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
<a name="API_BGW_ListVirtualMachines"></a>

Elenca le macchine virtuali.

## Sintassi della richiesta
<a name="API_BGW_ListVirtualMachines_RequestSyntax"></a>

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

## Parametri della richiesta
<a name="API_BGW_ListVirtualMachines_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [HypervisorArn](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-HypervisorArn"></a>
Il nome della risorsa Amazon (ARN) dell'hypervisor connesso alla macchina virtuale.  
Tipo: String  
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]+`   
Obbligatorio: no

 ** [MaxResults](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-MaxResults"></a>
Il numero massimo di macchine virtuali da elencare.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1.  
Obbligatorio: no

 ** [NextToken](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-NextToken"></a>
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: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.  
Modello: `.+`   
Obbligatorio: no

## Sintassi della risposta
<a name="API_BGW_ListVirtualMachines_ResponseSyntax"></a>

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

## Elementi di risposta
<a name="API_BGW_ListVirtualMachines_ResponseElements"></a>

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

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

 ** [NextToken](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-NextToken"></a>
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: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.  
Modello: `.+` 

 ** [VirtualMachines](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-VirtualMachines"></a>
Un elenco dei tuoi `VirtualMachine` oggetti, ordinati in base ai loro Amazon Resource Names (ARNs).  
Tipo: matrice di oggetti [VirtualMachine](API_BGW_VirtualMachine.md)

## Errori
<a name="API_BGW_ListVirtualMachines_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** InternalServerException **   
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.    
 ** ErrorCode **   
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500

 ** ThrottlingException **   
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.    
 ** ErrorCode **   
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400

 ** ValidationException **   
L'operazione non è riuscita perché si è verificato un errore di convalida.    
 ** ErrorCode **   
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400

## Vedi anche
<a name="API_BGW_ListVirtualMachines_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListVirtualMachines)