Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée une passerelle de sauvegarde. Une fois la passerelle créée, vous pouvez l'associer à un serveur à l'aide de l'opération `AssociateGatewayToServer`.

## Syntaxe de la requête
<a name="API_BGW_CreateGateway_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_BGW_CreateGateway_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [ActivationKey](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-ActivationKey"></a>
La clé d'activation de la passerelle créée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.  
Modèle : `[0-9a-zA-Z\-]+`   
Obligatoire : oui

 ** [GatewayDisplayName](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayDisplayName"></a>
Le nom d'affichage de la passerelle créée.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.  
Modèle : `[a-zA-Z0-9-]*`   
Obligatoire : oui

 ** [GatewayType](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayType"></a>
Type de passerelle créée.  
Type : Chaîne  
Valeurs valides : `BACKUP_VM`   
Obligatoire : oui

 ** [Tags](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-Tags"></a>
Liste jusqu'à 50 balises à attribuer à la passerelle. Chaque balise est une paire clés-valeurs.  
Type : tableau d’objets [Tag](API_BGW_Tag.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_BGW_CreateGateway_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_BGW_CreateGateway_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [GatewayArn](#API_BGW_CreateGateway_ResponseSyntax) **   <a name="Backup-BGW_CreateGateway-response-GatewayArn"></a>
Amazon Resource Name (ARN) de la passerelle que vous créez.  
Type : Chaîne  
Contraintes de longueur : longueur minimale de 50. Longueur maximale de 180.  
Modèle : `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Erreurs
<a name="API_BGW_CreateGateway_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** InternalServerException **   
L'opération n'a pas réussi, car une erreur interne s'est produite. Réessayez ultérieurement.    
 ** ErrorCode **   
Description de l'erreur interne survenue.
Code d’état HTTP : 500

 ** ThrottlingException **   
Le TPS a été limité pour protéger contre les volumes de demandes élevés intentionnels ou involontaires.    
 ** ErrorCode **   
Erreur : le TPS a été limité afin de se protéger contre les volumes de demandes élevés intentionnels ou involontaires.
Code d’état HTTP : 400

 ** ValidationException **   
L'opération n'a pas réussi, car une erreur de validation s'est produite.    
 ** ErrorCode **   
Description de l'origine de l'erreur de validation.
Code d’état HTTP : 400

## Voir aussi
<a name="API_BGW_CreateGateway_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/CreateGateway)