ONTAP S3 unterstützte Aktionen
ONTAP S3-Aktionen werden von den Standard-S3-REST-APIs unterstützt, sofern nachfolgend nichts anderes angegeben ist. Weitere Informationen enthält die "Amazon S3 API-Referenz".
|
|
Diese S3-Aktionen werden speziell bei der Verwendung von nativen S3-Buckets in ONTAP unterstützt. Einige dieser Aktionen, wie beispielsweise solche im Zusammenhang mit Versionierung, Objektsperren und anderen Funktionen, werden bei der Verwendung von "S3 NAS Buckets (S3 in Multiprotokoll NAS Volumes)" nicht unterstützt. |
Sofern für einen bestimmten Vorgang nichts anderes angegeben ist, werden ab ONTAP 9.8 die folgenden gängigen Anforderungsheader unterstützt:
-
Authorization -
Connection -
Content-Length -
Content-MD5 -
Content-Type -
Date -
Expect -
Host -
x-amz-date
Ab ONTAP 9.20.1 werden die folgenden Prüfsummen-Header für S3 NAS Buckets unterstützt:
-
x-amz-checksum-algorithm -
x-amz-checksum-crc64nvme -
x-amz-checksum-type
Bucket-Operationen
Die folgenden Operationen werden in ONTAP mit AWS S3 APIs unterstützt:
| Bucket-Operation | ONTAP Unterstützung ab |
|---|---|
CreateBucket ONTAP S3 unterstützt diesen zusätzlichen Header:
|
ONTAP 9.11.1 |
DeleteBucket |
ONTAP 9.11.1 |
DeleteBucketCors |
ONTAP 9.8 |
DeleteBucketLifecycle |
ONTAP 9.8 |
DeleteBucketPolicy |
ONTAP 9.12.1 |
GetBucketAcl |
ONTAP 9.8 |
GetBucketCors |
ONTAP 9.8 |
GetBucketLifecycleConfiguration |
ONTAP 9.13.1 *Es werden nur Ablaufaktionen unterstützt |
GetBucketLocation |
ONTAP 9.10.1 |
GetBucketPolicy |
ONTAP 9.12.1 |
GetBucketVersioning |
ONTAP 9.11.1 |
HeadBucket |
ONTAP 9.8 |
ListAllMyBuckets |
ONTAP 9.8 |
ListBuckets |
ONTAP 9.8 |
ListBucketVersions |
ONTAP 9.11.1 |
PutBucket |
|
PutBucketCors |
ONTAP 9.8 |
PutBucketLifecycleConfiguration |
ONTAP 9.13.1 * Nur Ablaufaktionen werden unterstützt |
PutBucketPolicy |
ONTAP 9.12.1 |
PutBucketVersioning |
ONTAP 9.11.1 |
Objektoperationen
Ab ONTAP 9.19.1 unterstützt ONTAP S3 die Durchsetzung bedingter Schreibvorgänge beim Hochladen von Objekten und bedingter Löschvorgänge beim Löschen von Objekten. Bedingte Schreib- und Löschvorgänge bieten eine Möglichkeit, das Überschreiben oder unbeabsichtigte Löschen von Objekten zu verhindern. Bedingte Operationen funktionieren nur, wenn die Anfrage mit der AWS_V4-Signaturmethode über eine TLS-Verbindung gestellt wird. Die folgenden bedingten Header und Objektoperationen werden unterstützt:
| Objektoperation | Bedingter Header |
|---|---|
PutObject CopyObject CompleteMultipartUpload |
If-None-Match If-Match |
DeleteObject DeleteObjects |
If-Match |
Ab ONTAP 9.20.1 unterstützt ONTAP S3 flexible Prüfsummen für S3 NAS-Buckets.
-
ONTAP validiert, speichert und gibt Prüfsummen zurück, wenn Clients Prüfsummen-Header in Anfragen einfügen.
-
Es werden nur der CRC-64NVME-Algorithmus und der
FULL_OBJECTPrüfsummentyp unterstützt. -
Die Unterstützung für flexible Prüfsummen gilt nur für S3 NAS-Buckets.
Ab ONTAP 9.9.1 unterstützt ONTAP S3 Objektmetadaten und Tagging.
-
PutObject und CreateMultipartUpload enthalten Schlüssel-Wert-Paare mithilfe von
x-amz-meta-<key>.Zum Beispiel:
x-amz-meta-project: ontap_s3. -
GetObject und HeadObject geben benutzerdefinierte Metadaten zurück.
-
Im Gegensatz zu Metadaten können Tags unabhängig von Objekten gelesen werden mit:
-
PutObjectTagging
-
GetObjectTagging
-
DeleteObjectTagging
-
Ab ONTAP 9.11.1 unterstützt ONTAP S3 die Objektversionierung und zugehörige Aktionen mit diesen ONTAP APIs:
-
GetBucketVersioning
-
ListBucketVersions
-
PutBucketVersioning
Sofern für eine bestimmte Operation nicht anders angegeben, wird der folgende URI-Abfrageparameter unterstützt:
-
versionId(wie für Objektoperationen ab ONTAP 9.12.1 erforderlich)
| Objektoperation | ONTAP Unterstützung ab |
|---|---|
AbortMultipartUpload ONTAP S3 unterstützt diesen zusätzlichen URI-Abfrageparameter:
|
ONTAP 9.8 |
CompleteMultipartUpload ONTAP S3 unterstützt diesen zusätzlichen URI-Abfrageparameter:
|
ONTAP 9.8 |
CopyObject ONTAP S3 unterstützt diese zusätzlichen Header:
|
ONTAP 9.12.1 |
CreateMultipartUpload ONTAP S3 unterstützt diese zusätzlichen Header:
|
ONTAP 9.8 |
DeleteObject ONTAP S3 unterstützt diesen zusätzlichen Header:
|
ONTAP 9.8 |
DeleteObjects ONTAP S3 unterstützt diesen zusätzlichen Header: * |
ONTAP 9.11.1 |
DeleteObjectTagging |
ONTAP 9.9.1 |
GetObject ONTAP S3 unterstützt diese zusätzlichen URI-Abfrageparameter:
Und diese zusätzlichen Anfrage-Header:
|
ONTAP 9.8 |
GetObjectAcl |
ONTAP 9.8 |
GetObjectAttributes ONTAP S3 unterstützt alle gängigen Parameter und Header für diese Anforderung, ONTAP S3 unterstützt außerdem diesen zusätzlichen Header:
|
ONTAP 9.17.1 |
GetObjectRetention |
ONTAP 9.14.1 |
GetObjectTagging |
ONTAP 9.9.1 |
HeadObject ONTAP S3 unterstützt alle gängigen Parameter und Header für diese Anfrage. |
ONTAP 9.8 |
ListMultipartUploads ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
|
ONTAP 9.8 |
ListObjects ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
|
ONTAP 9.8 |
ListObjectsV2 ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
|
ONTAP 9.8 |
ListObjectVersions ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
|
ONTAP 9.11.1 |
ListParts ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
|
ONTAP 9.8 |
PutObject ONTAP S3 unterstützt diese zusätzlichen Header:
|
ONTAP 9.8 |
PutObjectLockConfiguration |
ONTAP 9.14.1 |
PutObjectRetention ONTAP S3 unterstützt diesen zusätzlichen Header:
|
ONTAP 9.14.1 |
PutObjectTagging |
ONTAP 9.9.1 |
UploadPart ONTAP S3 unterstützt alle gängigen Parameter und Header für diese Anfrage. |
ONTAP 9.8 |
UploadPartCopy ONTAP S3 unterstützt diese zusätzlichen URI-Parameter:
Und diese zusätzlichen Anfrage-Header:
|
ONTAP 9.12.1 |
Gruppenrichtlinien
Diese Operationen sind nicht S3-spezifisch und werden im Allgemeinen mit Identitäts- und Verwaltungsprozessen (IAM) in Verbindung gebracht. ONTAP unterstützt diese Befehle, verwendet jedoch nicht die IAM REST-APIs.
-
Richtlinie erstellen
-
AttachGroup Richtlinie
Benutzerverwaltung
Diese Operationen sind nicht spezifisch für S3 und stehen im Allgemeinen im Zusammenhang mit IAM-Prozessen.
-
CreateUser
-
DeleteUser
-
CreateGroup
-
DeleteGroup
S3-Aktionen nach Release
Ab ONTAP 9.20.1 unterstützen S3 NAS-Buckets auf FlexCache Volumes serverseitige Objektkopiervorgänge mithilfe der S3 CopyObject und UploadPartCopy APIs. Objekte lassen sich innerhalb desselben FlexCache NAS-Buckets oder von einem S3 NAS-Bucket, der auf einem FlexGroup Volume basiert, in einen FlexCache NAS-Bucket kopieren. Das Kopieren von einem S3 NAS-Bucket, der auf einem FlexVol Volume basiert, in einen FlexCache NAS-Bucket, zwischen zwei FlexCache NAS-Buckets oder von einem FlexCache NAS-Bucket in einen Nicht-FlexCache NAS-Bucket wird nicht unterstützt.
ONTAP 9.20.1 bietet Unterstützung für flexible Prüfsummen mithilfe des CRC-64NVME Algorithmus für S3 NAS-Buckets. ONTAP validiert, speichert und gibt Prüfsummen zurück, wenn Clients Prüfsummen-Header in Anfragen einfügen. Die folgenden Operationen unterstützen flexible Prüfsummen-Header:
-
PutObject
-
CreateMultipartUpload
-
UploadPart
-
CompleteMultipartUpload
-
CopyObject
-
UploadPartCopy
-
GetObject
-
HeadObject
-
ListObjectsV2
-
ListParts
Unterstützt werden nur der CRC-64NVME-Algorithmus und der Prüfsummentyp FULL_OBJECT. Flexible Prüfsummenunterstützung ist nur für S3 NAS Buckets verfügbar.
ONTAP 9.14.1 bietet Unterstützung für S3 Object Lock.
|
|
Legal hold-Operationen (Sperren ohne festgelegte Aufbewahrungszeiten) sind nicht unterstützt. |
-
GetObjectLockConfiguration
-
GetObjectRetention
-
PutObjectLockConfiguration
-
PutObjectRetention
ONTAP 9.13.1 bietet Unterstützung für das Bucket Lifecycle Management.
-
DeleteBucketLifecycleConfiguration
-
GetBucketLifecycleConfiguration
-
PutBucketLifecycleConfiguration
ONTAP 9.12.1 bietet Unterstützung für Bucket-Richtlinien und die Möglichkeit, Objekte zu kopieren.
-
DeleteBucketPolicy
-
GetBucketPolicy
-
PutBucketPolicy
-
CopyObject
-
UploadPartCopy
ONTAP 9.11.1 bietet Unterstützung für Versionierung, vorab signierte URLs, Chunked Uploads und Unterstützung für gängige S3-Aktionen wie das Erstellen und Löschen von Buckets mit S3-APIs.
-
ONTAP S3 bietet Unterstützung für das Signieren von Anfragen für Chunked Uploads unter Verwendung von
x-amz-content-sha256: STREAMING-AWS4-HMAC-SHA256-PAYLOAD -
ONTAP S3 unterstützt jetzt Clientanwendungen, die vorab signierte URLs verwenden, um Objekte freizugeben oder anderen Benutzern das Hochladen von Objekten zu ermöglichen, ohne dass Benutzeranmeldeinformationen erforderlich sind.
-
CreateBucket
-
DeleteBucket
-
GetBucketVersioning
-
ListBucketVersions
-
PutBucket
-
PutBucketVersioning
-
DeleteObjects
-
ListObjectVersions
|
|
Da die zugrundeliegende FlexGroup erst erstellt wird, wenn der erste Bucket erstellt wird, muss zunächst ein Bucket in ONTAP erstellt werden, bevor ein externer Client mit CreateBucket einen Bucket erstellen kann. |
ONTAP 9.10.1 bietet Unterstützung für SnapMirror S3 und GetBucketLocation.
-
GetBucketLocation
ONTAP 9.9.1 erweitert ONTAP S3 um Unterstützung für Objektmetadaten und Tagging.
-
PutObject und CreateMultipartUpload enthalten jetzt Schlüssel-Wert-Paare mit
x-amz-meta-<key>. Zum Beispiel:x-amz-meta-project: ontap_s3. -
GetObject und HeadObject geben nun benutzerdefinierte Metadaten zurück.
Tags können auch mit Buckets verwendet werden. Im Gegensatz zu Metadaten können Tags unabhängig von Objekten gelesen werden mit:
-
PutObjectTagging
-
GetObjectTagging
-
DeleteObjectTagging