S3 API compatibility
R2 implements the S3 API to allow users and their applications to migrate with ease. When comparing to AWS S3, Cloudflare has removed some API operations' features and added others. The S3 API operations are listed below with their current implementation status. Feature implementation is currently in progress. Refer back to this page for updates.
The API is available via the https://<ACCOUNT_ID>.r2.cloudflarestorage.com
endpoint. Find your account ID in the Cloudflare dashboard.
This page has two sections: bucket-level operations and object-level operations.
Each section will have two tables: a table of implemented APIs and a table of unimplemented APIs.
Refer the feature column of each table to review which features of an API have been implemented and which have not.
โ
Feature Implemented
๐ง Feature Implemented (Experimental)
โ Feature Not Implemented
When using the S3 API, the region for an R2 bucket is auto
. For compatibility with tools that do not allow you to specify a region, an empty value and us-east-1
will alias to the auto
region.
This also applies to the LocationConstraint
for the CreateBucket
API.
The following tables are related to bucket-level operations.
Below is a list of implemented bucket-level operations. Refer to the Feature column to review which features have been implemented (โ ) and have not been implemented (โ).
API Name | Feature |
---|---|
โ ListBuckets โ | |
โ HeadBucket โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ CreateBucket โ | โ ACL: โ โ x-amz-acl โ โ x-amz-grant-full-control โ โ x-amz-grant-read โ โ x-amz-grant-read-acp โ โ x-amz-grant-write โ โ x-amz-grant-write-acp โ Object Locking: โ โ x-amz-bucket-object-lock-enabled โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ DeleteBucket โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ DeleteBucketCors โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketCors โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketLifecycleConfiguration โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketLocation โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketEncryption โ | โ Bucket Owner: โ x-amz-expected-bucket-owner |
โ PutBucketCors โ | โ Checksums: โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketLifecycleConfiguration โ | โ Checksums: โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
Unimplemented bucket-level operations
API Name | Feature |
---|---|
โ GetBucketAccelerateConfiguration โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketAcl โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketAnalyticsConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketIntelligentTieringConfiguration โ | โ id |
โ GetBucketInventoryConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketLifecycle โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketLogging โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketMetricsConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketNotification โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketNotificationConfiguration โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketOwnershipControls โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketPolicy โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketPolicyStatus โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketReplication โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketRequestPayment โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketTagging โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketVersioning โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetBucketWebsite โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetObjectLockConfiguration โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetPublicAccessBlock โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListBucketAnalyticsConfigurations โ | โ Query Parameters: โ โ continuation-token โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListBucketIntelligentTieringConfigurations โ | โ Query Parameters: โ โ continuation-token โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListBucketInventoryConfigurations โ | โ Query Parameters: โ โ continuation-token โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListBucketMetricsConfigurations โ | โ Query Parameters: โ โ continuation-token โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketAccelerateConfiguration โ | โ Checksums: โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketAcl โ | โ Permissions: โ โ x-amz-grant-full-control โ โ x-amz-grant-read โ โ x-amz-grant-read-acp โ โ x-amz-grant-write โ โ x-amz-grant-write-acp โ Checksums: โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketAnalyticsConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketEncryption โ | โ Checksums: โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketIntelligentTieringConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketInventoryConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketLifecycle โ | โ Checksums: โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketLogging โ | โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketMetricsConfiguration โ | โ id โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketNotification โ | โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketNotificationConfiguration โ | โ Validation: โ โ x-amz-skip-destination-validation โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketOwnershipControls โ | โ Checksums: โ โ Content-MD5 โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketPolicy โ | โ Validation: โ โ x-amz-confirm-remove-self-bucket-access โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketReplication โ | โ Object Locking: โ โ x-amz-bucket-object-lock-token โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketRequestPayment โ | โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketTagging โ | โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketVersioning โ | โ Multi-factor authentication: โ โ x-amz-mfa โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutBucketWebsite โ | โ Checksums: โ โ Content-MD5 โ Bucket Owner: โ x-amz-expected-bucket-owner |
โ PutObjectLockConfiguration โ | โ Object Locking: โ โ x-amz-bucket-object-lock-token โ Checksums: โ โ Content-MD5 โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutPublicAccessBlock โ | โ Checksums: โ โ Content-MD5 โ โ x-amz-sdk-checksum-algorithm โ โ x-amz-checksum-algorithm โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
The following tables are related to object-level operations.
Below is a list of implemented object-level operations. Refer to the Feature column to review which features have been implemented (โ ) and have not been implemented (โ).
API Name | Feature |
---|---|
โ HeadObject โ | โ
Conditional Operations: โ โ If-Match โ โ If-Modified-Since โ โ If-None-Match โ โ If-Unmodified-Since โ Range: โ โ Range (has no effect in HeadObject) โ โ partNumber โ SSE-C: โ โ x-amz-server-side-encryption-customer-algorithm โ โ x-amz-server-side-encryption-customer-key โ โ x-amz-server-side-encryption-customer-key-MD5 โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListObjects โ | Query Parameters: โ โ delimiter โ โ encoding-type โ โ marker โ โ max-keys โ โ prefix โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListObjectsV2 โ | Query Parameters: โ โ list-type โ โ continuation-token โ โ delimiter โ โ encoding-type โ โ fetch-owner โ โ max-keys โ โ prefix โ โ start-after โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ GetObject โ | โ
Conditional Operations: โ โ If-Match โ โ If-Modified-Since โ โ If-None-Match โ โ If-Unmodified-Since โ Range: โ โ Range โ โ PartNumber โ SSE-C: โ โ x-amz-server-side-encryption-customer-algorithm โ โ x-amz-server-side-encryption-customer-key โ โ x-amz-server-side-encryption-customer-key-MD5 โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ PutObject โ | โ
System Metadata: โ โ Content-Type โ โ Cache-Control โ โ Content-Disposition โ โ Content-Encoding โ โ Content-Language โ โ Expires โ โ Content-MD5 โ Storage Class: โ โ x-amz-storage-class โ โ โ STANDARD โ โ โ STANDARD_IA โ Object Lifecycle โ Website: โ โ x-amz-website-redirect-location โ SSE-C: โ โ 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-server-side-encryption-aws-kms-key-id โ โ x-amz-server-side-encryption-context โ โ x-amz-server-side-encryption-bucket-key-enabled โ Request Payer: โ โ x-amz-request-payer โ Tagging: โ โ x-amz-tagging โ Object Locking: โ โ x-amz-object-lock-mode โ โ x-amz-object-lock-retain-until-date โ โ x-amz-object-lock-legal-hold โ ACL: โ โ x-amz-acl โ โ x-amz-grant-full-control โ โ x-amz-grant-read โ โ x-amz-grant-read-acp โ โ x-amz-grant-write-acp โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ DeleteObject โ | โ Multi-factor authentication: โ โ x-amz-mfa โ Object Locking: โ โ x-amz-bypass-governance-retention โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ DeleteObjects โ | โ Multi-factor authentication: โ โ x-amz-mfa โ Object Locking: โ โ x-amz-bypass-governance-retention โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ ListMultipartUploads โ | โ
Query Parameters: โ โ delimiter โ โ encoding-type โ โ key-marker โ โ ๏ธ max-uploads โ โ prefix โ โ upload-id-marker |
โ CreateMultipartUpload โ | โ
System Metadata: โ โ Content-Type โ โ Cache-Control โ โ Content-Disposition โ โ Content-Encoding โ โ Content-Language โ โ Expires โ โ Content-MD5 โ Storage Class: โ โ x-amz-storage-class โ โ โ STANDARD โ โ โ STANDARD_IA โ Website: โ โ x-amz-website-redirect-location โ SSE-C: โ โ 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-server-side-encryption-aws-kms-key-id โ โ x-amz-server-side-encryption-context โ โ x-amz-server-side-encryption-bucket-key-enabled โ Request Payer: โ โ x-amz-request-payer โ Tagging: โ โ x-amz-tagging โ Object Locking: โ โ x-amz-object-lock-mode โ โ x-amz-object-lock-retain-until-date โ โ x-amz-object-lock-legal-hold โ ACL: โ โ x-amz-acl โ โ x-amz-grant-full-control โ โ x-amz-grant-read โ โ x-amz-grant-read-acp โ โ x-amz-grant-write-acp โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ CompleteMultipartUpload โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner โ Request Payer: โ โ x-amz-request-payer |
โ AbortMultipartUpload โ | โ Request Payer: โ โ x-amz-request-payer |
โ CopyObject โ | โ
Operation Metadata: โ โ x-amz-metadata-directive โ System Metadata: โ โ Content-Type โ โ Cache-Control โ โ Content-Disposition โ โ Content-Encoding โ โ Content-Language โ โ Expires โ Conditional Operations: โ โ 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 โ Storage Class: โ โ x-amz-storage-class โ โ โ STANDARD โ โ โ STANDARD_IA โ ACL: โ โ x-amz-acl โ โ x-amz-grant-full-control โ โ x-amz-grant-read โ โ x-amz-grant-read-acp โ โ x-amz-grant-write-acp โ Website: โ โ x-amz-website-redirect-location โ SSE-C: โ โ 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-server-side-encryption-aws-kms-key-id โ โ x-amz-server-side-encryption-context โ โ x-amz-server-side-encryption-bucket-key-enabled โ โ 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 โ Request Payer: โ โ x-amz-request-payer โ Tagging: โ โ x-amz-tagging โ โ x-amz-tagging-directive โ Object Locking: โ โ x-amz-object-lock-mode โ โ x-amz-object-lock-retain-until-date โ โ x-amz-object-lock-legal-hold โ Bucket Owner: โ โ x-amz-expected-bucket-owner โ โ x-amz-source-expected-bucket-owner โ Checksums: โ โ x-amz-checksum-algorithm |
โ UploadPart โ | โ
System Metadata: โ โ Content-MD5 โ SSE-C: โ โ 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 โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
โ UploadPartCopy โ | โ Conditional Operations: โ โ 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 โ Range: โ โ x-amz-copy-source-range โ SSE-C: โ โ 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 โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner โ โ x-amz-source-expected-bucket-owner |
โ ListParts โ | Query Parameters: โ โ max-parts โ โ part-number-marker โ Request Payer: โ โ x-amz-request-payer โ Bucket Owner: โ โ x-amz-expected-bucket-owner |
Unimplemented object-level operations
API Name | Feature |
---|---|
โ GetObjectTagging โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner โ Request Payer: โ โ x-amz-request-payer |
โ PutObjectTagging โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner โ Request Payer: โ โ x-amz-request-payer โ Checksums: โ โ x-amz-sdk-checksum-algorithm |
โ DeleteObjectTagging โ | โ Bucket Owner: โ โ x-amz-expected-bucket-owner |