Utilize as bibliotecas do Azure (SDK) para Python

As bibliotecas Azure open-source para Python simplificam o provisionamento, a gestão e a utilização de recursos Azure a partir de código de aplicação Python.

Os detalhes que você realmente quer saber

• Utilize as bibliotecas Azure para comunicar com os serviços Azure a partir de código Python que executa localmente ou na cloud. Se consegues executar código Python dentro do âmbito de um determinado serviço depende de esse próprio serviço suportar atualmente Python.

• Para versões de Python suportadas, consulte a política de suporte da versão Python dos SDKs do Azure. Se estiveres a usar PyPy, usa uma versão compatível com uma versão Python suportada.

• O SDK do Azure para Python é composto exclusivamente por mais de 180 bibliotecas Python individuais relacionadas com serviços específicos do Azure. Não há outras ferramentas no SDK.

• Quando executa código localmente, autenticando com o Azure depende de variáveis de ambiente, conforme descrito em Como autenticar aplicações Python aos serviços Azure usando o SDK do Azure para Python.

• Para instalar pacotes de biblioteca com pip, use pip install <library_name> usando nomes de biblioteca do índice de pacotes. Para instalar pacotes de bibliotecas em ambientes conda, utilize conda install <package_name> com nomes do canal Microsoft no anaconda.org. Para mais informações, consulte Instalar pacotes de biblioteca Azure.

• Existem bibliotecas de gestão distintas e bibliotecas de cliente (às vezes referidas como bibliotecas de "plano de gestão" e "plano de dados"). Cada conjunto serve propósitos diferentes e é usado por diferentes tipos de código. Para obter mais informações, consulte as seguintes seções mais adiante neste artigo:

  • Criar e gerir recursos Azure com bibliotecas de gestão
  • Liga-te e usa recursos Azure com bibliotecas clientes

• Pode encontrar documentação para as bibliotecas no Azure para Python Reference, que é organizado por Azure Serviço, ou no navegador API Python, que está organizado pelo nome do pacote.

• Para experimentares as bibliotecas por ti próprio, primeiro configura o teu ambiente local de desenvolvimento. Depois pode tentar qualquer um dos seguintes exemplos independentes (por qualquer ordem): Exemplo: Criar um grupo de recursos, Exemplo: Criar e usar Armazenamento do Azure, Exemplo: Criar e implementar uma aplicação web, Exemplo: Criar e consultar uma base de dados MySQL, e Exemplo: Criar uma máquina virtual.

• Para vídeos de demonstração, veja Introducing the SDK do Azure for Python (PyCon 2021) e Using SDKs do Azure to interact with Azure resources (PyCon 2020).

Detalhes não essenciais, mas ainda assim interessantes

• Como o CLI do Azure está escrito em Python e usa as bibliotecas de gestão, podes fazer tudo com CLI do Azure comandos que também podes executar a partir de um script Python. Os comandos CLI fornecem muitas funcionalidades úteis, como realizar múltiplas tarefas em conjunto, lidar automaticamente com operações assíncronas, formatar a saída como strings de ligação, entre outros. Assim, usar a CLI (ou o seu equivalente, Azure PowerShell) para scripts automatizados de criação e gestão pode ser mais conveniente do que escrever o equivalente Python código, a menos que queiras ter um grau muito mais rigoroso de controlo sobre o processo.

• As bibliotecas Azure para Python baseiam-se na API REST Azure subjacente, por isso podes usar essas APIs através de paradigmas de Python familiares. No entanto, podes sempre usar a API REST diretamente do código Python, se assim o desejar.

• Pode encontrar o código-fonte das bibliotecas Azure em https://github.com/Azure/azure-sdk-for-python. Como um projeto de código aberto, as contribuições são bem-vindas!

• Embora possas usar as bibliotecas com intérpretes como IronPython e Jython contra os quais a Microsoft não testa, podes encontrar problemas isolados e incompatibilidades.

• O repositório de origem para a documentação de referência da API da biblioteca reside em https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

• As bibliotecas Python do Azure partilham padrões comuns na cloud, como protocolos de autenticação, registo em log, rastreio, protocolos de transporte, respostas em buffer e novas tentativas. As bibliotecas cumprem as diretrizes atuais do SDK do Azure.

• Para detalhes sobre as diretrizes que a Microsoft aplica às bibliotecas, consulte as Diretrizes Python: Introdução.

Crie e gere recursos do Azure com bibliotecas de gestão

As bibliotecas management (ou "plano de gestão") do SDK, cujos nomes começam todas por azure-mgmt-, ajudam-no a criar, configurar e gerir recursos Azure de scripts Python. Todos os serviços do Azure têm bibliotecas de gestão correspondentes. Para mais informações, veja Azure plano de controlo e plano de dados.

Ao usar as bibliotecas de gestão, pode escrever scripts de configuração e implementação para executar as mesmas tarefas que pode fazer através do portal Azure ou do CLI do Azure. (Como referido anteriormente, a CLI do Azure é escrita em Python e utiliza as bibliotecas de gestão para implementar os seus vários comandos.)

Os exemplos a seguir ilustram como usar algumas das bibliotecas de gerenciamento primárias:

• Criar um grupo de recursos
• Listar grupos de recursos numa assinatura
• Criar uma conta Armazenamento do Azure e um contentor de armazenamento Blob
• Criar e implantar um aplicativo Web no Serviço de Aplicativo
• Criar e consultar uma base de dados Azure MySQL
• Criar uma máquina virtual

Para detalhes sobre como trabalhar com cada biblioteca de gestão, consulte o ficheiro README.md ou README.rst localizado na pasta do projeto da biblioteca no repositório GitHub SDK. Também podes encontrar mais excertos de código na documentação reference e nos Azure Samples.

Migrando de bibliotecas de gerenciamento mais antigas

Se você estiver migrando código de versões mais antigas das bibliotecas de gerenciamento, consulte os seguintes detalhes:

• Se você usar a classe ServicePrincipalCredentials, consulte Autenticar com credenciais de token.
• Os nomes das APIs assíncronas foram alterados conforme descrito em Padrões de uso da Biblioteca - operações assíncronas. Os nomes das APIs assíncronas em bibliotecas mais recentes começam com begin_. Na maioria dos casos, a assinatura da API permanece a mesma.

Ligue-se e utilize recursos do Azure com bibliotecas de clientes

As bibliotecas client (ou "plano de dados") do SDK ajudam-no a escrever Python código de aplicação para interagir com serviços já provisionados. As bibliotecas de cliente existem apenas para os serviços que suportam uma API de cliente.

O artigo Exemplo: Use Armazenamento do Azure fornece uma ilustração básica da utilização de uma biblioteca cliente.

Diferentes serviços do Azure também fornecem exemplos que utilizam estas bibliotecas. Consulte as seguintes páginas de índice para obter outros links:

• Hospedagem de aplicativos
• Serviços Cognitivos
• Soluções de dados
• Identidade e segurança
• Aprendizagem automática
• Mensagens e IoT
• Outros serviços

Para detalhes sobre como trabalhar com cada biblioteca cliente, consulte o ficheiro README.md ou README.rst localizado na pasta de projeto da biblioteca no repositório GitHub do SDK. Também podes encontrar mais excertos de código na documentação reference e nos Azure Samples.

Obtenha ajuda e conecte-se com a equipe do SDK

• Visite as bibliotecas Azure para documentação Python
• Postar perguntas para a comunidade no Stack Overflow
• Questões em aberto contra o SDK em GitHub
• Mencione @AzureSDK no Twitter
• Complete um breve inquérito sobre o SDK do Azure para Python

Próximo passo

Configura o teu ambiente de desenvolvimento local para que possas usar facilmente qualquer uma das bibliotecas do Azure para Python.

Configure seu ambiente de desenvolvimento local >>>