GOgoogle
projects

POST /v1/projects/{projectsId}/locations/{locationsId}:upgradeEdition

Changed on

Upgrades the edition for a list of reservations and capacity commitments. You can only upgrade to a higher edition (from STANDARD to ENTERPRISE or ENTERPRISE_PLUS, from ENTERPRISE to ENTERPRISE_PLUS, or from EDITION_UNSPECIFIED to ENTERPRISE or ENTERPRISE_PLUS). You can't downgrade an edition. The upgrade must not cause an overall flexible slot increase across the original and target editions (for example, by upgrading a reservation without upgrading its corresponding capacity commitment). Otherwise, the method fails with a google.rpc.Code.FAILED_PRECONDITION error. Before the upgrade, the service validates that the resources meet the requirements of the target edition (for example, all reservations within a reservation group must be upgraded together).

Request

  • Base URL
    https://bigqueryreservation.googleapis.com
  • URL
    https://bigqueryreservation.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}:upgradeEdition
  • Auth
    • OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/bigquery
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/bigquery
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/cloud-platform
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/cloud-platform

Path parameters

projectsIdstring required
locationsIdstring required

Request body

capacityCommitmentsstring[]

Optional. The resource names of the capacity commitments to upgrade, in the format projects/{project}/locations/{location}/capacityCommitments/{capacity_commitment}. For example, projects/myproject/locations/us-west1/capacityCommitments/123. These capacity commitments must be in the ACTIVE state and must exist under the specified parent. The commitment_start_time and commitment_end_time fields don't change after the upgrade.

reservationsstring[]

Optional. The resource names of the reservations to upgrade, in the format projects/{project}/locations/{location}/reservations/{reservation}. For example, projects/myproject/locations/us-west1/reservations/team1-prod. These reservations must exist under the specified parent.

targetEdition'EDITION_UNSPECIFIED' | 'STANDARD' | 'ENTERPRISE' | 'ENTERPRISE_PLUS'

The edition to upgrade the capacity commitments and reservations to. Supported values are ENTERPRISE and ENTERPRISE_PLUS.

Response

Successful response

Changes