设置自动续费开关
开启或关闭单个资源的自动续费。只修改已有策略的开关,不提交或修改规格、套餐、币种信息。
接口地址:
text
/papi/wallet/auto-renew/update请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数(单个资源):
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| resourceType | integer | 是 | 资源类型:1 云机、4 代理 IP、6 云盘,一次请求的资源类型相同 |
| resourceUid | string | 是 | 资源标识,取策略列表返回的 resourceUid |
| enabled | boolean | 是 | true 开启、false 关闭 |
请求示例(单个资源):
json
{
"resourceType": 1,
"resourceUid": "从策略列表取得的resourceUid",
"enabled": true
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 更新后的策略对象 |
| ├─ resourceType | integer | 资源类型:1 云机、4 代理 IP、6 云盘 |
| ├─ resourceUid | string | 资源标识 |
| ├─ enabled | integer | 自动续费开关:0 关闭、1 开启(请求时使用布尔值) |
| ├─ status | string | 策略状态 |
| ├─ currency | string | 币种代码 |
| ├─ skuCode | string | 商品规格编码 |
| ├─ packageCode | string | 套餐编码 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"resourceType": 1,
"resourceUid": "",
"enabled": 1,
"status": "",
"currency": "USD",
"skuCode": "",
"packageCode": ""
},
"msg": ""
}说明:
- 策略必须存在,且付款人、团队和资源归属校验通过;开启时还会校验资源、规格、套餐及有效期。
- 关闭时保留现有资源和套餐信息;云盘按购买记录区分策略,不能用团队 ID 代替。
