調用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"
}