登录管理相关接口
更新时间：2019-06-14
获取虚机登录事件统计结果
描述
- 指定最近时间time, 以及虚机列表，查询登录事件统计数据
请求结构
POST /v{version}/hosteye/loginmanage/overview?time={time}&clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string
{
"region" : REGION, //String，"bj"/"gz"/"sz"/hk02"
"vmList" : [
{
"instanceName" : NAME, // String, 实例名称
"instanceId" : NAMEID, //String, 实例长id
"instanceShortId" : SHORT_ID, //String, 实例短id
"internalIp" : "10.130.xx.xx" , //String, 内网ip
"publicIp" : "180.xx.xx.xx", //String, 外网ip
"agentStatus" : 0 //Int, 0代表离线，1代表在线
"crackCount" : 0 //Int, 暴力破解拦截次数
"abnormalCount" : 0 //Int, 暴力破解拦截次数
"operation" : 0 //Int, 0代表"重新安装", 1代表"查看详情"
},
...
]
}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 | |
|---|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 | |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken | |
| time | int | 否 | Query参数 | 查询的最近小时数，默认为24小时 | |
| region | region | String | 是 | RequestBody | 区域 |
| vmList | list<VmLoginSummaryModel> | 是 | RequestBody | 虚机登录事件统计数据 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | region | 区域 |
| vmList | list<VmLoginSummaryModel> | 虚机登录事件统计数据 |
请求示例
POST /v2/hosteye/loginmanage/overview?time=24&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"region" : REGION, //String，"bj"/"gz"/"sz"/hk02"
"vmList" : [
{
"instanceName" : NAME, // String, 实例名称
"instanceId" : NAMEID, //String, 实例长id
"instanceShortId" : SHORT_ID, //String, 实例短id
"internalIp" : "10.130.xx.xx" , //String, 内网ip
"publicIp" : "180.xx.xx.xx", //String, 外网ip
"agentStatus" : 0 //Int, 0代表离线，1代表在线
"crackCount" : 0 //Int, 暴力破解拦截次数
"abnormalCount" : 0 //Int, 暴力破解拦截次数
"operation" : 0 //Int, 0代表"重新安装", 1代表"查看详情"
},
...
]
}响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"region" : REGION, //String，"bj"/"gz"/"sz"/hk02"
"vmList" : [
{
"instanceName" : NAME, // String, 实例名称
"instanceId" : NAMEID, //String, 实例长id
"instanceShortId" : SHORT_ID, //String, 实例短id
"internalIp" : "10.130.xx.xx" , //String, 内网ip
"publicIp" : "180.xx.xx.xx", //String, 外网ip
"agentStatus" : 0 //Int, 0代表离线，1代表在线
"crackCount" : 0 //Int, 暴力破解拦截次数
"abnormalCount" : 0 //Int, 暴力破解拦截次数
"operation" : 0 //Int, 0代表"重新安装", 1代表"查看详情"
},
...
]
}获取虚机登录次数趋势
描述
- 指定虚机长id, 获取0点以来每小时统计的登录次数趋势。
请求结构
GET /v{version}/hosteye/loginmanage/{instance_uuid}/eventCount?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| t0 | int | 昨日23:00:00至今日00:00:00间登录次数 |
| t1 | int | 今日00:00:00至今日01:00:00间登录次数 |
| .. | .. | .. |
| t24 | int | 今日23:00:00至今日24:00:00间登录次数 |
请求示例
GET /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/eventCount?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"t0": LOGIN_COUNT_0, //INT,昨日23:00:00至今日00:00:00间登录事件计数. key为字符串，value为int.
"t1": LOGIN_COUNT_1, //INT,今日00:00:00至今日01:00:00间登录事件计数
...
"t24": LOGIN_COUNT_24, //INT,今日23:00:00至今日24:00:00间登录事件计数
} 获取虚机登录事件列表
描述
- 指定最近时间time, 可选指定源IP或登录账号，查询登录事件列表。
请求结构
GET /v{version}/hosteye/loginmanage/{instance_uuid}/eventList?time={time}&sourceIp={sourceIp}&loginAccount={loginAccount}&pageNo={pageNo}&pageSize={pageSize}&clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
| time | int | 否 | Query参数 | 查询的最近小时数，默认为24小时 |
| pageNo | int | 否 | Query | 页号，默认为1 |
| pageSize | int | 否 | Query | 页大小，默认为10 |
| sourceIp | String | 否 | Query | 来源IP |
| loginAccount | String | 否 | Query | 登录账号 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | int | 总事件数目 |
| details | list<loginEventModel> | 登录事件列表 |
请求示例
GET /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/eventList?time=24&pageNo=1&pageSize=10&&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"details": [
{
"loginTime": LOGIN_TIME,
"eventType": EVENT_TYPE,
"repeatCount" : REPEAT_COUNT,
"targetVmid": LOGIN_TIME,
"sourceIp": SOURCE_IP, //String,来源IP，
"ipLocation": LOCATION,
"ipStatus" : STATUS,
"loginAccount": LOGIN_ACCOUNT,
"loginType": LOGIN_TYPE,
"loginResult":LOGIN_RESULT,
"operationStatus": CMD_STATUS,
},
...
],
"totalCount": 57 //Int,总数
}来源IP一键加白
描述
- 对指定虚机长id和来源IP加白。
请求结构
POST /v{version}/hosteye/loginmanage/{instance_uuid}/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
| ip | String | 是 | URL | 来源IP |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
POST /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS指定虚机移除白名单IP
描述
- 将指定虚机移除白名单IP。
请求结构
DELETE /v{version}/hosteye/loginmanage/{instance_uuid}/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
| ip | String | 是 | URL | 来源IP |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
DELETE /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS获取虚机白名单IP列表
描述
- 获取虚机白名单IP列表。
请求结构
GET /v{version}/hosteye/loginmanage/{instance_uuid}/whiteList?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| whiteList | list |
白名单ip列表 |
请求示例
GET /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/whiteList?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
'whiteList': [
"1.1.1.1",
"2.2.2.2"
]
}获取虚机封禁IP列表
描述
- 获取虚机封禁IP列表。
请求结构
GET /v{version}/hosteye/loginmanage/{instance_uuid}/denyList?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| denyList | list |
封禁ip列表 |
请求示例
GET /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/denyList?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
'denyList': [
"1.224.150.34",
"115.230.124.21"
]
}指定虚机解封禁某IP
描述
- 对指定虚机IP进行解封禁。
请求结构
PUT /v{version}/hosteye/loginmanage/{instance_uuid}/unblock/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| instance_uuid | String | 是 | URL | 虚机长id |
| ip | String | 是 | URL | 来源IP |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
PUT /v2/hosteye/loginmanage/ffff2065-460a-498a-8c6e-e771088a0001/unblock/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS获取区域白名单IP列表
描述
- 获取区域白名单IP列表。
请求结构
GET /v{version}/hosteye/loginmanage/showWhite?ip={ip}&pageNo={pageNo}&pageSize={pageSize}&clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 否 | Query | 白名单IP |
| pageNo | int | 否 | Query | 页号，默认为1 |
| pageSize | int | 否 | Query | 页大小，默认为10 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | int | 白名单ip总数目 |
| list | list<LoginWhiteIpModel> | 登录白名单ip列表 |
请求示例
GET /v2/hosteye/loginmanage/showWhite?ip=1.1.1.1&pageNo=1&pageSize=10&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"list":[
{
"region":"bj",
"whiteIp":"1.1.1.1",
"ipLocation":"澳大利亚",
"cmdInProcess":0,
"applyCount":2,
"failedCount":0,
"vmList":[
{
"vmid":"409cc6fa-bcf9-45b9-8c4f-b9ada0a7c06a",
"whiteStatus":12,
"region":"bj"
},
{
"vmid":"81d76287-ec0c-4e2d-8ea6-198d8a5a294c",
"whiteStatus":12,
"region":"bj"
}
]
}
],
"totalCount":1
}获取全局白名单IP列表
描述
- 获取全局白名单IP列表。
请求结构
GET /v{version}/hosteye/loginmanage/showAllWhite?ip={ip}&pageNo={pageNo}&pageSize={pageSize}&clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 否 | Query | 白名单IP |
| pageNo | int | 否 | Query | 页号，默认为1 |
| pageSize | int | 否 | Query | 页大小，默认为10 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | int | 白名单ip总数目 |
| list | list<LoginWhiteIpModel> | 登录白名单ip列表 |
请求示例
GET /v2/hosteye/loginmanage/showAllWhite?ip=1.1.1.1&pageNo=1&pageSize=10&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"list":[
{
"region":"bj",
"whiteIp":"1.1.1.1",
"ipLocation":"澳大利亚",
"cmdInProcess":0,
"applyCount":2,
"failedCount":0,
"vmList":[
{
"vmid":"409cc6fa-bcf9-45b9-8c4f-b9ada0a7c06a",
"whiteStatus":12,
"region":"bj"
},
{
"vmid":"81d76287-ec0c-4e2d-8ea6-198d8a5a294c",
"whiteStatus":12,
"region":"bj"
}
]
}
],
"totalCount":1
} 查看区域白名单IP配置
描述
- 查看区域白名单IP配置。
请求结构
GET /v{version}/hosteye/loginmanage/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 是 | URL | 白名单IP |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | region | 区域 |
| vmList | list<VmWhiteStatusModel> | 登录白名单ip列表 |
请求示例
GET /v2/hosteye/loginmanage/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"region":"bj",
"vmList":[
{
"vmid":"409cc6fa-bcf9-45b9-8c4f-b9ada0a7c06a",
"whiteStatus":12
},
{
"vmid":"81d76287-ec0c-4e2d-8ea6-198d8a5a294c",
"whiteStatus":12
}
]
}添加白名单IP配置
描述
- 添加白名单IP配置。
请求结构
POST /v{version}/hosteye/loginmanage/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string
{
"region": REGION, //String, "bj"/"gz"/"sz"/"hk02"/
"vmList" : [vmid1, vmid2], //String, 如9c308f36-dfbd-445a-9443-8a805f16f8c9,
}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 是 | URL | 白名单IP |
| region | region | 是 | RequestBody | 区域 |
| vmList | list<HOSTEYE/API参考/附录1.mdString> | 是 | RequestBody | 虚机长id列表 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
POST /v2/hosteye/loginmanage/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"region": REGION, //String, "bj"/"gz"/"sz"/"hk02"/
"vmList" : [vmid1, vmid2], //String, 如9c308f36-dfbd-445a-9443-8a805f16f8c9,
}响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS更新白名单IP配置
描述
- 更新白名单IP配置。
请求结构
PUT /v{version}/hosteye/loginmanage/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string
{
"region": REGION, //String, "bj"/"gz"/"sz"/"hk02"/
"vmList" : [
{
"vmid" : VMID , //String，Instance_uuid
"currentStatus" : OLD_STATUS, / /int, 0 代表未勾选， 1 代表被勾选
"expectedStatus" : NEW_STATUS, // int, 0 代表未勾选，1代表被勾选
},
]
}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 是 | URL | 白名单IP |
| region | region | 是 | RequestBody | 区域 |
| vmList | list<VmUpdateWhiteStatusModel> | 是 | RequestBody | 虚机长id更新状态列表 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
PUT /v2/hosteye/loginmanage/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"region": REGION, //String, "bj"/"gz"/"sz"/"hk02"/
"vmList" : [
{
"vmid" : VMID ,
"currentStatus" : OLD_STATUS,
"expectedStatus" : NEW_STATUS,
},
]
}响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS删除白名单IP配置
描述
- 删除白名单IP配置。
请求结构
DELETE /v{version}/hosteye/loginmanage/white/{ip}?clientToken={clientToken} HTTP/1.1
Host: bss.{region}.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值2 |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见clientToken |
| ip | String | 是 | URL | 白名单IP |
| region | region | 是 | RequestBody | 区域 |
| vmList | list<VmUpdateWhiteStatusModel> | 是 | RequestBody | 虚机长id更新状态列表 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
DELETE /v2/hosteye/loginmanage/white/1.1.1.1?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST bss.{region}.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS文档反馈