Prev Next

3.3. Managing S3 User and Bucket Limits via REST API¶

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

3.3.1. Setting Operations per Second for Users¶

You can limit operations rate with the ostor-limits service and the following parameters: emailAddress specifying the email address, ops specifying the limit type, and default=, get=, put=, list=, or delete= specifying the limit value:

# s3_curl PUT "http://s3.example.com/?ostor-limits&emailAddress=client@example.com&limit-type=ops&limit-resource=get&limit-value=3600"

3.3.2. Setting Bandwidth per Second for Users¶

You can limit outgoing bandwidth of a response with the ostor-limits service and the following parameters: emailAddress specifying the email address, bandwidth specifying the limit type, and out= specifying the limit value:

# s3_curl PUT "http://s3.example.com/?ostor-limits&emailAddress=client@example.com&limit-type=bandwidth&limit-resource=out&limit-value=100"

3.3.3. Querying User Limits¶

You can display the current limits with the ostor-limits service and parameter emailAddress specifying the email address:

# s3_curl GET "http://s3.example.com/?ostor-limits&emailAddress=client@example.com"
{
    "ops:default": "0.00",
    "ops:get": "3600.00",
    "ops:put": "0.00",
    "ops:list": "0.00",
    "ops:delete": "0.00",
    "bandwidth:out": "100"
}

3.3.4. Deleting User Limits¶

You can delete the current limits with the ostor-limits service and parameter emailAddress specifying the email address:

# s3_curl DELETE "http://s3.example.com/?ostor-limits&emailAddress=client@example.com"

3.3.5. Setting Operations per Second for Buckets¶

You can limit operations rate with the ostor-limits service and the following parameters: bucket specifying the bucket name, ops specifying the limit type, and default=, get=, put=, list=, or delete= specifying the limit value:

# s3_curl PUT "http://s3.example.com/?ostor-limits&bucket=client&limit-type=ops&limit-resource=get&limit-value=3600"

3.3.6. Setting Bandwidth per Second for Buckets¶

You can limit outgoing bandwidth of a response with the ostor-limits service and the following parameters: bucket specifying the bucket name, bandwidth specifying the limit type, and out= specifying the limit value:

# s3_curl PUT "http://s3.example.com/?ostor-limits&bucket=client&limit-type=bandwidth&limit-resource=out&limit-value=100"

3.3.7. Querying Bucket Limits¶

You can display the current limits with the ostor-limits service and parameter bucket specifying the bucket name:

# s3_curl GET "http://s3.example.com/?ostor-limits&bucket=client"
{
    "ops:default": "0.00",
    "ops:get": "3600.00",
    "ops:put": "0.00",
    "ops:list": "0.00",
    "ops:delete": "0.00",
    "bandwidth:out": "100"
}

3.3.8. Deleting Bucket Limits¶

You can delete the current limits with the ostor-limits service and parameter bucket specifying the bucket name:

# s3_curl DELETE "http://s3.example.com/?ostor-limits&bucket=client"

Jul 21, 2020

Prev Next