Image Service Quotas

Overview

The Polystack Image Service enforces per-project quotas on image count and total storage size. Quotas prevent a single project from consuming the entire image catalog storage and ensure equitable resource distribution across teams.

Administrator Access Required — This operation requires the admin role. Contact your Polystack administrator if you do not have sufficient permissions.

Quota Reference

Quota Field	Default	Description
`images`	Unlimited	Maximum number of images (including snapshots) per project
`image_size_total`	Unlimited	Maximum total image storage in bytes per project
`image_staging_total`	Unlimited	Maximum staging area usage per project
`image_count_total`	Unlimited	Combined count of uploaded and staging images
`image_count_uploading`	Unlimited	Maximum simultaneous uploads per project

Default quotas are unlimited unless explicitly configured. Set quotas proactively for multi-project deployments to prevent runaway storage consumption.

View Image Quotas

Dashboard
CLI

Navigate to the admin quota settings and review the Image section quota fields. Per-project overrides are visible in Identity > Projects (admin view) > Modify Quotas.

Show current image quota for a project

openstack quota show --project backend-prod

Show quota usage for a project

openstack quota show --usage --project backend-prod

Count images in a project

openstack image list \
  --project backend-prod \
  --format json | python3 -c \
  "import json,sys; imgs=json.load(sys.stdin); print(f'{len(imgs)} images')"

Set Project Quotas

Dashboard
CLI

Navigate to project quota settings

Navigate to Identity > Projects (admin view). Find the project and click Modify Quotas.

Set image quota values

Update the Images field to the maximum allowed image count and optionally set Image Storage in bytes.

Field	Example	Description
Images	`100`	Maximum image count per project
Image Storage	`107374182400`	Maximum total bytes (100 GB)

Save quotas

Click Save. The quota takes effect immediately.

Project quota is updated. New image uploads that exceed the limit will be rejected.

Set image count quota for a project

openstack quota set --images 100 backend-prod

View updated quotas

openstack quota show backend-prod | grep image

Storage-based quotas (byte limits) are set at the Image Service configuration level, not via the standard quota API. Contact your platform administrator to set user_storage_quota in the Image Service configuration.

Monitor Quota Usage

Set up regular quota monitoring to catch projects approaching their limits:

List all projects with image counts

openstack image list --all-projects \
  -c project_id \
  -f json | python3 -c "
import json, sys, collections
imgs = json.load(sys.stdin)
counts = collections.Counter(i['project_id'] for i in imgs)
for proj_id, count in sorted(counts.items(), key=lambda x: -x[1])[:10]:
    print(f'{count:4d}  {proj_id}')
"

Next Steps

Security

Control access to public image creation alongside quota enforcement.

Admin Troubleshooting

Resolve quota exceeded errors and investigate storage consumption.

Image Cache

Cache configuration also consumes storage — factor cache size into capacity planning.

Storage Backends

Review backend capacity alongside quota limits.

Core Services

Other Services

Overview

Quota Reference

View Image Quotas

Set Project Quotas

Navigate to project quota settings

Set image quota values

Save quotas

Monitor Quota Usage

Next Steps

Security

Admin Troubleshooting

Image Cache

Storage Backends

​Overview

​Quota Reference

​View Image Quotas

​Set Project Quotas

Navigate to project quota settings

Set image quota values

Save quotas

​Monitor Quota Usage

​Next Steps

Security

Admin Troubleshooting

Image Cache

Storage Backends

Overview

Quota Reference

View Image Quotas

Set Project Quotas

Monitor Quota Usage

Next Steps