Usar perfis de versão de API com o .NET no Azure Stack Hub

  • Artigo

Importante

O SDK do .NET foi atualizado da faixa 1 para a faixa 2. É altamente recomendável migrar para o SDK da faixa 2 assim que possível. Consulte este guia de migração para obter instruções.

O SDK do .NET para o Azure Stack Hub Resource Manager fornece ferramentas para ajudá-lo a criar e gerenciar sua infraestrutura. Os provedores de recursos no SDK incluem Computação, Rede, Armazenamento, Serviços de Aplicativos e Key Vault. O SDK do .NET inclui 14 pacotes NuGet. Se você estiver usando a faixa preterida 1 SDK do .NET (não recomendado), esses pacotes serão com versões com perfis de API, como 2020-09-01-hybrid e 2019-03-01-hybrid. Os perfis de API no SDK do .NET permitem o desenvolvimento de nuvem híbrida, ajudando você a alternar entre os recursos globais do Azure e os recursos do Azure Stack Hub. Consulte a seção Perfis de versão do .NET e da API para obter mais informações.

Instalar o SDK do .NET do Azure

Perfis de versão do .NET e da API

Um perfil de API é uma combinação de provedores de recursos e versões de API. Use um perfil de API para obter a versão mais recente e estável de cada tipo de recurso em um pacote de provedor de recursos.

Observação

A parte ResourceProvider da especificação do pacote NuGet deve ser alterada. Além disso, os pacotes para o SDK do .NET da faixa 1 foram preteridos, portanto, você pode enfrentar erros. É recomendável atualizar para o SDK do .NET da faixa 2 assim que possível.

Perfis

Para perfis que contêm datas, para usar um perfil ou versão diferente do SDK, substitua a data em Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Por exemplo, para a versão 2008, o perfil é 2019_03_01e a cadeia de caracteres se torna Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. 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.

Versão do Azure Stack Perfil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020_09_01
2102 2020_09_01
2008 2019_03_01

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

Subscription

Se você ainda não tiver uma assinatura, crie uma assinatura e salve a ID da assinatura a ser usada posteriormente. Para obter informações sobre como criar uma assinatura, consulte este documento.

Entidade de serviço

Uma entidade de serviço e suas informações de ambiente associadas devem ser criadas e salvas em algum lugar. A entidade de serviço com owner função é recomendada, mas dependendo do exemplo, uma contributor função pode ser suficiente. Consulte o LEIAME no repositório de exemplo para obter os valores necessários. Você pode ler esses valores em qualquer formato compatível com a linguagem SDK, como de um arquivo JSON (que nossos exemplos usam). Dependendo do exemplo que está sendo executado, nem todos esses valores podem ser usados. Consulte o repositório de exemplo para obter o código de exemplo atualizado ou mais informações.

ID do locatário

Para localizar a ID do diretório ou do locatário do 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 Azure Stack Resource Manager

O ARM (Azure Resource Manager) é 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 as informações de metadados do ponto de extremidade Resource Manager. O ponto de extremidade retorna um arquivo JSON com as informações necessárias para executar seu código.

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

JSON de exemplo:

{
   "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 este repositório de exemplo para obter o código de exemplo de atualização até a data (faixa 2). Consulte este repositório de exemplo para obter o código de exemplo da faixa 1. A raiz README.md descreve os requisitos gerais e cada subdiretório contém um exemplo específico com seu próprio README.md que descreve como executar esse exemplo.

Consulte aqui para obter o exemplo aplicável para a versão 2008 ou perfil 2019-03-01 do Azure Stack e abaixo.

Próximas etapas

Saiba mais sobre perfis de API: