Product Home > Spaces Object Storage > Reference > Supported S3 Commands

Was this page helpful?

S3 Commands Supported by Spaces

Validated on 6 Dec 2024 • Last edited on 10 Dec 2024

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.

S3 Commands Supported by Spaces

Read (Objects)

Read/Write/Delete (Objects)

All Permissions (Buckets and Objects)

We can't find any results for your search.