Skip to content

Commit c61c314

Browse files
committed
doc/rgw: clarify path-style vs virtual-hosted-style access
instead of referring to "vhost-style", copy the "path-style" and "virtual-hosted-style" language from https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html expand the FQDN acronym to avoid potential confusion "The second method is deprecated by AWS" had incorrectly referred to the vhost-style method - clarify that it refers to path-style access Signed-off-by: Casey Bodley <[email protected]>
1 parent c3c9e6d commit c61c314

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

doc/radosgw/s3/commons.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,19 @@
77

88
Bucket and Host Name
99
--------------------
10-
There are two different modes of accessing buckets. The first method identifies
11-
the bucket as the top-level directory in the URI::
10+
There are two different modes of accessing buckets: path-style and virtual-hosted-style.
11+
Path-style requests identify the bucket as the top-level directory of the request's path::
1212

1313
GET /mybucket HTTP/1.1
1414
Host: cname.domain.com
1515

16-
Most S3 clients nowadays rely on vhost-style access. The desired bucket is
17-
indicated by a DNS FQDN. For example::
16+
Most S3 clients default to virtual-hosted-style access, where the bucket name is instead
17+
indicated as part of the fully-qualified domain name::
1818

1919
GET / HTTP/1.1
2020
Host: mybucket.cname.domain.com
2121

22-
The second method is deprecated by AWS. See the `Amazon S3 Path Deprecation
22+
Path-style access is deprecated by AWS. See the `Amazon S3 Path Deprecation
2323
Plan`_ for more information.
2424

2525
To configure virtual hosted buckets, you can either set ``rgw_dns_name =

0 commit comments

Comments
 (0)