全部產品
Search
文件中心

Tablestore:CreateInstance

更新時間:Oct 26, 2026

建立執行個體。

介面說明

  • 請確保在使用該介面前,已充分了解 Tablestore 產品的計費說明和價格。更多資訊,請參見計費概覽。

  • 單一阿里雲帳戶最多可以建立 10 個執行個體,且在同一地域中執行個體名稱必須唯一。

  • 叢集類型(即執行個體規格)在執行個體建立後無法修改,請謹慎選擇。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ots:InsertInstance

create

*Instance

acs:ots:{#regionId}:{#accountId}:instance/{#InstanceName}

無 無

請求文法

POST /v2/openapi/createinstance HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

body

object

否

請求主體參數。

InstanceName

string

是

執行個體名稱。執行個體的命名規範如下:

  • 必須由英文字母、數字或短橫線(-)組成。

  • 首字元必須為英文字母。

  • 末尾字元不能為短橫線(-)。

  • 大小寫不敏感。

  • 長度在 3~16 字元之間。

  • 執行個體名稱不能包含 ali、ay、ots、taobao、admin 這幾個單字。

instance-test

ClusterType

string

是

叢集類型(即執行個體規格)。

枚舉值:

  • SSD :

    高效能。

  • HYBRID :

    容量型。

SSD

InstanceDescription

string

否

執行個體描述。長度限制在 3-256 個字元之間。

the test instance

ResourceGroupId

string

否

資源群組 ID。

rg-acfmxh4em5jnbcd

Network

string

否

(已棄用)執行個體網路類型。NORMAL, VPC_CONSOLE。預設為 NORMAL。

NORMAL

NetworkTypeACL

array

否

執行個體允許的網路類型清單,預設皆允許。

  • INTERNET:公網。

  • VPC:VPC 網路。

  • CLASSIC:經典網路。

string

否

執行個體允許的網路類型。

枚舉值:

  • INTERNET :

    公網。

  • VPC :

    VPC 網路。

  • CLASSIC :

    經典網路。

VPC

NetworkSourceACL

array

否

執行個體允許的網路來源清單,預設皆允許。

TRUST_PROXY:可信閘道(主控台)。

string

否

執行個體允許的網路來源。

枚舉值:

  • TRUST_PROXY :

    可信閘道(主控台)

TRUST_PROXY

Policy

string

否

執行個體存取控制策略,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" ] } } } ] }

Tags

array<object>

否

標籤清單。

object

否

標籤鍵值組。

Key

string

是

標籤的鍵。 長度限制為 64 個字元。

p_instance

Value

string

是

標籤的值。 長度限制為 64 個字元。

0woauavextilfqr61

DisableReplication deprecated

boolean

否

(已棄用)是否開啟執行個體的容災狀態。

false

返回參數

名稱

類型

描述

樣本值

object

傳回結構體。

RequestId

string

請求 ID,可用於排查和定位問題。

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

Code

string

回應狀態碼。

200

Message

string

回應訊息描述。

success

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。