Azioni supportate da ONTAP S3
Le azioni di ONTAP S3 sono supportate dalle API REST S3 standard, ad eccezione di quanto indicato di seguito. Per ulteriori informazioni, vedere "Riferimento API Amazon S3".
|
|
Queste azioni S3 sono supportate in modo specifico quando si utilizzano bucket S3 nativi in ONTAP. Alcune di queste azioni, ad esempio quelle associate al controllo delle versioni, ai blocchi degli oggetti e ad altre funzionalità, non sono supportate quando si utilizza "Bucket S3 NAS (S3 PB in volumi NAS multiprotocollo)". |
A meno che non sia diversamente specificato per un'operazione specifica, a partire da ONTAP 9.8 sono supportate le seguenti intestazioni di richiesta comuni:
-
Authorization -
Connection -
Content-Length -
Content-MD5 -
Content-Type -
Date -
Expect -
Host -
x-amz-date
Operazioni della benna
In ONTAP sono supportate le seguenti operazioni utilizzando le API AWS S3:
| Funzionamento della benna | Supporto ONTAP a partire da |
|---|---|
CreateBucket ONTAP S3 supporta questa intestazione aggiuntiva:
|
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 *Sono supportate solo le azioni di scadenza |
GetBucketLocation |
ONTAP 9.10.1 |
GetBucketPolicy |
ONTAP 9.12.1 |
GetBucketVersioning |
ONTAP 9.11.1 |
HeadBucket |
ONTAP 9.8 |
ListAllMyBuckets |
ONTAP 9.8 |
ListBucket |
ONTAP 9.8 |
ListBucketVersions |
ONTAP 9.11.1 |
PutBucket |
|
PutBucketCors |
ONTAP 9.8 |
PutBucketLifecycleConfiguration |
ONTAP 9.13.1 * sono supportate solo le azioni di scadenza |
PutBucketPolicy |
ONTAP 9.12.1 |
PutBucketVersioning |
ONTAP 9.11.1 |
Operazioni a oggetti
A partire da ONTAP 9.19.1, ONTAP S3 supporta l'applicazione di scritture condizionali per il caricamento di oggetti e cancellazioni condizionali per la cancellazione di oggetti. Le scritture e le cancellazioni condizionali consentono di prevenire sovrascritture o cancellazioni involontarie di oggetti. Le operazioni condizionali funzionano solo se la richiesta viene effettuata utilizzando il metodo di firma AWS_V4 su una connessione TLS. Sono supportate le seguenti intestazioni condizionali e operazioni sugli oggetti:
| Operazione a oggetti | Intestazione condizionale |
|---|---|
PutObject Oggetto CopyObject CompleteMultipartUpload |
If-None-Match If-Match |
DeleteObject (Elimina oggetto) DeleteObjects |
If-Match |
A partire da ONTAP 9.9.1, ONTAP S3 supporta metadati e tagging degli oggetti.
-
PutObject e CreateMultipartUpload includono coppie chiave-valore utilizzando
x-amz-meta-<key>.Ad esempio:
x-amz-meta-project: ontap_s3. -
GetObject e HeadObject restituiscono metadati definiti dall'utente.
-
A differenza dei metadati, i tag possono essere letti indipendentemente dagli oggetti utilizzando:
-
PutObjectTagging
-
GetObjectTagging
-
DeleteObjectTagging
-
A partire da ONTAP 9.11.1, ONTAP S3 supporta il controllo della versione degli oggetti e le azioni associate a queste API ONTAP:
-
GetBucketVersioning
-
ListBucketVersions
-
PutBucketVersioning
A meno che non sia diversamente specificato per un'operazione specifica, sono supportati i seguenti parametri di query URI:
-
versionId(come richiesto per le operazioni sugli oggetti a partire da ONTAP 9.12.1)
| Operazione a oggetti | Supporto ONTAP a partire da |
|---|---|
AbortMultipartUpload ONTAP S3 supporta questo parametro di query URI aggiuntivo:
|
ONTAP 9.8 |
CompleteMultipartUpload ONTAP S3 supporta questo parametro di query URI aggiuntivo:
|
ONTAP 9.8 |
Oggetto CopyObject ONTAP S3 supporta queste ulteriori intestazioni:
|
ONTAP 9.12.1 |
CreateMultipartUpload ONTAP S3 supporta queste ulteriori intestazioni:
|
ONTAP 9.8 |
DeleteObject (Elimina oggetto) ONTAP S3 supporta questa intestazione aggiuntiva:
|
ONTAP 9.8 |
DeleteObjects ONTAP S3 supporta questa intestazione aggiuntiva: * |
ONTAP 9.11.1 |
DeleteObjectTagging |
ONTAP 9.9.1 |
GetObject ONTAP S3 supporta questi parametri di query URI aggiuntivi:
E questa ulteriore intestazione di richiesta:
|
ONTAP 9.8 |
GetObjectAcl |
ONTAP 9.8 |
Ottieni attributi oggetto ONTAP S3 supporta questa intestazione aggiuntiva:
|
ONTAP 9.17.1 |
GetObjectRetention |
ONTAP 9.14.1 |
GetObjectTagging |
ONTAP 9.9.1 |
HeadObject (oggetto intestazione) |
ONTAP 9.8 |
ListMultipartUploads ONTAP S3 supporta questi parametri URI aggiuntivi:
|
ONTAP 9.8 |
ListObjects (oggetti elenco) ONTAP S3 supporta questi parametri URI aggiuntivi:
|
ONTAP 9.8 |
ListObjectsV2 ONTAP S3 supporta questi parametri URI aggiuntivi:
|
ONTAP 9.8 |
ListObjectVersions ONTAP S3 supporta questi parametri URI aggiuntivi:
|
ONTAP 9.11.1 |
ListParts ONTAP S3 supporta questi parametri URI aggiuntivi:
|
ONTAP 9.8 |
PutObject ONTAP S3 supporta queste ulteriori intestazioni:
|
ONTAP 9.8 |
PutObjectLockConfiguration |
ONTAP 9.14.1 |
PutObjectRetention ONTAP S3 supporta questa intestazione aggiuntiva:
|
ONTAP 9.14.1 |
PutObjectTagging |
ONTAP 9.9.1 |
UploadPart |
ONTAP 9.8 |
UploadPartCopy ONTAP S3 supporta questi parametri URI aggiuntivi:
E queste intestazioni di richiesta aggiuntive:
|
ONTAP 9.12.1 |
Policy di gruppo
Queste operazioni non sono specifiche di S3 e sono generalmente associate ai processi di identità e gestione (IAM). ONTAP supporta questi comandi ma non utilizza le API REST IAM.
-
Crea policy
-
Policy AttachGroup
Gestione degli utenti
Queste operazioni non sono specifiche di S3 e sono generalmente associate ai processi IAM.
-
CreateUser
-
DeleteUser
-
CreateGroup
-
DeleteGroup
S3 azioni per rilascio
ONTAP 9.14,1 aggiunge il supporto per blocco oggetti S3.
|
|
Le operazioni di conservazione a fini giudiziari (blocchi senza tempi di conservazione definiti) non sono supportate. |
-
GetObjectLockConfiguration
-
GetObjectRetention
-
PutObjectLockConfiguration
-
PutObjectRetention
ONTAP 9.13,1 aggiunge supporto per la gestione del ciclo di vita dei bucket.
-
DeleteBucketLifecycleConfiguration
-
GetBucketLifecycleConfiguration
-
PutBucketLifecycleConfiguration
ONTAP 9.12,1 aggiunge il supporto per le policy del bucket e la capacità di copiare gli oggetti.
-
DeleteBucketPolicy
-
GetBucketPolicy
-
PutBucketPolicy
-
Oggetto CopyObject
-
UploadPartCopy
ONTAP 9.11,1 aggiunge il supporto per il controllo delle versioni, gli URL prefirmati, i caricamenti in blocchi e il supporto per le azioni S3 più comuni, come la creazione e l'eliminazione di bucket tramite le API S3.
-
ONTAP S3 aggiunge il supporto per le richieste di firma di caricamenti a blocchi utilizzando
x-amz-content-sha256: STREAMING-AWS4-HMAC-SHA256-PAYLOAD -
ONTAP S3 ora supporta le applicazioni client che utilizzano URL pre-firmati per condividere oggetti o consentire ad altri utenti di caricare oggetti senza richiedere credenziali utente.
-
CreateBucket
-
DeleteBucket
-
GetBucketVersioning
-
ListBucketVersions
-
PutBucket
-
PutBucketVersioning
-
DeleteObjects
-
ListObjectVersions
|
|
Poiché il FlexGroup sottostante non viene creato fino a quando il primo bucket non è, è necessario creare un bucket in ONTAP prima che un client esterno possa creare un bucket utilizzando CreateBucket. |
ONTAP 9.10,1 aggiunge il supporto per SnapMirror S3 e GetBucketLocation.
-
GetBucketLocation
ONTAP 9.9,1 aggiunge il supporto per i metadati degli oggetti e tagging in ONTAP S3.
-
PutObject e CreateMultipartUpload ora includono coppie di valori chiave utilizzando
x-amz-meta-<key>. Ad esempio:x-amz-meta-project: ontap_s3. -
GetObject e HeadObject ora restituiscono metadati definiti dall'utente.
Le etichette possono essere utilizzate anche con i bucket. A differenza dei metadati, i tag possono essere letti indipendentemente dagli oggetti utilizzando:
-
PutObjectTagging
-
GetObjectTagging
-
DeleteObjectTagging