Skip to main content

Overview

The Xloud 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 Xloud administrator if you do not have sufficient permissions.

Quota Reference

Quota FieldDefaultDescription
imagesUnlimitedMaximum number of images (including snapshots) per project
image_size_totalUnlimitedMaximum total image storage in bytes per project
image_staging_totalUnlimitedMaximum staging area usage per project
image_count_totalUnlimitedCombined count of uploaded and staging images
image_count_uploadingUnlimitedMaximum simultaneous uploads per project
Default quotas are unlimited unless explicitly configured. Set quotas proactively for multi-tenant deployments to prevent runaway storage consumption.

View Image Quotas

Navigate to Admin → System → Defaults and review the Image section quota fields. Per-project overrides are visible in Admin → Identity → Projects → Modify Quotas.

Set Project Quotas

Navigate to project quota settings

Navigate to Admin → Identity → Projects. 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.
FieldExampleDescription
Images100Maximum image count per project
Image Storage107374182400Maximum 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.

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.