Managing Image Lists

Machine images must be added to an image list to create a versioned instance template. When defining the launch plan for an orchestration to create an instance, an image list must be selected. You may also optionally select the version of the member machine image for launch. If no version is selected, then the default entry defined for the image list is launched. For example, you might want to set up an image list containing a selection of machine images of various Oracle Linux releases.

Topics:

add imagelist

This command enables you to add a new image list.

Note:

You can add only private image lists to the system. To make these image lists public, contact you Oracle Cloud Administrator.

Syntax

oracle-compute add imagelist name description [--default]

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
name	A unique hierarchical name for the image list. For example, /mytenant/public/myimagelist . Object names can contain only alphanumeric characters, hyphens, and periods. Object names are case-sensitive.
description	A description of this image list
--default	(Optional) The version of the image in the list that should be considered the default. The default is used on instance launch if a specific version has not been given.

Example

$ oracle-compute add imagelist /mytenant/admin/oel6 "new imagelist" --default=1

Sample Output

$ oracle-compute add imagelist  /mytenant/admin/oel6 "new imagelist" --default=1 -f json
{
 "list": [
  {
   "default": 1,
   "uri": "http://api.oc.example.com/imagelist/mytenant/admin/oel6",
   "description": "new imagelist",
   "name": "/mytenant/admin/oel6",
   "entries": []
  }
 ]
}

delete imagelist

This command enables you to delete an existing image list.

Note:

You can delete only private image lists that you have created.

Syntax

oracle-compute delete 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
Parameter	Description
name	A unique hierarchical name for the image list. For example, `/mytenant/public/myimagelist`.

Example

$ oracle-compute delete imagelist /mytenant/public/oel6

update imagelist

This command enables you to update an image list.

Note:

You can update only private image lists that you have created.

Syntax

oracle-compute update imagelist name [--description] [--default]

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
name	A unique hierarchical name for the image list. For example, `/mytenant/public/myimagelist`
--description	(Optional) A description of this image list
--default	(Optional) The default machine image when launching instances from this image list

Example

$ oracle-compute update imagelist /mytenant/public/ol66_40GB --description "Refreshed imagelist"

Sample Output

$  oracle-compute update imagelist /mytenant/public/ol66_40GB --description "Refreshed imagelist" -f json
{
 "list": [{ 
  "default": 2, 
  "description": "Refreshed imagelist", 
  "entries": [], 
  "uri": "https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB", 
  "name": "/mytenant/public/ol66_40GB" 
  }]

}

Retrieve Image List Details

You can retrieve image list details by using the CLI.

Topics:

discover imagelist

This command enables you to discover image lists in a specific container.

Syntax

oracle-compute discover imagelist container

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
container	Hierarchical name-space for the image list

Example

oracle-compute discover imagelist /oracle/public

Sample Output

$ oracle-compute discover imagelist /oracle/public
entry
/oracle/public/linux5_16.1.2_64  
/oracle/public/linux6_16.1.2_64  
/oracle/public/linux6_12.2.1.0.0_64_jaas_16.2.1.0.103

get imagelist

This command enables you to retrieve information for a specific image list.

Syntax

oracle-compute get 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
name	A unique hierarchical name for the image list. For example, `/mytenant/public/myimagelist`

Example

$ oracle-compute get imagelist /oracle/public/linux6_16.1.2_64

Sample Output

$ oracle-compute get imagelist /oracle/public/linux6_16.1.2_64 -F name,description,default
name                                 description                 default
/oracle/public/linux6_16.1.2_64      A default public image.     1
$

list imagelist

This command enables you to retrieve information for image lists in a container or subcontainers.

Syntax

oracle-compute list imagelist container

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
container	Hierarchical name-space for the image list.

Example

$ oracle-compute list imagelist /oracle/public

Sample Output

$ oracle-compute list imagelist /oracle/public -F name,description,default 
name                                                  description             default  
/oracle/public/linux5_16.1.2_64                       A default public image. 1  
/oracle/public/linux6_16.1.2_64                       A default public image. 1 
/oracle/public/linux6_12.2.1.0.0_64_jaas_16.2.1.0.103 JCS Image               1