ironic.common.image_service.
BaseImageService
[source]¶Bases: object
Provides retrieval of disk images.
download
(image_href, image_file)[source]¶Downloads image to specified location.
Parameters: |
|
---|---|
Raises: | exception.ImageRefValidationFailed. |
Raises: | exception.ImageDownloadFailed. |
show
(image_href)[source]¶Get dictionary of image properties.
Parameters: | image_href – Image reference. |
---|---|
Raises: | exception.ImageRefValidationFailed. |
Returns: | dictionary of image properties. It has three of them: ‘size’, ‘updated_at’ and ‘properties’. ‘updated_at’ attribute is a naive UTC datetime object. |
ironic.common.image_service.
FileImageService
[source]¶Bases: ironic.common.image_service.BaseImageService
Provides retrieval of disk images available locally on the conductor.
download
(image_href, image_file)[source]¶Downloads image to specified location.
Parameters: |
|
---|---|
Raises: | exception.ImageRefValidationFailed if source image file doesn’t exist. |
Raises: | exception.ImageDownloadFailed if exceptions were raised while writing to file or creating hard link. |
show
(image_href)[source]¶Get dictionary of image properties.
Parameters: | image_href – Image reference. |
---|---|
Raises: | exception.ImageRefValidationFailed if image file specified doesn’t exist. |
Returns: | dictionary of image properties. It has three of them: ‘size’, ‘updated_at’ and ‘properties’. ‘updated_at’ attribute is a naive UTC datetime object. |
ironic.common.image_service.
HttpImageService
[source]¶Bases: ironic.common.image_service.BaseImageService
Provides retrieval of disk images using HTTP.
download
(image_href, image_file)[source]¶Downloads image to specified location.
Parameters: |
|
---|---|
Raises: | exception.ImageRefValidationFailed if GET request returned response code not equal to 200. |
Raises: | exception.ImageDownloadFailed if: * IOError happened during file write; * GET request failed. |
show
(image_href)[source]¶Get dictionary of image properties.
Parameters: | image_href – Image reference. |
---|---|
Raises: | exception.ImageRefValidationFailed if: * HEAD request failed; * HEAD request returned response code not equal to 200; * Content-Length header not found in response to HEAD request. |
Returns: | dictionary of image properties. It has three of them: ‘size’, ‘updated_at’ and ‘properties’. ‘updated_at’ attribute is a naive UTC datetime object. |
validate_href
(image_href, secret=False)[source]¶Validate HTTP image reference.
Parameters: |
|
---|---|
Raises: | exception.ImageRefValidationFailed if HEAD request failed or returned response code not equal to 200. |
Returns: | Response to HEAD request. |
ironic.common.image_service.
get_image_service
(image_href, client=None, context=None)[source]¶Get image service instance to download the image.
Parameters: |
|
---|---|
Raises: | exception.ImageRefValidationFailed if no image service can handle specified href. |
Returns: | Instance of an image service class that is able to download specified image. |
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.