Riferimento rapido: Richieste API S3 supportate
In questa pagina viene riepilogato il modo in cui StorageGRID supporta le API di Amazon Simple Storage Service (S3).
Questa pagina include solo le operazioni S3 supportate da StorageGRID.
Per visualizzare la documentazione AWS relativa a ciascuna operazione, selezionare il collegamento nell'intestazione. |
Parametri di query URI comuni e intestazioni di richiesta
Se non specificato, sono supportati i seguenti parametri di query URI comuni:
-
versionId
(come richiesto per le operazioni a oggetti)
Se non specificato, sono supportate le seguenti intestazioni di richiesta comuni:
-
Authorization
-
Connection
-
Content-Length
-
Content-MD5
-
Content-Type
-
Date
-
Expect
-
Host
-
x-amz-date
"AbortMultipartUpload"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre a questo parametro di query URI aggiuntivo:
-
uploadId
Nessuno
"CompleteMultipartUpload"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre a questo parametro di query URI aggiuntivo:
-
uploadId
-
x-amz-checksum-sha256
StorageGRID supporta questi tag XML del corpo della richiesta:
-
ChecksumSHA256
-
CompleteMultipartUpload
-
ETag
-
Part
-
PartNumber
"Oggetto CopyObject"
StorageGRID supporta tutte parametri e intestazioni comuniqueste richieste, oltre alle seguenti intestazioni aggiuntive:
-
x-amz-copy-source
-
x-amz-copy-source-if-match
-
x-amz-copy-source-if-modified-since
-
x-amz-copy-source-if-none-match
-
x-amz-copy-source-if-unmodified-since
-
x-amz-copy-source-server-side-encryption-customer-algorithm
-
x-amz-copy-source-server-side-encryption-customer-key
-
x-amz-copy-source-server-side-encryption-customer-key-MD5
-
x-amz-metadata-directive
-
x-amz-object-lock-legal-hold
-
x-amz-object-lock-mode
-
x-amz-object-lock-retain-until-date
-
x-amz-server-side-encryption
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
x-amz-storage-class
-
x-amz-tagging
-
x-amz-tagging-directive
-
x-amz-meta-<metadata-name>
Nessuno
"CreateBucket"
StorageGRID supporta tutte parametri e intestazioni comuniqueste richieste, oltre alle seguenti intestazioni aggiuntive:
-
x-amz-bucket-object-lock-enabled
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"CreateMultipartUpload"
StorageGRID supporta tutte parametri e intestazioni comuniqueste richieste, oltre alle seguenti intestazioni aggiuntive:
-
Cache-Control
-
Content-Disposition
-
Content-Encoding
-
Content-Language
-
Expires
-
x-amz-checksum-algorithm
-
x-amz-server-side-encryption
-
x-amz-storage-class
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
x-amz-tagging
-
x-amz-object-lock-mode
-
x-amz-object-lock-retain-until-date
-
x-amz-object-lock-legal-hold
-
x-amz-meta-<metadata-name>
Nessuno
"DeleteBucket"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
"DeleteBucketCors"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteBucketEncryption"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteBucketLifecycle"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteBucketPolicy"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteBucketReplication"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteBucketTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"DeleteObject (Elimina oggetto)"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre all'intestazione della richiesta aggiuntiva:
-
x-amz-bypass-governance-retention
Nessuno
"DeleteObjects"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre all'intestazione della richiesta aggiuntiva:
-
x-amz-bypass-governance-retention
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"DeleteObjectTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketAcl"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketCors"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketEncryption"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketLifecycleConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketLocation"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketNotificationConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketPolicy"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketReplication"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetBucketVersioning"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetObject"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri di query URI aggiuntivi:
-
x-amz-checksum-mode
-
partNumber
-
response-cache-control
-
response-content-disposition
-
response-content-encoding
-
response-content-language
-
response-content-type
-
response-expires
E queste intestazioni di richiesta aggiuntive:
-
Range
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
If-Match
-
If-Modified-Since
-
If-None-Match
-
If-Unmodified-Since
Nessuno
"GetObjectAcl"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"GetObjectLegalHold"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"GetObjectLockConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"GetObjectRetention"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"GetObjectTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"HeadBucket"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"HeadObject (oggetto intestazione)"
StorageGRID supporta tutte parametri e intestazioni comuniqueste richieste, oltre alle seguenti intestazioni aggiuntive:
-
x-amz-checksum-mode
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
If-Match
-
If-Modified-Since
-
If-None-Match
-
If-Unmodified-Since
-
Range
Nessuno
"ListBucket"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Nessuno
"ListMultipartUploads"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri aggiuntivi:
-
encoding-type
-
key-marker
-
max-uploads
-
prefix
-
upload-id-marker
Nessuno
"ListObjects (oggetti elenco)"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri aggiuntivi:
-
delimiter
-
encoding-type
-
marker
-
max-keys
-
prefix
Nessuno
"ListObjectsV2"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri aggiuntivi:
-
continuation-token
-
delimiter
-
encoding-type
-
fetch-owner
-
max-keys
-
prefix
-
start-after
Nessuno
"ListObjectVersions"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri aggiuntivi:
-
delimiter
-
encoding-type
-
key-marker
-
max-keys
-
prefix
-
version-id-marker
Nessuno
"ListParts"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri aggiuntivi:
-
max-parts
-
part-number-marker
-
uploadId
Nessuno
"PutBucketCors"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"PutBucketEncryption"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta questi tag XML del corpo della richiesta:
-
ApplyServerSideEncryptionByDefault
-
Rule
-
ServerSideEncryptionConfiguration
-
SSEAlgorithm
"PutBucketLifecycleConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta questi tag XML del corpo della richiesta:
-
And
-
Days
-
Expiration
-
ExpiredObjectDeleteMarker
-
Filter
-
ID
-
Key
-
LifecycleConfiguration
-
NewerNoncurrentVersions
-
NoncurrentDays
-
NoncurrentVersionExpiration
-
Prefix
-
Rule
-
Status
-
Tag
-
Value
"PutBucketNotificationConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta questi tag XML del corpo della richiesta:
-
Event
-
Filter
-
FilterRule
-
Id
-
Name
-
NotificationConfiguration
-
Prefix
-
S3Key
-
Suffix
-
Topic
-
TopicConfiguration
-
Value
"PutBucketPolicy"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Per informazioni dettagliate sui campi corpo JSON supportati, vedere "Utilizza policy di accesso a bucket e gruppi".
"PutBucketReplication"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
-
Bucket
-
Destination
-
Prefix
-
ReplicationConfiguration
-
Rule
-
Status
-
StorageClass
"PutBucketTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"PutBucketVersioning"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta questi parametri del corpo della richiesta:
-
VersioningConfiguration
-
Status
"PutObject"
StorageGRID supporta tutte parametri e intestazioni comuniqueste richieste, oltre alle seguenti intestazioni aggiuntive:
-
Cache-Control
-
Content-Disposition
-
Content-Encoding
-
Content-Language
-
x-amz-checksum-sha256
-
x-amz-server-side-encryption
-
x-amz-storage-class
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
x-amz-tagging
-
x-amz-object-lock-mode
-
x-amz-object-lock-retain-until-date
-
x-amz-object-lock-legal-hold
-
x-amz-meta-<metadata-name>
-
Dati binari dell'oggetto
"PutObjectLegalHold"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"PutObjectLockConfiguration"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"PutObjectRetention"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre a questa intestazione aggiuntiva:
-
x-amz-bypass-governance-retention
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"
"PutObjectTagging"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
StorageGRID supporta tutti i parametri del corpo della richiesta definiti dall'API REST di Amazon S3 al momento dell'implementazione.
"RestoreObject"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Per informazioni dettagliate sui campi corpo supportati, vedere "RestoreObject".
"SelectObjectContent"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta.
Per ulteriori informazioni sui body field supportati, vedere quanto segue:
"UploadPart"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri di query URI aggiuntivi:
-
partNumber
-
uploadId
E queste intestazioni di richiesta aggiuntive:
-
x-amz-checksum-sha256
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
Dati binari della parte
"UploadPartCopy"
StorageGRID supporta tutti parametri e intestazioni comuni per questa richiesta, oltre ai seguenti parametri di query URI aggiuntivi:
-
partNumber
-
uploadId
E queste intestazioni di richiesta aggiuntive:
-
x-amz-copy-source
-
x-amz-copy-source-if-match
-
x-amz-copy-source-if-modified-since
-
x-amz-copy-source-if-none-match
-
x-amz-copy-source-if-unmodified-since
-
x-amz-copy-source-range
-
x-amz-server-side-encryption-customer-algorithm
-
x-amz-server-side-encryption-customer-key
-
x-amz-server-side-encryption-customer-key-MD5
-
x-amz-copy-source-server-side-encryption-customer-algorithm
-
x-amz-copy-source-server-side-encryption-customer-key
-
x-amz-copy-source-server-side-encryption-customer-key-MD5
Nessuno