DescribeTasks - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d’appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeTasks	Opération à effectuer. Définissez la valeur sur DescribeTasks.
PageNumber	Integer	Non	1	Numéro de la page à renvoyer. La numérotation commence à partir de la page 1. Valeur par défaut : 1.
PageSize	Integer	Non	10	Nombre d’entrées à renvoyer par page. Valeur maximale : 100. Valeur par défaut : 10.
RegionId	String	Oui	cn-hangzhou	ID de région de la tâche. Appelez l’opération DescribeRegions pour obtenir la liste des régions la plus récente.
TaskIds	String	Non	t-bp1hvgwromzv32iq**,t-bp179lofu2pv768w**	ID de la tâche. Vous pouvez spécifier jusqu’à 100 ID de tâche simultanément. Séparez les ID de tâche par des virgules (,).
TaskAction	String	Non	ImportImage	Nom de l’opération qui génère la tâche. Valeurs possibles : ImportImage ExportImage RedeployInstance ModifyDiskSpec
TaskStatus	String	Non	Finished	État de la tâche. Valeurs possibles : Finished Processing Failed Ce paramètre est vide par défaut. Remarque Le système récupère uniquement les tâches dont l’état est Finished, Processing ou Failed, et ignore les autres valeurs.
StartTime	String	Non	2020-11-23T15:10:00Z	Début de la période de recherche des tâches créées. L’heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L’heure est exprimée en UTC.
EndTime	String	Non	2020-11-23T15:16:00Z	Fin de la période de recherche des tâches créées. L’heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L’heure est exprimée en UTC.
ResourceIds.N	String	Non	m-bp1i8huqm5u7****	ID de la ressource N associée à la tâche. Valeurs possibles pour N : 1 à 100. Si TaskAction est défini sur ImportImage ou ExportImage, indiquez un ID d’image. Si TaskAction est défini sur RedeployInstance, indiquez un ID d’instance Elastic Compute Service (ECS). Si TaskAction est défini sur ModifyDiskSpec, indiquez un ID de disque.

Paramètres de réponse

Paramètre	Type	Exemple	Description
PageSize	Integer	10	Nombre d’entrées renvoyées par page.
PageNumber	Integer	1	Numéro de la page renvoyée.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
TotalCount	Integer	1	Nombre total d’entrées renvoyées.
RegionId	String	cn-hangzhou	ID de région de la tâche.
TaskSet	Array of Task		Détails des tâches.
Task
CreationTime	String	2020-11-24T12:50Z	Date et heure de création de la tâche.
TaskStatus	String	Finished	État de la tâche.
FinishedTime	String	2020-11-24T12:50Z	Date et heure de fin de la tâche.
SupportCancel	String	true	Indique si la tâche peut être annulée.
TaskId	String	t-bp1hvgwromzv32iq****	ID de la tâche.
TaskAction	String	ImportImage	Nom de la tâche.
ResourceId	String	m-bp1i8huqm5u7****	ID de la ressource.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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 format

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"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Le message d'erreur renvoyé car le paramètre RegionId spécifié n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.