All Products
Search
Document Center

KVCacheStore:DescribeZones

Last Updated:Sep 04, 2026

Queries the list of available zones for KVCacheStore in a specified region.

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, such as cn-hangzhou.

cn-hangzhou

Response elements

Element

Type

Description

Example

object

DescribeZonesResponse

Zones

array<object>

The list of zones.

object

ZoneId

string

The zone ID.

cn-hangzhou-a

LocalName

string

The localized name of the zone.

Hangzhou Zone A

RequestId

string

The request ID. The request ID is returned regardless of whether the API call is successful.

6AA27F1A-A62C-59C3-BCC7-D1DFA4E7EEA0

Examples

Success response

JSON format

{
  "Zones": [
    {
      "ZoneId": "cn-hangzhou-a",
      "LocalName": "杭州 可用区A"
    }
  ],
  "RequestId": "6AA27F1A-A62C-59C3-BCC7-D1DFA4E7EEA0"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The parameter %s is invalid.
400 InvalidParameter.Conflict The specified parameter %s and %s are not blank at the same time.
400 InvalidParameter.Format Specified parameter format is not valid.
400 MissingParameter The input parameter %s that is mandatory for processing this request is not supplied.
500 InternalError The request processing has failed due to some unknown error, exception or failure.
403 Forbidden User is not authorized to operate.
403 Forbidden.Action User is not authorized to operate this action.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 LastTokenProcessing The last token request is processing.
403 NoPermission.SLR The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS.
403 OperationDenied The operation is not allowed.
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
504 RequestTimeout The request is timeout, please try again later.
429 BLOCK.LimitedRequest Request was denied due to user flow control.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.