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

JSON dizileri

• Linux / macOS: Dış katman için tek tırnak, iç değerler için çift tırnak kullanın.

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

• Windows (Komut İstemi ve PowerShell): Dış katman için çift tırnak, iç değerler için tek tırnak kullanın.

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

JSON nesneleri

Bir parametre değeri JSON nesnesi olduğunda, her JSON nesnesini süslü parantez {} içine alın ve anahtarlarla değerleri iki nokta üst üste : ile ayırın.

• Linux / macOS:

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

• Windows (Komut İstemi ve PowerShell):

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

Tire (-) ile başlayan değerler

Bir parametre değeri - ile başladığında, CLI bunu başka bir parametre adı olarak yanlış yorumlayabilir:

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

Bu sorunu çözmek için parametre adı ve değerini bağlamak amacıyla eşittir işareti kullanın:

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

Kabuk özel karakterleri

Parametre değerleri kabuk özel karakterleri ($, , \, boşluk vb.) içerdiğinde bunları tırnak işaretleri içine almanız gerekir. Linux / macOS'ta kabuğun özel karakterleri yorumlamasını önlemek için tek tırnak kullanın. Windows Komut İstemi'nde çift tırnak kullanın.

# 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 (RESTful API çağrıları)

RESTful API çağrılarında, HTTP istek gövdesini yerel bir dosyadan yüklemek için --body-file kullanın.

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

Kabuk komut ikamesi ve here-doc

Dosya içeriğini --body parametresine iletmek için kabuk komut ikamesini ($(cat ...)) veya here-doc'u da kullanabilirsiniz:

# 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
)"