实例（Instance）是您使用和管理表格存储服务的实体，每个实例相当于一个数据库。本文介绍如何使用Tablestore CLI以命令行的方式管理表格存储实例。
前提条件
已开通表格存储服务。具体操作，请参见开通表格存储服务。
创建实例
在指定地域下创建一个CU模型（原按量模式）下的高性能实例。
实例名需要在地域内全局唯一。如果出现实例名冲突错误，请重新命名。
使用命令行工具只能创建CU模型（原按量模式）下的高性能实例。
命令格式
create_instance -d description -n instanceName -r regionId配置项说明请参见下表。
配置项 | 是否必填 | 示例值 | 描述 |
-n | 是 | myinstance | 实例名称。更多信息，请参见实例。 |
-r | 是 | cn-hangzhou | 地域ID。更多信息，请参见地域。 |
-d | 否 | "First instance created by CLI." | 实例描述信息。 |
示例
以下示例用于在华东1（杭州）地域下创建一个高性能实例myinstance。
create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhou配置实例
只有配置实例后才能操作实例下的资源。
在配置接入信息时，如果未配置实例信息或已配置实例但是要修改操作的实例，则需要执行配置实例操作；如果已配置实例且无需修改操作的实例，则无需执行配置实例操作。
配置实例的服务地址用于选择要操作的实例，请根据所处的网络类型来选择合适的Endpoint进行配置。
命令格式
config --endpoint endpoint --instance instanceName配置项说明请参见下表。
配置项 | 是否必填 | 示例值 | 描述 |
--endpoint | 是 | http://myinstance.cn-hangzhou.ots.aliyuncs.com | 实例的服务地址，支持公网和VPC两种，请根据实际需要选择。域名的规则如下：
|
--instance | 是 | myinstance | 实例名称。 |
示例
以下示例用于配置华东1（杭州）地域下myinstance实例为公网访问域名。
config --endpoint http://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance返回结果如下：
{
"Endpoint": "http://myinstance.cn-hangzhou.ots.aliyuncs.com",
"AccessKeyId": "NTS**********************",
"AccessKeySecret": "7NR2****************************************",
"AccessKeySecretToken": "",
"Instance": "myinstance"
}返回结果说明请参见下表。
配置项 | 是否必填 | 示例值 | 说明 |
Endpoint | 否 | https://myinstance.cn-hangzhou.ots.aliyuncs.com | 实例的服务地址。更多信息，请参见服务地址。 |
Instance | 否 | myinstance | 实例名称。 |
AccessKeyId | 是 | NTS********************** | 阿里云账号或者RAM用户的AccessKey ID和AccessKey Secret。 说明 当使用从STS获取的临时访问凭证访问表格存储时，返回的AccessKeyId和AccessKeySecret分别为临时访问凭证的AccessKey ID和AccessKey Secret。 |
AccessKeySecret | 是 | 7NR2**************************************** | |
AccessKeySecretToken | 否 | STS.6MC2**************************************** | 临时访问令牌。当使用从STS获取的临时访问凭证访问表格存储时会返回此参数。 |
查看实例信息
查看实例的信息，例如实例名称、创建时间、所属账号ID等。
命令格式
describe_instance -r regionId -n instanceName配置项说明请参见下表。
配置项 | 是否必填 | 示例值 | 描述 |
-n | 是 | myinstance | 实例名称。更多信息，请参见实例。 |
-r | 是 | cn-hangzhou | 地域ID。更多信息，请参见地域。 |
示例
以下示例用于查询华东1（杭州）地域下myinstance实例的信息。
describe_instance -r cn-hangzhou -n myinstance返回结果如下：
{
"ClusterType": "ssd",
"CreateTime": "2024-07-18 09:15:10",
"Description": "First instance created by CLI.",
"InstanceName": "myinstance",
"Network": "NORMAL",
"Quota": {
"EntityQuota": 64
},
"ReadCapacity": 5000,
"Status": 1,
"TagInfos": {},
"UserId": "1379************",
"WriteCapacity": 5000
}获取实例列表
获取指定地域下所有实例的列表。
命令格式
list_instance -r regionId配置项说明请参见下表。
配置项 | 是否必填 | 示例值 | 描述 |
-r | 是 | cn-hangzhou | 地域ID。 |
示例
以下示例用于获取华东1（杭州）地域下所有实例列表。
list_instance -r cn-hangzhou返回结果如下：
如果当前地域下未创建实例，则返回结果为空。
[
"myinstance"
]相关文档
创建实例且已配置实例的接入信息后，您可以根据业务所需的数据存储模型使用表格存储功能。
数据模型 | 使用流程 |
宽表模型 | 如果要迁移数据或者使用计算引擎处理数据，请使用通道服务实现。更多信息，请参见通道服务。 |
时序模型 |