DescribeDeviceEc2Instances - AWS Snowball

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.

DescribeDeviceEc2Instances

Vérifie l'état actuel des instances Amazon EC2. La sortie est similaire àdescribeDevice, mais les résultats proviennent du cache de périphériques dans leAWS Cloudet inclut un sous-ensemble des champs disponibles.

Syntaxe de la demande

POST /managed-device/managedDeviceId/resources/ec2/describe HTTP/1.1 Content-type: application/json { "instanceIds": [ "string" ] }

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

managedDeviceId

ID de l'appareil géré.

Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

Obligatoire Oui

Corps de la demande

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

instanceIds

Liste des ID d'instance associés à l'appareil géré.

Type : Tableau de chaînes

Obligatoire Oui

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "instances": [ { "instance": { "amiLaunchIndex": number, "blockDeviceMappings": [ { "deviceName": "string", "ebs": { "attachTime": number, "deleteOnTermination": boolean, "status": "string", "volumeId": "string" } } ], "cpuOptions": { "coreCount": number, "threadsPerCore": number }, "createdAt": number, "imageId": "string", "instanceId": "string", "instanceType": "string", "privateIpAddress": "string", "publicIpAddress": "string", "rootDeviceName": "string", "securityGroups": [ { "groupId": "string", "groupName": "string" } ], "state": { "code": number, "name": "string" }, "updatedAt": number }, "lastUpdatedAt": number } ] }

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.

instances

Liste des structures contenant des informations sur chaque instance.

Type : Tableau deInstanceSummaryobjets

Erreurs

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

AccessDeniedException

Vous ne disposez pas d'un accès suffisant pour effectuer cette action.

HTTP Status Code : 403

InternalServerException

Une erreur inattendue s'est produite lors du traitement de la demande.

HTTP Status Code : 500

ResourceNotFoundException

La demande fait référence à une ressource qui n'existe pas.

HTTP Status Code : 404

ThrottlingException

La demande a été refusée suite à une limitation des demandes.

HTTP Status Code : 429

ValidationException

L'entrée ne satisfait pas les contraintes spécifiées par unAWSservice.

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 :