Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ ModelArts/ Referencia de la API/ Gestión de datos/ Gestión de etiquetas/ Consulta de la lista de etiquetas de conjunto de datos

Actualización más reciente 2022-11-14 GMT+08:00

Ver PDF

Consulta de la lista de etiquetas de conjunto de datos

Función

Esta API se utiliza para consultar todas las etiquetas de un conjunto de datos.

URI

GET /v2/{project_id}/datasets/{dataset_id}/data-annotations/labels

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
dataset_id	Sí	String	ID de conjunto de datos.
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
version_id	No	String	ID de versión del conjunto de datos.
offset	No	Integer	Página de inicio para la visualización de paginación. El valor predeterminado es 0.
limit	No	Integer	Número máximo de registros devueltos en cada página. El valor varía de 1 a 100000. El valor predeterminado es 100000.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
total_number	Integer	Número de etiquetas
labels	Array of Label objects	Lista de etiquetas.

**Tabla 4** Label
Parámetro	Tipo	Descripción
attributes	Array of LabelAttribute objects	Atributo multidimensional de una etiqueta. Por ejemplo, si la etiqueta es música, se pueden incluir atributos como el estilo y el artista.
name	String	Nombre de la etiqueta.
property	LabelProperty object	Par clave-valor de atributo básico de una etiqueta, como el color y las teclas de método abreviado.
type	Integer	Tipo de etiqueta. Opciones: 0: clasificación de imágenes 1: detección de objetos 3: segmentación de la imagen 100: Clasificación del texto 101: reconocimiento de entidad nombrada 102: Relación de trillizos de texto 103: Entidad triplete de texto 200: clasificación de sonido 201: Etiquetado de voz 202: Etiquetado de párrafo de discurso 600: etiquetado de vídeo

**Tabla 5** LabelAttribute
Parámetro	Tipo	Descripción
default_value	String	Valor predeterminado de un atributo de etiqueta.
id	String	ID de atributo de etiqueta.
name	String	Nombre del atributo de etiqueta.
type	String	Tipo de atributo de etiqueta. Opciones: text: texto select: lista desplegable de una sola opción
values	Array of LabelAttributeValue objects	Lista de valores de atributo de etiqueta.

**Tabla 6** LabelAttributeValue
Parámetro	Tipo	Descripción
id	String	ID de valor de atributo de etiqueta.
value	String	Valor del atributo de etiqueta.

**Tabla 7** LabelProperty
Parámetro	Tipo	Descripción
@modelarts:color	String	Atributo predeterminado: Color de etiqueta, que es un código hexadecimal del color. De forma predeterminada, este parámetro se deja en blanco. Ejemplo: #FFFFF0.
@modelarts:default_shape	String	Atributo predeterminado: forma predeterminada de una etiqueta de detección de objeto (atributo dedicado). De forma predeterminada, este parámetro se deja en blanco. Opciones: bndbox: rectángulo polygon: polígono circle: círculo line: línea recta dashed: línea de puntos point: punto polyline: polilínea
@modelarts:from_type	String	Atributo por defecto: Tipo de la entidad de cabecera en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.
@modelarts:rename_to	String	Atributo predeterminado: el nuevo nombre de la etiqueta.
@modelarts:shortcut	String	Atributo predeterminado: Tecla de método abreviado de etiqueta. De forma predeterminada, este parámetro se deja en blanco. Por ejemplo: D.
@modelarts:to_type	String	Atributo por defecto: Tipo de la entidad de cola en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.

Solicitudes de ejemplo

Consulta de todas las etiquetas de un conjunto de datos

GET https://{endpoint}/v2/{project_id}/datasets/WxCREuCkBSAlQr9xrde/data-annotations/labels

Ejemplo de respuestas

Código de estado: 200

{
  "total_number" : 2,
  "labels" : [ {
    "name" : "Cat",
    "type" : 1,
    "property" : {
      "@modelarts:color" : "#3399ff"
    }
  }, {
    "name" : "Dog",
    "type" : 1,
    "property" : {
      "@modelarts:color" : "#3399ff"
    }
  } ]
}