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à.

# CreateGateway
<a name="API_BGW_CreateGateway"></a>

Crea un gateway di backup. Dopo aver creato un gateway, puoi associarlo a un server utilizzando l'operazione `AssociateGatewayToServer`.

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

```
{
   "ActivationKey": "string",
   "GatewayDisplayName": "string",
   "GatewayType": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_BGW_CreateGateway_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.

 ** [ActivationKey](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-ActivationKey"></a>
La chiave di attivazione del gateway creato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.  
Modello: `[0-9a-zA-Z\-]+`   
Obbligatorio: sì

 ** [GatewayDisplayName](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayDisplayName"></a>
Il nome visualizzato del gateway creato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.  
Modello: `[a-zA-Z0-9-]*`   
Obbligatorio: sì

 ** [GatewayType](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayType"></a>
Il tipo di gateway creato.  
Tipo: String  
Valori validi: `BACKUP_VM`   
Obbligatorio: sì

 ** [Tags](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-Tags"></a>
Un elenco di massimo 50 tag da assegnare al gateway. Ogni tag è una coppia chiave-valore.  
Tipo: matrice di oggetti [Tag](API_BGW_Tag.md)  
Obbligatorio: no

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

```
{
   "GatewayArn": "string"
}
```

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

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

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

 ** [GatewayArn](#API_BGW_CreateGateway_ResponseSyntax) **   <a name="Backup-BGW_CreateGateway-response-GatewayArn"></a>
Il nome della risorsa Amazon (ARN) del gateway creato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.  
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errori
<a name="API_BGW_CreateGateway_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_CreateGateway_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/CreateGateway) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/CreateGateway)