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.
Actualización más reciente 2022-11-14 GMT+08:00

Consulta de la lista de versiones del conjunto de datos

Función

Esta API se utiliza para consultar la lista de versiones de un conjunto de datos específico.

URI

GET /v2/{project_id}/datasets/{dataset_id}/versions

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

dataset_id

String

ID de conjunto de datos.

project_id

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

status

No

Integer

Estado de una versión de conjunto de datos. Opciones:

  • 0: creando
  • 1: en ejecución
  • 2: eliminación
  • 3: eliminado
  • 4: error

train_evaluate_ratio

No

String

Relación de división de versiones para el filtrado de versiones. Los números antes y después de la coma indican las relaciones de división mínima y máxima, y las versiones cuyas relaciones de división están dentro del intervalo se filtran, por ejemplo, 0.0,1.0. Nota: Si este parámetro se deja en blanco o no está disponible, el sistema no filtra los conjuntos de datos basados en la relación de división de versiones de forma predeterminada.

version_format

No

Integer

Formato de una versión de conjunto de datos. Opciones:

  • 0: formato predeterminado
  • 1: CarbonData (soportado solo por conjuntos de datos de tablas)
  • 2: CSV (soportado solo por conjuntos de datos de tablas)

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 1000. El valor predeterminado es 1000.

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 total de versiones del conjunto de datos.

versions

Array of DatasetVersion objects

Lista de versiones del conjunto de datos.

Tabla 4 DatasetVersion

Parámetro

Tipo

Descripción

add_sample_count

Integer

Número de muestras añadidas.

analysis_cache_path

String

Ruta de caché para el análisis de características.

analysis_status

Integer

Estado de una tarea de análisis de elementos. Opciones:

  • 0: inicializado
  • 1: en ejecución
  • 2: completado
  • 3: fallido

analysis_task_id

String

ID de una tarea de análisis de características.

annotated_sample_count

Integer

Número de muestras con versiones etiquetadas.

annotated_sub_sample_count

Integer

Número de submuestras etiquetadas.

clear_hard_property

Boolean

Si se deben borrar las propiedades del ejemplo duro durante la publicación. Opciones:

  • true: Borre propiedades de ejemplos duros. (Valor predeterminado)
  • false: No borre las propiedades de los ejemplos duros.

code

String

Código de estado de una tarea de preprocesamiento, como rotación y recorte.

create_time

Long

Hora en que se crea una versión.

crop

Boolean

Si desea recortar la imagen. Este campo sólo es válido para el conjunto de datos de detección de objetos cuyo cuadro de etiquetado está en forma de rectángulo. Opciones:

  • true: Recortar la imagen.
  • false: No recortar la imagen. (Valor predeterminado)

crop_path

String

Ruta para almacenar archivos recortados.

crop_rotate_cache_path

String

Directorio temporal para ejecutar la tarea de rotación y recorte.

data_analysis

Map<String,Object>

Resultado del análisis de características en formato JSON.

data_path

String

Ruta para almacenar datos.

data_statistics

Map<String,Object>

Estadísticas de ejemplo en un conjunto de datos, incluidas las estadísticas de metadatos de ejemplo en formato JSON.

data_validate

Boolean

Si los datos son validados por el algoritmo de validación antes de publicación. Opciones:

  • true: los datos han sido validados.
  • false: los datos no se han validado.

deleted_sample_count

Integer

Número de muestras eliminadas.

deletion_stats

Map<String,Integer>

Estadísticas de motivos de eliminación.

description

String

Descripción de una versión.

export_images

Boolean

Si desea exportar imágenes al directorio de salida de la versión durante el lanzamiento. Opciones:

  • true: Exporte imágenes al directorio de salida de la versión.
  • false: no exporte imágenes al directorio de salida de la versión. (Valor predeterminado)

extract_serial_number

Boolean

Si se va a analizar el número de submuestra durante la publicación. El campo es válido para el conjunto de datos de atención médica. Opciones:

  • true: Analiza el número de submuestra.
  • false: no analice el número de submuestra. (Valor predeterminado)

include_dataset_data

Boolean

Si desea incluir los datos de origen de un conjunto de datos durante la publicación. Opciones:

  • true: Se incluyen los datos de origen de un conjunto de datos.
  • false: no se incluyen los datos de origen de un conjunto de datos.

is_current

Boolean

Si se utiliza la versión actual del conjunto de datos. Opciones:

  • trub se utiliza la versión actual del conjunto de datos.
  • falsee: no se utiliza la versión actual del conjunto de datos.

label_stats

Array of LabelStats objects

Lista de estadísticas de etiquetas de una versión publicada.

label_type

String

Tipo de etiqueta de una versión publicada. Opciones:

  • multi: se incluyen muestras multietiqueta.
  • single: Todas las muestras están marcadas con un solo marcador.

manifest_cache_input_path

String

Ruta de entrada para la caché del archivo de manifest durante la publicación de la versión.

manifest_path

String

Ruta de acceso para almacenar el archivo de manifest con la versión publicada.

message

String

Información de la tarea registrada durante la liberación (por ejemplo, información de error).

modified_sample_count

Integer

Número de muestras modificadas.

previous_annotated_sample_count

Integer

Número de muestras etiquetadas de versiones principales.

previous_total_sample_count

Integer

Muestras totales de versiones principales.

previous_version_id

String

ID de versión principal

processor_task_id

String

ID de una tarea de preprocesamiento, como rotación y recorte.

processor_task_status

Integer

Estado de una tarea de preprocesamiento, como rotación y recorte. Opciones:

  • 0: inicializado
  • 1: en ejecución
  • 2: completado
  • 3: fallido
  • 4: parado
  • 5: tiempo de espera
  • 6: error de eliminación
  • 7: parada fallida

remove_sample_usage

Boolean

Si se debe borrar la información de uso existente de un conjunto de datos durante el lanzamiento. Opciones:

  • true: Borre la información de uso existente de un conjunto de datos. (Valor predeterminado)
  • false: no borre la información de uso existente de un conjunto de datos.

rotate

Boolean

Si desea girar la imagen. Opciones:

  • true: Gire la imagen.
  • false: no gire la imagen. (Valor predeterminado)

rotate_path

String

Ruta de acceso para almacenar el archivo rotado.

sample_state

String

Estado de la muestra. Opciones:

  • __ALL__: etiquetado
  • __NONE__: sin etiqueta
  • __UNCHECK__: a comprobar
  • __ACEPTADO__: aceptado
  • __RECHAZADO__: rechazado
  • __UNREVIEWED__: a ser revisado
  • __REVISADO__: revisado
  • __WORKFORCE_SAMPLED__: datos aceptados muestreados
  • __WORKFORCE_SAMPLED_UNCHECK__: muestras a comprobar
  • __WORKFORCE_SAMPLED_CHECKED__: muestras comprobadas
  • __WORKFORCE_SAMPLED_ACCEPTED__: muestras aceptadas
  • __WORKFORCE_SAMPLED_REJECTED__: muestras rechazadas
  • __AUTO_ANNOTATION__: a comprobar

start_processor_task

Boolean

Si se debe iniciar una tarea de análisis de datos durante la publicación. Opciones:

  • true: Iniciar una tarea de análisis de datos durante el lanzamiento.
  • false: No inicie una tarea de análisis de datos durante el lanzamiento. (Valor predeterminado)

status

Integer

Estado de una versión de conjunto de datos. Opciones:

  • 0: creando
  • 1: en ejecución
  • 2: eliminación
  • 3: eliminado
  • 4: error

tags

Array of strings

Lista de identificadores de clave del conjunto de datos. El tipo de etiquetado se utiliza como etiqueta predeterminada cuando la tarea de etiquetado publica una versión. Por ejemplo, ["Image","Object detection"].

task_type

Integer

Tipo de tarea de etiquetado de la versión publicada, que es el mismo que el tipo de conjunto de datos.

total_sample_count

Integer

Número total de muestras de versión.

total_sub_sample_count

Integer

Número total de submuestras generadas a partir de las muestras prinicpales.

train_evaluate_sample_ratio

String

Dividir la relación de entrenamiento y verificación durante el lanzamiento de la versión. El valor predeterminado es 1.00, lo que indica que todas las versiones publicadas son conjuntos de entrenamiento.

update_time

Long

Hora en que se actualiza una versión.

version_format

String

Formato de una versión de conjunto de datos. Opciones:

  • Default: formato predeterminado
  • CarbonData (soportado solo por conjuntos de datos de tablas)
  • CSV: CSV

version_id

String

ID de versión del conjunto de datos.

version_name

String

Nombre de la versión del conjunto de datos.

with_column_header

Boolean

Si la primera fila del archivo CSV publicada es un nombre de columna. Este campo es válido para el conjunto de datos de la tabla. Opciones:

  • true: La primera fila del archivo CSV publicado es un nombre de columna.
  • false: La primera fila del archivo CSV publicado no es un nombre de columna.
Tabla 5 LabelStats

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.

count

Integer

Número de etiquetas.

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.

sample_count

Integer

Número de muestras que contienen la etiqueta.

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 6 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 7 LabelAttributeValue

Parámetro

Tipo

Descripción

id

String

ID de valor de atributo de etiqueta.

value

String

Valor del atributo de etiqueta.

Tabla 8 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 la lista de versiones de un conjunto de datos específico

GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/versions

Ejemplo de respuestas

Código de estado: 200

OK

{
  "total_number" : 3,
  "versions" : [ {
    "version_id" : "54IXbeJhfttGpL46lbv",
    "version_name" : "V003",
    "version_format" : "Default",
    "previous_version_id" : "eSOKEQaXhKzxN00WKoV",
    "status" : 1,
    "create_time" : 1605930512183,
    "total_sample_count" : 10,
    "annotated_sample_count" : 10,
    "total_sub_sample_count" : 0,
    "annotated_sub_sample_count" : 0,
    "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V003/V003.manifest",
    "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V003/data/",
    "is_current" : true,
    "analysis_status" : 3,
    "train_evaluate_sample_ratio" : "0.8",
    "remove_sample_usage" : false,
    "export_images" : false,
    "description" : "",
    "task_type" : 0,
    "extract_serial_number" : false
  }, {
    "version_id" : "eSOKEQaXhKzxN00WKoV",
    "version_name" : "V002",
    "version_format" : "Default",
    "previous_version_id" : "vlGvUqOcxxGPIB0ugeE",
    "status" : 1,
    "create_time" : 1605691027084,
    "total_sample_count" : 10,
    "annotated_sample_count" : 10,
    "total_sub_sample_count" : 0,
    "annotated_sub_sample_count" : 0,
    "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/V002.manifest",
    "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V002/data/",
    "is_current" : false,
    "analysis_status" : 3,
    "train_evaluate_sample_ratio" : "0.9999",
    "remove_sample_usage" : false,
    "export_images" : false,
    "description" : "",
    "task_type" : 0,
    "extract_serial_number" : false
  }, {
    "version_id" : "vlGvUqOcxxGPIB0ugeE",
    "version_name" : "V001",
    "version_format" : "Default",
    "status" : 1,
    "create_time" : 1605690687346,
    "total_sample_count" : 10,
    "annotated_sample_count" : 10,
    "total_sub_sample_count" : 0,
    "annotated_sub_sample_count" : 0,
    "manifest_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V001/V001.manifest",
    "data_path" : "/test-obs/classify/output/dataset-f9e8-gfghHSokody6AJigS5A/annotation/V001/data/",
    "is_current" : false,
    "analysis_status" : 3,
    "train_evaluate_sample_ratio" : "0.99",
    "remove_sample_usage" : false,
    "export_images" : false,
    "description" : "",
    "task_type" : 0,
    "extract_serial_number" : false
  } ]
}

Códigos de estado

Código de estado

Descripción

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

Códigos de error

Consulte Códigos de error.