:Type: String
:Example: ``foo_user``
:Required: Yes
-A tenant name may also specified as a part of ``uid``, by following the syntax ``tenant$user``, refer to `Multitenancy`_ for more details.
+
+A tenant name may also specified as a part of ``uid``, by following the syntax
+``tenant$user``, refer to :ref:`Multitenancy <rgw-multitenancy>` for more details.
``display-name``
:Required: No
.. versionadded:: Jewel
+
``tenant``
:Description: the Tenant under which a user is a part of.
:Type: Container
``tenant``
-:Description: The tenant which user is a part of
+
+:Description: The tenant which user is a part of.
:Type: String
:Parent: ``user``
==============
Create a new subuser (primarily useful for clients using the Swift API).
-Note that in general for a subuser to be useful, it must be granted
+Note that in general for a subuser to be useful, it must be granted
permissions by specifying ``access``. As with user creation if
``subuser`` is specified without ``secret``, then a secret key will
be automatically generated.
===============
Get information about a subset of the existing buckets. If ``uid`` is specified
-without ``bucket`` then all buckets beloning to the user will be returned. If
+without ``bucket`` then all buckets belonging to the user will be returned. If
``bucket`` alone is specified, information for that particular bucket will be
retrieved.
- **Maximum Objects:** The ``max-objects`` setting allows you to specify
the maximum number of objects. A negative value disables this setting.
-
+
- **Maximum Size:** The ``max-size`` option allows you to specify a quota
for the maximum number of bytes. The ``max-size-kb`` option allows you
to specify it in KiB. A negative value disables this setting.
Get User Quota
~~~~~~~~~~~~~~
-To get a quota, the user must have ``users`` capability set with ``read``
+To get a quota, the user must have ``users`` capability set with ``read``
permission. ::
GET /admin/user?quota&uid=<uid>"a-type=user
Set User Quota
~~~~~~~~~~~~~~
-To set a quota, the user must have ``users`` capability set with ``write``
+To set a quota, the user must have ``users`` capability set with ``write``
permission. ::
PUT /admin/user?quota&uid=<uid>"a-type=user
Get Bucket Quota
~~~~~~~~~~~~~~~~
-To get a quota, the user must have ``users`` capability set with ``read``
+To get a quota, the user must have ``users`` capability set with ``read``
permission. ::
GET /admin/user?quota&uid=<uid>"a-type=bucket
Set Bucket Quota
~~~~~~~~~~~~~~~~
-To set a quota, the user must have ``users`` capability set with ``write``
+To set a quota, the user must have ``users`` capability set with ``write``
permission. ::
PUT /admin/user?quota&uid=<uid>"a-type=bucket
+
+Binding libraries
+========================
+
+``Golang``
+
+ - `IrekFasikhov/go-rgwadmin`_
+ - `QuentinPerez/go-radosgw`_
+
+``Java``
+
+ - `twonote/radosgw-admin4j`_
+
+``Python``
+
+ - `UMIACS/rgwadmin`_
+ - `valerytschopp/python-radosgw-admin`_
+
+
+
.. _Admin Guide: ../admin
.. _Quota Management: ../admin#quota-management
-.. _Multitenancy: ./multitenancy
+.. _IrekFasikhov/go-rgwadmin: https://github.com/IrekFasikhov/go-rgwadmin
+.. _QuentinPerez/go-radosgw: https://github.com/QuentinPerez/go-radosgw
+.. _twonote/radosgw-admin4j: https://github.com/twonote/radosgw-admin4j
+.. _UMIACS/rgwadmin: https://github.com/UMIACS/rgwadmin
+.. _valerytschopp/python-radosgw-admin: https://github.com/valerytschopp/python-radosgw-admin
+