# 查询团队标注任务统计信息 #### 功能介绍 查询团队标注任务统计信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ListWorkforceTaskStats)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}/data-annotations/stats 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | 数据集ID。 | | project_id | 是 | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 | | workforce_task_id | 是 | String | 团队标注任务ID。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | sample_state | 否 | String | 查询指定样本状态下的统计信息。可选样本状态如下： - __ALL__：已标注 - __NONE__：未标注 - __UNCHECK__：待验收 - __ACCEPTED__：验收通过 - __REJECTED__：已驳回 - __UNREVIEWED__：待审核 - __REVIEWED__：已审核 - __WORKFORCE_SAMPLED__：已采样 - __WORKFORCE_SAMPLED_UNCHECK__：采样待验收 - __WORKFORCE_SAMPLED_CHECKED__：采样已验收 - __WORKFORCE_SAMPLED_ACCEPTED__：采样已通过 - __WORKFORCE_SAMPLED_REJECTED__：采样已驳回 - __AUTO_ANNOTATION__：待确认 | #### 请求参数 无 #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data_path | String | 数据集数据存储路径。 | | data_spliting_enable | Boolean | 根据样本标注统计，判断数据集是否可以进行训练/验证集切分。可选值如下： - true：数据集可以进行训练/验证集切分 - false：数据集无法进行训练/验证集切分 | | grouped_label_stats | Map\\> | 按标注类型分组后的标签统计信息。 | | hard_detail_stats | Map\ | 难例原因详情统计信息。类型为Map\\>，Map的key为难例原因ID，Pair的key为难例原因出现的次数，Pair的value为难例原因HardDetail。 | | key_sample_stats | Map\ | 难例统计信息。 | | label_stats | Array of [LabelStats] objects | 标签统计信息列表。 | | metadata_stats | Map\ | 样本元信息统计信息，json格式。 | | sample_stats | Map\ | 样本状态统计信息。 | 表4LabelStats | 参数 | 参数类型 | 描述 | |:---|:---|:---| | attributes | Array of [LabelAttribute] objects | 标签的多维度属性，如标签为"音乐"，可能包含属性"风格"、"歌手"等。 | | count | Integer | 该标签的打标数量。 | | name | String | 标签名称。 | | property | [LabelProperty] object | 标签基本属性键值对，如颜色、快捷键等。 | | sample_count | Integer | 包含该标签的样本数量。 | | type | Integer | 标签类型。可选值如下： - 0：图像分类 - 1：物体检测 - 3: 图像分割 - 100：文本分类 - 101：命名实体 - 102：文本三元组关系标签 - 103：文本三元组实体标签 - 200：语音分类 - 201：语音内容 - 202：语音分割 - 600：视频标注 | 表5PairOfintAndHardDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | Integer | 难例原因出现的次数。 | | value | [HardDetail] object | 难例原因。 | 表6HardDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | alo_name | String | 别名。 | | id | Integer | 原因ID。 | | reason | String | 原因描述。 | | suggestion | String | 处理建议。 | 表7LabelAttribute | 参数 | 参数类型 | 描述 | |:---|:---|:---| | default_value | String | 标签属性默认值。 | | id | String | 标签属性ID。可通过调用标签列表查询。 | | name | String | 标签属性名称。不能超过64个字符，不能包含字符!\<\>=\&"'。 | | type | String | 标签属性类型。可选值如下： - text：文本 - select：单选下拉列表 | | values | Array of [LabelAttributeValue] objects | 标签属性值列表。 | 表8LabelAttributeValue | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 标签属性值ID。 | | value | String | 标签属性值。 | 表9LabelProperty | 参数 | 参数类型 | 描述 | |:---|:---|:---| | @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 | 内置属性：三元组关系标签的指向实体类型，创建关系标签时必须指定，该参数仅文本三元组数据集使用。 | #### 请求示例 查询团队标注任务中未审核样本的统计信息 ``` GET https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/workforce-tasks/tY330MHxV9dqIPVaTRM/data-annotations/stats?sample_state=__unreviewed__ ``` #### 响应示例 **状态码： 200** OK ``` { "label_stats" : [ { "name" : "Rabbits", "type" : 1, "property" : { "@modelarts:color" : "#3399ff" }, "count" : 0, "sample_count" : 0 }, { "name" : "Bees", "type" : 1, "property" : { "@modelarts:color" : "#3399ff" }, "count" : 1, "sample_count" : 1 } ], "sample_stats" : { "un_annotation" : 308, "total" : 309, "rejected" : 0, "unreviewed" : 1, "accepted" : 0, "auto_annotation" : 0, "uncheck" : 0 }, "key_sample_stats" : { "total" : 309, "non_key_sample" : 309, "key_sample" : 0 }, "metadata_stats" : { }, "data_spliting_enable" : false } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。