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
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
{
"ActivationKey": "string",
"GatewayDisplayName": "string",
"GatewayType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
La demande accepte les données suivantes au JSON format suivant.
- ActivationKey
-
La clé d'activation de la passerelle créée.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Modèle :
^[0-9a-zA-Z\-]+$Obligatoire : oui
- GatewayDisplayName
-
Le nom d'affichage de la passerelle créée.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.
Modèle :
^[a-zA-Z0-9-]*$Obligatoire : oui
- GatewayType
-
Type de passerelle créée.
Type : String
Valeurs valides :
BACKUP_VMObligatoire : oui
- Tags
-
Liste jusqu'à 50 balises à attribuer à la passerelle. Chaque balise est une paire clés-valeurs.
Type : tableau d’objets Tag
Obligatoire : non
Syntaxe de la réponse
{
"GatewayArn": "string"
}Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées sous JSON forme formatée par le service.
- GatewayArn
-
Le nom de ressource Amazon (ARN) de la passerelle que vous créez.
Type : String
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
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServerException
-
L'opération n'a pas réussi, car une erreur interne s'est produite. Réessayez ultérieurement.
HTTPCode de statut : 500
- ThrottlingException
-
TPSa été limité pour se protéger contre des volumes de demandes élevés intentionnels ou involontaires.
HTTPCode de statut : 400
- ValidationException
-
L'opération n'a pas réussi, car une erreur de validation s'est produite.
HTTPCode de statut : 400
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
