创建迁移任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
apig:CreateMigrationTask |
create |
*全部资源
|
无 | 无 |
请求语法
POST /v1/migration-tasks HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求参数。 |
|
| gatewayId |
string |
否 |
目标网关 ID(迁移流量切到该网关) |
gw-xxxx |
environmentId
deprecated
|
string |
否 |
目标环境 ID,必须与 API 的 Ingress 导入环境一致。注意:本参数实际为必填项;未提供时,API 返回 400 InvalidParameter.IsEmpty。可调用 ListEnvironments 查询已有环境 ID;CreateEnvironment 已标记为废弃。 |
env-xxxx |
| httpApiId |
string |
否 |
HTTP API ID,必须已导入为 Ingress 类型(HttpIngress)的 API。注意:本参数实际为必填项;未提供时,API 返回 400 InvalidParameter.IsEmpty。 |
api-xxxx |
| migrationType |
string |
否 |
迁移类型 枚举值:
|
Nginx Ingress |
| clusterId |
string |
否 |
源 ACK 集群 ID,须与 API 的 IngressInfo 中集群一致 注意:本参数实际为必填项;未提供时,API 返回 400 InvalidParameter.IsEmpty。 |
c-xxxxxx |
| ingressClass |
string |
否 |
Ingress Class,传入时须与 API 导入配置一致,否则报 ingress class conflict |
nginx |
| description |
string |
否 |
任务描述,仅在创建时落库 |
migration from Nginx |
| watchNamespace |
string |
否 |
监听的命名空间,传入时须与 API 导入配置一致,否则报 watchNamespace conflict |
default |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求 ID。 |
019FD4D8-8A86-5FDE-B79F-357C69677DFB |
| code |
string |
响应状态码。 |
200 |
| message |
string |
响应消息。 |
success |
| data |
object |
响应数据。 |
|
| taskId |
string |
任务 ID。 |
async-task-xxx |
示例
正常返回示例
JSON格式
{
"requestId": "019FD4D8-8A86-5FDE-B79F-357C69677DFB",
"code": "200",
"message": "success",
"data": {
"taskId": "async-task-xxx"
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。