Tair:CreateTairInstance

The ID of the region where you want to create the instance. You can call the DescribeRegions operation to query the most recent region list.

The name of the instance. The name must meet the following requirements:

• The name is 2 to 80 characters in length.
• The name starts with a letter and does not contain spaces or special characters. These special characters include @ / : = " < > { [ ] }

The password that is used to connect to the instance. The password must meet the following requirements:

• The password is 8 to 32 characters in length.
• The password contains at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. These special characters include ! @ # $ % ^ & * ( ) _ + - =

The instance type. For more information, see the following topics:

• DRAM-based instances
• Persistent memory-optimized instances
• ESSD-based instances

The primary zone ID of the instance. You can call the DescribeRegions operation to query the most recent zone list.

The billing method of the instance. Default value: PrePaid. Valid values:

• PrePaid: subscription
• PostPaid: pay-as-you-go

The ID of the virtual private cloud (VPC). You can call the DescribeVpcs operation to query the ID of the VPC.

The ID of the vSwitch that belongs to the VPC. You can call the DescribeVpcs operation to query the ID of the vSwitch.

The subscription duration. Unit: months. Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24,36, and 60.

The ID of the promotion event or the business information.

The coupon code.

The ID of the source instance.

The ID of the backup set of the source instance. You can call the DescribeBackups operation to query the ID of the backup set.

The private IP address of the instance.

Specifies whether to use a coupon. Default value: false. Valid values:

• true: uses a coupon.
• false: does not use a coupon.

Specifies whether to enable auto-renewal for the instance. Default value: false. Valid values:

• true: enables auto-renewal.
• false: disables auto-renewal.

The subscription duration that is supported by auto-renewal. Unit: months. Valid values: 1, 2, 3, 6, and 12.

The ID of the resource group to which you want to assign the instance.

• You can query resource group IDs by using the ApsaraDB for Redis console or by calling the ListResourceGroups operation. For more information, see View basic information of a resource group.

• Before you modify the resource group to which an instance belongs, you can call the ListResources operation to view the current resource group of the instance.

Specifies whether to enable automatic payment. Set the value to true.

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 the token is unique among different requests. The token is case-sensitive. The token can contain only ASCII characters and cannot exceed 64 characters in length.

The storage type of the instance. Set the value to essd_pl1.

The storage space of cloud disks. Valid values vary based on the instance specifications. For more information, see ESSD-based instances.

The category of the instance. Default value: MASTER_SLAVE. Valid values:

• MASTER_SLAVE: runs in a master-replica architecture that provides high availability.
• STAND_ALONE: runs in a standalone architecture. If the only node fails, the system creates a new instance and switches the workloads to the new instance. This may cause data loss. You can set this parameter to this value only if the instance uses the single-zone deployment type. If you set this parameter to this value, you cannot create cluster or read/write splitting instances.

The number of data nodes in the instance. Default value: 1. Valid values:

• 1: You can create an instance in the standard architecture that contains only a single data node. For more information about the standard architecture, see Cluster master-replica instances.
• 2 to 32: You can create an instance in the cluster architecture that contains the specified number of data nodes. For more information about the cluster architecture, see Cluster master-replica instances.

The number of read-only nodes in the instance. This parameter is available only if you create a read/write splitting instance that uses cloud disks. Valid values: 1 to 5.

The database engine version of the instance. Default value: 1.0. The default version is developed by Alibaba Cloud and compatible with Redis 5.0.

The storage medium of the instance. Valid values:

• tair_rdb: ApsaraDB for Redis Enhanced Edition (Tair) DRAM-based instance
• tair_scm: ApsaraDB for Redis Enhanced Edition (Tair) persistent memory-optimized instance
• tair_essd: ApsaraDB for Redis Enhanced Edition (Tair) ESSD-based instance

The ID of the secondary zone. You can call the DescribeRegions operation to query the ID of the secondary zone.

• You cannot specify multiple zone IDs or set this parameter to a value that is the same as that of the ZoneId parameter.

• If you set both the SecondaryZoneId and ZoneId parameters, the master node is deployed in the primary zone and the replica node is deployed in the secondary zone within the same region. In this case, the instance adopts the zone-disaster recovery architecture.

The ID of the distributed instance.

The tags of the instance.

Specifies whether to perform a dry run. Default value: false. Valid values:

• true: performs a dry run. The system prechecks the request parameters, request format, service limits, and available resources. If the request fails the dry run, an error message is returned. If the request passes the dry run, the DryRunOperation error code is returned.
• **false: performs a dry run and sends the request. If the request passes the dry run, the system creates the instance.

The service port number of the instance. Valid values:1024 to 65535. Default value: 6379.