文档首页> 分布式消息服务RocketMQ版> API参考 (巴黎区域)> API V2（推荐）> 元数据迁移> 新建元数据迁移任务
更新时间：2023-08-16 GMT+08:00
查看PDF

新建元数据迁移任务

功能介绍

新建元数据迁移任务。

URI

POST /v2/{project_id}/instances/{instance_id}/metadata

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见获取项目ID。

instance_id

是

String

实例ID。
表2 Query参数

参数

是否必选

参数类型

描述

overwrite

是

String

true开启同名覆盖，会对已有的同名元数据的配置进行修改，false时当topic或group已存在则会报错。

name

是

String

迁移任务名称，名称规则参考创建实例

type

是

String

迁移任务类型，分为自建RocketMQ上云(rocketmq)、自建RabbitMQ上云(rabbitToRocket)

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

CreateRocketMqMigrationTaskRequestBody

是

String

元数据json文件。

响应参数

无

请求示例

创建元数据迁移任务。

POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/metadata

{
  "rabbit_version" : "3.8.35",
  "rabbitmq_version" : "3.8.35",
  "product_name" : "RabbitMQ",
  "product_version" : "3.8.35",
  "users" : [ {
    "name" : "root",
    "password_hash" : "password_hash",
    "hashing_algorithm" : "rabbit_password_hashing_sha256",
    "tags" : "administrator",
    "limits" : { }
  } ],
  "vhosts" : [ {
    "name" : "DeleteVhost123"
  } ],
  "permissions" : [ {
    "name" : "root",
    "vhost" : "DeleteVhost123",
    "configure" : ".*",
    "write" : ".*",
    "read" : ".*"
  } ],
  "topic_permissions" : [ ],
  "parameters" : [ ],
  "global_parameters" : [ {
    "name" : "internal_cluster_id",
    "value" : "rabbitmq-cluster-id-123"
  } ],
  "policies" : [ ],
  "queues" : [ {
    "name" : "test-001",
    "vhost" : "/",
    "durable" : false,
    "auto_delete" : false,
    "arguments" : { }
  } ],
  "exchanges" : [ {
    "name" : "direct",
    "vhost" : "/",
    "durable" : false,
    "auto_delete" : false,
    "internal" : false,
    "arguments" : { }
  } ],
  "bindings" : [ {
    "source" : "direct",
    "vhost" : "/",
    "destination" : "test-001",
    "destination_type" : "queue",
    "routing_key" : "test-001",
    "arguments" : { }
  } ]
}

响应示例

状态码： 200

返回状态码

6cf4dcd3-8471-4139-8b5b-8a3a71f704c7

状态码

状态码

描述

200

返回状态码

错误码

请参见错误码。

父主题： 元数据迁移