华为云用户手册

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/playbooks/versions/{version_id}/actions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID workspace_id 是 String 工作空间ID version_id 是 String 剧本版本ID 表2 Query参数 参数 是否必选 参数类型 描述 limit 是 Integer 分页查询参数，用于指定一次查询最多的结果数，从1开始 offset 是 Integer 分页查询参数。用于指定查询结果的起始位置，从0开始

响应示例 状态码： 200 请求成功响应参数 { "code" : 0, "message" : "Error message", "total" : 41, "size" : 3, "page" : 10, "data" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "name" : "MyXXX", "description" : "This my XXXX", "action_type" : "Workflow", "action_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "playbook_id" : "string", "playbook_version_id" : "string", "project_id" : "string" } ]}

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误信息 total Integer 总数 size Integer 分页大小 page Integer 当前页数 data Array of ActionInfo objects 剧本动作列表信息 表6 ActionInfo 参数 参数类型 描述 id String 剧本流程动作ID name String 流程动作名称 description String 描述 action_type String 流程动作类型 action_id String 流程ID playbook_id String 剧本ID playbook_version_id String 剧本版本ID project_id String 项目ID 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/dataclasses 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id workspace_id 是 String 工作空间id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 limit 否 Integer 数据量 name 否 String 名称查询 business_code 否 String 业务编码 description 否 String 描述 is_built_in 否 Boolean 是否内置

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 dataclass_details Array of DataClassResponseBody objects 数据类详情 total Number 数据总量 表6 DataClassResponseBody 参数 参数类型 描述 id String 数据类ID create_time String 创建时间 update_time String 更新时间 creator_id String 创建者ID creator_name String 创建者名称 modifier_id String 修改者ID modifier_name String 修改这名称 cloud_pack_version String 订阅包版本 region_id String 区域ID project_id String 租户ID workspace_id String 工作空间ID domain_id String domain id name String 数据类名称 business_code String 数据类业务编码 description String 数据类描述 is_built_in Boolean 是否内置，true内置，false非内置 parent_id String 父级id type_num Number 子类型数量 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

响应示例 状态码： 200 请求成功 { "total" : 41, "dataclass_details" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "create_time" : "2021-01-30T23:00:00Z+0800", "update_time" : "2021-01-30T23:00:00Z+0800", "creator_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "creator_name" : "张三", "modifier_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "modifier_name" : "李四", "cloud_pack_version" : "订阅包版本", "region_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "workspace_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "domain_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "name" : "证据", "business_code" : "Evidence", "description" : "我的数据类描述", "is_built_in" : false, "parent_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "type_num" : 9 } ]}

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 返回码 total Integer 数据总条数 offset Integer 当前页大小 limit Integer 当前页码 message String 请求ID success Boolean 是否成功 data Array of AopWorkflowInfo objects 流程信息列表 表6 AopWorkflowInfo 参数 参数类型 描述 id String 流程ID name String 流程名称 description String 描述 project_id String 租户ID owner_id String 所有者ID creator_id String 创建者ID edit_role String 编辑角色 use_role String 是用角色 approve_role String 审核人 enabled Boolean 是否已启用 workspace_id String 工作空间ID version_id String 流程版本ID current_approval_version_id String 当前待审核版本号 current_rejected_versoin_id String 当前拒绝的版本号 aop_type String aop的类型有以下的值 NORMAL, 通用 SURVEY, 调查 HEMOSTASIS,止血 EASE;缓解 engine_type String 引擎的类型分为共享版和专项版 dataclass_id String 数据类的ID 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

响应示例 状态码： 200 请求成功 { "code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "message" : "Error message", "total" : 41, "limit" : 2, "offset" : 1, "success" : true, "data" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "name" : "流程名称", "description" : "描述", "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "owner_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "creator_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "edit_role" : "编辑者", "use_role" : "使用者", "approve_role" : "审批者", "enabled" : true, "workspace_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "version_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "current_approval_version_id" : "v2", "current_rejected_versoin_id" : "v1", "aop_type" : "EASE;缓解", "engine_type" : "public_engine", "dataclass_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f" } ]}

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/workflows 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id workspace_id 是 String 工作空间id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 limit 否 Integer 数据量 order 否 String 排序顺序，asc：升序，desc：降序 sortby 否 String 排序字段，create_time：创建时间，category：类型分类名称 enabled 否 Boolean 是否启用 last_version 否 Boolean 最新版本号 name 否 String 流程名称 description 否 String 流程描述 dataclass_id 否 String 数据类ID dataclass_name 否 String 数据类名称 aop_type 否 String 流程类型

响应示例 状态码： 200 剧本列表查询成功响应参数 { "code" : 0, "message" : null, "total" : 41, "page" : 10, "data" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "name" : "MyXXX", "description" : "This my XXXX", "create_time" : "2021-01-30T23:00:00Z+0800", "update_time" : "2021-01-30T23:00:00Z+0800", "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "version_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "enabled" : true, "workspace_id" : "string", "approve_role" : "approve", "user_role" : "string", "edit_role" : "editor", "owner_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "version" : "v1.1.1", "dataclass_name" : "string", "dataclass_id" : "string", "unaudited_version_id" : "string", "reject_version_id" : "string" } ]}

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 错误码 message String 响应消息信息 total Integer 总条数 size Integer 分页查询数据大小 page Integer 当前页码 data Array of PlaybookInfo objects 剧本列表信息 表6 PlaybookInfo 参数 参数类型 描述 id String 剧本ID name String 剧本名称 description String 描述信息 create_time String 剧本创建时间 update_time String 剧本更新时间 project_id String 项目ID version_id String 剧本版本ID enabled Boolean 是否启用 workspace_id String 工作空间ID approve_role String 审核用户角色 user_role String 用户角色 edit_role String 编辑用户角色 owner_id String 所有者ID version String 版本号 dataclass_name String 数据类名称 dataclass_id String 数据类ID unaudited_version_id String 待审核剧本版本ID reject_version_id String 已驳回剧本版本ID 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/playbooks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID workspace_id 是 String 工作空间ID 表2 Query参数 参数 是否必选 参数类型 描述 search_txt 否 String 搜索关键字 enabled 否 Boolean 是否启用 offset 是 Integer 分页查询参数。用于指定查询结果的起始位置，从0开始 limit 是 Integer 分页查询参数，用于指定一次查询最多的结果数，从1开始 description 否 String 剧本描述 dataclass_name 否 String 数据类名称 name 否 String 剧本名称

响应示例 状态码： 200 请求成功响应信息 { "code" : 0, "message" : "Error message", "size" : 3, "page" : 10, "total" : 41, "data" : [ { "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "description" : "This my XXXX", "create_time" : "2021-01-30T23:00:00Z+0800", "update_time" : "2021-01-30T23:00:00Z+0800", "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "creator_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "modifier_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "playbook_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "version" : "v1.1.1", "enabled" : true, "status" : "editing", "action_strategy" : "sync", "rule_enable" : true, "dataclass_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "trigger_type" : "event", "dataobject_create" : true, "dataobject_update" : true, "dataobject_delete" : true, "version_type" : 1, "rule_id" : "string", "dataclass_name" : "string", "approve_name" : "string" } ]}

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/playbooks/{playbook_id}/versions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID workspace_id 是 String 工作空间ID playbook_id 是 String 剧本ID 表2 Query参数 参数 是否必选 参数类型 描述 status 否 String 剧本版本状态，编辑中：EDITING 审核中：APPROVING 不通过：UNPASSED 已发布：PUBLISHED enabled 否 Integer 启用/禁用 version_type 否 Integer 版本类型， 草稿版本：0 正式版本：1 offset 否 Integer 分页查询参数。用于指定查询结果的起始位置，从0开始 limit 否 Integer 分页查询参数，用于指定一次查询最多的结果数，从1开始

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误信息 size Integer 分页查询数据大小 page Integer 当前页码 total Integer 总数 data Array of PlaybookVersionListEntity objects 剧本版本列表信息 表6 PlaybookVersionListEntity 参数 参数类型 描述 id String 剧本版本ID description String 描述 create_time String 创建时间 update_time String 更新时间 project_id String 项目ID creator_id String 创建者ID modifier_id String 修改者ID playbook_id String 剧本ID version String 版本号 enabled Boolean 是否激活 status String 状态. (EDITING--编辑中, APPROVING--审核中, UNPASSED--审核不通过, PUBLISHED--审核通过) action_strategy String 执行策略. 目前仅支持异步并发执行，对应值为ASYNC rule_enable Boolean 过滤规则是否启用 dataclass_id String 数据类ID trigger_type String 触发方式. EVENT--事件触发, TIMER--定时触发 dataobject_create Boolean 标识数据对象是否创建时触发剧本 dataobject_update Boolean 标识数据对象是否更新时触发剧本 dataobject_delete Boolean 标识数据对象是否删除时触发剧本 version_type Integer 版本类型 rule_id String 过滤规则ID dataclass_name String 数据类名称 approve_name String 审核者 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

响应参数 状态码： 200 表6 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为:request_uuid-timestamp-hostname. 表7 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误信息 total Integer 总数 data Array of IndicatorDetail objects 指标列表数据 表8 IndicatorDetail 参数 参数类型 描述 id String 威胁情报ID name String 威胁情报名称 data_object IndicatorDataObjectDetail object 情报详情 workspace_id String 工作空间ID project_id String 项目ID dataclass_ref DataClassRefPojo object 数据类对象信息 create_time String 创建时间 update_time String 更新时间 表9 IndicatorDataObjectDetail 参数 参数类型 描述 indicator_type indicator_type object 情报类型对象 value String 值，如：ip url domain等 update_time String 更新时间 create_time String 创建时间 environment environment object 环境信息 data_source data_source object 数据源信息 first_report_time String 首次发生时间 is_deleted Boolean 是否删除 last_report_time String 最近发生时间 granular_marking Integer 粒度（保密等级），由高到低：1（首次发现）、2（自产数据）、3（需购买）、4（外网直接查询） name String 名称 id String 威胁情报ID project_id String 项目ID revoked Boolean 是否作废 status String 状态， Open--打开，Closed--关闭, Revoked--作废 verdict String 威胁度， Black--黑,White--白，Gray--灰 workspace_id String 工作空间ID confidence Integer 置信度，取值范围是80-100 表10 indicator_type 参数 参数类型 描述 indicator_type String 情报类型 id String 情报类型ID 表11 environment 参数 参数类型 描述 vendor_type String 环境供应商 domain_id String 租户ID region_id String 区域ID project_id String 项目ID 表12 data_source 参数 参数类型 描述 source_type Integer 数据源类型，取值范围如下：1 - 云上产品 2 - 第三方产品 3 - 租户私有产品 domain_id String 租户ID project_id String 项目ID region_id String 区域ID 表13 DataClassRefPojo 参数 参数类型 描述 id String 数据类ID name String 数据类名称 状态码： 400 表14 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表15 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

请求示例 查询id为id1、id2，名称为威胁情报名称，类型为DATA_SOURCE，数据类id为28f61af50fc9452aa0ed5ea25c3cc3d3的威胁情报列表，偏移量为0，查询上限10条，根据create_time排序 { "ids" : [ "id1", "id2" ], "dataclass_id" : "28f61af50fc9452aa0ed5ea25c3cc3d3", "condition" : { "conditions" : [ { "name" : "name", "data" : [ "name", "=", "威胁情报名称" ] } ], "logics" : [ "title" ] }, "offset" : 0, "limit" : 10, "sort_by" : "create_time", "from_date" : "2024-01-20T00:00:00.000Z+0800", "to_date" : "2024-01-26T23:59:59.999Z+0800"}

响应示例 状态码： 200 请求成功响应信息 { "code" : "00000000", "data" : [ { "create_time" : "2023-07-24T20:54:19Z+0800", "data_object" : { "indicator_type" : { "indicator_type" : "ipv6", "id" : "ac794b2dfab9fe8c0676587301a636d3" }, "revoked" : false, "workspace_id" : "d5baeef8-3e75-4e91-9826-fb208ac58987", "update_time" : "2023-07-24T20:54:19.038Z+0800", "project_id" : "15645222e8744afa985c93dab6341da6", "first_report_time" : "2023-07-31T20:54:12.000Z+0800", "id" : "ff61d1f8-0de4-4077-9e9b-e312f6829c6d", "granular_marking" : 1, "value" : "{}", "create_time" : "2023-07-24T20:54:19.038Z+0800", "confidence" : 80, "last_report_time" : "2023-07-25T20:54:15.000Z+0800", "data_source" : { "domain_id" : "ac7438b990ef4a37b741004eb45e8bf4", "project_id" : "15645222e8744afa985c93dab6341da6", "region_id" : "cn-XXX-7", "source_type" : 1 }, "environment" : { "domain_id" : "ac7438b990ef4a37b741004eb45e8bf4", "project_id" : "15645222e8744afa985c93dab6341da6", "region_id" : "cn-xxx-7", "vendor_type" : "xxx" }, "verdict" : "Black", "name" : "test", "status" : "Open" }, "dataclass_ref" : { "id" : "97ccf890-7480-31f6-a961-cf8da1f2f040", "name" : "name" }, "id" : "ff61d1f8-0de4-4077-9e9b-e312f6829c6d", "update_time" : "2023-07-24T20:54:19Z+0800" } ], "message" : "", "total" : 2}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 租户的Token content-type 是 String application/json;charset=UTF-8 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 否 Array of strings 威胁情报ID列表 dataclass_id 否 String 数据类ID condition 是 condition object 搜索条件表达式 offset 是 Integer request offset, from 0 limit 是 Integer request limit size sort_by 否 String sort by property, create_time. from_date 否 String 查询起始时间，例如：2024-01-20T00:00:00.000Z+0800 to_date 否 String 查询截止时间，例如：2024-01-26T23:59:59.999Z+0800 表4 condition 参数 是否必选 参数类型 描述 conditions 否 Array of conditions objects 表达式列表 logics 否 Array of strings 表达式名称列表 表5 conditions 参数 是否必选 参数类型 描述 name 否 String 表达式名称 data 否 Array of strings 表达式内容列表

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 错误码 message String 响应消息 data Array of ApproveOpinionDetail objects 剧本审核详情 表6 ApproveOpinionDetail 参数 参数类型 描述 result String 审核结果 content String 审核内容 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

URI GET /v1/{project_id}/workspaces/{workspace_id}/soc/playbooks/versions/approval 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID workspace_id 是 String 工作空间ID 表2 Query参数 参数 是否必选 参数类型 描述 resource_id 否 String 资源ID approve_type 否 String 审核类型。（PLAYBOOK-剧本, AOP_WORKFLOW--流程)

响应示例 状态码： 200 请求成功 { "count" : 9223372036854776000, "records" : [ { "template_id" : "443a0117-1aa4-4595-ad4a-796fad4d4950", "update_time" : 1665221214, "template_name" : "Alert rule template", "data_source" : "sec_hss_vul", "version" : "1.0.0", "query" : "* | select status, count(*) as count group by status", "query_type" : "SQL", "severity" : "TIPS", "custom_properties" : { "references" : "https://localhost/references", "maintainer" : "isap" }, "event_grouping" : true, "schedule" : { "frequency_interval" : 5, "frequency_unit" : "MINUTE", "period_interval" : 5, "period_unit" : "MINUTE", "delay_interval" : 2, "overtime_interval" : 10 }, "triggers" : [ { "mode" : "COUNT", "operator" : "GT", "expression" : 10, "severity" : "TIPS" } ] } ]}

URI GET /v1/{project_id}/workspaces/{workspace_id}/siem/alert-rules/templates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目 ID。Project ID. workspace_id 是 String 工作空间 ID。Workspace ID. 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Long 偏移量。Offset. limit 是 Long 条数。Limit. sort_key 否 String 排序字段。Sort key sort_dir 否 String 排序顺序，顺序、逆序。Sort direction, asc, desc。 severity 否 Array of strings 严重程度，提示、低危、中危、高危、致命。Severity. TIPS, LOW, MEDIUM, HIGH, FATAL

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用 IAM 服务获取用户Token接口获取。 IAM user token, fetch from IAM api. 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of strings EnableAlertRuleRequestBody

响应示例 状态码： 200 取消关联Dataobject返回body体 { "code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f", "message" : "Error message", "request_id" : "Error message", "success" : false, "total" : 41, "limit" : 3, "offset" : 10, "data" : { "success_ids" : [ "909494e3-558e-46b6-a9eb-07a8e18ca62f" ], "error_ids" : [ "909494e3-558e-46b6-a9eb-07a8e18ca62f" ] }}

URI DELETE /v1/{project_id}/workspaces/{workspace_id}/soc/{dataclass_type}/{data_object_id}/{related_dataclass_type} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id workspace_id 是 String 工作空间id dataclass_type 是 String 关联主体dataobject所属数据类，小写复数，如告警为alerts，事件为incidents data_object_id 是 String 关联主体dataobject的id related_dataclass_type 是 String 被关联的dataobject所属数据类，小写复数，如告警为alerts，事件为incidents

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） content-type 是 String 内容类型 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 否 Array of strings 关联dataobject的ID列表

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表5 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误信息 data BatchOperateDataobjectResult object 批量操作告警返回对象 表6 BatchOperateDataobjectResult 参数 参数类型 描述 error_ids Array of strings 失败id success_ids Array of strings 成功id 状态码： 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,格式为：request_uuid-timestamp-hostname 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 X-Language 是 String 用户当前语言环境 zh-cn or en-us. 表3 请求Body参数 参数 是否必选 参数类型 描述 region_id 是 String 区域ID，如cn-north-4 domain_id 是 String domainId tag_list 否 Array of TagInfo objects 计费标签 product_list 否 Array of ProductPostPaid objects 商品列表 operate_type 否 String 操作类型：create新购, addition增加配额 表4 TagInfo 参数 是否必选 参数类型 描述 key 是 String 标识 中文、字母、数字、_或者-，且长度范围[2, 36] value 是 String 内容 中文、字母、数字、_或者-，且长度范围[2, 36] 表5 ProductPostPaid 参数 是否必选 参数类型 描述 id 是 String ID标识，同一次询价中不能重复，用于标识返回询价结果和请求的映射关系 product_id 是 String 产品Id，通过向CBC询价获取该商品的标识 cloud_service_type 是 String 云服务类型，固定值为hws.service.type.sa resource_type 是 String 用户购买云服务产品的资源类型，例如SecMaster中的典型场景配置，资源类型为hws.resource.type.secmaster.typical resource_spec_code 是 String 用户购买云服务产品的资源规格，例如 安全云脑 中的的基础版，资源规格为secmaster.basic usage_measure_id 是 Integer 使用量单位标识，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时，枚举值如下： 4：小时 10：GB（带宽按流量询价使用） 11：MB（带宽按流量询价使用） usage_value 是 Number 使用量值，按需询价必填，例如按小时询价，使用量值为1，使用量单位为小时 resource_size 是 Integer 配额个数 usage_factor 是 String 使用量因子，按需计费必填，取值和话单中的使用量因子一致，云服务和使用量因子对应关系如下： 典型场景配置：Duration 态势管理：duration 安全编排：count 智能分析：flow resource_id 否 String 资源id，仅在增加配额的时候传入

请求示例 https://{endpoint}/v1/{projectId}/subscriptions/orders{ "domain_id" : "abcdef8a41164a2280ec65f1f4c4mlnyz", "region_id" : "cn-north-4", "product_list" : [ { "product_id" : "OFFI908269345109094402", "cloud_service_type" : "hws.service.type.sa", "id" : "E52E1A22-9408-459A-9F67-7B5C11B1E71A", "resource_spec_code" : "secmaster.professional", "resource_type" : "hws.resource.type.secmaster.typical", "usage_factor" : "duration", "usage_value" : 1, "usage_measure_id" : 4, "resource_size" : 1 } ]}