本文介绍如何使用Tablestore CLI以命令行的方式管理表格存储实例。

开通表格存储服务

如果已经开通表格存储服务，请跳过此操作。服务仅需开通一次，开通过程免费。

命令格式如下，用于开通表格存储服务。
enable_service
返回结果如下：
Your service is enabled.

创建实例

在指定地域下创建一个实例。

注意 实例名需要在地域内全局唯一。如果出现实例名冲突错误，请重新命名。
  • 命令格式
    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

查看实例信息

查看实例的信息，例如实例名称、创建时间、所属账号ID等。

  • 命令格式
    describe_instance -r regionId -n instanceName
  • 示例
    查询华东1（杭州）地域下myinstance实例的信息。
    describe_instance -r cn-hangzhou -n myinstance
    返回结果如下：
    {
    "Status": 1,
    "WriteCapacity": 5000,
    "ReadCapacity": 5000,
    "ClusterType": "SSD",
    "Timestamp": "",
    "UserId": "643941",
    "InstanceName": "myinstance",
    "CreateTime": "2021-10-31 14:19:43",
    "Network": "NORMAL",
    "Description": "First instance created by CLI.",
    "Quota": {
        "EntityQuota": 64
    },
    "TagInfos": {
        "TagInfo": []
    }
}

获取实例列表

获取指定地域下所有实例的列表。

  • 命令格式
    list_instance -r regionId
  • 示例

    获取华东1（杭州）地域下所有实例列表。

    list_instance -r cn-hangzhou
    配置项说明请参见下表。
    配置项 是否必填 示例值 描述
    -r 是 cn-hangzhou 地域ID。
    返回结果如下：
    说明 如果当前地域下未创建实例，则返回结果为空。 
    [
    "myinstance"
]

配置实例

配置实例的服务地址，请根据所处于的网络类型来选择。

  • 命令格式
    config --endpoint endpoint --instance instanceName
    配置项说明请参见下表。
    配置项 是否必填 示例值 描述
    --endpoint 是 http://myinstance.cn-hangzhou.ots.aliyuncs.com 实例的服务地址，支持公网和VPC两种，请根据实际需要选择。域名的规则如下：
    • 公网：http(s)://<instance_name>.<region_id>.ots.aliyuncs.com
    • VPC：http(s)://<instance_name>.<region_id>.vpc.tablestore.aliyuncs.com
    --instance 是 myinstance 实例名称。
  • 示例

    配置华东1（杭州）地域下myinstance实例为公网访问域名。

    config --endpoint http://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance
    返回结果如下：
    {
    "Endpoint": "http://myinstance.cn-hangzhou.ots.aliyuncs.com",
    "AccessKeyId": "NTSVLeBHzgX2iZfcaXXPJ****",
    "AccessKeySecret": "7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****",
    "Instance": "myinstance"
}
    返回结果说明请参见下表。
    配置项 是否必填 示例值 说明
    Endpoint 否 https://myinstance.cn-hangzhou.ots.aliyuncs.com 实例的服务地址。更多信息，请参见服务地址。
    Instance 否 myinstance 实例名称。
    AccessKeyId 是 NTSVLeBHzgX2iZfcaXXPJ**** 阿里云账号或者RAM用户的AccessKey ID和AccessKey Secret。
    AccessKeySecret 是 7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****