Help Center/ Distributed Message Service for RocketMQ/ API Reference/ APIs V2 (Recommended)/ Metadata Migration/ Deleting Metadata Migration Tasks in Batches
Updated on 2025-12-18 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Deleting Metadata Migration Tasks in Batches

Function

This API is used to delete metadata migration tasks in batches.

Calling Method

For details, see Calling APIs.

URI

POST /v2/{project_id}/instances/{instance_id}/metadata/batch-delete

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain it, see Obtaining a Project ID.

instance_id

Yes

String

Instance ID.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

task_ids

Yes

Array of strings

Tasks to be deleted.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

success_task_list

Array of strings

Definition

List of tasks that are successfully deleted.

Range

N/A

Example Requests

Deleting metadata migration tasks in batches

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

{
  "task_ids" : [ "1b8f2c93-8057-4bdd-9be5-5b6883737099", "fa89699b-61b9-497d-b1ac-972623f3c0ce" ]
}

Example Responses

Status code: 200

Metadata migration tasks deleted in batches.

{
  "success_task_list" : [ "1b8f2c93-8057-4bdd-9be5-5b6883737099", "fa89699b-61b9-497d-b1ac-972623f3c0ce" ]
}

Status Codes

Status Code

Description

200

Metadata migration tasks deleted in batches.

Error Codes

See Error Codes.

Parent Topic: Metadata Migration