AI 助理
文档备案控制台
官方文档
首页 云数据库 Tair（兼容 Redis®） 开发参考 API参考 API目录 其他 CreateTairKVCacheVNode - 创建Tair KVCache VNode实例

CreateTairKVCacheVNode - 创建Tair KVCache VNode实例

更新时间：
复制 MD 格式
产品详情
我的收藏

创建Tair VNode虚拟节点实例

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

kvstore:CreateTairKVCacheVNode

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

地域 ID。使用此参数指定要创建实例的地域。

cn-beijing
ZoneId

string

是

可用区 ID。使用此参数指定要创建实例的可用区。

cn-beijing-f
InstanceName

string

否

新的实例名称。名称为 2~80 个字符，以大小写英文字母或中文开头，不支持空格及特殊字符：@/:=”<>{[]}。

vnodetest
InstanceClass

string

是

实例规格

kvcache.cu.g4b.2

ComputeUnitNum

integer

是

计算单元数量，目前仅支持 1 个计算单元

枚举值：

  • 1 :

    1

1
VkName

string

是

VNode 所在 VCluster 虚拟集群实例 ID

tk-2ze4bba3c8fe****

VSwitchId

string

是

本实例的虚拟交换机 ID，需要从属于指定 VCluster 虚拟集群的专有网络 VPC，可调用专有网络 VPC 的 DescribeVpcs 获取。

说明

虚拟交换机所属的可用区需和本实例相同。

vsw-bp1e7clcw529l773d****
ChargeType

string

否

要转换到的付费类型，取值：

  • PrePaid：包年包月，传入本值时，您还需要传入 Period 参数。

枚举值：

  • PrePaid :

    包年包月

PrePaid
Period

integer

否

付费周期，单位为月，取值：1~9、12、24、36。

说明

当 ChargeType 取值为 PrePaid 时，本参数必须传入。

1
BusinessInfo

string

否

活动 ID、业务信息等扩展信息。

000000000

CouponNo

string

否

优惠码。

youhuiquan_promotion_option_id_for_blank
AutoUseCoupon

boolean

否

是否使用代金券，取值：

  • true：使用代金券。

  • false（默认）：不使用代金券。

false
AutoRenew

boolean

否

是否开启自动续费，取值：

  • true：开启。

  • false（默认）：不开启。

false
AutoRenewPeriod

string

否

自动续费周期，单位为月，取值：1、2、3、6、12。

说明

当 AutoRenew 取值为 true 时，本参数必须传入。

1
ResourceGroupId

string

否

目标资源组 ID。

说明

rg-acfmyiu4ekp****
AutoPay

boolean

否

自动支付，取值固定为 true

枚举值：

  • true :

    自动支付

true
ClientToken

string

否

用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。

ETnLKlblzczshOTUbOCz****
Tag

array<object>

否

实例的标签信息。

object

否

实例的标签信息。

Key

string

否

标签的键，与 Tag Value 组成标签的键值对。

说明

单次最多支持传入 5 组标签的键值对。

value1_test
Value

string

否

标签的值。

说明

N 表示传入第几个标签的值。例如Tag.1.Value表示传入第一个标签的值；Tag.2.Value表示传入第二个标签的值。

key1_test
DryRun

boolean

否

是否对本次创建实例的操作执行预检查，取值：

  • true：执行预检查操作，不创建实例。检查项目包含请求参数、请求格式、业务限制和库存。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码DryRunOperation。

  • false（默认）：发送正常请求，通过检查后直接创建实例。

false
VNodeType

string

否

fixed
ElasticTimeRange

string

否

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

2BE6E619-A657-42E3-AD2D-18F8428A****
InstanceId

string

虚拟节点实例 ID。

tv-2zeb1ce76fee****
OrderId

integer

订单 ID。

20905403119****
RegionId

string

地域 ID。

cn-beijing
ZoneId

string

可用区 ID。

cn-beijing-f
VkName

string

虚拟集群实例 ID

tk-2ze4bba3c8fe****

VClusterId

string

虚拟集群 ID

vc-16965a9267*****-*****
NodeId

string

虚拟节点 ID

vn-03a49876edb****

示例

正常返回示例

JSON格式

{
  "RequestId": "2BE6E619-A657-42E3-AD2D-18F8428A****",
  "InstanceId": "tv-2zeb1ce76fee****",
  "OrderId": 0,
  "RegionId": "cn-beijing",
  "ZoneId": "cn-beijing-f",
  "VkName": "tk-2ze4bba3c8fe****\n",
  "VClusterId": "vc-16965a9267*****-*****",
  "NodeId": "vn-03a49876edb****"
}

错误码

HTTP status code

错误码

错误信息

描述
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. 幂等性校验不过。
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. VPC未找到，建议检查VPC ID是否正确。
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. 无效的引擎版本
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 InvalidRegion.Format Specified Region is not valid. 指定的地域Region无效
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. 所指定的存储规格不存在。
404 InvalidvSwitchId The Specified vSwitchId zone not supported.
404 InvalidVpcIdOrVswitchId.NotSupported The Specified vpcId or vSwitchId not supported.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：DeleteBackup - 删除备份集下一篇：DescribeTairKVCacheInferInstances - 查询Tair KVCache实例的列表信息