文档首页/ 安全云脑 SecMaster/ API参考/ API V2/ 应急策略/ 创建重试应急策略
更新时间：2025-08-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建重试应急策略

功能介绍

创建重试应急策略

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/workspaces/{workspace_id}/soc/policys

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取项目ID

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

workspace_id

是

String

参数解释：

工作空间id。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

action_type

是

String

操作类型：create创建，retry重试

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

content-type

是

String

参数解释：

内容类型

  • application/json;charset=UTF-8 普通API请求的类型

约束限制：

不涉及

取值范围：

  • application/json;charset=UTF-8

默认取值：

不涉及

x-secmaster-version

是

String

服务版本，例如25.5.0
表4 请求Body参数

参数

是否必选

参数类型

描述

data_object

否

data_object object

策略实体信息
表5 data_object

参数

是否必选

参数类型

描述

retry_list

否

Array of strings

重试策略ID

block_age

是

block_age object

阻断老化

block_target

是

String

策略对象

defense_policy_list

是

Array of defense_policy_list objects

与操作连接对应的策略列表

description

否

String

描述信息

labels

否

String

标签

policy_category

是

String

类型,WHITE/BLOCK,WHITE代表加白(将ip等对象加入白名单),BLOCK代表阻断(将ip等对象加入黑名单)

policy_type

是

policy_type object

阻断类型

region_id

是

String

区域ID

policy_direction

否

String

出入方向

account_scope

否

String

账号范围

eps_scope

否

String

企业项目范围

region_scope

否

String

region范围
表6 block_age

参数

是否必选

参数类型

描述

is_block_ageing

是

Boolean

是否阻断老化

block_ageing

否

String

老化时间，毫秒级时间戳
表7 defense_policy_list

参数

是否必选

参数类型

描述

defense_connection_id

是

String

操作连接ID

defense_connection_name

是

String

操作连接名称

defense_connection_region_id

是

String

防线策略归属区域ID

defense_connection_region_name

是

String

防线策略归属区域名称

defense_type

是

String

防线服务

target_enterprise_id

是

String

企业项目ID

target_enterprise_name

是

String

企业项目名称

target_project_id

是

String

防线策略归属项目ID

target_project_name

是

String

防线策略归属项目名称
表8 policy_type

参数

是否必选

参数类型

描述

policy_type

是

String

阻断类型：User Name/Source Ip/Domain Name

响应参数

状态码：200

表9 响应Body参数

参数

参数类型

描述

code

String

状态码

data

String

下发任务id

message

String

状态信息

request_id

String

请求id

success

Boolean

请求状态

状态码：400

表10 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

不涉及

message

String

参数解释:

错误描述

取值范围:

不涉及

请求示例

https://secmaster-qa.cn-north-7.myhuaweicloud.com/v1/{project_id}/workspaces/{workspace_id}/soc/policys?action_type=create

{
  "data_object" : {
    "region_id" : "cn-north-7",
    "block_target" : "1.2.3.4",
    "policy_category" : "BLOCK",
    "description" : "",
    "labels" : "",
    "block_age" : {
      "is_block_ageing" : false,
      "block_ageing" : null
    },
    "policy_type" : {
      "policy_type" : "Source Ip"
    },
    "defense_policy_list" : [ {
      "defense_connection_id" : "84b273d3-47a8-3aba-bd00-7bdd1431d635",
      "defense_connection_name" : "CFW云服务认证凭据",
      "defense_type" : "CFW",
      "target_enterprise_id" : "0",
      "target_enterprise_name" : "default",
      "target_project_id" : "3bb27e024693436da46b5f5aaf499060",
      "target_project_name" : "cn-north-7",
      "defense_connection_region_id" : "cn-north-7",
      "defense_connection_region_name" : "XXX"
    } ]
  }
}

响应示例

无

状态码

状态码

描述

200

创建应急策略返回body体

400

创建应急策略错误返回body体

错误码

请参见错误码。

父主题： 应急策略

相关文档