AI 助理
备案控制台
开发者社区 问答 正文

查看RDS实例列表



描述


查看实例列表或被RAM授权的实例列表。

请求参数

名称类型是否必须描述
ActionString是系统规定参数，取值：DescribeDBInstances。
RegionIdString是实例的region，通过函数DescribeRegions查看。
EngineString否数据库类型，取值范围MySQL/SQLServer/PostgreSQL/PPAS，不填则返回所有。
DBInstanceTypeString否实例类型，取值范围如下：
  • Primary:主实例；
  • Readonly：只读实例；
  • Guard：灾备实例；
  • Temp：临时实例；
  • 不填，默认返回所有。
InstanceNetworkTypeString否取值范围如下：
  • VPC：返回VPC实例；
  • Classic：返回Classic实例；
  • 不填，默认返回所有。
ConnectionModeString否
  • Performance为标准访问模式；
  • Safty为高安全访问模式；
  • 不填，默认返回所有。
TagsString否查询绑定有该标签的实例，传入值格式为Json string，包括TagKey和TagValue，TagKey不能为空，TagValue可以为空。格式示例：{“key1”:”value1”}。
PageSizeInteger否每页记录数，取值：30/50/100，默认值：30。
PageNumberInteger否页码，大于0且不超过Integer的最大值，默认值：1。


返回参数

名称类型描述
<公共返回参数>详见公共参数。
DatabasesList<Database>由Database组成的数据。
PageNumberInteger页码。
TotalRecordCountInteger总记录数。
PageRecordCountInteger本页DBInstance个数。
ItemsList<DBInstance>由DBInstance组成的数组。


DBInstance的参数

名称类型描述
DBInstanceIdString实例名。
DBInstanceDescriptionString实例描述。
PayTypeString付费类型，取值如下：
  • Postpaid:按量付费；
  • Prepaid：预付费。
DBInstanceTypeString取值如下：
  • Primary:主实例；
  • ReadOnly：只读实例；
  • Guard：灾备实例；
  • Temp：临时实例。
InstanceNetworkTypeStringClassic：经典网络；VPC：VPC网络。
ConnectionModeStringPerformance为标准访问模式；Safty为高安全访问模式。
RegionIdString地域。
ExpireTimeString到期时间，按量付费实例无到期时间。
DBInstanceStatusString详见附录
EngineString数据库类型。
DBInstanceNetTypeStringInternet：外网；Intranet：内网。
LockModeString
  • Unlock：正常；
  • ManualLock：手动触发锁定；
  • LockByExpiration:实例过期自动锁定；
  • LockByRestoration：实例回滚前的自动锁定；
  • LockByDiskQuota：实例空间满自动。
LockReasonString被锁定的原因。
MasterInstanceIdString主实例的ID，如果没有返回此参数（即为null）则表示该实例是主实例。
GuardDBInstanceIdString该实例如果挂载着灾备实例，即为备实例的ID。
TempDBInstanceIdString该实例如果挂载着临时实例，即为临时实例的ID。
ReadOnlyDBInstanceIdList<ReadOnlyDBInstanceId>主实例下挂载的只读实例ID列表。


ReadOnlyDBInstanceId参数

名称类型描述
ReadOnlyDBInstanceIdString只读实例ID。


示例


  • 请求示例
    1. [backcolor=transparent] https[backcolor=transparent] :[backcolor=transparent] //rds.aliyuncs.com/?Action=DescribeDBInstances
    2. [backcolor=transparent]&[backcolor=transparent]RegionId[backcolor=transparent]=[backcolor=transparent]cn[backcolor=transparent]-[backcolor=transparent]hangzhou
    3. [backcolor=transparent]&[backcolor=transparent]Engine[backcolor=transparent]=[backcolor=transparent]MySQL
    4. [backcolor=transparent]&<公共请求参数>

  • 返回示例
    XML格式：
    1. [backcolor=transparent] <DescribeDBInstancesResponse>
    2. [backcolor=transparent]<PageRecordCount>[backcolor=transparent]2[backcolor=transparent]</PageRecordCount>
    3. [backcolor=transparent]<Items>
    4. [backcolor=transparent]<DBInstance>
    5. [backcolor=transparent]<DBInstanceDescription>[backcolor=transparent]testforRemarks[backcolor=transparent]</DBInstanceDescription>
    6. [backcolor=transparent]<ExpireTime>[backcolor=transparent]2014-10-10T16:00:00Z[backcolor=transparent]</ExpireTime>
    7. [backcolor=transparent]<DBInstanceId>[backcolor=transparent]rdsmjfirvmjfirv[backcolor=transparent]</DBInstanceId>
    8. [backcolor=transparent]<DBInstanceNetType>[backcolor=transparent]Internet[backcolor=transparent]</DBInstanceNetType>
    9. [backcolor=transparent]<PayType>[backcolor=transparent]Prepaid[backcolor=transparent]</PayType>
    10. [backcolor=transparent]<DBInstanceStatus>[backcolor=transparent]Running[backcolor=transparent]</DBInstanceStatus>
    11. [backcolor=transparent]<DBInstanceType>[backcolor=transparent]Primary[backcolor=transparent]</DBInstanceType>
    12. [backcolor=transparent]<Engine>[backcolor=transparent]MySQL[backcolor=transparent]</Engine>
    13. [backcolor=transparent]<LockMode>[backcolor=transparent]Unlock[backcolor=transparent]</LockMode>
    14. [backcolor=transparent]<LockReason></LockReason>
    15. [backcolor=transparent]<RegionId>[backcolor=transparent]cn-hangzhou[backcolor=transparent]</RegionId>
    16. [backcolor=transparent]<ZoneId>[backcolor=transparent]cn-hangzhou-a[backcolor=transparent]</ZoneId>
    17. [backcolor=transparent]<MasterInstanceId></MasterInstanceId>
    18. [backcolor=transparent]<GuardDBInstanceId></GuardDBInstanceId>
    19. [backcolor=transparent]<TempDBInstanceId></TempDBInstanceId>
    20. [backcolor=transparent]<ReadOnlyDBInstanceIds>
    21. [backcolor=transparent]    [backcolor=transparent]<ReadOnlyDBInstanceId></ReadOnlyDBInstanceId>
    22. [backcolor=transparent] [backcolor=transparent]</ReadOnlyDBInstanceIds>[backcolor=transparent]
    23. [backcolor=transparent]</DBInstance>
    24. [backcolor=transparent]<DBInstance>
    25. [backcolor=transparent]<DBInstanceDescription>[backcolor=transparent]testforcreate[backcolor=transparent]</DBInstanceDescription>
    26. [backcolor=transparent]<ExpireTime></ExpireTime>
    27. [backcolor=transparent]<DBInstanceId>[backcolor=transparent]rdsabqumfabqumf[backcolor=transparent]</DBInstanceId>
    28. [backcolor=transparent]<DBInstanceNetType>[backcolor=transparent]Intranet[backcolor=transparent]</DBInstanceNetType>
    29. [backcolor=transparent]<PayType>[backcolor=transparent]Postpaid[backcolor=transparent]</PayType>
    30. [backcolor=transparent]<DBInstanceStatus>[backcolor=transparent]Running[backcolor=transparent]</DBInstanceStatus>
    31. [backcolor=transparent]<DBInstanceType>[backcolor=transparent]Primary[backcolor=transparent]</DBInstanceType>
    32. [backcolor=transparent]<Engine>[backcolor=transparent]MySQL[backcolor=transparent]</Engine>
    33. [backcolor=transparent]<LockMode>[backcolor=transparent]Unlock[backcolor=transparent]</LockMode>
    34. [backcolor=transparent]<LockReason></LockReason>
    35. [backcolor=transparent]<RegionId>[backcolor=transparent]cn-hangzhou[backcolor=transparent]</RegionId>
    36. [backcolor=transparent]<MasterInstanceId></MasterInstanceId>
    37. [backcolor=transparent]<GuardDBInstanceId></GuardDBInstanceId>
    38. [backcolor=transparent]<TempDBInstanceId></TempDBInstanceId>
    39. [backcolor=transparent]<ReadOnlyDBInstanceIds>
    40. [backcolor=transparent]     [backcolor=transparent]<ReadOnlyDBInstanceId></ReadOnlyDBInstanceId>
    41. [backcolor=transparent]  [backcolor=transparent]</ReadOnlyDBInstanceIds>[backcolor=transparent]
    42. [backcolor=transparent]</DBInstance>
    43. [backcolor=transparent]</Items>
    44. [backcolor=transparent]<PageNumber>[backcolor=transparent]1[backcolor=transparent]</PageNumber>
    45. [backcolor=transparent]<TotalRecordCount>[backcolor=transparent]2[backcolor=transparent]</TotalRecordCount>
    46. [backcolor=transparent]<RequestId>[backcolor=transparent]2553A660-E4EB-4AF4-A402-8AFF70A49143[backcolor=transparent]</RequestId>
    47. [backcolor=transparent]</DescribeDBInstancesResponse>

    JSON格式：
    1. [backcolor=transparent]{
    2. [backcolor=transparent]  [backcolor=transparent]"PageNumber"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]1[backcolor=transparent],[backcolor=transparent]
    3. [backcolor=transparent]  [backcolor=transparent]"Items"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]{
    4. [backcolor=transparent]    [backcolor=transparent]"DBInstance"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][
    5. [backcolor=transparent]      [backcolor=transparent]{
    6. [backcolor=transparent]        [backcolor=transparent]"Engine"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"MySQL"[backcolor=transparent],[backcolor=transparent]
    7. [backcolor=transparent]        [backcolor=transparent]"DBInstanceType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Primary"[backcolor=transparent],[backcolor=transparent]
    8. [backcolor=transparent]        [backcolor=transparent]"DBInstanceStatus"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Running"[backcolor=transparent],[backcolor=transparent]
    9. [backcolor=transparent]        [backcolor=transparent]"DBInstanceDescription"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"testforRemarks"[backcolor=transparent],[backcolor=transparent]
    10. [backcolor=transparent]        [backcolor=transparent]"LockMode"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Unlock"[backcolor=transparent],[backcolor=transparent]
    11. [backcolor=transparent]        [backcolor=transparent]"RegionId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"cn-hangzhou"[backcolor=transparent],[backcolor=transparent]
    12. [backcolor=transparent]"ZoneId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"cn-hangzhou-a"[backcolor=transparent],[backcolor=transparent]
    13. [backcolor=transparent]        [backcolor=transparent]"DBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"rdsmjfirvmjfirv"[backcolor=transparent],[backcolor=transparent]
    14. [backcolor=transparent]        [backcolor=transparent]"PayType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Prepaid"[backcolor=transparent],[backcolor=transparent]
    15. [backcolor=transparent]        [backcolor=transparent]"ExpireTime"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"2014-10-10T16:00:00Z"[backcolor=transparent],[backcolor=transparent]
    16. [backcolor=transparent]        [backcolor=transparent]"DBInstanceNetType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Internet"[backcolor=transparent],[backcolor=transparent]
    17. [backcolor=transparent]        [backcolor=transparent]"LockReason"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    18. [backcolor=transparent]        [backcolor=transparent]"MasterInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    19. [backcolor=transparent]        [backcolor=transparent]"GuardDBInstanceId "[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    20. [backcolor=transparent]        [backcolor=transparent]"TempDBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    21. [backcolor=transparent]"ReadOnlyDBInstanceIds"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]{
    22. [backcolor=transparent]               [backcolor=transparent]"ReadOnlyDBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][]
    23. [backcolor=transparent]              [backcolor=transparent]}
    24. [backcolor=transparent]      [backcolor=transparent]},[backcolor=transparent]
    25. [backcolor=transparent]      [backcolor=transparent]{
    26. [backcolor=transparent]        [backcolor=transparent]"Engine"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"MySQL"[backcolor=transparent],[backcolor=transparent]
    27. [backcolor=transparent]        [backcolor=transparent]"DBInstanceType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Primary"[backcolor=transparent],[backcolor=transparent]
    28. [backcolor=transparent]        [backcolor=transparent]"DBInstanceStatus"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Running"[backcolor=transparent],[backcolor=transparent]
    29. [backcolor=transparent]        [backcolor=transparent]"DBInstanceDescription"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"testforcreate"[backcolor=transparent],[backcolor=transparent]
    30. [backcolor=transparent]        [backcolor=transparent]"LockMode"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Unlock"[backcolor=transparent],[backcolor=transparent]
    31. [backcolor=transparent]        [backcolor=transparent]"RegionId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"cn-hangzhou"[backcolor=transparent],[backcolor=transparent]
    32. [backcolor=transparent]        [backcolor=transparent]"DBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"rdsabqumfabqumf"[backcolor=transparent],[backcolor=transparent]
    33. [backcolor=transparent]        [backcolor=transparent]"PayType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Postpaid"[backcolor=transparent],[backcolor=transparent]
    34. [backcolor=transparent]        [backcolor=transparent]"ExpireTime"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],[backcolor=transparent]
    35. [backcolor=transparent]        [backcolor=transparent]"DBInstanceNetType"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"Intranet"[backcolor=transparent],[backcolor=transparent]
    36. [backcolor=transparent]        [backcolor=transparent]"LockReason"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    37. [backcolor=transparent]"MasterInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    38. [backcolor=transparent]        [backcolor=transparent]"GuardDBInstanceId "[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    39. [backcolor=transparent]        [backcolor=transparent]"TempDBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent],
    40. [backcolor=transparent]"ReadOnlyDBInstanceIds"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]{
    41. [backcolor=transparent]               [backcolor=transparent]"ReadOnlyDBInstanceId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][]
    42. [backcolor=transparent]              [backcolor=transparent]}
    43. [backcolor=transparent]      [backcolor=transparent]}
    44. [backcolor=transparent]]
    45. [backcolor=transparent]  [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent],[backcolor=transparent]
    46. [backcolor=transparent]  [backcolor=transparent]"TotalRecordCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]2[backcolor=transparent],[backcolor=transparent]
    47. [backcolor=transparent]  [backcolor=transparent]"PageRecordCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]2[backcolor=transparent],[backcolor=transparent]
    48. [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"2553A660-E4EB-4AF4-A402-8AFF70A49143"
    49. [backcolor=transparent]}

展开
收起
云栖大讲堂 2017-10-18 17:32:35 1659 分享 版权

版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

0 条回答
写回答
取消 提交回答
问答分类：
XML JSON 安全 关系型数据库 MySQL 数据库 数据格式 PostgreSQL RDS 专有网络VPC 云数据库 RDS MySQL 版 云原生数据库 PolarDB 云数据库 RDS SQL Server 版
问答标签：
云数据库 RDS MySQL 版实例 云数据库 RDS MySQL 版列表 云数据库 RDS列表 云数据库 RDS实例列表 云数据库 RDS PostgreSQL 版列表
问答地址：
开发者社区 > 数据库 > 问答
相关问答
阿里云OpenAPI的RDS 获取实例列表调试SDK可以获取结果，但为什么代码下载返回值是空的？
143
2
0
rds实例中某库已经删除，dms首页列表中库也不存在了，但是结构设计工单中删除的库还存在，怎么解决？
230
4
0
RDS主实例规格列表
86
1
0
RDS监控项列表
83
1
0
DTS同步列表中看不到源RDS已有库
78
1
0
RDS MySQL通过API请求获取备份列表BackupDownloadURL返回为空字符串
108
1
0
Flink CDC目前环境里的包列表，只有mysql的胖包报错如下是缺了什么包么？
88
0
0
DataWorks如何配置云数据库rds数据库白名单列表中？
160
1
0
DMS添加跨rds实例 添加账号后 没有在列表里面？
112
3
0
自建的 MySQL 迁移至 RDS MySQL 可以通过哪个产品实现应用不停服务的情况下，平滑完成数
1530
1
0