GetTask - Intelligent Media Management - Centro de documentación de Alibaba Cloud

Consulta la información de una tarea asíncrona especificada. Intelligent Media Management (IMM) admite diversas capacidades de procesamiento de datos asíncrono, cada una con su propia operación de creación de tareas, como CreateFigureClusteringTask para crear tareas de agrupación de figuras y CreateFileCompressionTask para crear tareas de compresión de archivos. Esta es una operación de propósito general que permite consultar los detalles de una tarea asíncrona mediante el ID y el tipo de tarea.

Descripción de la operación

Antes de utilizar esta operación, asegúrese de estar familiarizado con la facturación de Intelligent Media Management y sus precios.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

imm:GetTask

get

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ProjectName	string	Sí	El nombre del proyecto. Para obtener información sobre cómo conseguir el nombre del proyecto, consulte Crear un proyecto.	immtest
TaskType	string	Sí	El tipo de la tarea. Para consultar los valores válidos, vea Lista de tipos de tareas.	FileCompression
TaskId	string	Sí	El ID de la tarea que desea consultar. Este valor se devuelve al crear la tarea.	FileCompression-2f157087-91df-4fda-8c3e-232407ec*****
RequestDefinition	boolean	No	Especifica si se deben devolver los parámetros de solicitud originales utilizados para crear la tarea. Valores válidos: true false (valor predeterminado) Este parámetro solo surte efecto para los siguientes tipos de tareas: MediaConvert VideoLabelClassification FaceClustering FileCompression ArchiveFileInspection FileUncompression PointCloudCompress ImageToPDF StoryCreation LocationDateClustering ImageSplicing FacesSearching.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los detalles de la tarea especificada.
RequestId	string	El ID de la solicitud.	2C5C1E0F-D8B8-4DA0-8127-EC32C771****
ProjectName	string	El nombre del proyecto.	test-project
EventId	string	El ID del evento.	2F6-1Bz99Xi93EnRpNEyLudILJm****
Status	string	El estado de ejecución de la tarea. Valores válidos: Running: La tarea se está ejecutando. Succeeded: La tarea se completó. Failed: La tarea falló.	Running
Code	string	El código de error de la tarea.	ResourceNotFound
Message	string	El mensaje de error de la tarea.	The specified resource project is not found
StartTime	string	La hora en que inició la tarea. El valor es una marca de tiempo UTC en formato ISO 8601 con precisión de milisegundos.	2021-12-24T03:01:41.662060377Z
EndTime	string	La hora en que finalizó la tarea. El valor es una marca de tiempo UTC en formato ISO 8601 con precisión de milisegundos.	2021-12-24T03:01:49.480109219Z
UserData	string	La información personalizada especificada por el usuario.	{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
TaskType	string	El tipo de la tarea. Para consultar los valores válidos, vea Lista de tipos de tareas.	FileCompression
TaskId	string	El ID de la tarea.	c2b277b9-0d30-4882-ad6d-ad661382****
Tags	object	Las etiquetas de la tarea. Estas son las etiquetas que el usuario proporcionó al crear la tarea.	{"test": "val1"}
TaskRequestDefinition	string	Los parámetros de solicitud originales utilizados para crear la tarea.	{ "ProjectName":"test-project", "CompressedFormat":"zip", "TargetURI":"oss://test-bucket/output/test.zip", "Sources":[{"URI":"oss://test-bucket/input/test.jpg"}] }
Progress	integer	El progreso de la tarea. Valores válidos: de 0 a 100. Unidad: porcentaje (%). Nota La operación GetTask no admite este parámetro. Este parámetro solo tiene significado cuando el estado de la tarea `State` es `Running`.	100

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "2C5C1E0F-D8B8-4DA0-8127-EC32C771****",
  "ProjectName": "test-project",
  "EventId": "2F6-1Bz99Xi93EnRpNEyLudILJm****",
  "Status": "Running",
  "Code": "ResourceNotFound",
  "Message": "The specified resource project is not found.",
  "StartTime": "2021-12-24T03:01:41.662060377Z",
  "EndTime": "2021-12-24T03:01:49.480109219Z",
  "UserData": "{\"ID\": \"user1\",\"Name\": \"test-user1\",\"Avatar\": \"http://example.com?id=user1\"}",
  "TaskType": "FileCompression",
  "TaskId": "c2b277b9-0d30-4882-ad6d-ad661382****",
  "Tags": {
    "test": "val1"
  },
  "TaskRequestDefinition": "{\n\t\"ProjectName\":\"test-project\",\n\t\"CompressedFormat\":\"zip\",\n\t\"TargetURI\":\"oss://test-bucket/output/test.zip\",\n\t\"Sources\":[{\"URI\":\"oss://test-bucket/input/test.jpg\"}]\n}",
  "Progress": 100
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.