Queries detailed information of an ApsaraDB for Redis instance.

Debugging

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 DescribeInstanceAttribute

The operation that you want to perform. Set the value to DescribeInstanceAttribute.

InstanceId String Yes r-bp1zxszhcgatnx****

The ID of the instance.

RegionId String No cn-hangzhou

The region ID of the instance.

Response parameters

Parameter Type Example Description
Instances Array of DBInstanceAttribute

The information of the instance.

DBInstanceAttribute
ArchitectureType String standard

The architecture of the instance. Valid values:

  • cluster: The instance is a cluster instance.
  • standard: The instance is a standard instance.
  • rwsplit: The instance is a read/write splitting instance.
AuditLogRetention String 15

The retention period of audit logs. Unit: days. A value of 0 indicates that the audit log feature is disabled. For more information about how to enable the audit log feature, see Enable the new version of the audit log feature.

AvailabilityValue String 100%

The availability metric of the current month.

BackupLogStartTime String 2021-07-06T05:49:55Z

The earliest point in time to which you can restore data. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mmZ format. The time is displayed in UTC.

Note
  • This parameter is returned only when the data flashback feature is enabled for the instance. For more information, see Restore data to a point in time by using the data flashback feature.
  • When you call the RestoreInstance operation to implement data flashback, you can determine the earliest point in time for data flashback based on the return value of this parameter. The preceding earliest point in time is also the earliest point in time that can be specified by the RestoreTime parameter.
Bandwidth Long 10

The bandwidth of the instance. Unit: MB/s.

Capacity Long 1024

The storage capacity of the instance. Unit: MB.

ChargeType String PostPaid

The billing method of the instance. Valid values:

  • PrePaid: subscription
  • PostPaid: pay-as-you-go
Config String {\"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}

The parameter configurations of the instance in the JSON format. For more information, see Modify the parameters of an ApsaraDB for Redis instance.

ConnectionDomain String r-bp1d72gwl41z7f****.redis.rds.aliyuncs.com

The endpoint of the instance.

Connections Long 10000

The maximum number of connections supported by the instance.

CreateTime String 2019-03-06T10:42:03Z

The time when the instance was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

EndTime String 2019-04-06T10:42:03Z

The time when the subscription expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

Engine String Redis

The database engine of the instance. The return value is Redis.

EngineVersion String 4.0

The version of the database engine that is run on the instance. Valid values: 2.8, 4.0, and 5.0.

GlobalInstanceId String gr-bp14rkqrhac****

The ID of the distributed instance to which the instance belongs.

Note This parameter is returned only if the instance is a child instance of the distributed instance.
HasRenewChangeOrder String false

Indicates whether your Alibaba Cloud account has pending orders for renewal and configuration change. Valid values:

  • true
  • false
InstanceClass String redis.master.small.default

The instance type.

InstanceId String r-bp1d72gwl41z7f****

The ID of the instance.

InstanceName String apitest

The name of the instance.

InstanceReleaseProtection Boolean false

Indicates whether the release protection feature is enabled for the instance. Valid values:

  • true: The release protection feature is enabled.
  • false: The release protection feature is disabled.
InstanceStatus String Normal

The state of the instance.

InstanceType String Redis

The database engine of the instance.

IsRds Boolean true

Indicates whether the instance is managed by ApsaraDB RDS. Valid values:

  • true
  • false
MaintainEndTime String 22:00Z

The end time of the maintenance window. The time is displayed in the HH:mmZ format.

MaintainStartTime String 18:00Z

The start time of the maintenance window. The time is displayed in the HH:mmZ format.

NetworkType String CLASSIC

The network type. Valid values:

  • CLASSIC
  • VPC
NodeType String double

The node type. Valid values:

  • double: The instance contains a master node and a replica node.
  • single: The instance contains only a master node. This node type is phrased out.
PackageType String standard

The plan type. Valid values:

  • standard: a standard plan.
  • customized: a custom plan. This plan type is phased out.
Port Long 6379

The service port of the instance.

PrivateIp String 172.16.49.***

The IP address of the instance in the virtual private cloud (VPC).

Note This parameter is not returned when the instance is deployed in the classic network.
QPS Long 100000

The expected maximum queries per second (QPS).

RegionId String cn-hongkong

The region ID of the instance.

ReplicaId String bls-awxxxxxxxxxxxxx

The ID of the replica.

ReplicationMode String master-slave

The replication architecture. Valid values:

  • master-slave: the standard mater-replica architecture.
  • cluster: the cluster architecture, which includes the read/write splitting or cluster instances.
ResourceGroupId String rg-acfmyiu4ekp****

The ID of the resource group to which the instance belongs.

SecondaryZoneId String cn-hongkong-h

The ID of the secondary zone.

Note This parameter is returned only if the instance has a secondary zone ID.
SecurityIPList String 127.0.0.1

The IP address whitelist.

ShardCount Integer 2

The number of shards. This parameter is available only for ApsaraDB for Redis instances that are purchased on the China site (aliyun.com).

Tags Array of Tag

The details of tags.

Tag
Key String tagkey

The tag key.

Value String tagvalue

The tag value.

VSwitchId String vsw-bp1e7clcw529l773d****

The ID of the vSwitch.

VpcAuthMode String Open

The VPC authentication mode. Valid values:

  • Open: enables password authentication.
  • Close: disables password authentication. The password-free access mode is enabled. For more information, see Enable password-free access.
VpcCloudInstanceId String r-bp1d72gwl41z7f****

The ID of the instance in the VPC.

VpcId String vpc-bp1nme44gek34slfc****

The ID of the VPC.

ZoneId String cn-hongkong-b

The ID of the zone.

ZoneType String singlezone

The type of the zone. Valid values:

  • singlezone: one zone in a region
  • doublezone: two zones in a region
RequestId String CA40C261-EB72-4EDA-AC57-958722162595

The ID of the request.

Examples

Sample requests

https://r-kvstore.aliyuncs.com/?Action=DescribeInstanceAttribute
&InstanceId=r-bp1zxszhcgatnx****
&<Common request parameters>

Sample success responses

XML format 

<DescribeInstanceAttributeResponse>
      <Instances>
            <DBInstanceAttribute>
                  <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>
                  <ZoneType>singlezone</ZoneType>
                  <ConnectionDomain>r-bp1wcw2rlw76acc5k****.redis.rds.aliyuncs.com</ConnectionDomain>
                  <MaintainEndTime>22:00Z</MaintainEndTime>
                  <Capacity>1024</Capacity>
                  <QPS>100000</QPS>
                  <PrivateIp>172.16.49.***</PrivateIp>
                  <SecurityIPList>127.0.0.1</SecurityIPList>
                  <InstanceStatus>Normal</InstanceStatus>
                  <NetworkType>VPC</NetworkType>
                  <Bandwidth>10</Bandwidth>
                  <PackageType>standard</PackageType>
                  <InstanceReleaseProtection>false</InstanceReleaseProtection>
                  <InstanceType>Redis</InstanceType>
                  <AvailabilityValue>100.0%</AvailabilityValue>
                  <Engine>Redis</Engine>
                  <MaintainStartTime>18:00Z</MaintainStartTime>
                  <Tags>
                        <Tag>
                              <Value>Community Edition</Value>
                              <Key>Type</Key>
                        </Tag>
                  </Tags>
                  <ArchitectureType>standard</ArchitectureType>
                  <EngineVersion>5.0</EngineVersion>
                  <ZoneId>cn-hangzhou-f</ZoneId>
                  <InstanceId>r-bp1wcw2rlw76ac****</InstanceId>
                  <VSwitchId>vsw-bp1w9ouei2nm66qlz****</VSwitchId>
                  <CreateTime>2020-03-31T14:56:22Z</CreateTime>
                  <InstanceClass>redis.master.small.default</InstanceClass>
                  <AuditLogRetention>7</AuditLogRetention>
                  <IsRds>true</IsRds>
                  <ReplicationMode>master-slave</ReplicationMode>
                  <InstanceName>CommunityEditionMasterReplica50</InstanceName>
                  <VpcId>vpc-bp1opxu1zkhn00gzv****</VpcId>
                  <ChargeType>PostPaid</ChargeType>
                  <VpcAuthMode>Open</VpcAuthMode>
                  <NodeType>double</NodeType>
                  <VpcCloudInstanceId>r-bp1wcw2rlw76ac****</VpcCloudInstanceId>
                  <RegionId>cn-hangzhou</RegionId>
            </DBInstanceAttribute>
      </Instances>
      <RequestId>D67A69DF-C1FC-4B01-B239-B17888CCFD2A</RequestId>
</DescribeInstanceAttributeResponse>

JSON format 

{
    "Instances": {
        "DBInstanceAttribute": [
            {
                "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",
                "ZoneType":"singlezone",
                "ConnectionDomain": "r-bp1wcw2rlw76acc5k****.redis.rds.aliyuncs.com",
                "MaintainEndTime": "22:00Z",
                "Capacity": 1024,
                "QPS": 100000,
                "PrivateIp": "172.16.49.***",
                "SecurityIPList": "127.0.0.1",
                "InstanceStatus": "Normal",
                "NetworkType": "VPC",
                "Bandwidth": 10,
                "PackageType": "standard",
                "InstanceReleaseProtection": false,
                "InstanceType": "Redis",
                "AvailabilityValue": "100.0%",
                "Engine": "Redis",
                "MaintainStartTime": "18:00Z",
                "Tags": {
                    "Tag": [
                        {
                            "Value": "Community Edition",
                            "Key": "Type"
                        }
                    ]
                },
                "ArchitectureType": "standard",
                "EngineVersion": "5.0",
                "ZoneId": "cn-hangzhou-f",
                "InstanceId": "r-bp1wcw2rlw76ac****",
                "VSwitchId": "vsw-bp1w9ouei2nm66qlz****",
                "CreateTime": "2020-03-31T14:56:22Z",
                "InstanceClass": "redis.master.small.default",
                "AuditLogRetention": "7",
                "IsRds": true,
                "ReplicationMode": "master-slave",
                "InstanceName": "CommunityEditionMasterReplica50",
                "VpcId": "vpc-bp1opxu1zkhn00gzv****",
                "ChargeType": "PostPaid",
                "VpcAuthMode": "Open",
                "NodeType": "double",
                "VpcCloudInstanceId": "r-bp1wcw2rlw76ac****",
                "RegionId": "cn-hangzhou"
            }
        ]
    },
    "RequestId": "D67A69DF-C1FC-4B01-B239-B17888CCFD2A"
}

Error codes

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