Image Data

Uploads and downloads raw image data

Download image data

get

Downloads binary image data

Authorizations
X-Auth-TokenstringRequired

OpenStack Keystone authentication token

Path parameters
image_idstring · uuidRequired

The UUID of the image

Header parameters
RangestringOptional

The range of image data requested

Responses
200

Image data downloaded successfully

application/octet-stream
Responsestring · binary
get
/images/{image_id}/file
GET /v2/images/{image_id}/file HTTP/1.1
Host: image.example.com
X-Auth-Token: YOUR_API_KEY
Accept: */*

binary

Upload image data

put

Uploads binary image data

Authorizations
X-Auth-TokenstringRequired

OpenStack Keystone authentication token

Path parameters
image_idstring · uuidRequired

The UUID of the image

Header parameters
X-Image-Meta-StorestringOptional

A store identifier to upload image data

Body
string · binaryOptional
Responses
put
/images/{image_id}/file
PUT /v2/images/{image_id}/file HTTP/1.1
Host: image.example.com
X-Auth-Token: YOUR_API_KEY
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"
No content

Stage image data

put

Places the binary image data in a staging area for interoperable image import

Authorizations
X-Auth-TokenstringRequired

OpenStack Keystone authentication token

Path parameters
image_idstring · uuidRequired

The UUID of the image

Body
string · binaryOptional
Responses
put
/images/{image_id}/stage
PUT /v2/images/{image_id}/stage HTTP/1.1
Host: image.example.com
X-Auth-Token: YOUR_API_KEY
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"
No content

Import image

post

Signals the Image Service to complete the image import workflow

Authorizations
X-Auth-TokenstringRequired

OpenStack Keystone authentication token

Path parameters
image_idstring · uuidRequired

The UUID of the image

Header parameters
X-Image-Meta-StorestringOptional

A store identifier to import image data

Body
storesstring[]Optional

List of store identifiers to import to

all_storesbooleanOptional

Import to all available stores

all_stores_must_succeedbooleanOptional

Whether all stores must succeed for the operation to succeed

Responses
post
/images/{image_id}/import
POST /v2/images/{image_id}/import HTTP/1.1
Host: image.example.com
X-Auth-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 244

{
  "method": {
    "name": "glance-direct",
    "uri": "https://example.com",
    "glance_image_id": "123e4567-e89b-12d3-a456-426614174000",
    "glance_region": "text",
    "glance_service_interface": "text"
  },
  "stores": [
    "text"
  ],
  "all_stores": true,
  "all_stores_must_succeed": true
}
No content
PreviousImage TagsNextImage Service Info

Last updated

Was this helpful?