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

Consulta de la lista de tareas de procesamiento

Función

Esta API se utiliza para consultar la lista de tareas de procesamiento. Puede consultar las tareas de análisis de características y las tareas de procesamiento de datos. Puede especificar el parámetro task_type para consultar la lista de un tipo específico de tareas.- Análisis de características se refiere al proceso de análisis de las características de una imagen basada en la imagen o cuadro de destino, como el grado de desenfoque y el brillo, y dibujar una curva visualizada para ayudar a procesar el conjunto de datos.- El procesamiento de datos se refiere a la extracción o generación de datos que son valiosos y significativos para una persona en particular a partir de una gran cantidad de datos desordenados e incomprensibles. El procesamiento de datos incluye validación de datos, limpieza de datos, selección de datos y aumento de datos. * La validación de datos indica que el conjunto de datos se verifica para garantizar la exactitud de los datos. * La limpieza de datos se refiere al proceso de eliminación de ruido, corrección o complementación de datos. * La selección de datos indica el proceso de selección de subconjuntos de datos desde datos completos. * El aumento de datos indica que el volumen de datos aumenta a través de operaciones simples de amplificación de datos como escalado, recorte, transformación y composición.

URI

GET /v2/{project_id}/processor-tasks

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

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

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.

order

No

String

Secuencia de clasificación de la consulta. Opciones:

  • asc: orden ascendente
  • desc: orden descendente (valor predeterminado)

query_current

No

Boolean

Si desea consultar solo las tareas más recientes de la versión del conjunto de datos. Opciones:

  • true: consulta solo las tareas más recientes de la versión del conjunto de datos.
  • false: consulta todas las tareas de la versión del conjunto de datos. (Valor predeterminado)

return_result

No

Boolean

Si se devuelve el resultado de la tarea. Opciones:

  • true: Devuelve el resultado de la tarea. (Valor predeterminado)
  • false: no devuelve el resultado de la tarea.

sort_by

No

String

Modo de clasificación de la consulta. Opciones:

  • create_time: Ordenar por hora de creación. (Valor predeterminado)
  • name: Ordenar por nombre de tarea.
  • duration_seconds: Ordenar por tiempo de ejecución.

source

No

String

Ruta de origen de datos de la consulta. Opciones:

  • Si type se establece en OBS, source es una ruta de acceso de OBS.
  • Si type se establece en TASK, source es un ID de tarea.
  • Si type se establece en DATASET, source es un ID de conjunto de datos.
  • Si type se establece en CUSTOM y los inquilinos de recursos llaman a la API, establezca source en project_id del usuario real. De lo contrario, este campo se deja en blanco.

source_type

No

String

Tipo de origen de datos de la consulta. Si no se especifica este parámetro, todos los orígenes de datos se consultan de forma predeterminada. Opciones:

  • OBS: Datos obtenidos de OBS
  • TASK: Tarea de procesamiento de datos
  • DATASET: Conjunto de datos
  • CUSTOM: Datos llamados por los inquilinos del recurso

status

No

Integer

Estado de la tarea de la consulta. Si no se especifica este parámetro, las tareas en todos los estados se consultan de forma predeterminada. Opciones:

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

task_name

No

String

Palabra clave de búsqueda difusa.

task_type

No

String

Tipo de tarea, es decir, ID de una plantilla de procesamiento de datos. Opciones:

  • sys_data_analyse: análisis de características
  • sys_data_cleaning: limpieza de datos
  • sys_data_augmentation: aumento de datos
  • sys_data_validation: validación de datos
  • sys_data_selección: selección de datos

version_id

No

Array

Lista de ID de versión de un conjunto de datos específico de la consulta.

workspace_id

No

String

ID del espacio de trabajo. Si no se crea ningún espacio de trabajo, el valor predeterminado es 0. Si se crea y utiliza un espacio de trabajo, utilice el valor real.

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

count

Integer

Número total de tareas de procesamiento de datos.

tasks

Array of DescribeProcessorTaskResp objects

Lista de tareas de procesamiento de datos consultada por página.
Tabla 4 DescribeProcessorTaskResp

Parámetro

Tipo

Descripción

create_time

Long

Hora en que se crea una tarea de procesamiento de datos.

data_source

ProcessorDataSource object

Entrada de una tarea de procesamiento de datos. Se entregan este parámetro o inputs.

description

String

Descripción de una tarea de procesamiento de datos.

duration_seconds

Integer

Tiempo de ejecución del procesamiento de datos, en segundos.

error_msg

String

Mensaje de error. Este campo se muestra cuando el valor de status es 3.

inputs

Array of ProcessorDataSource objects

Lista de canales de entrada de una tarea de procesamiento de datos. Se entrega este parámetro o data_source.

is_current

Boolean

Si la tarea actual es la más reciente del mismo tipo de esta versión.

name

String

Nombre de una tarea de procesamiento de datos.

result

Object

Resultado de salida de una tarea de procesamiento de datos. Este campo se muestra cuando el estado se establece en 2 y es válido para una tarea de análisis de características.

status

Integer

Estado de una tarea de procesamiento de datos. Opciones:

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

task_id

String

ID de una tarea de procesamiento de datos.

template

TemplateParam object

Plantilla de procesamiento de datos, como el ID del algoritmo y los parámetros.

version_count

Integer

Número de versión de una tarea de procesamiento de datos.

version_id

String

ID de versión de conjunto de datos correspondiente a una tarea de procesamiento de datos.

version_name

String

Nombre de la versión del conjunto de datos correspondiente a una tarea de procesamiento de datos.

work_path

WorkPath object

Directorio de trabajo de una tarea de procesamiento de datos.

workspace_id

String

ID de espacio de trabajo de una tarea de procesamiento de datos. Si no se crea ningún espacio de trabajo, el valor predeterminado es 0. Si se crea y utiliza un espacio de trabajo, utilice el valor real.
Tabla 5 ProcessorDataSource

Parámetro

Tipo

Descripción

name

String

Nombre del conjunto de datos.

source

String

Ruta de origen de datos. Opciones:

  • Si type se establece en OBS, source es una ruta de acceso de OBS.
  • Si type se establece en TASK, source es un ID de tarea.
  • Si type se establece en DATASET, source es un ID de conjunto de datos.
  • Si type se establece en CUSTOM y los inquilinos de recursos llaman a la API, establezca source en project_id del usuario real. De lo contrario, este campo se deja en blanco.

type

String

Tipo de origen de datos. Opciones:

  • OBS: Datos obtenidos de OBS
  • TASK: Tarea de procesamiento de datos
  • DATASET: Conjunto de datos
  • CUSTOM: Datos llamados por los inquilinos del recurso

version_id

String

Versión de un conjunto de datos.

version_name

String

Nombre de la versión del conjunto de datos.
Tabla 6 TemplateParam

Parámetro

Tipo

Descripción

id

String

Tipo de tarea, es decir, ID de una plantilla de procesamiento de datos. Opciones:

  • sys_data_analyse: análisis de características
  • sys_data_cleaning: limpieza de datos
  • sys_data_augmentation: aumento de datos
  • sys_data_validation: validación de datos
  • sys_data_selección: selección de datos

name

String

Nombre de la plantilla.

operator_params

Array of OperatorParam objects

Lista de parámetros del operador.
Tabla 7 OperatorParam

Parámetro

Tipo

Descripción

advanced_params_switch

Boolean

Conmutador de parámetros avanzado.

id

String

ID de un operador.

name

String

Nombre del operador.

params

Object

Parámetro del operador. El tipo de parámetro es map<string,object>. Actualmente, el objeto sólo admite los tipos de Boolean, Integer, Long, String, List y Map<String,String>. Para dos escenarios especiales de detección de objetos y clasificación de imágenes en una tarea de preprocesamiento de datos, el valor de task_type es object_detection o image_classification.
Tabla 8 WorkPath

Parámetro

Tipo

Descripción

name

String

Nombre del conjunto de datos.

output_path

String

Ruta de salida.

path

String

Ruta de trabajo. Opciones:

  • Si type se establece en OBS, source es una ruta de acceso de OBS.
  • Si type se establece en DATASET, source es un ID de conjunto de datos.

Tipo

String

Tipo de una ruta de trabajo. Opciones:

  • OBS: Ruta OBS
  • DATASET: Conjunto de datos

version_id

String

Versión de un conjunto de datos.

version_name

String

Nombre de una versión de conjunto de datos. El valor puede contener de 0 a 32 caracteres. Solo se permiten dígitos, letras, guiones bajos (_) y guiones (-).

Solicitudes de ejemplo

  • Consulta de la lista histórica de tareas de análisis de elementos de un conjunto de datos 
    GET https://{endpoint}/v2/{project_id}/processor-tasks?offset=0&limit=10&sort_by=create_time&order=desc&source_type=DATASET&source=X6c3N3eztX7cr3Arvqu&task_type=sys_data_analyse&return_result=false&query_current=false
  • Consulta del resultado más reciente de la tarea de análisis de elementos para la lista de versiones especificadas de un conjunto de datos 
    GET https://{endpoint}/v2/{project_id}/processor-tasks?offset=0&limit=100&source_type=DATASET&source=X6c3N3eztX7cr3Arvqu&version_id=XwTuRqI9En7xuZskW70%2CJ4Eh2FDEWH1qnDlD3hQ&task_type=sys_data_analyse&return_result=true&query_current=true

Ejemplo de respuestas

Código de estado: 200

OK

{
  "count" : 1,
  "tasks" : [ {
    "task_id" : "ddwRJeTnjpiq4dNUZOq",
    "name" : "V001",
    "data_source" : {
      "type" : "DATASET",
      "source" : "X6c3N3eztX7cr3Arvqu"
    },
    "inputs" : [ {
      "type" : "DATASET",
      "source" : "X6c3N3eztX7cr3Arvqu"
    } ],
    "template" : {
      "id" : "sys_data_analyse",
      "name" : "data analyse template name",
      "operator_params" : [ {
        "id" : "sys_data_analyse",
        "params" : {
          "op_list" : [ ],
          "task_type" : "image_classification",
          "manifest_path" : "s3://test-obs/classify/output/dataset-3026-X6c3N3eztX7cr3Arvqu/annotation/V001/V001.manifest",
          "file_path" : "s3://test-obs/classify/output/dataset-3026-X6c3N3eztX7cr3Arvqu/annotation/evaluation/V001",
          "is_normed" : false
        }
      } ]
    },
    "status" : 2,
    "duration_seconds" : 11,
    "create_time" : 1606372570023,
    "version_id" : "J4Eh2FDEWH1qnDlD3hQ",
    "version_name" : "V001",
    "is_current" : true
  } ]
}

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.

Tema principal: Tarea de procesamiento