Changes the configurations of an ApsaraDB for Redis instance.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyInstanceSpec |
The operation that you want to perform. Set the value to ModifyInstanceSpec. |
RegionId | String | No | cn-hangzhou |
The region ID of the instance. You can call the DescribeRegions operation to query the region ID of the instance. |
InstanceId | String | Yes | r-bp1zxszhcgatnx**** |
The ID of the instance. You can call the DescribeInstances operation to query the ID of the instance. |
InstanceClass | String | No | redis.master.small.default |
The new instance type code. You can call the DescribeAvailableResource operation to query the instance types available for configuration change within the zone to which the instance belongs. Note For more information about the instance types, see Overview.
|
BusinessInfo | String | No | 000000001 |
The ID of the promotion event or the business information. |
CouponNo | String | No | youhuiquan_promotion_option_id_for_blank |
The coupon code. Default value: |
ForceUpgrade | Boolean | No | true |
Specifies whether to forcibly change the configurations. Default value: true. Valid values:
|
EffectiveTime | String | No | Immediately |
The time when to change the configurations. Default value: Immediately. Valid values:
|
AutoPay | Boolean | No | true |
Specifies whether to enable auto-renewal. Default value: true. Valid values:
|
OrderType | String | No | DOWNGRADE |
The change type. This parameter is required when you change the configurations of a subscription instance. Default value: UPGRADE. Valid values:
Note
|
MajorVersion | String | No | 5.0 |
The major version to which you want to upgrade. When you change the configurations of an instance, you can upgrade the major version of the instance by setting this parameter. Valid values: 4.0 and 5.0. |
ClientToken | String | No | ETnLKlblzczshOTUbOCz**** |
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 make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. |
SourceBiz | String | No | SDK |
The source of the operation. This parameter is used only for internal maintenance. You do not need to specify this parameter. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
OrderId | String | 20722623431**** |
The ID of the order. |
RequestId | String | 0DA1D7EF-C80D-432C-8758-7D225182626B |
The ID of the request. |
Examples
Sample requests
https://r-kvstore.aliyuncs.com/?Action=ModifyInstanceSpec
&InstanceId=r-bp1zxszhcgatnx****
&InstanceClass=redis.master.small.default
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyInstanceSpecResponse>
<RequestId>A4828C10-AF0A-4CD7-8FBE-737C6CC1193E</RequestId>
<OrderId>20722623431****</OrderId>
</ModifyInstanceSpecResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A4828C10-AF0A-4CD7-8FBE-737C6CC1193E",
"OrderId" : "20722623431****"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | PaymentMethodNotFound | No payment method has been registered on the account. | The error message returned because no payment method is specified for your account. |
400 | HasRenewChangeOrder | This instance has a renewChange order. | The error message returned because an order for renewal and configuration change already exists. |
For a list of error codes, visit the API Error Center.