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/ Tarea de exportación de datos/ Consulta de la lista de tareas de exportación de conjunto de datos
Actualización más reciente 2022-11-14 GMT+08:00
Ver PDF
Compartir

Consulta de la lista de tareas de exportación de conjunto de datos

Función

Esta API se utiliza para consultar la lista de tareas de exportación del conjunto de datos por página.

URI

GET /v2/{project_id}/datasets/{dataset_id}/export-tasks

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

export_type

No

Integer

Tipo de exportación. Si no se especifica este parámetro, todos los tipos de tareas de exportación se consultan de forma predeterminada. Opciones:

  • 0: etiquetado
  • 1: sin etiquetar
  • 2: todos
  • 3: búsqueda condicional

limit

No

Integer

Número máximo de registros devueltos en cada página. El valor varía de 1 a 100. El valor predeterminado es 10.

offset

No

Integer

Página de inicio de la lista de paginación. El valor predeterminado es 0.

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

create_time

Long

Hora en la que se crea una tarea.

error_code

String

Código de error.

error_msg

String

Mensaje de error.

export_format

Integer

Formato del directorio exportado. Opciones:

  • 1: estructura de árbol. Por ejemplo: cat/1.jpg,dog/2.jpg.
  • 2: estructura de mosaico. Por ejemplo: 1.jpg, 1.txt; 2.jpg,2.txt.

export_params

ExportParams object

Parámetros de una tarea de exportación de conjunto de datos.

export_tasks

Array of ExportTaskStatusResp objects

Exportar lista de tareas

export_type

Integer

Tipo de exportación. Opciones:

  • 0: etiquetado
  • 1: sin etiquetar
  • 2: todos
  • 3: búsqueda condicional

finished_sample_count

Integer

Número de muestras completadas.

path

String

Exportar ruta de salida.

progress

Float

Porcentaje del progreso de la tarea actual.

status

String

Estado de la tarea.

task_id

String

ID de tarea.

total_count

Integer

Número total de tareas de exportación

total_sample_count

Integer

Número total de muestras.

update_time

Long

Hora en la que se actualiza una tarea.

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.
Tabla 4 ExportParams

Parámetro

Tipo

Descripción

clear_hard_property

Boolean

Si se deben borrar los atributos de ejemplo duro. Opciones:

  • true: Borrar atributos de ejemplo duro. (Valor predeterminado)
  • false: No borrar los atributos de ejemplo duro.

export_dataset_version_format

String

Formato de la versión del conjunto de datos a la que se exportan los datos.

export_dataset_version_name

String

Nombre de la versión del conjunto de datos a la que se exportan los datos.

export_dest

String

Destino de exportación. Opciones:

  • DIR: Exportar datos a OBS. (Valor predeterminado)
  • NEW_DATASET: Exportar datos a un nuevo conjunto de datos.

export_new_dataset_name

String

Nombre del nuevo conjunto de datos al que se exportan los datos.

export_new_dataset_work_path

String

Directorio de trabajo del nuevo conjunto de datos al que se exportan los datos.

ratio_sample_usage

Boolean

Si se asigna aleatoriamente el conjunto de entrenamiento y el conjunto de validación en función de la relación especificada. Opciones:

  • true: Asigne el conjunto de entrenamiento y el conjunto de validación.
  • false: no asigne el conjunto de entrenamiento y el conjunto de validación. (Valor predeterminado)

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 revisados 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

samples

Array of strings

Lista de ID de muestras exportadas.

search_conditions

Array of SearchCondition objects

Condiciones de búsqueda exportadas. La relación entre múltiples condiciones de búsqueda es O.

train_sample_ratio

String

Relación de división entre el conjunto de entrenamiento y el conjunto de verificación durante la liberación de la versión especificada. El valor predeterminado es 1.00, lo que indica que todas las versiones publicadas son conjuntos de entrenamiento.
Tabla 5 ExportTaskStatusResp

Parámetro

Tipo

Descripción

create_time

Long

Hora en la que se crea una tarea.

error_code

String

Código de error.

error_msg

String

Mensaje de error.

export_format

Integer

Formato del directorio exportado. Opciones:

  • 1: estructura de árbol. Por ejemplo: cat/1.jpg,dog/2.jpg.
  • 2: estructura de mosaico. Por ejemplo: 1.jpg, 1.txt; 2.jpg,2.txt.

export_params

ExportParams object

Parámetros de una tarea de exportación de conjunto de datos.

export_type

Integer

Tipo de exportación. Opciones:

  • 0: etiquetado
  • 1: sin etiquetar
  • 2: todos
  • 3: búsqueda condicional

finished_sample_count

Integer

Número de muestras completadas.

path

String

Exportar ruta de salida.

progress

Float

Porcentaje del progreso de la tarea actual.

status

String

Estado de la tarea.

task_id

String

ID de tarea.

total_sample_count

Integer

Número total de muestras.

update_time

Long

Hora en la que se actualiza una tarea.

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.
Tabla 6 SearchCondition

Parámetro

Tipo

Descripción

coefficient

String

Filtrar por coeficiente de dificultad.

frame_in_video

Integer

Un cuadro en el vídeo.

hard

String

Si una muestra es una muestra dura. Opciones:

  • 0: muestra no dura
  • 1: muestra dura

import_origin

String

Filtrar por origen de datos.

kvp

String

Dosificación de CT, filtrada por dosificación.

label_list

SearchLabels object

Criterios de búsqueda de etiquetas.

labeler

String

Etiquetadora.

metadata

SearchProp object

Búsqueda por atributo de muestra.

parent_sample_id

String

ID de la muestra principal.

sample_dir

String

Directorio donde se almacenan muestras de datos (el directorio debe terminar con una barra diagonal (/)). Solo se buscan ejemplos en el directorio especificado. No se admite la búsqueda recursiva de directorios.

sample_name

String

Buscar por nombre de ejemplo, incluida la extensión del nombre de archivo.

sample_time

String

Cuando se agrega una muestra al conjunto de datos, se crea un índice basado en la última hora de modificación (exacta al día) de la muestra en OBS. Puede buscar la muestra en función de la hora. Opciones:- month: Búsqueda de muestras agregadas desde hace 30 días al día actual.- day: Búsqueda de muestras agregadas desde ayer (hace un día) al día actual.- yyyyMMdd-yyyyMMdd: Búsqueda de muestras agregadas en un período especificado (como máximo 30 días), en el formato de Start date-End date. Por ejemplo, 20190901-2019091501 indica que se buscan muestras generadas del 1 de septiembre al 15 de septiembre de 2019.

score

String

Búsqueda por confianza.

slice_thickness

String

Espesor de capa DICOM. Las muestras se filtran por el espesor de la capa.

study_date

String

Tiempo de escaneo DICOM.

time_in_video

String

Un punto de tiempo en el video.
Tabla 7 SearchLabels

Parámetro

Tipo

Descripción

labels

Array of SearchLabel objects

Lista de criterios de búsqueda de etiquetas.

op

String

Si desea buscar varias etiquetas, debe especificarse op. Si busca solo una etiqueta, op puede dejarse en blanco. Opciones:

  • OR: operación O
  • AND: operación Y
Tabla 8 SearchLabel

Parámetro

Tipo

Descripción

name

String

Nombre de la etiqueta.

op

String

Tipo de operación entre múltiples atributos. Opciones:

  • OR: operación O
  • AND: operación Y

property

Map<String,Array<String>>

El atributo de etiqueta que tiene el formato Object y almacena todos los pares clave-valor. key indica el nombre del atributo y value indica la lista de valores. Si value es null, la búsqueda no se realiza por valor. De lo contrario, el valor de búsqueda puede ser cualquier valor de la lista.

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 9 SearchProp

Parámetro

Tipo

Descripción

op

String

Relación entre valores de atributo. Opciones:

  • AND: relación Y
  • OR: Relación O

props

Map<String,Array<String>>

Criterios de búsqueda de un atributo. Se pueden establecer varios criterios de búsqueda.

Solicitudes de ejemplo

Consulta de la lista de tareas de exportación por página

GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/export-tasks

Ejemplo de respuestas

Código de estado: 200

OK

{
  "total_count" : 2,
  "export_tasks" : [ {
    "task_id" : "rF9NNoB56k5rtYKg2Y7",
    "path" : "/test-obs/classify/input/",
    "export_type" : 3,
    "version_format" : "Default",
    "export_format" : 2,
    "export_params" : {
      "sample_state" : "",
      "export_dest" : "NEW_DATASET",
      "export_new_dataset_name" : "dataset-export-test",
      "export_new_dataset_work_path" : "/test-obs/classify/output/",
      "clear_hard_property" : true,
      "train_sample_ratio" : 1.0,
      "ratio_sample_usage" : false
    },
    "status" : "SUCCESSED",
    "progress" : 100.0,
    "total_sample_count" : 20,
    "finished_sample_count" : 20,
    "create_time" : 1606103820120,
    "update_time" : 1606103824823
  }, {
    "task_id" : "TZMuy7OKbClkGCAc3gb",
    "path" : "/test-obs/daoChu/",
    "export_type" : 3,
    "version_format" : "Default",
    "export_format" : 2,
    "export_params" : {
      "sample_state" : "",
      "export_dest" : "DIR",
      "clear_hard_property" : true,
      "clear_difficult" : false,
      "train_sample_ratio" : 1.0,
      "ratio_sample_usage" : false
    },
    "status" : "SUCCESSED",
    "progress" : 100.0,
    "total_sample_count" : 20,
    "finished_sample_count" : 20,
    "create_time" : 1606103424662,
    "update_time" : 1606103497519
  } ]
}

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.