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 versiones de conjuntos de datos/ Consulta de detalles acerca de una versión de conjunto de datos

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

Ver PDF

Consulta de detalles acerca de una versión de conjunto de datos

Función

Esta API se utiliza para consultar los detalles sobre una versión de conjunto de datos.

URI

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

**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.
version_id	Sí	String	ID de versión del conjunto de datos.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 2** Parámetros de body de respuesta
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. (Default value)
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>	Eliminación de estadísticas de motivos.
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. (Default value)
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 liberació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 3** 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 4** LabelAttribute
Parámetro	Tipo	Descripción
default_value	String	Valor predeterminado de un atributo label.
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 5** LabelAttributeValue
Parámetro	Tipo	Descripción
id	String	ID de valor de atributo de etiqueta.
value	String	Valor del atributo de etiqueta.

**Tabla 6** 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 detalles acerca de una versión de conjunto de datos

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

Ejemplo de respuestas

Código de estado: 200

{
  "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" : true,
  "analysis_status" : 3,
  "train_evaluate_sample_ratio" : "0.9999",
  "remove_sample_usage" : false,
  "export_images" : false,
  "description" : "",
  "label_stats" : [ {
    "name" : "Cat",
    "type" : 0,
    "property" : {
      "@modelarts:color" : "#3399ff"
    },
    "count" : 5,
    "sample_count" : 5
  }, {
    "name" : "Dog",
    "type" : 0,
    "property" : {
      "@modelarts:color" : "#3399ff"
    },
    "count" : 5,
    "sample_count" : 5
  } ],
  "label_type" : "single",
  "task_type" : 0,
  "extract_serial_number" : false
}