Modifies the information about a capacity reservation, including the name, description, release mode, and the total number of Elastic Compute Service (ECS) instances for which capacity is reserved.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the capacity reservation. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
PrivatePoolOptions.Id | string | Yes | The capacity reservation ID. | crp-bp67acfmxazb4**** |
PrivatePoolOptions.Name | string | No | The name of the capacity reservation. The name must be 2 to 128 characters in length. It must start with a letter and cannot start with | eapTestName |
Description | string | No | The description of the capacity reservation. The description must be 2 to 256 characters in length. It cannot start with | This is description. |
StartTime | string | No | The mode in which the capacity reservation takes effect. Only immediate capacity reservations are supported. You do not need to specify a value for this parameter. Note
If you do not specify a value for this parameter, the capacity reservation immediately takes effect.
| Now |
EndTime | string | No | The expiration time of the capacity reservation. This parameter takes effect only when | 2021-10-30T06:32:00Z |
EndTimeType | string | No | The release mode of the capacity reservation. Valid values:
| Unlimited |
Platform | string | No | The operating system of the image used by the instance. Valid values:
Note
This parameter is unavailable.
| Linux |
InstanceAmount | integer | No | The total number of instances for which capacity is reserved. Valid values: the number of used instances to 1000. Note
When you increase the number of instances, the increase may fail due to insufficient resources.
| 100 |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "8455DD10-84F8-43C9-8365-5F448EB169B6"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidInstanceAmount.ValueNotSupported | The specified parameter InstanceAmount is not valid. | - |
400 | InvalidDescription.ValueNotSupported | The specified Description is invalid. | - |
400 | InvalidEndTime.ValueNotSupported | The specified EndTime is invalid. | - |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | - |
401 | InvalidUser.Unauthorized | The user is not authorized | You are not authorized to perform this operation. |
403 | IncorrectPrivatePoolStatus | The current status of the private pool does not support this operation. | The specified private pool state does not support the operation. |
403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | The requested resources are insufficient. |
403 | InvalidPrivatePoolOptionsName.ValueNotSupported | The specified PrivatePoolOptions.Name is invalid. | - |
403 | InvalidPlatform.ValueNotSupported | The specified Platform is invalid. | - |
403 | OperationDenied.PlatformNotSupported | The specified private pool does not support this operation. | - |
403 | OperationDenied.EndTimeTypeNotSupported | The specified private pool does not support this operation. | - |
403 | OperationDenied.StartTimeNotSupported | The specified private pool does not support this operation. | - |
403 | OperationDenied.InstanceAmountNotSupported | The specified private pool does not support this operation. | - |
403 | InvalidInstanceAmount.ValueNotSupported | The specified InstanceAmount is invalid. | - |
403 | InvalidPrivatePoolOptions.Id | The specified private pool does not support this operation. | - |
403 | InvalidPrivatePoolOptions.Id | The specified PrivatePoolOptions.Id is invalid | - |
404 | InvalidPrivatePoolId.NotFound | The specified private pool does not exist. | - |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
2023-12-06 | The Error code has changed | see changesets | ||||||||||
|