CreateTairSkvDdbTable - Tair (Redis® OSS-Compatible) - Centro de documentación de Alibaba Cloud

Crea una instancia de tabla KV Serverless de Tair.

Descripción de la operación

Antes de llamar a esta operación, asegúrese de comprender los métodos de facturación y los precios de ApsaraDB for Redis.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

kvstore:CreateTairSkvDdbTable

create

*All Resource

*

Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
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 valor sea único entre diferentes solicitudes. El token distingue entre mayúsculas y minúsculas y no puede superar los 64 caracteres ASCII de longitud.	ETnLKlblzczshOTUbOCz**
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
WorkspaceId	string	Sí	El ID de la instancia del espacio de trabajo. Puede llamar a DescribeInstances para obtener el ID.	tt-bp1zxszhcgatnx**
TableName	string	Sí	El nombre de la tabla. El nombre debe tener entre 2 y 128 caracteres de longitud y debe comenzar con una letra mayúscula, una letra minúscula o un carácter chino. El nombre no puede contener los siguientes caracteres: @/:="<>{}[] ni espacios.	apitest
InstanceType	string	Sí	El tipo de instancia. Establezca el valor en tair_skv_ddb_table.	tair_skv_ddb_table
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 Este parámetro debe utilizarse junto con BackupId.	r-bp1zxszhcgatnx**
BackupId	string	No	El ID del conjunto de copias de seguridad del clúster. Algunas arquitecturas de clúster nuevas admiten este parámetro. Puede llamar a DescribeClusterBackupList para obtener el ID.	cb-hyxdof5x9kqb**
RestoreTime	string	No
Schema	string	No	La configuración del esquema de la tabla en formato JSON.	{"AttributeDefinitions":[{"AttributeType":"S","AttributeName":"pk"},{"AttributeType":"S","AttributeName":"sk"}],"KeySchema":[{"KeyType":"HASH","AttributeName":"pk"},{"KeyType":"RANGE","AttributeName":"sk"}]}
TtlSpec	string	No	El modificador de configuración de parámetros en formato JSON.	{"attributeName":"Expiretime","enabled":true}

https://r-kvstore.aliyuncs.com/?Action=CreateInstance &RegionId=ap-southeast-1 &WorkspaceId=tt-2ze4mktt0xxxxxxxx &InstanceType=tair_skv_ddb_table &TableName=table1 &Schema={"AttributeDefinitions":[{"AttributeType":"S","AttributeName":"pk"},{"AttributeType":"S","AttributeName":"sk"}],"KeySchema":[{"KeyType":"HASH","AttributeName":"pk"},{"KeyType":"RANGE","AttributeName":"sk"}]} &<Parámetros comunes de solicitud>

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El objeto de respuesta.
QPS	integer	Las consultas por segundo (QPS). Este valor es el máximo teórico para las especificaciones actuales de la instancia.	100000
ConnectionDomain	string	El endpoint interno de la instancia de Redis.	r-bp1zxszhcgatnx**.redis.rds.aliyuncs.com
ChargeType	string	El método de facturación. Valores válidos: PrePaid: suscripción. PostPaid: pago por uso.	PostPaid
InstanceId	string	El ID de instancia único global.	r-bp1zxszhcgatnx*
Port	integer	El puerto del servicio de Redis.	6379
Config	string	La configuración detallada de la instancia en formato 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,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64}
RegionId	string	El ID de la región.	cn-hangzhou
RequestId	string	El ID de la solicitud.	2D9F3768-EDA9-4811-943E-42C8006E****
Bandwidth	integer	El límite de ancho de banda de la instancia. Unidad: MB/s.	96
Connections	integer	El número máximo de conexiones que admite la instancia.	10000
TableName	string	El nombre de la instancia.	apitest
ZoneId	string	El ID de la zona de la instancia.	cn-hangzhou-b
InstanceStatus	string	El estado actual de la instancia. El valor está fijado como Creating.	Creating
TaskId	string	El ID del flujo de tareas que se ejecuta para la creación.	11111****
OrderId	integer	El ID del pedido.	20741011111111

{ "Connections": 0, "RequestId": "37B7A1E8-7590-1345-A0F2-EBD657D1AA8A", "InstanceId": "tt-2zelkttksbyc12x6c", "Port": 443, "OrderId": 274427815940904, "ConnectionDomain": "tt-2ze4mktt0jnguvf7m.tairskvddb.pre.rds.aliyuncs.com", "TableName": "table1", "QPS": 0, "ChargeType": "PostPaid", "InstanceStatus": "Creating", "Bandwidth": 0, "RegionId": "cn-beijing" }

Ejemplos

Respuesta exitosa

JSON Formato

{
  "QPS": 100000,
  "ConnectionDomain": "r-bp1zxszhcgatnx**.redis.rds.aliyuncs.com",
  "ChargeType": "PostPaid",
  "InstanceId": "r-bp1zxszhcgatnx*",
  "Port": 6379,
  "Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
  "RegionId": "cn-hangzhou",
  "RequestId": "2D9F3768-EDA9-4811-943E-42C8006E****",
  "Bandwidth": 96,
  "Connections": 10000,
  "TableName": "apitest",
  "ZoneId": "cn-hangzhou-b",
  "InstanceStatus": "Creating",
  "TaskId": "11111****",
  "OrderId": 20741011111111
}

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	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.	Idempotent check.
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.	The specified VPC is not found. Check whether the VPC ID is correct.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	The error message returned because the instance engine version is invalid.
400	Zone.Closed	The specified zone is closed.
400	InvalidRegion.Format	Specified Region is not valid.	The specified region is invalid.
403	AuthorizationFailure	The request processing has failed due to authorization failure.
403	TokenServiceError	The specified token is duplicated, please change it.
404	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.	The specified storage specification does not exist.
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.