Upgrade the term of commitments
You can upgrade the term of your 1-year commitments and convert them into3-year commitments to get a higher discount rate for your committed resourcesand continue receiving committed use discounts (CUDs) for a longer time period.
This document shows you how to upgrade the term of your commitment from 1 yearto 3 years.
How a term upgrade works
When you upgrade the term for your commitment, the expiration date of thecommitment moves into the future by two years. The upgraded commitment termbecomes valid at 12 AM US and Canadian Pacific Time (UTC-8, or UTC-7 duringdaylight saving time) on the day following the upgrade operation, and you beginto receive the new CUD percentage that is applicable for your upgradedterm.
Upgrading your commitment's term changes theterm extension eligibility windowfor your commitment. After the term upgrade takes effect, Compute Engineupdates the eligibility window to remain open up to 1 year from the start dateof the ongoing term. Upgrading the term doesn't affect the following propertiesof your commitment:
- Name
- Start date
- Region
- Project
- Commitment type
- Auto renew status
- Committed resources
The process of term upgrade remains the same regardless of whether yourcommitment has a preset term length or a custom term length. Any attachedreservations for your commitment continue to exist throughout thelifetime of your upgraded term, unless you manually replace them.
Example of an upgraded commitment
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 |
|
|
| Term | 1 year | 3 years |
| Start date* | January 1, 2020 | January 1, 2020 |
| End date† | January 1, 2021 | January 1, 2023 |
| Term extension eligibility window open until | May 1, 2020 | January 1, 2021 |
| Auto-renew status | Disabled | Disabled |
*Commitment starts at 12 AM US and Canadian Pacific Time(UTC-8 or UTC-7) on the specified start date.†Commitment ends at 12 AM US and Canadian Pacific Time(UTC-8 or UTC-7) on the specified end date.
Quota considerations
You don't typically need to request additional quota when you upgrade yourcommitment's term. However, if you upgrade a commitment's term on the same daythat it expires, you mustverifythat you still have sufficient quota available. That's because on the day that acommitment expires, whatever quota the commitment was using up gets releasedback into your pool of available quota, and it might get used up by your otherbusiness needs.
Pricing implications
Your commitment fee is the sum of the discounted prices of all your committedresources. When you upgrade your commitment's term, Compute Engineapplies the new 3-year CUD percentage and recalculates the discounted price foreach committed resource. To do this recalculation, Compute Engine usesthe prevailing on-demand price of each resource on the day your original termbecame active. This new discounted price for each resource stays the same untilthe end of your upgraded term, even if the on-demand prices change.
Note: If you merge or split your commitments, then the discounted prices foryour committed resources might change on the day your merged or splitcommitments become active.Limitations
- You can upgrade the term for only active commitments.
- You can't upgrade the term for software license commitments.
Perform a term upgrade
Upgrade your commitment's term by using the gcloud CLI,Google Cloud console, or the Compute Engine API.
Note: If you are using the gcloud CLI or the Compute Engine APIto upgrade a commitment's term and also want toenable auto renewon that commitment, then you must do so using two separate operations. You canperform these two operations at the same time using the Google Cloud console,but on the gcloud CLI or the Compute Engine API, you mustenable auto renew either before or after you upgrade the commitment's term.Permissions required for this task
To perform this task, you must have the followingpermissions:
compute.commitments.updateon the project or organization.
Console
In the Google Cloud console, select the project where you want toupgrade your commitment's term, and go to theCommitted use discountspage.
To initiate the term upgrade operation for a commitment, select an activehardware commitment in theHardware commitments tab of theCommitment list page and clickUpgrade.
- Alternatively, you can click the name of the active commitment that youwant to upgrade. After theHardware commitment details page opens,clickUpgrade.
In theUpgrade committed use discount pane that appears, verify theNew end time of your modified commitment and clickUpgrade.
To finish the term upgrade operation and return to theCommitment listpage, in theUpgrade your commitment? dialogue that appears, reviewthe terms and conditions and then clickUpgrade.
gcloud
To upgrade your commitment's term, use thegcloud compute commitments update commandcommand with the--plan flag.
gcloud compute commitments updateCOMMITMENT_NAME \--plan=36-month \ --region=REGION \ --project=PROJECT_NAME
Replace the following:
COMMITMENT_NAME: the name of the commitment whoseterm you want to upgrade.REGION: the region of your commitment whose termyou want to upgrade.PROJECT_NAME: the name of the project for whichyou want to upgrade the commitment.
For example, consider a 1-year commitment,commitment-upgrade-example, inus-central1 region and for the projectproject-upgrade-example. Thefollowing gcloud CLI command upgrades the commitment's term andmodifies it into a 3-year commitment.
gcloud compute commitments update commitment-upgrade-example \ --plan=36-month \ --region=us-central1 \ --project=project-upgrade-example
REST
To upgrade your commitment's term, use theregionCommitments.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 whereyou want to upgrade your commitment's term.REGION: the region of the commitment whose termyou want to upgrade.COMMITMENT_NAME: the name of the commitment whoseterm you want to upgrade.
For example, consider a 1-year commitment,commitment-upgrade-example inus-central1 region and for the projectproject-upgrade-example. Thefollowing Compute Engine API request upgrades the commitment's termand 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
- Learn how torenew commitments automatically.
- Learn how toextend the term length of resource-based commitments.
- Learn how tomerge and split resource-based commitments.
- Learn how toanalyze the effectiveness of your CUDs.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-15 UTC.