文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 计量计费管理/ 更新订购资源 - UpdateSubscriptionOrder
更新时间：2026-01-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新订购资源 - UpdateSubscriptionOrder

功能介绍

更新订购资源

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v1/{project_id}/subscriptions/orders

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户projectId

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

X-Language

是

String

用户当前语言环境
表3 请求Body参数

参数

是否必选

参数类型

描述

scene

是

String

操作场景，包周期场景：PREPAID 或者 按需场景：POSTPAID

operate_type

是

String

按需或者包周期场景下，要进行的操作类型

比如增减配额，规格升降配，按需转包周期

规格升级：UPGRADE，配额增加：ADDITION，配额减少：DECREASE，按需转包周期：POSTPAID_2_PREPAID

注：目前不支持规格降级，比如不支持从专业版降级为标准版或基础版

promotion_info

否

String

促销折扣信息

tag_list

否

Array of SubscriptionTag objects

计费标签

product_list

否

Array of UpdateProduct objects

要进行变更的商品列表
表4 SubscriptionTag

参数

是否必选

参数类型

描述

key

否

String

键。

最大长度36个字符。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）

value

否

String

值。 最大长度43个字符，可以为空字符串。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）
表5 UpdateProduct

参数

是否必选

参数类型

描述

resource_type

是

String

变更后的资源类型

resource_spec_code

是

String

变更后的商品规格编码

resource_size

是

Integer

变更后的资源配额

如果operate_type为addition时，resource_size必须要大于原来的resource_id，decrease时要小于原来的resource_size，并且大于等于当前project下的ecs数量

resource_id

是

String

要进行变更的资源ID

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

order_id

String

创建或变更订单ID，只有scene为PREPAID时返回有此数据

order_status

Integer

订单更新状态，1：变更订单成功，5，订单变更失败

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述

取值范围:

不涉及

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述

取值范围:

不涉及

状态码：404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述

取值范围:

不涉及

请求示例

  • 包周期基础版升级到专业版（假设历史版本为基础版）

    {
  "scene" : "PREPAID",
  "operate_type" : "UPGRADE",
  "product_list" : [ {
    "resource_type" : "xxx.resource.type.secmaster.typical",
    "resource_spec_code" : "secmaster.professional",
    "resource_size" : 3,
    "resource_id" : "e6d9047a-3478-4867-8c0d-7c4cfed1685b"
  } ],
  "tag_list" : [ {
    "key" : "testKey3",
    "value" : "testVal3"
  } ]
}

  • 按需配额增加

    {
  "scene" : "POSTPAID",
  "operate_type" : "ADDITION",
  "product_list" : [ {
    "resource_type" : "xxx.resource.type.secmaster.typical",
    "resource_spec_code" : "secmaster.professional",
    "resource_size" : 3,
    "resource_id" : "e6d9047a-3478-4867-8c0d-7c4cfed1685b"
  } ],
  "tag_list" : [ {
    "key" : "testKey3",
    "value" : "testVal3"
  } ]
}

  • 按需配额减少

    {
  "scene" : "POSTPAID",
  "operate_type" : "DECREASE",
  "product_list" : [ {
    "resource_type" : "xxx.resource.type.secmaster.typical",
    "resource_spec_code" : "secmaster.professional",
    "resource_size" : 2,
    "resource_id" : "e6d9047a-3478-4867-8c0d-7c4cfed1685b"
  } ],
  "tag_list" : [ {
    "key" : "testKey3",
    "value" : "testVal3"
  } ]
}

  • 按需转包周期

    {
  "scene" : "POSTPAID",
  "operate_type" : "POSTPAID_2_PREPAID",
  "product_list" : [ {
    "resource_spec_code" : "secmaster.professional",
    "resource_id" : "e6d9047a-3478-4867-8c0d-7c4cfed1685b"
  } ]
}

响应示例

无

状态码

状态码

描述

200

接口请求成功

400

请求参数异常

403

权限不足

404

资源不存在

错误码

请参见错误码。

父主题： 计量计费管理

相关文档