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.
CreateLogicallyAirGappedBackupVault
Crée un conteneur logique dans lequel les sauvegardes peuvent être copiées.
Cette demande inclut un nom, la région, le nombre maximum de jours de rétention, le nombre minimum de jours de rétention et peut éventuellement inclure des balises et un ID de demande de créateur.
Note
N'incluez pas de données sensibles, telles que des numéros de passeport, dans le nom d'un coffre-fort de sauvegarde.
Syntaxe de la demande
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"MaxRetentionDays": number,
"MinRetentionDays": number
}Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- backupVaultName
-
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde logiquement cloisonnés sont identifiés par des noms uniques au compte utilisé pour les créer et la région dans laquelle ils sont créés.
Modèle :
^[a-zA-Z0-9\-\_]{2,50}$Obligatoire : oui
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- BackupVaultTags
-
Les balises à attribuer au coffre.
Type : mappage chaîne/chaîne
Obligatoire : non
- CreatorRequestId
-
ID de la demande de création.
Ce paramètre est facultatif. S'il est utilisé, ce paramètre doit contenir de 1 à 50 caractères alphanumériques ou « -_. » caractères.
Type : chaîne
Obligatoire : non
- MaxRetentionDays
-
Période de conservation maximale pendant laquelle le coffre conserve ses points de récupération. Si ce paramètre n'est pas spécifié, AWS Backup n'applique pas de période de rétention maximale sur les points de récupération dans le coffre-fort (permettant un stockage indéfini).
S'il est spécifié, toute tâche de sauvegarde ou de copie vers le coffre-fort doit avoir une politique de cycle de vie avec une période de rétention égale ou inférieure à la période de rétention maximale. Si la période de rétention de la tâche est plus longue que cette période de rétention maximale, la tâche de sauvegarde ou de copie du coffre-fort échoue, et vous devez soit modifier vos paramètres de cycle de vie, soit utiliser un autre coffre-fort.
Type : long
Obligatoire : oui
- MinRetentionDays
-
Ce paramètre spécifie la période de rétention minimale pendant laquelle le coffre-fort conserve ses points de récupération. Si ce paramètre n'est pas spécifié, aucune période de rétention minimale n'est appliquée.
S'il est spécifié, toute tâche de sauvegarde ou de copie vers le coffre-fort doit avoir une politique de cycle de vie avec une période de rétention égale ou supérieure à la période de rétention minimale. Si la période de rétention d'une tâche est plus courte que cette période de rétention minimale, la tâche de sauvegarde ou de copie du coffre-fort échoue et vous devez soit modifier vos paramètres de cycle de vie, soit utiliser un autre coffre-fort.
Type : long
Obligatoire : oui
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "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 au format JSON par le service.
- BackupVaultArn
-
L'ARN (Amazon Resource Name) du coffre.
Type : chaîne
- BackupVaultName
-
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde logiquement cloisonnés sont identifiés par des noms uniques au compte utilisé pour les créer et la région dans laquelle ils sont créés.
Type : chaîne
Modèle :
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
Date et heure de la création du coffre-fort.
Cette valeur est au format Unix, en temps universel coordonné (UTC) et précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s.
Type : Timestamp
- VaultState
-
État actuel du coffre.
Type : chaîne
Valeurs valides :
CREATING | AVAILABLE | FAILED
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- AlreadyExistsException
-
La ressource demandée existe déjà.
Code d’état HTTP : 400
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
Code d’état HTTP : 400
- InvalidRequestException
-
Indique une erreur dans la saisie de la demande. Par exemple, un paramètre n'est pas du bon type.
Code d’état HTTP : 400
- LimitExceededException
-
Une limite de la demande a été dépassée ; par exemple, le nombre maximum d'éléments autorisés dans une demande.
Code d’état HTTP : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
Code d’état HTTP : 500
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
