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.
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 |
