找不到 API ? 点击 反馈吧
- 费用
- 实例
- 创建RDS实例CreateDBInstance
- 回收站重建实例CreateDBInstanceForRebuild
- 释放RDS实例DeleteDBInstance
- 重启RDS实例RestartDBInstance
- 暂停RDS实例StopDBInstance
- 启动RDS实例StartDBInstance
- 变更RDS实例ModifyDBInstanceSpec
- 设置存储空间自动扩容ModifyDasInstanceConfig
- 迁移RDS实例可用区MigrateToOtherZone
- 修改实例名称ModifyDBInstanceDescription
- 修改实例可维护时间段ModifyDBInstanceMaintainTime
- 修改实例资源组ModifyResourceGroup
- 修改实例可用性检测方式ModifyHADiagnoseConfig
- 设置SQL Server账号密码策略ModifyAccountSecurityPolicy
- 查询实例是否支持在线扩盘DescribeSupportOnlineResizeDisk
- 查询可用区资源DescribeAvailableZones
- 查询实例可变更规格DescribeAvailableClasses
- 查询实例详情DescribeDBInstanceAttribute
- 查询实例拓扑信息GetDBInstanceTopology
- 查询实例列表DescribeDBInstances
- 查询规格信息ListClasses
- 按过期时间获取数据库实例DescribeDBInstancesByExpireTime
- 查看可选的地域和可用区DescribeRegions
- 查询实例是否存在CheckInstanceExist
- 查询实例可用性检测方式DescribeHADiagnoseConfig
- 查询RDS MySQL分析实例数量DescribeAnalyticdbByPrimaryDBInstance
- 查询RDS实例的授权状态CheckCloudResourceAuthorized
- 释放实例外网连接地址ReleaseInstanceConnection
- 升级版本
- 网络与连接地址
- 主备高可用和数据复制方式
- 历史事件
- 通知
- 账号
- 数据库
- 只读实例
- RDS集群系列实例
- 数据库代理
- 数据库共享代理(下线中)
- 安全加密
- 日志
- 备份
- 恢复
- 跨地域备份恢复
- 监控
- 参数
- 数据迁移
- 运维任务管理
- MySQL备份文件上云
- SQL Server备份文件上云
- SQL Server AD域
- PostgreSQL一键上云
- 全球多活数据库集群(旧版)
- 标签
- 管理RDS PostgreSQL插件
- PostgreSQL实例Replication Slot管理
- SQL Server/PostgreSQL灾备实例
- 其他
- 事件与任务
- 控制台接口
- 停止维护的接口
DescribeDBInstances分页
该接口用于查询RDS的实例列表
服务地址:
华东1 金融云
参数配置
高级配置
输入参数
只看必填
注意事项
proxyId废弃参数
Engine数据库类型
ZoneId可用区ID
ResourceGroupId资源组ID
DBInstanceStatus实例状态
Expired实例的过期状态
SearchKey可基于实例ID或者实例备注模糊搜索
DBInstanceId实例ID
DBInstanceType实例类型
RegionId地域ID
InstanceNetworkType实例的网络类型
VpcIdVPC ID
VSwitchId交换机ID
DBInstanceClass实例规格
EngineVersion数据库版本
PayType付费类型
ConnectionMode实例的访问模式
Tags查询绑定有该标签的实例
DedicatedHostGroupId专属集群ID
DedicatedHostId专属集群内的主机ID
InstanceLevel是否返回实例系列(Category)信息
ConnectionString实例的连接地址
Filter实例过滤条件参数及其值的JSON串
Category实例的系列
幂等性参数
ClientToken用于保证请求的幂等性
分页参数
PageSize每页记录数
PageNumber页码
NextToken翻页凭证
MaxResults每页记录数
文档
调用结果
SDK 示例
CLI示例
相关示例 (2)
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
适用引擎
- RDS MySQL
- RDS PostgreSQL
- RDS SQL Server
- RDS MariaDB
请求参数
字段名称 | 字段详情 |
---|---|
ClientTokenstring | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符,且该参数值中不能包含非 ASCII 字符。 示例值:ETnLKlblzczshOTUbOCz**** |
proxyIdstring | 废弃参数,无需配置。 示例值:API |
Enginestring | 数据库类型,取值:展开详情 示例值:MySQL |
ZoneIdstring | 可用区 ID。 示例值:cn-hangzhou-a |
ResourceGroupIdstring | 资源组 ID。 示例值:rg-acfmy****参考取值来源: DescribeResourceDetails |
DBInstanceStatusstring | 实例状态,详情请参见实例状态表。 示例值:Running |
Expiredstring | 实例的过期状态,取值:展开详情 示例值:True |
SearchKeystring | 可基于实例 ID 或者实例备注模糊搜索。 示例值:rm-uf6w |
DBInstanceIdstring | 实例 ID。 示例值:rm-uf6wjk5****参考取值来源: CloneDBInstance CreateDBInstance ReceiveDBInstance ModifyDBInstanceSpec RecoveryDBInstance DescribeGadInstances GetDbProxyInstanceSsl CalculateDBInstanceWeight MigrateDBNodes UpgradeDBInstanceMajorVersion TransformDBInstancePayType EvaluateLocalExtendDisk RestoreDdrTable RebuildReplicationLink |
DBInstanceTypestring | 实例类型,取值:展开详情 示例值:Primary参考取值来源: DescribeDBInstanceNetInfo CalculateDBInstanceWeight |
RegionIdstring | 地域 ID。可调用 DescribeRegions 获取。 示例值:cn-hangzhou参考取值来源: DescribeRegions |
PageSizeinteger<int32> | 每页记录数,取值:1~100。展开详情 示例值:30取值 <= 100 |
PageNumberinteger<int32> | 页码,取值:大于 0 且不超过 Integer 的最大值。展开详情 示例值:1取值 <= 21474836 |
InstanceNetworkTypestring | 实例的网络类型,取值:展开详情 示例值:Classic参考取值来源: DescribeDBInstanceNetInfo |
VpcIdstring | VPC ID。 示例值:vpc-uf6f7l4fg90**** |
VSwitchIdstring | 交换机 ID。 示例值:vsw-uf6adz52c2p****参考取值来源: DescribeVSwitches |
DBInstanceClassstring | 实例规格,详见实例规格表。 示例值:rds.mys2.small参考取值来源: CreateDBInstance DescribeDBInstancesForClone |
EngineVersionstring | 数据库版本。 示例值:8.0参考取值来源: DescribeDBMiniEngineVersions |
PayTypestring | 付费类型,取值:展开详情 示例值:Postpaid |
ConnectionModestring | 实例的访问模式,取值:展开详情 示例值:Standard |
Tagsstring | 查询绑定有该标签的实例,包括 TagKey 和 TagValue。单次最多支持传入 5 组值,格式:{"key1":"value1","key2":"value2"...}。 示例值:{"key1":"value1"}参考取值来源: DescribeTags |
DedicatedHostGroupIdstring | 专属集群 ID。 示例值:dhg-7a9****参考取值来源: DescribeDedicatedHostGroups |
DedicatedHostIdstring | 专属集群内的主机 ID。 示例值:i-bp****参考取值来源: DescribeDedicatedHosts |
InstanceLevelinteger<int32> | 是否返回实例系列(Category)信息,取值:展开详情 示例值:0 |
ConnectionStringstring | 实例的连接地址。通过该连接地址查询对应的实例。 示例值:rm-uf6wjk5****.mysql.rds.aliyuncs.com参考取值来源: AllocateInstancePublicConnection |
NextTokenstring | 翻页凭证。取值为上一次调用 DescribeDBInstances 接口时返回的 NextToken 参数值。如果调用结果分多页展示,再次调用接口时传入该值便可以展示下一页的内容。 示例值:o7PORW5o2TJg**** |
MaxResultsinteger<int32> | 每页记录数。取值:1~100。展开详情 示例值:30取值 <= 100 |
Filterstring | 实例过滤条件参数及其值的 JSON 串 示例值:{"babelfishEnabled":"true"} |
Categorystring | 实例的系列。取值:展开详情 示例值:cluster |
请求说明
本接口支持如下两种方式查看返回数据:
- 方式一:通过传入 MaxResults 参数设置每页的记录数,再通过 NextToken 参数设置翻页凭证来展示下一页的内容。NextToken 取值为上一次调用 DescribeDBInstances 接口返回的 NextToken 参数值。
说明
首次调用接口进行分页查询时,您只需设置 MaxResults 参数,接口会返回第一页的数据和 NextToken 参数值。
- 方式二:通过 PageSize 参数设置每页的记录数,通过 PageNumber 参数进行翻页。
说明
上述两种方式只能任选其一。当返回的记录数较多时,推荐使用方式一,可以获得更快的查询速度。
返回参数
变更历史