实例操作接口
更新时间:2019-10-17
查询实例列表
接口描述
查询指定集群和实例组的实例
权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求,请参考 鉴权认证。
注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden
,错误信息:AccessDenied
。
请求结构
GET /v{version}/cluster/{clusterId}/instanceGroup/{instanceGroupId}/instance HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: bmr.bj.baidubce.com
connection: keep-alive
accept: */*
content-type: application/json
authorization: {bce-authorization-string}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名 | 参数类型 | 是否必须 | 参数位置 | 参数描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
clusterId | String | 是 | URL参数 | 指定的集群ID |
instanceGroupId | String | 是 | URL参数 | 指定的实例组ID |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名 | 参数类型 | 参数描述 |
---|---|---|
instances | List\<Instance> | 返回的实例列表 |
请求示例
GET /v1/cluster/0ce4f730-4af2-4f37-8fa2-b14f2f44e50e/instanceGroup/dabc21c6-41f8-4b23-98f2-3415e5886a5f/instance HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:02:00Z
host: bmr.bj.baidubce.com
connection: keep-alive
accept: */*
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:02:01 GMT
Content-Type: application/json;charset=UTF-8
{
"instances": [{
"bccInstanceId": "5a5c65e2-6eb7-4e4d-bf86-cb95baa0687d",
"id": "6fd35fcf-558d-415d-54eb-f131ec29e2ea",
"instanceName": "ngbcd1d97-master-instance-0b5frrum.novalocal",
"status": {
"code": "",
"creationDateTime": "2019-10-14T07:56:07Z",
"endDateTime": null,
"message": "",
"readyDateTime": "2019-10-14T07:56:07Z",
"state": "Running"
},
"managementIP": "10.107.234.74",
"privateDnsName": "",
"privateIpAddress": "192.168.25.125",
"publicDnsName": "",
"publicIpAddress": "10.107.245.106",
"sshPort": 22
}]
}