ListVirtualMachines - AWS Backup
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ListVirtualMachines

Listet Ihre virtuellen Maschinen auf.

Anforderungssyntax

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

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

HypervisorArn

Der Amazon-Ressourcenname (ARN) des Hypervisors, der mit Ihrer virtuellen Maschine verbunden ist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 50. Maximale Länge beträgt 500 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$

Erforderlich: Nein

MaxResults

Die maximale Anzahl der virtuellen Maschinen, die aufgelistet werden sollen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1.

Erforderlich: Nein

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Ressourcen. Wenn beispielsweise eine Anforderung zur Rückgabe der maxResults Anzahl von Ressourcen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 1000 Zeichen.

Pattern: ^.+$

Erforderlich: Nein

Antwortsyntax

{
   "NextToken": "string",
   "VirtualMachines": [ 
      { 
         "HostName": "string",
         "HypervisorId": "string",
         "LastBackupDate": number,
         "Name": "string",
         "Path": "string",
         "ResourceArn": "string"
      }
   ]
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Ressourcen. Wenn beispielsweise eine Anforderung zur Rückgabe der maxResults Anzahl von Ressourcen gestellt wird, ermöglicht Ihnen NextToken, mehr Elemente in Ihrer Liste zurückzugeben, beginnend mit der Position, auf die das nächste Token verweist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 1000 Zeichen.

Pattern: ^.+$

VirtualMachines

Eine Liste Ihrer VirtualMachine Objekte, sortiert nach ihren Amazon-Ressourcennamen (ARNs).

Typ: Array von VirtualMachine-Objekten

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InternalServerException

Der Vorgang war nicht erfolgreich, da ein interner Fehler aufgetreten ist. Bitte versuchen Sie es später erneut.

HTTPStatuscode: 500

ThrottlingException

TPSwurde auf den Schutz vor vorsätzlichen oder unbeabsichtigten hohen Anforderungszahlen beschränkt.

HTTPStatuscode: 400

ValidationException

Der Vorgang war nicht erfolgreich, da ein Überprüfungsfehler aufgetreten ist.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: