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.
CreateReplicationConfiguration
Crée une configuration de réplication qui réplique un système de EFS fichiers existant vers un nouveau système de fichiers en lecture seule. Pour plus d'informations, consultez Amazon EFS Replication dans le guide de EFS l'utilisateur Amazon. La configuration de la réplication spécifie les éléments suivants :
-
Système de fichiers source : système de EFS fichiers que vous souhaitez répliquer. Le système de fichiers source ne peut pas être un système de fichiers de destination dans une configuration de réplication existante.
-
Région AWS — Le système de fichiers Région AWS dans lequel le système de fichiers de destination est créé. EFSLa réplication Amazon est disponible Régions AWS dans toutes les EFS versions disponibles. La région doit être activé. Pour plus d'informations, consultez la section Gestion Régions AWS dans le Guide de référence AWS général.
-
Configuration du système de fichiers de destination – Configuration du système de fichiers de destination vers lequel le système de fichiers source sera répliqué. Il ne peut y avoir qu’un seul système de fichiers de destination dans une configuration de réplication.
Les paramètres de configuration de réplication incluent :
-
ID du système de fichiers – ID du système de fichiers de destination pour la réplication. Si aucun identifiant n'est fourni, EFS crée un nouveau système de fichiers avec les paramètres par défaut. Pour les systèmes de fichiers existants, la protection contre le remplacement par réplication du système de fichiers doit être désactivée. Pour en savoir plus, consultez la section Réplication vers un système de fichiers existant.
-
Zone de disponibilité – Si vous souhaitez que le système de fichiers de destination utilise le stockage Zone unique, vous devez spécifier la Zone de disponibilité dans laquelle créer le système de fichiers. Pour plus d'informations, consultez les types de systèmes de EFS fichiers dans le guide de EFS l'utilisateur Amazon.
-
Chiffrement : tous les systèmes de fichiers de destination sont créés avec le chiffrement au repos activé. Vous pouvez spécifier la clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer le système de fichiers de destination. Si vous ne spécifiez pas de KMS clé, votre KMS clé gérée par le service pour Amazon EFS est utilisée.
Note
Une fois le système de fichiers créé, vous ne pouvez pas modifier la KMS clé.
-
Pour les nouveaux systèmes de fichiers de destination, les propriétés suivantes sont définies par défaut :
-
Mode performance : le mode de performance du système de fichiers de destination correspond à celui du système de fichiers source, sauf si le système de fichiers de destination utilise le stockage EFS One Zone. Dans ce cas, le mode Performance Usage général est utilisé. Le mode Performance ne peut pas être modifié.
-
Mode débit - Le mode de débit du système de fichiers de destination correspond à celui du système de fichiers source. Une fois le système de fichiers créé, vous pouvez modifier le mode de débit.
-
gestion du cycle de vie : la gestion du cycle de vie n'est pas activée sur le système de fichiers de destination. Une fois le système de fichiers de destination créé, vous pouvez activer la gestion du cycle de vie.
-
Sauvegardes automatiques – Les sauvegardes quotidiennes automatiques sont activées sur le système de fichiers de destination. Une fois le système de fichiers créé, vous pouvez modifier ce paramètre.
Pour plus d'informations, consultez Amazon EFS Replication dans le guide de EFS l'utilisateur Amazon.
Syntaxe de la requête
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string"
}
]
}URIParamètres de demande
La demande utilise les URI paramètres suivants.
- SourceFileSystemId
-
Spécifie le système de EFS fichiers Amazon que vous souhaitez répliquer. Ce système de fichiers ne peut pas déjà être un système de fichiers source ou de destination dans une autre configuration de réplication.
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$Obligatoire : oui
Corps de la demande
La demande accepte le JSON format des données suivantes.
- Destinations
-
Un tableau d’objets de configuration de destination. Un seul objet de configuration de destination est pris en charge.
Type : tableau d’objets DestinationToCreate
Obligatoire : oui
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "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.
- CreationTime
-
Décrit le moment où la configuration de réplication a été créée.
Type : Timestamp
- Destinations
-
Tableau d’objets de destination. Un seul objet de destination est pris en charge.
Type : tableau d’objets Destination
- OriginalSourceFileSystemArn
-
Le nom de ressource Amazon (ARN) du système de EFS fichiers source d'origine dans la configuration de réplication.
Type : chaîne
- SourceFileSystemArn
-
Le nom de ressource Amazon (ARN) du système de fichiers source actuel dans la configuration de réplication.
Type : chaîne
- SourceFileSystemId
-
ID du système de EFS fichiers Amazon source en cours de réplication.
Type : chaîne
Contraintes de longueur : Longueur maximum de 128.
Modèle :
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - SourceFileSystemRegion
-
Région AWS Dans lequel se trouve le système de EFS fichiers source.
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
Modèle :
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
Erreurs
- BadRequest
-
Renvoyé si la demande est mal formée ou contient une erreur telle qu’une valeur de paramètre non valide ou un paramètre obligatoire manquant.
HTTPCode de statut : 400
- ConflictException
-
Renvoie si le système de fichiers source d’une réplication est chiffré mais que le système de fichiers de destination n’est pas chiffré.
HTTPCode de statut : 409
- FileSystemLimitExceeded
-
Renvoie si le nombre maximum de systèmes de fichiers autorisés par compte Compte AWS a déjà été créé.
HTTPCode de statut : 403
- FileSystemNotFound
-
Renvoyé si la
FileSystemIdvaleur spécifiée n'existe pas dans celle du Compte AWS demandeur.HTTPCode de statut : 404
- IncorrectFileSystemLifeCycleState
-
Renvoyé si l’état du cycle de vie du système de fichiers n’est pas « disponible ».
HTTPCode de statut : 409
- InsufficientThroughputCapacity
-
Renvoyé si la capacité est insuffisante pour fournir un débit supplémentaire. Cette valeur peut être renvoyée lorsque vous essayez de créer un système de fichiers en mode débit alloué, lorsque vous essayez d’augmenter le débit alloué d’un système de fichiers existant ou lorsque vous essayez de faire passer un système de fichiers existant du mode débit en rafale au mode débit alloué. Réessayez ultérieurement.
HTTPCode de statut : 503
- InternalServerError
-
Renvoyé si une erreur s’est produite côté serveur.
HTTPCode de statut : 500
- ReplicationNotFound
-
Renvoyé si le système de fichiers spécifié ne possède pas de configuration de réplication.
HTTPCode de statut : 404
- ThroughputLimitExceeded
-
Renvoie si le mode de débit ou la quantité de débit alloué ne peuvent pas être Modifiés car la limite de débit de 1024 Mbits/s a été atteinte.
HTTPCode de statut : 400
- UnsupportedAvailabilityZone
-
Renvoyé si la EFS fonctionnalité Amazon demandée n'est pas disponible dans la zone de disponibilité spécifiée.
HTTPCode de statut : 400
- ValidationException
-
Renvoyé si le AWS Backup service n'est pas disponible dans le Région AWS pays dans lequel la demande a été faite.
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 :
