Alibaba Cloud CLI:Understand Alibaba Cloud CLI command parameters

aliyun ecs describe-instances --biz-region-id cn-hangzhou --cli-dry-run

aliyun configure --help

configure credential and settings

Usage:
  aliyun configure --mode {AK|RamRoleArn|EcsRamRole|OIDC|External|CredentialsURI|ChainableRamRoleArn|CloudSSO|OAuth} --profile <profileName> [--config-path <configPath>]

Commands:
  get             print configuration values
  set             set config in non interactive mode
  list            list all config profile
  delete          delete the specified profile
  switch          switch default profile
  safety-policy   manage safety policy and human-in-the-loop rules
  ai-mode         manage global AI mode and User-Agent for API calls
  plugin-settings manage global plugin system settings

aliyun ecs describe-instances --help

Description: Queries a list of instances and their details based on specified conditions

API Version: 2014-05-26

Usage:
  aliyun ecs describe-instances [parameters]

Parameters:
  --biz-region-id                string (required), The ID of the region where the
                                 instance resides. You can call https://help.aliyun.
                                 com/document_detail/25609.html to query the latest
                                 list of Alibaba Cloud regions
  --additional-attributes        list, The list of other instance attributes
                                 format: --additional-attributes value1 value2 value3
  --device-available             bool, > This parameter is in invitational preview
                                 and is not available for use
......

Global Flags:
  --cli-ai-mode             bool, For this run, enable AI-mode
  --cli-dry-run             bool, Enable dry-run mode: print request details
                            without sending the actual API call
  --cli-query               string, Use `--cli-query <jmespath>` to filter
                            output with JMESPath expression
  --endpoint                string, Override service endpoint (e.g., --endpoint
                            https://ecs.cn-hangzhou.aliyuncs.com)
......

Examples:
  aliyun ecs describe-instances --biz-region-id example-value
  aliyun ecs describe-instances --biz-region-id example-value --vpc-id example-value

Matrices JSON

• Linux / macOS: Utilice comillas simples para la capa externa y comillas dobles para los valores internos.

  aliyun ecs describe-disks --disk-ids '["d-bp1****","d-bp2****","d-bp3****"]' --biz-region-id cn-hangzhou

• Windows (Símbolo del sistema y PowerShell): Utilice comillas dobles para la capa externa y comillas simples para los valores internos.

  aliyun ecs describe-disks --disk-ids "['d-bp1****','d-bp2****','d-bp3****']" --biz-region-id cn-hangzhou

Objetos JSON

Cuando un valor de parámetro es un objeto JSON, encierre cada objeto JSON entre llaves {} y separe claves y valores con dos puntos :.

• Linux / macOS:

  aliyun slb add-backend-servers --load-balancer-id lb-bp1**** --backend-servers '[{"ServerId":"i-bp1****"},{"ServerId":"i-bp2****"}]'

• Windows (Símbolo del sistema y PowerShell):

  aliyun slb add-backend-servers --load-balancer-id lb-bp1**** --backend-servers "[{'ServerId':'i-bp1****'},{'ServerId':'i-bp2****'}]"

Valores que comienzan con un guion (-)

Cuando un valor de parámetro comienza con -, el CLI puede interpretarlo erróneamente como otro nombre de parámetro:

aliyun ecs AuthorizeSecurityGroup --SecurityGroupId 'sg-bp67acfmxazb4p****' --Permissions.1.PortRange "-1/-1" --method POST --force

Utilice un signo igual para conectar el nombre del parámetro y el valor a fin de resolver este problema:

aliyun ecs AuthorizeSecurityGroup --SecurityGroupId 'sg-bp67acfmxazb4p****' --Permissions.1.PortRange=-1/-1 --method POST --force

Caracteres especiales del shell

Cuando los valores de los parámetros contienen caracteres especiales del shell ($, , \, espacios, etc.), debe encerrarlos entre comillas. En Linux / macOS, utilice comillas simples para evitar que el shell interprete los caracteres especiales. En el Símbolo del sistema de Windows, utilice comillas dobles.

# Linux/macOS/PowerShell
aliyun ecs describe-images --image-name 'Example Image'
# Windows CMD
aliyun ecs describe-images --image-name "Example Image"

# Linux/macOS
aliyun xxx --param '$literal_dollar'

--body-file (llamadas a API RESTful)

En llamadas a API RESTful, utilice --body-file para cargar el cuerpo de la solicitud HTTP desde un archivo local.

aliyun cs PUT /clusters/c1234****/nodepools/np5678**** --body-file request.json

Sustitución de comandos del shell y here-doc

También puede utilizar la sustitución de comandos del shell ($(cat ...)) o un here-doc para pasar el contenido del archivo al parámetro --body:

# Command substitution
aliyun cs PUT /clusters/c1234****/nodepools/np5678**** --body "$(cat request.json)"

# Here-doc (suitable for constructing inline JSON in scripts)
aliyun cs PUT /clusters/c1234****/nodepools/np5678**** --body "$(cat <<EOF
{
  "nodepool_info": {
    "name": "default-nodepool",
    "resource_group_id": "rg-acfmyvw****"
  }
}
EOF
)"