Renews one or more subscription dedicated hosts.
Operation description
Operation description
When you make a renewal payment, deductible vouchers are used first. Your account must support balance payment or credit payment.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:RenewDedicatedHosts |
update |
*DedicatedHost
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| DedicatedHostIds |
string |
Yes |
The list of dedicated host IDs. You can enter up to 100 subscription dedicated host IDs. Specify multiple IDs in a JSON array formatted as |
dh-bp199lyny9b3**** |
| RegionId |
string |
Yes |
The region ID of the dedicated host. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
| Period |
integer |
Yes |
The renewal period. Valid values:
|
1 |
| PeriodUnit |
string |
No |
The unit of the renewal period. Valid values:
Default value: Month. |
Month |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence. |
123e4567-e89b-12d3-a456-426655440000 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
2A4EA075-CB5B-41B7-B0EB-70D339F6**** |
| OrderId |
string |
The order ID. |
23841229**** |
Examples
Success response
JSON format
{
"RequestId": "2A4EA075-CB5B-41B7-B0EB-70D339F6****",
"OrderId": "23841229****"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IdempotenceParamNotMatch | Request uses a client token in a previous request but is not identical to that request. | This request and the previous request contain the same client token but different other parameters. |
| 400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | The specified ClientToken parameter is invalid. |
| 400 | InvalidPeriod | The specified period is not valid. | The specified period is invalid. |
| 400 | InvalidPeriodUnit.ValueNotSupported | The specified parameter PeriodUnit is not valid. | The specified PeriodUnit parameter is invalid. |
| 400 | ChargeTypeViolation | Pay-As-You-Go dedicated host do not support this operation. | |
| 400 | InvalidDedicatedHostId.NotFound | The specified DedicatedHostId does not exist. | The specified dedicated host does not exist. |
| 400 | InvalidStatus.Upgrading | The dedicated host is upgrading, please try it later. | The specified dedicated host is being upgraded. Try again later. |
| 400 | LastOrderProcessing | The previous order is still processing, please try again later. | The order is being processed. Try again later. |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | ChargeTypeViolation | Pay-As-You-Go dedicated host do not support this operation. | |
| 403 | IncorrectHostStatus | The current status of the resource does not support this operation. | The resource is in a state that does not support the current operation. |
| 403 | LastTokenProcessing | The last token request is processing. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.