Disk Image Commands

image delete

Delete an image.

image delete [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

image detail

Get details for an image.

image detail [OPTIONS] IDENTIFIER

Arguments

IDENTIFIER

Required argument

image edit

Edit details of an image.

image edit [OPTIONS] IDENTIFIER

Options

--name <name>

Name of the image

--note <note>

Additional note for the image

--tag <tag>

Tags for the image

Arguments

IDENTIFIER

Required argument

image list

List images.

image list [OPTIONS]

Options

--name <name>

Filter on image name

--public, --private

Display only public or private images

-l, --limit <limit>

How many results to get in one api call

Default:

100

image import

Import an image.

The URI for an object storage object (.vhd/.iso file) of the format: swift://<objectStorageAccount>@<cluster>/<container>/<objectPath> or cos://<regionName>/<bucketName>/<objectPath> if using IBM Cloud Object Storage

image import [OPTIONS] NAME URI

Options

--note <note>

The note to be applied to the imported template

--os-code <os_code>

The referenceCode of the operating system software description for the imported VHD, ISO, or RAW image

--ibm-api-key <ibm_api_key>

The IBM Cloud API Key with access to IBM Cloud Object Storage instance and IBM KeyProtect instance. For help creating this key see https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-iam-overview#iam-overview-service-id-api-key

--root-key-crn <root_key_crn>

CRN of the root key in your KMS instance

--wrapped-dek <wrapped_dek>

Wrapped Data Encryption Key provided by IBM KeyProtect. For more info see https://cloud.ibm.com/docs/key-protect?topic=key-protect-wrap-keys

--cloud-init

Specifies if image is cloud-init

--byol

Specifies if image is bring your own license

--is-encrypted

Specifies if image is encrypted

Arguments

NAME

Required argument

URI

Required argument

image export

Export an image to object storage.

The URI for an object storage object (.vhd/.iso file) of the format: swift://<objectStorageAccount>@<cluster>/<container>/<objectPath> or cos://<regionName>/<bucketName>/<objectPath> if using IBM Cloud Object Storage

image export [OPTIONS] IDENTIFIER URI

Options

--ibm-api-key <ibm_api_key>

The IBM Cloud API Key with access to IBM Cloud Object Storage instance. For help creating this key see https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-iam-overview#iam-overview-service-id-api-key

Arguments

IDENTIFIER

Required argument

URI

Required argument

image datacenter

Add/Remove datacenter of an image.

image datacenter [OPTIONS] IDENTIFIER LOCATIONS...

Options

--add, --remove

To add or remove Datacenter

Arguments

IDENTIFIER

Required argument

LOCATIONS

Required argument(s)

image share

Share an image template with another account.

image share [OPTIONS] IDENTIFIER

Options

--account-id <account_id>

Required Account Id for another account to share image template

Arguments

IDENTIFIER

Required argument

image share-deny

Deny share an image template with another account.

image share-deny [OPTIONS] IDENTIFIER

Options

--account-id <account_id>

Required Account Id for another account to deny share image template

Arguments

IDENTIFIER

Required argument