更新时间：2025-04-09 GMT+08:00

创建迁移项目

功能介绍

创建迁移项目。创建迁移项目需要关联状态为“COMPLETED”的评估项目。迁移项目依次经历以下几个阶段：目标库权限检查、语法转换、验证、下载迁移失败的报告、删除。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/migration-projects

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户在某一Region下的Project ID。获取方法请参见获取项目ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	从IAM服务获取的用户Token。

表3 请求Body参数
参数	是否必选	参数类型	描述
migration_project_name	是	String	迁移项目名称。长度为5-50个字符，以英文字母开头，英文字母或数字结束，允许包含下划线和中划线。不允许重复。最小长度：5 最大长度：50
evaluation_project_id	是	Integer	评估项目ID。
target_db_info	是	表4 object	目标数据库信息。
open_gauss_config	否	表5 object	目标库为GaussDB的配置项。

表4 TargetDBInfo
参数	是否必选	参数类型	描述
user_name	是	String	用户名。
password	是	String	用户密码。
service_name	是	String	service名称。
instance_id	是	String	RDS数据库的实例ID。

表5 GaussDBConfig
参数	是否必选	参数类型	描述
permission_check_type	否	String	权限检查类型。枚举值： objectowner sysadmin

响应参数

无

请求示例

创建名为OPEN_API_MIGRATION，目标库实例ID为dxx49b0c0cc846b6a1ead4caad4cd58ein14的迁移项目。

POST https://{EndPoint}/v1/0ac6eb2c8000d2ee2fd9c006dededbe6/migration-projects 
 
{ 
  "migration_project_name" : "OPEN_API_MIGRATION", 
  "evaluation_project_id" : 191, 
  "target_db_info" : { 
    "user_name" : "root", 
    "password" : "password", 
    "service_name" : "ugo", 
    "instance_id" : "dxx49b0c0cc846b6a1ead4caad4cd58ein14" 
  }, 
  "open_gauss_config" : { 
    "permission_check_type" : "sysadmin" 
  } 
}