Method: projects.locations.dataStores.controls.create
Stay organized with collections
Save and categorize content based on your preferences.
Creates a Control.
By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
HTTP request
POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/dataStores/*}/controls
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. Full resource name of parent data store. Format: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} or projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}.
|
Query parameters
| Parameters |
controlId |
string
Required. The ID to use for the Control, which will become the final component of the Control's resource name. This value must be within 1-63 characters. Valid characters are /[a-z][0-9]-_/.
|
Request body
The request body contains an instance of Control.
Response body
If successful, the response body contains a newly created instance of Control.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the parent resource:
discoveryengine.controls.create
For more information, see the IAM documentation.
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-03-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-03 UTC."],[[["This API call is used to create a new Control within a specified data store, with a default limit of 1000 controls per data store, and the ability to request an adjustment to this limit."],["The HTTP request utilizes the `POST` method to the specified URL pattern `https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/dataStores/*}/controls`, following gRPC Transcoding syntax."],["Required path parameters include the `parent` data store resource name, and query parameters include `controlId` which is a unique identifier for the control."],["Successful requests return a newly created instance of a `Control` in the response body, and requires `discoveryengine.controls.create` IAM permission on the parent resource and the OAuth scope `https://www.googleapis.com/auth/cloud-platform`."],["The request body must include the definition for a new `Control` instance, and if the `Control` already exists, the API will return an `ALREADY_EXISTS` error."]]],[]]
