Skip to main content
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Operationen an Buckets

Beitragende netapp-pcarriga
Änderungen vorschlagen
PDFs

Das StorageGRID -System unterstützt maximal 5.000 Buckets für jedes S3-Mandantenkonto.

Jedes Raster kann maximal 100.000 Buckets enthalten.

Wenn mehrere Mandanten jeweils bis zu 5.000 Buckets haben, muss jeder Storage Node im Grid über mindestens 64 GB RAM verfügen.

Die Einschränkungen für Bucket-Namen folgen den regionalen Einschränkungen des AWS-US-Standards, Sie sollten sie jedoch zusätzlich auf DNS-Namenskonventionen beschränken, um Anfragen im virtuellen S3-Hosting-Stil zu unterstützen.

Weitere Informationen finden Sie im Folgenden:

Die Operationen ListObjects (GET Bucket) und ListObjectVersions (GET Bucket-Objektversionen) unterstützen StorageGRID"Konsistenzwerte" .

Sie können überprüfen, ob Aktualisierungen der letzten Zugriffszeit für einzelne Buckets aktiviert oder deaktiviert sind. Weitere Informationen unter "GET Bucket – Letzte Zugriffszeit".

Die folgende Tabelle beschreibt, wie StorageGRID S3 REST API-Bucket-Operationen implementiert. Um diese Vorgänge auszuführen, müssen die erforderlichen Zugangsdaten für das Konto angegeben werden.

Betrieb Durchführung

Bucket erstellen

Erstellt einen neuen Bucket. Indem Sie den Bucket erstellen, werden Sie zum Bucket-Eigentümer.

  • Bucket-Namen müssen den folgenden Regeln entsprechen:

    • Muss in jedem StorageGRID -System eindeutig sein (nicht nur innerhalb des Mandantenkontos).

    • Muss DNS-kompatibel sein.

    • Muss mindestens 3 und darf nicht mehr als 63 Zeichen enthalten.

    • Kann eine Reihe von einem oder mehreren Labels sein, wobei benachbarte Labels durch einen Punkt getrennt sind. Jedes Etikett muss mit einem Kleinbuchstaben oder einer Zahl beginnen und enden und darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten.

    • Darf nicht wie eine IP-Adresse im Textformat aussehen.

    • In Anfragen im virtuell gehosteten Stil sollten keine Punkte verwendet werden. Punkte verursachen Probleme bei der Überprüfung des Platzhalterzertifikats des Servers.

  • Standardmäßig werden Buckets im us-east-1 Region; Sie können jedoch die LocationConstraint Anforderungselement im Anforderungstext, um eine andere Region anzugeben. Bei Verwendung der LocationConstraint Element müssen Sie den genauen Namen einer Region angeben, die mit dem Grid Manager oder der Grid Management API definiert wurde. Wenden Sie sich an Ihren Systemadministrator, wenn Sie den zu verwendenden Regionsnamen nicht kennen.

    Hinweis: Es tritt ein Fehler auf, wenn Ihre CreateBucket-Anforderung eine Region verwendet, die nicht in StorageGRID definiert wurde.

  • Sie können den x-amz-bucket-object-lock-enabled Anforderungsheader einfügen, um einen Bucket mit aktivierter S3 Object Lock zu erstellen. Weitere Informationen unter "Verwenden Sie die S3 REST API, um S3 Object Lock zu konfigurieren".

    Sie müssen S3 Object Lock aktivieren, wenn Sie den Bucket erstellen. Sie können die S3-Objektsperre nicht hinzufügen oder deaktivieren, nachdem ein Bucket erstellt wurde. S3 Object Lock erfordert eine Bucket-Versionierung, die automatisch aktiviert wird, wenn Sie den Bucket erstellen.

Bucket löschen

Löscht den Bucket.

BucketCors löschen

Löscht die CORS-Konfiguration für den Bucket.

DeleteBucketEncryption

Löscht die Standardverschlüsselung aus dem Bucket. Vorhandene verschlüsselte Objekte bleiben verschlüsselt, aber alle neuen Objekte, die dem Bucket hinzugefügt werden, werden nicht verschlüsselt.

DeleteBucketLifecycle

Löscht die Lebenszykluskonfiguration aus dem Bucket. Weitere Informationen unter "Erstellen einer S3-Lebenszykluskonfiguration".

DeleteBucketPolicy

Löscht die an den Bucket angehängte Richtlinie.

DeleteBucketReplication

Löscht die an den Bucket angehängte Replikationskonfiguration.

BucketTagging löschen

Verwendet die tagging Unterressource zum Entfernen aller Tags aus einem Bucket.

Achtung: Wenn für diesen Bucket ein nicht standardmäßiges ILM-Policy-Tag festgelegt ist, gibt es ein NTAP-SG-ILM-BUCKET-TAG Bucket-Tag mit einem zugewiesenen Wert. Eine DeleteBucketTagging-Anfrage sollte nicht gestellt werden, wenn ein NTAP-SG-ILM-BUCKET-TAG Bucket-Tag vorhanden ist. Stattdessen sollte eine PutBucketTagging-Anfrage mit nur dem NTAP-SG-ILM-BUCKET-TAG Tag und dessen zugewiesenem Wert gestellt werden, um alle anderen Tags aus dem Bucket zu entfernen. Das NTAP-SG-ILM-BUCKET-TAG Bucket-Tag sollte nicht geändert oder entfernt werden.

GetBucketAcl

Gibt eine positive Antwort sowie die ID, den Anzeigenamen und die Berechtigung des Bucket-Eigentümers zurück und gibt damit an, dass der Eigentümer vollen Zugriff auf den Bucket hat.

GetBucketCors

Gibt den cors Konfiguration für den Bucket.

GetBucketEncryption

Gibt die Standardverschlüsselungskonfiguration für den Bucket zurück.

GetBucketLifecycleConfiguration

(früher GET Bucket-Lebenszyklus genannt)

Gibt die Lebenszykluskonfiguration für den Bucket zurück. Weitere Informationen unter "Erstellen einer S3-Lebenszykluskonfiguration".

BucketLocation abrufen

Gibt die Region zurück, die mit dem LocationConstraint Element in der CreateBucket-Anforderung. Wenn die Region des Buckets us-east-1 , wird für die Region eine leere Zeichenfolge zurückgegeben.

GetBucketNotificationConfiguration

(früher „GET Bucket-Benachrichtigung“ genannt)

Gibt die dem Bucket zugeordnete Benachrichtigungskonfiguration zurück.

GetBucketPolicy

Gibt die dem Bucket zugeordnete Richtlinie zurück.

GetBucketReplication

Gibt die dem Bucket zugeordnete Replikationskonfiguration zurück.

GetBucketTagging

Verwendet die tagging Unterressource, um alle Tags für einen Bucket zurückzugeben.

Achtung: Wenn für diesen Bucket ein nicht standardmäßiges ILM-Policy-Tag festgelegt ist, gibt es ein NTAP-SG-ILM-BUCKET-TAG Bucket-Tag mit einem zugewiesenen Wert. Dieses Tag sollte weder geändert noch entfernt werden.

GetBucketVersioning

Diese Implementierung verwendet die versioning Unterressource, um den Versionsstatus eines Buckets zurückzugeben.

  • blank: Die Versionierung wurde nie aktiviert (Bucket ist „Unversioned“)

  • Aktiviert: Versionierung ist aktiviert

  • Ausgesetzt: Die Versionsverwaltung war zuvor aktiviert und ist ausgesetzt

GetObjectLockConfiguration

Gibt den Standardaufbewahrungsmodus und die Standardaufbewahrungsdauer des Buckets zurück, sofern konfiguriert.

Weitere Informationen unter "Verwenden Sie die S3 REST API, um S3 Object Lock zu konfigurieren".

Kopfeimer

Stellt fest, ob ein Bucket vorhanden ist und Sie über die Berechtigung verfügen, darauf zuzugreifen.

Dieser Vorgang gibt Folgendes zurück:

  • x-ntap-sg-bucket-id: Die UUID des Buckets im UUID-Format.

  • x-ntap-sg-trace-id: Die eindeutige Trace-ID der zugehörigen Anfrage.

ListObjects und ListObjectsV2

(früher GET Bucket genannt)

Gibt einige oder alle (bis zu 1.000) Objekte in einem Bucket zurück. Die Speicherklasse für Objekte kann einen von zwei Werten haben, auch wenn das Objekt mit dem REDUCED_REDUNDANCY Speicherklassenoption:

  • STANDARD, was darauf hinweist, dass das Objekt in einem Speicherpool gespeichert ist, der aus Speicherknoten besteht.

  • GLACIER, was darauf hinweist, dass das Objekt in den vom Cloud Storage Pool angegebenen externen Bucket verschoben wurde.

Wenn der Bucket eine große Anzahl gelöschter Schlüssel mit demselben Präfix enthält, kann die Antwort einige CommonPrefixes die keine Schlüssel enthalten.

ListObjectVersions

(zuvor GET Bucket Object-Versionen genannt)

Mit Lesezugriff auf einen Bucket kann dieser Vorgang mit dem versions Die Unterressource listet Metadaten aller Versionen von Objekten im Bucket auf.

PutBucketCors

Legt die CORS-Konfiguration für einen Bucket fest, sodass der Bucket Cross-Origin-Anfragen verarbeiten kann. Cross-Origin Resource Sharing (CORS) ist ein Sicherheitsmechanismus, der es Client-Webanwendungen in einer Domäne ermöglicht, auf Ressourcen in einer anderen Domäne zuzugreifen. Angenommen, Sie verwenden einen S3-Bucket namens images zum Speichern von Grafiken. Durch Festlegen der CORS-Konfiguration für die images Bucket, können Sie die Anzeige der Bilder in diesem Bucket auf der Website zulassen http://www.example.com .

PutBucketEncryption

Legt den Standardverschlüsselungsstatus eines vorhandenen Buckets fest. Wenn die Verschlüsselung auf Bucket-Ebene aktiviert ist, werden alle neuen Objekte, die dem Bucket hinzugefügt werden, verschlüsselt. StorageGRID unterstützt serverseitige Verschlüsselung mit von StorageGRID verwalteten Schlüsseln. Wenn Sie die serverseitige Verschlüsselungskonfigurationsregel angeben, legen Sie die SSEAlgorithm Parameter auf AES256 und verwenden Sie nicht die KMSMasterKeyID Parameter.

Die Standardverschlüsselungskonfiguration des Buckets wird ignoriert, wenn die Objekt-Upload-Anforderung bereits eine Verschlüsselung angibt (d. h. wenn die Anforderung die x-amz-server-side-encryption-* Anforderungsheader).

PutBucketLifecycleConfiguration

(früher PUT Bucket-Lebenszyklus genannt)

Erstellt eine neue Lebenszykluskonfiguration für den Bucket oder ersetzt eine vorhandene Lebenszykluskonfiguration. StorageGRID unterstützt bis zu 1.000 Lebenszyklusregeln in einer Lebenszykluskonfiguration. Jede Regel kann die folgenden XML-Elemente enthalten:

  • Ablauf (Tage, Datum, ExpiredObjectDeleteMarker)

  • NoncurrentVersionExpiration (NewerNoncurrentVersions, NoncurrentDays)

  • Filter (Präfix, Tag)

  • Status

  • AUSWEIS

StorageGRID unterstützt diese Aktionen nicht:

  • AbbruchUnvollständigMehrteiliger Upload

  • Übergang

Weitere Informationen finden Sie unter "Erstellen einer S3-Lebenszykluskonfiguration". Weitere Informationen darüber, wie die Ablaufaktion im Lebenszyklus eines Buckets mit ILM-Platzierungsanweisungen interagiert, finden Sie unter "Funktionsweise von ILM während der gesamten Lebensdauer eines Objekts".

Hinweis: Die Bucket-Lebenszykluskonfiguration kann mit Buckets verwendet werden, bei denen die S3-Objektsperre aktiviert ist, wird jedoch für ältere Compliant Buckets nicht unterstützt.

PutBucketNotificationConfiguration

(früher PUT Bucket-Benachrichtigung genannt)

Konfiguriert Benachrichtigungen für den Bucket mithilfe der im Anforderungstext enthaltenen Benachrichtigungskonfigurations-XML. Sie sollten sich der folgenden Implementierungsdetails bewusst sein:

  • StorageGRID unterstützt Amazon Simple Notification Service (Amazon SNS) oder Kafka-Themen als Ziele. Simple Queue Service (SQS) oder Amazon Lambda-Endpunkte werden nicht unterstützt.

  • Das Ziel für Benachrichtigungen muss als URN eines StorageGRID Endpunkts angegeben werden. Endpunkte können mit dem Tenant Manager oder der Tenant Management API erstellt werden.

    Der Endpunkt muss vorhanden sein, damit die Benachrichtigungskonfiguration erfolgreich ist. Wenn der Endpunkt nicht existiert, wird ein 400 Bad Request Fehler wird mit dem Code zurückgegeben InvalidArgument .

  • Für die folgenden Ereignistypen können Sie keine Benachrichtigung konfigurieren. Diese Ereignistypen werden nicht unterstützt.

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • Von StorageGRID gesendete Ereignisbenachrichtigungen verwenden das standardmäßige JSON-Format, mit der Ausnahme, dass sie einige Schlüssel nicht enthalten und für andere bestimmte Werte verwenden, wie in der folgenden Liste gezeigt:

    • Ereignisquelle

      sgws:s3

    • awsRegion

      nicht enthalten

    • x-amz-id-2

      nicht enthalten

    • arn

      urn:sgws:s3:::bucket_name

PutBucketPolicy

Legt die dem Bucket zugeordnete Richtlinie fest. Weitere Informationen unter "Verwenden Sie Bucket- und Gruppenzugriffsrichtlinien".

PutBucketReplication

Konfiguriert"StorageGRID CloudMirror-Replikation" für den Bucket unter Verwendung der im Anforderungstext bereitgestellten XML-Replikationskonfiguration. Bei der CloudMirror-Replikation sollten Sie die folgenden Implementierungsdetails beachten:

  • StorageGRID unterstützt ausschließlich die Replikationskonfiguration V1. Das bedeutet, dass StorageGRID die Verwendung des Filter Elements für Regeln nicht unterstützt und die V1-Konventionen für das Löschen von Objektversionen anwendet. Weitere Informationen finden Sie unter "Amazon Simple Storage Service-Benutzerhandbuch: Replikationskonfiguration".

  • Die Bucket-Replikation kann für versionierte oder nicht versionierte Buckets konfiguriert werden.

  • Sie können in jeder Regel der XML-Replikationskonfiguration einen anderen Ziel-Bucket angeben. Ein Quell-Bucket kann in mehr als einen Ziel-Bucket repliziert werden.

  • Ziel-Buckets müssen als URN von StorageGRID Endpunkten angegeben werden, wie im Tenant Manager oder der Tenant Management API definiert. Weitere Informationen unter "Konfigurieren der CloudMirror-Replikation".

    Der Endpunkt muss vorhanden sein, damit die Replikationskonfiguration erfolgreich ist. Wenn der Endpunkt nicht existiert, schlägt die Anfrage fehl, da 400 Bad Request Die Fehlermeldung lautet: Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • Sie müssen in der Konfigurations-XML keinen Role angeben. Dieser Wert wird von StorageGRID nicht verwendet und bei der Übermittlung ignoriert.

  • Wenn Sie die Speicherklasse aus der Konfigurations-XML weglassen, verwendet StorageGRID die STANDARD Speicherklasse standardmäßig.

  • Wenn Sie ein Objekt aus dem Quell-Bucket oder den Quell-Bucket selbst löschen, ist das regionsübergreifende Replikationsverhalten wie folgt:

    • Wenn Sie das Objekt oder den Bucket löschen, bevor die Replizierung erfolgt ist, wird das Objekt bzw. der Bucket nicht repliziert, und Sie erhalten keine Benachrichtigung.

    • Wenn Sie das Objekt oder den Bucket nach der Replikation löschen, folgt StorageGRID dem standardmäßigen Löschverhalten von Amazon S3 für V1 der regionsübergreifenden Replikation.

PutBucketTagging

Verwendet die tagging Unterressource zum Hinzufügen oder Aktualisieren eines Satzes von Tags für einen Bucket. Beachten Sie beim Hinzufügen von Bucket-Tags die folgenden Einschränkungen:

  • Sowohl StorageGRID als auch Amazon S3 unterstützen bis zu 50 Tags für jeden Bucket.

  • Mit einem Bucket verknüpfte Tags müssen eindeutige Tag-Schlüssel haben. Ein Tag-Schlüssel kann bis zu 128 Unicode-Zeichen lang sein.

  • Tag-Werte können bis zu 256 Unicode-Zeichen lang sein.

  • Bei Schlüsseln und Werten wird zwischen Groß- und Kleinschreibung unterschieden.

Achtung: Wenn für diesen Bucket ein nicht standardmäßiges ILM-Policy-Tag festgelegt ist, gibt es ein NTAP-SG-ILM-BUCKET-TAG Bucket-Tag mit einem zugewiesenen Wert. Es ist sicherzustellen, dass das NTAP-SG-ILM-BUCKET-TAG Bucket-Tag mit dem zugewiesenen Wert in allen PutBucketTagging-Anfragen enthalten ist. Dieses Tag sollte weder geändert noch entfernt werden.

Hinweis: Dieser Vorgang überschreibt alle aktuellen Tags, die der Bucket bereits hat. Wenn vorhandene Tags aus dem Set weggelassen werden, werden diese Tags für den Bucket entfernt.

PutBucketVersioning

Verwendet die versioning Unterressource zum Festlegen des Versionsstatus eines vorhandenen Buckets. Sie können den Versionsstatus mit einem der folgenden Werte festlegen:

  • Aktiviert: Aktiviert die Versionierung für die Objekte im Bucket. Alle dem Bucket hinzugefügten Objekte erhalten eine eindeutige Versions-ID.

  • Angehalten: Deaktiviert die Versionierung für die Objekte im Bucket. Alle zum Bucket hinzugefügten Objekte erhalten die Versions-ID null .

PutObjectLockConfiguration

Konfiguriert oder entfernt den Standardaufbewahrungsmodus und die Standardaufbewahrungsdauer des Buckets.

Wird die Standardaufbewahrungsfrist geändert, bleibt das Aufbewahrungsdatum für bestehende Objektversionen unverändert und wird nicht anhand der neuen Standardaufbewahrungsfrist neu berechnet.

Sehen"Verwenden Sie die S3 REST API, um S3 Object Lock zu konfigurieren" für detaillierte Informationen.