imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-19 07:15:23 +00:00
Code Activity

gcloud: Wed Apr 3 09:23:31 UTC 2024

Browse source
This commit is contained in:
Automated 2024-04-03 09:23:31 +00:00
parent 4ade1b44cc
commit 7e2535c53d
212 changed files with 8070 additions and 151 deletions
Download patch file Download diff file Expand all files Collapse all files

6
gcloud/alpha/compute/help
View file

@ -185,6 +185,12 @@ GROUPS
ssl-policies
(ALPHA) List, create, delete and update Compute Engine SSL policies.
storage-pool-types
(ALPHA) Read storage pool types.
storage-pools
(ALPHA) Read and manipulate storage pools.
target-grpc-proxies
(ALPHA) Manage Compute Engine target gRPC proxy resources.

22
gcloud/alpha/compute/images/create
View file

@ -13,6 +13,8 @@ SYNOPSIS
[--key-exchange-key-file=[KEK_VALUE,...]] [--labels=[KEY=VALUE,...]]
[--licenses=[LICENSES,...]] [--platform-key-file=PLATFORM_KEY_FILE]
[--no-require-csek-key-create]
[--rollout-override=[default_rollout_time=DEFAULT_ROLLOUT_TIME],
[location_rollout_policies=LOCATION_ROLLOUT_POLICIES]]
[--signature-database-file=[DB_VALUE,...]]
[--source-disk-project=SOURCE_DISK_PROJECT]
[--source-disk-zone=SOURCE_DISK_ZONE]
@ -189,6 +191,26 @@ OPTIONAL FLAGS
for more details. Enabled by default, use --no-require-csek-key-create
to disable.
--rollout-override=[default_rollout_time=DEFAULT_ROLLOUT_TIME],[location_rollout_policies=LOCATION_ROLLOUT_POLICIES]
A rollout policy for the image. A rollout policy is used to restrict
the zones where this image is accessible when using a zonal image
family reference. When specified, the rollout policy overrides per-zone
references to the image through the associated image family. When the
rollout policy does not include the user specified zone, or if the zone
is rolled out, this image is accessible.
default_rollout_time
This is an optional RFC3339 timestamp on or after which
the update is considered rolled out to any zone that is not
explicitly stated.
location_rollout_policies
Location based rollout policies to apply to the resource.
Currently only zone names are supported as the key and must be
represented as valid URLs, like: zones/us-central1-a.
The value expects an RFC3339 timestamp on or after which the update
is considered rolled out to the specified location.
--signature-database-file=[DB_VALUE,...]
Comma-separated list of file paths that point to valid X.509
certificates in DER format or raw binary files. When you create a

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel
View file

@ -69,7 +69,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests cancel
$ gcloud beta compute instance-groups managed resize-requests cancel

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/create
View file

@ -73,7 +73,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests create
$ gcloud beta compute instance-groups managed resize-requests create

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/delete
View file

@ -63,7 +63,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests delete
$ gcloud beta compute instance-groups managed resize-requests delete

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/describe
View file

@ -62,7 +62,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests describe
$ gcloud beta compute instance-groups managed resize-requests \
describe

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/help
View file

@ -37,7 +37,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests
$ gcloud beta compute instance-groups managed resize-requests

4
gcloud/alpha/compute/instance-groups/managed/resize-requests/list
View file

@ -91,7 +91,9 @@ NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
access allowlist. These variants are also available:
$ gcloud compute instance-groups managed resize-requests list
$ gcloud beta compute instance-groups managed resize-requests list

16
gcloud/alpha/compute/instance-templates/create
View file

@ -11,6 +11,7 @@ SYNOPSIS
[--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE]
[--can-ip-forward] [--configure-disk=[PROPERTY=VALUE,...]]
[--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION]
[--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
[--disk=[auto-delete=AUTO-DELETE],
[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]]
[--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking]
@ -345,6 +346,21 @@ FLAGS
--description=DESCRIPTION
Specifies a textual description for the instance template.
--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
Required and only allowed for VMs that have one or more local SSDs, use
--termination-action=STOP (default), and use either --max-run-duration
or --termination-time. This flag indicates whether you want Compute
Engine to discard (true) or preserve (false) local SSD data when the
VM's terminationTimestamp is reached.
If set to false, Compute Engine will preserve local SSD data by
including the --discard-local-ssd=false flag in the automatic
termination command. The --discard-local-ssd=false flag preserves local
SSD data by migrating it to persistent storage until you rerun the VM.
Importantly, preserving local SSD data incurs costs and is subject to
restrictions. For more information, see
https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME]
Attaches an existing persistent disk to the instances.

16
gcloud/alpha/compute/instances/bulk/create
View file

@ -14,6 +14,7 @@ SYNOPSIS
[--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE]
[--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]]
[--description=DESCRIPTION]
[--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
[--disk=[boot=BOOT],
[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]]
[--enable-display-device] [--[no-]enable-nested-virtualization]
@ -381,6 +382,21 @@ OPTIONAL FLAGS
--description=DESCRIPTION
Specifies a textual description of the instances.
--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
Required and only allowed for VMs that have one or more local SSDs, use
--termination-action=STOP (default), and use either --max-run-duration
or --termination-time. This flag indicates whether you want Compute
Engine to discard (true) or preserve (false) local SSD data when the
VM's terminationTimestamp is reached.
If set to false, Compute Engine will preserve local SSD data by
including the --discard-local-ssd=false flag in the automatic
termination command. The --discard-local-ssd=false flag preserves local
SSD data by migrating it to persistent storage until you rerun the VM.
Importantly, preserving local SSD data incurs costs and is subject to
restrictions. For more information, see
https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
--disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]
Attaches persistent disks to the instances. The disks specified must
already exist.

22
gcloud/alpha/compute/instances/create
View file

@ -14,6 +14,7 @@ SYNOPSIS
[--can-ip-forward] [--create-disk=[PROPERTY=VALUE,...]]
[--csek-key-file=FILE] [--deletion-protection]
[--description=DESCRIPTION]
[--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
[--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],
[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]]
[--enable-display-device] [--[no-]enable-nested-virtualization]
@ -445,6 +446,21 @@ FLAGS
--description=DESCRIPTION
Specifies a textual description of the instances.
--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
Required and only allowed for VMs that have one or more local SSDs, use
--termination-action=STOP (default), and use either --max-run-duration
or --termination-time. This flag indicates whether you want Compute
Engine to discard (true) or preserve (false) local SSD data when the
VM's terminationTimestamp is reached.
If set to false, Compute Engine will preserve local SSD data by
including the --discard-local-ssd=false flag in the automatic
termination command. The --discard-local-ssd=false flag preserves local
SSD data by migrating it to persistent storage until you rerun the VM.
Importantly, preserving local SSD data incurs costs and is subject to
restrictions. For more information, see
https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]
Attaches an existing persistent disk to the instances.
@ -585,9 +601,9 @@ FLAGS
--ipv6-public-ptr-domain=IPV6_PUBLIC_PTR_DOMAIN
Assigns a custom PTR domain for the external IPv6 in the IPv6 access
configuration of instance. If its value is not specified, the default
PTR record will be used. This option can only be specified for the
default network interface, nic0.
configuration of instance. If unspecified or specified to be an empty
string, the default PTR record will be used. This option can only be
specified for the default network interface, nic0.
--key-revocation-action-type=POLICY
Specifies the behavior of the instance when the KMS key of one of its

25
gcloud/alpha/compute/instances/set-scheduling
View file

@ -11,6 +11,8 @@ SYNOPSIS
[--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible]
[--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure]
[--zone=ZONE]
[--clear-discard-local-ssds-at-termination-timestamp
| --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
[--clear-instance-termination-action
| --instance-termination-action=INSTANCE_TERMINATION_ACTION]
[--clear-max-run-duration | --max-run-duration=MAX_RUN_DURATION]
@ -118,6 +120,29 @@ FLAGS
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_COMPUTE_ZONE.
Discard Local SSDs At Termination Timestamp
At most one of these can be specified:
--clear-discard-local-ssds-at-termination-timestamp
Removes the discard-local-ssds-at-termination-timestamp field from
the scheduling options.
--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
Required and only allowed for VMs that have one or more local SSDs,
use --termination-action=STOP (default), and use either
--max-run-duration or --termination-time. This flag indicates whether
you want Compute Engine to discard (true) or preserve (false) local
SSD data when the VM's terminationTimestamp is reached.
If set to false, Compute Engine will preserve local SSD data by
including the --discard-local-ssd=false flag in the automatic
termination command. The --discard-local-ssd=false flag preserves
local SSD data by migrating it to persistent storage until you rerun
the VM. Importantly, preserving local SSD data incurs costs and is
subject to restrictions. For more information, see
https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
Instance Termination Action
At most one of these can be specified:

16
gcloud/alpha/compute/queued-resources/create
View file

@ -15,6 +15,7 @@ SYNOPSIS
[--boot-disk-size=BOOT_DISK_SIZE] [--boot-disk-type=BOOT_DISK_TYPE]
[--can-ip-forward] [--count=COUNT] [--create-disk=[PROPERTY=VALUE,...]]
[--description=DESCRIPTION]
[--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP]
[--disk=[boot=BOOT],
[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]]
[--enable-display-device] [--[no-]enable-nested-virtualization]
@ -365,6 +366,21 @@ OPTIONAL FLAGS
--description=DESCRIPTION
Specifies a textual description of the instances.
--discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP
Required and only allowed for VMs that have one or more local SSDs, use
--termination-action=STOP (default), and use either --max-run-duration
or --termination-time. This flag indicates whether you want Compute
Engine to discard (true) or preserve (false) local SSD data when the
VM's terminationTimestamp is reached.
If set to false, Compute Engine will preserve local SSD data by
including the --discard-local-ssd=false flag in the automatic
termination command. The --discard-local-ssd=false flag preserves local
SSD data by migrating it to persistent storage until you rerun the VM.
Importantly, preserving local SSD data incurs costs and is subject to
restrictions. For more information, see
https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance.
--disk=[boot=BOOT],[device-name=DEVICE-NAME],[name=NAME],[scope=SCOPE]
Attaches persistent disks to the instances. The disks specified must
already exist.

72
gcloud/alpha/compute/storage-pool-types/describe Normal file
View file

@ -0,0 +1,72 @@
NAME
gcloud alpha compute storage-pool-types describe - describe a storage pool
type
SYNOPSIS
gcloud alpha compute storage-pool-types describe
(STORAGE_POOL_TYPE : --zone=ZONE) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Describe a storage pool.
EXAMPLES
To retrieve a single storage pool type and print its properties, run the
following command:
$ gcloud alpha compute storage-pool-types describe my-storage-pool
POSITIONAL ARGUMENTS
Storage pool type resource - Name of the storage pool you want to inspect.
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool_type on the command line with a
fully specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL_TYPE
ID of the storage pool type or fully qualified identifier for the
storage pool type.
To set the storage_pool_type attribute:
▸ provide the argument storage_pool_type on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool_type on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pool-types describe
$ gcloud beta compute storage-pool-types describe

33
gcloud/alpha/compute/storage-pool-types/help Normal file
View file

@ -0,0 +1,33 @@
NAME
gcloud alpha compute storage-pool-types - read storage pool types
SYNOPSIS
gcloud alpha compute storage-pool-types COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Read Compute Engine storage pool types.
GCLOUD WIDE FLAGS
These flags are available to all commands: --help.
Run $ gcloud help for details.
COMMANDS
COMMAND is one of the following:
describe
(ALPHA) Describe a storage pool type.
list
(ALPHA) View storage pools types.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pool-types
$ gcloud beta compute storage-pool-types

71
gcloud/alpha/compute/storage-pool-types/list Normal file
View file

@ -0,0 +1,71 @@
NAME
gcloud alpha compute storage-pool-types list - view storage pools types
SYNOPSIS
gcloud alpha compute storage-pool-types list [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) View storage pools.
EXAMPLES
To display all storage pool types and their locations visible the project,
run the following command:
$ gcloud alpha compute storage-pool-types list
The --filter option can be used to filter down available options. To
display all available storage pool types in US-based zones, run the
following command:
$ gcloud alpha compute storage-pool-types list --filter="zone ~ us"
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag
specifies the maximum number of resources per page. The default is
determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter
and --limit depending on the service.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag interacts with other flags that are
applied in this order: --flatten, --sort-by, --filter, --limit.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pool-types list
$ gcloud beta compute storage-pool-types list

129
gcloud/alpha/compute/storage-pools/create Normal file
View file

@ -0,0 +1,129 @@
NAME
gcloud alpha compute storage-pools create - create a storage pool
SYNOPSIS
gcloud alpha compute storage-pools create STORAGE_POOL
--provisioned-capacity=PROVISIONED_CAPACITY
--storage-pool-type=STORAGE_POOL_TYPE [--async]
[--capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE]
[--description=DESCRIPTION]
[--performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE]
[--provisioned-iops=PROVISIONED_IOPS]
[--provisioned-throughput=PROVISIONED_THROUGHPUT] [--zone=ZONE]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Create a storage pool.
EXAMPLES
To create a new storage pool named my-storage-pool, run the following
command:
$ gcloud alpha compute storage-pools create my-storage-pool \
--storage-pool-type=hyperdisk-throughput \
--provisioned-capacity=10TB --provisioned-throughput=200
POSITIONAL ARGUMENTS
Storage pool resource - The name of the storage pool you want to create.
This represents a Cloud resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
To set the zone attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ provide the argument --zone on the command line;
◆ set the property compute/zone.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
REQUIRED FLAGS
--provisioned-capacity=PROVISIONED_CAPACITY
Provisioned capacity of the storage pool.
Storage pool type resource - Type of the storage pool. This represents a
Cloud resource. (NOTE) Some attributes are not given arguments in this
group but can be set in other ways.
To set the project attribute:
◆ provide the argument --storage-pool-type on the command line with a
fully specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
To set the zone attribute:
◆ provide the argument --storage-pool-type on the command line with a
fully specified name;
◆ provide the argument --zone on the command line;
◆ set the property compute/zone.
This must be specified.
--storage-pool-type=STORAGE_POOL_TYPE
ID of the storage pool type or fully qualified identifier for the
storage pool type.
To set the storage-pool-type attribute:
▸ provide the argument --storage-pool-type on the command line.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
--capacity-provisioning-type=CAPACITY_PROVISIONING_TYPE
Capacity provisioning type. CAPACITY_PROVISIONING_TYPE must be one of:
advanced, standard.
--description=DESCRIPTION
Description of the storage pool.
--performance-provisioning-type=PERFORMANCE_PROVISIONING_TYPE
Performance provisioning type. PERFORMANCE_PROVISIONING_TYPE must be
one of: advanced, standard.
--provisioned-iops=PROVISIONED_IOPS
IOPS with which to provision the pool.
--provisioned-throughput=PROVISIONED_THROUGHPUT
Throughput in MB/s with which to provision the pool.
--zone=ZONE
For resources [storage pool, storage pool type], provides fallback
value for resource zone attribute. When the resource's full URI path is
not provided, zone will fallback to this flag value.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools create
$ gcloud beta compute storage-pools create

76
gcloud/alpha/compute/storage-pools/delete Normal file
View file

@ -0,0 +1,76 @@
NAME
gcloud alpha compute storage-pools delete - delete a storage pool
SYNOPSIS
gcloud alpha compute storage-pools delete (STORAGE_POOL : --zone=ZONE)
[--async] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Deleta a storage pool.
EXAMPLES
To delete a single storage pool named my-storage-pool, run the following
command:
$ gcloud alpha compute storage-pools delete my-storage-pool
POSITIONAL ARGUMENTS
Storage pool resource - Name of the storage pool you want to delete. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools delete
$ gcloud beta compute storage-pools delete

71
gcloud/alpha/compute/storage-pools/describe Normal file
View file

@ -0,0 +1,71 @@
NAME
gcloud alpha compute storage-pools describe - describe a storage pool
SYNOPSIS
gcloud alpha compute storage-pools describe (STORAGE_POOL : --zone=ZONE)
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Describe a storage pool.
EXAMPLES
To retrieve a single storage pool and print its properties, run the
following command:
$ gcloud alpha compute storage-pools describe my-storage-pool
POSITIONAL ARGUMENTS
Storage pool resource - Name of the storage pool you want to inspect. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools describe
$ gcloud beta compute storage-pools describe

99
gcloud/alpha/compute/storage-pools/get-iam-policy Normal file
View file

@ -0,0 +1,99 @@
NAME
gcloud alpha compute storage-pools get-iam-policy - get the IAM policy of a
storage pool
SYNOPSIS
gcloud alpha compute storage-pools get-iam-policy
(STORAGE_POOL : --zone=ZONE) [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Get the IAM policy of a storage pool.
EXAMPLES
The following command retrieves the IAM configuration of the specified
storage pool.
$ gcloud alpha compute storage-pools get-iam-policy my-storage-pool
POSITIONAL ARGUMENTS
Storage pool resource - Storage pool you want to get the IAM permissions
of. The arguments in this group can be used to specify the attributes of
this resource. (NOTE) Some attributes are not given arguments in this
group but can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag
specifies the maximum number of resources per page. The default is
determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter
and --limit depending on the service.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag interacts with other flags that are
applied in this order: --flatten, --sort-by, --filter, --limit.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools get-iam-policy
$ gcloud beta compute storage-pools get-iam-policy

51
gcloud/alpha/compute/storage-pools/help Normal file
View file

@ -0,0 +1,51 @@
NAME
gcloud alpha compute storage-pools - read and manipulate storage pools
SYNOPSIS
gcloud alpha compute storage-pools COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Read and manipulate Compute Engine storage pools.
GCLOUD WIDE FLAGS
These flags are available to all commands: --help.
Run $ gcloud help for details.
COMMANDS
COMMAND is one of the following:
create
(ALPHA) Create a storage pool.
delete
(ALPHA) Delete a storage pool.
describe
(ALPHA) Describe a storage pool.
get-iam-policy
(ALPHA) Get the IAM policy of a storage pool.
list
(ALPHA) View storage pools.
list-disks
(ALPHA) View the disks that are in a storage pool.
set-iam-policy
(ALPHA) Set the IAM policy of the given storage pool.
update
(ALPHA) Update a storage pool.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools
$ gcloud beta compute storage-pools

94
gcloud/alpha/compute/storage-pools/list Normal file
View file

@ -0,0 +1,94 @@
NAME
gcloud alpha compute storage-pools list - view storage pools
SYNOPSIS
gcloud alpha compute storage-pools list [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) View storage pools.
The compact default output format is explained below:
The type column contains all three types -- storage pool type, capacity and
performance. For example, the value
> "Hdb/Adv/Std"
means the storage pool type is "hyperdisk-balanced", its capacity type is
"advanced", and its performance type is "standard."
The list of storage pool abbreviations is as follows:
▪ HdB: Hyperdisk Balanced
▪ HdT: Hyperdisk Throughput
The list of capacity/performance abbreviations is as follows:
▪ Adv: Advanced
▪ Std: Standard
The capacity, iops and throughput columns describe used, provisioned, the
utilization rate. For example, the following value for capacity:
40 / 50 (80%)
means 40 TB of it is used, 50 TB provisioned, and its utilization rate is
80%. The utilization rate is equivalent to used capacity divided by
provisioned capacity.
EXAMPLES
To display all storage pools in all regions and zones, run the following
command:
$ gcloud alpha compute storage-pools list
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag
specifies the maximum number of resources per page. The default is
determined by the service if it supports paging, otherwise it is
unlimited (no paging). Paging may be applied before or after --filter
and --limit depending on the service.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag interacts with other flags that are
applied in this order: --flatten, --sort-by, --filter, --limit.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools list
$ gcloud beta compute storage-pools list

72
gcloud/alpha/compute/storage-pools/list-disks Normal file
View file

@ -0,0 +1,72 @@
NAME
gcloud alpha compute storage-pools list-disks - view the disks that are in
a storage pool
SYNOPSIS
gcloud alpha compute storage-pools list-disks (STORAGE_POOL : --zone=ZONE)
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) View the disks that are in a given storage pool.
EXAMPLES
The following command retrieves all disks belonging to a storage pool and
lists them:
$ gcloud alpha compute storage-pools list-disks my-storage-pool
POSITIONAL ARGUMENTS
Storage pool resource - Name of the storage pool you want to inspect. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools list-disks
$ gcloud beta compute storage-pools list-disks

80
gcloud/alpha/compute/storage-pools/set-iam-policy Normal file
View file

@ -0,0 +1,80 @@
NAME
gcloud alpha compute storage-pools set-iam-policy - set the IAM policy of
the given storage pool
SYNOPSIS
gcloud alpha compute storage-pools set-iam-policy
(STORAGE_POOL : --zone=ZONE) POLICY_FILE [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Set the IAM policy of the given storage pool.
EXAMPLES
The following command sets the IAM configuration of the specified storage
pool with the specified policy file.
$ gcloud alpha compute storage-pools set-iam-policy \
my-storage-pool policy.json
POSITIONAL ARGUMENTS
Storage pool resource - Storage pool you want to get the IAM permissions
of. The arguments in this group can be used to specify the attributes of
this resource. (NOTE) Some attributes are not given arguments in this
group but can be set in other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
POLICY_FILE
Path to a local JSON or YAML formatted file containing a valid policy.
The output of the get-iam-policy command is a valid file, as is any
JSON or YAML file conforming to the structure of a Policy
(https://cloud.google.com/iam/reference/rest/v1/Policy).
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools set-iam-policy
$ gcloud beta compute storage-pools set-iam-policy

93
gcloud/alpha/compute/storage-pools/update Normal file
View file

@ -0,0 +1,93 @@
NAME
gcloud alpha compute storage-pools update - update a storage pool
SYNOPSIS
gcloud alpha compute storage-pools update (STORAGE_POOL : --zone=ZONE)
[--async] [--description=DESCRIPTION]
[--provisioned-capacity=PROVISIONED_CAPACITY]
[--provisioned-iops=PROVISIONED_IOPS]
[--provisioned-throughput=PROVISIONED_THROUGHPUT]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Update a storage pool.
EXAMPLES
To update the size of a storage pool named 'my-storage-pool', run th
following command:
$ gcloud alpha compute storage-pools update my-storage-pool \
--provisioned-capacity=20TB
POSITIONAL ARGUMENTS
Storage pool resource - Storage pool you want to update. The arguments in
this group can be used to specify the attributes of this resource. (NOTE)
Some attributes are not given arguments in this group but can be set in
other ways.
To set the project attribute:
◆ provide the argument storage_pool on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
STORAGE_POOL
ID of the storage pool or fully qualified identifier for the storage
pool.
To set the storage_pool attribute:
▸ provide the argument storage_pool on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--zone=ZONE
The name of the Google Compute Engine zone.
To set the zone attribute:
▸ provide the argument storage_pool on the command line with a
fully specified name;
▸ provide the argument --zone on the command line;
▸ set the property compute/zone.
FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
--description=DESCRIPTION
Description of the storage pool.
--provisioned-capacity=PROVISIONED_CAPACITY
Provisioned capacity of the storage pool.
--provisioned-iops=PROVISIONED_IOPS
IOPS to provision the pool with.
--provisioned-throughput=PROVISIONED_THROUGHPUT
Throughput in MB/s provision the pool with.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the compute/alpha API. The full documentation for this
API can be found at: https://cloud.google.com/compute/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud compute storage-pools update
$ gcloud beta compute storage-pools update