You can call this operation to split, merge, or modify reserved instances.
Description
When you call this operation, take note of the following items:
- For information about limits on reserved instances, see the "Limits" section in Reserved instance overview.
- If you call this operation to split a reserved instance, make sure that you fully understand the limits on splitting a reserved instance. For more information, see Split a reserved instance.
- If you call this operation to merge reserved instances, make sure that you fully understand the limits on merging reserved instances. For more information, see Merge reserved instances.
- If you call this operation to modify a reserved instance, make sure that you fully understand the limits and methods of modifying a reserved instance. For more information, see Modify a reserved instance.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyReservedInstances |
The operation that you want to perform. Set the value to ModifyReservedInstances. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the reserved instance. You can call the DescribeRegions operation to query the most recent region list. |
ReservedInstanceId.N | RepeatList | Yes | ReservedInstanceId.1="ecsri-bp1cx3****",ReservedInstanceId.2="ecsri-bp15xx2****"...... |
The ID of reserved instance N. Valid values of N: 1 to 20. |
Configuration.N.ZoneId | String | No | cn-hangzhou-i |
The zone ID of reserved instance N. Valid values of N: 1 to 100. This parameter is required when You can call the DescribeZones operation to query the most recent zone list. |
Configuration.N.ReservedInstanceName | String | No | testReservedInstanceName |
The name of reserved instance N. Valid values of N: 1 to 100. The name must be 2 to 128 characters in length. It must start with a letter but cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-). |
Configuration.N.InstanceType | String | No | ecs.c5.4xlarge |
The number of instance types that reserved instance N can match. Valid values of N: 1 to 100. Note The applicable instance types are continuously updated. For more information, see
the "Attributes" section in Reserved instance overview.
|
Configuration.N.Scope | String | No | Zone |
The scope of reserved instance N. Valid values:
Valid values of N: 1 to 100. Default value: Region. |
Configuration.N.InstanceAmount | Integer | No | 1 |
The number of pay-as-you-go instances that are of the instance type matched with reserved instance N. The value must be greater than or equal to 1. Valid values of N: 1 to 100. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7 |
The ID of the request. |
ReservedInstanceIdSets | List | {"ReservedInstanceId":"ecsri-bp1cx3****","ecsri-bp15xx2****"]} |
The list of reserved instance IDs. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=ModifyReservedInstances
&RegionId=cn-hangzhou
&ReservedInstanceId.1=ecsri-bp1cx3****
&ReservedInstanceId.2=ecsri-bp15xx2****
&Configuration.1.InstanceType=ecs.c5.4xlarge
&Configuration.1.Scope=Zone
&Configuration.2.InstanceType=ecs.g5.4xlarge
&Configuration.2.Scope=Region
&<Common request parameters>
Sample success responses
XML
format
<ModifyReservedInstancesResponse>
<ReservedInstanceIdSets>
<ReservedInstanceId>ecsri-bp1cx3****</ReservedInstanceId>
<ReservedInstanceId>ecsri-bp15xx2****</ReservedInstanceId>
</ReservedInstanceIdSets>
<RequestId>ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7</RequestId>
</ModifyReservedInstancesResponse>
JSON
format
{
"ReservedInstanceIdSets": {
"ReservedInstanceId": [
"ecsri-bp1cx3****",
"ecsri-bp15xx2****"
]
},
"RequestId": "ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidInstanceType.ValueUnauthorized | The specified InstanceType is not authorized. | The error message returned because you are not authorized to use the specified instance type. |
403 | OperationDenied.NoStock | The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. | The error message returned because the requested resources are insufficient. |
500 | InternalError | The request processing has failed due to some unknown error. | The error message returned because an internal error has occurred. Try again later. If the problem persists, submit a ticket. |
403 | OperationDenied | Sales of this resource are temporarily suspended in the specified region; please try again later. | The error message returned because the sales of the requested resource are suspended in the specified region. Try again later. |
400 | InvalidParameter.Conflict | The specified region and cluster do not match. | The error message returned because the specified region does not match the specified cluster. |
403 | NodeControllerUnavailable | The Node Controller is temporarily unavailable. | The error message returned because the node controller is unavailable. |
403 | OperationDenied | The resource is out of usage. | The error message returned because the instance is not in the Running state. Start the instance or check whether the specified operation is valid. |
403 | InvalidParameter.ResourceOwnerAccount | ResourceOwnerAccount is Invalid. | The error message returned because the specified ResourceOwnerAccount parameter is invalid. |
403 | Zone.NotOpen | The specified zone is not granted to you to buy resources yet. | The error message returned because you are not authorized to purchase resources in the specified zone. |
403 | Zone.NotOnSale | The specified zone is not available for purchase. | The error message returned because the requested instance resources are unavailable in the specified zone. Change the instance type or select a different zone. |
400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | The error message returned because the specified Tag.N.Key parameter is invalid. |
400 | RegionUnauthorized | %s | The error message returned because you are not authorized to perform the operation in the specified region. |
500 | InternalError | %s | The error message returned because an internal error has occurred. |
400 | Zone.NotOnSale | %s | The error message returned because the sales of the specified resources in the specified zone are suspended. |
400 | InvalidPeriodUnit.ValueNotSupported | The specified parameter PeriodUnit is not valid. | The error message returned because the specified PeriodUnit parameter is invalid. |
400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | The error message returned because the specified Tag.N.Value parameter is invalid. |
403 | InvalidParameter.NotMatch | %s | The error message returned because the specified parameter is invalid. Check whether the parameter conflicts with another parameter. |
403 | Account.Arrearage | Your account has been in arrears. | The error message returned because your account balance is insufficient. Add funds to your account before you proceed. |
400 | InvalidChargeType.ValueNotSupported | ChargeType is not valid | The error message returned because the billing method is invalid. |
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | The error message returned because the operation is not supported while the resource is in the current state. |
For a list of error codes, visit the API Error Center.