調用ModifyParameter介面修改執行個體參數。

調用該介面時,執行個體狀態必須為運行中,否則將操作失敗。

可以修改的參數請在控制台查看,請參見使用控制台設定參數

提交修改請求後,RDS將下發任務,將新修改的參數應用到執行個體,如果所提交的參數中有需要重啟資料庫的,RDS將重啟資料庫。

下達任務之前,RDS將會進行參數檢查,方法如下:

  • 參數是否存在;
  • 參數是否可修改;
  • 參數是否合法。

調試

前往【API Explorer】線上調試,API Explorer 提供線上調用 API、動態產生 SDK Example 代碼和快速檢索介面等能力,能顯著降低使用雲 API 的難度,強烈推薦使用。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String ModifyParameter

系統規定參數,取值:ModifyParameter

DBInstanceId String rm-uf6wjk5xxxxxxx

執行個體ID。

Parameters String {"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}

參數及其值的JSON串,參數的值都是字串類型。格式:{"參數名稱1":"參數值1","參數名稱2":"參數值2"...}

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用於保證請求的等冪性,防止重複提交請求。由用戶端產生該參數值,要保證在不同請求間唯一,最大值不超過64個ASCII字元,且該參數值中不能包含非ASCII字元。

Forcerestart Boolean false

修改參數是否重啟資料庫,取值:

  • true:強制重啟(若修改的參數當中,有需要重啟的參數,則必須傳入true,否則修改將不生效)。
  • false:不強制重啟。

預設值:false

AccessKeyId String LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回參數

名稱 類型 樣本值 描述
RequestId String 542BB8D6-4268-45CC-A557-B03EFD7AB30A

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=ModifyParameter
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Parameters={"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}
&<公用請求參數>

正常返回樣本

XML 格式

<ModifyeParameterResponse>
  <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
</ModifyeParameterResponse>

JSON 格式

{
	"RequestId":"542BB8D6-4268-45CC-A557-B03EFD7AB30A"
}

錯誤碼

查看本產品錯誤碼