Upgrade the term of commitments

Stay organized with collections Save and categorize content based on your preferences.

You can upgrade the term of your 1-year commitments and convert them into 3-year commitments to get a higher discount rate for your committed resources and continue receiving the discounts for a longer time period.

This document shows you how to upgrade the term of your commitment from 1 year to 3 years.

Limitations

  • You can upgrade the term for only active commitments.
  • You can't upgrade the term for software license commitments.
  • You can't upgrade the term for your commitments that have nvidia-tesla-k80 GPUs as commitments for these GPUs are available only as 1-year commitments.

How a term upgrade works

When you upgrade the term for your commitment, the expiration date of the commitment moves into the future by two years. The upgraded commitment term becomes valid at 12 AM US and Canadian Pacific Time (UTC-8 or UTC-7) on the day following the upgrade operation and you begin to receive the new discount percentage that is applicable for your upgraded term.

Upgrading the term doesn't affect the other properties of your commitment. The following commitment properties remain the same after the upgrade operation:

  • Name
  • Start date
  • Region
  • Project
  • Commitment type
  • Auto renew status
  • Committed resources

Any attached reservations for your commitment continue to exist throughout the lifetime of your upgraded term, unless you manually replace them.

The following table shows an example where the term of an existing commitment (commitment-1) gets upgraded by 2 years:

Commitment property Before term upgrade After term upgrade
Name commitment-1 commitment-1
Type N2 N2
Region us-central-1 us-central-1
Project example-project-1 example-project-1
Resources
  • vCPUs: 200
  • Memory: 200 GB
  • vCPUs: 200
  • Memory: 200 GB
Term 1 year 3 years
Start date January 1, 2020 January 1, 2020
End date January 1, 2021 January 1, 2023
Auto-renew status Disabled Disabled

Quota considerations during a term upgrade

You don't typically need to request additional quota when you upgrade your commitment's term. However, if you upgrade a commitment's term on the same day that it expires, you must verify that you still have sufficient quota available. That's because on the day that a commitment expires, whatever quota the commitment was using up gets released back into your pool of available quota, and it might get used up by your other business needs.

Perform a term upgrade

Upgrade your commitment's term by using the gcloud CLI, Google Cloud console, or the Compute Engine API.

Console

  1. In the Google Cloud console, select the project where you want to upgrade your commitment's term, and go to the Committed use discounts page.

    Go to Committed use discounts

  2. To initiate the term upgrade operation for a commitment, select an active hardware commitment in the Hardware commitments tab of the Commitment list page and click Upgrade.

    • Optionally, you can click the desired active commitment's name and then, on the Hardware commitment details page, click Upgrade.
  3. On the Upgrade committed use discount pane, verify the New end time of your modified commitment and click Upgrade.

  4. To finish the term upgrade operation, review the terms and conditions in the Upgrade your commitment? dialog and click Upgrade.

gcloud

To upgrade your commitment's term, use the gcloud compute commitments update command command with the --plan flag.

gcloud compute commitments update COMMITMENT_NAME \
    --plan=36-month \
    --region=REGION \
    --project=PROJECT_NAME

Replace the following:

  • COMMITMENT_NAME: the name of the commitment whose term you want to upgrade.
  • REGION: the region of your commitment whose term you want to upgrade.
  • PROJECT_NAME: the name of the project for which you want to upgrade the commitment.

For example, consider a 1-year commitment, commitment-upgrade-example, in us-central1 region and for the project project-upgrade-example. The following gcloud CLI command upgrades the commitment's term and modifies it into a 3-year commitment.

gcloud compute commitments update commitment-upgrade-example \
    --plan=36-month \
    --region=us-central1 \
    --project=project-upgrade-example

API

To upgrade your commitment's term, use the regionCommitments.update method.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
{
  "name": COMMITMENT_NAME,
  "plan": "THIRTY_SIX_MONTH",
}

Replace the following:

  • PROJECT_ID: the project ID of the project where you want to upgrade your commitment's term.
  • REGION: the region of the commitment whose term you want to upgrade.
  • COMMITMENT_NAME: the name of the commitment whose term you want to upgrade.

For example, consider a 1-year commitment, commitment-upgrade-example in us-central1 region and for the project project-upgrade-example. The following Compute Engine API request upgrades the commitment's term and modifies it into a 3-year commitment.

PATCH https://compute.googleapis.com/compute/v1/projects/project-upgrade-example/regions/us-central1/commitments/commitment-upgrade-example
{
  "name": "commitment-upgrade-example",
  "plan": "THIRTY_SIX_MONTH",
}

What's next