# 创建数据集标签 #### 功能介绍 创建数据集标签。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=CreateLabels)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI POST /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | 数据集ID。 | | project_id | 是 | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | labels | 否 | Array of [Label] objects | 待创建的标签列表。 | 表3Label | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | attributes | 否 | Array of [LabelAttribute] objects | 标签的多维度属性，如标签为"音乐"，可能包含属性"风格"、"歌手"等。 | | name | 否 | String | 标签名称。 | | property | 否 | [LabelProperty] object | 标签基本属性键值对，如颜色、快捷键等。 | | type | 否 | Integer | 标签类型。可选值如下： - 0：图像分类 - 1：物体检测 - 3: 图像分割 - 100：文本分类 - 101：命名实体 - 102：文本三元组关系标签 - 103：文本三元组实体标签 - 200：语音分类 - 201：语音内容 - 202：语音分割 - 600：视频标注 | 表4LabelAttribute | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | default_value | 否 | String | 标签属性默认值。 | | id | 否 | String | 标签属性ID。可通过调用标签列表查询。 | | name | 否 | String | 标签属性名称。不能超过64个字符，不能包含字符!\<\>=\&"'。 | | type | 否 | String | 标签属性类型。可选值如下： - text：文本 - select：单选下拉列表 | | values | 否 | Array of [LabelAttributeValue] objects | 标签属性值列表。 | 表5LabelAttributeValue | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | String | 标签属性值ID。 | | value | 否 | String | 标签属性值。 | 表6LabelProperty | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | @modelarts:color | 否 | String | 内置属性：标签展示的颜色，为色彩的16进制代码，默认为空。例如："#FFFFF0"。 | | @modelarts:default_shape | 否 | String | 内置属性：物体检测标签的默认形状（物体检测标签专用属性），默认为空。可选值如下： - bndbox：矩形。 - polygon：多边形。 - circle：圆形。 - line：直线。 - dashed：虚线。 - point：点。 - polyline：折线。 | | @modelarts:from_type | 否 | String | 内置属性：三元组关系标签的起始实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。 | | @modelarts:rename_to | 否 | String | 内置属性：重命名后的标签名。 | | @modelarts:shortcut | 否 | String | 内置属性：标签快捷键，默认为空。例如："D"。 | | @modelarts:to_type | 否 | String | 内置属性：三元组关系标签的指向实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。 | #### 响应参数 **状态码： 200** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 操作失败的错误码。 | | error_msg | String | 操作失败的错误信息。 | | results | Array of [BatchResponse] objects | 创建标签响应体。 | | success | Boolean | 操作是否执行成功。可选值如下： - true：执行成功 - false：执行失败 | 表8BatchResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 操作失败的错误码。 | | error_msg | String | 操作失败的错误信息。 | | success | Boolean | 操作是否执行成功。可选值如下： - true：执行成功 - false：执行失败 | #### 请求示例 创建数据集标签。设置标签名称为"Cat"，物体检测标签的默认形状为"bndbox"。 ``` { "labels" : [ { "name" : "Cat", "property" : { "@modelarts:color" : "#3399ff", "@modelarts:default_shape" : "bndbox" } } ] } ``` #### 响应示例 **状态码： 200** OK ``` { "success" : true } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。