Queries regions where the Resource Sharing service is available.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeRegions

The operation that you want to perform. Set the value to DescribeRegions.

RegionId String Yes cn-hangzhou

The region ID. Valid values:

  • cn-hangzhou: China (Hangzhou)
  • cn-shanghai: China (Shanghai)
  • cn-beijing: China (Beijing)
  • cn-zhangjiakou: China (Zhangjiakou)
  • ap-southeast-1: Singapore (Singapore)
AcceptLanguage String No zh-CN

The supported natural language. Valid values:

  • zh-CN: Chinese
  • en-US: English

For more information about common parameters, see Common parameters.

Response parameters

Parameter Type Example Description
Regions Array of Region

The information of the regions.

LocalName String China (Hangzhou)

The region name.

RegionEndpoint String resourcesharing.cn-hangzhou.aliyuncs.com

The region endpoint.

RegionId String cn-hangzhou

The region ID.

RequestId String 0D64A198-5842-4570-8E26-5E540CDC84CD

The ID of the request.

Examples

Sample requests

https://resourcesharing.aliyuncs.com/?Action=DescribeRegions
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeRegionsResponse>
	  <RequestId>0D64A198-5842-4570-8E26-5E540CDC84CD</RequestId>
	  <Regions>
		    <RegionId>cn-hangzhou</RegionId>
		    <RegionEndpoint>resourcesharing.cn-hangzhou.aliyuncs.com</RegionEndpoint>
		    <LocalName>China (Hangzhou)</LocalName>
	  </Regions>
	  <Regions>
		    <RegionId>cn-shanghai</RegionId>
		    <RegionEndpoint>resourcesharing.cn-shanghai.aliyuncs.com</RegionEndpoint>
		    <LocalName>China (Shanghai)</LocalName>
	  </Regions>
	  <Regions>
		    <RegionId>cn-beijing</RegionId>
		    <RegionEndpoint>resourcesharing.cn-beijing.aliyuncs.com</RegionEndpoint>
		    <LocalName>China (Beijing)</LocalName>
	  </Regions>
	  <Regions>
		    <RegionId>cn-zhangjiakou</RegionId>
		    <RegionEndpoint>resourcesharing.cn-zhangjiakou.aliyuncs.com</RegionEndpoint>
		    <LocalName>China (Zhangjiakou)</LocalName>
	  </Regions>
	  <Regions>
		    <RegionId>ap-southeast-1</RegionId>
		    <RegionEndpoint>resourcesharing.ap-southeast-1.aliyuncs.com</RegionEndpoint>
		    <LocalName>Singapore (Singapore)</LocalName>
	  </Regions>
</DescribeRegionsResponse>

JSON format

{
  "RequestId": "0D64A198-5842-4570-8E26-5E540CDC84CD",
  "Regions": [
    {
      "RegionId": "cn-hangzhou",
      "RegionEndpoint": "resourcesharing.cn-hangzhou.aliyuncs.com",
      "LocalName": "China (Hangzhou)"
    },
    {
      "RegionId": "cn-shanghai",
      "RegionEndpoint": "resourcesharing.cn-shanghai.aliyuncs.com",
      "LocalName": "China (Shanghai)"
    },
    {
      "RegionId": "cn-beijing",
      "RegionEndpoint": "resourcesharing.cn-beijing.aliyuncs.com",
      "LocalName": "China (Beijing)"
    },
    {
      "RegionId": "cn-zhangjiakou",
      "RegionEndpoint": "resourcesharing.cn-zhangjiakou.aliyuncs.com",
      "LocalName": "China (Zhangjiakou)"
    },
    {
      "RegionId": "ap-southeast-1",
      "RegionEndpoint": "resourcesharing.ap-southeast-1.aliyuncs.com",
      "LocalName": "Singapore (Singapore)"
    }
  ]
}

Error codes

For a list of error codes, visit the API Error Center.