imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 06:47:12 +00:00
Code Activity

gcloud: Wed Aug 28 09:41:07 UTC 2024

Browse source
This commit is contained in:
Automated 2024-08-28 09:41:07 +00:00
parent ed5fe34b64
commit afbe8a5afb
256 changed files with 8602 additions and 358 deletions
Download patch file Download diff file Expand all files Collapse all files

4
gcloud/alpha/compute/future-reservations/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 future-reservations cancel
$ gcloud beta compute future-reservations cancel

66
gcloud/alpha/compute/future-reservations/create
View file

@ -13,10 +13,16 @@ SYNOPSIS
--maintenance-interval=MAINTENANCE_INTERVAL
--min-cpu-platform=MIN_CPU_PLATFORM])
(--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME))
[--description=DESCRIPTION] [--name-prefix=NAME_PREFIX]
[--planning-status=PLANNING_STATUS]
[--[no-]require-specific-reservation] [--zone=ZONE]
[--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION]
[--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE]
[--instance-termination-action=INSTANCE_TERMINATION_ACTION]
[--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS]
[--[no-]require-specific-reservation]
[--reservation-name=RESERVATION_NAME]
[--scheduling-type=SCHEDULING_TYPE] [--zone=ZONE]
[--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION]
[--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN
--previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS]
[--share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]]
[GCLOUD_WIDE_FLAG ...]
@ -163,9 +169,25 @@ REQUIRED FLAGS
2021-11-20T07:00:00Z).
OPTIONAL FLAGS
--deployment-type=DEPLOYMENT_TYPE
Indicates if the reservation allocation strategy is static or dynamic.
DENSE refers to a fixed size and topology, with deployment expressed in
terms of blocks. FLEXIBLE indicates a non-static distribution of
capacity that can change over time. Deployment is not expressed in
blocks. DEPLOYMENT_TYPE must be one of: DENSE, FLEXIBLE.
--description=DESCRIPTION
An optional description of the future reservation to create.
--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE
Indicates if this group of VMs have opportunistic maintenance enabled.
Applicable only to dense coordinated maintenance.
--instance-termination-action=INSTANCE_TERMINATION_ACTION
Specific termination action for running instances at the end of
reservation duration, it can be DELETE or STOP.
INSTANCE_TERMINATION_ACTION must be one of: DELETE, STOP.
--name-prefix=NAME_PREFIX
A name prefix for the auto-created reservations when capacity is
delivered at the start time. Each auto-created reservation name starts
@ -194,6 +216,18 @@ OPTIONAL FLAGS
the name of the future reservation. Use --require-specific-reservation
to enable and --no-require-specific-reservation to disable.
--reservation-name=RESERVATION_NAME
Name of reservations where the capacity is provisioned at the time of
delivery of future reservations. If the reservation with the given name
does not exist already, it is created automatically at the time of
Approval with INACTIVE state till specified start-time. Either provide
the reservation_name or a name_prefix.
--scheduling-type=SCHEDULING_TYPE
Indicates the maintenance type for this group of VMs. This will be set
on the reservation via FR, and will be inherited for reservation
blocks. SCHEDULING_TYPE must be one of: GROUPED, INDEPENDENT.
--zone=ZONE
Zone of the future reservation to create. If not specified and the
compute/zone property isn't set, you might be prompted to select a zone
@ -233,6 +267,28 @@ OPTIONAL FLAGS
for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4
seconds. For more information, see $ gcloud topic datetimes.
Manage the commitment info properties
--commitment-name=COMMITMENT_NAME
Name of commitment covering the delivered reservation at the time of
delivery of future reservations. If not specified, it takes the name
of the future reservation.
--commitment-plan=COMMITMENT_PLAN
The plan for this commitment to be created, which determines duration
and discount rate. The currently supported plans are TWELVE_MONTH (1
year), and THIRTY_SIX_MONTH (3 years). COMMITMENT_PLAN must be one
of: TWELVE_MONTH, THIRTY_SIX_MONTH.
--previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS
Applicable only if future reservation will deliver to an existing
reservation with a ramp plan. When set to EXTEND, all associated
parent Committed Used Discount's end-date/term will be extended to
the end-time of this future reservation. Default is to extend
previous commitment's time to the end_time of the reservation.
PREVIOUS_COMMITMENT_TERMS must be (only one value is supported):
EXTEND.
Manage the properties of a shared reservation.
--share-setting=SHARE_SETTING
@ -257,7 +313,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 future-reservations create
$ gcloud beta compute future-reservations create

4
gcloud/alpha/compute/future-reservations/delete
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 future-reservations delete
$ gcloud beta compute future-reservations delete

4
gcloud/alpha/compute/future-reservations/describe
View file

@ -64,7 +64,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 future-reservations describe
$ gcloud beta compute future-reservations describe

4
gcloud/alpha/compute/future-reservations/help
View file

@ -38,7 +38,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 future-reservations
$ gcloud beta compute future-reservations

4
gcloud/alpha/compute/future-reservations/list
View file

@ -59,7 +59,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 future-reservations list
$ gcloud beta compute future-reservations list

65
gcloud/alpha/compute/future-reservations/update
View file

@ -5,13 +5,20 @@ NAME
SYNOPSIS
gcloud alpha compute future-reservations update FUTURE_RESERVATION
[--[no-]auto-delete-auto-created-reservations]
[--description=DESCRIPTION] [--planning-status=PLANNING_STATUS]
[--[no-]require-specific-reservation] [--total-count=TOTAL_COUNT]
[--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION]
[--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE]
[--instance-termination-action=INSTANCE_TERMINATION_ACTION]
[--planning-status=PLANNING_STATUS]
[--[no-]require-specific-reservation]
[--reservation-name=RESERVATION_NAME]
[--scheduling-type=SCHEDULING_TYPE] [--total-count=TOTAL_COUNT]
[--zone=ZONE]
[--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION]
[--clear-name-prefix | --name-prefix=NAME_PREFIX]
[--clear-share-settings
| --share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]]
[--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN
--previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS]
[--machine-type=MACHINE_TYPE
--maintenance-interval=MAINTENANCE_INTERVAL
--min-cpu-platform=MIN_CPU_PLATFORM
@ -44,9 +51,25 @@ FLAGS
Use --auto-delete-auto-created-reservations to enable and
--no-auto-delete-auto-created-reservations to disable.
--deployment-type=DEPLOYMENT_TYPE
Indicates if the reservation allocation strategy is static or dynamic.
DENSE refers to a fixed size and topology, with deployment expressed in
terms of blocks. FLEXIBLE indicates a non-static distribution of
capacity that can change over time. Deployment is not expressed in
blocks. DEPLOYMENT_TYPE must be one of: DENSE, FLEXIBLE.
--description=DESCRIPTION
An optional description of the future reservation to create.
--enable-opportunistic-maintenance=ENABLE_OPPORTUNISTIC_MAINTENANCE
Indicates if this group of VMs have opportunistic maintenance enabled.
Applicable only to dense coordinated maintenance.
--instance-termination-action=INSTANCE_TERMINATION_ACTION
Specific termination action for running instances at the end of
reservation duration, it can be DELETE or STOP.
INSTANCE_TERMINATION_ACTION must be one of: DELETE, STOP.
--planning-status=PLANNING_STATUS
The planning status of the future reservation. The default value is
DRAFT. While in DRAFT, any changes to the future reservation's
@ -70,6 +93,18 @@ FLAGS
the name of the future reservation. Use --require-specific-reservation
to enable and --no-require-specific-reservation to disable.
--reservation-name=RESERVATION_NAME
Name of reservations where the capacity is provisioned at the time of
delivery of future reservations. If the reservation with the given name
does not exist already, it is created automatically at the time of
Approval with INACTIVE state till specified start-time. Either provide
the reservation_name or a name_prefix.
--scheduling-type=SCHEDULING_TYPE
Indicates the maintenance type for this group of VMs. This will be set
on the reservation via FR, and will be inherited for reservation
blocks. SCHEDULING_TYPE must be one of: GROUPED, INDEPENDENT.
--total-count=TOTAL_COUNT
The total number of instances for which capacity assurance is requested
at a future time period.
@ -145,6 +180,28 @@ FLAGS
list of projects that this future reservation is shared with. The
list must contain project IDs or project numbers.
Manage the commitment info properties
--commitment-name=COMMITMENT_NAME
Name of commitment covering the delivered reservation at the time of
delivery of future reservations. If not specified, it takes the name
of the future reservation.
--commitment-plan=COMMITMENT_PLAN
The plan for this commitment to be created, which determines duration
and discount rate. The currently supported plans are TWELVE_MONTH (1
year), and THIRTY_SIX_MONTH (3 years). COMMITMENT_PLAN must be one
of: TWELVE_MONTH, THIRTY_SIX_MONTH.
--previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS
Applicable only if future reservation will deliver to an existing
reservation with a ramp plan. When set to EXTEND, all associated
parent Committed Used Discount's end-date/term will be extended to
the end-time of this future reservation. Default is to extend
previous commitment's time to the end_time of the reservation.
PREVIOUS_COMMITMENT_TERMS must be (only one value is supported):
EXTEND.
Manage the specific SKU reservation properties.
--machine-type=MACHINE_TYPE
@ -248,7 +305,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 future-reservations update
$ gcloud beta compute future-reservations update

5
gcloud/alpha/compute/resource-policies/update/instance-schedule
View file

@ -17,10 +17,7 @@ EXAMPLES
$ gcloud alpha compute resource-policies update instance-schedule \
NAME --region=REGION --timezone=UTC \
--vm-start-schedule="* 7 * * *" \
--vm-stop-schedule="* 17 * * *" \
--initiation-date=2025-05-01T00:00:00.000-07:00 \
--end-date=2027-05-01T00:00:00.000-07:00
--vm-start-schedule="0 7 * * *" --vm-stop-schedule="0 17 * * *"
POSITIONAL ARGUMENTS
NAME