This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Compute Images

1 - pcloud compute images

Image management commands

Synopsis

Image management commands.

Before you can create your first VM on your Power cloud instance, you must have a VM image in your cloud instance catalog. IBM provides a few stock images. These stock images are ideal for creating your first VM. The service also supports options to bring your own images.

To view available stock images, run the “pcloud compute images list –available” command.

Possibility to create, list, describe, import, export, delete Image(s).

pcloud compute images [flags]

Options

  -h, --help   help for images

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

2 - pcloud compute images create

Create an Image

Synopsis

Create an Image for a Cloud Instance from available Images. Note that ImageID can be used as parameter instead of ImageName.

pcloud compute images create <ImageName> [flags]

Options

  -h, --help   help for create

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

3 - pcloud compute images delete

Delete Images

Synopsis

Delete Images from a Cloud. Several Images can be deleted at the same time. Note that ImageID can be used as parameter instead of ImageName.

pcloud compute images delete <ImageName> [<ImageName> ...] [flags]

Options

  -h, --help    help for delete
  -q, --quiet   Quiet deletion (no confirmation is required)

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

4 - pcloud compute images describe

Describe Image

Synopsis

Describe with details, either one Image available for all Clouds, or one Image of a particular Cloud. Note that ImageID can be used as parameter instead of ImageName. Output format depends on –format option.

pcloud compute images describe <ImageName> [flags]

Options

  -h, --help   help for describe

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

5 - pcloud compute images export

Export a deployable Image

Synopsis

Export a deployable Image. Note that ImageID can be used as parameter instead of ImageName.

pcloud compute images export <ImageName> --bucketname <Bucket> --accesskey <AccessKey> --secretkey <SecretKey> [flags]

Options

  -a, --accesskey string    Cloud Storage Access Key (required)
  -b, --bucketname string   Cloud Storage Bucket (bucket name plus optional folders): bucket-name[/folder/../..] (required)
  -h, --help                help for export
  -s, --secretkey string    Cloud Storage Secret Key (required)

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

6 - pcloud compute images import

Import a new Image for a Cloud Instance

Synopsis

Import a new Image for a Cloud Instance.

pcloud compute images import <ImageName> --bucketname <Bucket> --filename <ImageFileName> --accesskey <AccessKey> --secretkey <SecretKey> [flags]

Options

  -a, --accesskey string     Cloud Storage Access Key (required)
  -b, --bucketname string    Cloud Storage Bucket (bucket name plus optional folders): bucket-name[/folder/../] (required)
  -f, --filename string      Cloud Storage Image File Name, should end with .ova, .ova.gz, .tar, .tar.gz or .tgz (required)
  -h, --help                 help for import
  -s, --secretkey string     Cloud Storage Secret Key (required)
  -T, --storagetype string   Storage type for imported image (default value set).
                             Storage type depends on the region of your cloud and can only be set from a short list of available values.
                             You can list the available storage types and the default storage type for your cloud by running the "running the "pcloud compute clouds describe <cloudID>" command.
  -k, --taskID               Display the taskID of the command to follow the progression

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO

7 - pcloud compute images list

List Images

Synopsis

List Images in the Cloud Instance. With –available, list available Images in the Power Cloud Public Repository. Images details are displayed with –long option. Images can be filtered out with –filter option. Output format depends on –format option.

pcloud compute images list [flags]

Options

  -a, --available       List available images to copy into Cloud Instance
  -f, --filter string   Set search filter.
                        Filters can be any boolean expression built on Image attributes from this list:
                        "CreationDate ImageID LastUpdateDate Name Servers Size State StoragePool StorageType Volumes Architecture ContainerFormat DiskFormat Endianness ImageType OperatingSystem"
  -h, --help            help for list
  -l, --long            Print detailed info of each Image

Options inherited from parent commands

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -D, --log.dir string     Override Log file directory
  -L, --log.file string    Override Log file name
  -V, --verbosity string   Override Log verbosity

SEE ALSO