DescribeDBInstances--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

DescribeDBInstances

最近更新时间：2024.08.09 11:47:08首次发布时间：2023.02.02 17:41:21

调用 DescribeDBInstances 接口查看实例列表。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
InstanceId	String	否	mysql-1d797b6f****	实例 ID。
InstanceName	String	否	TestDB	实例名称。
InstanceStatus	String	否	Running	实例状态，取值： `Creating`：创建中。 `Running`：运行中。 `Deleting`：删除中。 `Restarting`：重启中。 `Updating`：变更中。 `Restoring`：恢复中。 `Error`：错误。 `Upgrading`：升级中。 `Recycled`：已回收。 `MasterChanging`：主节点切换中。 `TDEUpdating`：TDE 修改中。 `Closed`：关停。 `Maintaining`：维护中。 `CreateFailed`：创建失败。 `Closing`：关停中。 `SSLUpdating`：SSL 变更中。 `AllowListMaintaining`：白名单变更中。 `Unknown`：未知。 `ProxyCreating`：代理开启中。 `ProxyDeleting`：代理关闭中。 `ChargeTypeChanging`：计费类型变更中。 `NetWorkChanging`：网络变更中。
DBEngineVersion	String	否	MySQL_8_0	兼容版本。取值： `MySQL_5_7`：MySQL 5.7 版本。 `MySQL_8_0`：MySQL 8.0 版本。
CreateTimeStart	String	否	2022-01-01T10:10:10Z	查询创建实例创建时间范围。
CreateTimeEnd	String	否	2022-01-01T10:10:10Z	查询创建实例创建时间范围。
ZoneId	String	否	cn-beijing-a	实例所属可用区。
ChargeType	String	否	PostPaid	付费类型。取值： `PostPaid`：按量付费。 `PrePaid`：包年包月（默认）。
InstanceType	String	否	DoubleNode	实例类型。取值固定为 `DoubleNode`。
NodeSpec	String	否	rds.mysql.1c2g	主节点规格。关于节点规格的详细信息，请参见产品规格。
TagFilters	Array of TagFilterObject	否	[ { "Key":"key1", "Value":"value1" } ]	用于查询筛选的标签键值对数组。关于 TagFilters 的更多详情，请参见数据结构。说明单次最多支持同时传入 10 组标签键值对进行查询筛选。需同时设置 key 和 value 两个字段。
ProjectName	String	否	testProject	项目名称。
PageNumber	Integer	否	1	当前页页码。取值最小为 1。默认值为 1。
PageSize	Integer	否	10	每页记录数。最小值为 1，最大值不超过 100。默认值为 10。

返回参数

名称	类型	示例值	描述
Total	Integer	1	实例总数。
Instances	Array of InstanceObject	无	实例列表。更多关于 Instances 的信息，请参见数据结构。

请求示例

POST /?Action=DescribeDBInstances&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a****

{
    "InstanceStatus" : "Running"
}

返回示例

正常返回示例

{
    "ResponseMetadata":{
        "RequestId":"20230110194301C23B8A99043A27D617A2",
        "Action":"DescribeDBInstances",
        "Version":"2022-01-01",
        "Service":"rds_mysql",
        "Region":"cn-beijing"
    },
    "Result":{
        "Instances":[
            {
                "AddressObject":[
                    {
                        "DNSVisibility": false,
                        "Domain": "mysql-1d797b6f****-public.rds.volces.com",
                        "EipId": "eip-13flx63066io03n6nu51u****",
                        "IPAddress": "180.***.***.***",
                        "InternetProtocol": "IPv4",
                        "NetworkType": "Public",
                        "SubnetId": "subnet-rs4brkc5pnuov0x576g****"
                    },
                    {
                        "DNSVisibility": false,
                        "Domain": "mysql-1d797b6f****.rds.ivolces.com",
                        "EipId": "",
                        "IPAddress": "192.***.***.***",
                        "InternetProtocol": "IPv4",
                        "NetworkType": "Private",
                        "SubnetId": "subnet-rs4brkc5pnuov0x576g****"
                    }
                ],
                "AllowListVersion":"v2",
                "ChargeDetail":{
                    "AutoRenew":FALSE,
                    "ChargeEndTime":"",
                    "ChargeStartTime":"2023-01-10T11:13:34.000Z",
                    "ChargeStatus":"Normal",
                    "ChargeType":"PostPaid",
                    "Number":0,
                    "OverdueReclaimTime":"2200-01-15T16:00:00.000Z",
                    "OverdueTime":"",
                    "Period":0,
                    "PeriodUnit":"Month"
                },
                "CreateTime":"2023-01-10T11:13:30.000Z",
                "DBEngineVersion":"MySQL_5_7",
                "InstanceId":"mysql-1d797b6f****",
                "InstanceName":"测试实例 1",
                "InstanceStatus":"Running",
                "InstanceType": "DoubleNode",
                "LowerCaseTableNames":"1",
                "MaintenanceWindow": {
                    "DayKind": "Week",
                    "DayOfMonth": [],
                    "DayOfWeek": [
                        "Monday",
                        "Tuesday",
                        "Wednesday",
                        "Thursday",
                        "Friday",
                        "Saturday",
                        "Sunday"
                    ],
                    "MaintenanceTime": "19:00Z-22:59Z"
                },
                "NodeCPUUsedPercentage": 1.59,
                "NodeMemoryUsedPercentage": 16.46,
                "NodeNumber": 3,
                "NodeSpaceUsedPercentage": 4.23,
                "NodeSpec":"rds.mysql.1c2g",
                "ProjectName":"",
                "RegionId":"cn-beijing",
                "StorageSpace":20,
                "StorageType":"LocalSSD",
                "SubnetId":"subnet-2bzr8zdx5o8ao2dx0efq4****",
                "TimeZone":"UTC +08:00",
                "VpcId":"vpc-3rebt5uf5fr405zsk2if9****",
                "ZoneId":"cn-beijing-c",
                "ZoneIds": [
                    "cn-beijing-a",
                    "cn-beijing-c"
                ]
            }
        ],
        "Total": 1
    }
}

错误码

更多详情，请参见错误码。