DescribeTasks - : Central de Documentação do Alibaba Cloud

Consulta o progresso de uma ou mais solicitações assíncronas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeTasks	A operação que você deseja executar. Defina o valor como DescribeTasks.
PageNumber	Integer	Não	1	O número da página a ser retornada. A numeração começa na página 1. Valor padrão: 1.
PageSize	Integer	Não	10	O número de entradas a serem retornadas em cada página. Valor máximo: 100. Valor padrão: 10.
RegionId	String	Sim	cn-hangzhou	O ID da região da tarefa. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.
TaskIds	String	Não	t-bp1hvgwromzv32iq**,t-bp179lofu2pv768w**	O ID da tarefa. É possível especificar até 100 IDs de tarefa por vez. Separe os IDs de tarefa com vírgulas (,).
TaskAction	String	Não	ImportImage	O nome da operação que gera a tarefa. Valores válidos: ImportImage ExportImage RedeployInstance ModifyDiskSpec
TaskStatus	String	Não	Finished	O estado da tarefa. Valores válidos: Finished Processing Failed Este parâmetro está vazio por padrão. Nota O sistema recupera apenas tarefas nos estados Finished, Processing e Failed e ignora outros valores.
StartTime	String	Não	2020-11-23T15:10:00Z	O ponto inicial do período de tempo para consultar as tarefas criadas. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
EndTime	String	Não	2020-11-23T15:16:00Z	O ponto final do período de tempo para consultar as tarefas criadas. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
ResourceIds.N	String	Não	m-bp1i8huqm5u7****	O ID do recurso N associado à tarefa. Valores válidos de N: 1 a 100. Se TaskAction estiver definido como ImportImage ou ExportImage, defina o ID do recurso como um ID de imagem. Se TaskAction estiver definido como RedeployInstance, defina o ID do recurso como um ID de instância do Elastic Compute Service (ECS). Se TaskAction estiver definido como ModifyDiskSpec, defina o ID do recurso como um ID de disco.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	O número de entradas retornadas por página.
PageNumber	Integer	1	O número da página retornada.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
TotalCount	Integer	1	O número total de entradas retornadas.
RegionId	String	cn-hangzhou	O ID da região da tarefa.
TaskSet	Array of Task		Detalhes sobre as tarefas.
Task
CreationTime	String	2020-11-24T12:50Z	O horário em que a tarefa foi criada.
TaskStatus	String	Finished	O estado da tarefa.
FinishedTime	String	2020-11-24T12:50Z	O horário em que a tarefa foi concluída.
SupportCancel	String	true	Indica se a tarefa pode ser cancelada.
TaskId	String	t-bp1hvgwromzv32iq****	O ID da tarefa.
TaskAction	String	ImportImage	O nome da tarefa.
ResourceId	String	m-bp1i8huqm5u7****	O ID do recurso.

Exemplos

Solicitações de exemplo

http(s)://ecs.aliyuncs.com/?Action=DescribeTasks
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&TaskIds=t-bp1hvgwromzv32iq****
&TaskAction=ImportImage
&TaskStatus=Finished
&StartTime=2020-11-23T15:10:00Z
&EndTime=2020-11-23T15:16:00Z
&Common request parameters

Respostas de sucesso de exemplo

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTasksResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <TaskSet>
        <Task>
            <TaskId>t-bp1hvgwromzv32iq****</TaskId>
            <TaskAction>ImportImage</TaskAction>
            <SupportCancel>true</SupportCancel>
            <CreationTime>2020-11-24T12:50Z</CreationTime>
            <TaskStatus>Finished</TaskStatus>
            <FinishedTime>2020-11-24T12:50Z</FinishedTime>
        </Task>
    </TaskSet>
    <RegionId>cn-hangzhou</RegionId>
</DescribeTasksResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "PageNumber" : 1,
  "TaskSet" : {
    "Task" : [ {
      "TaskId" : "t-bp1hvgwromzv32iq****",
      "TaskAction" : "ImportImage",
      "SupportCancel" : true,
      "CreationTime" : "2020-11-24T12:50Z",
      "TaskStatus" : "Finished",
      "FinishedTime" : "2020-11-24T12:50Z"
    } ]
  },
  "RegionId" : "cn-hangzhou"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	A mensagem de erro é retornada porque o parâmetro RegionId especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.