Description
You can call this operation to create a video category. You can create a maximum of three category levels and up to 100 subcategories in each category.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Action | String | Yes | The operation that you want to perform. Set the value to AddCategory. |
| CateName | String | Yes | The category name.
|
| ParentId | Long | No | The parent category ID. If you do not set this parameter, a level-1 category is generated by default. The root node category ID is -1. |
Response parameters
| Name | Type | Description |
|---|---|---|
| RequestId | String | The GUID generated by Alibaba Cloud for the request. |
| Category | Category | The video category information. |
Examples
Sample requests
http://vod.cn-shanghai.aliyuncs.com/?Action=AddCategory&CateName=exampleCategory&Format=JSON&<Common request parameters>
Note: For more information about common request parameters, see Common parameters.
Sample responses
JSON format
{"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58","Category": {"CateId": 67788823,"CateName": "exampleCategory","ParentId": -1,"Level": 0}}
Error codes
The following table lists the error codes that this operation can return. For more information, see Error codes.
| Error code | Error message | HTTP status code | Description |
|---|---|---|---|
| LevelExceededMax | The level of categories exceeded maximum. | 400 | The error message returned when the levels of categories exceed the upper limit. |
| SubTotalExceededMax | The total of sub categories exceeded maximum. | 400 | The error message returned when the number of subcategories exceeds the upper limit. |
| InvalidCateId.NotFound | The CateId not exist. | 404 | The error message returned when the specified parent category ID does not exist. |