Crea una instancia nativa de la nube de Tair (Enhanced Edition).
Descripción de la operación
Para obtener información sobre la selección de instancias, consulte la Guía de selección de ApsaraDB for Tair (compatible con Redis® OSS).
Asegúrese de comprender por completo los métodos de facturación y los precios de ApsaraDB for Tair (compatible con Redis® OSS) antes de invocar esta operación.
Para obtener información sobre cómo ejecutar esta operación en la consola, consulte Crear una instancia de Tair.
Para crear otros tipos de instancias, como instancias clásicas de código abierto o optimizadas para memoria de Tair, invoque la operación CreateInstance.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
kvstore:CreateTairInstance |
create |
*DBInstance.
|
|
Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| RegionId |
string |
Sí |
El ID de la región. Puede llamar a DescribeRegions para consultar las regiones disponibles. Utilice este parámetro para especificar la región en la que se creará la instancia. |
cn-hangzhou |
| InstanceName |
string |
No |
El nombre de la instancia. El nombre debe cumplir los siguientes requisitos:
|
apitest |
| Password |
string |
No |
La contraseña de la instancia. La contraseña debe cumplir los siguientes requisitos:
|
Pass!123456 |
| InstanceClass |
string |
Sí |
El tipo de instancia. Para obtener más información, consulte: |
tair.scm.standard.4m.32d |
| ZoneId |
string |
No |
El ID de la zona principal. Puede llamar a DescribeRegions para consultar las zonas disponibles. Utilice este parámetro para especificar la zona en la que se creará la instancia. Nota
También puede especificar el parámetro SecondaryZoneId para configurar una zona secundaria. Los nodos principal y secundario se despliegan en las zonas principal y secundaria especificadas para implementar una arquitectura principal/secundaria de doble centro dentro de la misma ciudad. Por ejemplo, establezca ZoneId en cn-hangzhou-h y SecondaryZoneId en cn-hangzhou-g. |
cn-hangzhou-h |
| SecondaryZoneId |
string |
No |
El ID de la zona secundaria. Puede llamar a DescribeRegions para consultar las zonas disponibles. Nota
El valor de este parámetro debe ser diferente del valor de ZoneId. No puede establecer este parámetro en el ID de una multizona. |
cn-hangzhou-g |
| ChargeType |
string |
No |
El método de facturación. Valores válidos:
Valores válidos:
|
PrePaid |
| VpcId |
string |
Sí |
El ID de la VPC. Puede llamar a la operación DescribeVpcs de VPC para consultar los ID de VPC. |
vpc-bp1nme44gek34slfc**** |
| VSwitchId |
string |
Sí |
El ID del vSwitch dentro de la VPC especificada. Puede llamar a la operación DescribeVpcs de VPC para consultar los ID de vSwitch. |
vsw-bp1e7clcw529l773d**** |
| Period |
integer |
No |
El periodo de suscripción. Unidad: meses. Valores válidos: 1 a 9, 12, 24, 36 y 60. Nota
Este parámetro es obligatorio cuando ChargeType se establece en PrePaid. |
1 |
| BusinessInfo |
string |
No |
El ID de la actividad y la información comercial. |
000000000 |
| CouponNo |
string |
No |
El código de cupón. |
youhuiquan_promotion_option_id_for_blank |
| SrcDBInstanceId |
string |
No |
Para crear una instancia a partir de un conjunto de copias de seguridad de una instancia existente, especifique el ID de la instancia de origen en este parámetro. Nota
A continuación, utilice el parámetro BackupId, ClusterBackupId (recomendado para instancias de clúster nativas de la nube) o RestoreTime para especificar el conjunto de copias de seguridad o el punto en el tiempo. Este parámetro debe utilizarse junto con uno de los tres parámetros anteriores. |
r-bp1zxszhcgatnx**** |
| BackupId |
string |
No |
El ID del conjunto de copias de seguridad de la instancia de origen. El sistema utiliza los datos almacenados en el conjunto de copias de seguridad para crear la instancia. Puede invocar DescribeBackups para consultar el BackupId. Si la instancia de origen es una instancia de clúster, especifique los ID de los conjuntos de copias de seguridad de todos los fragmentos de la instancia de origen, separados por comas (,). Ejemplo: "10**,11**,15**". Nota
Si su instancia es una instancia de clúster con arquitectura nativa de la nube, le recomendamos invocar DescribeClusterBackupList para obtener el ID del conjunto de copias de seguridad del clúster, como "cb-xx", y luego especificar el parámetro de solicitud ClusterBackupId para clonar la instancia de clúster. De este modo, no necesita especificar los ID de los conjuntos de copias de seguridad de los fragmentos individuales. |
2158****20 |
| ClusterBackupId |
string |
No |
El ID del conjunto de copias de seguridad del clúster. Algunas arquitecturas de clúster nuevas admiten ID de conjuntos de copias de seguridad de clúster. Puede llamar a la operación DescribeClusterBackupList para obtener el ID.
|
cb-hyxdof5x9kqb**** |
| RecoverConfigMode |
string |
No |
Especifica si se debe restaurar la cuenta, el parámetro del kernel (config) o la información de la lista blanca desde el conjunto de copias de seguridad original al crear una instancia a partir de un conjunto de copias de seguridad especificado. Por ejemplo, para restaurar la información de la cuenta, establezca este parámetro en account. El valor predeterminado está vacío, lo que indica que la cuenta, el parámetro del kernel y la información de la lista blanca no se restauran desde el conjunto de copias de seguridad original. Nota
Este parámetro solo es aplicable a instancias nativas de la nube. El conjunto de copias de seguridad original debe contener la cuenta, el parámetro del kernel o la información de la lista blanca. Puede llamar a la operación DescribeBackups para comprobar si el parámetro RecoverConfigMode del conjunto de copias de seguridad especificado contiene la información anterior. |
whitelist,config,account |
| PrivateIpAddress |
string |
No |
La dirección IP privada de la instancia. Nota
La dirección IP debe estar dentro del bloque CIDR del vSwitch al que pertenece la instancia. Puede llamar a la operación DescribeVSwitches de VPC para consultar la información del bloque CIDR. |
172.16.88.*** |
| AutoUseCoupon |
string |
No |
Especifica si se debe utilizar un cupón. Valores válidos:
|
true |
| AutoRenew |
string |
No |
Especifica si se debe habilitar la renovación automática. Valores válidos:
|
true |
| AutoRenewPeriod |
string |
No |
El periodo de renovación automática. Unidad: meses. Valores válidos: 1, 2, 3, 6 y 12. Nota
Este parámetro es obligatorio cuando AutoRenew se establece en true. |
3 |
| ResourceGroupId |
string |
No |
El ID del grupo de recursos al que pertenece la instancia. Nota
|
rg-acfmyiu4ekp**** |
| AutoPay |
boolean |
No |
Especifica si se debe habilitar el pago automático. El valor se fija en true. |
true |
| ClientToken |
string |
No |
El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el valor. Asegúrese de que el token sea único entre las diferentes solicitudes. El token distingue entre mayúsculas y minúsculas y puede contener hasta 64 caracteres ASCII. |
ETnLKlblzczshOTUbOCz**** |
| StorageType |
string |
No |
El tipo de almacenamiento. Valores válidos: essd_pl1, essd_pl2 y essd_pl3. Nota
Este parámetro solo es obligatorio cuando InstanceType se establece en tair_essd y está creando una instancia basada en ESSD. |
essd_pl1 |
| Storage |
integer |
No |
La capacidad de almacenamiento de una instancia basada en disco. Los valores válidos varían según el tipo de instancia. Para obtener más información, consulte Tipos de instancias basadas en disco. Nota
Este parámetro solo es obligatorio cuando InstanceType se establece en tair_essd y está creando una instancia basada en ESSD. Para las instancias SSD basadas en disco de Tair, la capacidad de almacenamiento es un valor fijo determinado por el tipo de instancia. No es necesario que especifique este parámetro. |
60 |
| ShardType |
string |
No |
El tipo de instancia. Valores válidos:
|
MASTER_SLAVE |
| ShardCount |
integer |
No |
El número de nodos de datos en la instancia. Valores válidos:
Nota
Solo puede establecer este parámetro en un valor de 2 a 32 cuando InstanceType se establece en tair_rdb o tair_scm. Solo las instancias optimizadas para memoria y optimizadas para memoria persistente admiten la arquitectura de clúster. |
2 |
| ReplicaCount |
integer |
No |
El número de nodos de réplica en la zona principal. Este parámetro solo es aplicable a instancias de clúster nativas de la nube con múltiples réplicas. Puede utilizar este parámetro para personalizar el número de nodos de réplica. Valores válidos: 1 a 4. Nota
Si crea una instancia multizona, puede utilizar este parámetro junto con el parámetro SlaveReplicaCount para personalizar el número de nodos de réplica en las zonas principal y secundaria. La suma de este parámetro y el parámetro SlaveReplicaCount no puede superar 4. |
2 |
| SlaveReplicaCount |
integer |
No |
El número de nodos de réplica en la zona secundaria. |
2 |
| ReadOnlyCount |
integer |
No |
El número de nodos de solo lectura en la zona principal. Este parámetro solo es aplicable a instancias nativas de la nube con división de lectura/escritura.
Nota
Si crea una instancia multizona, puede utilizar este parámetro junto con el parámetro SlaveReadOnlyCount para personalizar el número de nodos de solo lectura en las zonas principal y secundaria.
|
5 |
| SlaveReadOnlyCount |
integer |
No |
El número de nodos de solo lectura en la zona secundaria. |
1 |
| EngineVersion |
string |
No |
La versión del motor de base de datos. Valor predeterminado: 1.0. Los valores válidos varían según el tipo de producto de Tair:
|
1.0 |
| InstanceType |
string |
Sí |
El medio de almacenamiento. Valores válidos:
|
tair_scm |
| GlobalInstanceId |
string |
No |
Especifica si se debe agregar la nueva instancia como instancia secundaria de una instancia distribuida.
Nota
Para crear una instancia distribuida, la nueva instancia debe ser una instancia optimizada para memoria de Tair. |
gr-bp14rkqrhac**** |
| Tag |
array<object> |
No |
Las etiquetas de la instancia. |
|
|
object |
No |
La información de la etiqueta. |
||
| Key |
string |
No |
La clave de la etiqueta. La clave y el valor juntos forman un par clave-valor para la etiqueta. Nota
Puede especificar hasta 5 pares clave-valor de etiquetas a la vez. |
key1_test |
| Value |
string |
No |
El valor de la etiqueta. Nota
N indica el número de secuencia del valor de la etiqueta. Por ejemplo, Tag.1.Value indica el valor de la primera etiqueta, y Tag.2.Value indica el valor de la segunda etiqueta. |
value1_test |
| DryRun |
boolean |
No |
Especifica si se debe ejecutar una prueba para esta solicitud. Valores válidos:
|
false |
| Port |
integer |
No |
El puerto de servicio de la instancia. Valores válidos: 1 a 65535. Valor predeterminado: 6379. |
6379 |
| GlobalSecurityGroupIds |
string |
No |
Las plantillas globales de lista blanca de IP para la instancia. Separe varias plantillas con comas (,). No se permiten valores duplicados. |
g-zsldxfiwjmti0kcm**** |
| ParamGroupId |
string |
No |
El ID de la plantilla de parámetros. La instancia se crea en función de los parámetros de la plantilla de parámetros especificada. No se permiten valores duplicados. |
g-50npzjcqb1ua6q6j**** |
| RestoreTime |
string |
No |
Si la retrospección de datos está habilitada para la instancia de origen, puede especificar un punto en el tiempo dentro del periodo de retención de copias de seguridad de la instancia de origen. El sistema utiliza los datos de la copia de seguridad de la instancia de origen en el punto en el tiempo especificado para crear la instancia. Especifique la hora en formato yyyy-MM-ddTHH:mm:ssZ (UTC). |
2021-07-06T07:25:57Z |
| ConnectionStringPrefix |
string |
No |
El prefijo del endpoint. El prefijo debe constar de letras minúsculas y dígitos, comenzar con una letra minúscula y tener una longitud de 8 a 40 caracteres. Nota
El endpoint tiene el siguiente formato: |
r-bp1zxszhcgatnx**** |
| InstanceEndpointType |
string |
No |
El tipo de endpoint que se utiliza al crear una instancia nativa de la nube con división de lectura/escritura y despliegue en zona dual. Si este parámetro no se especifica explícitamente, el valor predeterminado es AzIndependentEndpoint.
Importante Este parámetro solo es aplicable a instancias nativas de la nube con división de lectura/escritura y despliegue en zona dual. Para otros tipos de instancias, solo se admiten endpoints independientes de la zona. Incluso si envía UnifiedEndpoint, la configuración no surte efecto. Importante El valor UnifiedEndpoint solo está disponible para los usuarios en la lista blanca. Si no está en la lista blanca e invoca este valor, la invocación falla. Para solicitar acceso, envíe un ticket. |
AzIndependentEndpoint |
| MaintainStartTime |
string |
No |
La hora de inicio de la ventana de mantenimiento. Especifique la hora en formato HH:mmZ (UTC). Por ejemplo, para establecer la hora de inicio a las 01:00 (UTC+8), especifique Nota
Si no se especifica este parámetro, el valor predeterminado es 18:00Z (UTC), que corresponde a las 02:00 (UTC+8). |
|
| MaintainEndTime |
string |
No |
La hora de finalización de la ventana de mantenimiento. Especifique la hora en formato HH:mmZ (UTC). Por ejemplo, para establecer la hora de finalización a las 02:00 (UTC+8), especifique Nota
El intervalo entre la hora de inicio y la hora de finalización debe ser de al menos 1 hora. Nota
Si no se especifica este parámetro, el valor predeterminado es 22:00Z (UTC), que corresponde a las 06:00 (UTC+8). |
Elementos de la respuesta
|
Elemento |
Tipo |
Descripción |
Ejemplo |
|
object |
El objeto de respuesta. |
||
| Bandwidth |
integer |
El ancho de banda máximo de la instancia. Unidad: MB/s. |
96 |
| ChargeType |
string |
El método de facturación de la instancia. Valores válidos:
|
PrePaid |
| Config |
string |
Las configuraciones detalladas de la instancia. El valor es una cadena JSON. Para obtener más información sobre los parámetros, consulte Configuración de parámetros. |
{\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"list-max-ziplist-entries\":512,\"list-max-ziplist-value\":64,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64} |
| ConnectionDomain |
string |
El endpoint de red interna de la instancia. |
r-bp13ac3d047b****.tairpena.rds.aliyuncs.com |
| Connections |
integer |
El número máximo de conexiones para la instancia. |
10000 |
| InstanceId |
string |
El ID de la instancia. |
r-bp13ac3d047b**** |
| InstanceName |
string |
El nombre de la instancia. Nota
Este parámetro se devuelve solo cuando se especifica el parámetro de solicitud InstanceName. |
redistest |
| InstanceStatus |
string |
El estado actual de la instancia. El valor devuelto se establece en Creating. |
Creating |
| OrderId |
integer |
El ID del pedido. |
2084452111111 |
| Port |
integer |
El número de puerto de la instancia. |
6379 |
| QPS |
integer |
El número máximo de operaciones de lectura y escritura por segundo. Unidad: operaciones por segundo. Este es el valor teórico para el tipo de instancia actual. |
100000 |
| RegionId |
string |
El ID de la región. |
cn-hangzhou |
| RequestId |
string |
El ID de la solicitud. |
12123216-4B00-4378-BE4B-08005BFC**** |
| TaskId |
string |
El ID de la tarea. |
10**** |
| ZoneId |
string |
El ID de la zona. |
cn-hangzhou-h |
Ejemplos
Respuesta exitosa
JSON Formato
{
"Bandwidth": 96,
"ChargeType": "PrePaid",
"Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"list-max-ziplist-entries\\\":512,\\\"list-max-ziplist-value\\\":64,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
"ConnectionDomain": "r-bp13ac3d047b****.tairpena.rds.aliyuncs.com",
"Connections": 10000,
"InstanceId": "r-bp13ac3d047b****",
"InstanceName": "redistest",
"InstanceStatus": "Creating",
"OrderId": 2084452111111,
"Port": 6379,
"QPS": 100000,
"RegionId": "cn-hangzhou",
"RequestId": "12123216-4B00-4378-BE4B-08005BFC****",
"TaskId": "10****",
"ZoneId": "cn-hangzhou-h"
}
Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|---|---|---|---|
| 400 | MissingParameter | Period is mandatory for this action. | |
| 400 | InvalidToken.Malformed | The Specified parameter Token is not valid. | |
| 400 | InvalidInstanceName.Malformed | The Specified parameter InstanceName is not valid. | |
| 400 | InvalidPassword.Malformed | The Specified parameter Password is not valid. | |
| 400 | InsufficientBalance | Your account does not have enough balance. | |
| 400 | QuotaExceed.AfterpayInstance | Living afterpay instances quota exceeded. | |
| 400 | InvalidCapacity.NotFound | The Capacity provided does not exist in our records. | |
| 400 | ResourceNotAvailable | Resource you requested is not available for finance user. | |
| 400 | PaymentMethodNotFound | No payment method has been registered on the account. | |
| 400 | IdempotentParameterMismatch | Request uses a client token in a previous request but is not identical to that request. | La verificación de idempotencia falló. |
| 400 | QuotaNotEnough | Quota not enough in this zone. | |
| 400 | QuotaExceed | Living afterpay instances quota exceed. | |
| 400 | VpcServiceError | Invoke vpc service failed. | |
| 400 | IzNotSupportVpcError | Specify iz not support vpc. | |
| 400 | InvalidvSwitchId | The vpc does not cover the vswitch. | |
| 400 | InvalidIzNo.NotSupported | The Specified vpc zone not supported. | |
| 400 | InvalidAccountPassword.Format | Specified account password is not valid. | |
| 400 | InstanceClass.NotMatch | Current instance class and instance type is not match. | |
| 400 | InvalidVPCId.NotFound | Specified virtual vpc is not found. | No se encontró la VPC. Verifique si el ID de la VPC es correcto. |
| 400 | AccountMoneyValidateError | Account money validate error. | |
| 400 | RequestTokenConflict | Specified request token conflict. | |
| 400 | InvalidIPNotInSubnet | Error ip not in subnet. | |
| 400 | InvalidEngineVersion.Malformed | Specified engine version is not valid. | La versión del motor DPI no es válida. |
| 400 | Zone.Closed | The specified zone is closed. | |
| 400 | VSwithNotBelongToNotVpcFault | The vSwitch does not belong to current vpc. | |
| 400 | PayIllegalAgreement | Pay mayi with holding agreement illegal. | |
| 400 | IllegalParamError | validateSaleConditionWithSubArticle failed. | |
| 400 | CASH_BOOK_INSUFFICIENT | No payment method is specified for your account. We recommend that you add a payment method or maitain a minimum prepayment balance of INR 1000. | |
| 400 | InvalidRegion.Format | Specified Region is not valid. | La región especificada no es válida. |
| 403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | |
| 403 | AuthorizationFailure | The request processing has failed due to authorization failure. | |
| 403 | TokenServiceError | The specified token is duplicated, please change it. | |
| 403 | UserCannotBuyNotInnerCommodity | The user can not buy this commodity without alibaba group tag. | |
| 404 | InvalidCapacity.NotFound | The Capacity provided does not exist in our records. | La especificación de almacenamiento especificada no existe. |
| 404 | InvalidvSwitchId | The Specified vSwitchId zone not supported. | |
| 404 | InvalidVpcIdOrVswitchId.NotSupported | The Specified vpcId or vSwitchId not supported. |
Consulte Códigos de error para ver la lista completa.
Notas de la versión
Consulte Notas de la versión para ver la lista completa.