查询指定实例详情
更新时间：2022-12-28
说明
- 查询指定实例的详细信息
请求结构
GET /v{version}/instance/{instanceId} HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| instanceId | string | 是 | URL参数 | 指定实例Id |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceId | String | 实例ID |
| instanceName | String | 数据库实例名 |
| engine | String | 数据库引擎,参见引擎类型 |
| engineVersion | String | 数据库引擎版本,取值参考数据库版本 |
| category | String | 所属系列。Basic、Singleton：单机基础版，Standard：双机高可用版 |
| instanceStatus | String | 实例状态，参见实例状态表 |
| cpuCount | Int | CPU核数 |
| memoryCapacity | Int | 实例内存，单位GB |
| volumeCapacity | Int | 存储空间，单位GB |
| nodeAmount | Int | 节点数（代理实例） |
| usedStorage | Int | 已用存储空间，单位GB |
| instanceCreateTime | Datetime | 实例创建时间，规范参考时间与日期 |
| instanceExpireTime | Datetime | 实例到期时间，规范参考时间与日期 |
| endpoint | Endpoint | 数据库连接信息 |
| publicAccessStatus | String | 外网访问功能状态,参考公网状态表 |
| syncMode | String | 数据同步方式,参考同步方式 |
| backupPolicy | BackupPolicy | 备份策略 |
| region | String | 该实例的区域 |
| instanceType | String | 实例类型，参考实例类型 |
| sourceInstanceId | String | 主实例ID，如果为主实例则为空 |
| sourceRegion | String | 该实例的主实例的区域 |
| zoneNames | List String | 实例的可用区 |
| vpcId | String | 实例所属VPC的ID |
| subnets | List Subnet | 实例所在子网 |
| topology | Topology | 实例所属数据库集群的拓扑信息 |
| paymentTiming | String | 付费方式,参考付费方式 |
| characterSetName | String | 实例字符集 |
请求示例
GET /v1/instance/rds-nca3jn5j HTTP/1.1
HOST: rds.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
{
"instanceId": "rds-mut9rhom8p3m",
"instanceName": "mysql56",
"memoryCapacity": 0.25,
"volumeCapacity": 5,
"nodeAmount": 2,
"usedStorage": 0.5672,
"engine": "mysql",
"engineVersion": "5.6",
"characterSetName": "utf8mb4",
"instanceStatus": "Available",
"publicAccessStatus": "Closed",
"instanceCreateTime": "2016-04-26T06:46:30Z",
"instanceExpireTime": "2016-05-26T06:46:11Z",
"endpoint": {
"address": "mysql.rdsmut9rhom8p3m.bj.bce.qa.sandbox.baidu.com",
"port": 3306,
"vnetIp": "192.168.0.1",
"inetIp": "180.32.96.1"
},
"instanceType": "Master",
"zoneNames": ["cn-bj-a"],
"vpcId": "v-kj3nc8fs",
"backupPolicy": {
"backupDays": "0,1,2,3,4,5,6",
"backupTime": "17:00:00Z",
"persistent": false,
"expireInDays": 0,
"freeSpace": 5
},
"topology": {
"rdsproxy": [],
"master": [
"rds-mut9rhog"
],
"readReplica": [
"rds-m2s2du6j",
"rds-m4bkxb0i"
]
},
"syncMode" : "Async",
"paymentTiming" : "Prepaid"
}