续费席位-大模型服务平台百炼(Model Studio)-阿里云帮助中心

对席位订阅进行整体续费。

前提条件

已获取阿里云账号或 RAM 用户的 AccessKey，并已为其授予调用 BssOpenApi 所需的 RAM 权限。建议将 AccessKey 配置为环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET，避免明文写入代码。

已有一个有效的 Token Plan 团队版席位订阅，并已通过 QueryProductList 获取 ProductCode、ProductType 和 SubscriptionType。

请求说明

HTTP 方法：POST
请求地址
地域
Endpoint
中国站
POST https://business.aliyuncs.com/
认证方式
本接口属于 BssOpenApi（版本 2023-09-30），采用 AccessKey 签名（RPC 签名，HMAC-SHA1），不支持 Authorization: Bearer {API_KEY} 方式。

推荐使用阿里云 SDK 的 CommonRequest 发起调用，SDK 会自动生成公共参数并计算签名。

地域	Endpoint
中国站	`POST https://business.aliyuncs.com/`

请求参数

全部参数通过表单或 Query String 传递。

参数	类型	必选	描述
ProductCode	string	是	产品代码。通过 `QueryProductList` 获取，例如 `sfm`。
ProductType	string	是	产品类型。通过 `QueryProductList` 获取，例如 `sfm_tokenplanteams_dp_cn`。
SubscriptionType	string	是	订阅类型。通过 `QueryProductList` 获取，例如 `Subscription`。
ClientToken	string	是	幂等性令牌。由客户端生成，需保证不同请求间唯一，最大 64 个 ASCII 字符。
Period	integer	是	续费周期数，至少为 1。
PeriodUnit	string	是	付费周期单位。取值： `Year`：年 `Month`：月
AutoRenew	boolean	否	是否开启自动续费。

返回参数

参数	类型	描述
RequestId	string	请求 ID。
Success	boolean	是否成功。
Code	string	结果码，成功为 `Success`。
Message	string	结果描述。
Data	object	业务数据。
Data.OrderId	long	续费订单 ID。
Data.HostId	string	站点标识。中国站返回 `cn`；部分响应可能不返回该字段。
AccessDeniedDetail	string	RAM 权限被拒绝时的详细错误信息。

请求示例

本接口使用 BssOpenApi 的 RPC 签名。下例中 ${SIGNATURE} 需按签名算法计算，SignatureNonce 和 Timestamp 需替换为实际值。使用阿里云 SDK 时会自动处理公共参数和签名。

curl -X POST "https://business.aliyuncs.com/" \
    --data-urlencode "Action=RenewCreditSeat" \
    --data-urlencode "Version=2023-09-30" \
    --data-urlencode "Format=JSON" \
    --data-urlencode "AccessKeyId=${ALIBABA_CLOUD_ACCESS_KEY_ID}" \
    --data-urlencode "SignatureMethod=HMAC-SHA1" \
    --data-urlencode "SignatureVersion=1.0" \
    --data-urlencode "SignatureNonce=${SIGNATURE_NONCE}" \
    --data-urlencode "Timestamp=2026-01-01T12:00:00Z" \
    --data-urlencode "Signature=${SIGNATURE}" \
    --data-urlencode "ProductCode=sfm" \
    --data-urlencode "ProductType=sfm_tokenplanteams_dp_cn" \
    --data-urlencode "SubscriptionType=Subscription" \
    --data-urlencode "ClientToken=example-client-token-001" \
    --data-urlencode "Period=1" \
    --data-urlencode "PeriodUnit=Month" \
    --data-urlencode "AutoRenew=false"

返回示例

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123459
  }
}

错误码

如果调用失败，会返回错误信息。续费场景的常见错误码：

INSTANCE_HOLDING_LIMIT_EXCEEDED：实例持有数量超过限制。
MissingParameter：缺少必填参数。
ResourceNotExists：指定的资源不存在。

更多错误码及解决方法，请参见 BssOpenApi 错误码。