StorageGRID 中支援的 S3 API 要求
本頁概述 StorageGRID 如何支援 Amazon Simple Storage Service (S3) API。
本頁僅包含 StorageGRID 支援的 S3 操作。
|
|
若要查看每個操作的 AWS 文件,請選擇標題中的連結。 |
常用的 URI 查詢參數和請求標頭
除非另有說明,否則支援以下常見的 URI 查詢參數:
-
versionId(物件操作所需)
除非另有說明,否則支援以下常用請求標頭:
-
Authorization -
Connection -
Content-Length -
Content-MD5 -
Content-Type -
Date -
Expect -
Host -
x-amz-date
"CompleteMultipartUpload"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加 URI 查詢參數:
-
uploadId -
x-amz-checksum-sha256
StorageGRID 支援以下請求本文 XML 標籤:
-
ChecksumSHA256 -
CompleteMultipartUpload -
ETag -
Part -
PartNumber
"CopyObject"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
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>
無
"CreateBucket"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
x-amz-bucket-object-lock-enabled
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"CreateMultipartUpload"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
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>
無
"DeleteBucket"
StorageGRID 支援此請求的所有 常用參數和標頭。
"DeleteBucketLifecycle"
"GetBucketLifecycleConfiguration"
"GetObject"
StorageGRID 支援此請求的所有 常用參數和標頭 URI 查詢參數,以及以下附加 URI 查詢參數:
-
x-amz-checksum-mode -
partNumber -
response-cache-control -
response-content-disposition -
response-content-encoding -
response-content-language -
response-content-type -
response-expires
以及以下附加請求標頭:
-
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
無
"GetObjectLegalHold"
"GetObjectLockConfiguration"
"GetObjectRetention"
"HeadObject"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
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
無
"ListBuckets"
"ListMultipartUploads"
StorageGRID 支援此請求的所有 常用參數和標頭 以及以下附加參數:
-
encoding-type -
key-marker -
max-uploads -
prefix -
upload-id-marker
無
"ListObjects"
StorageGRID 支援此請求的所有 常用參數和標頭 以及以下附加參數:
-
delimiter -
encoding-type -
marker -
max-keys -
prefix
無
"ListObjectsV2"
StorageGRID 支援此請求的所有 常用參數和標頭 以及以下附加參數:
-
continuation-token -
delimiter -
encoding-type -
fetch-owner -
max-keys -
prefix -
start-after
無
"ListObjectVersions"
StorageGRID 支援此請求的所有 常用參數和標頭 以及以下附加參數:
-
delimiter -
encoding-type -
key-marker -
max-keys -
prefix -
version-id-marker
無
"ListParts"
StorageGRID 支援此請求的所有 常用參數和標頭 以及以下附加參數:
-
max-parts -
part-number-marker -
uploadId
無
"PutBucketCors"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"PutBucketEncryption"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援以下請求本文 XML 標籤:
-
ApplyServerSideEncryptionByDefault -
Rule -
ServerSideEncryptionConfiguration -
SSEAlgorithm
"PutBucketLifecycleConfiguration"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援以下請求本文 XML 標籤:
-
And -
Days -
Expiration -
ExpiredObjectDeleteMarker -
Filter -
ID -
Key -
LifecycleConfiguration -
NewerNoncurrentVersions -
NoncurrentDays -
NoncurrentVersionExpiration -
Prefix -
Rule -
Status -
Tag -
Value
"PutBucketNotificationConfiguration"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援以下請求本文 XML 標籤:
-
Event -
Filter -
FilterRule -
Id -
Name -
NotificationConfiguration -
Prefix -
S3Key -
Suffix -
Topic -
TopicConfiguration -
Value
"PutBucketPolicy"
StorageGRID 支援此請求的所有 常用參數和標頭。
有關支援的 JSON 本文欄位的詳細資訊,請參閱 "使用儲存桶和群組存取原則"。
"PutBucketReplication"
StorageGRID 支援此請求的所有 常用參數和標頭。
-
Bucket -
Destination -
Prefix -
ReplicationConfiguration -
Rule -
Status -
StorageClass
"PutBucketTagging"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"PutBucketVersioning"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援以下請求本文參數:
-
VersioningConfiguration -
Status
"PutObject"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
Cache-Control -
Content-Disposition -
Content-Encoding -
Content-Language -
Expires -
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>
-
物件的二進位資料
"PutObjectLegalHold"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"PutObjectLockConfiguration"
StorageGRID 支援此請求的所有 常用參數和標頭。
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"PutObjectRetention"
StorageGRID 支援此請求的所有 常用參數和標頭 ,以及以下附加標頭:
-
x-amz-bypass-governance-retention
StorageGRID 支援 Amazon S3 REST API 在實作時定義的所有請求本文參數。
"RestoreObject"
StorageGRID 支援此請求的所有 常用參數和標頭。
有關支援的本文欄位的詳細資訊,請參閱 "RestoreObject"。
"SelectObjectContent"
StorageGRID 支援此請求的所有 常用參數和標頭。
如需支援的本文欄位的詳細資訊,請參閱下列內容:
"UploadPart"
StorageGRID 支援此請求的所有 常用參數和標頭 URI 查詢參數,以及以下附加 URI 查詢參數:
-
partNumber -
uploadId
以及以下附加請求標頭:
-
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
-
零件的二進位資料
"UploadPartCopy"
StorageGRID 支援此請求的所有 常用參數和標頭 URI 查詢參數,以及以下附加 URI 查詢參數:
-
partNumber -
uploadId
以及以下附加請求標頭:
-
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
無