From: Casey Bodley Date: Mon, 6 May 2019 13:33:05 +0000 (-0400) Subject: doc/rgw: document CreateBucketConfiguration for s3 PUT Bucket api X-Git-Tag: v14.2.2~68^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F28512%2Fhead;p=ceph.git doc/rgw: document CreateBucketConfiguration for s3 PUT Bucket api Fixes: http://tracker.ceph.com/issues/39597 Signed-off-by: Casey Bodley (cherry picked from commit e97668bb7a1333850a5791ae16b97496851ac854) --- diff --git a/doc/radosgw/placement.rst b/doc/radosgw/placement.rst index bd164daf8de88..208ecad979c8e 100644 --- a/doc/radosgw/placement.rst +++ b/doc/radosgw/placement.rst @@ -195,6 +195,8 @@ format must be edited manually: $ vi user.json $ radosgw-admin metadata put user: < user.json +.. _s3_bucket_placement: + S3 Bucket Placement ------------------- diff --git a/doc/radosgw/s3/bucketops.rst b/doc/radosgw/s3/bucketops.rst index 51b613ae111bc..01e5eb4bfdd7c 100644 --- a/doc/radosgw/s3/bucketops.rst +++ b/doc/radosgw/s3/bucketops.rst @@ -7,8 +7,6 @@ PUT Bucket Creates a new bucket. To create a bucket, you must have a user ID and a valid AWS Access Key ID to authenticate requests. You may not create buckets as an anonymous user. -.. note:: We do not support request entities for ``PUT /{bucket}`` in this release. - Constraints ~~~~~~~~~~~ In general, bucket names should follow domain name constraints. @@ -37,6 +35,16 @@ Parameters | ``x-amz-acl`` | Canned ACLs. | ``private``, ``public-read``, ``public-read-write``, ``authenticated-read`` | No | +---------------+----------------------+-----------------------------------------------------------------------------+------------+ +Request Entities +~~~~~~~~~~~~~~~~ + ++-------------------------------+-----------+----------------------------------------------------------------+ +| Name | Type | Description | ++===============================+===========+================================================================+ +| ``CreateBucketConfiguration`` | Container | A container for the bucket configuration. | ++-------------------------------+-----------+----------------------------------------------------------------+ +| ``LocationConstraint`` | String | A zonegroup api name, with optional :ref:`s3_bucket_placement` | ++-------------------------------+-----------+----------------------------------------------------------------+ HTTP Response