GetTask - Intelligent Media Management: Central de Documentação do Alibaba Cloud

Consulta as informações sobre uma tarefa assíncrona especificada. O Intelligent Media Management (IMM) oferece suporte a vários recursos de processamento de dados assíncronos, cada um com sua própria operação de criação de tarefa, como CreateFigureClusteringTask para criar tarefas de clustering de figuras e CreateFileCompressionTask para criar tarefas de compactação de arquivos. Esta é uma operação de uso geral que permite consultar os detalhes de uma tarefa assíncrona pelo ID e tipo da tarefa.

Descrição da operação

Antes de usar esta operação, certifique-se de estar familiarizado com a cobrança do Intelligent Media Management e seus preços.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

imm:GetTask

get

*Project

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProjectName	string	Sim	O nome do projeto. Para obter informações sobre como obter o nome do projeto, consulte Criar um projeto.	immtest
TaskType	string	Sim	O tipo da tarefa. Para valores válidos, consulte Lista de tipos de tarefa.	FileCompression
TaskId	string	Sim	O ID da tarefa que você deseja consultar. Este valor é retornado quando você cria a tarefa.	FileCompression-2f157087-91df-4fda-8c3e-232407ec*****
RequestDefinition	boolean	Não	Especifica se devem ser retornados os parâmetros de solicitação originais usados para criar a tarefa. Valores válidos: true false (padrão) Este parâmetro entra em vigor apenas para os seguintes tipos de tarefa: MediaConvert VideoLabelClassification FaceClustering FileCompression ArchiveFileInspection FileUncompression PointCloudCompress ImageToPDF StoryCreation LocationDateClustering ImageSplicing FacesSearching.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os detalhes da tarefa especificada.
RequestId	string	O ID da solicitação.	2C5C1E0F-D8B8-4DA0-8127-EC32C771****
ProjectName	string	O nome do projeto.	test-project
EventId	string	O ID do evento.	2F6-1Bz99Xi93EnRpNEyLudILJm****
Status	string	O status de execução da tarefa. Valores válidos: Running: A tarefa está em execução. Succeeded: A tarefa foi concluída. Failed: A tarefa falhou.	Running
Code	string	O código de erro da tarefa.	ResourceNotFound
Message	string	A mensagem de erro da tarefa.	The specified resource project is not found.
StartTime	string	A hora em que a tarefa começou. O valor é um carimbo de data e hora UTC no formato ISO 8601 com precisão de milissegundos.	2021-12-24T03:01:41.662060377Z
EndTime	string	A hora em que a tarefa terminou. O valor é um carimbo de data e hora UTC no formato ISO 8601 com precisão de milissegundos.	2021-12-24T03:01:49.480109219Z
UserData	string	As informações personalizadas especificadas pelo usuário.	{"ID": "user1","Name": "test-user1","Avatar": "http://example.com?id=user1"}
TaskType	string	O tipo da tarefa. Para valores válidos, consulte Lista de tipos de tarefa.	FileCompression
TaskId	string	O ID da tarefa.	c2b277b9-0d30-4882-ad6d-ad661382****
Tags	object	As tags da tarefa. Estas são as tags que o usuário transmitiu ao criar a tarefa.	{"test": "val1"}
TaskRequestDefinition	string	Os parâmetros de solicitação originais usados para criar a tarefa.	{ "ProjectName":"test-project", "CompressedFormat":"zip", "TargetURI":"oss://test-bucket/output/test.zip", "Sources":[{"URI":"oss://test-bucket/input/test.jpg"}] }
Progress	integer	O progresso da tarefa. Valores válidos: 0 a 100. Unidade: porcentagem (%). Nota A operação GetTask não oferece suporte a este parâmetro. Este parâmetro é significativo apenas quando o status da tarefa `State` é `Running`.	100

Exemplos

Resposta de sucesso

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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.