Creates a Tair VNode instance.
Debugging
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- For mandatory resource types, indicate with a prefix of * .
- If the permissions cannot be granted at the resource level,
All Resourcesis used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| kvstore:CreateTairKVCacheVNode | create | *All Resources * |
| none |
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RegionId | string | Yes | The ID of the region where the instance resides. | cn-beijing |
| ZoneId | string | Yes | The zone ID of the instance. | cn-beijing-f |
| InstanceName | string | No | The name of the instance. The name must be 2 to 80 characters in length. The name must start with a letter and cannot contain spaces or the following special characters: | vnodetest |
| InstanceClass | string | Yes | Instance specification | kvcache.cu.g4b.2 |
| ComputeUnitNum | integer | Yes | The number of compute units. Valid values: 1. | 1 |
| VkName | string | Yes | The ID of the VCluster that contains the VNode. | tk-2ze4bba3c8fe**** |
| VSwitchId | string | Yes | The ID of the vSwitch to which the instance belongs. The vSwitch must belong to the VPC of the VCluser. You can call the DescribeVpcs operation to query the VPC ID. Note
The vSwitch and the instance must be deployed in the same zone.
| vsw-bp1e7clcw529l773d**** |
| ChargeType | string | No | The new billing method. Valid values:
| PrePaid |
| Period | integer | No | The subscription duration. Valid values: 1 to 9, 12, 24, and 36. Unit: months. Note
This parameter is required only if the ChargeType parameter is set to PrePaid.
| 1 |
| BusinessInfo | string | No | The extended information such as the promotional event ID and business information. | 000000000 |
| CouponNo | string | No | The coupon code. | youhuiquan_promotion_option_id_for_blank |
| AutoUseCoupon | boolean | No | Specifies whether to use a coupon. Valid values:
| false |
| AutoRenew | boolean | No | Specifies whether to enable auto-renewal for the instance. Default value: false. Valid values:
| false |
| AutoRenewPeriod | string | No | The subscription duration that is supported by auto-renewal. Unit: month. Valid values: 1, 2, 3, 6, and 12. Note
This parameter is required if the AutoRenew parameter is set to true.
| 1 |
| ResourceGroupId | string | No | The ID of the resource group that you want to manage. Note
| rg-acfmyiu4ekp**** |
| AutoPay | boolean | No | Specifies whether to enable automatic payment. Set the value to true. | true |
| ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests and is case-sensitive. The token can contain only ASCII characters and cannot exceed 64 characters in length. | ETnLKlblzczshOTUbOCz**** |
| Tag | array<object> | No | Details of the tags. | |
| object | No | Details of the tag. | ||
| Value | string | No | The value of tag N of the instance. Note
N specifies the value of the nth tag. For example, Tag.1.Value specifies the value of the first tag, and Tag.2.Value specifies the value of the second tag.
| key1_test |
| Key | string | No | The tag key. Note
A maximum of five key-value pairs can be specified at a time.
| value1_test |
| DryRun | boolean | No | Specifies whether to perform a dry run. Valid values:
| false |
Response parameters
Examples
Sample success responses
JSONformat
{
"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****"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 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. | Your account balance is insufficient. Add funds to your account and try again. |
| 400 | QuotaExceed.AfterpayInstance | Living afterpay instances quota exceeded. | The maximum number of instances has been reached. |
| 400 | InvalidCapacity.NotFound | The Capacity provided does not exist in our records. | The specified storage specification does not exist. |
| 400 | ResourceNotAvailable | Resource you requested is not available for finance user. | The requested resource is unavailable to users of Alibaba Finance Cloud. |
| 400 | PaymentMethodNotFound | No payment method has been registered on the account. | No payment methods are specified for your account. |
| 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. | The number of instances specified for this region is insufficient. |
| 400 | QuotaExceed | Living afterpay instances quota exceed. | The maximum number of instances has been reached. |
| 400 | VpcServiceError | Invoke vpc service failed. | - |
| 400 | IzNotSupportVpcError | Specify iz not support vpc. | The specified iz does not support VPCs. |
| 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 | 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. | The error message returned because the instance engine version is invalid. |
| 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. | The specified region is invalid. |
| 403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | Your account has not completed real-name verification. |
| 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. | The specified vswitch is not supported in this Availability Zone |
| 404 | InvalidVpcIdOrVswitchId.NotSupported | The Specified vpcId or vSwitchId not supported. | - |
For a list of error codes, visit the Service error codes.