You can upgrade 1-year commitments to convert them into 3-year commitments.When you upgrade a commitment, Compute Engine changes its plan from1-year to 3-year, which lets you get a higher discount rate for your committedresources and continue receiving committed use discounts (CUDs) for a longertime period.

This document explains how commitment upgrades work and provides steps toupgrade your 1-year commitments to 3-year commitments.

How commitment upgrades work

When you upgrade a 1-year commitment, Compute Engine changes itsplan from 1-year to 3-year and moves the expiration date of itsongoingterm (the term that is active when you request the upgrade) two years into thefuture. The upgrade becomes valid at 12 AM US and Canadian Pacific Time(UTC-8, or UTC-7 during daylight saving time) on the day following the upgradeoperation, and you begin to receive the new CUD rate that is applicable for3-year commitments.

Upgrading a commitment changes theterm extension eligibility windowfor your commitment. After the upgrade takes effect, Compute Engineupdates the eligibility window to remain open for up to one year from the startdate of the ongoing term. When you upgrade a commitment, the followingproperties of the commitment don't change:

• Name
• Start date
• Region
• Project
• Commitment type
• Auto-renewal setting
• Committed resources

The commitment upgrade process 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 of a 1-year commitment (commitment-1)with a 1-year term, which is upgraded from a 1-year to a 3-year plan:

Quota considerations

You don't typically need to request additional quota when you upgrade acommitment. However, if you upgrade a commitment 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 a commitment, Compute Engineapplies the new 3-year CUD rate 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.

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

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

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

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 toanalyze the effectiveness of your CUDs.
• Learn how torenew commitments automatically.
• Learn how toextend the term length of resource-based commitments.
• Learn how tomerge and split resource-based commitments.