Este tópico explica como configurar um ambiente Python e utilizar códigos de exemplo para chamar operações de API. O conteúdo aborda a instalação e auxilia você a construir e integrar rapidamente um serviço em nuvem.
Pré-requisitos
-
Baixe e instale o Python 3.
Abra um terminal e execute
python --versionpara verificar sua versão do Python. -
Tenha um editor de código Python instalado.
Este tópico utiliza o PyCharm como exemplo.
-
Obtenha um par de AccessKey.
É necessário usar um par de AccessKey para autenticar suas requisições de API. Um par de AccessKey consiste em um AccessKey ID e um AccessKey Secret. Para obter informações sobre como criar e obter um par de AccessKey, consulte Criar um par de AccessKey.
Procedimento
Etapa 1: Configure variáveis de ambiente
Para evitar o risco de segurança de codificar seu par de AccessKey diretamente no código, este exemplo utiliza variáveis de ambiente para gerenciá-lo. Para mais informações, consulte Configurar variáveis de ambiente no Linux, macOS e Windows.
Etapa 2: Instale dependências
Execute os comandos a seguir para instalar as dependências.
Caso o pip não esteja instalado em seu ambiente, consulte o site oficial do pip para obter instruções de instalação.
pip install alibabacloud_credentials
pip install alibabacloud_smc20190601==1.0.2
pip install alibabacloud_tea_console==0.0.1
pip install alibabacloud_tea_util==0.3.11
pip install alibabacloud_tea_openapi==0.3.8
Etapa 3: Baixe o projeto de exemplo do SDK
-
Acesse a página de depuração de API no OpenAPI Portal e selecione uma operação de API no painel de navegação à esquerda.
Este tópico usa a operação de API
DescribeSourceServerscomo exemplo. Na aba Parameters à esquerda, selecione uma region e especifique os parâmetros necessários. Consulte a aba Documentation à direita para obter detalhes sobre a operação de API, seus parâmetros e observações importantes, como informações de faturamento.
-
Na aba SDK Sample à direita, selecione Python e clique em Download Complete Project. Descompacte o projeto do SDK baixado em sua máquina local.
NotaPara copiar o código de exemplo do SDK, consulte Gerar automaticamente um exemplo de SDK.
Para mais informações sobre o código de exemplo do SDK para Python, consulte o Guia de início rápido do SDK.
Etapa 4: Importar o projeto descompactado
Abra o PyCharm.
Na barra de menu superior, escolha .
Na caixa de diálogo exibida, selecione a pasta do projeto do SDK descompactado.
Etapa 5: Execute o código de exemplo do SDK
No painel de navegação à esquerda do PyCharm, abra o arquivo de código de exemplo do SDK para Python.
Na barra de menu superior, escolha .
-
Visualize a saída.
C:\Demo\python-sdk\venv\Scripts\python.exe C:/Demo/python-sdk/alibabacloud_sample... [LOG] {"headers": {"date": "Fri, 30 Jun 2023 05:26:00 GMT", "content-type": "appl...}} Process finished with exit code 0
O SDK também suporta configurações avançadas, como requisições HTTPS, proxies, timeouts e mecanismos de nova tentativa. Para mais informações, consulte Configuração avançada.