All Products
Search
Document Center

Tablestore:CreateVCUInstance

Last Updated:Jul 30, 2025

Creates a VCU instance.

Operation description

  • Before you call this operation, ensure that you understand the billing methods and pricing of Tablestore. For more information, see Billing overview.

  • An Alibaba Cloud account can create a maximum of 10 instances. The instance names must be unique within the same region.

  • The cluster type (instance type) cannot be changed after an instance is created. Select the cluster type with caution.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/openapi/createvcuinstance HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body.

ClusterType

string

Yes

The cluster type.

SSD vs HYBRID

VCU

integer

Yes

The instance type: the number of VCUs.

1

PeriodInMonth

integer

Yes

The subscription duration. Unit: month.

1

EnableElasticVCU

boolean

No

Specifies whether to enable instance elasticity. If you enable instance elasticity, the peak VCU usage can exceed the purchased VCU amount, but additional fees are incurred.

AliasName

string

No

The alias of the instance.

test

InstanceDescription

string

No

The description of the instance.

testvcu

Tags

array

No

The tags.

object

No

The key-value pair of the tag.

Value

string

Yes

The value of the tag. The value can be up to 64 characters in length.

0woauavextilfqr61

Key

string

Yes

The key of the tag. The key can be up to 64 characters in length.

created

ResourceGroupId

string

No

The ID of the resource group.

rg-acfmxh4em5jnbcd

EnableAutoRenew

boolean

No

Specifies whether to enable auto-renewal.

AutoRenewPeriodInMonth

integer

No

The auto-renewal cycle. This parameter is required if auto-renewal is enabled.

1

DryRun

boolean

No

Specifies whether to perform a dry run. If you perform a dry run, no instance is created.

false

Response parameters

Parameter

Type

Description

Example

object

The schema of the response.

RequestId

string

The request ID.

39871ED2-62C0-578F-A32E-B88072D5582F

InstanceName

string

The name of the created instance.

instance-test

Code

string

The status code of the response.

200

Message

string

The description of the response message.

success

Examples

Success response

JSON format

{
  "RequestId": "39871ED2-62C0-578F-A32E-B88072D5582F",
  "InstanceName": "instance-test",
  "Code": "200",
  "Message": "success"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.