描述
建立一個執行個體。執行個體規格,詳見附錄中執行個體規格表。
請求參數
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
<公用請求參數> | - | 是 | 參見公用請求參數。 |
Action | String | 是 | 操作介面名,取值:CreateInstance。 |
InstanceName | String | 否 | 執行個體名稱。 名稱為2-128個字元,以大小寫字英文母或中文開頭,不支援字元@/:=”<>{[]}和空格。 |
Password | String | 否 | 執行個體密碼。 字元類型,8-30個字元,需同時包含大寫字母、小寫字母和數字。
注意 暫時不支援 !<>()[]{},`~.-_@#$%^&* 之類的特殊符號。
|
InstanceClass | String | 是 | 申請的 Redis 執行個體規格。參見執行個體規格表。 |
RegionId | String | 是 | 申請的儲存執行個體所在地區。通過函數 DescribeRegions 查看可用的資料中心。 |
ZoneId | String | 否 | RegionId 下的可用性區域。通過函數 DescribeRegions 查看可用的可用性區域。 |
ChargeType | String | 否 | 付費類型:PrePaid 或 PostPaid,預設為 PostPaid。 |
Period | Long | 否 | 付費周期,付費類型為 PrePaid 時必須,單位為月,可選值:1-9,12,24,36 。 |
Token | String | 否 | 用於保證請求的等冪性。由用戶端產生該參數值,要保證在不同請求間唯一,大小寫敏感、不超過64個 ASCII 字元。參見如何保證等冪性。 |
NetworkType | String | 否 | 網路類型:
網路預設傳統網路。 |
VpcId | String | 否 | VPC 網路識別碼。 |
VSwitchId | String | 否 | 虛擬交換器 ID。 |
PrivateIp | String | 否 | 私人 IP 位址。 |
SrcDBInstanceId | String | 否 | 基於某個執行個體的備份組建立執行個體有效,輸入產生備份組的執行個體 ID。 |
BackupId | String | 否 | 基於某個執行個體的備份組建立執行個體有效,輸入產生備份組 ID。通過調用 DescribeBackups 查詢 BackupId。 |
InstanceType | String | 否 | 執行個體類型,取值:Redis,Memcache。 預設為 Redis。 |
EngineVersion | String | 否 | 版本類型,取值:2.8 或 4.0。 預設值為 2.8。 |
返回參數
名稱 | 參數類型 | 描述 |
---|---|---|
<公用返回參數> | - | 參見公用返回參數。 |
InstanceId | String | 執行個體 ID (全域唯一)。 |
InstanceName | String | 執行個體名稱。 |
注意 出於曆史相容性考慮,該函數會有些返回結構在文檔中並未提及(如 Config,Region 等),後續阿里雲將逐步把這些欄位刪除,請您在調用 API 時不要依賴這些在文檔中沒有涉及的返回欄位。
請求樣本
https://r-kvstore.aliyuncs.com
?<公用請求參數>
&Action=CreateInstance
&RegionId=cn-hangzhou
&Password=Qa123456
&InstanceClass= redis.master.small.default
返回樣本
{
"InstanceId":"736538d0a6894665",
"InstanceName":"736538d0a6894665"
}