Promo Center

50% off for new user

Direct Mail-46% off

Learn More

DescribeRegions

Updated at: 2024-09-03 02:48

Queries all regions and zones supported for an ApsaraDB for MongoDB instance.

Operation description

Note
To query available regions and zones in which an ApsaraDB for MongoDB instance can be created, call the DescribeAvailableResource operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ParameterTypeRequiredDescriptionExample
RegionIdstringNo

The region ID.

Note
If you do not specify this parameter, all supported regions are queried.
cn-hangzhou
AcceptLanguagestringNo

The language of the values of the returned RegionName and ZoneName parameters. Valid values:

  • zh (default)
  • en
zh

Response parameters

ParameterTypeDescriptionExample
ParameterTypeDescriptionExample
object

The regions and zones.

RequestIdstring

The request ID.

4E46C22C-D3B7-4DB8-9C76-63851BE68E20
Regionsarray<object>

The regions.

object

The region.

Zonesarray<object>

The zones.

object

The zone.

ZoneIdstring

The zone ID.

cn-hangzhou-h
VpcEnabledboolean

Indicates whether a virtual private cloud (VPC) is supported. Valid values:

  • true: VPC is supported.
  • false: VPC is not supported.
true
ZoneNamestring

The name of the zone.

The value of the ZoneName parameter is in the language that is specified by the AcceptLanguage parameter. For example, if the value of the ZoneId parameter in the response is cn-hangzhou-h, the following values are returned for the ZoneName parameter:

  • If the value of the AcceptLanguage parameter is zh, the value H is returned for the ZoneName parameter.
  • If the value of the AcceptLanguage parameter is en, the value Hangzhou Zone H is returned for the ZoneName parameter.
Hangzhou Zone H
RegionIdstring

The region ID.

cn-hangzhou
EndPointstring

The public endpoint of the region.

For example, if the value of the RegionId parameter in the response is cn-hangzhou, the following value is returned for the EndPoint parameter:

  • mongodb.aliyuncs.com
mongodb.aliyuncs.com

Examples

Sample success responses

JSONformat

{
  "RequestId": "4E46C22C-D3B7-4DB8-9C76-63851BE68E20",
  "Regions": {
    "DdsRegion": [
      {
        "Zones": {
          "Zone": [
            {
              "ZoneId": "cn-hangzhou-h",
              "VpcEnabled": true,
              "ZoneName": "Hangzhou Zone H"
            }
          ]
        },
        "RegionId": "cn-hangzhou",
        "RegionName": "China (Hangzhou)",
        "EndPoint": "mongodb.aliyuncs.com"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
Change timeSummary of changesOperation
2023-09-01The response structure of the API has changedView Change Details
2022-03-31The request parameters of the API has changed. The response structure of the API has changedView Change Details
2022-03-31The request parameters of the API has changed. The response structure of the API has changedView Change Details
  • On this page (1)
  • Operation description
  • Debugging
  • Authorization information
  • Request parameters
  • Response parameters
  • Examples
  • Error codes
  • Change history
Feedback
phone Contact Us

Chat now with Alibaba Cloud Customer Service to assist you in finding the right products and services to meet your needs.

alicare alicarealicarealicare