DescribeTasks - - Centro de documentación de Alibaba Cloud

Consulta el progreso de una o más solicitudes asíncronas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeTasks	La operación que desea ejecutar. Establezca el valor en DescribeTasks.
PageNumber	Integer	No	1	El número de la página que se devuelve. La numeración de las páginas comienza en la página 1. Valor predeterminado: 1.
PageSize	Integer	No	10	El número de entradas que se devuelven en cada página. Valor máximo: 100. Valor predeterminado: 10.
RegionId	String	Sí	cn-hangzhou	El ID de la región de la tarea. Para consultar la lista de regiones más reciente, llame a la operación DescribeRegions.
TaskIds	String	No	t-bp1hvgwromzv32iq**,t-bp179lofu2pv768w**	El ID de la tarea. Especifique hasta 100 ID de tarea a la vez. Separe los ID de tarea con comas (,).
TaskAction	String	No	ImportImage	El nombre de la operación que genera la tarea. Valores válidos: ImportImage ExportImage RedeployInstance ModifyDiskSpec
TaskStatus	String	No	Finished	El estado de la tarea. Valores válidos: Finished Processing Failed Este parámetro está vacío de forma predeterminada. Nota El sistema solo recupera las tareas en los estados Finished, Processing y Failed, e ignora otros valores.
StartTime	String	No	2020-11-23T15:10:00Z	El punto de inicio del período en el que se consultan las tareas creadas. La hora sigue el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mm:ssZ. La hora se muestra en UTC.
EndTime	String	No	2020-11-23T15:16:00Z	El punto final del período en el que se consultan las tareas creadas. La hora sigue el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mm:ssZ. La hora se muestra en UTC.
ResourceIds.N	String	No	m-bp1i8huqm5u7****	El ID del recurso N asociado a la tarea. Valores válidos de N: 1 a 100. Si TaskAction tiene el valor ImportImage o ExportImage, establezca el ID del recurso en un ID de imagen. Si TaskAction tiene el valor RedeployInstance, establezca el ID del recurso en un ID de instancia de Elastic Compute Service (ECS). Si TaskAction tiene el valor ModifyDiskSpec, establezca el ID del recurso en un ID de disco.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
PageSize	Integer	10	El número de entradas que se devuelven por página.
PageNumber	Integer	1	El número de la página que se devuelve.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
TotalCount	Integer	1	El número total de entradas que se devuelven.
RegionId	String	cn-hangzhou	El ID de la región de la tarea.
TaskSet	Array of Task		Detalles sobre las tareas.
Task
CreationTime	String	2020-11-24T12:50Z	La hora en que se creó la tarea.
TaskStatus	String	Finished	El estado de la tarea.
FinishedTime	String	2020-11-24T12:50Z	La hora en que se completó la tarea.
SupportCancel	String	true	Indica si se puede cancelar la tarea.
TaskId	String	t-bp1hvgwromzv32iq****	El ID de la tarea.
TaskAction	String	ImportImage	El nombre de la tarea.
ResourceId	String	m-bp1i8huqm5u7****	El ID del recurso.

Ejemplos

Solicitudes de ejemplo

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

Respuestas correctas de ejemplo

Formato XML

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>

Formato JSON

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidRegionId.NotFound	El RegionId especificado no existe.	El mensaje de error que se devuelve porque el parámetro RegionId especificado no existe.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.