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.
Obtention d'informations sur le statut de la réplication
Le statut de réplication peut vous aider à déterminer l'état actuel d'un objet répliqué. Le statut de réplication d'un objet source renvoie soit PENDING, COMPLETED ou FAILED. Le statut de réplication d'un réplica renvoie REPLICA.
Rubriques
Vue d'ensemble des statuts de réplication
Dans le cadre de la réplication, vous disposez d'un compartiment source dans lequel vous configurez la réplication et d'un compartiment de destination dans lequel Amazon S3 réplique les objets. Lorsque vous demandez un objet (à l'aide de l'objet GET) ou des métadonnées d'objet (à l'aide de l'objet HEAD) à partir de ces compartiments, Amazon S3 renvoie l'en-tête x-amz-replication-status dans la réponse :
-
Lorsque vous demandez un objet depuis le compartiment source, Amazon S3 renvoie l'en-tête
x-amz-replication-statussi l'objet demandé peut être répliqué.Par exemple, imaginons que vous spécifiez le préfixe d'objet
TaxDocsdans votre configuration de réplication pour indiquer à Amazon S3 de ne répliquer que les objets dotés du préfixe de nom de cléTaxDocs. Tous les objets que vous chargez ayant ce préfixe de nom de clé (par exemple,TaxDocs/document1.pdf) seront répliqués. Pour les demandes d'objet avec ce préfixe de nom de clé, Amazon S3 renvoie l'en-têtex-amz-replication-statusavec l'une des valeurs suivantes pour le statut de réplication de l'objet :PENDING,COMPLETEDouFAILED.Note
Si la réplication d'objet échoue après avoir chargé un objet, vous ne pouvez pas relancer la réplication. Vous devez recharger l'objet. Les objets passent à l'état
FAILEDen cas de problèmes, par exemple si les autorisations de rôle de réplication, les autorisations AWS KMS ou les autorisations de compartiment sont manquantes. Pour les échecs temporaires, par exemple si un compartiment ou une Région n'est pas disponible, le statut de réplication ne passera pas àFAILED, mais resteraPENDING. Une fois la ressource remise en ligne, S3 reprendra la réplication de ces objets. -
Lorsque vous demandez un objet à partir du compartiment de destination, si l'objet demandé est un réplica créé par Amazon S3, Amazon S3 renvoie l'en-tête
x-amz-replication-statusavec la valeurREPLICA.
Note
Avant de supprimer un objet d'un compartiment source pour lequel la réplication a été activée, contrôlez le statut de réplication de l'objet pour vérifier qu'il a été répliqué.
Si la configuration du cycle de vie est activée sur le compartiment source, Amazon S3 interrompt les actions de cycle de vie tant que les statuts des objets ne sont pas marqués comme COMPLETED ou FAILED.
Statut de la réplication en cas de réplication vers plusieurs compartiments de destination
Lorsque vous répliquez des objets vers plusieurs compartiments de destination, l'en-tête x-amz-replication-status agit différemment. L'en-tête de l'objet source renvoie uniquement la valeur COMPLETED lorsque la réplication a réussi vers toutes les destinations. L'en-tête reste à la valeur PENDING jusqu'à ce que la réplication soit terminée pour toutes les destinations. Si la réplication échoue vers une ou plusieurs destinations, l'en-tête renvoie FAILED.
Statut de la réplication si la synchronisation des modifications de réplica Simple Storage Service (Amazon S3) est activée
Lorsque vos règles de réplication activent la synchronisation des modifications de réplica Simple Storage Service (Amazon S3), les statuts des réplicas peuvent être différents de REPLICA. Si des modifications de métadonnées sont en cours de réplication, l'en-tête x-amz-replication-status renvoie PENDING. Si la synchronisation des modifications du réplica ne parvient pas à répliquer les métadonnées, l'en-tête renvoie FAILED. Si les métadonnées sont répliquées correctement, les réplicas retournent l'en-tête REPLICA.
Recherche du statut de réplication
Pour obtenir le statut de réplication des objets dans un compartiment, utilisez l'outil d'inventaire Amazon S3. Amazon S3 envoie un fichier CSV au compartiment de destination que vous spécifiez dans la configuration d'inventaire. Vous pouvez également utiliser Amazon Athena pour interroger le statut de réplication dans le rapport d'inventaire. Pour plus d’informations sur l’inventaire Amazon S3, consultez Inventaire Simple Storage Service (Amazon S3).
Vous pouvez également connaître l'état de réplication de l'objet à l'aide de la console, du AWS Command Line Interface (AWS CLI) ou du AWS SDK.
Dans la console S3, vous pouvez afficher le statut de réplication d'un objet sur la page Détails de l'objet sous la Vue d'ensemble de la gestion des objets.
-
Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/
. -
Dans la liste Compartiments, sélectionnez le nom de votre compartiment.
-
Dans la liste Objets , sélectionnez le nom de l'objet.
-
Sous l'onglet Properties (Propriétés), vous pouvez voir le Replication status (Statut de réplication) sous Object management overview (Présentation de la gestion des objets).
Utilisez la commande head-object comme suit pour récupérer les métadonnées de l'objet.
aws s3api head-object --bucketsource-bucket--keyobject-key--version-idobject-version-id
La commande renvoie les métadonnées de l'objet, y compris ReplicationStatus comme illustré dans l'exemple de réponse suivant.
{ "AcceptRanges":"bytes", "ContentType":"image/jpeg", "LastModified":"Mon, 23 Mar 2015 21:02:29 GMT", "ContentLength":3191, "ReplicationStatus":"COMPLETED", "VersionId":"jfnW.HIMOfYiD_9rGbSkmroXsFj3fqZ.", "ETag":"\"6805f2cfc46c0f04559748bb039d69ae\"", "Metadata":{ } }
Les fragments de code suivants obtiennent l'état de réplication avec le AWS SDK for Java et AWS SDK for .NET, respectivement.
