Usar perfis de versão da API com o Go no Azure Stack Hub

Perfis de programação Go e versão

Um perfil é uma combinação de diferentes tipos de recursos com diferentes versões de diferentes serviços. A utilização de um perfil ajuda-o a combinar diferentes tipos de recursos. Os perfis podem oferecer os seguintes benefícios:

• Estabilidade para seu aplicativo bloqueando versões específicas da API.
• Compatibilidade para seu aplicativo com o Azure Stack Hub e datacenters regionais do Azure.

No SDK Go, os perfis estão disponíveis no diretório de perfis. Os números de versão do perfil são rotulados no formato AAAA-MM-DD . Por exemplo, o perfil da API do Azure Stack Hub versão 2020-09-01 é para as versões 2102 ou posteriores do Azure Stack Hub. Para importar um determinado serviço de um perfil, importe o módulo correspondente do perfil. Por exemplo, para importar o serviço Compute do perfil 2020-09-01, use o seguinte código:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Instale o Azure SDK para Go

1. Instale o Git. Consulte Introdução - Instalação do Git.
2. Instale o Go. Os perfis de API para o Azure exigem o Go versão 1.9 ou mais recente. Consulte Linguagem de programação Go.

Perfis

Para usar um perfil ou versão diferente do SDK, substitua a data em uma instrução de importação, como github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Por exemplo, para a versão 2008, o perfil é 2019-03-01, e a cadeia de caracteres se torna github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Observe que, às vezes, a equipe do SDK altera o nome dos pacotes, portanto, simplesmente substituir a data de uma cadeia de caracteres por uma data diferente pode não funcionar. Consulte a tabela a seguir para associação de perfis e versões do Azure Stack.

Para obter mais informações sobre o Azure Stack Hub e perfis de API, consulte o Resumo dos perfis de API.

Consulte Perfis Go SDK.

Subscrição

Se ainda não tiver uma subscrição, crie uma subscrição e guarde o ID da subscrição para ser utilizado mais tarde. Para obter informações sobre como criar uma assinatura, consulte este documento.

Entidade de serviço

Uma entidade de serviço e as suas informações de ambiente correspondentes devem ser criadas e guardadas em algum lugar. A entidade de serviço com owner função é recomendada, mas, dependendo da amostra, uma contributor função pode ser suficiente. Consulte o LEIA-ME no repositório de exemplo para obter os valores necessários. Você pode ler esses valores em qualquer formato suportado pela linguagem SDK, como a partir de um arquivo JSON (que nossos exemplos usam). Dependendo da amostra que está a ser executada, nem todos estes valores podem ser utilizados. Consulte o repositório de exemplo para obter código de exemplo atualizado ou mais informações.

ID do inquilino

Para localizar o diretório ou a ID do locatário para seu Azure Stack Hub, siga as instruções neste artigo.

Registrar provedores de recursos

Registre os provedores de recursos necessários seguindo este documento. Esses provedores de recursos serão necessários dependendo dos exemplos que você deseja executar. Por exemplo, se você quiser executar um exemplo de VM, o registro do Microsoft.Compute provedor de recursos será necessário.

Ponto de extremidade do gerenciador de recursos do Azure Stack

O Azure Resource Manager (ARM) é uma estrutura de gerenciamento que permite aos administradores implantar, gerenciar e monitorar recursos do Azure. O Azure Resource Manager pode lidar com essas tarefas como um grupo, em vez de individualmente, em uma única operação. Você pode obter os metadados do ponto final do Gerenciador de Recursos. O ponto de extremidade retorna um arquivo JSON com as informações necessárias para executar seu código.

• O ResourceManagerEndpointUrl no Azure Stack Development Kit (ASDK) é: https://management.local.azurestack.external/.
• O ResourceManagerEndpointUrl em sistemas integrados é: https://management.region.<fqdn>/, onde <fqdn> é o seu nome de domínio totalmente qualificado.
• Para recuperar os metadados necessários: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Para obter as versões de API disponíveis, consulte Especificações da API restante do Azure. Por exemplo, na versão 2020-09-01 do perfil, pode alterar o api-version para 2019-10-01 no provedor de recursos microsoft.resources.

Exemplo de JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Exemplos

Consulte o repositório de exemplo para obter código de exemplo atualizado. A raiz README.md descreve os requisitos gerais, e cada subdiretório contém um exemplo específico com seu próprio README.md sobre como executar esse exemplo.

Próximos passos

Saiba mais sobre perfis de API:

• Gerenciar perfis de versão da API no Azure Stack Hub
• Versões da API do provedor de recursos suportadas por perfis