跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

发布说明

最后更新 查看 MarkdownAgent 设置

Subscribe to RSS

2026-04-27

2025-09-23

  • 修复了一个问题:即使对象在仪表板上应用了存储桶锁定规则,您仍可以尝试删除这些对象。此前,这些对象会暂时从表格中消失,但刷新页面后又会重新出现。现在,仪表板中已对锁定对象禁用删除操作。

2025-09-22

  • 我们更新了 R2 仪表板,采用更简洁的外观,让您更容易找到所需内容并执行操作。您可以在侧面板中找到如何通过各种 API 接口使用 R2 的说明,并可在底部轻松访问文档。

2025-07-03

  • 单个对象和分段对象现在都支持 CRC-64/NVME 校验和算法。这也为分段上传带来了对 FULL_OBJECT 校验和类型的支持。请在此处查看校验和类型兼容性。

2024-12-03

2024-11-21

  • 现在可以在位于辖区(例如 EU、FedRAMP)中的存储桶上启用 Sippy。
  • 修复了 Sippy 的一个问题:对包含某些特殊字符的对象发出的 GET/HEAD 请求会返回错误响应。

2024-11-20

  • 大洋洲(OC)现已作为 R2 区域推出。
  • 每个账户的默认最大存储桶数量现为 100 万个。如果您需要超过 100 万个存储桶,请联系 Cloudflare 支持。
  • 通过自定义域访问的公共存储桶现在支持 Smart Tiered Cache。

2024-11-19

2024-11-14

  • Wrangler 中新增 R2 bucket info 命令,可显示存储桶的位置和常用指标。

2024-11-08

2024-11-06

2024-11-01

2024-10-28

2024-10-21

  • 现在可以为位于辖区(例如 EU、FedRAMP)中的 R2 存储桶配置事件通知。

2024-09-26

  • R2 事件通知现已正式发布。事件通知现在支持更高的吞吐量(每个队列每秒最多 5,000 条消息),可以在仪表板和 Wrangler 中配置,并支持生命周期删除。

2024-09-18

2024-08-26

  • 新增通过 API 配置 R2 存储桶自定义域的支持。

2024-08-21

  • Sippy 现已正式发布。现在可以在仪表板中或通过 GraphQL Analytics API 查看正在进行的迁移的指标。

2024-07-08

  • 在仪表板的迁移摘要中添加了 Super Slurper 的迁移日志。

2024-06-12

2024-06-07

  • 修复了导致 Sippy 无法从设置了 SSE 的 S3 存储桶复制对象的问题。

2024-06-06

  • R2 现在将忽略 x-purpose 请求参数。

2024-05-29

2024-05-24

2024-04-03

2024-02-20

  • 当针对公共入口点的 OPTIONS 请求不包含 origin 标头时,将返回 HTTP 400 而不是 HTTP 401。

2024-02-06

  • GET /buckets/:bucket/sippy 的响应结构已更改。
  • /buckets/:bucket/sippy/validate 端点已通过 APIGW 公开,用于验证 Sippy 的配置。
  • 修改 Sippy 配置时所用配置对象的结构已更改。

2024-02-02

  • 更新了 GetBucket 端点:现在按 bucket_name 而不是 bucket_id 获取。

2024-01-30

  • 修复了 API 会在 PutBucketCors 操作的 AllowedHeaders 属性中接受空字符串的问题。

2024-01-26

  • 在 CompleteMultipartUpload 期间,无论输入顺序如何,分段现在都会自动按升序排序。

2024-01-11

  • Sippy 现已支持 Google Cloud Storage(GCS),处于 Beta 阶段。

2023-12-11

  • S3 ListBuckets 操作的 x-id 查询参数现在会被忽略。
  • 所有 S3 操作的 x-id 查询参数现在都会被忽略。

2023-10-23

  • PutBucketCors 现在仅接受有效的源。

2023-09-01

  • 修复了 ListBuckets 的一个问题:name_contains 参数也会搜索辖区名称。

2023-08-23

  • 配置审核日志正式发布。

2023-08-11

  • 用户现在可以完成有条件的分段发布操作。如果发布上传时出现条件不满足的情况,该上传将不再可用,并被视为已中止。

2023-07-05

  • 提升了对超大文件进行范围读取的性能。此前,在超大文件末尾附近进行范围读取明显慢于对较小文件进行范围读取。现在,无论文件大小如何,性能都应始终保持良好。

2023-06-21

2023-06-16

  • 修复了对不存在的存储桶调用 GetBucket 时返回 500 而不是 404 的问题。
  • 改进了 ListObjectsV1 的 S3 兼容性,现在仅当 truncated 为 true 时才设置 nextmarker。
  • R2 Worker 绑定现在支持解析包含多个 ETag 的条件标头。这些 ETag 现在可以是强 ETag、弱 ETag 或通配符。此前,绑定仅接受包含单个强 ETag 的标头。
  • S3 putObject 现在支持 sha256 和 sha1 校验和。R2 Worker 绑定此前已支持这些校验和。
  • S3 兼容 API 中的 CopyObject 现在支持 Cloudflare 特定的标头,可根据目标对象的状态有条件地执行复制操作。

2023-04-01

  • GetBucket 现在可以通过 Cloudflare API 使用。
  • 现在可以在创建存储桶时通过 S3 API 和仪表板设置位置提示。

2023-03-16

  • 已实现 ListParts API,现在可以使用。
  • 对于关联到 R2 存储桶的新自定义域,现在默认启用 HTTP2。
  • 对象生命周期现已可用。
  • 问题修复:使用 Accept-Encoding: gzip 时,对公共存储桶的请求现在会为 gzip 文件返回 Content-Encoding 标头。

2023-01-27

  • 通过 R2 令牌页面创建的 R2 身份验证令牌现在默认限定于单个账户。

2022-12-07

  • 修复了 S3 API 的 CORS 预检请求,从而可以在浏览器中使用 S3 SDK。
  • 在 R2 绑定 API 中向 get 操作传递 range 标头现在应能按预期工作。

2022-11-30

  • 带有 x-amz-acl: public-read 标头的请求不再被拒绝。
  • 修复了通配符 CORS 规则和预签名 URL 的问题。
  • 修复了 ListObjects 在对 Unicode 规范化的键进行分隔列出时超时的问题。
  • S3 API 的 PutBucketCors 现在会拒绝 XML 正文中包含未知键的请求。
  • 对额外的标头进行签名不再会破坏预签名 URL 的 CORS 预检请求。

2022-11-21

  • 修复了 ListObjects 中的一个问题:startAfter 会跳过键在 startAfter 前缀之后紧跟数字的对象。
  • 新增用于分段上传的 Worker 绑定。

2022-11-17

  • 对范围请求无条件返回 HTTP 206,以与其他 S3 兼容实现的行为保持一致。
  • 修复了一个 CORS 问题:CORS 配置中的 AllowedHeaders 被区分大小写处理。

2022-11-08

  • 重新启用通过 CopyObject 复制分段对象。
  • 重新启用 UploadPartCopy。

2022-10-28

  • 分段上传的各分段大小始终应保持一致,但现在此要求改为在完成上传时检查,而不是每次上传分段时都检查。
  • 修复了一个性能问题:并发上传分段时会被拒绝。

2022-10-26

  • 修复了分段大小未与 64 KiB 对齐的分段对象的范围读取问题。

2022-10-19

  • HeadBucket 现在会在响应中将 x-amz-bucket-region 设置为 auto。

2022-10-06

  • 在我们调查一个问题期间,暂时禁用 UploadPartCopy。

2022-09-29

  • 修复了一个 CORS 问题:未为预检请求设置 Access-Control-Allow-Headers。

2022-09-28

  • 修复了 CORS 配置未应用于 S3 端点的问题。
  • 如果未定义 ExposeHeader,将不再返回 Access-Control-Expose-Headers 响应标头。
  • 公共存储桶将不再返回 Content-Range 响应标头,除非响应是部分响应。
  • 修复了 S3 HeadObject 操作的 CORS 标头输出。
  • 修复了没有匹配的 CORS 配置时可能导致 403 响应的问题。
  • 暂时禁用复制通过分段上传创建的对象。
  • 修复了 Workers 绑定中的一个问题:格式错误的范围 .get 请求会返回内部错误。

2022-09-27

  • 现已为 S3 和公共存储桶实现 CORS 预检响应以及为其他响应添加 CORS 标头。目前,配置 CORS 的唯一方式是通过 S3 API。
  • 修复了绑定列表截断问题,使其在列出带有包含 " 的自定义元数据的键时,或在某些键/值包含特定多字节 UTF-8 值时,能够更正确地工作。
  • S3 GetObject 操作现在仅在响应范围请求时返回 Content-Range。

2022-09-19

  • 现在可以为 R2 put() 绑定的选项提供 onlyIf 字段(与 get() 类似),以执行有条件上传。
  • R2 delete() 绑定现在支持一次删除多个键。
  • R2 put() 绑定现在支持在选项中指定用户提供的 SHA-1、SHA-256、SHA-384、SHA-512 校验和。
  • 用户指定的对象校验和现在会出现在 R2 get() 和 head() 绑定的响应中。对于非分段上传的对象,默认包含 MD5。

2022-09-06

  • S3 CopyObject 操作现在会在响应标头中包含 x-amz-version-id 和 x-amz-copy-source-version-id,以与其他方法保持一致。
  • 对于在公开 Beta 后不久之前上传的分段文件,其 ETag 现在会以分段数量作为后缀。

2022-08-17

  • S3 DeleteObjects 操作在删除之前不再去除键两侧的空格。此前这会导致带有前导/尾随空格的文件无法被删除;此外,如果存在键为去除空格后的值的对象,则会改为删除该对象。S3 DeleteObject 操作不受此问题影响。
  • 修复了 S3 ListBuckets 和 ListObjects 操作对预签名 URL 的支持。

2022-08-06

  • 如果在 PutObject 请求中未显式设置 Content-Type,上传时将根据文件正文自动推断 Content-Type。此功能将来会扩展到分段操作。

2022-07-30

  • 修复了 S3 条件请求,使其在提供最近一次上传的 LastModified 日期时能够正常工作;绑定的修复将在下一个版本中发布。
  • If-Match / If-None-Match 标头现在支持 ETag 数组、弱 ETag 和通配符(*),符合 HTTP 标准和 AWS S3 未公开的行为。

2022-07-21

  • 为以下操作添加了模拟实现,以模仿基本的 AWS S3 存储桶在首次创建时返回的响应:GetBucketAcl。

2022-07-20

  • 为以下操作添加了模拟实现,以模仿基本的 AWS S3 存储桶在首次创建时返回的响应:

    • GetBucketVersioning
    • GetBucketLifecycleConfiguration
    • GetBucketReplication
    • GetBucketTagging
    • GetObjectLockConfiguration

2022-07-19

  • 修复了与 MinIO .NET SDK 以及其他要求顶层 Error 标签不带 xmlns 命名空间属性的工具之间的错误响应 S3 兼容性问题。
  • 不再接受 2022-07-01 之前的列表延续令牌,必须通过新的 list 操作重新获取。
  • 如果返回的数据过多,list() 绑定现在会正确地返回较小的限制数量(此前会返回 Internal Error)。

2022-07-14

  • 改进了 500 错误:我们现在会转换错误,因此某些操作中以前属于并发问题的错误现在应为 TooMuchConcurrency 而不是 InternalError。我们还通过内部改进降低了 500 错误的发生率。
  • 如果指定了 encoding-type,ListMultipartUpload 会正确编码返回的 Key。

2022-07-13

  • 发送到 R2 的带有 XML 声明的 S3 XML 文档不再会被以 400 Bad Request / MalformedXML 拒绝。
  • 一项仅影响 Windows 版 Arq Backup(不影响 Mac 版)的 S3 XML 小幅兼容性修复。响应现在包含 XML 声明标签前缀,并且响应中所有顶层标签上都带有 xmlns 属性。
  • Beta 版 ListMultipartUploads 支持。

2022-07-06

  • 支持即将在运行时版本中推出的 r2_list_honor_include 兼容性标志(自 2022-07-14 兼容性日期起为默认行为)。如果没有该兼容性标志/日期,无论您指定什么,list 都将继续隐式地按 include: ['httpMetadata', 'customMetadata'] 运行。
  • 可以在 PutObject/CreateMultipartUpload 请求上设置 cf-create-bucket-if-missing,以便在存储桶不存在时隐式创建存储桶。
  • 修复了与 MinIO 客户端在发布分段上传时使用不符合规范的 XML 的 S3 兼容性问题。CompleteMultipartUpload 中的前导和尾随引号现在是可选的并会被忽略,因为这似乎正是 AWS 实际实现的非标准行为。

2022-07-01

  • 传递给 ListObjects/ListObjectsV2 的不受支持的搜索参数现在会以 501 Not Implemented 拒绝。
  • 列出操作的修复:
    • 修复了文件夹内文件数量超过限制时的列出行为(此前您会看到该大文件夹的 CommonPrefix 出现 N 次,其中 N = CommonPrefix 内的子项数 / 限制)。
    • 修复了一个极端情况:列出操作可能会跳过与某个“文件夹”共享基本名称的对象。
    • 修复了对某些共享特定公共前缀的文件进行列出的问题。
  • DeleteObjects 现在可以一次处理 1000 个对象。
  • S3 CreateBucket 请求可以指定值为 false 的 x-amz-bucket-object-lock-enabled,而不会被以 NotImplemented 错误拒绝。值为 true 的请求将继续被拒绝,因为 R2 尚不支持对象锁定。

2022-06-17

  • 修复了某些客户端在使用空分隔符时出现的回归问题。
  • 新增对 S3 预签名 URL 的支持。

2022-06-16

  • 修复了 S3 API UploadPart 操作中的一个回归问题:TooMuchConcurrency 和 NoSuchUpload 错误被错误地返回为 NoSuchBucket。

2022-06-13

  • 修复了 S3 API ListObjectsV2 操作在使用分隔符时不会将空文件夹作为公共前缀返回的问题。
  • S3 API ListObjectsV2 的 KeyCount 参数现在会正确返回键和公共前缀的总数,而不仅仅是键的数量。
  • 列出操作的无效游标不再以 InternalError 失败,而是返回相应的错误消息。

2022-06-10

  • 如果在 S3 API ListObjectsV2 请求中提供了 ContinuationToken 字段,现在会在响应中正确返回该字段。
  • 修复了多次调用 S3 API AbortMultipartUpload 操作时会抛出错误的问题。

2022-05-27

  • 修复了 S3 API 的 PutObject 或 .put() 绑定可能失败但仍显示存储桶上传成功的问题。
  • 如果向 S3 API UploadObject 或 CreateMultipartUpload 操作提供了条件标头,并且对象已存在,则在不满足这些检查时将返回 412 Precondition Failed 状态码。

2022-05-20

  • 修复了向 S3 API 发送请求时,在 SignedHeaders 中使用 Accept-Encoding 会导致 SignatureDoesNotMatch 响应的问题。

2022-05-17

  • 修复了 S3 API 请求未正确处理用于授权签名的未编码参数的问题。
  • 修复了 S3 API 请求中类似数字的键被解析为数字而不是字符串的问题。

2022-05-16

  • 新增对 S3 虚拟托管样式路径的支持,例如使用 <BUCKET>.<ACCOUNT_ID>.r2.cloudflarestorage.com,而不是基于路径的路由(<ACCOUNT_ID>.r2.cloudflarestorage.com/<BUCKET>)。
  • 为兼容外部工具实现了 GetBucketLocation,它将始终返回 auto 的 LocationConstraint。

2022-05-06

  • S3 API GetObject 的范围现在包含两端(bytes=0-0 将正确返回第一个字节)。
  • S3 API GetObject 的部分读取会返回正确的 206 Partial Content 响应码。
  • 从不存在的键(或不存在的存储桶)复制到另一个存储桶时,现在会返回正确的 NoSuchKey / NoSuchBucket 响应。
  • S3 API 现在会在相关端点上返回正确的 Content-Type: application/xml 响应标头。
  • 分段上传现在会在 ETag 上带有 -N 后缀,表示发布文件时使用的分段数量。
  • UploadPart 和 UploadPartCopy 现在会返回正确的错误消息(例如 TooMuchConcurrency 或 NoSuchUpload),而不是 'internal error'。
  • 现在可以向 UploadPart 发送长度为 0 的分段。

2022-05-05

  • 使用 S3 API 时,空字符串和 us-east-1 现在将作为 auto 区域的别名,以兼容外部工具。
  • 现已支持 GetBucketEncryption、PutBucketEncryption 和 DeleteBucketEncrypotion(目前唯一支持的值为 AES256)。
  • 不受支持的操作现在会被明确拒绝为未实现,而不是被隐式地分别转换为 ListObjectsV2/PutBucket/DeleteBucket。
  • S3 API CompleteMultipartUploads 请求现在会被正确转义。

2022-05-03

  • 当存储桶中的键数量与 MaxKeys 参数相同时,不再返回分页游标。
  • S3 API ListBuckets 操作现在接受 cf-max-keys、cf-start-after 和 cf-continuation-token 标头,其行为与相应的 URL 参数相同。
  • S3 API ListBuckets 和 ListObjects 端点现在允许 per_page 为 0。
  • S3 API CopyObject 的源参数现在要求以斜杠开头。
  • 复制到不存在的存储桶时,S3 API CopyObject 操作现在会返回 NoSuchBucket 错误,而不是内部错误。
  • 强制要求在 SigV4 签名和 CreateBucket 的 LocationConstraint 参数中使用 auto。
  • S3 API CreateBucket 操作现在会返回正确的 location 响应标头。

2022-04-14

  • S3 API 现在支持非分块的签名负载。
  • 修复了 Workers R2 绑定的 .put()。
  • 修复了使用 S3 API 时键名未被正确解码的回归问题。
  • 修复了先删除一个对象,再删除另一个作为第一个对象前缀的对象时可能导致错误的问题。
  • 在某些情况下,即使对象已被删除,S3 API DeleteObjects 操作也会返回错误,此问题现已解决。
  • 修复了 startAfter 和 continuationToken 在列出操作中不起作用的问题。
  • S3 API ListObjects 操作现在会在响应中正确输出 Prefix、Delimiter、StartAfter 和 MaxKeys。
  • S3 API ListObjectsV2 现在会正确遵循 encoding-type 参数。
  • 为兼容 s3cmd,S3 API PutObject 操作现在支持 POST 请求。

2022-04-04

  • 当提供的键超过 128 个时,S3 API DeleteObjects 请求现在会正确返回 MalformedXML 错误,而不是 InternalError。

这篇文档对您有帮助吗?