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

快速参考：支持的S3 API请求

贡献者 netapp-madkat
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

请求正文XML标记

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

  • CompleteMultipartUpload

  • Part

  • ETag

  • PartNumber

StorageGRID 文档

"完成多部件上传"

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

"放置对象副本"

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

"启动多部件上传"

"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查询参数：

  • 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对象锁定"

"GetObject保留"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

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

"GetObjectTagging"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"对对象执行的操作"

"HeadBucket"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

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

"HeadObject"

URI查询参数和请求标头

StorageGRID 支持所有 通用参数和标头 对于此请求、加上以下附加标头：

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

"HEAD 对象"

"List桶"

URI查询参数和请求标头

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

请求正文

无

StorageGRID 文档

"服务上的操作"

"ListMultipartUploads"

URI查询参数和请求标头

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

  • delimiter

  • encoding-type

  • key-marker

  • max-uploads

  • prefix

  • upload-id-marker

请求正文

无

StorageGRID 文档

"列出多部件上传"

"ListObjects"

URI查询参数和请求标头

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

  • delimiter

  • encoding-type

  • marker

  • max-keys

  • prefix

请求正文

无

StorageGRID 文档

"对存储分段执行的操作" (GET分段)

"ListObjectsV2"

URI查询参数和请求标头

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

  • continuation-token

  • delimiter

  • encoding-type

  • fetch-owner

  • max-keys

  • prefix

  • start-after

请求正文

无

StorageGRID 文档

"对存储分段执行的操作" (GET分段)

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

"列出多部件上传"

"PutBucketCors"

URI查询参数和请求标头

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

请求正文

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

StorageGRID 文档

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

"PutBucketEncryption"

URI查询参数和请求标头

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

请求正文XML标记

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

  • ServerSideEncryptionConfiguration

  • Rule

  • ApplyServerSideEncryptionByDefault

  • SSEAlgorithm

StorageGRID 文档

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

"PutBucketLifecycleConfiguration"

URI查询参数和请求标头

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

请求正文XML标记

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

  • NewerNoncurrentVersions

  • LifecycleConfiguration

  • Rule

  • Expiration

  • Days

  • Filter

  • And

  • Prefix

  • Tag

  • Key

  • Value

  • Prefix

  • Tag

  • Key

  • Value

  • ID

  • NoncurrentVersionExpiration

  • NoncurrentDays

  • Prefix

  • Status

StorageGRID 文档

"PutBucketNotizationConfiguration"

URI查询参数和请求标头

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

请求正文XML标记

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

  • Prefix

  • Suffix

  • NotificationConfiguration

  • TopicConfiguration

  • Event

  • Filter

  • S3Key

  • FilterRule

  • Name

  • Value

  • Id

  • Topic

StorageGRID 文档

"对存储分段执行的操作" (放置存储分段通知)

"PutBucketPolicy"

URI查询参数和请求标头

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

请求正文

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

"PutBucketReplication"

URI查询参数和请求标头

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

请求正文XML标记

  • ReplicationConfiguration

  • Status

  • Prefix

  • Destination

  • Bucket

  • StorageClass

  • Rule

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

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

"PUT 对象"

"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对象锁定"

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

"对对象执行的操作"

"SelectObjectContent"

URI查询参数和请求标头

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

请求正文

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

"上传部件"

URI查询参数和请求标头

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

  • partNumber

  • uploadId

以及以下附加请求标头：

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

"上传部件—复制"