Managing S3 User and Bucket Limits via CLI
------------------------------------------

This section describes limits you can define for users and buckets via the command-line interface. You can apply the limits according to specific options that can be a part of your service plan.

Setting Operations per Second for Users
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can limit operations rate with the ``set-limits`` command and the following parameters: ``-e`` specifying the email address, ``-t ops`` specifying the limit type, and ``-L default=``, ``get=``, ``put=``, ``list=``, or ``delete=`` specifying the limit key:

::

   # ostor-s3-admin set-limits -e client@example.com -t ops -L get=3600
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=0kbs/s

Setting Bandwidth per Second for Users
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can limit outgoing bandwidth of a response with the ``set-limits`` command and the following parameters: ``-e`` specifying the email address, ``-t bandwidth`` specifying the limit type, and ``-L out=`` specifying the limit key:

::

   # ostor-s3-admin set-limits -e client@example.com -t bandwidth -L out=100
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=100kbs/s

Querying User Limits
~~~~~~~~~~~~~~~~~~~~

You can display the current limits with the ``query-limits`` command and parameter ``-e`` specifying the email address:

::

   # ostor-s3-admin query-limits -e client@example.com
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=100kbs/s

Deleting User Limits
~~~~~~~~~~~~~~~~~~~~

You can delete the current limits with the ``rm-limits`` command and parameter ``-e`` specifying the email address:

::

   # ostor-s3-admin rm-limits -e client@example.com
   ops:default=0.00ops/s
   ops:get=0.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=0kbs/s

Setting Operations per Second for Buckets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can limit operations rate with the ``set-limits`` command and the following parameters: ``-b`` specifying the bucket name, ``-t ops`` specifying the limit type, and ``-L default=``, ``get=``, ``put=``, ``list=``, or ``delete=`` specifying the limit key:

::

   # ostor-s3-admin set-limits -b example -t ops -L get=3600
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=0kbs/s

Setting Bandwidth per Second for Buckets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can limit outgoing bandwidth of a response with the ``set-limits`` command and the following parameters: ``-b`` specifying the bucket name, ``-t bandwidth`` specifying the limit type, and ``-L out=`` specifying the limit key:

::

   # ostor-s3-admin set-limits -b example -t bandwidth -L out=100
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=100kbs/s

Querying Bucket Limits
~~~~~~~~~~~~~~~~~~~~~~

You can display the current limits with the ``query-limits`` command and parameter ``-b`` specifying the bucket name:

::

   # ostor-s3-admin query-limits -b example
   ops:default=0.00ops/s
   ops:get=3600.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=100kbs/s

Deleting Bucket Limits
~~~~~~~~~~~~~~~~~~~~~~

You can delete the current limits with the ``rm-limits`` command and parameter ``-b`` specifying the bucket name:

::

   # ostor-s3-admin rm-limits -b example
   ops:default=0.00ops/s
   ops:get=0.00ops/s
   ops:put=0.00ops/s
   ops:list=0.00ops/s
   ops:delete=0.00ops/s
   bandwidth:out=0kbs/s
