創建一個云數據庫SelectDB版實例。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| selectdb:CreateDBInstance | create | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ResourceGroupId | string | 否 | 資源組 ID。 | rg-aekzt2zaluvuvqa_fake |
| ClientToken | string | 否 | 用于保證請求的冪等性，防止重復提交請求。由客戶端生成該參數值，要保證在不同請求間唯一，最大值不超過 64 個 ASCII 字符，且該參數值中不能包含非 ASCII 字符。 | AB |
| Engine | string | 否 | 數據庫類型，默認值為 selectdb。 | selectdb |
| EngineVersion | string | 是 | 數據庫版本，默認值為2.4。 | 2.4 |
| ChargeType | string | 是 | 實例的付費類型。取值：
| PrePaid |
| UsedTime | integer | 否 | 指定預付費實例的購買時長。取值說明：
說明
僅當 ChargeType 為 Prepaid 時，該參數才生效且為必填參數。
| 1 |
| Period | string | 否 | 指定預付費集群為包年或包月類型。取值說明：
說明
僅當 ChargeType 為 Prepaid 時，該參數才生效且為必填參數。
| Month |
| DBInstanceClass | string | 是 | 實例計算資源，取值說明：
| selectdb.xlarge |
| RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
| ZoneId | string | 是 | 可用區 ID。 | cn-hangzhou-e |
| CacheSize | integer | 是 | 預留緩存大小。 | 200GB |
| VpcId | string | 是 | VPC ID。 | vpc-bp175iuvg8nxqraf2**** |
| VSwitchId | string | 是 | 交換機 ID。 | vsw-bp1gzt31twhlo0sa5**** |
| DBInstanceDescription | string | 否 | 實例備注信息。 | 新建實例測試 |
| ConnectionString | string | 否 | 數據庫連接地址。 | selectdb-cn-7213c8y****-public.selectdbfe.pre.rds.aliyuncs.com |
| SecurityIPList | string | 否 | 實例的 IP 白名單，多個 IP 地址請用英文逗號（,）分隔。 | 192.168.1.1 |
| Tag | array<object> | 否 | 實例標簽列表信息。 | |
| object | 否 | 實例標簽列表。 | ||
| Key | string | 否 | 標簽鍵。 | testKey |
| Value | string | 否 | 標簽值。 | testValue |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "4773E4EC-025D-509F-AEA9-D53123FDFB0F",
"Data": {
"DBInstanceId": "selectdb-cn-7213cjv****",
"OrderId": 0
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | COMMODITY.INVALID_COMPONENT | Order configuration parameters do not meet the verification conditions, please re-match the product. | 訂單配置參數不符合校驗條件，請重新選配商品！ |
| 400 | DocumentConvertFailed.ExceedFileSizeLimit | The conversion has been failed, exceed file size limit. | 文檔轉換失敗，文件大小超過系統限額。 |
| 400 | Forbidden | User not authorized to operate on the specified resource, or this API does not support RAM. | 子賬號權限不足，請先獲取授權。 |
| 400 | InvalidDBName | The specified database name is not allowed. | 數據庫名稱不符合要求，請確認數據名稱是否正確。 |
| 400 | CreateOrderFailed | Failed to create order. | 創建訂單失敗。 |
| 403 | DBClusterNotSupported | The requested operation can not be performed while the cluster is not sale. | 當集群未運行時，無法執行請求的操作。 |
| 403 | IncorrectDBInstanceState | Current DB instance state does not support this operation. | 當前實例狀態不支持此操作。 |
| 403 | InstanceEngineType.NotSupport | The instance engine and type does not support operations. | 操作失敗，實例引擎和類型不支持該操作。 |
| 403 | InvalidDBInstanceState.NotSupport | The specified instance state does't support this operation. | 指定的實例狀態不支持此操作。 |
| 403 | MoneyLessThan100 | The Account Monet less Than 100. | 當前阿里云賬號余額不足100，請充值。 |
| 403 | OperationDenied.DBNameAndAccountPrivilegeCount | The operation is not permitted due to count of database or account privilege. | 操作失敗，數據庫與權限的數量不一致。 |
| 403 | InsufficientResourceCapacity | The resource is out of usage. | 資源不足，請您稍后再試。 |
| 404 | DBInstanceLocked | The current instance lock mode does not support this operation. | 操作失敗，當前實例已鎖定。 |
| 404 | IncorrectVswitchId | The specified parameter VSwitchId is not valid. | 交換機參數無效。 |
| 404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | 找不到指定的 API。請檢查調用的 URL 和方法。您調用的 API 不存在。請檢查 API 的名稱是否正確，請注意確認大小寫。 |
| 404 | InvalidDBInstance.NotFound | The specified instance is not found. | 沒有找到指定的實例，請檢查實例的正確性。 |
| 404 | InvalidDBInstanceClass.NotFound | The specified instance classic does not exist. | 當前選擇的配置或規格不存在或已停售，請重新選擇。 |
| 404 | InvalidRegionId.NotFound | The provided RegionId does not exist in our records. | 操作失敗，輸入的地域及可用區不存在。 |
| 404 | QueryPrice.Failed | The inquiry failed. Contact Alibaba Cloud customer service representatives. | 詢價失敗，請聯系客服同學。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-08-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-06-12 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-12-27 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |