`api.node.image`¶

/node/(hostname)/storage/(zpool)/image¶

api.node.image.views.node_image_list(*args, **kwargs)¶

List (GET) all images imported on a compute node storage or remove (DELETE) all unused images imported on a compute node storage.

GET /node/(hostname)/storage/(zpool)/image¶

DC-bound?:	✗
Permissions:	SuperAdmin
Asynchronous?:	✗
Parameters:	hostname (string) – required - Node hostname zpool (string) – required - Node storage pool name data.full (boolean) – Return list of objects with all image details (default: false) data.order_by (string) – Available fields for sorting: `name` (default: `name`)
Status Codes:	200 OK – SUCCESS 403 Forbidden – Forbidden 404 Not Found – Storage not found

DELETE /node/(hostname)/storage/(zpool)/image¶

Note

This API function will run DELETE node_image for every unused image.

DC-bound?:	✗
Permissions:	SuperAdmin
Asynchronous?:	✗
Parameters:	hostname (string) – required - Node hostname zpool (string) – required - Node storage pool name
Status Codes:	200 OK – SUCCESS 403 Forbidden – Forbidden 404 Not Found – Storage not found 423 Locked – Node is not operational

api.node.image.views.node_image(*args, **kwargs)¶

Show (GET), import (POST) or delete (DELETE) an image (name) on a compute node (hostname) storage (zpool).

GET /node/(hostname)/storage/(zpool)/image/(name)¶

DC-bound?:	✗
Permissions:	SuperAdmin
Asynchronous?:	✗
Parameters:	hostname (string) – required - Node hostname zpool (string) – required - Node storage pool name name (string) – required - Image name
Status Codes:	200 OK – SUCCESS 403 Forbidden – Forbidden 404 Not Found – Storage not found / Image not found

POST /node/(hostname)/storage/(zpool)/image/(name)¶

DC-bound?:	✗
Permissions:	SuperAdmin
Asynchronous?:	✓
Parameters:	hostname (string) – required - Node hostname zpool (string) – required - Node storage pool name name (string) – required - Image name
Status Codes:	200 OK – SUCCESS 201 Created – PENDING 400 Bad Request – FAILURE 403 Forbidden – Forbidden 404 Not Found – Storage not found / Image not found 406 Not Acceptable – Image already exists 423 Locked – Node is not operational 428 – Image requires newer node version / Image requires newer node version

DELETE /node/(hostname)/storage/(zpool)/image/(name)¶

DC-bound?:	✗
Permissions:	SuperAdmin
Asynchronous?:	✓
Parameters:	hostname (string) – required - Node hostname zpool (string) – required - Node storage pool name name (string) – required - Image name
Status Codes:	200 OK – SUCCESS 201 Created – PENDING 400 Bad Request – FAILURE 403 Forbidden – Forbidden 404 Not Found – Storage not found / Image not found 423 Locked – Node is not operational 428 – Image is used by some VMs