:Alibaba Cloud CLI command-line options

Opção

Descrição

--profile,-p

Especifique um perfil de configuração. O perfil definido substitui as configurações padrão de credenciais e variáveis de ambiente.

Exemplo: Chame a operação DescribeInstances do Elastic Compute Service (ECS) usando o perfil akProfile.

aliyun ecs DescribeInstances --profile akProfile

--region

Use --region para especificar uma região. Esta opção substitui a região definida nas credenciais padrão e nas variáveis de ambiente.

Exemplo: Chame a operação DescribeInstances do ECS na região cn-beijing.

aliyun ecs DescribeInstances --region cn-beijing

--endpoint

Defina um endpoint. Consulte os endpoints suportados em Developer Reference > API Reference > Endpoints de cada serviço.

Exemplo: Invoque a operação DescribeMonitorGroups do CloudMonitor utilizando o endpoint metrics.cn-qingdao.aliyuncs.com.

aliyun cms DescribeMonitorGroups --endpoint metrics.cn-qingdao.aliyuncs.com

--endpoint-type

Indica o tipo de endpoint. Valores válidos: vpc (acesso via VPC) e vazio (acesso público, padrão).

Exemplo: Acesse a API DescribeInstances do ECS por meio de um endpoint de VPC.

• Especifique na linha de comando

  aliyun ecs DescribeInstances --endpoint-type vpc

• Configure para persistência

  aliyun configure set --endpoint-type vpc
  aliyun ecs DescribeInstances

--version

Determina uma versão da API. Deve ser usado com a opção --force. Chamar forçadamente uma operação de API.

Exemplo: Execute a operação DescribeMetricList do CloudMonitor com a versão de API 2017-03-01.

aliyun cms QueryMetricList \
      --Project acs_ecs_dashboard \
      --Metric cpu_idle \
      --version 2017-03-01 \
      --force

--header

Adiciona um cabeçalho à requisição. Utilize esta opção várias vezes para incluir múltiplos cabeçalhos.

Exemplo: Inclua o cabeçalho X-foo=bar.

aliyun <product> <ApiName> --header X-foo=bar

--body

Insere uma string como corpo da requisição para chamadas de API ROA.

Exemplo: Realize a operação RunClusterCheck do Container Service for Kubernetes (ACK) com um corpo de requisição JSON.

aliyun cs POST /clusters/{cluster_id}/checks --body "{\"type\":\"NodePoolUpgrade\",\"target\":\"np1f6779297c4444a3a1cdd29be8e5****\"}"

--body-file

Utiliza um arquivo como corpo da requisição para chamadas de API RPC. Tem precedência sobre --body.

Exemplo: Acione a operação RunClusterCheck do Container Service for Kubernetes (ACK) usando um arquivo como corpo da requisição.

aliyun cs POST /clusters/{cluster_id}/checks --body-file /usr/local/bin/example.json

{
    "type": "NodePoolUpgrade",
    "target": "np1f6779297c4444a3a1cdd29be8e5****"
}

--read-timeout

Estabelece o tempo limite de E/S em segundos. Substitui o tempo limite de E/S padrão nas configurações de credenciais.

Exemplo: Defina o tempo limite de E/S para 20 segundos.

aliyun <product> <ApiName> --read-timeout 20

--connect-timeout

Configura o tempo limite de conexão em segundos. Sobrescreve o tempo limite de conexão padrão das credenciais.

Exemplo: Ajuste o tempo limite de conexão para 20 segundos.

aliyun <product> <ApiName> --connect-timeout 20

--retry-count

Limita o número máximo de tentativas. Prevalece sobre a contagem de tentativas padrão nas configurações de credenciais.

Exemplo: Configure o número de tentativas para 5.

aliyun <product> <ApiName> --retry-count 5

--secure

Impõe o uso de HTTPS na requisição. A execução falhará se a operação de API não suportar HTTPS.

--insecure

Força o protocolo HTTP na requisição. O comando resultará em erro caso a operação de API não aceite HTTP.

--quiet,-q

Oculta os resultados retornados pela API na saída.

--help

Empregue --help para visualizar a ajuda de um comando.

Usar o comando de ajuda.

--output,-o

Extrai campos da resposta da OpenAPI e os exibe em formato de tabela.

Extrair parâmetros e tabular a saída.

--pager

Obtém todos os resultados de uma API paginada sem necessidade de paginação manual.

Agregar os resultados de operações de paginação.

--force

Executa operações de API forçadamente e permite parâmetros ausentes na lista de metadados.

Chamar forçadamente uma operação de API.

--waiter

Consulta os resultados da API repetidamente até que um campo específico atinja um valor alvo.

Consultar os resultados retornados.

--dryrun

Simula uma chamada de API e retorna o resultado sem executar operações reais nos recursos de nuvem.

Simular uma chamada.