1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00

gcloud: Wed Feb 7 10:26:58 UTC 2024

This commit is contained in:
Automated 2024-02-07 10:26:58 +00:00
parent 40bc27506b
commit 3efce28165
109 changed files with 4100 additions and 399 deletions

View file

@ -24,6 +24,9 @@ GROUPS
instance-configs
(ALPHA) Manage instance-specific settings in a managed instance group.
resize-requests
(ALPHA) List, create, delete, cancel, and describe ResizeRequests.
rolling-action
(ALPHA) Manipulate rolling actions on Compute Engine managed instance
groups.

View file

@ -0,0 +1,75 @@
NAME
gcloud alpha compute instance-groups managed resize-requests cancel -
cancel a Compute Engine managed instance group resize request
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests cancel
INSTANCE_GROUP_MANAGER
(--resize-request=RESIZE_REQUEST_NAME
| --resize-requests=RESIZE_REQUEST_NAMES,[...]) [--zone=ZONE]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute instance-groups managed resize-requests cancel
cancels one or more Compute Engine managed instance group resize requests.
You can only cancel a resize request when it is in the ACCEPTED state.
EXAMPLES
To cancel a resize request for a managed instance group, run the following
command:
$ gcloud alpha compute instance-groups managed resize-requests \
cancel my-mig --resize-requests=resize-request-1
POSITIONAL ARGUMENTS
INSTANCE_GROUP_MANAGER
Name of the managed instance group to operate on.
REQUIRED FLAGS
Exactly one of these must be specified:
--resize-request=RESIZE_REQUEST_NAME
(ALPHA only) The name of the resize request to cancel.
--resize-requests=RESIZE_REQUEST_NAMES,[...]
A list of comma-separated names of resize requests to cancel.
OPTIONAL FLAGS
--zone=ZONE
Zone of the managed instance group to operate on. If not specified and
the compute/zone property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_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.
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:
$ gcloud beta compute instance-groups managed resize-requests cancel

View file

@ -0,0 +1,79 @@
NAME
gcloud alpha compute instance-groups managed resize-requests create -
create a Compute Engine managed instance group resize request
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests create
INSTANCE_GROUP_MANAGER --resize-by=RESIZE_BY
--resize-request=RESIZE_REQUEST_NAME
[--requested-run-duration=REQUESTED_RUN_DURATION] [--zone=ZONE]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Create a Compute Engine managed instance group resize request.
EXAMPLES
To create a resize request for a managed instance group, run the following
command:
$ gcloud alpha compute instance-groups managed resize-requests \
create my-mig --resize-request=resize-request-1 --resize-by=1 \
--requested-run-duration=3d1h30s
POSITIONAL ARGUMENTS
INSTANCE_GROUP_MANAGER
Name of the managed instance group to operate on.
REQUIRED FLAGS
--resize-by=RESIZE_BY
The number of VMs to resize managed instance group by.
--resize-request=RESIZE_REQUEST_NAME
The name of the resize request to create.
OPTIONAL FLAGS
--requested-run-duration=REQUESTED_RUN_DURATION
The time you need the requested VMs to run before being automatically
deleted. The value must be formatted as the number of days, hours,
minutes, or seconds followed by d, h, m, and s respectively. For
example, specify 30m for a duration of 30 minutes or 1d2h3m4s for 1
day, 2 hours, 3 minutes, and 4 seconds. The value must be between 10m
(10 minutes) and 7d (7 days).
--zone=ZONE
Zone of the managed instance group to operate on. If not specified and
the compute/zone property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_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.
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:
$ gcloud beta compute instance-groups managed resize-requests create

View file

@ -0,0 +1,69 @@
NAME
gcloud alpha compute instance-groups managed resize-requests delete -
delete a Compute Engine managed instance group resize request
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests delete
INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...]
[--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute instance-groups managed resize-requests delete
deletes one or more Compute Engine managed instance group resize requests.
You can only delete a request when it is in a state SUCCEEDED, FAILED, or
CANCELLED.
EXAMPLES
To delete a resize request for a managed instance group, run the following
command:
$ gcloud alpha compute instance-groups managed resize-requests \
delete my-mig --resize-requests=resize-request-1
POSITIONAL ARGUMENTS
INSTANCE_GROUP_MANAGER
Name of the managed instance group to operate on.
REQUIRED FLAGS
--resize-requests=RESIZE_REQUEST_NAMES,[...]
A list of comma-separated names of resize requests to delete.
OPTIONAL FLAGS
--zone=ZONE
Zone of the managed instance group to operate on. If not specified and
the compute/zone property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_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.
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:
$ gcloud beta compute instance-groups managed resize-requests delete

View file

@ -0,0 +1,69 @@
NAME
gcloud alpha compute instance-groups managed resize-requests describe -
describe a Compute Engine managed instance group resize request
resource
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests describe
INSTANCE_GROUP_MANAGER --resize-request=RESIZE_REQUEST_NAME
[--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute instance-groups managed resize-requests
describe describes a Compute Engine managed instance group resize request
resource.
EXAMPLES
To describe a resize request for a managed instance group, run the
following command:
$ gcloud alpha compute instance-groups managed resize-requests \
describe my-mig --resize-request=resize-request-1
POSITIONAL ARGUMENTS
INSTANCE_GROUP_MANAGER
Name of the managed instance group to operate on.
REQUIRED FLAGS
--resize-request=RESIZE_REQUEST_NAME
The name of the resize request to describe.
OPTIONAL FLAGS
--zone=ZONE
Zone of the managed instance group to operate on. If not specified and
the compute/zone property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_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.
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:
$ gcloud beta compute instance-groups managed resize-requests \
describe

View file

@ -0,0 +1,43 @@
NAME
gcloud alpha compute instance-groups managed resize-requests - list,
create, delete, cancel, and describe ResizeRequests
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests COMMAND
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) List, create, delete, cancel, and describe ResizeRequests.
GCLOUD WIDE FLAGS
These flags are available to all commands: --help.
Run $ gcloud help for details.
COMMANDS
COMMAND is one of the following:
cancel
(ALPHA) Cancel a Compute Engine managed instance group resize request.
create
(ALPHA) Create a Compute Engine managed instance group resize request.
delete
(ALPHA) Delete a Compute Engine managed instance group resize request.
describe
(ALPHA) Describe a Compute Engine managed instance group resize request
resource.
list
(ALPHA) List Compute Engine managed instance group resize requests.
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:
$ gcloud beta compute instance-groups managed resize-requests

View file

@ -0,0 +1,97 @@
NAME
gcloud alpha compute instance-groups managed resize-requests list - list
Compute Engine managed instance group resize requests
SYNOPSIS
gcloud alpha compute instance-groups managed resize-requests list
INSTANCE_GROUP_MANAGER [--zone=ZONE] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute instance-groups managed resize-requests list
displays all Compute Engine resize requests in a managed instance group.
EXAMPLES
To list all resize requests in a managed instance group in table form, run:
$ gcloud alpha compute instance-groups managed resize-requests \ list example-managed-instance-group --zone=us-central1-a
To list the URIs of all resize requests in a managed instance group, run:
$ gcloud alpha compute instance-groups managed resize-requests \ list example-managed-instance-group --zone=us-central1-a --uri
POSITIONAL ARGUMENTS
INSTANCE_GROUP_MANAGER
Name of the managed instance group to operate on.
FLAGS
--zone=ZONE
Zone of the managed instance group to operate on. If not specified and
the compute/zone property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/zone property:
$ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
$ gcloud compute zones list
To unset the property, run:
$ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable
CLOUDSDK_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.
--uri
Print a list of resource URIs instead of the default output, and change
the command output to a list of URIs. If this flag is used with
--format, the formatting is applied on this URI list. To display URIs
alongside other keys instead, use the uri() transform.
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.
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:
$ gcloud beta compute instance-groups managed resize-requests list