登录管理相关接口

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

描述

  • 指定最近时间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 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