blob: ca848bc277eb14bc7b403c8b15a6b1605f46a802 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
=================
Common Entities
=================
.. toctree::
:maxdepth: -1
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 |
+====================+==========================================+
| ``CONTENT_LENGTH`` | Length of the request body. |
+--------------------+------------------------------------------+
| ``DATE`` | Request time and date (in UTC). |
+--------------------+------------------------------------------+
| ``HOST`` | The name of the host server. |
+--------------------+------------------------------------------+
| ``AUTHORIZATION`` | Authorization token. |
+--------------------+------------------------------------------+
Common Response Status
----------------------
+---------------+-----------------------------------+
| HTTP Status | Response Code |
+===============+===================================+
| ``100`` | Continue |
+---------------+-----------------------------------+
| ``200`` | Success |
+---------------+-----------------------------------+
| ``201`` | Created |
+---------------+-----------------------------------+
| ``202`` | Accepted |
+---------------+-----------------------------------+
| ``204`` | NoContent |
+---------------+-----------------------------------+
| ``206`` | Partial content |
+---------------+-----------------------------------+
| ``304`` | NotModified |
+---------------+-----------------------------------+
| ``400`` | InvalidArgument |
+---------------+-----------------------------------+
| ``400`` | InvalidDigest |
+---------------+-----------------------------------+
| ``400`` | BadDigest |
+---------------+-----------------------------------+
| ``400`` | InvalidBucketName |
+---------------+-----------------------------------+
| ``400`` | InvalidObjectName |
+---------------+-----------------------------------+
| ``400`` | UnresolvableGrantByEmailAddress |
+---------------+-----------------------------------+
| ``400`` | InvalidPart |
+---------------+-----------------------------------+
| ``400`` | InvalidPartOrder |
+---------------+-----------------------------------+
| ``400`` | RequestTimeout |
+---------------+-----------------------------------+
| ``400`` | EntityTooLarge |
+---------------+-----------------------------------+
| ``403`` | AccessDenied |
+---------------+-----------------------------------+
| ``403`` | UserSuspended |
+---------------+-----------------------------------+
| ``403`` | RequestTimeTooSkewed |
+---------------+-----------------------------------+
| ``404`` | NoSuchKey |
+---------------+-----------------------------------+
| ``404`` | NoSuchBucket |
+---------------+-----------------------------------+
| ``404`` | NoSuchUpload |
+---------------+-----------------------------------+
| ``405`` | MethodNotAllowed |
+---------------+-----------------------------------+
| ``408`` | RequestTimeout |
+---------------+-----------------------------------+
| ``409`` | BucketAlreadyExists |
+---------------+-----------------------------------+
| ``409`` | BucketNotEmpty |
+---------------+-----------------------------------+
| ``411`` | MissingContentLength |
+---------------+-----------------------------------+
| ``412`` | PreconditionFailed |
+---------------+-----------------------------------+
| ``416`` | InvalidRange |
+---------------+-----------------------------------+
| ``422`` | UnprocessableEntity |
+---------------+-----------------------------------+
| ``500`` | InternalError |
+---------------+-----------------------------------+
.. _`Ceph Object Gateway - Multisite Configuration`: ../../multisite
|
