Files
glance/releasenotes/notes/add-x-openstack-image-size-header-9199a5544274002a.yaml
Abhishek Kekane df0d0aad86 Update API reference to mention x-openstack-image-size header
Add API reference documentation for the x-openstack-image-size header
in PUT /v2/images/{image_id}/file and PUT /v2/images/{image_id}/stage
endpoints.

Assisted-By: Cursor (claude-3.5-sonnet)
Change-Id: Ie733373c093bed4866719f163a75abaff4abe6a2
Signed-off-by: Abhishek Kekane <akekane@redhat.com>
2025-08-07 06:05:13 +00:00

18 lines
786 B
YAML

---
features:
- |
Added support for the optional ``x-openstack-image-size`` header in image
upload endpoints. This header allows clients to specify the expected size
of image data in bytes when uploading images via the PUT
``/v2/images/{image_id}/file`` and PUT ``/v2/images/{image_id}/stage``
endpoints.
When the header is present, the server validates that the uploaded data
size matches the specified value. If the actual size does not match the
expected size, a 400 (Bad Request) response is returned. When the header
is not present, the server calculates the image size based on the actual
request body size.
This feature improves data integrity validation during image uploads and
helps prevent incomplete or corrupted uploads.