gcloud preview compute commitments update

NAME

gcloud preview compute commitments update - update Compute Engine commitments

SYNOPSIS

gcloud preview compute commitments update COMMITMENT [--auto-renew] [--custom-end-time=CUSTOM_END_TIME] [--plan=PLAN] [--region=REGION] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(PREVIEW) Update Compute Engine commitments.

EXAMPLES

To enable auto renewal on a commitment called commitment-1 in the us-central1 region, run:

gcloud preview compute commitments update commitment-1 --auto-renew --region=us-central1

To disable auto renewal on a commitment called commitment-1 in the us-central1 region, run:

gcloud preview compute commitments update commitment-1 --no-auto-renew --region=us-central1

To upgrade the term of a commitment called commitment-1 from 12-month to 36-month, in the us-central1 region, run:

gcloud preview compute commitments update commitment-1 --plan=36-month --region=us-central1

POSITIONAL ARGUMENTS

COMMITMENT

Name of the commitment to update.

FLAGS

--auto-renew

Enable auto renewal for the commitment.

--custom-end-time=CUSTOM_END_TIME

Specifies a custom future end date and extends the commitment's ongoing term.

--plan=PLAN

Duration of the commitment. PLAN must be (only one value is supported): 36-month.

--region=REGION

Region of the commitment to update. If not specified, you might be prompted to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/region property:

gcloud config set compute/region REGION

A list of regions can be fetched by running:

gcloud compute regions list

To unset the property, run:

gcloud config unset compute/region

Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION.

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 DEVELOPER PREVIEW and may 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 commitments update

gcloud alpha compute commitments update

gcloud beta compute commitments update