Method: projects.locations.capacityCommitments.create

Creates a new capacity commitment resource.

HTTP request

POST https://bigqueryreservation.googleapis.com/v1/{parent=projects/*/locations/*}/capacityCommitments

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of the parent reservation. E.g., projects/myproject/locations/US

Authorization requires the following IAM permission on the specified resource parent:

  • bigquery.capacityCommitments.create

Query parameters

Parameters
enforceSingleAdminProjectPerOrg

boolean

If true, fail the request if another project in the organization has a capacity commitment.

capacityCommitmentId

string

The optional capacity commitment ID. Capacity commitment name will be generated automatically if this field is empty. This field must only contain lower case alphanumeric characters or dashes. The first and last character cannot be a dash. Max length is 64 characters. NOTE: this ID won't be kept if the capacity commitment is split or merged.

Request body

The request body contains an instance of CapacityCommitment.

Response body

If successful, the response body contains a newly created instance of CapacityCommitment.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.