DescribeTask - Backup and Disaster Recovery Center: Central de Documentação do Alibaba Cloud

Obtém os detalhes de uma tarefa assíncrona.

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

bdrc:DescribeTask

none

*All Resource

*

Nenhuma

Sintaxe da solicitação

GET /api/v1/tasks/{TaskId} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TaskId	string	Sim	O ID da tarefa. Você pode chamar a operação DescribeTasks para obter os IDs das tarefas.	t-0004d9ctt1ii********

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
Data	object	Os dados retornados.
TaskId	string	O ID da tarefa.	t-xxxxxxxx
TaskName	string	O nome da tarefa.	test5566
TaskDescription	string	A descrição da tarefa.	empty
TaskType	string	O tipo de tarefa. Valores válidos: UPDATE_RESOURCES (atualiza recursos e seus status) e CHECK_RULES.	UPDATE_RESOURCES
TaskPriority	string	A prioridade da tarefa. Valores válidos: HIGH (geralmente para tarefas iniciadas pelo usuário) e LOW (geralmente para tarefas em segundo plano).	HIGH
RequestId	string	O ID da solicitação.	784076D6-BD6D-5564-9CEA-834EB11F0C62
TaskDetail	string	Os detalhes da execução da tarefa.	{"resourceTypes":["ACS::ECS::Instance","ACS::OSS::Bucket","ACS::OTS::Instance","ACS::NAS::FileSystem"]}
ExecutionId	string	O ID da execução. Este parâmetro foi descontinuado e sempre retorna uma string vazia.	empty
Progress	integer	O progresso da tarefa, medido em uma escala de 0 a 10.000.	100
TaskStatus	string	O status da tarefa. Valores válidos: CREATED (Criado), RUNNING (Em execução), COMPLETE (Concluído), FAILED (Com falha), EXPIRED (Expirado) e CANCELED (Cancelado).	RUNNING
ErrorMessage	string	A mensagem de erro retornada se a tarefa falhar.	too many requests.
StartTime	integer	A hora de início, formatada como um timestamp Unix em segundos.	1724983927
CompleteTime	integer	A hora de conclusão, formatada como um timestamp Unix em segundos.	1724983927
ExpireTime	integer	A hora de expiração, formatada como um timestamp Unix em segundos.	1719026680
TaskResult	string	The result of the task.	{"resourceCounts":[{"resourceType":"ACS::OSS::Bucket","count":2},{"resourceType":"ACS::NAS::FileSystem","count":3}]}
RequestId	string	O ID da solicitação.	14DFF801-A4E3-5136-AAB8-7D246012CD7A

Exemplos

Resposta de sucesso

JSON formato

{
  "Data": {
    "TaskId": "t-xxxxxxxx",
    "TaskName": "test5566",
    "TaskDescription": " empty",
    "TaskType": "UPDATE_RESOURCES",
    "TaskPriority": "HIGH",
    "RequestId": "784076D6-BD6D-5564-9CEA-834EB11F0C62",
    "TaskDetail": "{\"resourceTypes\":[\"ACS::ECS::Instance\",\"ACS::OSS::Bucket\",\"ACS::OTS::Instance\",\"ACS::NAS::FileSystem\"]}",
    "ExecutionId": " empty",
    "Progress": 100,
    "TaskStatus": "RUNNING",
    "ErrorMessage": "too many requests.",
    "StartTime": 1724983927,
    "CompleteTime": 1724983927,
    "ExpireTime": 1719026680,
    "TaskResult": "{\"resourceCounts\":[{\"resourceType\":\"ACS::OSS::Bucket\",\"count\":2},{\"resourceType\":\"ACS::NAS::FileSystem\",\"count\":3}]}"
  },
  "RequestId": "14DFF801-A4E3-5136-AAB8-7D246012CD7A"
}

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.