DescribeZones - ApsaraDB for SelectDB - Alibaba Cloud Documentation Center

Describes the available zones.

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
RegionId	string	Yes	The region ID.	cn-beijing
MaxResults	integer	No	If you do not specify the MaxResults request parameter, paged query is disabled. The MaxResults response parameter indicates the total number of entries. If you specify the MaxResults request parameter, paged query is enabled. The MaxResults response parameter indicates the number of entries on the current page.	10
NextToken	string	No	The token for the next page of results.	40831b4f-d91d-4796-9589-ad306ec528d5

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	Id of the request	ADF42B18-43FD-5100-83A9-BE81AB70C863
Items	array<object>	The list of results.
	object	A list of zone information.
RegionId	string	The region ID.	cn-beijing
ZoneId	string	The zone ID.	cn-beijing-i
MaxResults	integer	The number of entries per page for a paged query.	20
NextToken	string	The token for the next page of results. If this parameter is empty, all results have been returned.	40831b4f-d91d-4796-9589-ad306ec528d5

Examples

Success response

JSON format

{
  "RequestId": "ADF42B18-43FD-5100-83A9-BE81AB70C863",
  "Items": [
    {
      "RegionId": "cn-beijing",
      "ZoneId": "cn-beijing-i"
    }
  ],
  "MaxResults": 20,
  "NextToken": "40831b4f-d91d-4796-9589-ad306ec528d5"
}

Error codes

HTTP status code	Error code	Error message	Description
400	SystemError	A system error occurred while processing your request.	The system is abnormal.
400	ClusterNotSupport	Current instance cluster does not support this operation.	The operation is not supported in the current cluster state.
400	Forbidden	User not authorized to operate on the specified resource, or this API does not support RAM.	english description1
400	InvalidChargeType.NotSupport	The specified parameter "ChargeType" does not meet the requirements.
400	InvalidDBName.Duplicate	Specified DB name already exists in the This instance.	New Cluster Name
400	InvalidClusterName.Format	Specified ClusterName is not valid. It can not be empty string.	The entered cluster name parameter is invalid.
400	MinorVersionNotSupport	The instance version does not support the current operation.	The instance version does not support the current operation.
403	DBClusterNotSupported	The requested operation can not be performed while the cluster is not sale.	The requested operation cannot be performed while the cluster is not running.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	english description1
403	OperationDenied.VirtualClusterBound	The operation is not permitted due to it has been bound to a virtual cluster.	Operation is not allowed because it is bound to a virtual cluster.
404	DBInstanceLocked	The current instance lock mode does not support this operation.	english description1
404	InvalidApi.NotFound	Specified api is not found, please check your url and method.
404	InvalidDBInstanceId.NotFound	The DBInstanceId provided does not exist in our records.	Instance does not exist.
404	InvalidParam	Invalid parameter, please check.
404	InvalidClusterName.NotFound	The specified cluster name is not available.	The specified cluster name is not available

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.