Notice
This document is for a development version of Ceph.
Common Entities
Bucket and Host Name
There are two different modes of accessing the buckets. The first (preferred) method identifies the bucket as the top-level directory in the URI.
GET /mybucket HTTP/1.1
Host: cname.domain.com
The second method identifies the bucket via a virtual bucket host name. For example:
GET / HTTP/1.1
Host: mybucket.cname.domain.com
To configure virtual hosted buckets, you can either set rgw_dns_name = cname.domain.com
in ceph.conf, or add cname.domain.com
to the list of hostnames
in your zonegroup configuration. See Ceph Object Gateway - Multisite Configuration for more on zonegroups.
Tip
We prefer the first method, because the second method requires expensive domain certification and DNS wild cards.
Tip
You can define multiple hostname directly with the rgw_dns_name
parameter.
Common Request Headers
Request Header |
Description |
---|---|
|
Length of the request body. |
|
Request time and date (in UTC). |
|
The name of the host server. |
|
Authorization token. |
Common Response Status
HTTP Status |
Response Code |
---|---|
|
Continue |
|
Success |
|
Created |
|
Accepted |
|
NoContent |
|
Partial content |
|
NotModified |
|
InvalidArgument |
|
InvalidDigest |
|
BadDigest |
|
InvalidBucketName |
|
InvalidObjectName |
|
UnresolvableGrantByEmailAddress |
|
InvalidPart |
|
InvalidPartOrder |
|
RequestTimeout |
|
EntityTooLarge |
|
AccessDenied |
|
UserSuspended |
|
RequestTimeTooSkewed |
|
NoSuchKey |
|
NoSuchBucket |
|
NoSuchUpload |
|
MethodNotAllowed |
|
RequestTimeout |
|
BucketAlreadyExists |
|
BucketNotEmpty |
|
MissingContentLength |
|
PreconditionFailed |
|
InvalidRange |
|
UnprocessableEntity |
|
InternalError |
Brought to you by the Ceph Foundation
The Ceph Documentation is a community resource funded and hosted by the non-profit Ceph Foundation. If you would like to support this and our other efforts, please consider joining now.