文档

CreateInstance - 创建实例

更新时间:

创建实例。

接口说明

  • 请确保在使用该接口前,已充分了解 Tablestore 产品的计费说明和价格。更多信息,请参见计费概览
  • 单个阿里云账户最多可以创建 10 个实例,且在同一地域中实例名称必须唯一。
  • 集群类型(即实例规格)在实例创建后无法修改,请谨慎选择。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/openapi/createinstance HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

InstanceNamestring

实例名称。实例的命名规范如下:

  • 必须由英文字母、数字或短划线(-)组成。
  • 首字符必须为英文字母。
  • 末尾字符不能为短划线(-)。
  • 大小写不敏感。
  • 长度在 3~16 字符之间。
  • 实例名称不能包含 ali、ay、ots、taobao、admin 这几个单词。
instance-test
ClusterTypestring

集群类型(即实例规格)。

  • SSD:高性能。
  • HYBRID:容量型。
SSD
InstanceDescriptionstring

实例描述。长度限制在 3-256 个字符之间。

测试实例的描述信息。
ResourceGroupIdstring

资源组 ID。

rg-acfmxh4em5jnbcd
Networkstring

(已弃用)实例网络类型。NORMAL, VPC_CONSOLE。默认为 NORMAL。

NORMAL
NetworkTypeACLarray

实例允许的网络类型列表,默认都允许。

  • INTERNET:公网。
  • VPC:VPC 网络。
  • CLASSIC:经典网。
string

实例允许的网络类型。

枚举值:
  • INTERNETINTERNET
  • VPCVPC
  • CLASSICCLASSIC
VPC
NetworkSourceACLarray

实例允许的网络来源列表,默认都允许。

TRUST_PROXY:可信网关(控制台)。

string

实例允许的网络来源。

枚举值:
  • TRUST_PROXYTRUST_PROXY
TRUST_PROXY
Policystring

实例访问控制策略,JSON 格式。

{ "Version": "1", "Statement": [ { "Action": [ "ots:*" ], "Resource": [ "acs:ots:*:13791xxxxxxxxxxx:instance/myinstance*" ], "Principal": [ "*" ], "Effect": "Allow", "Condition": { "StringEquals": { "ots:TLSVersion": [ "1.2" ] }, "IpAddress": { "acs:SourceIp": [ "192.168.0.1", "198.51.100.1" ] } } } ] }
Tagsarray<object>

标签列表。

object

标签键值对。

Keystring

标签的键。 长度限制为 64 个字符。

p_instance
Valuestring

标签的值。 长度限制为 64 个字符。

0woauavextilfqr61
DisableReplicationboolean

是否开启实例的容灾状态。

枚举值:
  • falsefalse
  • truetrue
false

返回参数

名称类型描述示例值
object

返回结构体。

RequestIdstring

请求 ID,可用于排查和定位问题。

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

响应状态码。

200
Messagestring

响应消息描述。

success

示例

正常返回示例

JSON格式

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

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-03-21API 内部配置变更,不影响调用查看变更详情
2023-10-13OpenAPI 返回结构发生变更查看变更详情
2023-08-16API 内部配置变更,不影响调用查看变更详情