文档首页/ 分布式数据库中间件 DDM/ API参考/ API（推荐）/ 逻辑库管理/ 修改切换路由策略V3
更新时间：2026-05-21 GMT+08:00
查看PDF
分享

修改切换路由策略V3

功能介绍

修改切换路由策略

URI

PUT /v3/{project_id}/instances/{instance_id}/databases/{db_name}/migration/jobs/{job_id}/route-switch-strategy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。

instance_id

是

String

DDM实例ID

db_name

是

String

逻辑库名称

job_id

是

String

任务流ID。参数获取，参见分片变更预校验。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

project_id

否

String

项目id。

instance_id

否

String

实例id。

task_id

否

String

任务id。

switch_route_begin_time

否

String

自动切换开始时间（hh:mm:ss，例如17:00:00）。

  • 不传switch_route_begin_time、switch_route_end_time则设置为手动切换策略。
  • 开始时间和结束时间间隔不能超过1小时

switch_route_end_time

否

String

自动切换结束时间（hh:mm:ss，例如18:00:00）。

  • 不传switch_route_begin_time、switch_route_end_time则设置手动切换策略。
  • 开始时间和结束时间间隔不能超过1小时

is_open_api

否

Boolean

是否openapi。

logic_db_name

否

String

逻辑库名称。

响应参数

状态码：200

无

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码：500

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

修改切换路由策略为自动切换。 
PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/databases/{db_name}/migration/jobs/{job_id}/route-switch-strategy

{
  "switch_route_begin_time": "17:00:00",
  "switch_route_end_time": "18:00:00"
}

修改切换路由策略为手动切换。 
PUT https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/1f5c9fd6cd984056ba89c8c87cc03278in09/databases/ddm_db_test/migration/jobs/10501cd3-0c19-498b-9ba4-8935ed447542/route-switch-strategy

响应示例

状态码：200

{ }

状态码：400

bad request

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码：500

server error

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码

状态码

描述

200

ok

400

bad request

500

server error

错误码

请参见错误码。

父主题： 逻辑库管理

相关文档