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 FileSystemId valeur 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 :

• Interface de ligne de commande AWS

• AWS SDKpour. NET

• AWS SDKpour C++

• AWS SDKpour Go v2

• AWS SDKpour Java V2

• AWS SDKpour JavaScript V3

• AWS SDKpour PHP V3

• AWS SDKpour Python

• AWS SDKpour Ruby V3