12.4. Managing quota limits by using the API

Procedure

1. To set a quota for an organization, you can use the POST /api/v1/organization/{orgname}/quota endpoint:

   $ curl -X POST "https://<quay-server.example.com>/api/v1/organization/<orgname>/quota" \
        -H "Authorization: Bearer <access_token>" \
        -H "Content-Type: application/json" \
        -d '{
            "limit_bytes": 10737418240,
            "limits": "10 Gi"
        }'

   Example output

   "Created"

2. Use the GET /api/v1/organization/{orgname}/quota command to see if your organization already has an established quota:

   $ curl -k -X GET -H "Authorization: Bearer <token>" -H 'Content-Type: application/json'  https://<quay-server.example.com>/api/v1/organization/<organization_name>/quota  | jq

   Example output

   [{"id": 1, "limit_bytes": 10737418240, "limit": "10.0 GiB", "default_config": false, "limits": [], "default_config_exists": false}]

3. You can use the PUT /api/v1/organization/{orgname}/quota/{quota_id} command to modify the existing quota limitation. For example:

   $ curl -X PUT "https://<quay-server.example.com>/api/v1/organization/<orgname>/quota/<quota_id>" \
        -H "Authorization: Bearer <access_token>" \
        -H "Content-Type: application/json" \
        -d '{
            "limit_bytes": <limit_in_bytes>
        }'

   Example output

   {"id": 1, "limit_bytes": 21474836480, "limit": "20.0 GiB", "default_config": false, "limits": [], "default_config_exists": false}