更新时间:2025-07-04 GMT+08:00

安全云脑按需订购

功能介绍

开通安全云脑按需服务

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/subscriptions/orders

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID

请求参数

表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

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,仅在增加配额的时候传入

响应参数

状态码:200

请求成功

请求示例

https://{endpoint}/v1/{projectId}/subscriptions/orders

{
  "domain_id" : "abcdef8a41164a2280ec65f1f4c4mlnyz",
  "region_id" : "region_id",
  "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
  } ]
}

响应示例

状态码:400

参数异常

{
  "error_msg" : "云脑已包含【标准版】,如有需要请升级版本或增加配额",
  "error_code" : "SecMaster.00010201"
}

状态码

状态码

描述

200

请求成功

400

参数异常

403

权限不足

错误码

请参见错误码