Abrufen von Replikationsstatusinformationen - Amazon Simple Storage Service
Übersicht über den ReplikationsstatusReplikationsstatus bei einer Replikation auf mehrere Ziel-BucketsReplikationsstatus, wenn die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert istVerwenden von Replikationsstatusinformationen mit Batch-ReplikationsaufträgenFinden des Replikationsstatus

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen von Replikationsstatusinformationen

Der Replikationsstatus hilft Ihnen, den aktuellen Status eines derzeit replizierten Objekts zu bestimmen. Der Replikationsstatus eines Quellobjekts gibt entweder PENDING, COMPLETED oder FAILED zurück. Der Replikationsstatus eines Replikats gibt REPLICA zurück.

Sie können auch Werte für den Replikationsstatus verwenden, wenn Sie S3-Batch-Replikationsaufträge erstellen. Sie können diese Statuswerte beispielsweise verwenden, um Objekte zu replizieren, die entweder nie repliziert wurden oder deren Replikation fehlgeschlagen ist. Weitere Hinweise zur Verwendung dieser Werte mit der Batch-Replikation finden Sie unterVerwenden von Replikationsstatusinformationen mit Batch-Replikationsaufträgen.

Übersicht über den Replikationsstatus

Bei der Replikation haben Sie einen Quell-Bucket, in dem Sie die Replikation konfigurieren, und einen oder mehrere Ziel-Buckets, in denen Amazon S3 Objekte repliziert. Wenn Sie ein Objekt (mithilfeGetObject) oder Objektmetadaten (mithilfe vonHeadObject) aus diesen Buckets anfordern, gibt Amazon S3 den x-amz-replication-status Header in der Antwort zurück:

  • Wenn Sie ein Objekt aus dem Quell-Bucket anfordern, gibt Amazon S3 den Header x-amz-replication-status zurück, wenn das Objekt in der Anforderung für die Replikation geeignet ist.

    Nehmen wir beispielsweise an, dass Sie in Ihrer Replikationskonfiguration das Objektpräfix TaxDocs angeben, um Amazon S3 anzuweisen, nur Objekte mit dem Schlüsselnamenpräfix TaxDocs zu replizieren. Alle Objekte mit diesem Schlüsselnamenpräfix, die Sie hochladen, z. B. TaxDocs/document1.pdf, werden repliziert. Für Objektanforderungen mit diesem Schlüsselnamenpräfix gibt Amazon S3 den Header x-amz-replication-status mit einem der folgenden Werte für den Replikationsstatus des Objekts zurück: PENDING, COMPLETED oder FAILED.

    Anmerkung

    Wenn nach dem Hochladen eines Objekts die Objektreplikation fehlschlägt, können Sie die fehlgeschlagene Replikation nicht erneut durchzuführen versuchen. Sie müssen das Objekt erneut hochladen, oder Sie müssen S3 Batch Replication verwenden, um alle fehlgeschlagenen Objekte zu replizieren. Weitere Informationen zur Verwendung der Batch-Replikation finden Sie unterReplizieren vorhandener Objekte mit Batch Replication.

    Objekte wechseln aufgrund von Problemen wie fehlenden Rollenberechtigungen, AWS Key Management Service (AWS KMS) -Berechtigungen oder Bucket-Berechtigungen für die Replikation in einen bestimmten FAILED Status. Bei vorübergehenden Ausfällen, z. B. wenn ein Bucket oder eine Region nicht verfügbar ist, wird der Replikationsstatus nicht auf den Status FAILED umgestellt, sondern bleibt bestehenPENDING. Nachdem die Ressource wieder online ist, setzt Amazon S3 die Replikation dieser Objekte fort.

  • Wenn Sie ein Objekt aus einem Ziel-Bucket anfordern und es sich bei dem Objekt Ihrer Anforderung um ein Replikat handelt, das Amazon S3 erstellt hat, gibt Amazon S3 den Header x-amz-replication-status mit dem Wert REPLICA zurück.

Anmerkung

Bevor Sie ein Objekt aus einem Quell-Bucket löschen, für das die Replikation aktiviert ist, überprüfen Sie den Replikationsstatus des Objekts, um sicherzustellen, dass das Objekt repliziert wurde.

Wenn eine S3-Lifecycle-Konfiguration im Quell-Bucket aktiviert ist, setzt Amazon S3 Lebenszyklusaktionen aus, bis der Status der Objekte entweder als oder COMPLETED markiert wird. FAILED

Replikationsstatus bei einer Replikation auf mehrere Ziel-Buckets

Wenn Sie Objekte in mehrere Ziel-Buckets replizieren, verhält sich der Header x-amz-replication-status anders. Der Header des Quellobjekts gibt COMPLETED nur dann den Wert zurück, wenn die Replikation an alle Ziele erfolgreich ist. Der Header bleibt auf dem Wert PENDING, bis die Replikation für alle Ziele abgeschlossen ist. Wenn die Replikation bei einem oder mehreren Zielen fehlschlägt, liefert der Header FAILED.

Replikationsstatus, wenn die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert ist

Wenn in Ihren Replikationsregeln die Synchronisierung von Amazon-S3-Replikatänderungen aktiviert ist, können Replikate einen anderen Status als REPLICA melden. Wenn Änderungen an Metadaten gerade repliziert werden, gibt der x-amz-replication-status-Header den Wert PENDING zurück. Wenn die Synchronisierung der Replikatänderung Metadaten nicht repliziert, gibt der Header FAILED zurück. Wenn Metadaten korrekt repliziert werden, geben die Replikate den Header REPLICA zurück.

Verwenden von Replikationsstatusinformationen mit Batch-Replikationsaufträgen

Wenn Sie einen Batch-Replikationsauftrag erstellen, können Sie optional zusätzliche Filter angeben, z. B. das Erstellungsdatum des Objekts und den Replikationsstatus, um den Umfang des Jobs zu reduzieren.

Sie können Objekte filtern, die repliziert werden sollen, basierend auf dem ObjectReplicationStatuses-Wert, indem Sie einen oder mehrere der folgenden Werte angeben:

  • "NONE" – Zeigt an, dass Amazon S3 noch nie versucht hat, das Objekt zu replizieren.

  • "FAILED"— Zeigt an, dass Amazon S3 versucht hat, das Objekt zuvor zu replizieren, dies jedoch fehlgeschlagen ist.

  • "COMPLETED" – Zeigt an, dass Amazon S3 das Objekt zuvor erfolgreich repliziert hat.

  • "REPLICA"— Zeigt an, dass es sich um ein Replikat-Objekt handelt, das Amazon S3 aus einer anderen Quelle repliziert hat.

Weitere Hinweise zur Verwendung dieser Replikationsstatuswerte mit der Batch-Replikation finden Sie unterFilter für einen Batch-Replikationsauftrag.

Finden des Replikationsstatus

Verwenden Sie das Amazon-S3-Inventory-Tool, um den Replikationsstatus der Objekte in einem Bucket abzurufen. Amazon S3 sendet eine CSV Datei an den Ziel-Bucket, den Sie in der Inventarkonfiguration angeben. Sie können auch Amazon Athena verwenden, um den Replikationsstatus im Bestandsbericht abzufragen. Weitere Informationen zu Amazon S3 Inventory finden Sie unter Katalogisieren und Analysieren Ihrer Daten mit S3 Inventory.

Sie können den Status der Objektreplikation auch mithilfe der Amazon S3 S3-Konsole, der AWS Command Line Interface (AWS CLI) oder der ermitteln AWS SDK.

In der Amazon S3 S3-Konsole können Sie den Replikationsstatus für ein Objekt auf der Detailseite des Objekts einsehen.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

  2. Wählen Sie im linken Navigationsbereich Buckets aus.

  3. Wählen Sie in der Liste der Buckets für allgemeine Zwecke den Namen des Replizierungsquellen-Buckets aus.

  4. Wählen Sie in der Liste Objekte den Objektnamen aus. Die Seite mit den Objektdetails wird angezeigt.

  5. Scrollen Sie auf der Registerkarte Eigenschaften nach unten zum Abschnitt Übersicht über die Objektverwaltung. Unter Verwaltungskonfigurationen finden Sie den Wert unter Replikationsstatus.

Verwenden Sie den head-object Befehl AWS Command Line Interface (AWS CLI), um Objektmetadaten abzurufen, wie im folgenden Beispiel gezeigt. Ersetzen Sie den amzn-s3-demo-source-bucket1 durch den Namen Ihres Replizierungsquellen-Buckets und den anderen user input placeholders durch Ihre eigenen Informationen.

aws s3api head-object --bucket amzn-s3-demo-source-bucket1 --key object-key --version-id object-version-id

Der Befehl gibt Informationen zu Objektmetadaten, einschließlich des ReplicationStatus, zurück, wie in der folgenden Beispielantwort dargestellt:

{
   "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":{

   }
}

Die folgenden Codefragmente ermitteln Ihren Replikationsstatus mithilfe von AWS SDK for Java und AWS SDK for .NET.

Java
GetObjectMetadataRequest metadataRequest = new GetObjectMetadataRequest(bucketName, key);
ObjectMetadata metadata = s3Client.getObjectMetadata(metadataRequest);

System.out.println("Replication Status : " + metadata.getRawMetadataValue(Headers.OBJECT_REPLICATION_STATUS));
.NET
GetObjectMetadataRequest getmetadataRequest = new GetObjectMetadataRequest
    {
         BucketName = sourceBucket,
         Key        = objectKey
    };

GetObjectMetadataResponse getmetadataResponse = client.GetObjectMetadata(getmetadataRequest);
Console.WriteLine("Object replication status: {0}", getmetadataResponse.ReplicationStatus);