S3 API Commands Supported by Spaces

Validated on 6 Dec 2024 • Last edited on 15 Apr 2025

Spaces Object Storage is an S3-compatible object storage service. Spaces buckets let you store and serve large amounts of data, and the built-in CDN minimizes page load times and improves performance.

DigitalOcean Spaces support the following S3 API commands, in alphabetical order for each level of access key permissions.

Read (Objects)

GetBucketLocation
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketLocation documentation.

GetBucketVersioning
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketVersioning documentation.

GetObjectAcl
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner
  • x-amz-request-payer

For more details, see the GetObjectAcl documentation.

GetObject
Verb Required Headers Supported Headers
GET
  • if-match
  • if-modified-since
  • if-none-match
  • if-unmodified-since
  • range
  • x-amz-checksum-mode
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

For more details, see the GetObject documentation.

GetObjectTagging
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner
  • x-amz-request-payer

For more details, see the GetObjectTagging documentation.

HeadBucket
Verb Required Headers Supported Headers
HEAD
  • x-amz-expected-bucket-owner

For more details, see the HeadBucket documentation.

HeadObject
Verb Required Headers Supported Headers
HEAD
  • if-match
  • if-modified-since
  • if-none-match
  • if-unmodified-since
  • range
  • x-amz-checksum-mode
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

For more details, see the HeadObject documentation.

ListMultipartUploads
Verb Required Headers Supported Headers
LIST
  • x-amz-expected-bucket-owner

For more details, see the ListMultipartUploads documentation.

ListObjects
Verb Required Headers Supported Headers
LIST
  • x-amz-expected-bucket-owner
  • x-amz-request-payer

For more details, see the ListObjects documentation.

ListObjectsV2
Verb Required Headers Supported Headers
LIST
  • x-amz-expected-bucket-owner
  • x-amz-request-payer

For more details, see the ListObjectsV2 documentation.

ListObjectVersions
Verb Required Headers Supported Headers
LIST
  • x-amz-expected-bucket-owner

For more details, see the ListObjectVersions documentation.

ListParts
Verb Required Headers Supported Headers
LIST
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

For more details, see the ListParts documentation.

PreflightObject
Verb Required Headers Supported Headers
OPTIONS

Read/Write/Delete (Objects)

AbortMultipartUpload
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner
  • x-amz-request-payer

For more details, see the AbortMultipartUpload documentation.

CompleteMultipartUpload
Verb Required Headers Supported Headers
POST
  • x-amz-checksum-crc32
  • x-amz-checksum-crc32c
  • x-amz-checksum-sha1
  • x-amz-checksum-sha256
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

For more details, see the CompleteMultipartUpload documentation.

CopyObject
Verb Required Headers Supported Headers
PUT
  • x-amz-copy-source
  • Cache-Control
  • Content-Disposition
  • Content-Type
  • Expires
  • x-amz-acl
  • x-amz-checksum-algorithm
  • x-amz-checksum-algorithm
  • x-amz-copy-if-match
  • x-amz-copy-if-modified-since
  • x-amz-copy-if-none-match
  • x-amz-copy-if-unmodified-since
  • 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-expected-bucket-owner
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write-acp
  • x-amz-metadata-directive
  • x-amz-object-lock-legal-hold
  • x-amz-object-lock-mode
  • x-amz-object-lock-retain-until-date
  • x-amz-request-payer
  • x-amz-server-side-encryption
  • x-amz-server-side-encryption-aws-kms-key-id
  • x-amz-server-side-encryption-bucket-key-enabled
  • x-amz-server-side-encryption-context
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5
  • x-amz-source-expected-bucket-owner
  • x-amz-storage-class
  • x-amz-tagging
  • x-amz-tagging-directive
  • x-amz-website-redirect-location

For more details, see the CopyObject documentation.

CreateMultipartUpload
Verb Required Headers Supported Headers
POST
  • Cache-Control
  • Content-Disposition
  • Content-Encoding
  • Content-Language
  • Content-Type
  • Expires
  • x-amz-acl
  • x-amz-checksum-algorithm
  • x-amz-expected-bucket-owner
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write-acp
  • 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-aws-kms-key-id
  • x-amz-server-side-encryption-bucket-key-enabled
  • x-amz-server-side-encryption-context
  • 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-website-redirect-location

For more details, see the CreateMultiPartUpload documentation.

DeleteObject
Verb Required Headers Supported Headers
DELETE
  • x-amz-bypass-governance-retention
  • x-amz-expected-bucket-owner
  • x-amz-mfa
  • x-amz-request-payer

For more details, see the DeleteObject documentation.

DeleteObjectTagging
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteObjectTagging documentation.

DeleteObjects
Verb Required Headers Supported Headers
DELETE
  • x-amz-bypass-governance-retention
  • x-amz-expected-bucket-owner
  • x-amz-mfa
  • x-amz-request-payer
  • x-amz-sdk-checksum-algorithm

For more details, see the DeleteObjects documentation.

PostObject
Verb Required Headers Supported Headers
POST

For more details, see the PostObject documentation.

PutObjectAcl
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-acl
  • x-amz-expected-bucket-owner
  • x-amz-sdk-checksum-algorithm
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write
  • x-amz-grant-write-acp
  • x-amz-request-payer

For more details, see the PutObjectAcl documentation.

PutObject
Verb Required Headers Supported Headers
PUT
  • Cache-Control
  • Content-Disposition
  • Content-Encoding
  • Content-Language
  • Content-Length
  • Content-MD5
  • Content-Type
  • Expires
  • x-amz-acl
  • x-amz-checksum-crc32
  • x-amz-checksum-crc32c
  • x-amz-checksum-sha1
  • x-amz-checksum-sha256
  • x-amz-expected-bucket-owner
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write-acp
  • x-amz-object-lock-legal-hold
  • x-amz-object-lock-mode
  • x-amz-object-lock-retain-until-date
  • x-amz-request-payer
  • x-amz-sdk-checksum-algorithm
  • x-amz-server-side-encryption
  • x-amz-server-side-encryption-aws-kms-key-id
  • x-amz-server-side-encryption-bucket-key-enabled
  • x-amz-server-side-encryption-context
  • 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-website-redirect-location

For more details, see the PutObject documentation.

PutObjectTagging
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-sdk-checksum-algorithm

For more details, see the PutObjectTagging documentation.

UploadPartCopy
Verb Required Headers Supported Headers
PUT
  • x-amz-copy-source
  • 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-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-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5
  • x-amz-source-expected-bucket-owner

For more details, see the UploadPartCopy documentation.

UploadPart
Verb Required Headers Supported Headers
PUT
  • x-amz-copy-source
  • Content-Length
  • Content-MD5
  • x-amz-checksum-crc32
  • x-amz-checksum-crc32c
  • x-amz-checksum-sha1
  • x-amz-checksum-sha256
  • x-amz-expected-bucket-owner
  • x-amz-request-payer
  • x-amz-sdk-checksum-algorithm
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

For more details, see the UploadPart documentation.

All Permissions (Buckets and Objects)

CreateBucket
Verb Required Headers Supported Headers
PUT
  • x-amz-acl
  • x-amz-bucket-object-lock-enabled
  • x-amz-bucket-object-lock-enabled
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write
  • x-amz-grant-write-acp
  • x-amz-object-ownership

For more details, see the CreateBucket documentation.

DeleteBucketCors
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteBucketCors documentation.

DeleteBucketLifecycle
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteBucketLifecycle documentation.

DeleteBucketPolicy
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteBucketPolicy documentation.

DeleteBucket
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteBucket documentation.

DeleteBucketWebsite
Verb Required Headers Supported Headers
DELETE
  • x-amz-expected-bucket-owner

For more details, see the DeleteBucketWebsite documentation.

GetBucketAcl
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketAcl documentation.

GetBucketCors
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketCors documentation.

GetBucketLifecycleConfiguration
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketLifecycleConfiguration documentation.

GetBucketLifecycle
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketLifecycle documentation.

GetBucketPolicy
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

For more details, see the GetBucketPolicy documentation.

GetBucketWebsite
Verb Required Headers Supported Headers
GET
  • x-amz-expected-bucket-owner

The URL of the resulting public bucket is in the format https://[bucket-name].[datacenter-name]-static.digitaloceanspaces.com For example, https://bucket1.nyc3-static.digitaloceanspaces.com.

For more details, see the GetBucketWebsite documentation.

ListBuckets
Verb Required Headers Supported Headers
LIST

For more details, see the ListBuckets documentation.

PutBucketAcl
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-acl
  • x-amz-expected-bucket-owner
  • x-amz-grant-full-control
  • x-amz-grant-read
  • x-amz-grant-read-acp
  • x-amz-grant-write
  • x-amz-grant-write-acp
  • x-amz-sdk-checksum-algorithm

For more details, see the PutBucketAcl documentation.

PutBucketCors
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-sdk-checksum-algorithm
  • x-amz-expected-bucket-owner

For more details, see the PutBucketCors documentation.

PutBucketLifecycleConfiguration
Verb Required Headers Supported Headers
PUT
  • x-amz-expected-bucket-owner
  • x-amz-sdk-checksum-algorithm

For more details, see the PutBucketLifecycleConfiguration documentation.

PutBucketLifecycle
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-expected-bucket-owner
  • x-amz-sdk-checksum-algorithm

For more details, see the PutBucketLifecycle documentation.

PutBucketPolicy
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-confirm-remove-self-bucket-access
  • x-amz-expected-bucket-owner
  • x-amz-sdk-checksum-algorithm

For more details, see the PutBucketPolicy documentation.

PutBucketVersioning
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-expected-bucket-owner
  • x-amz-mfa
  • x-amz-sdk-checksum-algorithm

For more details, see the PutBucketVersioning documentation.

PutBucketWebsite
Verb Required Headers Supported Headers
PUT
  • Content-MD5
  • x-amz-expected-bucket-owner
  • x-amz-sdk-checksum-algorithm

The URL of the resulting public bucket is in the format https://[bucket-name].[datacenter-name]-static.digitaloceanspaces.com. For example, https://bucket1.nyc3-static.digitaloceanspaces.com.

For more details, see the PutBucketWebsite documentation.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.