All Products
Search
Document Center

ApsaraVideo VOD:DeleteCategory

Last Updated:Jul 19, 2024

Deletes a category and its subcategories.

Operation description

  • After you call this operation to delete a category, all subcategories including level 2 and level 3 categories are deleted at the same time. Exercise caution when you call this operation.
  • If you have classified specific media resources to a category, the category names labeled on these media resources are automatically deleted when you delete the category.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
CateIdlongYes

The ID of the category. You can specify only one ID. You can use one of the following methods to obtain the ID:

  • Log on to the ApsaraVideo VOD console. Choose Configuration Management > Media Management > Categories. On the Audio and Video / Image Category or Short Video Material Category tab, view the category ID.
  • Obtain the category ID from the response to the AddCategory operation.
Note If you specify the ID of a parent category, all subcategories under the parent category are deleted at the same time.
3300****

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The ID of the request.

25818875-5F78-4AF6-D7393642CA58****

Examples

Sample success responses

JSONformat

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}

Error codes

For a list of error codes, visit the Service error codes.

Common errors

The following table describes the common errors that this operation can return.

Error codeError messageHTTP status codeDescription
InvalidCateId.NotFoundThe CateId not exist.404The error message returned because the specified category ID does not exist.