API参考—实例管理—DescribeDBInstances

本文涉及的产品
云原生数据库 PolarDB 分布式版,标准版 2核8GB
简介: 调用DescribeDBInstances接口查看实例列表详情。

调试

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

调试

请求参数

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

系统规定参数。取值为DescribeDBInstances

RegionId String ch-hangzhou

实例所属地域。

PageNumber Integer 1

页码,取值为大于0且不超过Integer数据类型的最大值,默认值为1

PageSize Integer 30

每页记录数,取值为3050100

默认值为30

ResourceGroupId String -1

资源组ID。

返回数据

名称 类型 示例值 描述
DBInstances Array of DBInstance

实例信息。

ExpireDate String 2020-08-29T06:09:30.000+0800

实例到期时间,格式为yyyy-MM-ddTHH:mm:ss.SSSZ,例如2020-08-29T06:09:30.000+0800表示该实例于北京时间(UTC+8)2020年8月29日上午6时9分30秒到期。

说明 仅包年包月实例支持该参数。

PageNumber Integer 1

页码,取值为大于0且不超过Integer数据类型的最大值,默认值为1

PageSize Integer 30

每页记录数,取值为3050100

默认值为30

RequestId String 91EA81C3-1622-47BF-BDCC-0D7BA1******

请求ID。

示例

请求示例


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

正常返回示例

XML 格式


<code>200</code>

<data>
<RequestId>91EA81C3-1622-47BF-BDCC-0D7BA1</RequestId>
<PageSize>2</PageSize>
<PageNumber>1</PageNumber>
<DBInstances>
<Status>Running</Status>
<Description/>
<ZoneId>cn-hangzhou-h</ZoneId>
<NodeCount>2</NodeCount>
<VPCId>vpc-*</VPCId>
<CreateTime>2020-07-29T06:09:30.000+0800</CreateTime>
<Expired>false</Expired>
<PayType>Prepaid</PayType>
<DBType>polarx</DBType>
<LockMode>Unlock</LockMode>
<StorageUsed>6784286720</StorageUsed>
<NodeClass>polarx.x4.large.2d</NodeClass>
<DBVersion>5.7</DBVersion>
<Network>VPC</Network>
<CommodityCode>drds_polarxpre_public_cn</CommodityCode>
<Id>pxc-**</Id>
<RegionId>cn-hangzhou</RegionId>
<ExpireTime>2020-08-29T06:09:30.000+0800</ExpireTime>
<Engine>polarx</Engine>
</DBInstances>
<DBInstances>
<Status>Running</Status>
<Description>2test</Description>
<ZoneId>cn-hangzhou-h</ZoneId>
<NodeCount>2</NodeCount>
<VPCId>vpc-*</VPCId>
<CreateTime>2020-07-29T06:09:30.000+0800</CreateTime>
<Expired>false</Expired>
<PayType>Prepaid</PayType>
<DBType>polarx</DBType>
<LockMode>Unlock</LockMode>
<StorageUsed>6834618368</StorageUsed>
<NodeClass>polarx.x4.large.2d</NodeClass>
<DBVersion>5.7</DBVersion>
<Network>VPC</Network>
<CommodityCode>drds_polarxpre_public_cn</CommodityCode>
<Id>pxc-**</Id>
<RegionId>cn-hangzhou</RegionId>
<ExpireTime>2020-08-29T06:09:30.000+0800</ExpireTime>
<Engine>polarx</Engine>
</DBInstances>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>91EA81C3-1622-47BF-BDCC-0D7BA1</requestId>
<successResponse>true</successResponse>

JSON 格式


{
"code": "200",
"data": {
"RequestId": "91EA81C3-1622-47BF-BDCC-0D7BA1",
"PageSize": 2,
"PageNumber": 1,
"DBInstances": [{
"Status": "Running",
"Description": "",
"ZoneId": "cn-hangzhou-h",
"NodeCount": 2,
"VPCId": "vpc-*",
"CreateTime": "2020-07-29T06:09:30.000+0800",
"Expired": false,
"PayType": "Prepaid",
"DBType": "polarx",
"LockMode": "Unlock",
"StorageUsed": 6784286720,
"NodeClass": "polarx.x4.large.2d",
"DBVersion": "5.7",
"Network": "VPC",
"CommodityCode": "drds_polarxpre_public_cn",
"Id": "pxc-**",
"RegionId": "cn-hangzhou",
"ExpireTime": "2020-08-29T06:09:30.000+0800",
"Engine": "polarx"
}, {
"Status": "Running",
"Description": "2test",
"ZoneId": "cn-hangzhou-h",
"NodeCount": 2,
"VPCId": "vpc-*",
"CreateTime": "2020-07-29T06:09:30.000+0800",
"Expired": false,
"PayType": "Prepaid",
"DBType": "polarx",
"LockMode": "Unlock",
"StorageUsed": 6834618368,
"NodeClass": "polarx.x4.large.2d",
"DBVersion": "5.7",
"Network": "VPC",
"CommodityCode": "drds_polarxpre_public_cn",
"Id": "pxc-**",
"RegionId": "cn-hangzhou",
"ExpireTime": "2020-08-29T06:09:30.000+0800",
"Engine": "polarx"
}]
},
"httpStatusCode": "200",
"requestId": "91EA81C3-1622-47BF-BDCC-0D7BA1",
"successResponse": true
}
            </div>
相关实践学习
跟我学:如何一键安装部署 PolarDB-X
《PolarDB-X 动手实践》系列第一期,体验如何一键安装部署 PolarDB-X。
相关文章
|
XML JSON API
API参考—实例管理—DeleteDBInstance
调用DeleteDBInstance接口释放实例。
|
XML JSON API
API参考—实例管理—DescribeDBInstances
调用DescribeDBInstances接口查看实例列表详情。
151 0
|
XML JSON API
API参考—实例管理—RestartDBInstance
调用RestartDBInstance接口重启实例。
|
XML JSON API
API参考—实例管理—ModifyDBInstanceMaintainTime
调用ModifyDBInstanceMaintainTime接口修改实例可维护时间。
|
JSON API 开发工具
API参考—实例管理—CreateDBInstance
调用CreateDBInstance接口创建数据库实例。
|
XML JSON API
API参考—实例管理—ModifyDBInstanceDescription
调用ModifyDBInstanceDescription接口修改实例描述。
|
XML JSON 开发工具
API参考—实例管理—DescribeDBInstanceAttribute
调用DescribeDBInstanceAttribute接口查看实例的详细信息。
|
应用服务中间件 nginx 弹性计算
实测阿里云slb转发策略的健康检查
小白实测阿里云slb的转发策略功能的健康检查问题
3886 0
|
1天前
|
存储 关系型数据库 MySQL
数据管理的艺术:PolarDB开源版详评与实战部署策略(一)
PolarDB-X是阿里巴巴自研的高性能云原生分布式数据库,基于共享存储的Shared-nothing架构,支持MySQL生态,具备金融级高可用、分布式水平扩展、HTAP混合负载等能力。它通过CN(计算节点)和DN(存储节点)实现计算与存储分离,保证数据强一致性,并支持全局二级索引和多主多写。PolarDB-X开源版提供更高程度的定制化和控制权,适合追求技术自主性和成本优化的开发者。部署方式包括RPM包、PXD工具和Kubernetes,其中PXD工具提供了一键部署的便利性。
34599 10
|
5天前
|
关系型数据库 Serverless 分布式数据库
高峰无忧,探索PolarDB PG版Serverless的弹性魅力
在数字经济时代,数据库成为企业命脉,面对爆炸式增长的数据,企业面临管理挑战。云原生和Serverless技术革新数据库领域,PolarDB PG Serverless作为阿里云的云原生数据库解决方案,融合Serverless与PostgreSQL,实现自动弹性扩展,按需计费,降低运维成本。它通过计算与存储分离技术,提供高可用性、灾备策略和简化运维。PolarDB PG Serverless智能应变业务峰值,实时监控与调整资源,确保性能稳定。通过免费体验,用户可观察其弹性性能和价格力,感受技术优势。