Zudoku
Unikraft Cloud Platform API

Images

Endpoint

An image is a collection of objects representing a VM which can be deployed on Unikraft Cloud. Its format is based on the OCI Image Specification. Within the context of Unikraft Cloud, these images also include a kernel component.


Get Image by Digest

GET
https://api.fra.unikraft.cloud
/v1/images/digest/{digest}

Retrieve an image by its digest.

Get Image by Digestpath Parameters

  • digeststring · required
    Example: sha256:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef

Get Image by Digest Responses

default

  • statusstring · enum · enum

    The status of the response.

    Enum values:
    success
    error
  • messagestring

    An optional message providing additional information about the response.

    Example: No image with name 'my-image:latest'
  • dataobject

    The response data for this request.

  • errorsobject[]

    A list of errors which may have occurred during the request.

  • op_time_usinteger · uint64

    The operation time in microseconds. This is the time it took to process the request and generate the response.

    Example: 46

Get Image by Tag

GET
https://api.fra.unikraft.cloud
/v1/images/tag/{tag}

Retrieve an image by its tag.

Get Image by Tagpath Parameters

  • tagstring · required
    Example: my-image:latest

Get Image by Tag Responses

default

  • statusstring · enum · enum

    The status of the response.

    Enum values:
    success
    error
  • messagestring

    An optional message providing additional information about the response.

    Example: No image with name 'my-image:latest'
  • dataobject

    The response data for this request.

  • errorsobject[]

    A list of errors which may have occurred during the request.

  • op_time_usinteger · uint64

    The operation time in microseconds. This is the time it took to process the request and generate the response.

    Example: 46