Queries the details of one or more ApsaraDB for Redis instances.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeInstances |
The operation that you want to perform. Set the value to DescribeInstances. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the instance. Note This parameter is required if you specify the Tag.N.Key and Tag.N.Value parameters when you call the operation.
|
InstanceIds | String | No | r-bp1zxszhcgatnx**** |
The ID of the instance. Note If you specify multiple instance IDs, separate the instance IDs with commas (,).
|
InstanceStatus | String | No | Normal |
The state of the instance. Valid values:
Note For more information about instance states, see Instance states and impacts.
|
ChargeType | String | No | PostPaid |
The billing method of the instance. Default value: PostPaid. Valid values:
|
NetworkType | String | No | CLASSIC |
The network type of the instance. Valid values:
|
EngineVersion | String | No | 4.0 |
The database engine version of the instance. Valid values: 2.8, 4.0, and 5.0. |
InstanceClass | String | No | redis.master.small.default |
The instance type. For more information, see Instance types. |
VpcId | String | No | vpc-bp1nme44gek34slfc**** |
The ID of the VPC. |
VSwitchId | String | No | vsw-bp1e7clcw529l773d**** |
The ID of the vSwitch to which the instance is connected. |
PageNumber | Integer | No | 1 |
The number of the page to return. Pages start from page 1. Default value: 1. |
PageSize | Integer | No | 10 |
The number of entries to return on each page. Maximum value: 50. Default value: 10. |
InstanceType | String | No | Redis |
The database engine of the instance. Valid values:
|
SearchKey | String | No | apitest |
The keyword used for fuzzy search. The keyword can be based on an instance name or an instance ID. |
ArchitectureType | String | No | standard |
The architecture of the instance. Valid values:
|
Expired | String | No | false |
Specifies whether the instance has expired. Valid values:
|
ZoneId | String | No | cn-hongkong-b |
The zone ID of the instance. |
ResourceGroupId | String | No | rg-acfmyiu4ekp**** |
The ID of the resource group to which the instance belongs. Note You can query resource group IDs by using the ApsaraDB for Redis console or by calling
the ListResourceGroups operation. For more information, see View basic information of a resource group.
|
GlobalInstance | Boolean | No | true |
Specifies whether to return the child instances of distributed instances. Valid values:
|
EditionType | String | No | Enterprise |
The edition of the instance. Valid values:
|
PrivateIp | String | No | 172.16.49.*** |
The private IP address of the instance. |
Tag.N.Key | String | No | Storage type |
The key of tag N of the instance. A tag is a key-value pair. Note Valid values of N: 1 to 5.
|
Tag.N.Value | String | No | Local disk |
The value of tag N of the instance. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 1E83311F-0EE4-4922-A3BF-730B312B**** |
The ID of the request. |
PageNumber | Integer | 1 |
The page number of the returned page. |
PageSize | Integer | 30 |
The number of entries returned per page. |
TotalCount | Integer | 1 |
The total number of instances that were queried. |
Instances | Array of KVStoreInstance |
Details of the instances. |
|
KVStoreInstance | |||
VpcId | String | vpc-bp1nme44gek34slfc**** |
The ID of the VPC. |
PrivateIp | String | 172.16.49.*** |
The private IP address of the instance. Note This parameter is not returned when the instance is deployed in the classic network.
|
Capacity | Long | 4096 |
The storage capacity of the instance. Unit: MB. |
ReplacateId | String | grr-bp11381ebc16**** |
The logical ID of the replica instance. |
CreateTime | String | 2018-11-07T08:49:00Z |
The time when the instance was created. |
ConnectionDomain | String | r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com |
The internal endpoint of the instance. |
IsRds | Boolean | true |
Indicates whether the instance is managed by ApsaraDB RDS. Valid values:
|
ChargeType | String | PostPaid |
The billing method of the instance. Valid values:
|
ArchitectureType | String | cluster |
The architecture of the instance. Default value: NULL. Valid values:
|
NetworkType | String | CLASSIC |
The network type of the instance. Valid values:
|
ConnectionMode | String | Standard |
The connection mode of the instance. Valid values:
|
Port | Long | 6379 |
The service port of the instance. |
SecondaryZoneId | String | cn-hangzhou-h |
The ID of the secondary zone. Note If multiple zones are returned for ZoneId such as cn-hangzhou-MAZ10(h,i), this parameter is ignored.
|
EngineVersion | String | 4.0 |
The database engine version of the instance. Valid values: 2.8, 4.0, and 5.0. |
PackageType | String | standard |
The plan type. Valid values:
|
Config | String | {\"maxmemory-policy\":\"volatile-lfu\",\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64,\"#no_loose_disabled-commands\":\"flushall,flushdb\",\"lazyfree-lazy-eviction\":\"yes\"} |
The parameter configurations of the instance. For more information, see Modify parameters of an instance. |
Bandwidth | Long | 96 |
The bandwidth of the instance. Unit: MB/s. |
InstanceName | String | apitest |
The name of the instance. |
ShardCount | Integer | 3 |
The number of data shards in the instance. Note This parameter is returned only if the instance is a cluster instance that uses cloud
disks.
|
UserName | String | r-bp1zxszhcgatnx**** |
The username that is used to connect to the instance. By default, the username that is named after the instance ID is returned. |
GlobalInstanceId | String | gr-bp14rkqrhac**** |
The ID of the distributed instance. Note This parameter is returned only if the instance is a child instance of a distributed
instance.
|
QPS | Long | 100000 |
The expected maximum queries per second (QPS). |
InstanceClass | String | redis.logic.sharding.2g.2db.0rodb.4proxy.default |
The instance type. |
DestroyTime | String | 2019-04-28T10:03:01Z |
The time when the instance was deleted. |
InstanceId | String | r-bp1zxszhcgatnx**** |
The ID of the instance. |
InstanceType | String | Redis |
The database engine type of the instance. Valid values:
|
HasRenewChangeOrder | Boolean | false |
Indicates whether your Alibaba Cloud account has pending orders for renewal and configuration change. Valid values:
|
RegionId | String | cn-hangzhou |
The ID of the region. |
EndTime | String | 2019-06-13T16:00:00Z |
The time when the instance expires if the instance is charged based on the subscription billing method. |
VSwitchId | String | vsw-bp1e7clcw529l773d**** |
The ID of the vSwitch to which the instance is connected. |
NodeType | String | double |
The node type. Valid values:
|
Connections | Long | 20000 |
The maximum number of connections supported by the instance. |
ResourceGroupId | String | rg-acfmyiu4ekp**** |
The ID of the resource group to which the instance belongs. |
ZoneId | String | cn-hangzhou-b |
The zone ID of the instance. |
InstanceStatus | String | Normal |
The state of the instance. Valid values:
|
CloudType | String | cloudbox |
This parameter is returned only if the instance is in a cloud box. |
EditionType | String | Enterprise |
The edition of the instance. Valid values:
|
Tags | Array of Tag |
The details of the tags. |
|
Tag | |||
Key | String | key1 |
The key of the tag. |
Value | String | value1 |
The value of the tag. |
Examples
Sample requests
https://r-kvstore.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&<Common request parameters>
Sample success response
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeInstancesResponse>
<Instances>
<KVStoreInstance>
<Connections>10000</Connections>
<ResourceGroupId>rg-acfmyiu4ekp****</ResourceGroupId>
<Config>{"EvictionPolicy":"volatile-lru","hash-max-ziplist-entries":512,"zset-max-ziplist-entries":128,"list-max-ziplist-entries":512,"list-max-ziplist-value":64,"zset-max-ziplist-value":64,"set-max-intset-entries":512,"hash-max-ziplist-value":64}</Config>
<Port>6379</Port>
<HasRenewChangeOrder>false</HasRenewChangeOrder>
<ConnectionDomain>r-bp1wcw2rlw76acc5k****.redis.rds.aliyuncs.com</ConnectionDomain>
<Capacity>1024</Capacity>
<QPS>80000</QPS>
<PrivateIp>172.16.49.***</PrivateIp>
<InstanceStatus>Normal</InstanceStatus>
<NetworkType>VPC</NetworkType>
<Bandwidth>10</Bandwidth>
<PackageType>standard</PackageType>
<InstanceType>Redis</InstanceType>
<Tags>
<Tag>
<Value>Community Edition</Value>
<Key>Type</Key>
</Tag>
</Tags>
<ArchitectureType>standard</ArchitectureType>
<UserName>r-bp1wcw2rlw76ac****</UserName>
<EngineVersion>5.0</EngineVersion>
<ZoneId>cn-hangzhou-f</ZoneId>
<InstanceId>r-bp1wcw2rlw76ac****</InstanceId>
<VSwitchId>vsw-bp1w9ouei2nm66qlz****</VSwitchId>
<CreateTime>2020-03-31T06:56:22Z</CreateTime>
<InstanceClass>redis.master.small.default</InstanceClass>
<IsRds>true</IsRds>
<InstanceName>Master-replica instances of Community Edition 50</InstanceName>
<VpcId>vpc-bp1opxu1zkhn00gzv****</VpcId>
<ChargeType>PostPaid</ChargeType>
<NodeType>double</NodeType>
<RegionId>cn-hangzhou</RegionId>
</KVStoreInstance>
</Instances>
<TotalCount>1</TotalCount>
<RequestId>78DDAA9A-B09E-4BE0-AEAE-10A22924****</RequestId>
<PageSize>30</PageSize>
<PageNumber>1</PageNumber>
</DescribeInstancesResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"Instances" : {
"KVStoreInstance" : [ {
"Connections" : 10000,
"ResourceGroupId" : "rg-acfmyiu4ekp****",
"Config" : "{\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"list-max-ziplist-entries\":512,\"list-max-ziplist-value\":64,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64}",
"Port" : 6379,
"HasRenewChangeOrder" : false,
"ConnectionDomain" : "r-bp1wcw2rlw76acc5k****.redis.rds.aliyuncs.com",
"Capacity" : 1024,
"QPS" : 80000,
"PrivateIp" : "172.16.49.***",
"InstanceStatus" : "Normal",
"NetworkType" : "VPC",
"Bandwidth" : 10,
"PackageType" : "standard",
"InstanceType" : "Redis",
"Tags" : {
"Tag" : [ {
"Value" : "Community Edition",
"Key" : "Type"
} ]
},
"ArchitectureType" : "standard",
"UserName" : "r-bp1wcw2rlw76ac****",
"EngineVersion" : "5.0",
"ZoneId" : "cn-hangzhou-f",
"InstanceId" : "r-bp1wcw2rlw76ac****",
"VSwitchId" : "vsw-bp1w9ouei2nm66qlz****",
"CreateTime" : "2020-03-31T06:56:22Z",
"InstanceClass" : "redis.master.small.default",
"IsRds" : true,
"InstanceName" : "Master-replica instances of Community Edition 50",
"VpcId" : "vpc-bp1opxu1zkhn00gzv****",
"ChargeType" : "PostPaid",
"NodeType" : "double",
"RegionId" : "cn-hangzhou"
} ]
},
"TotalCount" : 1,
"RequestId" : "78DDAA9A-B09E-4BE0-AEAE-10A22924****",
"PageSize" : 30,
"PageNumber" : 1
}
Error codes
For a list of error codes, visit the API Error Center.