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

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

{
  "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
  } ]
}