Managing Image List Entries

An image list entry connects machine images to image lists. This section specifies the operations associated with managing image list entries.

add imagelistentry

This command enables you to add a machine image list to an image list entry.

Note:

You can add only private machine image list entries to the system. To make a public image list entry to the system, contact your Oracle Cloud Administrator.

Syntax

oracle-compute add imagelistentry imagelist name machineimages version [--attributes]

Parameters and Options

The following parameters are specific to this command. You can also use the common options described in General Command Options.

Parameter Description
imagelist name Unique hierarchical name for the imagelist entry. For example, /mytenant/public/myimagelistentry.

Object names can contain only alphanumeric characters, hyphens, and periods. Object names are case-sensitive.

machineimages List of machine images to be used for this image lists
version The version of the machine image in the specified image list
--attributes (Optional) Specified as a JSON object, user-defined parameters that can be passed to an instance of this machine image when it is launched

For more information on attributes, see section Orchestration Templates in Using Oracle Compute Cloud Service.

Example

$ oracle-compute add imagelistentry /mytenant/public/my-imagelist-1 /mytenant/public/snapshot-1 1

Sample Output

$ oracle-compute add imagelistentry /mytenant/public/my-imagelist-1 /mytenant/public/snapshot-1 1 -fjson 
{
 "list": [
  {
   "attributes": {}, 
   "imagelist": {
    "default": 1, 
    "description": null, 
    "entries": null, 
    "uri": "imagelist/mytenant/public/my-imagelist-1",
    "name": "/mytenant/public/my-imagelist-1"
   }, 
   "version": 1, 
   "machineimages": [
    "/mytenant/public/snapshot-1"
   ], 
   "uri": "http://api.oc.example.com/imagelist/mytenant/public/my-imagelist-1/entry/1"
  }
 ]
}

delete imagelistentry

This command enables you to delete a specific version of an image list entry.

Note:

You can delete only those image list entries that you have created.

Syntax

oracle-compute delete imagelistentry imagelist name version

Parameters and Options

The following parameters are specific to this command. You can also use the common options described in General Command Options.

Parameter Description
imagelist name Unique hierarchical name for the image list entry. For example, /mytenant/public/myimagelistentry.
version The version of the machine image in the specified image list

Example

$ oracle-compute delete imagelistentry /oracle/public/oel6 2 -f json

Retrieve Image List Entry Details

You can retrieve details of image list entry by using the CLI.

get imagelistentry

This command enables you to retrieve information for a specific version of an image list entry.

Syntax

oracle-compute get imagelistentry imagelist_name version

Parameters and Options

The following parameters are specific to this command. You can also use the common options described in General Command Options.

Parameter Description
imagelist_name Unique hierarchical name for the image list entry. For example, /mytenant/public/my-imagelist-1
version The version of this machine image in this image list

Example

$ oracle-compute get imagelistentry /oracle/public/linux6_16.1.2_64 1

Sample Output

$ oracle-compute get imagelistentry /oracle/public/linux6_16.1.2_64 1 -F machineimages,version 
machineimages                     version  
/oracle/public/linux6_16.1.2_64   1 

list imagelistentry

This command enables you to list information about image list entries for a specific image list. You must specify a container, which must be a specific image list.

Syntax

oracle-compute list imagelistentry imagelist_name

Parameters and Options

The following parameters are specific to this command. You can also use the common options described in General Command Options.

Parameter Description
imagelist_name Unique hierarchical name for the image list entry. For example, /mytenant/public/myimagelistentry

Example

oracle-compute list imagelistentry /oracle/public/linux6_16.1.2_64

Sample Output

$ oracle-compute list imagelistentry /oracle/public/linux6_16.1.2_64 -Fmachineimages,version,attributes

machineimages                    version    attributes
/oracle/public/linux6_16.1.2_64  1          {"connect2db": "true"}