查询实例列表

1. 接口描述

接口请求域名： mariadb.tencentcloudapi.com 。

本接口（DescribeDBInstances）用于查询云数据库实例列表，支持通过项目ID、实例ID、内网地址、实例名称等来筛选实例。
如果不指定任何筛选条件，则默认返回20条实例记录，单次请求最多支持返回100条实例记录。

默认接口请求频率限制：200次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 根据实例ID查询实例列表

输入示例

https://mariadb.tencentcloudapi.com/?Action=DescribeDBInstances
&InstanceIds.0=tdsql-dj77jd0p
&<公共请求参数>

输出示例

{
    "Response": {
        "Instances": [
            {
                "AppId": 251000022,
                "AutoRenewFlag": 1,
                "Cpu": 1,
                "CreateTime": "2021-03-26 15:28:23",
                "DbEngine": "Percona",
                "DbVersion": "5.7.17",
                "DcnDstNum": 0,
                "DcnFlag": 0,
                "DcnStatus": 0,
                "ExclusterId": "",
                "Id": 2000090,
                "InstanceId": "tdsql-dj77jd0p",
                "InstanceName": "tdsql-dj77jd0p",
                "InstanceType": 2,
                "Ipv6Flag": 0,
                "IsAuditSupported": 1,
                "IsEncryptSupported": 1,
                "IsTmp": 0,
                "Locker": 0,
                "Machine": "TS85",
                "Memory": 2,
                "NodeCount": 2,
                "OriginSerialId": "set_1616743781_36017514",
                "Paymode": "prepaid",
                "PeriodEndTime": "2021-04-26 15:28:23",
                "Pid": 1002231,
                "ProjectId": 0,
                "Qps": 2100,
                "Region": "ap-guangzhou",
                "Status": 2,
                "StatusDesc": "运行中",
                "Storage": 10,
                "SubnetId": 1479311,
                "TdsqlVersion": "基于Percona 5.7.17设计(兼容Mysql 5.7)",
                "Uin": "918700682",
                "UniqueSubnetId": "subnet-au6ics6s",
                "UniqueVpcId": "vpc-737mtr2f",
                "UpdateTime": "2021-03-29 17:20:05",
                "Vip": "10.1.0.10",
                "Vipv6": "",
                "VpcId": 74809,
                "Vport": 3306,
                "WanDomain": "",
                "WanPort": 0,
                "WanPortIpv6": 0,
                "WanStatus": 0,
                "WanStatusIpv6": 0,
                "WanVip": "",
                "WanVipv6": "",
                "Zone": "ap-guangzhou-1",
                "ResourceTags": [
                    {
                        "TagKey": "name",
                        "TagValue": "liu"
                    }
                ],
                "DbVersionId": "8.0"
            }
        ],
        "RequestId": "66c4d0c5-bdef-45bd-aa5b-05642802d034",
        "TotalCount": 1
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。