Gerir os perfis de versões das APIs no Azure Stack Hub

  • Artigo

Os perfis de API especificam o fornecedor de recursos do Azure e a versão da API para pontos finais REST do Azure. Pode criar clientes personalizados em idiomas diferentes com perfis de API. Cada cliente utiliza um perfil de API para contactar o fornecedor de recursos correto e a versão da API do Azure Stack Hub.

Pode criar uma aplicação para trabalhar com fornecedores de recursos do Azure sem ter de saber exatamente que versão de cada API de fornecedor de recursos é compatível com o Azure Stack Hub. Basta alinhar a sua aplicação com um perfil e o SDK reverte para a versão correta da API.

Este tópico ajuda-o a:

  • Compreender os perfis de API do Azure Stack Hub.
  • Saiba como pode utilizar perfis de API para desenvolver as suas soluções.
  • Veja onde encontrar orientações específicas do código.

Resumo dos perfis de API

  • Os perfis de API são utilizados para representar um conjunto de fornecedores de recursos do Azure e as respetivas versões de API.
  • Foram criados perfis de API para criar modelos em várias clouds do Azure. Os perfis fornecem uma interface compatível e estável.
  • Os perfis são lançados quatro vezes por ano.
  • São utilizadas três convenções de nomenclatura de perfis:
    • mais recente
      Contém as versões de API mais recentes lançadas no Azure global.
    • yyyy-mm-dd-hybrid
      Lançada bi-anualmente, esta versão foca-se na consistência e estabilidade em várias clouds. Este perfil destina-se à compatibilidade ideal do Azure Stack Hub.
    • yyyy-mm-dd-profile
      Equilibra a estabilidade ideal e as funcionalidades mais recentes.

Perfis da API do Azure e compatibilidade do Azure Stack Hub

Os perfis mais recentes da API do Azure não são compatíveis com o Azure Stack Hub. Utilize as seguintes convenções de nomenclatura para identificar os perfis a utilizar para as suas soluções do Azure Stack Hub:

mais recente
Este perfil tem as versões de API mais atualizadas encontradas no Azure global, que não funcionam no Azure Stack Hub. o mais recente tem o maior número de alterações interruptivas. O perfil coloca de lado a estabilidade e a compatibilidade com outras clouds. Se estiver a tentar utilizar as versões de API mais atualizadas, o mais recente é o perfil que deve utilizar.

Yyyy-mm-dd-hybrid
Este perfil é lançado em março e setembro todos os anos. Tem estabilidade e compatibilidade ideais com várias clouds e foi concebida para visar o Azure global e o Azure Stack Hub. As versões da API do Azure listadas neste perfil serão as mesmas que estão listadas no Azure Stack Hub. Utilize este perfil para desenvolver código para soluções de cloud híbridas.

yyyy-mm-dd-profile
Este perfil é lançado para o Azure global em junho e dezembro. Não funciona com o Azure Stack Hub e, normalmente, haverá muitas alterações interruptivas. Apesar de equilibrar a estabilidade ideal e as funcionalidades mais recentes, a diferença entre o mais recente e este perfil é que a versão mais recente consiste sempre nas versões mais recentes da API, independentemente de quando a API é lançada. Por exemplo, se uma nova versão da API for criada para a API de Computação amanhã, essa versão da API é listada na versão mais recente, mas não no perfil yyyy-mm-dd-profile , porque este perfil já existe. O perfil yyyy-mm-dd-profile abrange as versões mais atualizadas lançadas antes de junho ou antes de dezembro.

Perfis de API do Azure Resource Manager

O Azure Stack Hub não utiliza a versão mais recente das versões da API encontradas no Azure global. Quando cria uma solução, tem de encontrar a versão da API para cada fornecedor de recursos do Azure compatível com o Azure Stack Hub.

Em vez de pesquisar todos os fornecedores de recursos e a versão específica suportada pelo Azure Stack Hub, pode utilizar um perfil de API. O perfil especifica um conjunto de fornecedores de recursos e versões de API. O SDK, ou uma ferramenta criada com o SDK, reverterá para o destino api-version especificado no perfil. Com os perfis de API, pode especificar uma versão de perfil que se aplica a um modelo inteiro. No runtime, o Resource Manager do Azure seleciona a versão certa do recurso.

Os perfis de API funcionam com ferramentas que utilizam Resource Manager do Azure, como o PowerShell, a CLI do Azure, o código fornecido no SDK e o Microsoft Visual Studio. As ferramentas e os SDKs podem utilizar perfis para ler a versão dos módulos e bibliotecas a incluir ao criar uma aplicação.

Por exemplo, se utilizar o PowerShell para criar uma conta de armazenamento com o fornecedor de recursos Microsoft.Storage , que suporta a versão 2016-03-30 da API e uma VM com o fornecedor de recursos Microsoft.Compute com a versão 2015-12-01 da API, tem de procurar que módulo do PowerShell suporta 2016-03-30 para Armazenamento e que módulo suporta 2015-02-01 para Computação e, em seguida, instalá-los. Em vez disso, pode utilizar um perfil. Utilize o cmdlet Install-Profile <profilename>e o PowerShell carrega a versão correta dos módulos.

Da mesma forma, ao utilizar o SDK python para criar uma aplicação baseada em Python, pode especificar o perfil. O SDK carrega os módulos certos para os fornecedores de recursos que especificou no script.

Enquanto programador, isto significa que pode concentrar-se em escrever a sua solução. Em vez de pesquisar que versões de API, fornecedor de recursos e cloud funcionam em conjunto, pode utilizar um perfil e saber que o seu código funciona em todas as clouds que suportam esse perfil.

Exemplos de código de perfil da API

Pode encontrar exemplos de código para o ajudar a integrar a sua solução com o seu idioma preferido no Azure Stack Hub através de perfis. Atualmente, pode encontrar documentação de orientação e exemplos para os seguintes idiomas:

  • .NET
    Utilize o perfil da API .NET para obter a versão mais recente e estável de cada tipo de recurso num pacote de fornecedor de recursos. Para obter mais informações, veja Utilizar perfis de versão da API com .NET no Azure Stack Hub.
  • PowerShell
    Utilize o módulo Az.Bootstrapper disponível através do Galeria do PowerShell para obter os cmdlets do PowerShell necessários para trabalhar com perfis de versão da API. Para obter informações, veja Utilizar perfis de versão da API para o PowerShell. Utilize o módulo AzureRM.Bootstrapper disponível através do Galeria do PowerShell para obter os cmdlets do PowerShell necessários para trabalhar com perfis de versão da API. Para obter informações, veja Utilizar perfis de versão da API para o PowerShell.
  • CLI do Azure
    Atualize a configuração do ambiente para utilizar o perfil de versão da API específica do Azure Stack Hub. Para obter informações, veja Utilizar perfis de versão da API para a CLI do Azure.
  • Ir
    No SDK Go, um perfil é uma combinação de diferentes tipos de recursos com versões diferentes de diferentes serviços. Os perfis estão disponíveis nos perfis/caminho com a respetiva versão no formato YYYY-MM-DD . Para obter informações, veja Utilizar perfis de versão da API para Go.
  • Ruby
    O SDK Ruby para o Azure Stack Hub Resource Manager fornece ferramentas para o ajudar a criar e gerir a sua infraestrutura. Os fornecedores de recursos no SDK incluem computação, redes virtuais e armazenamento com a linguagem Ruby. Para obter informações, veja Utilizar perfis de versão da API com Ruby.
  • Python
    O SDK python suporta perfis de versão da API para direcionar diferentes plataformas na cloud, como o Azure Stack Hub e o Azure global. Utilize perfis de API para criar soluções para uma cloud híbrida. Para obter informações, veja Utilizar perfis de versão da API com Python.
  • Node.js
    O SDK Node.js do Azure Stack Hub Resource Manager fornece ferramentas para o ajudar a criar e gerir a sua infraestrutura. Para obter mais informações, veja Utilizar a versão da API Perfis com Node.js.

Passos seguintes