# 高级设置 - UpdateTuningParams #### 功能介绍 修改调优参数的值。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DRS&api=UpdateTuningParams)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。 #### URI PUT /v3/{project_id}/job/{job_id}/tuning-params/modify-params 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 | | job_id | 是 | String | 租户在某一Region下的Job ID，如果是主备任务，使用父任务ID。 获取方法请参见[获取任务ID](https://support.huaweicloud.com/api-drs/drs_api_0115.html)。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | 指定类型为application/json。 | | X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 | | X-Language | 否 | String | 请求语言类型 缺省值：**en-us** 枚举值： - **en-us** - **zh-cn** | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | full_sync | 否 | Map\ | 全量参数的参数名及对应的取值。 - **supportObjectTypes**：全量同步对象类型 - **fullScn**：同步位点 - **readTaskNum**：导出并发数 - **optimizeMode**：导入模式 - **writeTaskNum**：导入并发数 - **shardRecordLength**：分片记录数 - **openStreamMode**：流模式 - **splitMode**：分片方式 - **isMultiThreadingConfig**：配置并发数 | | incre_capture | 否 | Map\ | 增量抓取参数的参数名及对应的取值。 - **readerThreadPerNode**：日志抓取并发数 | | incre_apply | 否 | Map\ | 增量回放参数的参数名及对应的取值。 - **conflictPolicy**：冲突策略 - **applyStartId**：回放启动位点 - **applyCoun** **t**：回放任务并发数 - **applyAutoStart**：回放启动策略 | | incre_relay | 否 | Map\ | 增量日志拉取参数的参数名及对应的取值。 - **slotAdvanceInterval**：源库逻辑复制槽推进间隔。 | | recovery | 否 | Boolean | 初始化参数，首次调用时需要传true，其他时候不传。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | full_sync | Array of objects | 全量调优参数。 详情请参见[表5]。 | | incre_capture | Array of objects | 增量抓取调优参数。 详情请参见[表5 TuningParameterfull_sync、incre_capture、incre_apply和incre_relay字段数据结构说明]。 | | incre_apply | Array of objects | 增量回放调优参数。 详情请参见[表5 TuningParameterfull_sync、incre_capture、incre_apply和incre_relay字段数据结构说明]。 | | incre_relay | Array of objects | 增量日志拉取调优参数。 详情请参见[表5 TuningParameterfull_sync、incre_capture、incre_apply和incre_relay字段数据结构说明]。 | | modify_result | String | 参数修改是否成功。 | 表5full_sync、incre_capture、incre_apply和incre_relay字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | param_name | String | 参数名称。 | | param_value | String | 参数取值。 | | availability | String | 是否可用。 | | range | String | 参数取值范围。 | #### 请求示例 - GaussDB集中式版到kafka任务设置指定源库逻辑复制槽推进间隔 ``` https://{endpoint}/v3/054c06d8aa00d39e2f6cc00176952b8b/job/1e3f710f-4df3-4fc9-8a29-0ec72c5jb2b3/tuning-params/modify-params { "incre_relay" : { "slotAdvanceInterval" : "5" } } ``` - 初始化高级参数 ``` https://{endpoint}/v3/054c06d8aa00d39e2f6cc00176952b8b/job/1e3f710f-4df3-4fc9-8a29-0ec72c5jb2b3/tuning-params/modify-params { "recovery" : true } ``` #### 响应示例 **状态码：200** OK ``` { "full_sync" : [ ], "incre_capture" : [ ], "incre_apply" : [ ], "incre_relay" : [ { "param_name" : "slotAdvanceInterval", "param_value" : "5" } ], "modify_result" : "success" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | 其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。