调用DescribeInstanceAttribute查询Redis实例的详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeInstanceAttribute

系统规定参数,取值:DescribeInstanceAttribute

InstanceId String r-bp1zxszhcgatnx****

实例ID。

RegionId String cn-hangzhou

实例所属的地域ID。

返回数据

名称 类型 示例值 描述
Instances Array of DBInstanceAttribute

实例详细信息列表。

DBInstanceAttribute
ArchitectureType String standard

实例的架构,返回值:

  • cluster:集群版。
  • standard:标准版。
  • rwsplit:读写分离版。
AuditLogRetention String 15

审计日志中设置的日志保留时间,单位为天。0代表未开通审计日志,开通方式请参见开通新版审计日志

AvailabilityValue String 100%

当月的可用性指标。

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

允许闪回的最早时间点,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

说明
  • 当Redis实例开启了数据闪回功能,才会返回本参数。
  • 调用RestoreInstance接口执行数据闪回时,可通过本参数的返回值确认允许闪回的最早时间点(即RestoreTime可传入的最早时间点)。
Bandwidth Long 10

带宽,单位:MB/s。

Capacity Long 1024

存储容量,单位:MB。

ChargeType String PostPaid

付费类型,返回值:

  • PrePaid:预付费,即包年包月。
  • PostPaid:后付费,即按量付费。
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}

实例的参数配置信息,格式为JSON,详情请参见参数说明

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

实例的连接地址。

Connections Long 10000

实例连接数限制。

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

实例创建时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

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

预付费实例到期时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Engine String Redis

数据库类型,返回值固定为Redis

EngineVersion String 4.0

数据库版本,返回值:2.84.05.06.0

GlobalInstanceId String gr-bp14rkqrhac****

所属的分布式实例ID。

说明 当Redis实例为分布式实例中的子实例时,才会返回本参数。
HasRenewChangeOrder String false

是否有未生效的续费变配订单,返回值:

  • true:是。
  • false:否。
InstanceClass String redis.master.small.default

实例规格。

InstanceId String r-bp1d72gwl41z7f****

实例ID。

InstanceName String apitest

实例名称。

InstanceReleaseProtection Boolean false

是否开启了实例释放保护,返回值:

  • true:已开启。
  • false:未开启。
InstanceStatus String Normal

实例状态。

InstanceType String Redis

实例类型。

IsRds Boolean true

是否属RDS管控,返回值:

  • true:是。
  • false:否。
MaintainEndTime String 22:00Z

可运维结束时间,格式为HH:mmZ。

MaintainStartTime String 18:00Z

可运维开始时间,格式为HH:mmZ。

NetworkType String CLASSIC

网络类型,返回值:

  • CLASSIC:经典网络。
  • VPC:专有网络。
NodeType String double

节点类型,返回值:

  • double:双副本。
  • single:单副本,已下线。
PackageType String standard

套餐类型,返回值:

  • standard:标准套餐。
  • customized:定制套餐,已下线。
Port Long 6379

Redis服务端口。

PrivateIp String 172.16.49.***

专有网络IP地址。

说明 实例的网络类型为经典网络时,不会返回本参数。
QPS Long 100000

理论最大QPS值。

RegionId String cn-hongkong

地域ID。

ReplicaId String bls-awxxxxxxxxxxxxx

副本ID。

ReplicationMode String master-slave

副本架构,返回值:

  • master-slave:标准版的主从架构。
  • cluster:集群架构,包含读写分离版或集群版。
ResourceGroupId String rg-acfmyiu4ekp****

实例所属的资源组ID。

SecondaryZoneId String cn-hongkong-h

备可用区ID。

说明 实例没有备可用区ID时,不返回本参数。
SecurityIPList String 127.0.0.1

IP白名单。

ShardCount Integer 2

分片数,本参数仅适用于中国站。

当Redis实例为集群架构的云盘实例时,才会返回本参数。

Tags Array of Tag

标签信息。

Tag
Key String tagkey

标签key。

Value String tagvalue

标签value。

VSwitchId String vsw-bp1e7clcw529l773d****

虚拟交换机ID。

VpcAuthMode String Open

VPC认证模式,返回值:

  • Open:需要密码认证。
  • Close:关闭密码认证,即开启了VPC免密功能
VpcCloudInstanceId String r-bp1d72gwl41z7f****

VPC实例ID。

VpcId String vpc-bp1nme44gek34slfc****

专有网络(VPC)的ID。

ZoneId String cn-hongkong-b

可用区ID。

ZoneType String singlezone

可用区类型,返回值:

  • singlezone:同城单可用区。
  • doublezone:同城双可用区。
RequestId String CA40C261-EB72-4EDA-AC57-958722162595

请求ID。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=DescribeInstanceAttribute
&InstanceId=r-bp1zxszhcgatnx****
&<公共请求参数>

正常返回示例

XML格式

<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>社区版</Value>
                              <Key>类型</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>社区主从50</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格式

{
	"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": "社区版",
							"Key": "类型"
						}
					]
				},
				"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": "社区主从50",
				"VpcId": "vpc-bp1opxu1zkhn00gzv****",
				"ChargeType": "PostPaid",
				"VpcAuthMode": "Open",
				"NodeType": "double",
				"VpcCloudInstanceId": "r-bp1wcw2rlw76ac****",
				"RegionId": "cn-hangzhou"
			}
		]
	},
	"RequestId": "D67A69DF-C1FC-4B01-B239-B17888CCFD2A"
}

错误码

访问错误中心查看更多错误码。