Skip to main content
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

StorageGRID 中支持的 S3 API 请求

PDF

本页总结了 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

相关信息

"AbortMultipartUpload"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及此附加 URI 查询参数：

  • uploadId

请求正文

无

StorageGRID 文档

"多部分上传的操作"

"CompleteMultipartUpload"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及此附加 URI 查询参数：

  • uploadId

  • x-amz-checksum-sha256

请求正文 XML 标记

StorageGRID 支持这些请求正文 XML 标记：

  • ChecksumSHA256

  • CompleteMultipartUpload

  • ETag

  • Part

  • PartNumber

StorageGRID 文档

"CompleteMultipartUpload"

"CopyObject"

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

"CopyObject"

"CreateBucket"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及以下附加标头：

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

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"对存储桶的操作"

"CreateMultipartUpload"

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

"CreateMultipartUpload"

"DeleteBucket"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

StorageGRID 文档

"对存储桶的操作"

"DeleteBucketCors"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"DeleteBucketEncryption"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"DeleteBucketLifecycle"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"DeleteBucketPolicy"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"DeleteBucketReplication"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"DeleteBucketTagging"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"删除对象"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及此附加请求标头：

  • x-amz-bypass-governance-retention

请求正文

无

StorageGRID 文档

"对象上的操作"

"DeleteObjects"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及此附加请求标头：

  • x-amz-bypass-governance-retention

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"对象上的操作"

"DeleteObjectTagging"

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对象上的操作"

"GetBucketAcl"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketCors"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketEncryption"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketLifecycleConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"GetBucketLocation"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketNotificationConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketPolicy"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketReplication"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketTagging"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"GetBucketVersioning"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"获取对象"

URI 查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"获取对象"

"GetObjectAcl"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对象上的操作"

"GetObjectLegalHold"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"GetObjectLockConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"GetObjectRetention"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"GetObjectTagging"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对象上的操作"

"HeadBucket"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"HeadObject"

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

"HeadObject"

"ListBuckets"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

无

StorageGRID 文档

"服务上的操作 > ListBuckets"

"ListMultipartUploads"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头 参数，以及以下附加参数：

  • encoding-type

  • key-marker

  • max-uploads

  • prefix

  • upload-id-marker

请求正文

无

StorageGRID 文档

"ListMultipartUploads"

"ListObjects"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头 参数，以及以下附加参数：

  • delimiter

  • encoding-type

  • marker

  • max-keys

  • prefix

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"ListObjectsV2"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头 参数，以及以下附加参数：

  • continuation-token

  • delimiter

  • encoding-type

  • fetch-owner

  • max-keys

  • prefix

  • start-after

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"ListObjectVersions"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头 参数，以及以下附加参数：

  • delimiter

  • encoding-type

  • key-marker

  • max-keys

  • prefix

  • version-id-marker

请求正文

无

StorageGRID 文档

"对存储桶的操作"

"ListParts"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头 参数，以及以下附加参数：

  • max-parts

  • part-number-marker

  • uploadId

请求正文

无

StorageGRID 文档

"ListMultipartUploads"

"PutBucketCors"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"对存储桶的操作"

"PutBucketEncryption"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文 XML 标记

StorageGRID 支持这些请求正文 XML 标记：

  • ApplyServerSideEncryptionByDefault

  • Rule

  • ServerSideEncryptionConfiguration

  • SSEAlgorithm

StorageGRID 文档

"对存储桶的操作"

"PutBucketLifecycleConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文 XML 标记

StorageGRID 支持这些请求正文 XML 标记：

  • And

  • Days

  • Expiration

  • ExpiredObjectDeleteMarker

  • Filter

  • ID

  • Key

  • LifecycleConfiguration

  • NewerNoncurrentVersions

  • NoncurrentDays

  • NoncurrentVersionExpiration

  • Prefix

  • Rule

  • Status

  • Tag

  • Value

StorageGRID 文档

"PutBucketNotificationConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文 XML 标记

StorageGRID 支持这些请求正文 XML 标记：

  • Event

  • Filter

  • FilterRule

  • Id

  • Name

  • NotificationConfiguration

  • Prefix

  • S3Key

  • Suffix

  • Topic

  • TopicConfiguration

  • Value

StorageGRID 文档

"对存储桶的操作"

"PutBucketPolicy"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

有关支持的JSON正文字段的详细信息，请参见 "使用存储区和组访问策略"。

"PutBucketReplication"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文 XML 标记

  • Bucket

  • Destination

  • Prefix

  • ReplicationConfiguration

  • Rule

  • Status

  • StorageClass

StorageGRID 文档

"对存储桶的操作"

"PutBucketTagging"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"对存储桶的操作"

"PutBucketVersioning"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文参数

StorageGRID 支持以下请求正文参数：

  • VersioningConfiguration

  • Status

StorageGRID 文档

"对存储桶的操作"

"放置对象"

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

"放置对象"

"PutObjectLegalHold"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"PutObjectLockConfiguration"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"PutObjectRetention"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有 通用参数和标头，以及此附加标头：

  • x-amz-bypass-governance-retention

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"使用 S3 REST API 配置 S3 对象锁定"

"PutObjectTagging"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

StorageGRID 支持实施时 Amazon S3 REST API 定义的所有请求正文参数。

StorageGRID 文档

"对象上的操作"

"RestoreObject"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

有关支持的正文字段的详细信息，请参见 "RestoreObject"。

"SelectObjectContent"

URI 查询参数和请求标头

StorageGRID 支持此请求的所有通用参数和标头内容。

请求正文

有关受支持的正文字段的详细信息，请参见以下内容：

"UploadPart"

URI 查询参数和请求标头

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

请求正文

  • 零件的二进制数据

StorageGRID 文档

"UploadPart"

"UploadPartCopy"

URI 查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"UploadPartCopy"