調用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 |
修改參數是否重啟資料庫，取值：
預設值：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"
}