ListVirtualMachines - AWS Backup
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ListVirtualMachines

Elenca le macchine virtuali.

Sintassi della richiesta

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

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

HypervisorArn

Il nome della risorsa Amazon (ARN) dell'hypervisor connesso alla macchina virtuale.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.

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

Campo obbligatorio: no

MaxResults

Il numero massimo di macchine virtuali da elencare.

Tipo: integer

Intervallo valido: valore minimo di 1.

Campo obbligatorio: no

NextToken

L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero maxResults di risorse, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.

Modello: ^.+$

Campo obbligatorio: no

Sintassi della risposta

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

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero maxResults di risorse, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.

Modello: ^.+$

VirtualMachines

Un elenco di oggetti VirtualMachine, ordinati in base ai nomi delle risorse Amazon (ARN).

Tipo: matrice di oggetti VirtualMachine

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalServerException

L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.

Codice di stato HTTP: 500

ThrottlingException

Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.

Codice di stato HTTP: 400

ValidationException

L'operazione non è riuscita perché si è verificato un errore di convalida.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: