快速參考:支援的 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
"完成多個部分上傳"
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>
無
"建立多個部分上傳"
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>
無
"GetObject"
StorageGRID 支援此要求的所有通用參數和標頭功能、以及下列其他 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
無
"標題物件"
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
無
"ListMultipartUploads"
StorageGRID 支援此要求的所有通用參數和標頭功能、以及下列額外參數:
-
encoding-type
-
key-marker
-
max-uploads
-
prefix
-
upload-id-marker
無
"清單零件"
StorageGRID 支援此要求的所有通用參數和標頭功能、以及下列額外參數:
-
max-parts
-
part-number-marker
-
uploadId
無
"PuttBucketLifecycleConfiguration"
StorageGRID 支援此要求的所有通用參數和標頭功能。
StorageGRID 支援這些要求本文 XML 標記:
-
And
-
Days
-
Expiration
-
ExpiredObjectDeleteMarker
-
Filter
-
ID
-
Key
-
LifecycleConfiguration
-
NewerNoncurrentVersions
-
NoncurrentDays
-
NoncurrentVersionExpiration
-
Prefix
-
Rule
-
Status
-
Tag
-
Value
"PuttBucketPolicy"
StorageGRID 支援此要求的所有通用參數和標頭功能。
如需有關支援的 JSON 本文欄位的詳細資訊、請參閱"使用貯體和群組存取原則"。
"PuttObject"
StorageGRID 支援此要求的所有通用參數和標頭功能、以及下列額外標頭:
-
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>
-
物件的二進位資料
"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"、請參閱。
"上傳PartCopy"
StorageGRID 支援此要求的所有通用參數和標頭功能、以及下列其他 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
無