Gerencie o Alibaba Cloud CDN com a CLI - CDN: Central de Documentação do Alibaba Cloud

A Alibaba Cloud CLI é uma ferramenta de linha de comando unificada, desenvolvida com base no OpenAPI Explorer, que permite automatizar o gerenciamento e a manutenção do Alibaba Cloud CDN. Este tópico descreve como instalar, configurar e usar a Alibaba Cloud CLI para chamar operações da API do Alibaba Cloud CDN.

Pré-requisitos

Antes de prosseguir, familiarize-se com a Alibaba Cloud CLI. Para mais informações, consulte O que é a Alibaba Cloud CLI?.

Instale a Alibaba Cloud CLI

Instale a Alibaba Cloud CLI no seu sistema operacional antes de começar.

Como alternativa, use o Cloud Shell para depurar comandos da Alibaba Cloud CLI sem instalação local. Para mais informações, consulte O que é o Cloud Shell?.

Configure a Alibaba Cloud CLI

Importante

Uma conta Alibaba Cloud (conta raiz) tem acesso administrativo total aos seus serviços e recursos, o que representa um risco significativo de segurança. Recomendamos fortemente criar e usar um usuário RAM para acesso à API ou para operações e manutenção diárias.

Configure suas credenciais de identidade e um ID de região antes de usar a Alibaba Cloud CLI. A ferramenta oferece suporte a diversos tipos de credenciais. Para mais informações, consulte Configurar e gerenciar credenciais de identidade. Este tópico usa credenciais AccessKey (AK) como exemplo.

Crie um usuário RAM e conceda as permissões necessárias. Para mais informações, consulte Criar um usuário RAM e Conceder permissões a um usuário RAM.

Importante
Este exemplo exige anexar a política AliyunCDNReadOnlyAccess ao usuário RAM. Também é possível anexar a política AliyunCDNFullAccess, que concede controle total para consultar e modificar nomes de domínio do Alibaba Cloud CDN, ou criar uma política personalizada. Para mais informações, consulte Referência de política personalizada do CDN.
Após criar e autorizar o usuário RAM, crie um par de AccessKey. Registre o AccessKey ID e o AccessKey Secret. Para mais informações, consulte Criar um AccessKey.
Obtenha e registre um ID de região disponível. A Alibaba Cloud CLI envia solicitações de API para a região especificada. Para obter uma lista de regiões disponíveis, consulte Estrutura da solicitação.

Nota
Use a opção --region para especificar uma região em um comando. Essa opção substitui a região padrão definida nas suas credenciais e variáveis de ambiente. Para mais informações, consulte Opções de linha de comando.
Use o par de AccessKey do usuário RAM para configurar as credenciais. Nomeie o perfil de configuração como AkProfile. Para mais informações, consulte Endpoints.

Gere um exemplo de comando da CLI

Acesse a página de Depuração da API do Alibaba Cloud CDN.
Na caixa de pesquisa à esquerda, busque a API desejada. Na aba Parameters, configure os parâmetros conforme a documentação da API. Clique na aba CLI Example para gerar um exemplo de comando com os parâmetros configurados.
- Clique no ícone para abrir o Cloud Shell e depurar o comando.
- Clique no ícone para copiar o exemplo da CLI. Em seguida, cole-o no seu shell local para executar o comando.
  - Ao colar o exemplo no shell local, verifique o formato dos parâmetros. Para mais informações, consulte Entender os parâmetros de comando.
  - Por padrão, o OpenAPI Explorer adiciona a opção --region ao exemplo gerado. Essa opção substitui a região padrão na configuração de credenciais e nas variáveis de ambiente. Remova-a ou mantenha-a conforme necessário.

Chame uma operação de API

Estrutura do comando

Os comandos da Alibaba Cloud CLI seguem esta estrutura. Para mais informações, consulte Gerar e chamar um comando.

aliyun <command> <subcommand> [options and parameters]

Opções comuns de linha de comando

Use opções de linha de comando para modificar o comportamento padrão de um comando. As opções mais comuns incluem:

--profile <profileName>: Especifica um perfil de credencial a ser usado em vez do padrão. Quando definido, a Alibaba Cloud CLI ignora a configuração de credencial padrão e as variáveis de ambiente.
--help: Exibe informações de ajuda para um comando. Para mais detalhes, consulte Obter informações de ajuda.

Para mais informações, consulte Opções de linha de comando.

Exemplo

O exemplo a seguir chama a operação DescribeUserDomains para consultar todos os nomes de domínio e seus respectivos status na sua conta. Para mais informações, consulte DescribeUserDomains.

Execute o comando.

aliyun cdn DescribeUserDomains --DomainName mxxxio.top

O comando retorna a seguinte saída.

{
  "Domains": {
    "PageData": [
      {
        "CdnType": "web",
        "Cname": "mxxx.xxxp.w.kunlunq.com",
        "Coverage": "domestic",
        "Description": "",
        "DomainId": 201xxx553,
        "DomainName": "mjlxxxao.top",
        "DomainStatus": "online",
        "GlobalResourcePlan": "off",
        "GmtCreated": "2024-08-27T06:29:36Z",
        "GmtModified": "2024-08-27T06:34:04Z",
        "ResourceGroupId": "rg-acfmwpdflelaoai",
        "Sandbox": "",
        "Sources": {
          "Source": [
            {
              "Content": "183.xxx.xxx.88.cn-hangzhou.sae.aliyuncs.com",
              "Port": 80,
              "Priority": "20",
              "Type": "domain",
              "Weight": "10"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "E4EBD2BF-5EB0-4044-9B97-xxxxxx",
  "TotalCount": 1
}
            }
          ]
        },
        "SslProtocol": "off"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "34C9E61F-02A0-5EB5-BBCB-16B531ABB9E0",
  "TotalCount": 1
}

Nota

Se uma chamada de API do Alibaba Cloud CDN retornar um erro, verifique o código de erro para confirmar se os parâmetros e valores da solicitação estão corretos.

Você também pode usar o RequestId ou a mensagem de erro do SDK presente na resposta com o Alibaba Cloud OpenAPI Diagnostics para solucionar o problema.