image

Available methods

Description

Provides methods to access and modify images.

Namespace:

image

Method: delete

Description:

Delete an image

Parameters:

  • string sessionKey

  • int imageId

Returns:

  • int - 1 on success, exception thrown otherwise.

Method: getCustomValues

Description:

Get the custom data values defined for the image

Parameters:

  • string sessionKey

  • int imageId

Returns:

  • struct the map of custom labels to custom values

    • string "custom info label"

    • string "value"

Method: getDetails

Description:

Get details of an image

Parameters:

  • string sessionKey

  • int imageId

Returns:

  • * struct image overview information

    • int "id"

    • string "name" - image name

    • string "version" - image tag/version

    • int "revision" - image build revision number

    • string "arch" - image architecture

    • boolean "external" - true if the image is built externally, false otherwise

    • string "checksum"

    • string "profileLabel"

    • string "buildStatus" - One of:

      • queued

      • picked up

      • completed

      • failed

    • string "inspectStatus" - Available if the build is successful. One of:

      • queued

      • picked up

      • completed

      • failed

    • int "buildServerId"

    • int "securityErrata"

    • int "bugErrata"

    • int "enhancementErrata"

    • int "outdatedPackages"

    • int "installedPackages"

Method: getRelevantErrata

Description:

Returns a list of all errata that are relevant for the image

Parameters:

  • string sessionKey

  • int imageId

Returns:

  • array :

  • struct errata

    • int "id" - errata ID

    • string "issue_date" - the date erratum was updated (deprecated)

    • string "date" - the date erratum was created (deprecated)

    • string "update_date" - the date erratum was updated (deprecated)

    • string "advisory_synopsis" - summary of the erratum

    • string "advisory_type" - type label such as 'Security', 'Bug Fix'

    • string "advisory_status" - status label such as 'final', 'testing', 'retracted'

    • string "advisory_name" - name such as 'RHSA', etc.

Method: importImage

Description:

Import an image and schedule an inspect afterwards

Parameters:

  • string sessionKey

  • string name - image name as specified in the store

  • string version - version to import or empty

  • int buildHostId - system ID of the build host

  • string storeLabel

  • string activationKey - activation key to get the channel data from

  • dateTime.iso8601 earliestOccurrence - earliest the following inspect can run

Returns:

  • int the ID of the inspect action created

Method: listImages

Description:

List available images

Parameters:

  • string sessionKey

Returns:

  • array :

  • struct image information

    • int "id"

    • string "name" - image name

    • string "version" - image tag/version

    • int "revision" - image build revision number

    • string "arch" - image architecture

    • boolean "external" - true if the image is built externally, false otherwise

    • string "storeLabel"

    • string "checksum"

    • string "obsolete"

Method: listPackages

Description:

List the installed packages on the given image

Parameters:

  • string sessionKey

  • int imageId

Returns:

  • array :

    • struct package

      • string "name"

      • string "version"

      • string "release"

      • string "epoch"

      • string "arch"

Method: scheduleImageBuild

Description:

Schedule an image build

Parameters:

  • string sessionKey

  • string profileLabel

  • string version - version to build or empty

  • int buildHostId - system id of the build host

  • dateTime.iso8601 earliestOccurrence - earliest the build can run.

Returns:

  • int the ID of the build action created