主机安全客户端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
    上一篇
    错误码
    下一篇
    网站后门相关接口