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

Return to the regular view of this page.

IP4G CLI (pcloud)

The pcloud command line tool allows you to create and manage the lifecycle of VMs on your IBM Power for Google Cloud instance. You can use the pcloud command line tool to manage related resources such as VM images and data volumes. The pcloud command line tool is a stand alone executable file that is available for use on Mac, Windows, and Linux operating systems. You can obtain the latest pcloud binaries from the cli download site.

1 - Authentication in the CLI

Before you can start using the pcloud tool, you must have an available Power Cloud instance that is provisioned and attached to a selected GCP project within your organization. This process occurs when you subscribe to the offering in the GCP Marketplace. Next, run the pcloud auth login command to authenticate to your cloud instance. When you authenticate, you must use the registered Google identity that is associated with the organization and the billing account that is used in the subscription. Running the pcloud auth login command provides you with a unique code to register your pcloud instance. In the following example, XXXX-YYYY represents the unique code.

pcloud auth login
To authorize pcloud you will need to complete following steps (within 30 minutes):
  1. Navigate to: https://www.google.com/device
  2. Enter the code: XXXX-YYYY
  3. Select your Google ID that was registered with IBM Power Systems for Google Cloud


Once these steps have been completed the login command will complete within 5 seconds

When you go to https://www.google.com/device, you must enter the code in the dialog box. Next, a popup is displayed and you select the appropriate identity. After you complete this process, pcloud is now enabled to operate against the Power Systems Cloud instance that is associated with your Google identity. To verify that pcloud is enabled, run the pcloud config list, pcloud compute clouds list, and pcloud compute clouds describe commands. The following example displays the correct sequence of running these commands.

# pcloud config list
accountID: test
cloudID: 7f16fae4f3f54d8bb62f75645db56905
cloudName: test-us-east4
region: us-east4

# pcloud compute clouds list
CloudID                           Name              Region       Current
7f16fae4f3f54d8bb62f75645db56905  test-us-east4     us-east4     true
7f8e1c3032484fa390d7e87d329afdb1  test-us-central1  us-central1  false

# pcloud compute clouds describe test-us-east4
cloudID: 7f16fae4f3f54d8bb62f75645db56905
name: test-us-east4
accountID: test
ibmCustomerNumber: "1234"
region: us-east4
storageTypes: ssd, standard
defaultStorageType: standard
usage:
  memory: 152
  cores: 21.5
  storage: 3.378
  instances: 7
limits:
  memory: 640
  cores: 70
  storage: 50
  instances: 40
  peeringNetworks: 1
  peeringBandwidth: 1000
limitsPerVM:
  memory: 400
  cores: 15

2 - CLI Documentation

You can use the –help option with all subcommands to get additional information and available options for each of the operations. You can run the pcloud docs command to generate an up-to-date collection of documentation in markdown formatted (.md) files.

By default, the markdown files are placed in a newly created pcloud-doc directory.

You can use the -d option with pcloud docs to specify an alternate directory that will be created.

If pcloud-doc or the alternate directory already exists, it must be renamed or removed before running pcloud docs.

To view the markdown files, you can use a browser plug-in or other available tools. For example, you can use the Markdown Viewer plug-in for the Chrome browser.

The pcloud_main.md file is the top level document with links to specific topics.

3 - Adding Images to the Image Catalog

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 -a command. The following example displays the output from running this command:

pcloud compute images list -a
ImageID                               Name
9f72fc9b-a8b9-4d50-ad2d-65564a80b6d8  7100-05-04
0d50200b-c1b7-41fc-a858-7d3627714384  7200-03-03

The previous command without the -a flag can be used to list the images that are currently in your image catalog.

pcloud compute images list
ImageID                               Name
a232f02c-f041-480a-8b5a-87058710e2b3  7200-03-03

To copy a stock image into your cloud catalog, run the pcloud compute images create command. The following example uses the AIX 7100-05-04 stock image.

pcloud compute images create 9f72fc9b-a8b9-4d50-ad2d-65564a80b6d8

Now that you created the 7100-05-04 image, it is part of the cloud instance catalog and can be used to deploy VMs.

4 - Adding Networks in the CLI

The pcloud command line interface provides functionality to add a network interface to a virtual machine.

The command to add the additional network interface is as follows:

pcloud compute instances attach-network <InstanceName> --network <NetworkName[:IPAddress]> [flags]

Flags

FlagDescription
h, –helpHelp for attach-network
-n, –network stringNetwork to attach to the VM Instance value must follow the <NetworkName[:IPAddress]> form.
Note that “NetworkID” can be provided instead of “NetworkName”, “IPAddress” is optional.
Required.
Global FlagsDescription
-F, –format stringAvailable formats: “table”, “yaml”, “json”, “csv”. Default is command specific. Can be used with describe and list subcommands.
-D, –log dir stringOverride Log file Directory
-L, –log file stringOverride Log File Name
-V, –verbosity stringOverride Log Verbosity

After a new interface has been created, the IP address will not automatically be assigned to the interface in the OS. Use the standard procedure for the operating system running in the VM to assign the IP address to the interface and bring it up.

5 - VM Creation Using the CLI

After you have an image and network, you can create a VM by running the pcloud compute instances create command. The following is an example of the output from using the -h flag for this command:

# pcloud compute instances create -h
Create a VM Instance in IBM Power Cloud.

 Most of the flags have default values, but you must enter the VM name to be created, and mandatory image and network names.
 You can list the images of your Cloud by running the "pcloud compute images list" command.
 You can list the available networks by running the "pcloud compute networks list" command.

 Creating a new VM instance can take a few minutes to fully complete. You can look at the state
 of the VM by using the "pcloud compute instances describe" subcommand.

Usage:
  pcloud compute instances create <InstanceName> --image <ImageName> --network <NetworkName[:IPAddress]> [flags]

Flags:
  -a, --affinityPolicy string   Affinity policy for replicants being created (must be one of {"affinity", "anti-affinity", "none"}) (default "none")
  -c, --cores float             Number of cores to allocate to the VM Instance (default 2)
  -h, --help                    help for create
  -i, --image string            Image to allocate to the VM Instance (note that 'ImageID' or 'ImageName' can be used) (required)
  -k, --keypair string          SSHKeyPair Name
  -m, --memory float            Memory size (in GB) to allocate to the VM Instance (default 4)
  -s, --namingScheme string     Replicants naming scheme (must be one of {"prefix", "suffix"}) (default "suffix")
  -n, --network strings         Networks to assign to the VM Instance, (values must follow the <NetworkName[:IPAddress]> form, note that 'NetworkID' can be provided instead of 'NetworkName', 'IPAddress' is optional, several --network allowed) (required)
  -P, --pinPolicy string        VM pinning policy (must be one of {"none", "soft", "hard"}) (default "none")
  -t, --proctype string         Dedicated, Shared or Capped Processing Type (must be one of {"dedicated", "shared", "capped"}) (default "dedicated")
  -r, --replicants float        Number of replicants (default 1)
  -T, --storagetype string      Storage type for VMInstance deployment (required only if image is a "stock" 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 "pcloud compute clouds describe" command.
  -u, --userdata string         Cloud-init user defined data file (optional, if necessary data are uuencoded before being sent)
  -v, --volume strings          Volumes to assign to the VM Instance (several --volume allowed, note that 'VolumeID' or 'VolumeName' can be used)

Global Flags:
  -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

Some of the flags have default values, but you must enter several parameters. For example, you must enter the VM image name and the network ID.

You can list the available networks by running the pcloud compute networks list command. A cloud instance has at least one network that was created when it was initially provisioned. This network is what connects the cloud instance and its VMs to GCP.

If you run the command in the following example, you create a new AIX 7.2 VM with two entitled shared cores of compute and 8 GB of RAM.

pcloud compute instances create mytestvm -i 7200-03-03 -m 8 -c 2 -t shared -n gcp-network

Creating a new VM instance can take a few minutes to fully complete. You can look at the state of the VM by using the describe subcommand. In the following example, the VM is still booting up and initializing.

# pcloud compute instances describe test-vm10
instanceID: 4f99e4c5-b8e4-4751-80a8-dd02ccbb00d0
name: test-vm10
cloudID: 7f16fae4f3f54d8bb62f75645db56905
systemType: s922
cores: 2
procType: shared
memory: 24
pinPolicy: none
status: ACTIVE
health:
  status: OK
  lastUpdate: 2021-04-22T17:23:12.354988
  reason: '-'
fault:
  code: 0
  created: '-'
  details: '-'
  message: '-'
imageID: 91e656a6-a9a1-4a99-abb9-7bcb366c3546
networks:
- ipAddress: 192.168.0.17
  macAddress: fa:b8:ef:cf:4b:20
  networkName: gcp-network
  networkID: 8e72b5cc-9e50-4b06-bc56-eb4e1781eefe
volumes:
- name: test-vm10-4f99e4c5-00000ad1-boot-0
  ID: bc141301-85a2-461e-8c68-1f0bc67a35c4
  storageType: standard
  size: 20
  shareable: false
  bootable: true
  bootVolume: true
creationDate: "2021-04-22T17:09:37.000Z"
updateDate: "2021-04-22T17:09:37.000Z"
progress: 0

To initially access the new VM, you can use the console subcommand. This subcommand generates a url that can be used in your web browser to access the console of the VM. A recommended first task is to create a password for root using the passwd command so that ssh as root can be used with the VM.

pcloud compute instances console mytestvm


console: https://pforg.converge.cloud/console/index.html?token=<token>

Here is a screen capture of the console:

6 - Working with Data Volumes in the CLI

Volume Types

In IP4G there are two volume types. Those volumes are defined by a name (HDD or SDD) and correspond to the following Characteristics:

RegionDescription
US EastSDD and HDD are different hardware types. Performance is dictacted by the corresponding hardware.
All other RegionsSSD and HDD are both IBM Flash Storage, with a QoS limit of 10 iops/GB for SSD, and 3 iops/GB for HDD.

You can see an individual volumes iops limit using

pcloud compute volumes describe <volume name>

Working with additional data volumes

You can create more data volumes to hold application data or support multi-disk use cases with your VMs by using the compute volumes subcommand. The following are examples of using the compute volumes subcommand

To list out existing volumes:

pcloud compute volumes list
VolumeID                              Name                                    Size  StorageType    State      Shareable  Bootable
696226c7-0a97-4917-a220-9bcbe828dab8  mytestvm-7f11d296-000006ac-boot-0       20    standard       in-use     false      true
e2c688bb-962d-413c-ba14-804e9fbb6042  instanceTestN-ef7c9d9d-00000697-boot-0  32    standard       in-use     false      true

To create a new 10 GB SSD volume and display it in the list of volumes:

pcloud compute volumes create my-test-volume -s 10 -t ssd
Volume "my-test-volume" created with ID: 4cd31e0e-eea1-4d3d-8b15-90a272b27bc0


pcloud compute volumes list
VolumeID                              Name                                    Size  StorageType    State      Shareable  Bootable
4cd31e0e-eea1-4d3d-8b15-90a272b27bc0  my-test-volume                          10    ssd            available  false      false
696226c7-0a97-4917-a220-9bcbe828dab8  mytestvm-7f11d296-000006ac-boot-0       20    standard       in-use     false      true
e2c688bb-962d-413c-ba14-804e9fbb6042  instanceTestN-ef7c9d9d-00000697-boot-0  32    standard       in-use     false      true

To show the details of a volume:

# pcloud compute volumes describe test-vm10-4f99e4c5-00000ad1-boot-0
volumeID: bc141301-85a2-461e-8c68-1f0bc67a35c4
name: test-vm10-4f99e4c5-00000ad1-boot-0
cloudID: 7f16fae4f3f54d8bb62f75645db56905
storageType: standard
size: 20
shareable: false
bootable: true
state: in-use
instanceIDs:
- 4f99e4c5-b8e4-4751-80a8-dd02ccbb00d0
creationDate: "2021-04-22T17:09:44.000Z"
updateDate: "2021-04-22T17:10:06.000Z"

The following example shows how to attach the new volume to an existing VM. In the following example, the new my-test-volume is now attached the VM.

pcloud compute instances attach-volume mytestvm -v my-test-volume
"rcb-test-volume" Volume being attached to "mytestvm" VM Instance (complete attach is not immediate)

7 - pcloud Reference

The pcloud command line tool can auto-create its documentation by running pcloud docs. The documentation is included here for reference. You can obtain the latest pcloud binaries from the cli download site.

7.1 - pcloud

CLI for IBM® Power Systems™ for GCP

Synopsis

CLI for IBM® Power Systems™ for Google Cloud Platform.

The pcloud command line tool allows you to create and manage the lifecycle of VMs on your IBM Power Systems for Google Cloud instance.

You can use the pcloud command line tool to manage related resources such as VM images and data volumes.

The pcloud command line tool is a stand alone executable file that is available for use on Mac, Windows, and Linux operating systems.

You can use the –help option with all subcommands to get additional information and available options for each of the operations.

You can run the “pcloud docs” command to generate an up-to-date directory of documentation topics that are markdown (.md) files.

pcloud [flags]

Options

  -F, --format string      Available formats: 'table', 'yaml', 'json', 'csv'.
                            Default is command specific.
                            Can be used with describe and list subcommands.
  -h, --help               help for pcloud
  -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.2 - pcloud completion

pcloud completion

Generate completion script

Synopsis

To load command line completions for your shell, fine your shell in the list below and follow the process outlined.

Bash

To load completions for your current session, run:

$ source <(pcloud completion bash)

To load completions for each session going forward, execute once:

On Linux:
$ pcloud completion bash > /etc/bash_completion.d/pcloud
On MacOS:
$ pcloud completion bash > /usr/local/etc/bash_completion.d/pcloud

ZSH

If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:

$ echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions for each session going forward, execute once:

$ pcloud completion zsh > "${fpath[1]}/_pcloud"

You will need to start a new shell for this setup to take effect.

Fish

To load completions for your current session, run:

$ pcloud completion fish | source

To load completions for each session going forward, execute once:

$ pcloud completion fish > ~/.config/fish/completions/pcloud.fish

You will need to start a new shell for this setup to take effect.

pcloud completion [bash|zsh|fish|powershell]

Options

  -h, --help   help for completion

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

  • pcloud - CLI for IBM® Power Systems™ for GCP

7.3 - pcloud compute

pcloud compute

Synopsis

pcloud compute CLI gives access to “clouds”, “images”, “instances”, “networks”, “sshkeys”, “volumes” subcommands

pcloud compute [flags]

Options

  -h, --help   help for compute

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.4 - pcloud docs

Generate documentation for pcloud

Synopsis

Generate documentation for pcloud command (Markdown format), from the current directory into “pcloud-doc” default directory. Output documentation directory can be set with –dir option

pcloud docs [flags]

Options

  -d, --dir string   Directory for pcloud documentation
  -h, --help         help for docs

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

  • pcloud - CLI for IBM® Power Systems™ for GCP

7.5 - pcloud version

Get current server and pcloud version

Synopsis

Get current server and pcloud version.

pcloud version [flags]

Options

  -h, --help   help for version

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

  • pcloud - CLI for IBM® Power Systems™ for GCP

7.6 - Auth

7.6.1 - pcloud auth

Authorization for pcloud

Synopsis

Commands to authorize pcloud.

Possibility to login, print-access-token, print-identity-token, revoke.

Before you can start using the pcloud tool, you must have an available Power Cloud instance that is provisioned and attached to a selected GCP project within your organization. This process occurs when you subscribe to the offering in the GCP Marketplace. Next, run the “pcloud auth login” command to authenticate to your cloud instance. When you authenticate, you must use the registered Google identity that is associated with the organization and the billing account that is used in the subscription. Running the “pcloud auth login” command provides ou with a unique code to register your pcloud instance.

pcloud auth [flags]

Options

  -h, --help   help for auth

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.6.2 - pcloud auth login

Login for pcloud

Synopsis

Login for pcloud. To prompt the user to login to pcloud with instructions.

pcloud auth login [flags]

Options

  -h, --help   help for login

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.6.3 - pcloud auth print-access-token

Print access token

Synopsis

Print access token characteristics.

pcloud auth print-access-token [flags]

Options

  -b, --bare   print bare access token only
  -h, --help   help for print-access-token

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.6.4 - pcloud auth print-identity-token

Print identity token

Synopsis

Print identity token characteristics.

pcloud auth print-identity-token [flags]

Options

  -h, --help   help for print-identity-token

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.6.5 - pcloud auth revoke

Revoke credentials for pcloud

Synopsis

Revoke credentials for pcloud: effectively logout.

pcloud auth revoke [flags]

Options

  -h, --help   help for revoke

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.6.6 - pcloud auth sa

System Account Commands

Synopsis

System Account Commands

pcloud auth sa [flags]

Options

  -h, --help   help for sa

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.6.7 - pcloud auth sa create

add a system account user

Synopsis

add a system account user

pcloud auth sa create <sa-name> <sa-client-id> [--tenant=<tenant-id>] [--cloud=<cloud-id>] [flags]

Options

  -c, --cloud stringArray    Cloud ID
  -h, --help                 help for create
  -t, --tenant stringArray   Tenant ID

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.6.8 - pcloud auth sa delete

description

Synopsis

description

pcloud auth sa delete <sa-client-id> [flags]

Options

  -h, --help   help for delete

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.6.9 - pcloud auth sa describe

description

Synopsis

description

pcloud auth sa describe <sa-client-id> [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

7.6.10 - pcloud auth sa list

description

Synopsis

description

pcloud auth sa list usage [flags]

Options

  -h, --help   help for list

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.6.11 - pcloud auth sa load

create a service account from json keyfile

Synopsis

create a service account from json keyfile

pcloud auth sa load <key.json> [flags]

Options

  -h, --help   help for load

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.6.12 - pcloud auth sa update

update an existing sa account

Synopsis

update an existing sa account

pcloud auth sa update <sa-client-id> [-name=<name>] [-tenant=<tenant-id>] [-cloud=<cloud-id>] [flags]

Options

  -c, --cloud stringArray    Cloud ID
  -h, --help                 help for update
  -n, --name string          SA Account Name
  -t, --tenant stringArray   Tenant ID

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.7 - Config

7.7.1 - pcloud config

Configuration for pcloud

Synopsis

Commands configuration to manage pcloud config. Possibility to set, list properties.

pcloud config [flags]

Options

  -h, --help   help for config

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.7.2 - pcloud config list

List Cloud properties

Synopsis

List Cloud properties: AccountID, CloudID

pcloud config list [flags]

Options

  -h, --help   help for list

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.7.3 - pcloud config set

Set pcloud configurations

Synopsis

Set Configuration Parameters

Options

  -h, --help   help for set

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.7.4 - pcloud config set account

Set Account

Synopsis

Set Account property

pcloud config set account <AccountID> [flags]

Options

  -h, --help   help for account

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.7.5 - pcloud config set cloud

Set Cloud

Synopsis

Set Cloud property

pcloud config set cloud <CloudID> [flags]

Options

  -h, --help   help for cloud

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.8 - Tasks

7.8.1 - pcloud tasks

Get task details. Possibility to list, describe task(s)

Synopsis

Get task details. Possibility to list, describe task(s). Tasks are used to obtain progress details of long running operations. TaskIDs are returned when launching long operations like: ‘image import’, ‘capture pvm-instance’.

pcloud tasks [flags]

Options

  -h, --help   help for tasks

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.8.2 - pcloud tasks describe

Describe Task

Synopsis

Describe Task with details. Output format depends on –format option.

pcloud tasks describe <TaskID> [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

  • pcloud tasks - Get task details. Possibility to list, describe task(s)

7.8.3 - pcloud tasks list

List Tasks from log files generated locally

Synopsis

List Tasks from log files generated locally. Output format depends on –format option.

pcloud tasks list [flags]

Options

  -h, --help   help for list

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

  • pcloud tasks - Get task details. Possibility to list, describe task(s)

7.9 - Compute Clouds

7.9.1 - pcloud compute clouds

Cloud commands

Synopsis

Commands to manage Cloud Instance(s). Possibility to list, describe Cloud Instance(s)

pcloud compute clouds [flags]

Options

  -h, --help   help for clouds

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.9.2 - pcloud compute clouds describe

Describe Cloud Instance

Synopsis

Describe Cloud Instance with details. Output format depends on –format option.

pcloud compute clouds describe <cloudID> [flags]

Options

  -h, --help            help for describe
  -r, --report string   Specify the extent of the output.
                        Options are brief (default), full, limits, instances, capabilities, or usage. (default "brief")

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.9.3 - pcloud compute clouds list

List Clouds

Synopsis

List Clouds. Clouds details are displayed with –long option. Output format depends on –format option.

pcloud compute clouds list [flags]

Options

  -h, --help   help for list
  -l, --long   Print detailed info of each Cloud

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.9.4 - pcloud compute clouds syspools

List System Pools

Synopsis

List System Pools

pcloud compute clouds syspools [flags]

Options

  -h, --help   help for syspools

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.10 - Compute Events

7.10.1 - pcloud compute events

Event management commands

Synopsis

Event management commands. Possibility to list or describe Event(s).

pcloud compute events [flags]

Options

  -h, --help   help for events

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.10.2 - pcloud compute events describe

Describe Event

Synopsis

Describe Event with details. Output format depends on –format option.

pcloud compute events describe <EventId> [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

7.10.3 - pcloud compute events list

List Events

Synopsis

List Events since one date, to another date, in the Cloud Instance. Events details are displayed with –long option. Events can be filtered out with –filter option. Output format depends on –format option.

Dates can be in any of the following formats, note the use of quotes around formats with spaces:

2024-05-20 “2024-05-20 13:00” 1716163200 2024-05-19T19:00:00-05:00

pcloud compute events list --since <Time> --to <Time>  [flags]

Options

  -f, --filter string   Set search filter.
                        Filters can be any boolean expression built on Event attributes from this list:
                        "Action EventID Level Message Resource Time Timestamp Email Name UserID"
  -h, --help            help for list
  -l, --long            Print detailed info of each Event
  -s, --since string    Timestamp since which events must be displayed 
  -t, --to string       Timestamp to which events must be displayed

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.11 - Compute Images

7.11.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

7.11.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

7.11.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

7.11.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

7.11.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

7.11.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.11.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

7.12 - Compute Instances

7.12.1 - pcloud compute instances

VM Instances management commands

Synopsis

VM Instances management commands. Possibility to create, list, describe, update, delete a VM Instance. Possibility to attach, detach a Volume to/from a VM Instance. Possibility to attach, detach a Network to/from a VM Instance. Possibility to start, stop, reboot, shutdown, reset VM Instance(s). Possibility to capture a VM Instance.

pcloud compute instances [flags]

Options

  -h, --help   help for instances

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.12.2 - pcloud compute instances attach-network

Attach a Network to a VM Instance

Synopsis

Attach a Network to a VM Instance in IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances attach-network <InstanceName> --network <NetworkName[:IPAddress]> [flags]

Options

  -h, --help             help for attach-network
  -n, --network string   Network to attach to the VM Instance (value must follow the <NetworkName[:IPAddress]> form, note that 'NetworkID' can be provided instead of 'NetworkName', 'IPAddress' is optional) (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

7.12.3 - pcloud compute instances attach-volume

Attach volumes to a VM Instance

Synopsis

Attach volumes to a VM Instance in IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances attach-volume <InstanceName> --volume <VolumeID> (several --volume allowed) [flags]

Options

  -h, --help             help for attach-volume
  -v, --volume strings   Volume to attach to the VM Instance (note that 'VolumeName' or 'VolumeID' can be used. Several --volume allowed) (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

7.12.4 - pcloud compute instances capture

Capture a VM Instance and create a deployable Image

Synopsis

Capture a VM Instance and create a deployable Image. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances capture <InstanceName> --destination image-catalog --name <ImageName>
  pcloud compute instances capture <InstanceName> --destination [cloud-storage|both] --name <ImageName> --bucketname <Bucket> --accesskey <AccessKey> --secretkey <SecretKey> [flags]

Options

  -a, --accesskey string     Cloud Storage Access Key
  -b, --bucketname string    Cloud Storage Bucket (bucket name plus optional folders): bucket-name[/folder/../..]
  -d, --destination string   Destination for the Deployable Image (must be one of {'image-catalog', 'cloud-storage', 'both'}) (required)
  -h, --help                 help for capture
  -n, --name string          Name for the Deployable Image created from the Captured Instance (required)
  -s, --secretkey string     Cloud Storage Secret Key
  -k, --taskID               Display the taskID of the command to follow the progression
  -v, --volume strings       Data volumes you want to include in the capture (several --volume allowed, note that 'VolumeID' or 'VolumeName' can be used, optional).

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.12.5 - pcloud compute instances clone

Clone a VM Instance

Synopsis

Clone a VM Instance

pcloud compute instances clone <InstanceID> <CloneName> [options] [flags]

Options

  -c, --cores float       Number of cores to allocate to the VM Instance (default 2)
  -h, --help              help for clone
  -k, --keypair string    SSHKeyPair Name
  -l, --license strings   Software Licenses (several --license allowed, must be one of "IbmiCSS", "IbmiDBQ", "IbmiPHA", "IbmiRDS")
  -m, --memory float      Memory size (in GB) to allocate to the VM Instance (default 4)
  -n, --network strings   Networks to assign to the VM Instance, (values must follow the <NetworkName[:IPAddress]> form, note that 'NetworkID' can be provided instead of 'NetworkName', 'IPAddress' is optional, several --network allowed) (required)
  -t, --proctype string   Dedicated, Shared or Capped Processing Type (must be one of {"dedicated", "shared", "capped"}) (default "dedicated")
  -d, --rdsUsers int      Number of IbmiRDS license users (Required if "IbmiRDS" license is specified)
  -v, --volume strings    Volumes to assign to the VM Instance (several --volume allowed, note that 'VolumeID' or 'VolumeName' can be used)

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.12.6 - pcloud compute instances console

Get Console URL of VM Instance

Synopsis

Get Console URL of VM Instance in IBM Power Cloud.

To initially access a VM Instance, you can use the “pcloud compute instances console ” subcommand. This subcommand generates a url that can be used in your web browser to access the console of the VM.

Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances console <InstanceName> [flags]

Options

  -h, --help   help for console

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.12.7 - pcloud compute instances create

Create a VM Instance

Synopsis

Create a VM Instance

Most of the flags have default values, but you must enter the VM name to be created, and mandatory image and network names.

You can list the images of your Cloud by running:

pcloud compute images list

You can list the available networks by running

pcloud compute  networks list

You can list the system types available to your cloud by running

pcloud compute clouds syspools

Creating a new VM instance can take a few minutes to fully complete. You can look at the state of the VM by running

 pcloud compute instances describe

pcloud compute instances create <InstanceName> --image <ImageName> --network <NetworkName[:IPAddress]> [flags]

Options

  -a, --affinityPolicy string   Affinity policy for replicants being created (must be one of {"affinity", "anti-affinity", "none"}) (default "none")
  -c, --cores float             Number of cores to allocate to the VM Instance (default 2)
  -h, --help                    help for create
  -i, --image string            Image to allocate to the VM Instance (note that 'ImageID' or 'ImageName' can be used) (required)
  -k, --keypair string          SSHKeyPair Name
  -l, --license strings         Software Licenses (several --license allowed, must be one of "IbmiCSS", "IbmiDBQ", "IbmiPHA", "IbmiRDS")
  -m, --memory float            Memory size (in GB) to allocate to the VM Instance (default 4)
  -s, --namingScheme string     Replicants naming scheme (must be one of {"prefix", "suffix"}) (default "suffix")
  -n, --network strings         Networks to assign to the VM Instance, (values must follow the <NetworkName[:IPAddress]> form, note that 'NetworkID' can be provided instead of 'NetworkName', 'IPAddress' is optional, several --network allowed) (required)
  -P, --pinPolicy string        VM pinning policy (must be one of {"none", "soft", "hard"}) (default "none")
  -g, --placementGroup string   Placement group for VM.
  -t, --proctype string         Dedicated, Shared or Capped Processing Type (must be one of {"dedicated", "shared", "capped"}) (default "dedicated")
  -d, --rdsUsers int            Number of IbmiRDS license users (Required if "IbmiRDS" license is specified)
  -r, --replicants float        Number of replicants (default 1)
  -T, --storagetype string      Storage type for VMInstance deployment (required only if image is a "stock" 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 "pcloud compute clouds describe" command.
  -S, --systype string          System type. See note above. (default "s922")
  -u, --userdata string         Cloud-init user defined data file (optional, if necessary data are uuencoded before being sent)
  -v, --volume strings          Volumes to assign to the VM Instance (several --volume allowed, note that 'VolumeID' or 'VolumeName' can be used)

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.12.8 - pcloud compute instances delete

Delete VM Instances

Synopsis

Delete VM Instances from a Cloud. Several VM Instances can be deleted at the same time. Attached volumes can be deleted along with the VM instances by using withvolumes flag. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances delete <InstanceName> [<InstanceName> ...] [flags]

Options

  -f, --force         Skip pre-deletion instance checks, implies -q
  -h, --help          help for delete
  -q, --quiet         Quiet deletion (no confirmation is required)
  -v, --withvolumes   Delete attached volumes when deleting the VM Instances

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.12.9 - pcloud compute instances describe

Describe VM Instance

Synopsis

Describe VM Instance with details. Output format depends on –format option. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances describe <InstanceName> [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

7.12.10 - pcloud compute instances detach-network

Detach a Network from a VM Instance

Synopsis

Detach a Network from a VM Instance in IBM Power Cloud. If “macAddress” is not specified, then a confirmation is asked to the user to verify that all attachments for that given network can be detached. If “macAddress” is specified, only that single attachment is detached from the given network (no confirmation is required). Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances detach-network <InstanceName> --network <NetworkName> [flags]

Options

  -h, --help                help for detach-network
  -m, --macAddress string   MAC address to detach (optional). If no MAC address is provided, all attachments of the Network are detached after user confirmation
  -n, --network string      Network to detach from the VM Instance (note that 'NetworkName' or 'NetworkID' can be used) (required)
  -q, --quiet               Quiet detach (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

7.12.11 - pcloud compute instances detach-volume

Detach Volumes from a VM Instance

Synopsis

Detach Volumes from a VM Instance in IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances detach-volume <InstanceName> --volume <VolumeName> (several --volume allowed) [flags]

Options

  -h, --help             help for detach-volume
  -v, --volume strings   Volume to detach from the VM Instance (note that 'VolumeName' or 'VolumeID' can be used. Several --volume allowed) (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

7.12.12 - pcloud compute instances dumprestart

Dump Restart VM Instances (dumprestart)

Synopsis

Dump restart VM Instances in the IBM Power Cloud (dumprestart). Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances dumprestart <InstanceName> [<InstanceName> ...] [flags]

Options

  -h, --help    help for dumprestart
  -q, --quiet   Quiet shutdown (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

7.12.13 - pcloud compute instances list

List VM Instances

Synopsis

List VM Instances of Cloud Instance. VM Instances details are displayed with –long option. VM Instances can be filtered out with –filter option. Output format depends on –format option.

pcloud compute instances list [flags]

Options

  -f, --filter string    Set search filter.
                         Filters can be any boolean expression built on VM Instance attributes from this list:
                         "ConsoleLanguage HostID ImageID LicenseRepositoryCapacity Memory Migratable NetworkIDs OperatingSystem OsType PinPolicy PlacementGroup ProcType Processors PvmInstanceID SapProfile ServerName SoftwareLicenses Srcs Status StoragePool StoragePoolAffinity StorageType TaskState VirtualCores VolumeIDs"
  -h, --help             help for list
  -l, --long             Print detailed info of each VM Instance
  -r, --resource-usage   Display core and memory information

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.12.14 - pcloud compute instances reboot

Reboot VM Instances (soft-reboot by default)

Synopsis

Reboot VM Instances in the IBM Power Cloud (soft-reboot by default). Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances reboot <InstanceName> [<InstanceName> ...] [flags]

Options

  -r, --hard    Reboot VM Instances with hard-reboot
  -h, --help    help for reboot
  -q, --quiet   Quiet reboot (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

7.12.15 - pcloud compute instances reset

Reset the state of VM Instances (reset-state)

Synopsis

Reset the state of VM Instances in the IBM Power Cloud (reset-state). Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances reset <InstanceName> [<InstanceName> ...] [flags]

Options

  -h, --help    help for reset
  -q, --quiet   Quiet reset (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

7.12.16 - pcloud compute instances shutdown

Shutdown VM Instances (immediate-shutdown)

Synopsis

Shutdown VM Instances in the IBM Power Cloud (immediate-shutdown). Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances shutdown <InstanceName> [<InstanceName> ...] [flags]

Options

  -h, --help    help for shutdown
  -q, --quiet   Quiet shutdown (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

7.12.17 - pcloud compute instances start

Start VM Instances

Synopsis

Start VM Instances in the IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances start <InstanceName> [<InstanceName> ...] [flags]

Options

  -h, --help   help for start

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.12.18 - pcloud compute instances stop

Stop VM Instances

Synopsis

Stop VM Instances in the IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances stop <InstanceName> [<InstanceName> ...] [flags]

Options

  -h, --help    help for stop
  -q, --quiet   Quiet stop (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

7.12.19 - pcloud compute instances update

Update a VM Instance

Synopsis

Update a VM Instance in IBM Power Cloud. Note that InstanceID can be used as parameter instead of InstanceName.

pcloud compute instances update <InstanceName> [flags]

Options

  -c, --cores float        New number of cores to allocate to the VM instance
  -h, --help               help for update
  -l, --license strings    Software Licenses (several --license allowed, must be one of "IbmiCSS", "IbmiDBQ", "IbmiPHA", "IbmiRDS")
  -m, --memory float       New memory size (in GB) to allocate to the VM instance
  -n, --name string        New name of the VM Instance
  -P, --pinPolicy string   New VM pinning policy (must be one of {"none", "soft", "hard"})
  -t, --proctype string    New Processing Type (must be one of {"dedicated", "shared", "capped"})
  -d, --rdsUsers int       Number of IbmiRDS license users (Required if "IbmiRDS" license is specified)

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.13 - Compute Networks

7.13.1 - pcloud compute networks

Network management commands

Synopsis

Network management commands. Possibility to create, describe, list, update, delete Network(s).

pcloud compute networks [flags]

Options

  -h, --help   help for networks

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.13.2 - pcloud compute networks create

Create a Network

Synopsis

Create a Network for a Cloud.

pcloud compute networks create <NetworkName> --cidr <CIDR> --range <startIP-endIP[,startIP-endIP]> [flags]

Options

  -c, --cidr string      Network in CIDR notation (192.168.0.0/24) (required)
  -d, --dns strings      DNS Server (several --dns allowed)
  -g, --gateway string   Gateway
  -h, --help             help for create
  -r, --range string     IP address ranges, format: startIP-endIP[,startIP-endIP] (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

7.13.3 - pcloud compute networks delete

Delete Networks

Synopsis

Delete Networks from a Cloud. Several Networks can be deleted at the same time. Note that NetworkID can be used as parameter instead of NetworkName.

pcloud compute networks delete <NetworkName> [<NetworkName> ...] [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

7.13.4 - pcloud compute networks describe

Describe Network

Synopsis

Describe Network with details. Output format depends on –format option. Note that NetworkID can be used as parameter instead of NetworkName.

pcloud compute networks describe <NetworkName> [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

7.13.5 - pcloud compute networks list

List Networks

Synopsis

List Networks of Cloud Instance. Networks details are displayed with –long option. Networks can be filtered out with –filter option. Output format depends on –format option.

pcloud compute networks list [flags]

Options

  -f, --filter string   Set search filter.
                        Filters can be any boolean expression built on Network attributes from this list:
                        "Cidr CloudConnections DhcpManaged DNSServers Gateway IPAddressMetrics IPAddressRanges Jumbo Name NetworkID PublicIPAddressRanges Type VlanID"
  -h, --help            help for list
  -l, --long            Print detailed info of each Network

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.13.6 - pcloud compute networks ports

Network port commands

Synopsis

Network port commands. Actions include creating, describing, listing, updating, and deleting ports.

pcloud compute networks ports [flags]

Options

  -h, --help    help for ports
  -q, --quiet   Delete without confirmation

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.13.7 - pcloud compute networks ports attach

Attach network port

Synopsis

Attach network port.

pcloud compute networks ports attach <net-name> <port-id> --instance <instance-id> [flags]

Options

  -h, --help              help for attach
  -i, --instance string   Instance ID

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.13.8 - pcloud compute networks ports create

Create network port

Synopsis

Create network port.

pcloud compute networks ports create <net-id> [-d <description>] [-i <ip address>] [flags]

Options

  -d, --description string   Port Description
  -h, --help                 help for create
  -i, --ipAddress string     IP Address

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.13.9 - pcloud compute networks ports delete

Delete network port

Synopsis

Delete network port

pcloud compute networks ports delete [flags]

Options

  -h, --help   help for delete

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.13.10 - pcloud compute networks ports describe

Describe network ports

Synopsis

Describe network ports.

pcloud compute networks ports describe <net-id> <port-id> [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

7.13.11 - pcloud compute networks ports detach

Detach network port

Synopsis

Detach network port.

pcloud compute networks ports detach <net-id> <port-id> [flags]

Options

  -h, --help   help for detach

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.13.12 - pcloud compute networks ports list

List network ports

Synopsis

List network ports.

pcloud compute networks ports list <net-id> [flags]

Options

  -h, --help   help for list

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.13.13 - pcloud compute networks ports update

Update network port

Synopsis

Update network port.

pcloud compute networks ports update <net-id> <port-id> -d <description> [flags]

Options

  -d, --description string   Port Description
  -h, --help                 help for update

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.13.14 - pcloud compute networks update

Update a Network

Synopsis

Update a Network for a Cloud. Note that NetworkID can be used as parameter instead of NetworkName.

pcloud compute networks update <NetworkName> [flags]

Options

  -d, --dns strings      DNS Server (several --dns allowed)
  -g, --gateway string   Gateway
  -h, --help             help for update
  -n, --name string      New name of network
  -r, --range string     IP address ranges, format: startIP-endIP[,startIP-endIP]

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.14 - Compute Pgroups

7.14.1 - pcloud compute pgroups

Placement Groups management commands

Synopsis

Placement Group management commands.

PGroups may be created, deleted, listed, and described. PVM Instances may be added to or removed from PGroups.

pcloud compute pgroups [flags]

Options

  -h, --help   help for pgroups

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.14.2 - pcloud compute pgroups add

Add Instance to Placement Group

Synopsis

Add a PVM Instance to a Placement Group.

pcloud compute pgroups add <PGroup> <Instance> [flags]

Options

  -h, --help   help for add

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.14.3 - pcloud compute pgroups create

Create Placement Group

Synopsis

Create a new Placement Group.

Must specify the PGroup name and one of ‘affinity’ or ‘anti-affinity’.

pcloud compute pgroups create <PGroup> <affinity|anti-affinity> [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

7.14.4 - pcloud compute pgroups delete

Delete Placement Group

Synopsis

Delete a Placement Group.

pcloud compute pgroups delete <PGroup> [flags]

Options

  -h, --help   help for delete

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.14.5 - pcloud compute pgroups describe

Describe Placement Group

Synopsis

Describe a Placement Group.

pcloud compute pgroups describe <PGroup> [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

7.14.6 - pcloud compute pgroups list

List Placement Groups

Synopsis

List Placement Groups int he Cloud Instance.

Output format depends on –format option.

pcloud compute pgroups list [flags]

Options

  -h, --help   help for list

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.14.7 - pcloud compute pgroups remove

Remove Instance from Placement Group

Synopsis

Remove a PVM Instance from a Placement Group.

pcloud compute pgroups remove <PGroup> <Instance> [flags]

Options

  -h, --help   help for remove

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.15 - Compute Snapshots

7.15.1 - pcloud compute snapshots

Snapshot management comamnds

Synopsis

Snapshot management commands

pcloud compute snapshots [flags]

Options

  -h, --help   help for snapshots

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.15.2 - pcloud compute snapshots create

Create Snapshot

Synopsis

Create Snapshot

pcloud compute snapshots create <SnapshotName> <InstanceID> [--description] [--volume] [flags]

Options

  -d, --description string   description
  -h, --help                 help for create
  -v, --volume stringArray   volume(s)

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.15.3 - pcloud compute snapshots delete

Delete Snapshot

Synopsis

Delete Snapshot

pcloud compute snapshots delete <SnapshotID> [flags]

Options

  -h, --help   help for delete

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.15.4 - pcloud compute snapshots describe

Describe Snapshot

Synopsis

Describe Snapshot

pcloud compute snapshots describe <SnapshotID> [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

7.15.5 - pcloud compute snapshots list

List Snapshots

Synopsis

List Snapshots

pcloud compute snapshots list [--long] [--instance=<InstanceID>] [flags]

Options

  -h, --help              help for list
  -i, --instance string   only instance snapshots
  -l, --long              show detailed report

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.15.6 - pcloud compute snapshots restore

Restore Snapshot

Synopsis

Restore Snapshot

pcloud compute snapshots restore SnapshotID InstanceID [--force] [flags]

Options

  -f, --force   force restore
  -h, --help    help for restore

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.15.7 - pcloud compute snapshots update

Update Snapshot

Synopsis

Update Snapshot

pcloud compute snapshots update [flags]

Options

  -d, --description string   new snapshot description
  -h, --help                 help for update
  -n, --name string          new snapshot name

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.16 - Compute Sshkeys

7.16.1 - pcloud compute sshkeys

SSH Keys management commands

Synopsis

SSH Keys management commands. Possibility to create, list, describe, update, delete SSH Key(s). One SSH Key can be associated to a VM Instance at VM instance creation time.

Options

  -h, --help   help for sshkeys

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.16.2 - pcloud compute sshkeys create

Create a SSH Key

Synopsis

Create a SSH Key. SSH Key can be created without SSH public key, which can be added later on.

pcloud compute sshkeys create <SSHKeyName> [flags]

Options

  -h, --help               help for create
  -p, --publickey string   SSH public key

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.16.3 - pcloud compute sshkeys delete

Delete SSH Keys

Synopsis

Delete SSH Keys. Several SSH Keys can be deleted at the same time.

pcloud compute sshkeys delete <SSHKeyName> [<SSHKeyName> ...] [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

7.16.4 - pcloud compute sshkeys describe

Describe SSH Key

Synopsis

Describe SSH Key with details. Output format depends on –format option.

pcloud compute sshkeys describe <SSHKeyName> [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

7.16.5 - pcloud compute sshkeys list

List SSH Keys

Synopsis

List SSH Keys with details. Output format depends on –format option.

pcloud compute sshkeys list [flags]

Options

  -h, --help   help for list
  -l, --long   Print detailed info of each SSHKey

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.16.6 - pcloud compute sshkeys update

Update a SSH Key

Synopsis

Update a SSH Key’s name or public key.

pcloud compute sshkeys update <SSHKeyName> [flags]

Options

  -h, --help               help for update
  -k, --keyname string     new SSH Key Name
  -p, --publickey string   New SSH public key

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.17 - Compute Volume-Groups

7.17.1 - pcloud compute volume-groups

Volume group commands

Synopsis

Volume group commands

pcloud compute volume-groups [flags]

Options

  -h, --help   help for volume-groups

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.17.2 - pcloud compute volume-groups add-volumes

add volume(s) to group

Synopsis

add volume(s) to group

pcloud compute volume-groups add-volumes <volume-group> --volume=<volume> [--volume=<volume>] [flags]

Options

  -h, --help                 help for add-volumes
  -v, --volume stringArray   Volume

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.17.3 - pcloud compute volume-groups create

create volume group

Synopsis

create volume group

pcloud compute volume-groups create --name <name> --description <description> --volume <volume-id> [flags]

Options

  -d, --description string   Description
  -h, --help                 help for create
  -n, --name string          Name
  -v, --volume stringArray   Volume(s)

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.17.4 - pcloud compute volume-groups delete

delete volume group

Synopsis

delete volume group

pcloud compute volume-groups delete <volume group> [flags]

Options

  -h, --help   help for delete

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.17.5 - pcloud compute volume-groups describe

show the volume groups

Synopsis

show the volume groups

pcloud compute volume-groups describe usage [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

7.17.6 - pcloud compute volume-groups list

List volume groups

Synopsis

List volume groups

pcloud compute volume-groups list [flags]

Options

  -h, --help   help for list

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.17.7 - pcloud compute volume-groups relationship

show remote copy relationship

Synopsis

show remote copy relationship

pcloud compute volume-groups relationship <group-id> [--secondary] [flags]

Options

  -h, --help        help for relationship
  -s, --secondary   show secondary status

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.17.8 - pcloud compute volume-groups remove-volumes

remove volume(s) from group

Synopsis

remove volume(s) from group

pcloud compute volume-groups remove-volumes <volume-group> --volume-<volume> [--volume=<volume>] [flags]

Options

  -h, --help                 help for remove-volumes
  -v, --volume stringArray   Volume

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.17.9 - pcloud compute volume-groups reset

reset replication in the group

Synopsis

reset replication in the group

pcloud compute volume-groups reset <group-id> [--quiet] [flags]

Options

  -h, --help    help for reset
  -q, --quiet   do not prompt for confirmation

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.17.10 - pcloud compute volume-groups start

start replication in the group

Synopsis

start replication in the group

pcloud compute volume-groups start <group-id> <master|aux> [flags]

Options

  -h, --help   help for start

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.17.11 - pcloud compute volume-groups stop

stop replication in the group

Synopsis

stop replication in the group

pcloud compute volume-groups stop <group-id> [--allow-read-access] [flags]

Options

  -a, --allow-read-access   allow read access
  -h, --help                help for stop

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.18 - Compute Volumes

7.18.1 - pcloud compute volumes

Volume management commands

Synopsis

Volume management commands.

You can create more data volumes to hold application data or support multi-disk use cases with your VMs by using the “pcloud compute volumes” subcommand.

Possibility to create, describe, list, update, delete Volume(s). Possibility to list, describe Volume(s) of a VM instance. Possibility to set a Volume as the boot Volume of a VM instance.

pcloud compute volumes [flags]

Options

  -h, --help   help for volumes

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.18.2 - pcloud compute volumes clones

Clone Management Commands

Synopsis

Clone Management Commands

pcloud compute volumes clones [flags]

Options

  -h, --help   help for clones

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.18.3 - pcloud compute volumes clones cancel

Cancel a Volume Clone

Synopsis

Cancel a Volume Clone

pcloud compute volumes clones cancel <VolumeCloneID> [flags]

Options

  -f, --force   force cancellation
  -h, --help    help for cancel

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.18.4 - pcloud compute volumes clones create

Create Clone

Synopsis

Create Clone

pcloud compute volumes clones create <CloneName> -v <VolumeName> [-v <VolumeName> ...] [flags]

Options

  -h, --help                 help for create
  -v, --volume stringArray   Volume clone source(s).

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.18.5 - pcloud compute volumes clones delete

Delete Clone

Synopsis

Delete Clone

pcloud compute volumes clones delete <VolumeCloneID> [flags]

Options

  -h, --help   help for delete

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.18.6 - pcloud compute volumes clones describe

Describe a Volume Clone Request

Synopsis

Describe a Volume Clone Request

pcloud compute volumes clones describe <VolumeCloneID> [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

7.18.7 - pcloud compute volumes clones execute

Initiate Volume Clone Execute

Synopsis

Initiate Volume Clone Execute

pcloud compute volumes clones execute <VolumesCloneID> <CloneName> [flags]

Options

  -h, --help               help for execute
  -r, --rollback-prepare   rollback prepared snapshot on failure

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.18.8 - pcloud compute volumes clones list

List Clone Requests

Synopsis

List Clone Requests

The –long option will provide extended clone detail.

The may be one of: - prepare - start - exeecute - cancel - completed - failed - cancelled - finalized

pcloud compute volumes clones list [--long] [--filter=<FilterSpec>] [flags]

Options

  -f, --filter string   filter
  -h, --help            help for list
  -l, --long            long output format

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.18.9 - pcloud compute volumes clones new

Prepare Clone Request

Synopsis

Prepare Clone Request

pcloud compute volumes clones new <CloneName> -v <VolumeName> [-v <VolumeName> ...] [flags]

Options

  -h, --help                 help for new
  -v, --volume stringArray   Volume clone source(s).

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.18.10 - pcloud compute volumes clones start

Initiate The Volume Clone Start

Synopsis

Initiate The Volume Clone Start

pcloud compute volumes clones start <VolumesCloneID> [flags]

Options

  -h, --help   help for start

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.18.11 - pcloud compute volumes clones status

Get Clone Task Status

Synopsis

Get Clone Task Status

pcloud compute volumes clones status <CloneTaskID> [flags]

Options

  -h, --help   help for status

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.18.12 - pcloud compute volumes create

Create Volumes

Synopsis

Create Volumes for a Cloud

pcloud compute volumes create <VolumeName> --type <Type> [flags]

Options

  -a, --affinityPolicy string   Affinity policy for data volume being created (must be one of {"affinity", "anti-affinity"}, requires --affinityVolume to be specified)
                                 - "affinity": uses the same storage provider that the specified affinityVolume was created in.
                                 - "anti-affinity": uses any storage provider that is not the same as the storage provider the affinityVolume is in.
  -v, --affinityVolume string   Volume (ID or Name) to base volume affinity policy against (required if --affinityPolicy is provided)
  -r, --enableReplication       Indicates replication should be enabled
  -h, --help                    help for create
  -n, --number int              Number of volumes to create (default 1)
  -S, --shareable               Indicates if the volume is shareable between VMs
  -s, --size int                Volume Size (GB) (default 10)
  -T, --type string             Storage type (required except when affinity is specified)
                                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 of your cloud by running the "pcloud compute clouds describe <cloudID>" command.
  -p, --volumePool string       Volume pool for new volume(s)

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.18.13 - pcloud compute volumes delete

Delete Volumes

Synopsis

Delete Volume(s) from a Cloud. Several volumes can be deleted at the same time. Note that VolumeID can be used as parameter instead of VolumeName

pcloud compute volumes delete <VolumeName> [<VolumeName> ] [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

7.18.14 - pcloud compute volumes describe

Describe Volume

Synopsis

Describe Volume with details. Output format depends on –format option., Note that VolumeID can be used as parameter instead of VolumeName.

pcloud compute volumes describe <VolumeName> [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

7.18.15 - pcloud compute volumes list-pools

List Volume Pools

Synopsis

List volume pools

pcloud compute volumes list-pools [flags]

Options

  -h, --help   help for list-pools

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.18.16 - pcloud compute volumes list

List Volumes

Synopsis

List Volumes with details. If no –instance parameter is provided, list Volume(s) of Cloud Instance. If –instance parameter is provided, and if –affinity is not provided, list volumes attached to a VM Instance. If –instance parameter is provided, and if –affinity is provided, list volumes in affinity with a VM Instance. Volumes details are displayed with –long option. Volumes can be filtered out with –filter option. Output format depends on –format option.

pcloud compute volumes list [flags]

Options

  -a, --affinity          List volumes in affinity with a VM Instance (note that --instance must be set)
  -f, --filter string     Set search filter.
                          Filters can be any boolean expression built on Volume attributes from this list:
                          "AuxVolumeName BootVolume Bootable ConsistencyGroupName CreationDate DeleteOnTermination DiskType GroupID IoThrottleRate LastUpdateDate MasterVolumeName MirroringState Name PvmInstanceIDs ReplicationStatus Shareable Size State VolumeID VolumePool VolumeType Wwn"
  -h, --help              help for list
  -i, --instance string   Without -a option, VM Instance to see its attached volumes.
                           With -a option, VM Instance to see its affinity volumes.
                           (note that 'InstanceID' or 'InstanceName' can be used)
  -l, --long              Print detailed info of each Volume

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.18.17 - pcloud compute volumes replication

volume replication commands

Synopsis

volume replication commands

pcloud compute volumes replication [flags]

Options

  -h, --help   help for replication

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.18.18 - pcloud compute volumes replication disable

disable replication on a volume

Synopsis

disable replication on a volume

pcloud compute volumes replication disable <volume-id> [flags]

Options

  -h, --help   help for disable

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.18.19 - pcloud compute volumes replication enable

enable replication on a volume

Synopsis

enable replication on a volume

pcloud compute volumes replication enable volume <volume-id> [flags]

Options

  -h, --help   help for enable

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.18.20 - pcloud compute volumes replication onboard

onboard aux volumes

Synopsis

onboard aux volumes

pcloud compute volumes replication onboard --name <name> --source <cloud-id> --volume <aux-volume-name:local-volume-name> [flags]

Options

  -h, --help                 help for onboard
  -n, --name string          Replication Name
  -s, --source string        Source Cloud ID
  -v, --volume stringArray   AuxVolume:LocalName

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.18.21 - pcloud compute volumes transfer

Volume Transfer Commands

Synopsis

Volume Transfer Commands

pcloud compute volumes transfer [flags]

Options

  -h, --help   help for transfer

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.18.22 - pcloud compute volumes transfer accept

Accept a volume transfer

Synopsis

Accept a volume transfer

pcloud compute volumes transfer accept <transferID> <authCode> [flags]

Options

  -h, --help   help for accept

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.18.23 - pcloud compute volumes transfer create

Volume Transfer Create

Synopsis

Volume Transfer Create

pcloud compute volumes transfer create <name> <volumeID> [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

7.18.24 - pcloud compute volumes transfer delete

Delete a volume transfer

Synopsis

Delete a volume transfer

pcloud compute volumes transfer delete <transferID> [flags]

Options

  -h, --help   help for delete

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.18.25 - pcloud compute volumes transfer describe

Describe volume transfer

Synopsis

Describe volume transfer

pcloud compute volumes transfer describe <transferID> [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

7.18.26 - pcloud compute volumes transfer list

Volume transfer list

Synopsis

Volume transfer list

pcloud compute volumes transfer list [flags]

Options

  -h, --help   help for list

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.18.27 - pcloud compute volumes update

Update a Volume

Synopsis

Update a Volume for a Cloud Instance. Note that VolumeID can be used as parameter instead of VolumeName.

pcloud compute volumes update <VolumeName> [flags]

Options

  -B, --bootable string    Indicates if the volume is boot capable [yes/no]
  -h, --help               help for update
  -n, --name string        New Volume name
  -S, --shareable string   Indicates if the volume is shareable between VMs [yes/no]
  -s, --size float         New Volume size (GB)

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

8 - pcloud CLI Release Notes

Version 1.100.0 (2024-12-09)

  • Add listing volume pools using pcloud compute volumes spools
  • Add Volume Pool specification to allow users to specify the target volume pool when using pcloud compute volumes create
  • Add pcloud compute instances dumprestart to enable dumprestart functionality for VM Instances

Version 1.99.11 (2024-09-30)

  • Expand acceptable datetime inputs for pcloud compute events to pcloud compute events list

Version 1.91.0 (2023-12-05)

  • Add WWN to pcloud compute volumes describe

Version 1.5.0 (2023-08-04)

  • Add volume transfer capability with pcloud compute volumes transfer