创建Tair VNode虚拟节点实例
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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 |
| VkName | string | 是 | VNode 所在 VCluster 虚拟集群实例 ID | tk-2ze4bba3c8fe**** |
| VSwitchId | string | 是 | 本实例的虚拟交换机 ID，需要从属于指定 VCluster 虚拟集群的专有网络 VPC，可调用专有网络 VPC 的 DescribeVpcs 获取。 说明
虚拟交换机所属的可用区需和本实例相同。
| vsw-bp1e7clcw529l773d**** |
| ChargeType | string | 否 | 要转换到的付费类型，取值：
| 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 | 否 | 是否使用代金券，取值：
| false |
| AutoRenew | boolean | 否 | 是否开启自动续费，取值：
| false |
| AutoRenewPeriod | string | 否 | 自动续费周期，单位为月，取值：1、2、3、6、12。 说明
当 AutoRenew 取值为 true 时，本参数必须传入。
| 1 |
| ResourceGroupId | string | 否 | 目标资源组 ID。 说明
| rg-acfmyiu4ekp**** |
| AutoPay | boolean | 否 | 自动支付，取值固定为 true | true |
| ClientToken | string | 否 | 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。 | ETnLKlblzczshOTUbOCz**** |
| Tag | array<object> | 否 | 实例的标签信息。 | |
| object | 否 | 实例的标签信息。 | ||
| Value | string | 否 | 标签的值。 说明
N 表示传入第几个标签的值。例如Tag.1.Value表示传入第一个标签的值；Tag.2.Value表示传入第二个标签的值。
| key1_test |
| Key | string | 否 | 标签的键，与 Tag Value 组成标签的键值对。 说明
单次最多支持传入 5 组标签的键值对。
| value1_test |
| DryRun | boolean | 否 | 是否对本次创建实例的操作执行预检查，取值：
| false |
返回参数
示例
正常返回示例
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. | 指定 iz不支持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 | InvalidvSwitchId | The Specified vSwitchId zone not supported. | 指定的vswitch在此可用区不支持 |
| 404 | InvalidVpcIdOrVswitchId.NotSupported | The Specified vpcId or vSwitchId not supported. | - |
访问错误中心查看更多错误码。