Notice

This document is for a development version of Ceph.

Warning

This document is for an unsupported version of Ceph.

Edit on GitHub | Report a Documentation Bug

Ceph Object Gateway S3 API

Ceph supports a RESTful API that is compatible with the basic data access model of the Amazon S3 API.

API

• Common
• Authentication
• Service Ops
• Bucket Ops
• Object Ops
• C++
• C#
• Java
• Perl
• PHP
• Python
• Ruby AWS::SDK Examples (aws-sdk gem ~>2)
• Ruby AWS::S3 Examples (aws-s3 gem)

Features Support

The following table describes the support status for current Amazon S3 functional features:

Feature	Status	Remarks
List Buckets	Supported
Delete Bucket	Supported
Create Bucket	Supported	Different set of canned ACLs
Bucket Lifecycle	Supported	Removing expired files is supported
Policy (Buckets, Objects)	Not Supported	ACLs are supported
Bucket Website	Supported
Bucket ACLs (Get, Put)	Supported	Different set of canned ACLs
Bucket Location	Supported
Bucket Notification	Not Supported
Bucket Object Versions	Supported
Get Bucket Info (HEAD)	Supported
Bucket Request Payment	Supported
Put Object	Supported
Delete Object	Supported
Get Object	Supported
Object ACLs (Get, Put)	Supported
Get Object Info (HEAD)	Supported
POST Object	Supported
Copy Object	Supported
Multipart Uploads	Supported

Unsupported Header Fields

The following common request header fields are not supported:

Name	Type
x-amz-security-token	Request
Server	Response
x-amz-delete-marker	Response
x-amz-id-2	Response
x-amz-version-id	Response