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 Anforderung 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 IhnenNextToken
, 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 Service 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 IhnenNextToken
, 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 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.
HTTP Status Code: 500
- ThrottlingException
-
TPS wurde auf den Schutz vor absichtlich oder unbeabsichtigt hohen Anforderungsvolumen beschränkt.
HTTP Status Code: 400
- ValidationException
-
Der Vorgang war nicht erfolgreich, da ein Überprüfungsfehler aufgetreten ist.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: