Skip to main content

update

inctl vm pool update​

Update an existing VM pool.

Synopsis​

Update an existing VM pool.

  • If no flag is specified, no fields will be updated.
  • If a flag is specified, that field will be updated with the value of the flag.
  • If a flag is specified with an empty string as value, the endpoint will use the default value (e.g., latest runtime version or latest Intrinsic OS version).

Example: Update a pool named 'usecase0' to the latest runtime and Intrinsic OS versions: inctl vm pool update --pool usecase0 --runtime "" --intrinsic-os "" --org=<my-org>

You can specify:

  • Runtime
  • IntrinsicOS
  • tier (preset for pool size, e.g. how many VMs ready anticipated and maximum amount)
  • hardware template (which hardware to use for the VMs inside that pool)

Example fully specified: inctl vm pool update
--pool=usecase1
--tier=ad_hoc_single
--hwtemplate=default
--runtime=intrinsic.platform.20241108.RC00
--intrinsic-os=20241108.RC00
--org=<my-org>

Example pool using default values (current runtime & os + default tier & hwtemplate): inctl vm pool update
--pool=usecase2
--org=<my-org>

inctl vm pool update [flags]

Options​

  -h, --help                  help for update
      --hwtemplate string     The hardware template used for each created VM. All hardware templates -&gt; 'inctl vm pool list-hardware-templates'. (default "default")
      --intrinsic-os string   The IntrinsicOS version to use for the pool's VMs. If not specified, the IntrinsicOS version at the time of execution will be set. The IntrinsicOS version should be in the form of 'YYYYMMDD.RCXX'.
      --pool string           The name of the VM pool.
      --runtime string        The intrinsic platform runtime version that the VMs should run. If not specified, the runtime version at the time of execution will be set. The runtime version should be in the form of 'intrinsic.platform.YYYYMMDD.RCXX'
      --tier string           The tier of VM pool sizing. All tiers -&gt; 'inctl vm pool list-tiers' (default "ad_hoc_single")

Options inherited from parent commands​

  -e, --email string     User email to be used for access control. Optional, will fall back to $USER@google.com if unset.
      --org string       The Intrinsic organization to use. You can set the environment variable
                         	INTRINSIC_ORG=organization to set a default organization.
  -o, --output string    (optional) Output format. One of: (json, ndjson)
      --print-trace      Print the trace identifier when exiting.
  -p, --project string   The Google Cloud Project (GCP) project to use. You can set the environment variable
                         	INTRINSIC_PROJECT=project_name to set a default project name.

SEE ALSO​