Skip to main content
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Unterstützte Versionen und Updates der StorageGRID S3 REST API

Beitragende netapp-pcarriga netapp-maireadn netapp-lhalbert netapp-perveilerk netapp-jsnyder
Änderungen vorschlagen
PDFs

StorageGRID unterstützt die S3-API (Simple Storage Service), die als Satz Rest-Web-Services (Representational State Transfer) implementiert wird.

Dank der Unterstützung für die S3-REST-API können serviceorientierte Applikationen, die für S3-Web-Services entwickelt wurden, mit On-Premises-Objekt-Storage verbunden werden, der das StorageGRID-System verwendet. Es sind minimale Änderungen an der aktuellen Nutzung von S3-REST-API-Aufrufen einer Client-Applikation erforderlich.

Unterstützte Versionen

StorageGRID unterstützt die folgenden spezifischen Versionen von STS, S3 und HTTP:

Element Version

STS AssumeRole-API-Spezifikation

"Amazon Web Services (AWS)-Dokumentation: Amazon Assumerole API-Referenz"

Weitere Informationen zu AssumeRole finden Sie unter"Einrichten von AssumeRole" .

S3-API-Spezifikation

"AWS-Dokumentation: Amazon Simple Storage Service API-Referenz"

HTTP

1,1

Weitere Informationen zu HTTP finden Sie unter HTTP/1.1 (RFCs 7230-35).

"IETF RFC 2616: Hypertext Transfer Protocol (HTTP/1.1)"

Hinweis: StorageGRID unterstützt HTTP/1.1-Pipelining nicht.

Updates für die S3-REST-API-Unterstützung

Freigabe Kommentare

12.1.0

  • If-Match

    Der `If-Match`Header verhält sich je nach Ihrer StorageGRID Konfiguration unterschiedlich. Das Bereitstellen dieses Headers kann eine Fehlermeldung (501 Not Implemented) zurückgeben. Wenn der `If-Match`Header akzeptiert, aber nicht funktionsfähig ist, kann eine Warnung mit Hinweisen zur Aktivierung des strengeren 501 Not Implemented Fehlerverhaltens ausgelöst werden.

  • If-None-Match

    Der `If-None-Match`Header verhält sich je nach Ihrer StorageGRID Konfiguration unterschiedlich. Das Bereitstellen dieses Headers kann eine Fehlermeldung (501 Not Implemented) zurückgeben. Wenn der `If-None-Match`Header akzeptiert, aber nicht funktionsfähig ist, kann eine Warnung mit Hinweisen zur Aktivierung des strengeren 501 Not Implemented Fehlerverhaltens ausgelöst werden.

  • Unterstützung für vorab berechnete Prüfsummenwerte für die folgenden Anfragen und unterstützten Header hinzugefügt:

    • CompleteMultipartUpload: x-amz-checksum-crc32, x-amz-checksum-crc32c und x-amz-checksum-crc64nvme

    • CreateMultipartUpload: CRC32, CRC32C, und CRC64NVME für x-amz-checksum-algorithm

    • CopyObject: CRC32, CRC32C, CRC64NVME, und SHA256 für x-amz-checksum-algorithm

    • PutObject: x-amz-checksum-crc32, x-amz-checksum-crc32c, und x-amz-checksum-crc64nvme

    • UploadPart: x-amz-checksum-crc32, x-amz-checksum-crc32c, und x-amz-checksum-crc64nvme

  • Unterstützung für x-amz-checksum-type für CreateMultipartUpload und CompleteMultipartUpload hinzugefügt.

  • Unterstützung für den `s3:x-amz-copy-source`Richtlinienbedingungsschlüssel wurde hinzugefügt.

  • Die S3-Objektsperre kann für bestehende Buckets aktiviert werden.

12,0

  • Unterstützung für Cross-Origin Resource Sharing (CORS) für eine Verwaltungsschnittstelle hinzugefügt, die es einer anderen Domäne ermöglicht, mithilfe von Verwaltungs-APIs auf Daten in StorageGRID zuzugreifen. "Weitere Informationen ." .

  • Unterstützung für STS AssumeRole und Sitzungsrichtlinien wurde hinzugefügt. Siehe "ein Beispiel für eine Sitzungsrichtlinie". AssumeRole kann unter Mandantengruppen eingerichtet werden.

11,9

  • Unterstützung für vorberechnete SHA-256-Prüfsummenwerte für die folgenden Anforderungen und unterstützten Header wurde hinzugefügt. Mit dieser Funktion können Sie die Integrität hochgeladener Objekte überprüfen:

    • CompleteMultipartUpload: x-amz-checksum-sha256

    • CreateMultipartUpload: x-amz-checksum-algorithm

    • GetObject: x-amz-checksum-mode

    • Kopfobjekt: x-amz-checksum-mode

    • ListenTeile

    • PutObject: x-amz-checksum-sha256

    • UploadPart: x-amz-checksum-sha256

  • Der Grid-Administrator kann die Aufbewahrungs- und Compliance-Einstellungen auf Mandantenebene kontrollieren. Diese Einstellungen wirken sich auf die Einstellungen der S3-Objektsperre aus.

    • Standardaufbewahrungsmodus und Objektaufbewahrungsmodus mit Buckets: Governance oder Compliance, sofern vom Grid-Administrator zugelassen.

    • Standardaufbewahrungszeitraum für Bucket und Objektaufbewahrung bis Datum: Muss kleiner oder gleich dem sein, was durch den vom Grid-Administrator festgelegten maximalen Aufbewahrungszeitraum zulässig ist.

  • Verbesserte Unterstützung von aws-chunked Kodierungs- und Streaming-Werten für Inhalte x-amz-content-sha256. Einschränkungen:

    • Falls vorhanden, chunk-signature ist optional und nicht validiert

    • Wenn vorhanden, x-amz-trailer wird der Inhalt ignoriert

11,8

Die Namen der S3-Vorgänge wurden aktualisiert, um sie mit den in der verwendeten Namen "Amazon Web Services (AWS) Dokumentation: Amazon Simple Storage Service API Reference" zu vergleichen.

11,7

  • Hinzugefügt "Schnelle Referenz: Unterstützte S3-API-Anforderungen".

  • Zusätzliche Unterstützung für die Verwendung DES GOVERNANCE-Modus mit S3 Object Lock.

  • Unterstützung für den StorageGRID-spezifischen Antwortheader für GET Object- und HEAD-Objektanforderungen wurde hinzugefügt x-ntap-sg-cgr-replication-status. Dieser Header stellt den Replikationsstatus eines Objekts für die Grid-übergreifende Replikation bereit.

  • SelectObjectContent Requests unterstützen nun Parkett-Objekte.

11,6

  • Unterstützung für die Verwendung des Anforderungsparameters in GET Object und HEAD Object Requests hinzugefügt partNumber.

  • Zusätzliche Unterstützung für einen Standardaufbewahrungsmodus und einen Standardaufbewahrungszeitraum auf Bucket-Ebene für S3 Object Lock.

  • Unterstützung für den Richtlinienzustandsschlüssel hinzugefügt s3:object-lock-remaining-retention-days, um den Bereich der zulässigen Aufbewahrungsfristen für Ihre Objekte festzulegen.

  • Die maximale recommended-Größe für einen einzelnen PUT-Objekt-Vorgang wurde auf 5 gib (5,368,709,120 Bytes) geändert. Wenn Sie über Objekte mit einer Größe von mehr als 5 gib verfügen, verwenden Sie stattdessen mehrteilige Uploads.

11,5

  • Zusätzliche Unterstützung für das Management der Bucket-Verschlüsselung

  • Unterstützung für S3 Object Lock und veraltete ältere Compliance-Anforderungen wurde hinzugefügt.

  • Zusätzliche Unterstützung beim LÖSCHEN mehrerer Objekte in versionierten Buckets.

  • Der Content-MD5 Anforderungskopf wird jetzt korrekt unterstützt.

11,4

  • Unterstützung für DELETE Bucket-Tagging, GET Bucket-Tagging und PUT Bucket-Tagging. Kostenzuordnungstags werden nicht unterstützt.

  • Bei in StorageGRID 11.4 erstellten Buckets ist keine Beschränkung der Objektschlüsselnamen auf Performance-Best-Practices mehr erforderlich.

  • Unterstützung für Bucket-Benachrichtigungen für den Ereignistyp hinzugefügt s3:ObjectRestore:Post.

  • Die Größenbeschränkungen von AWS für mehrere Teile werden nun durchgesetzt. Jedes Teil eines mehrteiligen Uploads muss zwischen 5 MiB und 5 gib liegen. Der letzte Teil kann kleiner als 5 MiB sein.

  • Unterstützung für TLS 1.3 hinzugefügt

11,3

  • Zusätzliche Unterstützung für serverseitige Verschlüsselung von Objektdaten mit vom Kunden bereitgestellten Schlüsseln (SSE-C).

  • Unterstützung für DIE Lebenszyklusoperationen „DELETE“, „GET“ und „PUT“ (nur Ablaufaktion) und für den Antwortheader hinzugefügt x-amz-expiration.

  • Aktualisiertes PUT-Objekt, PUT-Objekt – Copy und Multipart-Upload, um die Auswirkungen von ILM-Regeln zu beschreiben, die synchrone Platzierung bei der Aufnahme verwenden.

  • TLS 1.1-Chiffren werden nicht mehr unterstützt.

11,2

Unterstützung für DIE WIEDERHERSTELLUNG NACH Objekten wurde hinzugefügt und kann in Cloud-Storage-Pools verwendet werden. Unterstützung für die Verwendung der AWS-Syntax für ARN, Richtlinienzustandsschlüssel und Richtlinienvariablen in Gruppen- und Bucket-Richtlinien Vorhandene Gruppen- und Bucket-Richtlinien, die die StorageGRID-Syntax verwenden, werden weiterhin unterstützt.

Hinweis: die Verwendung von ARN/URN in anderen Konfigurationen JSON/XML, einschließlich derjenigen, die in benutzerdefinierten StorageGRID-Funktionen verwendet werden, hat sich nicht geändert.

11,1

Zusätzliche Unterstützung für die Cross-Origin Resource Sharing (CORS), HTTP für S3-Clientverbindungen zu Grid-Nodes und Compliance-Einstellungen für Buckets.

11,0

Unterstützung für die Konfiguration von Plattform-Services (CloudMirror Replizierung, Benachrichtigungen und Elasticsearch-Integration) für Buckets. Außerdem wurden die Unterstützung für Objekt-Tagging-Speicherortbeschränkungen für Buckets und die verfügbare Konsistenz hinzugefügt.

10,4

Unterstützung für ILM-Scanning-Änderungen an Versionierung, Seitenaktualisierungen von Endpoint Domain-Namen, Bedingungen und Variablen in Richtlinien, Richtlinienbeispiele und die Berechtigung PutOverwriteObject.

10,3

Zusätzliche Unterstützung für Versionierung

10,2

Unterstützung für Gruppen- und Bucket-Zugriffsrichtlinien und für mehrteilige Kopien (Upload Part - Copy) hinzugefügt

10,1

Unterstützung für Multipart-Upload, Virtual-Hosted-Anfragen und v4-Authentifizierung wurde hinzugefügt.

10,0

Erste Unterstützung der S3 REST API durch das StorageGRID -System. Die derzeit unterstützte Version der Simple Storage Service API Reference ist 2006-03-01.