Manage Tablestore instances with the CLI - Tablestore - Alibaba Cloud Documentation Center

Prerequisites

A configured Tablestore CLI with access credentials. For more information, see Tablestore CLI.
An activated Tablestore service. For more information, see Activate Tablestore.

Create an instance

Create a Tablestore instance in a specific region.

create_instance -n instanceName -r regionId [-t ssd|hybrid] [-d description]

Parameter	Required	Description
`-n`	Yes	The instance name. The name must be unique within the region. If the name is already in use, specify a different name.
`-r`	Yes	The region ID. Example: `cn-hangzhou`. For more information, see Basic concepts.
`-t`	No	The instance type. Valid values: `ssd` (high-performance instance, default) and `hybrid` (capacity instance).
`-d`	No	The instance description.

Create a high-performance instance:

create_instance -n myinstance -r cn-hangzhou -d "High-performance instance"

Create a capacity instance:

create_instance -n myinstance-cap -r cn-hangzhou -t hybrid

View instance details

View details of a specific instance, including instance type, creation time, and network configuration.

describe_instance -n instanceName -r regionId

Parameter	Required	Description
`-n`	Yes	The instance name.
`-r`	Yes	The region ID.

Example:

describe_instance -n myinstance -r cn-hangzhou

Sample response:

{
    "InstanceName": "myinstance",
    "InstanceSpecification": "SSD",
    "InstanceStatus": "normal",
    "PaymentType": "PayAsYouGo",
    "CreateTime": "2025-04-22T06:24:52Z",
    "RegionId": "cn-hangzhou",
    "NetworkTypeACL": ["VPC", "CLASSIC", "INTERNET"],
    "TableQuota": 64,
    ...
}

List instances

List all instances in a specific region.

list_instance -r regionId

Parameter	Required	Description
`-r`	Yes	The region ID.

Example:

list_instance -r cn-hangzhou

Sample response:

["myinstance", "myinstance-cap"]

Note

If no instances exist in the region, the command returns an empty list.

What's next

After you create an instance, choose a data model based on your use case.