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.
As bibliotecas suportam Python 3.9 ou posterior. Para mais informações sobre versões suportadas de Python, consulte Azure SDKs Python política de suporte a versões. Se estiveres a usar PyPy, certifica-te de que a versão que usas suporta pelo menos a versão Python mencionada anteriormente.
O Azure SDK 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 Azure Storage, 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 Azure SDK for Python (PyCon 2021) e Using Azure SDKs to interact with Azure resources (PyCon 2020).

Detalhes não essenciais, mas ainda assim interessantes

Como o Azure CLI está escrito em Python e usa as bibliotecas de gestão, podes fazer tudo com Azure CLI 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/.
A partir de 2019, a Microsoft atualizou as bibliotecas do Azure Python para partilhar padrões comuns na nuvem, como protocolos de autenticação, logging, tracing, protocolos de transporte, respostas em buffer e tentativas. As bibliotecas atualizadas cumprem as diretrizes Azure SDK atuais.
- A 31 de março de 2023, a Microsoft retirou o suporte para bibliotecas do Azure SDK que não cumprem as diretrizes atuais do Azure SDK. Embora as bibliotecas mais antigas ainda possam ser usadas para além de 31 de março de 2023, já não recebem suporte oficial nem atualizações da Microsoft. Para mais informações, consulte o aviso Atualize as suas bibliotecas de Azure SDK.
- Para evitar perder atualizações de segurança e desempenho do Azure SDKs, atualize para as bibliotecas Azure SDK mais recentes até 31 de março de 2023.
- Para verificar quais as bibliotecas Python afetadas, veja Azure SDK Versões Descontinuadas para Python.
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 Azure CLI. (Como referido anteriormente, a Azure CLI é 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:

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 Azure Storage 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:

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 Azure SDK 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 >>>

Comentários

Esta página foi útil?

Last updated on 2026-03-11