ListRobotApplications - AWS RoboMaker
Syntaxe de la requêteURIParamètres de demandeCorps de la requêteSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Avis de fin de support : le 10 septembre 2025, AWS le support de AWS RoboMaker. Après le 10 septembre 2025, vous ne pourrez plus accéder à la AWS RoboMaker console ni aux AWS RoboMaker ressources. Pour plus d'informations sur la transition AWS Batch afin de faciliter l'exécution de simulations conteneurisées, consultez ce billet de blog.

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.

ListRobotApplications

Important

Avis de fin de support : le 10 septembre 2025, AWS le support de AWS RoboMaker. Après le 10 septembre 2025, vous ne pourrez plus accéder à la AWS RoboMaker console ni aux AWS RoboMaker ressources. Pour plus d'informations sur la transition AWS Batch afin de faciliter l'exécution de simulations conteneurisées, consultez ce billet de blog.

Renvoie la liste des applications du robot. Vous pouvez éventuellement fournir des filtres pour récupérer des applications robotiques spécifiques.

Syntaxe de la requête

POST /listRobotApplications HTTP/1.1
Content-type: application/json

{
   "filters": [ 
      { 
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string",
   "versionQualifier": "string"
}

URIParamètres de demande

La demande n'utilise aucun URI paramètre.

Corps de la requête

La demande accepte le JSON format des données suivantes.

filters

Filtres facultatifs pour limiter les résultats.

Le nom du filtre name est pris en charge. Lors du filtrage, vous devez utiliser la valeur complète de l'élément filtré. Vous pouvez utiliser jusqu'à trois filtres.

Type : tableau d’objets Filter

Membres du tableau : nombre fixe de 1 élément.

Obligatoire : non

maxResults

Lorsque ce paramètre est utilisé, les maxResults résultats ListRobotApplications ne sont renvoyés que sur une seule page avec un élément de nextToken réponse. Les résultats restants de la demande initiale peuvent être consultés en envoyant une autre ListRobotApplications demande avec la nextToken valeur renvoyée. Cette valeur peut être comprise entre 1 et 100. Si ce paramètre n'est pas utilisé, ListRobotApplications renvoie jusqu'à 100 résultats et une nextToken valeur, le cas échéant.

Type : entier

Obligatoire : non

nextToken

Si la requête paginée précédente n'a pas renvoyé tous les résultats restants, la valeur du nextToken paramètre de l'objet de réponse est définie sur un jeton. Pour récupérer le prochain ensemble de résultats, appelez ListRobotApplications à nouveau et attribuez ce jeton au nextToken paramètre de l'objet de requête. S'il n'y a aucun résultat restant, le NextToken paramètre de l'objet de réponse précédent est défini sur null.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.

Modèle : [a-zA-Z0-9_.\-\/+=]*

Obligatoire : non

versionQualifier

Le qualificatif de version de l'application du robot.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.

Modèle : ALL

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "robotApplicationSummaries": [ 
      { 
         "arn": "string",
         "lastUpdatedAt": number,
         "name": "string",
         "robotSoftwareSuite": { 
            "name": "string",
            "version": "string"
         },
         "version": "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 sous JSON forme formatée par le service.

nextToken

Si la requête paginée précédente n'a pas renvoyé tous les résultats restants, la valeur du nextToken paramètre de l'objet de réponse est définie sur un jeton. Pour récupérer le prochain ensemble de résultats, appelez ListRobotApplications à nouveau et attribuez ce jeton au nextToken paramètre de l'objet de requête. S'il n'y a aucun résultat restant, le NextToken paramètre de l'objet de réponse précédent est défini sur null.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.

Modèle : [a-zA-Z0-9_.\-\/+=]*

robotApplicationSummaries

Liste des résumés des applications de robots répondant aux critères de la demande.

Type : tableau d’objets RobotApplicationSummary

Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 100 éléments.

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InternalServerException

AWS RoboMaker a rencontré un problème de service. Renouvelez votre appel.

HTTPCode de statut : 500

InvalidParameterException

Un paramètre spécifié dans une demande n'est pas valide, n'est pas pris en charge ou ne peut pas être utilisé. Le message renvoyé fournit une explication de la valeur d'erreur.

HTTPCode de statut : 400

ThrottlingException

AWS RoboMaker est temporairement incapable de traiter la demande. Renouvelez votre appel.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :