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.
Répertorie vos machines virtuelles.
Syntaxe de la requête
{
"HypervisorArn": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- HypervisorArn
-
Amazon Resource Name (ARN) de l'hyperviseur connecté à votre machine virtuelle.
Type : String
Contraintes de longueur : longueur minimale de 50. Longueur maximale de 500.
Modèle :
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
Obligatoire : non
- MaxResults
-
Le nombre maximal de machines virtuelles à répertorier.
Type : entier
Plage valide : Valeur minimum de 1.
Obligatoire : non
- NextToken
-
L'élément suivant selon une liste partielle des ressources renvoyées. Par exemple, si une demande est faite pour renvoyer
maxResults
ressources,NextToken
vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 1 000.
Modèle :
^.+$
Obligatoire : non
Syntaxe de la réponse
{
"NextToken": "string",
"VirtualMachines": [
{
"HostName": "string",
"HypervisorId": "string",
"LastBackupDate": number,
"Name": "string",
"Path": "string",
"ResourceArn": "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.
- NextToken
-
L'élément suivant selon une liste partielle des ressources renvoyées. Par exemple, si une demande est faite pour renvoyer
maxResults
ressources,NextToken
vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 1 000.
Modèle :
^.+$
- VirtualMachines
-
Une liste de vos
VirtualMachine
objets, classés par leur nom de ressource Amazon (ARNs).Type : tableau d’objets VirtualMachine
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServerException
-
L'opération n'a pas réussi, car une erreur interne s'est produite. Réessayez ultérieurement.
Code d’état HTTP : 500
- ThrottlingException
-
Le TPS a été limité pour protéger contre les volumes de demandes élevés intentionnels ou involontaires.
Code d’état HTTP : 400
- ValidationException
-
L'opération n'a pas réussi, car une erreur de validation s'est produite.
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :