更新时间:2025-09-23 GMT+08:00

切换防护状态

功能介绍

切换防护状态

URI

POST /v5/{project_id}/host-management/protection

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

企业项目ID,查询所有企业项目时填写:all_granted_eps

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

表4 请求Body参数

参数

是否必选

参数类型

描述

version

String

主机开通的版本,包含如下:

  • hss.version.null :无,代表关闭防护。

  • hss.version.basic :基础版。

  • hss.version.advanced :专业版。

  • hss.version.enterprise :企业版。

  • hss.version.premium :旗舰版。

  • hss.version.wtp :网页防篡改版。

charging_mode

String

付费模式,当version不为“hss.version.null”时,则需必填该参数

  • on_demand : 按需

resource_id

String

HSS配额ID,不填该参数时,则随机选择对应版本配额

host_id_list

Array of strings

服务器列表

tags

Array of TagInfo objects

资源标签列表

表5 TagInfo

参数

是否必选

参数类型

描述

key

String

键。最大长度128个unicode字符。 key不能为空

value

String

值。最大长度255个unicode字符。

响应参数

状态码:200

successful response

请求示例

切换ID为71a15ecc-049f-4cca-bd28-5e90aca1817f的服务器防护版本为基础版。

{
  "version" : "hss.version.basic",
  "charging_mode" : "on_demand",
  "resource_id" : "af4d08ad-2b60-4916-a5cf-8d6a23956dda",
  "host_id_list" : [ "71a15ecc-049f-4cca-bd28-5e90aca1817f" ],
  "tags" : [ {
    "key" : "服务",
    "value" : "hss"
  } ]
}

响应示例

状态码

状态码

描述

200

successful response

错误码

请参见错误码