Changes the specifications of a data node in an ApsaraDB for Redis cluster instance.

The instance must be a persistent memory-optimized instance in the cluster architecture.

Note
  • Before you call this operation, you can call the DescribeClusterMemberInfo operation to query the current specifications of each data node.
  • During a specification change, one to two disconnections that last no more than 30 seconds may occur. Make sure that the client supports automatic reconnection.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyNodeSpec

The operation that you want to perform. Set the value to ModifyNodeSpec.

InstanceClass String Yes redis.shard.large.ce

The specifications to which you want to change. For more information, see Persistent memory-optimized instances.

InstanceId String Yes r-bp1zxszhcgatnx****

The ID of the ApsaraDB for Redis instance. You can call the DescribeInstances operation to query instance IDs.

NodeId String Yes r-bp1zxszhcgatnx****-db-0

The ID of the data node for which you want to change the specifications. You can call the DescribeLogicInstanceTopology operation to query the ID of the data node.

Note Set the parameter to the obtained ID with the #null suffix removed.
RegionId String No cn-hangzhou

The region ID of the instance. You can call the DescribeRegions operation to query region IDs.

BusinessInfo String No 000000000000

The extended information such as the promotional event ID and business information.

CouponNo String No youhuiquan_promotion_option_id_for_blank

The coupon ID.

AutoPay Boolean No true

Specifies whether to automatically pay fees after you call this operation. Valid values:

  • true: automatically pay fees. This is the default value.
  • false: disables automatic payment. If automatic payment is disabled, you must perform the following steps to complete the payment in the ApsaraDB for Redis console: In the top navigation bar, choose Expenses > Renewal Management. In the left-side navigation pane, click Orders. On the Orders page, find the order and complete the payment.
OrderType String No UPGRADE

The order type. Valid values:

  • UPGRADE: upgrades the specifications.
  • DOWNGRADE: downgrades the specifications.
SwitchTimeMode String No Immediately

The execution mode of the specification change based on the time. Valid values:

  • Immediately: immediately changes the specifications.
  • MaintainTime: changes the specifications during the maintenance window of the instance.
Note You can call the ModifyInstanceMaintainTime operation to modify the maintenance window of an ApsaraDB for Redis instance.

Response parameters

Parameter Type Example Description
OrderId Long 207866611111111

The ID of the order.

RequestId String F1242783-7011-4949-8AC0-A96DBC5F****

The ID of the request.

Examples

Sample requests

http(s)://https://r-kvstore.aliyuncs.com/?Action=ModifyNodeSpec
&InstanceId=r-bp1zxszhcgatnx****
&NodeId=r-bp1zxszhcgatnx****-db-0
&InstanceClass=redis.shard.large.ce
&<Common request parameters>

Sample success responses

XML format

<ModifyNodeSpecResponse>
      <RequestId>F1242783-7011-4949-8AC0-A96DBC5F****</RequestId>
      <OrderId>207866611111111</OrderId>
</ModifyNodeSpecResponse>

JSON format

{
    "RequestId": "F1242783-7011-4949-8AC0-A96DBC5F****",
    "OrderId": 207866611111111
}

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 a renewal order with specification changes already exists.

For a list of error codes, visit the API Error Center.