閱讀954 返回首頁    go 阿裏雲 go 技術社區[雲棲]

修改數據庫參數列表__參數管理_API 參考_雲數據庫 RDS 版-阿裏雲

描述

用戶可以修改實例參數，提交請求後，RDS將下達任務，新修改的參數應用到實例。如果所提交的參數中，有需要重啟數據庫的，RDS將重啟數據庫。
必須滿足以下條件，否則調用失敗：

  • 當前實例狀態：使用中
  • 當前實例鎖定模式：正常

參數值有如下3類：

  • [1-65535]，表示數字範圍，通過正則識別，從而提取出最小值，最大值。然後根據最小值和最大值對輸入參數進行驗證，另外，還須是整除因子的倍數
  • [utf8|gbk|latin1]，表示固定的取值規則，通過正則識別，從而提取出固定的取值。然後根據這些固定的取值對輸入參數進行驗證
  • 其它，這種情況符合正則表達式

下達任務之前，RDS將會進行參數檢查，步驟如下：

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

若參數非法，RDS返回400錯誤，並返回非法的參數信息。類似： 

{"HttpStatusCode":400,"Code":"InvalidParameter.Format",
"Message":"Specified parameter is not valid.[auto_increment_increment:a,character_set_client:41]"}

請求參數

名稱 類型 是否必須 描述
Action String 是 係統規定參數，取值：ModifyParameter
DBInstanceId String 是 實例名
Parameters String 是 參數及其值的JSON串，
參數的值都是字符串類型，
{"auto_increment_increment":"1",
"character_set_client":"utf8"}
Forcerestart String 否 true：強製重啟（若修改的參數當中，有需要重啟的參數，則必須傳入true，否則修改將不生效）；false：不強製重啟。默認不強製重啟

返回參數

名稱 類型 描述
詳見附錄

示例

  • 請求示例
https://rds.aliyuncs.com/?Action=ModifyeParameter
&DBInstanceId=riauvjz6zajfiq6ba1370329449201L
&Parameters={"key_buffer_size":"456","character_set_client":"gbk"}
&<公共請求參數>
  • 返回示例

XML格式：

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

JSON格式： 

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

最後更新：2016-11-23 16:03:53

  上一篇：go 查看當前實例數據庫參數運行列表__參數管理_API 參考_雲數據庫 RDS 版-阿裏雲
  下一篇：go 查看慢日誌列表__日誌管理_API 參考_雲數據庫 RDS 版-阿裏雲