CreateInstance - 建立叢集
建立一個 OceanBase 資料庫叢集。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
oceanbase:CreateInstance |
create |
*Instance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ChargeType |
string |
是 |
執行個體的付費方式。取值範圍:
枚舉值:
|
PrePay |
| Series |
string |
是 |
執行個體的系列。
|
normal |
| Zones |
string |
是 |
執行個體所屬的可用性區域 ID。 |
cn-hangzhou-h,cn-hangzhou-i,cn-hangzhou-j |
| InstanceClass |
string |
是 |
叢集規格資訊。
枚舉值:
|
14C70GB |
| DiskSize |
integer |
否 |
儲存空間大小,單位 GB。 儲存空間的限制根據叢集規格不同而不同,具體如下:
|
200 |
| Period |
integer |
否 |
購買資源的時間長度,單位由 PeriodUnit 指定。
|
1 |
| PeriodUnit |
string |
否 |
購買資源的時間長度。 |
Month |
| AutoRenew |
boolean |
否 |
是否要自動續約。 當參數 ChargeType 取值 PrePaid 時生效。取值範圍:
|
true |
| AutoRenewPeriod |
integer |
否 |
每次自動續約的時間長度,當參數 AutoRenew 取值 True 時,該參數為必填參數。
|
2 |
| ResourceGroupId |
string |
否 |
執行個體所在的企業資源組 ID。 |
rg-bp67acfmxazb4p**** |
| InstanceName |
string |
否 |
OceanBase 叢集名稱。 長度為 1~20 個英文或中文字元。 如未指定該參數,預設值為叢集的 InstanceId。 |
amap_aos_tx_ob |
| ObVersion |
string |
否 |
OceanBase Server 版本號碼。 |
2.2.77 |
| DiskType |
string |
否 |
叢集的儲存類型。僅在標準叢集版(雲端硬碟)下生效。
|
cloud_essd_pl1 |
| DryRun |
boolean |
否 |
是否只預檢此次請求, 預設為 false。取值範圍:
|
false |
| ReplicaMode |
string |
否 |
全功能型副本數。傳回值僅包含 3 和 2。
|
3 |
| IsolationOptimization |
string |
否 |
是否開啟 Cgroup。 |
true |
| PrimaryInstance |
string |
否 |
主執行個體 ID。 |
ob3h8ytroxxxxx |
| PrimaryRegion |
string |
否 |
主執行個體 Region。 |
cn-hangzhou |
| CpuArch |
string |
否 |
cpu 架構 |
x86 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
請求結果。 |
||
| RequestId |
string |
請求 ID。 |
EE205C00-30E4-****-****-87E3A8A2AA0C |
| Data |
object |
返回資料。 |
|
| InstanceId |
string |
執行個體 ID。 |
i-bp67acfmxazb4p**** |
| OrderId |
string |
訂單 ID。 |
1234567890 |
| ResourceGroupId |
string |
資源群組 ID。 |
rg-*************** |
| DryRunResult |
boolean |
預檢查請求的結果。
|
false |
樣本
正常返回樣本
JSON格式
{
"RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
"Data": {
"InstanceId": "i-bp67acfmxazb4p****",
"OrderId": "1234567890",
"ResourceGroupId": "rg-***************",
"DryRunResult": false
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | Instance.Order.CreateFailed | Instance.Order.CreateFailed | |
| 400 | InstanceName.ModifyFailed | InstanceName.ModifyFailed | |
| 400 | InstanceClass.InvalidValue | InstanceClass.InvalidValue | |
| 400 | InstanceType.Unsupport | InstanceType.Unsupport | |
| 400 | ZoneList.Unsupport | ZoneList.Unsupport | |
| 400 | InstanceId.Invalid | InstanceId.Invalid | |
| 400 | InstanceId.Missing | InstanceId.Missing | |
| 400 | Instance.Name.Missing | Instance.Name.Missing | |
| 400 | ListCluster.Fail | ListCluster.Fail | |
| 400 | GetCluster.Fail | GetCluster.Fail | |
| 400 | ListClusterGroup.Fail | ListClusterGroup.Fail | |
| 400 | GetClusterGroup.Fail | GetClusterGroup.Fail | |
| 400 | ListInstance.Fail | ListInstance.Fail | |
| 400 | GetInstance.Fail | GetInstance.Fail | |
| 400 | ListTenant.Fail | ListTenant.Fail | |
| 400 | GetTenant.Fail | GetTenant.Fail | |
| 400 | Instance.ListAliyunInstance.Fail | Instance.ListAliyunInstance.Fail | |
| 400 | Instance.GetAliyunInstance.Fail | Instance.GetAliyunInstance.Fail | |
| 400 | ListZone.Fail | ListZone.Fail | |
| 400 | ListObServer.Fail | ListObServer.Fail | |
| 400 | GetObServer.Fail | GetObServer.Fail | |
| 400 | CreateInstanceParameters.Error | CreateInstanceParameters.Error | |
| 400 | CreateInstance.Fail | CreateInstance.Fail | |
| 400 | InstanceClassSpecification.Invalid | InstanceClassSpecification.Invalid | |
| 400 | InstanceOrder.NotAvailable | InstanceOrder.NotAvailable | |
| 400 | InstanceNodeNum.Invalid | InstanceNodeNum.Invalid | |
| 400 | InstanceLogSize.Invalid | InstanceLogSize.Invalid | |
| 400 | Instance.ExpandLogDisk.NotSupport | Instance.ExpandLogDisk.NotSupport | |
| 400 | InstanceStatus.Invalid | InstanceStatus.Invalid | |
| 400 | InstanceDataSize.Invalid | InstanceDataSize.Invalid | |
| 400 | StandbyInstance.StillOnline | StandbyInstance.StillOnline | |
| 400 | InstanceServiceName.Missing | InstanceServiceName.Missing | |
| 400 | PrimaryInstanceStatus.Invalid | PrimaryInstanceStatus.Invalid | |
| 400 | StandbyInstanceStatus.Invalid | StandbyInstanceStatus.Invalid | |
| 400 | StandbyInstance.NotSupport | StandbyInstance.NotSupport | |
| 400 | StandbyInstance.Disconnect.NotAllowed | StandbyInstance.Disconnect.NotAllowed | |
| 400 | InstanceDiskSize.Invalid | InstanceDiskSize.Invalid | |
| 400 | CreateInstance.Spec.NotSupport | CreateInstance.Spec.NotSupport | |
| 400 | MissingParameterDiskSize | MissingParameterDiskSize | |
| 400 | CreateInstance.ReplicaMode.InvalidValue | CreateInstance.ReplicaMode.InvalidValue | |
| 400 | CreateInstance.DeployType.InvalidValue | CreateInstance.DeployType.InvalidValue | |
| 400 | ConfigError | ConfigError | |
| 500 | Instance.Order.CreateFailed | Instance.Order.CreateFailed | |
| 500 | UnknownError | UnknownError |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。