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

Crea una instancia de espacio de trabajo de Tair Serverless KV.

Descripción de la operación

Descripción de la solicitud

Antes de llamar a esta operación, asegúrese de comprender los métodos de facturación y los detalles de precios de ApsaraDB for Redis.
Para crear una instancia de tabla de Tair Serverless KV, llame a la operación CreateTairSkvDdbTable.

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:CreateTairSkvDdbWorkspace

create

*All resources.

*

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, pero debe asegurarse de que sea único entre las distintas solicitudes. El token distingue entre mayúsculas y minúsculas y puede tener una longitud de hasta 64 caracteres ASCII.	ETnLKlblzczshOTUbOCz**
RegionId	string	Sí	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente. Utilice este parámetro para especificar la región donde desea crear la instancia.	cn-hangzhou
ZoneId	string	Sí	El ID de la zona. Puede llamar a la operación DescribeZones para consultar la lista de zonas más reciente.	cn-hangzhou-e
InstanceType	string	Sí	El tipo de instancia. Establezca el valor en tair_skv_ddb_ws. Valores válidos: tair_skv_ddb_ws :	tair_skv_ddb_ws
InstanceName	string	No	El nombre de la instancia. El nombre debe tener de 2 a 128 caracteres de longitud y comenzar con una letra o un carácter chino. No puede contener espacios ni los siguientes caracteres especiales: @, /, :, =, ", <, >, { y }.	apitest
Password	string	No	La contraseña de la instancia. La contraseña debe cumplir con los siguientes requisitos: La contraseña debe tener de 8 a 32 caracteres de longitud. La contraseña debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, caracteres especiales y dígitos. Los caracteres especiales admitidos incluyen `!@#$%^&*()_+-=`.	Pass!123456
VpcId	string	Sí	El ID de la nube privada virtual (VPC).	vpc-bp1nme44gek34slfc**
VSwitchId	string	Sí	El ID del vSwitch.	vsw-bp1e7clcw529l773d**
Port	integer	No	El puerto de servicio de la instancia. Valores válidos: 1 a 65535. Valor predeterminado: 443.	443
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-resourcegroupid1

https://r-kvstore.aliyuncs.com/?Action=CreateInstance &RegionId=cn-hangzhou &ZoneId=cn-hangzhou-e &InstanceType=tair_skv_ddb_ws &InstanceName=apitest &<Parámetros de solicitud comunes>

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
QPS	integer	Las consultas por segundo (QPS). Este es el valor teórico para las especificaciones actuales de la instancia.	100000
ConnectionDomain	string	El endpoint de conexión de red interna 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 la instancia único a nivel global.	r-bp1zxszhcgatnx**
Port	integer	El puerto de servicio de Redis.	443
Config	string	Las configuraciones detalladas de la instancia.	{\"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	La región donde se despliega la instancia.	cn-hongkong
RequestId	string	El ID de la solicitud.	5DEA3CC9-F81D-4387-8E97-CEA40F09****
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 a la instancia.	10000
InstanceName	string	El nombre de la instancia.	apitest
ZoneId	string	El ID de la zona donde se despliega la instancia.	cn-hangzhou-b
InstanceStatus	string	El estado actual de la instancia. El valor es fijo: Creating.	Creating
TaskId	string	El ID del flujo de tareas ejecutado para la creación.	1111
OrderId	integer	El ID del pedido.	20741011111111

{ "Connections": 0, "RequestId": "3631EF6F-2979-1C04-BDAA-51XXXXXXXXX", "InstanceId": "tt-2zesmjzrj0wzncb9y", "Port": 443, "OrderId": 0, "ConnectionDomain": "tt-2zesmjzrj0wzncb9y.tairskvddb.pre.rds.aliyuncs.com", "InstanceName": "apitest", "QPS": 0, "ChargeType": "PostPaid", "InstanceStatus": "Normal", "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": 443,
  "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-hongkong",
  "RequestId": "5DEA3CC9-F81D-4387-8E97-CEA40F09****",
  "Bandwidth": 96,
  "Connections": 10000,
  "InstanceName": "apitest",
  "ZoneId": "cn-hangzhou-b",
  "InstanceStatus": "Creating",
  "TaskId": "1111",
  "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.	La comprobació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	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	InvalidRegion.Format	Specified Region is not valid.	La región especificada no es válida.
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.	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.