You can call DescribeAvailableResource to query the types of ApsaraDB for Redis instances that can be created in a specified zone.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeAvailableResource

The operation that you want to perform. Set this parameter to DescribeAvailableResource.

RegionId String Yes cn-beijing

The ID of the region. You can call the DescribeRegions operation to query the latest region list.

ZoneId String No cn-beijing-c

The ID of the zone. You can call the DescribeZones operation to query the zone ID.

InstanceChargeType String No PrePaid

The payment type. Valid values:

  • PrePaid: subscription.
  • PostPaid: pay-as-you-go.
Note Default value: PrePaid.
Engine String No redis

The engine type. Valid values:

  • redis
  • memcache

Response parameters

Parameter Type Example Description
AvailableZones Array

The detailed information of ApsaraDB for Redis instances that can be created in the zone.

RegionId String cn-beijing

The ID of the region.

SupportedEngines Array

The engine types that are supported.

Engine String ApsaraDB for Redis

The engine type of the instance.

SupportedEditionTypes Array

Supported Editions.

EditionType String Community


  • Community
  • Enterprise
SupportedSeriesTypes Array

Supported types of the series.

SeriesType String enhanced_performance_type


  • enhanced_performance_type: indicates performance-enhanced series.
  • hybrid_storage: indicates hybrid-storage series.
SupportedEngineVersions Array

The engine version list.

SupportedArchitectureTypes Array

Supported architecture types.

Architecture String cluster


  • standard: the standard master-replica edition.
  • cluster: the cluster edition.
  • rwsplit: the read/write-splitting edition.
SupportedShardNumbers Array

Number of shards supported.

ShardNumber String 8

The number of shards.

SupportedNodeTypes Array

Supported node types.

AvailableResources Array

The detailed information about available instance types in the zone.

InstanceClass String redis.logic.sharding.2g.8db.0rodb.8proxy.default

The specification code. In the Help Center, enter an instance type code in the search box to view the instance type information.

InstanceClassRemark String 16 GB Cluster Edition (Sharding)(QPS:2000000 Connections:80000)

The description of the instance type.

SupportedNodeType String double

The node type of the instance. Valid values:

  • single: single-node.
  • double: master-replica.
Version String 5.0

The engine version of the instance.

ZoneId String cn-beijing-c

The ID of the zone.

ZoneName String Beijing Zone C

The name of the zone.

RequestId String 128BD75D-A423-4235-B777-811429BB6E4D

The ID of the request.


Sample request
&<Common request parameters>

Sample success responses

XML format

                <ZoneName> Beijing Zone C</ZoneName>
                                                                                                              <InstanceClass> redis.logic.sharding.2g.8db.0rodb.8proxy.default</InstanceClass>
                                                                                                              <InstanceClassRemark>16 GB Cluster Edition (Sharding)(QPS:2000000 Connections:80000)</InstanceClassRemark>

JSON format

    "RequestId": "5094D428-5CC5-4494-A8B4-59BBBDEDABF5",
    "AvailableZones": {
        "AvailableZone": {
            "ZoneName": "Beijing Zone C",
            "ZoneId": "cn-beijing-c",
            "SupportedEngines": {
                "SupportedEngine": {
                    "SupportedEditionTypes": {
                        "SupportedEditionType": {
                            "EditionType": "Community",
                            "SupportedSeriesTypes": {
                                "SupportedSeriesType": {
                                    "SupportedEngineVersions": {
                                        "SupportedEngineVersion": {
                                            "SupportedArchitectureTypes": {
                                                "SupportedArchitectureType": {
                                                    "SupportedShardNumbers": {
                                                        "SupportedShardNumber": {
                                                            "ShardNumber": 8,
                                                            "SupportedNodeTypes": {
                                                                "SupportedNodeType": {
                                                                    "AvailableResources": {
                                                                        "AvailableResource": {
                                                                            "InstanceClass": "redis.logic.sharding.2g.8db.0rodb.8proxy.default",
                                                                            "InstanceClassRemark": "16 GB Cluster Edition (Sharding)(QPS:2000000 Connections:80000)"
                                                                    "SupportedNodeType": "double"
                                                    "Architecture": "cluster"
                                            "Version": 5
                                    "SeriesType": "enhanced_performance_type"
                    "Engine": "redis"

Error codes

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