ListClusterJobs - AWS Snowball
Syntaxe de la demandeParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ListClusterJobs

Renvoie un tableau deJobListEntryobjets de la longueur spécifiée. EACHJobListEntryobjet est destiné à une tâche dans le cluster spécifié et contient l'état d'une tâche, l'ID d'une tâche et d'autres informations.

Syntaxe de la demande

{
   "ClusterId": "string",
   "MaxResults": number,
   "NextToken": "string"
}

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voirParamètres courants.

Cette demande accepte les données suivantes au format JSON.

ClusterId

L'ID de 39 caractères du cluster que vous souhaitez répertorier, par exempleCID123e4567-e89b-12d3-a456-426655440000.

Type : Chaîne

Contraintes de longueur : Longueur fixe de 39.

Modèle : CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obligatoire Oui

MaxResults

Le nombre d'JobListEntryobjets à renvoyer.

Type : Entier

Plage valide : La valeur minimale est 0. Valeur maximale fixée à 100.

Obligatoire Non

NextToken

Les requêtes HTTP sont sans état. Identifier quel objet vient « suivant » dans la liste desJobListEntry, vous avez la possibilité de spécifierNextTokencomme point de départ pour votre liste renvoyée.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.

Modèle : .*

Obligatoire Non

Syntaxe de la réponse

{
   "JobListEntries": [ 
      { 
         "CreationDate": number,
         "Description": "string",
         "IsMaster": boolean,
         "JobId": "string",
         "JobState": "string",
         "JobType": "string",
         "SnowballType": "string"
      }
   ],
   "NextToken": "string"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

JobListEntries

EACHJobListEntrycontient l'état d'une tâche, l'ID de la tâche et une valeur qui indique si la tâche est une pièce de travail, dans le cas des travaux d'exportation.

Type : TableauJobListEntryobjets

NextToken

Les requêtes HTTP sont sans état. Si vous utilisez l'option générée automatiquementNextTokenvaleur dans votre prochainListClusterJobsResultappel, la liste des tâches renvoyées commencera à partir de ce point de la baie.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.

Modèle : .*

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, voirErreurs courantes.

InvalidNextTokenException

LeNextTokenchaîne a été modifiée de façon inattendue et l'opération s'est arrêtée. Exécutez l'opération sans modifier le paramètreNextTokenString, puis réessayez.

HTTP Status Code : 400

InvalidResourceException

La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans votre dernière demande, puis réessayez.

HTTP Status Code : 400

Voir aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :