How Do I Leave a Body Parameter Empty for Cloud Service APIs?

• A map parameter can be left empty as {} at the corresponding level.
• An array parameter can be left empty as [] at the corresponding level.

Take the BatchStopServers operation of ECS as an example. There are two parameters in the body: os-stop.servers.[N].id and os-stop.type.

cloud ECS BatchStopServers --cli-region=ru-moscow-1 --help

Cloud CLI Version 4.2.12

Service:
  ECS

Description:
This API is used to stop ECSs in a batch based on the specified ECS ID list. A maximum of 1000 ECSs can be stopped at a time.

Method:
  POST

Params:
  --cli-region
    required    string  Region where the API can be called. If no region is specified in the command, cli-region in the current profile is used.
  --os-stop.servers.[N].id
    required    string  body    ECS Instance ID. Format: --os-stop.servers.1.id=value1 ...
  --project_id
    required    string  path    Specifies the project ID. If no project ID is specified in the command, either the parent project ID of the specified region in the authentication information or cli-project-id in the current profile is used.
  --os-stop.type
    optional    string  body    Specifies an ECS stop type. The default value is SOFT. [SOFT|HARD]
    - SOFT: normal ECS stop (default)
    - HARD: forcible ECS stop

• No parameters left empty

  Pass the values of os-stop.servers.[N].id and os-stop.type, and run --dryrun to view the request body:

  cloud ECS BatchStopServers --cli-region=ru-moscow-1 --os-stop.servers.1.id="test" --os-stop.type="SOFT" --dryrun
  -------- The execution is eliminated in dry-run mode. Current request: --------
  POST https://ecs.ru-moscow-1.hc.sbercloud.ru/v1/0a152ab****************262d035e8/cloudservers/action
  Content-Type: application/json;charset=UTF-8
  X-Project-Id: 0a152ab****************262d035e8
  X-Sdk-Date: 20221116T121721Z
  Authorization: ****
  
  {
    "os-stop": {
      "servers": [
        {
          "id": "test"
        }
      ],
      "type": "SOFT"
    }
  }
  
  

• Array parameter left empty

  Pass --os-stop.servers="[]" for the array parameter os-stop.servers of os-stop.servers.[N].id to leave [N] and the remaining part empty. Then run --dryrun to view the request body:

  cloud ECS BatchStopServers --cli-region=ru-moscow-1 --os-stop.servers="[]" --os-stop.type="SOFT" --dryrun
  -------- The execution is eliminated in dry-run mode. Current request: --------
  POST https://ecs.ru-moscow-1.hc.sbercloud.ru/v1/0a152ab****************262d035e8/cloudservers/action
  X-Project-Id: 0a152ab****************262d035e8
  X-Sdk-Date: 20221116T122841Z
  Authorization: ****
  Content-Type: application/json;charset=UTF-8
  
  {
    "os-stop": {
      "servers": [],
      "type": "SOFT"
    }
  }
  
  

• Map parameter left empty

  Pass --os-stop="{}" for the common parent os-stop of os-stop.servers.[N].id and os-stop.type to leave the map parameter empty. Then run --dryrun to view the request body:

  cloud ECS BatchStopServers --cli-region=ru-moscow-1 --os-stop="{}" --dryrun
  -------- The execution is eliminated in dry-run mode. Current request: --------
  POST https://ecs.ru-moscow-1.hc.sbercloud.ru/v1/0a152ab****************262d035e8/cloudservers/action
  Content-Type: application/json;charset=UTF-8
  X-Project-Id: 0a152ab****************262d035e8
  X-Sdk-Date: 20221117T013616Z
  Authorization: ****
  
  {
    "os-stop": {}
  }