Get an Object Storage quota

get

https://api.linode.com/{apiVersion}/object-storage/quotas/{objQuotaId}

Returns information about a specific Object Storage-related quota on your account. The operation includes any quota overrides in the response.

linode-cli object-storage quota-view obj-objects-us-ord-1

Learn more...

object_storage:read_only

Learn more...

Responses

Response body

object

description

string

A description for the Object Storage-related quota.

endpoint_type

string

enum

The type of s3_endpoint. See Endpoint types for more information.

E0 E1 E2 E3

has_usage

boolean

Indicates whether usage metrics are collected for this quota. If true, you can use the Get Object Storage quota usage operation to see the current usage for this quota.

quota_id

string

Identifies the Object Storage-related quota. Formatted as <quota_type>-<s3_endpoint>.

quota_limit

integer

The maximum quantity of the resource_metric allowed by the quota.

quota_name

string

enum

Filterable The human-readable name of the Object Storage-related quota.

Number of Objects Number of Buckets Total Capacity Ingress Throughput (per endpoint) Egress Throughput (per endpoint) Ingress Throughput (per IP) Egress Throughput (per IP)

quota_type

string

enum

Identifies the type of Object Storage quota. Values include:

obj-buckets: Current number of buckets per account, per endpoint
obj-objects: Current number of objects per account, per endpoint
obj-bytes: Current total capacity per account, per endpoint
obj-total-ingress-throughput: Current total ingress bandwidth per account, per endpoint
obj-total-egress-throughput: Current total egress bandwidth per account, per endpoint
obj-per-ip-ingress-throughput: Current ingress bandwidth per account, per destination IP address
obj-per-ip-egress-throughput: Current egress bandwidth per account, per destination IP address

obj-buckets obj-objects obj-bytes obj-total-ingress-throughput obj-total-egress-throughput obj-per-ip-ingress-throughput obj-per-ip-egress-throughput

resource_metric

string

enum

The specific Object Storage-based resource for the quota. A quota maximum may apply as follows:

The Object Storage bucket quota for a single s3_endpoint
The object quota for a single s3_endpoint
The byte count quota for content in a single s3_endpoint

bucket object byte byte_per_second

s3_endpoint

string

Filterable The URL for the s3 endpoint where the quota applies. Every s3_endpoint exists in a specific Akamai Cloud Computing data center (region). Run the List Object Storage endpoints operation to see more specifics on this s3_endpoint.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/object-storage/quotas/objQuotaId \
3
     --header 'accept: application/json'


xxxxxxxxxx
11
 
1
{
2
  "description": "Current number of buckets per account, per endpoint",
3
  "endpoint_type": "E1",
4
  "has_usage": true,
5
  "quota_id": "obj-buckets-us-sea-1.linodeobjects.com",
6
  "quota_limit": 1000,
7
  "quota_name": "Number of Buckets",
8
  "quota_type": "obj-buckets",
9
  "resource_metric": "bucket",
10
  "s3_endpoint": "us-sea-1.linodeobjects.com"
11
}

200A single Object Storage-related quota for your account.

defaultSee Errors for the range of possible error response codes.