所有文档

          主机安全 HOSTEYE

          登录管理相关接口

          获取虚机登录事件统计结果

          描述

          • 指定最近时间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
          上一篇
          错误码
          下一篇
          网站后门相关接口