ListVirtualMachines - AWS Backup
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez 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.

ListVirtualMachines

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.

La demande accepte les données suivantes au JSON format suivant.

HypervisorArn

Le nom de ressource Amazon (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 sous JSON forme formatée 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.

HTTPCode de statut : 500

ThrottlingException

TPSa été limité pour se protéger contre des volumes de demandes élevés intentionnels ou involontaires.

HTTPCode de statut : 400

ValidationException

L'opération n'a pas réussi, car une erreur de validation s'est produite.

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 :