Skip to main content
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

快速參考:支援的 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

"中止分段上傳"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加 URI 查詢參數:

  • uploadId

請求正文

沒有任何

StorageGRID文檔

"分段上傳的操作"

"完成多部分上傳"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加 URI 查詢參數:

  • uploadId

  • x-amz-checksum-sha256

請求主體 XML 標籤

StorageGRID支援以下請求正文 XML 標籤:

  • ChecksumSHA256

  • CompleteMultipartUpload

  • ETag

  • Part

  • PartNumber

StorageGRID文檔

"完成多部分上傳"

"複製對象"

URI 查詢參數和請求標頭

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文檔

"複製對象"

"創建桶"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加標頭:

  • x-amz-bucket-object-lock-enabled

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

StorageGRID文檔

"對 bucket 的操作"

"建立多部分上傳"

URI 查詢參數和請求標頭

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>

請求正文

沒有任何

StorageGRID文檔

"建立多部分上傳"

"刪除桶"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

StorageGRID文檔

"對 bucket 的操作"

"刪除BucketCors"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"刪除桶加密"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"DeleteBucket生命週期"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"刪除桶策略"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"刪除桶複製"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"刪除桶標記"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"刪除對象"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加請求標頭:

  • x-amz-bypass-governance-retention

請求正文

沒有任何

StorageGRID文檔

"對物件的操作"

"刪除對象"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加請求標頭:

  • x-amz-bypass-governance-retention

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

StorageGRID文檔

"對物件的操作"

"刪除物件標記"

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對物件的操作"

"獲取BucketAcl"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"獲取BucketCors"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得桶加密"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得BucketLifecycleConfiguration"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"取得儲存桶位置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得儲存桶通知配置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得BucketPolicy"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"獲取Bucket複製"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得桶標記"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得Bucket版本"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"取得對象"

URI 查詢參數和請求標頭

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文檔

"取得對象"

"取得對象Acl"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對物件的操作"

"獲取對象合法持有"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"取得物件鎖配置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"取得對象保留"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"取得物件標記"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對物件的操作"

"頭桶"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"頭部對象"

URI 查詢參數和請求標頭

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

請求正文

沒有任何

StorageGRID文檔

"頭部對象"

"列表桶"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

沒有任何

"列出多部分上傳"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加參數:

  • encoding-type

  • key-marker

  • max-uploads

  • prefix

  • upload-id-marker

請求正文

沒有任何

StorageGRID文檔

"列出多部分上傳"

"清單對象"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加參數:

  • delimiter

  • encoding-type

  • marker

  • max-keys

  • prefix

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"ListObjectsV2"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加參數:

  • continuation-token

  • delimiter

  • encoding-type

  • fetch-owner

  • max-keys

  • prefix

  • start-after

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"列出物件版本"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加參數:

  • delimiter

  • encoding-type

  • key-marker

  • max-keys

  • prefix

  • version-id-marker

請求正文

沒有任何

StorageGRID文檔

"對 bucket 的操作"

"列出零件"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加參數:

  • max-parts

  • part-number-marker

  • uploadId

請求正文

沒有任何

StorageGRID文檔

"列出多部分上傳"

"PutBucketCors"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

StorageGRID文檔

"對 bucket 的操作"

"PutBucket加密"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求主體 XML 標籤

StorageGRID支援以下請求正文 XML 標籤:

  • ApplyServerSideEncryptionByDefault

  • Rule

  • ServerSideEncryptionConfiguration

  • SSEAlgorithm

StorageGRID文檔

"對 bucket 的操作"

"PutBucket生命週期配置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求主體 XML 標籤

StorageGRID支援以下請求正文 XML 標籤:

  • And

  • Days

  • Expiration

  • ExpiredObjectDeleteMarker

  • Filter

  • ID

  • Key

  • LifecycleConfiguration

  • NewerNoncurrentVersions

  • NoncurrentDays

  • NoncurrentVersionExpiration

  • Prefix

  • Rule

  • Status

  • Tag

  • Value

"PutBucketNotification配置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求主體 XML 標籤

StorageGRID支援以下請求正文 XML 標籤:

  • Event

  • Filter

  • FilterRule

  • Id

  • Name

  • NotificationConfiguration

  • Prefix

  • S3Key

  • Suffix

  • Topic

  • TopicConfiguration

  • Value

StorageGRID文檔

"對 bucket 的操作"

"PutBucketPolicy"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

有關支援的 JSON 主體欄位的詳細信息,請參閱"使用儲存桶和群組存取策略"

"PutBucket複製"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求主體 XML 標籤
  • Bucket

  • Destination

  • Prefix

  • ReplicationConfiguration

  • Rule

  • Status

  • StorageClass

StorageGRID文檔

"對 bucket 的操作"

"PutBucketTagging"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

StorageGRID文檔

"對 bucket 的操作"

"PutBucket版本控制"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求主體參數

StorageGRID支援以下請求正文參數:

  • VersioningConfiguration

  • Status

StorageGRID文檔

"對 bucket 的操作"

"放置對象"

URI 查詢參數和請求標頭

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>

請求正文
  • 物件的二進位數據

StorageGRID文檔

"放置對象"

"放置對象合法保留"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

"PutObjectLock配置"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

"PutObjectRetention"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加標頭:

  • x-amz-bypass-governance-retention

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

"PutObjectTagging"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

StorageGRID支援實作時由 Amazon S3 REST API 定義的所有請求正文參數。

StorageGRID文檔

"對物件的操作"

"復原對象"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

有關支援的主體欄位的詳細信息,請參閱"復原對象"

"選擇對象內容"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求。

請求正文

有關支援的主體欄位的詳細信息,請參閱以下內容:

"上傳部分"

URI 查詢參數和請求標頭

StorageGRID支援所有通用參數和標頭對於此請求,加上以下附加 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

請求正文
  • 該部分的二進位數據

StorageGRID文檔

"上傳部分"

"上傳部分複製"

URI 查詢參數和請求標頭

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

請求正文

沒有任何

StorageGRID文檔

"上傳部分複製"