Help Center> ModelArts> API Reference> Historical APIs> Data Management (Old Version)> Deleting a Label and the Files that Only Contain the Label
Updated on 2023-12-14 GMT+08:00

Deleting a Label and the Files that Only Contain the Label

Function

This API is used to delete a label and the files that only contain this label.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

DELETE /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels/{label_name}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

dataset_id

Yes

String

Dataset ID.

label_name

Yes

String

Label name.

project_id

Yes

String

Project ID. For details about how to obtain a project ID, see Obtaining a Project ID and Name.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

delete_source

No

Boolean

Whether to delete the sample source files. Options:

  • true: Delete the sample source files.

  • false: Do not delete the sample source files. (Default value)

label_type

No

Integer

Label type. Options:

  • 0: image classification

  • 1: object detection

  • 3: image segmentation

  • 100: text classification

  • 101: named entity recognition

  • 102: text triplet relationship label

  • 103: text triplet entity label

  • 200: sound classification

  • 201: speech content

  • 202: speech paragraph labeling

  • 600: video labeling

Request Parameters

None

Response Parameters

Status code: 204

Table 3 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

success

Boolean

Check whether the operation is successful. Options:

  • true: The operation is successful.

  • false: The operation is failed.

Example Requests

Deleting a Label and the Files that Only Contain the Label

DELETE https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/data-annotations/labels/%E8%8D%89%E8%8E%93

Example Responses

Status code: 204

No Content

{
  "success" : true
}

Status Codes

Status Code

Description

204

No Content

401

Unauthorized

403

Forbidden

Error Codes

See Error Codes.