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/bigqueryhttps://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["\u003cp\u003eThis endpoint creates a new capacity commitment resource within a specified project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe request is a \u003ccode\u003ePOST\u003c/code\u003e request to the provided URL, utilizing gRPC Transcoding syntax with a required \u003ccode\u003eparent\u003c/code\u003e path parameter indicating the resource location.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters include \u003ccode\u003eenforceSingleAdminProjectPerOrg\u003c/code\u003e for organization-wide capacity commitment checks and \u003ccode\u003ecapacityCommitmentId\u003c/code\u003e to set a custom ID for the commitment.\u003c/p\u003e\n"],["\u003cp\u003eThe request and response bodies both use the \u003ccode\u003eCapacityCommitment\u003c/code\u003e resource definition, and creating the commitment requires specific IAM permissions.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this request requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],[],null,[]]
