Todos os produtos
Search
Central de documentação

:Exemplo de chamada de operação de API com o Simple Log Service SDK for Python

Última atualização: Jul 03, 2026

Este tópico descreve como usar o Simple Log Service SDK for Python para chamar a operação ListProject do Simple Log Service e consultar um projeto.

Consulte a documentação da API

Antes de chamar uma operação de API, leia a documentação correspondente para conhecer os parâmetros e as permissões necessários. Para obter mais informações, consulte Lista de operações por função.

Crie um usuário RAM e conceda permissões

Importante

O par de AccessKey de uma conta Alibaba Cloud tem permissões em todas as operações de API. Recomendamos criar e usar um usuário do Resource Access Management (RAM) para chamar operações de API ou executar tarefas rotineiras de operação e manutenção.

Se você já criou um usuário RAM e concedeu as permissões necessárias, pule esta etapa.

  1. Faça login no RAM console.

  2. Crie um usuário RAM.

    1. No painel de navegação à esquerda, escolha Identities > Users.

    2. Na página Users, clique em Create User.

    3. Na página Create User, defina Logon Name e Display Name como config-openapi-operator e selecione OpenAPI Access no campo Access Mode.

    4. Clique em OK.

      Após a criação do usuário RAM, o sistema gera automaticamente um AccessKey ID e um AccessKey secret. Para obter mais informações, consulte Criar um par de AccessKey. Anote o par de AccessKey, pois será necessário inseri-lo ao chamar operações de API com esse usuário RAM.

  3. Conceda permissões ao usuário RAM.

    Nota

    Por padrão, um usuário RAM não possui permissões. Após criar o usuário, anexe políticas de sistema, como AliyunLogFullAccess e AliyunLogReadOnlyAccess, ou políticas personalizadas. Para obter mais informações, consulte Visão geral. Neste exemplo, a política AliyunLogReadOnlyAccess é anexada ao usuário RAM. Essa política concede permissões somente leitura nos recursos do Simple Log Service.

    1. Na página Users, localize o usuário RAM config-openapi-operator e clique em Add Permissions na coluna Actions.

    2. No painel Add Permissions, selecione AliyunLogReadOnlyAccess e clique em OK.

    3. Confirme o resultado da autorização e clique em Complete.

Chame uma operação de API

Neste exemplo, utiliza-se o Simple Log Service SDK for Python para chamar uma operação de API. Caso utilize um Simple Log Service SDK em outra linguagem de programação, o procedimento a seguir também se aplica. Para obter mais informações, consulte SDKs do Simple Log Service.

Prepare o ambiente Python

Instale o Python. Para obter mais informações, visite o site oficial do Python.

Nota

O Simple Log Service SDK for Python oferece suporte ao Python 3 e versões posteriores.

Execute o comando python -V para verificar a versão instalada do Python.

Configure variáveis de ambiente

Para evitar riscos de segurança causados pela codificação fixa do par de AccessKey no código de negócios, recomendamos configurar variáveis de ambiente para gerenciar essas credenciais.

  • Sistema operacional Linux ou macOS

    Substitua <access_key_id> e <access_key_secret> nos comandos abaixo pelo AccessKey ID e AccessKey secret do usuário RAM. Em seguida, execute os seguintes comandos no dispositivo:

    export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
  • Sistema operacional Windows

    Crie um arquivo de variáveis de ambiente, adicione as variáveis ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET e insira o AccessKey ID e o AccessKey secret do usuário RAM. Depois, reinicie o sistema operacional Windows.

Baixe o código de exemplo

  1. Acesse ListProject.

  2. Na aba Parameters, configure os parâmetros. Por exemplo, insira o nome do projeto cujas informações deseja consultar no campo projectName.

  3. Na aba SDK Sample Code, selecione Python e clique em Download Project para baixar o pacote de código de exemplo.

  4. Descompacte o pacote de código de exemplo no computador e acesse o diretório alibabacloud_sample.

Instale as dependências

Nota

Após baixar o código de exemplo, abra o arquivo README.md para visualizar informações como a versão do SDK e as dependências.

pip install alibabacloud-sls20201230

Execute o código

Execute o arquivo sample.py. O sistema retorna a seguinte resposta de exemplo:

[LOG]
{
  "headers": {
    "server": "AliyunSLS",
    "content-type": "application/json",
    "content-length": "230",
    "connection": "keep-alive",
    "access-control-allow-origin": "*",
    "date": "Tue, 25 Jul 2023 10:08:25 GMT",
    "x-log-time": "1690279705",
    "x-log-requestid": "64BF9F199ED2B749708E5445"
  },
  "statusCode": 200,
  "body": {
    "count": 1,
    "projects": [
      {
        "createTime": "1656666120",
        "description": "",
        "lastModifyTime": "1665978308",
        "owner": "",
        "projectName": "re****-nginx",
        "region": "cn-hangzhou",
        "resourceGroupId": "rg-a****a",
        "status": "Normal"
      }
    ],
    "total": 1
  }
}