Upload dữ liệu image

PUT/v2/images/{image_id}/file

Upload file image dạng binary vào một bản ghi image đã tạo bằng POST /v2/images.

Trước khi có thể lưu dữ liệu image, request phải đáp ứng các điều kiện sau:

• Image phải tồn tại.
• Bạn phải đặt disk_format và container_format trong bản ghi image.
• status của image phải là queued.
• Quota lưu trữ image phải đủ.
• Kích thước dữ liệu upload không được vượt giới hạn cấu hình của OpenStack Image service.

Nguồn: OpenStack Image service API v2 — Upload binary image data

Request

Header

• Content-Type (header, string) — Mô tả media type của request body. Khi upload dữ liệu image dạng binary, đặt là application/octet-stream (hoặc media type image phù hợp mà cloud hỗ trợ).
• X-Image-Meta-Store (Optional, header, string) — Store ID để upload hoặc import dữ liệu image. Chỉ dùng với cloud hỗ trợ nhiều backend store. Bỏ trống để dùng store mặc định. (Mới trong API v2.8)
• X-Auth-Token — Token xác thực Keystone của bạn.

Tham số path

image_idstringbắt buộc

UUID của image cần upload dữ liệu.

Ví dụ (curl)

Đặt header Content-Type là application/octet-stream và gửi image dưới dạng binary.

curl -ks -X PUT \
  -H 'Content-Type: application/octet-stream' \
  -H 'X-Auth-Token: gAAAAA<...>' \
  --data-binary @alpine.qcow2 \
  https://api.vietnix.cloud:9292/v2/images/9775d86a-8bf8-4200-a4b5-d892e931e8f6/file

Response

Thành công

Mã	Mô tả
204 - No Content	Server đã nhận dữ liệu và hoàn tất upload. Sau khi upload thành công, status của image chuyển sang active.

Lỗi

Mã	Mô tả
400 - Bad Request	Nội dung request không hợp lệ.
401 - Unauthorized	Cần xác thực trước khi gửi request.
403 - Forbidden	Policy không cho phép user hiện tại thực hiện thao tác này.
404 - Not Found	Không tìm thấy image.
409 - Conflict	Thao tác xung đột với một thao tác khác trên tài nguyên.
410 - Gone	Tài nguyên đích không còn khả dụng.
413 - Request Entity Too Large	Dữ liệu upload lớn hơn mức server có thể xử lý.
415 - Unsupported Media Type	Media type của request không được server hoặc tài nguyên hỗ trợ.
503 - Service Unavailable	Service không khả dụng (lỗi cấu hình operator/service).