调用DescribeDBInstances接口查看RDS实例列表或被RAM授权的实例列表。

调试

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

请求参数

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

系统规定参数,取值:DescribeDBInstances

RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

proxyId String API

代理模式ID。

Engine String MySQL

数据库类型,取值:

  • MySQL
  • SQLServer
  • PostgreSQL
  • PPAS
  • MariaDB

默认返回所有数据库类型。

ZoneId String cn-hangzhou-a

可用区ID。

ResourceGroupId String rg-acfmyxxxxx

资源组ID。

DBInstanceStatus String Running

实例状态,详情请参见实例状态表

Expired String True

实例的过期状态,取值:

  • True:已过期
  • False:未过期
SearchKey String rm-uf6w

可基于实例ID或者实例备注模糊搜索。

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

DBInstanceType String Primary

实例类型,取值:

  • Primary:主实例
  • Readonly:只读实例
  • Guard:灾备实例
  • Temp:临时实例

默认返回所有实例类型。

PageSize Integer 30

每页记录数,取值:1~100

默认值:30

PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。

默认值:1

InstanceNetworkType String Classic

实例的网络类型,取值:

  • VPC:专有网络下的实例
  • Classic:经典网络下的实例

默认返回所有网络类型下的实例。

VpcId String vpc-uf6f7l4fg90xxxxxxxxxx

VPC ID。

VSwitchId String vsw-uf6adz52c2pxxxxxxxxxx

交换机ID。

DBInstanceClass String rds.mys2.small

实例规格,详见实例规格表

EngineVersion String 5.7

数据库版本。

PayType String Postpaid

付费类型,取值:

  • Postpaid:按量付费
  • Prepaid:包年包月
ConnectionMode String Standard

实例的访问模式,取值:

  • Standard:标准访问模式
  • Safe:数据库代理模式

默认返回所有访问模式下的实例。

Tags String {"key1":"value1"}

查询绑定有该标签的实例,包括TagKey和TagValue。单次最多支持传入5组值,格式:{"key1":"value1","key2":"value2"...}。

DedicatedHostGroupId String dhg-7a9xxxxxxxx

主机组ID。

DedicatedHostId String i-bpxxxxxxx

主机ID。

返回数据

名称 类型 示例值 描述
PageRecordCount Integer 10

当前页实例个数。

TotalRecordCount Integer 100

总记录数。

PageNumber Integer 1

页码。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

Items Array

由实例信息组成的数组。

DBInstance
DBInstanceId String rm-uf6wjk5xxxxxxxxxx

实例ID。

DBInstanceDescription String 测试数据库

实例描述。

PayType String Postpaid

实例的付费类型,取值:

  • Postpaid:按量付费
  • Prepaid:包年包月
DBInstanceType String Primary

实例类型,取值:

  • Primary:主实例
  • ReadOnly:只读实例
  • Guard:灾备实例
  • Temp:临时实例
InstanceNetworkType String Classic

实例的网络类型,取值:

  • Classic:经典网络
  • VPC:VPC网络
ConnectionMode String Performance

实例的访问模式,取值:

  • Standard:标准访问模式
  • Safe:数据库代理模式
RegionId String cn-hangzhou

地域ID。

ExpireTime String 2019-02-27T16:00:00Z

到期时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 按量付费实例无到期时间。
DBInstanceStatus String Running

实例状态,详情请参见实例状态表

Engine String MySQL

数据库类型。

DBInstanceNetType String Internet

实例的网络连接类型,取值:

  • Internet:外网连接
  • Intranet:内网连接
LockMode String Unlock

实例的锁定状态。取值:

  • Unlock:正常。
  • ManualLock:手动触发锁定。
  • LockByExpiration:实例过期自动锁定。
  • LockByRestoration:实例回滚前自动锁定。
  • LockByDiskQuota:实例空间满自动锁定。
  • Released:实例已释放。此时实例无法进行解锁,只能使用备份数据重新创建新实例,重建时间较长,请耐心等待。
LockReason String instance_expired

实例被锁定的原因。

MasterInstanceId String rm-uf6wjk5xxxxxxxxxx

主实例的ID,如果没有返回此参数(即为null)则表示该实例是主实例。

GuardDBInstanceId String rm-uf64zsuxxxxxxxxxx

主实例如果有灾备实例,该参数即为灾备实例的ID。

TempDBInstanceId String rm-uf64zsuxxxxxxxxxx

主实例如果有临时实例,该参数即为临时实例的ID。

AutoUpgradeMinorVersion String Auto

实例升级小版本的方式,取值:

  • Auto:自动升级小版本
  • Manual:不自动升级(仅在当前版本下线时才强制升级)
Category String Basic

实例系列:

  • Basic:基础版
  • HighAvailability:高可用版
  • Finance:三节点企业版
CreateTime String 2018-11-05T11:26:02Z

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

DBInstanceClass String rds.mys2.small

实例规格,详见实例规格表

DBInstanceStorageType String ModuleList.4.ModuleCode

实例储存类型。

DedicatedHostGroupId String dhg-7a9xxxxxxxx

主机组ID。

DedicatedHostIdForLog String dh-bpxxxx

Log节点所在主机的ID。

DedicatedHostIdForMaster String dh-bpxxxx

Master节点所在主机的ID。

DedicatedHostIdForSlave String dh-bpxxxx

Slave节点所在主机的ID。

DedicatedHostNameForLog String testlog

Log节点所在主机的名称。

DedicatedHostNameForMaster String testmaster

Master节点所在主机的名称。

DedicatedHostNameForSlave String testslave

Slave节点所在主机的名称。

DestroyTime String 2018-11-05T11:26:02Z

销毁时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

EngineVersion String 5.7

数据库版本。

MutriORsignle Boolean true

是否是多可用区,取值:true | false

ReadOnlyDBInstanceIds Array

主实例下如果有只读实例,该参数为只读实例的ID列表。

ReadOnlyDBInstanceId
DBInstanceId String rr-uf6wjk5xxxxxxx

只读实例ID。

ResourceGroupId String rg-acfmyxxxxxxx

资源组ID。

VSwitchId String vsw-uf6adz52c2pxxxxxxx

交换机ID。

VpcCloudInstanceId String rm-uf6wjk5xxxxxxx

专有网络实例ID。

VpcId String vpc-uf6f7l4fg90xxxxxxx

VPC ID。

ZoneId String cn-hangzhou-a

可用区ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeDBInstances
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDBInstancesResponse>
  <Items>
		    <DBInstance>
			      <LockMode>Unlock</LockMode>
			      <DBInstanceNetType>Intranet</DBInstanceNetType>
			      <DBInstanceClass>ppas.x4.xlarge.2</DBInstanceClass>
			      <ResourceGroupId>rg-acfnt75uxxxxx</ResourceGroupId>
			      <DBInstanceId>rm-dj120j44xxxxx</DBInstanceId>
			      <VpcCloudInstanceId></VpcCloudInstanceId>
			      <ZoneId>cn-beijing-MAZ3(c,e)</ZoneId>
			      <ReadOnlyDBInstanceIds></ReadOnlyDBInstanceIds>
			      <ConnectionMode>Standard</ConnectionMode>
			      <InstanceNetworkType>Classic</InstanceNetworkType>
			      <Engine>PPAS</Engine>
			      <MutriORsignle>true</MutriORsignle>
			      <InsId>1</InsId>
			      <ExpireTime></ExpireTime>
			      <CreateTime>2019-03-20T02:18:02Z</CreateTime>
			      <DBInstanceType>Primary</DBInstanceType>
			      <RegionId>cn-beijing</RegionId>
			      <EngineVersion>10.0</EngineVersion>
			      <LockReason></LockReason>
			      <DBInstanceStatus>Running</DBInstanceStatus>
			      <PayType>Postpaid</PayType>
		    </DBInstance>
	  </Items>
	  <TotalRecordCount>1</TotalRecordCount>
	  <PageNumber>1</PageNumber>
	  <RequestId>0C2B0363-2707-4300-9900-0A65846CE48E</RequestId>
	  <PageRecordCount>1</PageRecordCount>
</DescribeDBInstancesResponse>

JSON 格式

{
	"Items": {
		"DBInstance": [
			{
				"LockMode": "Unlock",
				"DBInstanceNetType": "Intranet",
				"DBInstanceClass": "ppas.x4.xlarge.2",
				"ResourceGroupId": "rg-acfnt75uxxxxx",
				"DBInstanceId": "rm-dj120j44xxxxx",
				"VpcCloudInstanceId": "",
				"ZoneId": "cn-beijing-MAZ3(c,e)",
				"ReadOnlyDBInstanceIds": {
					"ReadOnlyDBInstanceId": []
				},
				"ConnectionMode": "Standard",
				"InstanceNetworkType": "Classic",
				"Engine": "PPAS",
				"MutriORsignle": true,
				"InsId": 1,
				"ExpireTime": "",
				"CreateTime": "2019-03-20T02:18:02Z",
				"DBInstanceType": "Primary",
				"RegionId": "cn-beijing",
				"EngineVersion": "10.0",
				"LockReason": "",
				"DBInstanceStatus": "Running",
				"PayType": "Postpaid"
			}
		]
	},
	"TotalRecordCount": 1,
	"PageNumber": 1,
	"RequestId": "0C2B0363-2707-4300-9900-0A65846CE48E",
	"PageRecordCount": 1
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBInstanceType.ValueNotSupport The specified parameter"DBInstanceType" is not valid. 参数DBInstanceType无效。

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