This topic describes how to use Alibaba Cloud CLI version 3.0.25 or later to call other API operations.

DescribeRegions

You can call this operation to query available regions.

Parameter Type Required Example Description
--AcceptLanguage String No zh-CN

The natural language that is used to filter responses. For more information, see RFC 7231.

Valid values: zh-CN, en-US, and ja.

Default value: zh-CN.

Sample requests

aliyun ros DescribeRegions --AcceptLanguage zh-CN

Sample success responses

{
        "RequestId": "57B6379F-0446-4B09-A1A2-318F0E70010C",
        "Regions": [
                {
                        "RegionId": "cn-qingdao",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Qingdao)"
                },
                {
                        "RegionId": "cn-beijing",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Beijing)"
                },
                {
                        "RegionId": "cn-zhangjiakou",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Zhangjiakou-Beijing Winter Olympics"
                },
                {
                        "RegionId": "cn-huhehaote",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Hohhot)"
                },
                {
                        "RegionId": "cn-hangzhou",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Hangzhou)"
                },
                {
                        "RegionId": "cn-shanghai",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Shanghai)"
                },
                {
                        "RegionId": "cn-shenzhen",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Shenzhen)"
                },
                {
                        "RegionId": "cn-chengdu",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Chengdu)"
                },
                {
                        "RegionId": "cn-hongkong",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "China (Hong Kong)"
                },
                {
                        "RegionId": "ap-northeast-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Japan (Tokyo)"
                },
                {
                        "RegionId": "ap-southeast-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Singapore"
                },
                {
                        "RegionId": "ap-southeast-2",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Australia (Sydney)"
                },
                {
                        "RegionId": "ap-southeast-3",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Malaysia (Kuala Lumpur)"
                },
                {
                        "RegionId": "ap-southeast-5",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Indonesia (Jakarta)"
                },
                {
                        "RegionId": "ap-south-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "India (Mumbai)"
                },
                {
                        "RegionId": "us-east-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "US (Virginia)"
                },
                {
                        "RegionId": "us-west-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "US (Silicon Valley)"
                },
                {
                        "RegionId": "eu-west-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "UK (London)"
                },
                {
                        "RegionId": "me-east-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "UAE (Dubai)"
                },
                {
                        "RegionId": "eu-central-1",
                        "RegionEndpoint": "ros.aliyuncs.com",
                        "LocalName": "Germany (Frankfurt)"
                }
        ]
}

SignalResource

You can call this operation to send signals.

Parameter Type Required Example Description
--RegionId String Yes cn-hangzhou

The region ID of the stack. You can call the DescribeRegions operation to query the most recent region list.

--StackId String Yes 4a6c9851-3b0f-4f5f-b4ca-a14bf691****

The ID of the stack.

--LogicalResourceId String Yes WebServer

The logical resource ID defined in the template.

--Status String Yes SUCCESS

The status of the signal. Failure signals can cause stack creation or update to fail. If all signals are warnings, the stack cannot be created or updated. Valid values:

  • SUCCESS
  • FAILURE
  • WARNING
--UniqueId String Yes 27c7347b-352a-4377-accf-63d361c1****

The unique ID of the signal. If multiple signals are sent to a single resource, each signal must have a unique ID.

The signal ID must be 1 to 64 characters in length.

--ClientToken String No 123e4567-e89b-12d3-a456-42665544****

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can only contain ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

Sample requests

aliyun ros SignalResource --StackId bd98e636-68e9-4632-82df-ce2aba56**** --LogicalResourceId WebServer --Status SUCCESS --UniqueId 36fd647b-g472-6426-accf-63d361c1****

Sample success responses

{
        "RequestId":"36DE4C6C-1F85-425F-9083-FEB040B8BB21"
}