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.

Topics:

Add Image List Entry

This API enables you to add an image list entry.

Note:

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

Method

POST

REST Resource

/imagelist/name/entry/

URI

https://api_endpoint/imagelist/name/entry/

URI Parameter

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

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

Request Body Parameters

Parameter Description
machineimages

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

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

Example URI

https://api.oc.example.com/imagelist/mytenant/public/ol/entry/

Example Request Body

{
  "attributes": {"type": "Oracle Linux 6.6"}, 
  "version": 2, 
  "machineimages": ["/mytenant/public/ol66_40GB"], 
}

Example Response Body

{
 "list": [
  {
   "attributes": {"type": "Oracle Linux 6.6"},
   "imagelist": {
    "default": 1,
    "description": null,
    "entries": null,
    "uri": "imagelist/mytenant/public/ol66_40GB",
    "name": "/mytenant/public/ol66_40GB"
   },
   "version": 2,
   "machineimages": ["/mytenant/public/ol66_40GB"],
   "uri": "https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB/entry/2"
  }
 ]
}

Delete Image List Entry

This API enables you to delete an image list entry.

Note:

You can delete only those image list entries created in your tenancy.

Method

DELETE

REST Resource

/imagelist/name/entry/version

URI

https://api_endpoint/imagelist/name/entry/version

URI Parameters

Parameter Description
name A 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 URI

https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB/entry/1

Retrieve Image List Entry Details

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

Topics:

Get Image List Entry

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

Method

GET

REST Resource

/imagelist/name

URI

https://api_endpoint/imagelist/name?version=versionValue

URI Parameters

Parameter Description
name A unique hierarchical name for the image list entry. For example, /mytenant/public/my-imagelist-1
version=versionValue (Optional) The version of the machine image in the image list.

Example URI

https://api.oc.example.com/imagelist/oracle/public/linux6_16.1.2_64

Example Response Body

{
 "default": 1,
 "description": "A default public image.",
 "entries": [
             {
              "attributes": {},
              "version": 1,
              "machineimages": ["/oracle/public/linux6_16.1.2_64"],
              "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64/entry/1"
             }
            ],
 "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64 ",
 "name": "/oracle/public/linux6_16.1.2_64"
}

List Image List Entries

This API enables you to list details of image list entries.

Method

GET

REST Resource

/imagelist/name

URI

https://api_endpoint/imagelist/name

URI Parameter

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

Example URI

https://api.oc.example.com/imagelist/oracle/public/linux6_16.1.2_64

Example Response Body

{
        default": 1, 
        "description": "A default public image.", 
        "entries": 
                [{
                                "attributes": {}, 
                                "version": 1, 
                                "machineimages": ["/oracle/public/linux6_16.1.2_64"], 
                                "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64/entry/1"
                }], 
        "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64", 
        "name": "/oracle/public/linux6_16.1.2_64"
}