查询实例列表

最近更新时间:2019-12-09 10:57:13

1. 接口描述

本接口(GetInstanceList)用于查询实例列表。
接口请求域名:sqlserver.api.qcloud.com

  • “实例状态” 字段指明了实例当前所属的状态,包含在下列所述情形范围内:
状态ID 状态名
1 申请中
2 运行中
3 受限运行中 (主备切换中)
4 已隔离
5 回收中
6 已回收
7 任务执行中 (实例做备份,回档等操作)
8 已下线
9 实例扩容中
10 实例迁移中
  • “地域ID” 字段表明地域映射的int值,包含在下列所述情形范围内:
地域ID 地域名
1 广州
4 上海
5 香港
7 上海金融
8 北京
11 深圳金融
  • “可用区ID” 字段表明可用区映射的int值,包含在下列所述情形范围内:
可用区ID 可用区名
100002 广州二区
100003 广州三区
200001 上海一区
300001 香港一区
700001 上海金融一区
800001 北京一区
110001 深圳金融一区

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为GetInstanceList。

参数名称 是否必选 类型 描述
projectId Int 项目ID,请使用查询项目列表接口查询项目ID
resourceIds.n String 一个或者多个实例ID,n表示从0开始的数组下标。实例ID,格式如:mssql-si2823jyl
regionId Int 地域ID,请使用查看地域ID列表
zoneId Int 可用区ID,请使用查看可用区ID列表
status Int 实例状态值,请使用查看实例状态列表
pageNo Int 页号,默认值为0
pageSize Int 每页返回的数量,默认50

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
data Array 返回的数据

其中,data 参数的构成如下:

参数名称 类型 描述
totalCount Int 实例个数
details Array 实例详情列表

其中,details 参数的构成如下:

参数名称 类型 描述
resourceId String 实例ID
name String 实例名称
projectId Int 实例所在项目ID,请使用查询项目列表接口获取项目ID
regionId Int 实例所在地域ID
zoneId Int 实例所在可用区ID
vpcId Int 实例所在私有网络ID,请使用查询私有网络列表
subnetId Int 实例所在私有网络子网ID,请使用查询私有网络列表
status Int 实例状态,请使用查看实例状态列表
vip String 实例访问IP
vport Int 实例访问端口
createTime String 实例创建时间
updateTime String 实例更新时间
startTime String 实例计费开始时间
endTime String 实例计费结束时间
isolateTime String 实例隔离时间
memory Int 实例内存大小,单位G
used Int 实例已经使用存储空间大小,单位G
storage Int 实例存储空间大小,单位G
versionName String 实例版本
renewFlag Int 实例续费标记,0-正常续费,1-自动续费,2-到期不续费
model Int 实例高可用, 1-双机高可用,2-单机

4. 输出参数

错误代码 英文提示 错误描述
1000 SystemError 系统错误,请联系客服人员。
1002 DBConnectError 数据库连接错误
1004 OssError Oss接口错误

5. 示例

输入

https://sqlserver.api.qcloud.com/v2/index.php?Action=GetInstanceList
&<公共请求参数>
®ionId=1
&resourceIds.0=mssql-pf20sran
&pageSize=20
&pageNo=0

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "totalCount": 1,
        "details": [
            {
                "resourceId": "mssql-pf20sran",
                "name": "ab43d155-41e0-4f8d-b586-51fd3b362518",
                "projectId": 0,
                "regionId": 1,
                "zoneId": 100002,
                "vpcId": 0,
                "subnetId": 0,
                "status": 2,
                "vip": "10.66.19.118",
                "vport": 1433,
                "createTime": "2017-03-16 17:35:38",
                "updateTime": "2017-03-16 18:58:13",
                "startTime": "2017-03-16 18:58:13",
                "endTime": "2017-04-16 18:58:13",
                "isolateTime": "0000-00-00 00:00:00",
                "memory": 2,
                "used": 1,
                "storage": 50,
                "versionName": "SQL Server 2008 R2",
                "renewFlag": 0,
                "model": 1
            }
        ]
    }
}