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

StorageGRID 中支持的 S3 API 请求

贡献者 netapp-pcarriga netapp-lhalbert netapp-perveilerk netapp-jsnyder
PDF

此页面汇总了StorageGRID 如何支持Amazon Simple Storage Service (S3) API。

此页面仅包含 StorageGRID 支持的 S3 操作。任何未列出的 S3 操作都可能返回 `501 Not Implemented`或导致意外行为。

提示 要查看每个操作的AWS文档、请选择标题中的链接。

通用URI查询参数和请求标头

除非另有说明、否则支持以下通用URI查询参数：

  • versionId(根据对象操作的需要)

除非另有说明、否则支持以下通用请求标头：

  • Authorization

  • Connection

  • Content-Length

  • Content-MD5

  • Content-Type

  • Date

  • Expect

  • Host

  • x-amz-date

相关信息

"AbortMultipartUpload"

URI查询参数和请求标头

StorageGRID支持对此请求使用all、并支持通用参数和标头以下附加URI查询参数：

  • uploadId

请求正文

无

StorageGRID 文档

"多部分上传操作"

"CompleteMultipartUpload"

URI查询参数和请求标头

StorageGRID支持对此请求使用all、并支持通用参数和标头以下附加URI查询参数：

  • uploadId

  • x-amz-checksum-crc32

  • x-amz-checksum-crc32c

  • x-amz-checksum-crc64nvme

  • x-amz-checksum-sha256

  • x-amz-checksum-type

  • x-amz-storage-class

请求正文XML标记

StorageGRID 支持以下请求正文XML标记：

  • ChecksumCRC32

  • ChecksumCRC32C

  • ChecksumCRC64NVME

  • ChecksumSHA256

  • CompleteMultipartUpload

  • ETag

  • Part

  • PartNumber

StorageGRID 文档

"CompleteMultipartUpload"

"CopyObject"

URI查询参数和请求标头

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

  • x-amz-checksum-algorithm

  • 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-checksum-type

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

"对存储分段执行的操作"

"DeleteBucketTbaging"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"DeleteObject"

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

"对存储分段执行的操作"

"GetBucketNotizationConfiguration"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"GetBucketPolicy"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"GetBucketReplication"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"GetBucketTaging"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"GetBucketVersioning"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对存储分段执行的操作"

"GetObject"

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

"GetObject"

"GetObjectAcl"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对对象执行的操作"

"GetObjectLegalHold"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

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

"GetObjectLockConfiguration"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

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

"GetObject保留"

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"

"List桶"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"服务 上的操作"

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

"对存储分段执行的操作"

"ListObjectVersies"

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

"PutBucketNotizationConfiguration"

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

"对存储分段执行的操作"

"PutBucketTaging"

URI查询参数和请求标头

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

请求正文

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

StorageGRID 文档

"对存储分段执行的操作"

"PutBucketVersioning"

URI查询参数和请求标头

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

请求正文参数

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

  • VersioningConfiguration

  • Status

StorageGRID 文档

"对存储分段执行的操作"

"PutObject"

URI查询参数和请求标头

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

  • Cache-Control

  • Content-Disposition

  • Content-Encoding

  • Content-Language

  • Expires

  • x-amz-checksum-crc32

  • x-amz-checksum-crc32c

  • x-amz-checksum-crc64nvme

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

"PutObject"

"PutObjectLegalHold"

URI查询参数和请求标头

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

请求正文

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

StorageGRID 文档

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

"PutObjectLockConfiguration"

URI查询参数和请求标头

StorageGRID 支持此请求的_大多数_通用参数和标头。

请求正文

StorageGRID 支持 Amazon S3 REST API 在实施时定义的_大多数_请求正文参数，但以下情况除外：

除非网格管理员授予权限，否则无法使用 PutObjectLockConfiguration 在现有存储桶上启用 S3 对象锁定。

StorageGRID 文档

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

"PutObject保留"

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支持所有通用参数和标头此请求。

请求正文

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

"上传部件"

URI查询参数和请求标头

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

  • partNumber

  • uploadId

以及以下附加请求标头：

  • x-amz-checksum-crc32

  • x-amz-checksum-crc32c

  • x-amz-checksum-crc64nvme

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

"上传部件"

"上传PartCopy"

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

"上传PartCopy"