修改云數據庫SelectDB版實例的集群名稱。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| selectdb:ModifyBEClusterAttribute | update | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
| DBInstanceId | string | 是 | 實例 ID。 | selectdb-cn-7213cjv**** |
| DBClusterId | string | 是 | 集群 ID。 | selectdb-xxxb9f2w-be |
| InstanceAttributeType | string | 是 | 修改屬性類型。 固定填寫為 DBInstanceDescription。 | DBInstanceDescription |
| Value | string | 是 | 目標集群名稱。 | testdb |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "58E21E11-90FF-50F8-A615-8DEB193676E0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | ClusterNotSupport | Current instance cluster does not support this operation. | 當前集群狀態不支持該操作。 |
| 400 | InvalidClusterName.Format | Specified ClusterName is not valid. It can not be empty string. | 輸入的集群名稱參數不合法。 |
| 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 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in our records. | SelectDB實例不存在。 |
| 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-07-10 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-06-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-01-11 | OpenAPI 返回結構發生變更 | 查看變更詳情 |