新建迁移项目
功能介绍
新建迁移项目。
接口约束
迁移项目不可与已有的迁移项目同名。
调用方法
请参见如何调用API。
URI
POST /v3/migprojects
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | X-Auth-Token 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：16384 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 是 | String | 迁移项目名称 最小长度：2 最大长度：19 |
description | 否 | String | 迁移项目描述 最小长度：0 最大长度：255 |
isdefault | 否 | Boolean | 是否为默认模板 缺省值：false |
region | 是 | String | 区域名称 最小长度：0 最大长度：255 |
start_target_server | 否 | Boolean | 迁移后是否启动目的端虚拟机 缺省值：true |
speed_limit | 否 | Integer | 限制迁移速率，单位：Mbps 最小值：0 最大值：10000 |
use_public_ip | 是 | Boolean | 是否使用公网IP迁移 缺省值：true |
exist_server | 是 | Boolean | 是否是已经存在的服务器 缺省值：true |
type | 是 | String | 迁移项目类型 MIGRATE_BLOCK:块级迁移 MIGRATE_FILE:文件级迁移 最小长度：0 最大长度：255 枚举值：
|
enterprise_project | 否 | String | 企业项目名称 缺省值：default 最小长度：0 最大长度：255 |
syncing | 是 | Boolean | 首次复制或者同步后 是否继续持续同步 缺省值：false |
start_networck_check | 否 | Boolean | 是否启动网络质量检测 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 创建迁移项目返回的新添加的迁移项目的id 最小长度：0 最大长度：255 |
状态码：403
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误代码 最小长度：0 最大长度：255 |
error_msg | String | 错误信息 最小长度：0 最大长度：255 |
encoded_authorization_message | String | 加密授权信息 最小长度：0 最大长度：65535 |
error_param | Array of strings | 错误参数 最小长度：0 最大长度：65535 数组长度：1 - 20 |
details | Array of details objects | 详细错误信息 数组长度：1 - 20 |
请求示例
新建迁移项目。新的迁移项目名称是N121，region信息是region，使用公网ip是true，迁移项目类型是MIGRATE_BLOCK
POST https://{endpoint}/v3/migprojects
{
"name" : "N121",
"description" : "",
"region" : "region",
"start_target_server" : true,
"speed_limit" : 0,
"use_public_ip" : true,
"exist_server" : true,
"isdefault" : true,
"type" : "MIGRATE_BLOCK",
"syncing" : false,
"enterprise_project" : "default"
} 响应示例
状态码：200
新建迁移项目成功
{
"id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx0001"
} 状态码：403
鉴权失败
{
"error_code" : "SMS.9004",
"error_msg" : "The current account does not have the permission to execute policy You do not have permission to perform action XXX on resource XXX.",
"encoded_authorization_message" : "XXXXXX",
"error_param" : [ "You do not have permission to perform action XXX on resource XXX." ],
"details" : [ {
"error_code" : "SMS.9004",
"error_msg" : "You do not have permission to perform action XXX on resource XXX."
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 新建迁移项目成功 |
403 | 鉴权失败 |
错误码
请参见错误码。
