2.2. 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.

2.2.1. 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

2.2.2. 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

2.2.3. 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

2.2.4. 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

2.2.5. 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

2.2.6. 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

2.2.7. 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

2.2.8. 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