:Opciones de línea de comandos

Opción

Descripción

--profile,-p

Especifique un perfil de configuración. El perfil indicado anula la credencial predeterminada y la configuración de variables de entorno.

Ejemplo: Llame a la operación DescribeInstances de Elastic Compute Service (ECS) mediante el perfil akProfile.

aliyun ecs DescribeInstances --profile akProfile

--region

Utilice --region para especificar una región. Esta opción anula la región definida en la credencial predeterminada y en las variables de entorno.

Ejemplo: Llame a la operación DescribeInstances de ECS en la región cn-beijing.

aliyun ecs DescribeInstances --region cn-beijing

--endpoint

Especifique un endpoint. Consulte los endpoints compatibles en Developer Reference > API Reference > Endpoints de cada servicio.

Ejemplo: Llame a la operación DescribeMonitorGroups de CloudMonitor mediante el endpoint metrics.cn-qingdao.aliyuncs.com.

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

--endpoint-type

Especifique el tipo de endpoint. Valores válidos: vpc (acceso por VPC) y vacío (acceso público, valor predeterminado).

Ejemplo: Llame a la API DescribeInstances de ECS mediante un endpoint de VPC.

• Especifíquelo en la línea de comandos

  aliyun ecs DescribeInstances --endpoint-type vpc

• Configure para persistencia

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

--version

Especifique una versión de la API. Debe usarse junto con la opción --force. Forcibly call an API operation.

Ejemplo: Llame a la operación DescribeMetricList de CloudMonitor con la versión de API 2017-03-01.

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

--header

Agrega un encabezado de solicitud. Utilice esta opción varias veces para agregar varios encabezados.

Ejemplo: Agregue el encabezado X-foo=bar.

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

--body

Agrega una cadena como cuerpo de la solicitud para llamadas a API ROA.

Ejemplo: Llame a la operación RunClusterCheck de Container Service for Kubernetes (ACK) con un cuerpo de solicitud JSON.

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

--body-file

Agrega un archivo como cuerpo de la solicitud para llamadas a API RPC. Tiene prioridad sobre --body.

Ejemplo: Llame a la operación RunClusterCheck de Container Service for Kubernetes (ACK) con un archivo como cuerpo de la solicitud.

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

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

--read-timeout

Especifique el tiempo de espera de E/S en segundos. Anula el tiempo de espera de E/S predeterminado en la configuración de credenciales.

Ejemplo: Establezca el tiempo de espera de E/S en 20 segundos.

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

--connect-timeout

Especifique el tiempo de espera de conexión en segundos. Anula el tiempo de espera de conexión predeterminado en la configuración de credenciales.

Ejemplo: Establezca el tiempo de espera de conexión en 20 segundos.

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

--retry-count

Especifique el número máximo de reintentos. Anula el recuento de reintentos predeterminado en la configuración de credenciales.

Ejemplo: Establezca el recuento de reintentos en 5.

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

--secure

Fuerza el uso de HTTPS para la solicitud. Falla si la operación de la API no es compatible con HTTPS.

--insecure

Fuerza el uso de HTTP para la solicitud. Falla si la operación de la API no es compatible con HTTP.

--quiet,-q

Suprime los resultados devueltos por la API en la salida.

--help

Utilice --help para mostrar la ayuda de un comando.

Use the help command.

--output,-o

Extrae campos de la respuesta de OpenAPI y los muestra en una tabla.

Extract parameters and tabulate output.

--pager

Recupera todos los resultados de una API paginada sin necesidad de realizar la paginación manualmente.

Aggregate the results of paging operations.

--force

Fuerza la llamada a operaciones de la API y permite el uso de parámetros que no están en la lista de metadatos.

Forcibly call an API operation.

--waiter

Consulta repetidamente los resultados de la API hasta que un campo específico alcance un valor objetivo.

Poll the return results.

--dryrun

Simula una llamada a la API y devuelve el resultado sin ejecutar operaciones reales sobre los recursos en la nube.

Simulate a call.