最近更新时间：2024.04.22 11:34:50
首次发布时间：2024.04.22 11:34:50
调用 RenewDedicatedHost 接口续费一台专有宿主机，优先使用抵扣代金券方式续费。
名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | RenewDedicatedHost | 要执行的操作，取值：RenewDedicatedHost。 |
| Version | String | 是 | 2020-04-01 | API的版本，取值：2020-04-01。 |
| DedicatedHostId | String | 是 | dh-3tigy72q3u3vj0x2**** | 专有宿主机ID。 |
Period | Integer | 是 | 1 | 续费时长（月）。 |
PeriodUnit | String | 是 | Month | 续费时长的时间单位，即参数 取值：Month。 |
ClientToken | String | 否 | 23fa21A8823nfasd7f**** | 保证请求幂等性。由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| OrderId | String | Order7007335217124****** | 订单ID。 |
GET /?Action=RenewDedicatedHost&Version=2020-04-01&DedicatedHostId=dh-ycje2rquioh9l3bn****&Period=1&PeriodUnit=Month HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "2023071716274123B73A705E255110****", "Action": "RenewDedicatedHost", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "OrderId": "Order725670114528284****" } }
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Insufficient.Balance | The request is denied due to the lack of balance. | 账户余额不足。 |
| 400 | InvalidChargeType | The specified ChargeType is not valid, is unsupported, or cannot be used. | 指定的计费类型不合法。 |
| 400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
| 400 | InvalidPeriod.Malformed | The specified period is malformed. | 指定的计费周期不合法。 |
| 400 | InvalidPeriodUnit.Malformed | The specified PeriodUnit is malformed. | 指定的计费周期单位不合法。 |
| 400 | MissingParameter.DedicatedHostId | The required parameter DedicatedHostId is not supplied. | 参数DedicatedHostId不能为空。 |
| 400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | 幂等参数不一致。 |
| 404 | InvalidDedicatedHost.NotFound | The specified dedicated host does not exist. | 指定的专有宿主机不存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 先前的幂等请求仍在处理中，请稍后重试。 |
| 412 | OperationDenied.ResourceLocked | The specified operation is denied as your resource is locked for another operation. | 指定的操作被拒绝，因为您的资源已被其他操作锁定。 |
| 500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |