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: v12.2.13~25^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=e28236a479ee81ab646cbfed36d4348c0b34a340;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 ce9ecbc2e084d..5878eb207e8ba 100644 --- a/doc/radosgw/placement.rst +++ b/doc/radosgw/placement.rst @@ -147,6 +147,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 ed1f2a4f6c7d9..16bd8fb1c7dd5 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