All Products
Search
Document Center

Smart Access Gateway:DescribeRegions

Last Updated:Mar 24, 2026

Queries available regions.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

AcceptLanguage

string

No

The language of the response. Valid values:

  • zh-CN (default): Chinese

  • en-US: English

  • ja: Japanese

zh-CN

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1

Regions

object

Region

array<object>

A list of regions.

object

LocalName

string

The name of the region.

China (Shanghai)

RegionEndpoint

string

The endpoint of the Smart Access Gateway (SAG) service in the current region.

smartag.cn-shanghai.aliyuncs.com

RegionId

string

The ID of the region.

cn-shanghai

Examples

Success response

JSON format

{
  "RequestId": "2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1",
  "Regions": {
    "Region": [
      {
        "LocalName": "China (Shanghai)",
        "RegionEndpoint": "smartag.cn-shanghai.aliyuncs.com",
        "RegionId": "cn-shanghai"
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

501 InnerServiceFailed Call inner service failed. An error occurred while invoking internal services.
403 Forbidden User not authorized to operate on the specified resource. You do not have permissions to manage the specified resource.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.