Tair (Redis® OSS-Compatible):ModifyInstanceSpec

The region ID. You can call the DescribeRegions operation to query the most recent region list.

The instance ID. You can call the DescribeInstances operation to query the instance ID.

The new instance type. You can call the DescribeAvailableResource operation to query the instance types available for configuration change within the zone to which the instance belongs.

The ID of the promotional event or the business information.

The coupon code. Default value: youhuiquan_promotion_option_id_for_blank.

Specifies whether to forcibly change the configurations. Valid values:

• false: The system does not forcefully change the configurations.
• true (default): The system forcefully changes the configurations.

The time when you want the configurations to be changed. Valid values:

• Immediately (default): immediately changes the configurations.
• MaintainTime: changes the configurations within the maintenance window. You can call the ModifyInstanceMaintainTime operation to change the maintenance window.

Specifies whether to enable automatic payment. Valid values:

• true (default): enables automatic payment.
• false: disables automatic payment. If you set this parameter to false, the instance must be manually renewed before it expires. For more information, see Renew an instance.

The change type. This parameter is required when you change the configurations of a subscription instance. Valid values:

• UPGRADE (default): upgrades the configurations of the subscription instance.
• DOWNGRADE: downgrades the configurations of the subscription instance.

• To downgrade a subscription instance, you must set this parameter to DOWNGRADE.

• If the price of an instance increases after its configurations are changed, the instance is upgraded. If the price decreases, the instance is downgraded. For example, the price of an 8 GB read/write splitting instance with five read replicas is higher than that of a 16 GB cluster instance. If you want to change a 16 GB cluster instance to an 8 GB read/write splitting instance with five read replicas, you must upgrade the instance.

The major version of the classic instance that you want to upgrade. Valid values: 2.8, 4.0, and 5.0.

The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

The source of the operation. This parameter is used only for internal maintenance. You do not need to specify this parameter.

The number of shards. This parameter is applicable only to cloud-native cluster instances.

• If you want to change a cloud-native cluster instance to a standard instance, you must explicitly set the ShardCount parameter to 1 and specify the specifications of the master-replica instance.

• To change a cloud-native standard instance to a cluster instance, you must explicitly set the ShardCount parameter to a value greater than 1 and specify the specifications of the cluster instance.

The number of replica nodes in the primary zone. This parameter is applicable only to cloud-native multi-replica cluster instances. Valid values: 1 to 4.

• The sum of the values of this parameter and the SlaveReplicaCount parameter cannot be greater than 4.

• You can specify either ReplicaCount or ReadOnlyCount.

• A master-replica instance cannot contain multiple replica nodes.

The number of replica nodes in the secondary zone when you create a cloud-native multi-replica cluster instance that is deployed across multiple zones. The sum of the values of this parameter and the ReplicaCount parameter cannot be greater than 4.

The number of read replicas in the primary zone. Valid values: 0 to 5. This parameter applies only to the following scenarios:

• If the instance is a cloud-native standard instance, you can set this parameter to a value greater than 0 to enable the read/write splitting architecture.
• If the instance is a cloud-native read/write splitting instance, you can use this parameter to customize the number of read replicas. You can also set this parameter to 0 to disable the read/write splitting architecture and switch the instance to the standard architecture.

The number of read replicas in the secondary zone when you create a read/write splitting instance that is deployed across multiple zones. Valid values: 1 to 9. The sum of the values of this parameter and the ReadOnlyCount parameter cannot be greater than 9.

Specifies whether to enable forced transmission during a configuration change. Valid values:

• false (default): Before the configuration change, the system checks the minor version of the instance. If the minor version of the instance is outdated, an error is reported. You must update the minor version of the instance and try again.
• true: The system skips the version check and directly performs the configuration change.

The type of the node. Valid values:

• MASTER_SLAVE: high availability (master-replica)
• STAND_ALONE: standalone
• double: master-replica
• single: standalone

The storage type. Valid values: essd_pl1, essd_pl2, and essd_pl3.

The storage capacity of the ESSD/SSD-based instance. The valid values vary based on the instance type. For more information, see ESSD/SSD-based instances.