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/v1/{parent=projects/*/locations/*/collections/*/engines/*}/controls
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]-_/.
[[["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-06-27 UTC."],[[["\u003cp\u003eThis document describes how to create a Control, with a default limit of 1000 controls per data store, which can be adjusted upon request.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for creating a Control is a \u003ccode\u003ePOST\u003c/code\u003e operation to a specified URL, using gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter, which is mandatory, specifies the full resource name of the data store, and the \u003ccode\u003econtrolId\u003c/code\u003e query parameter must be a string of between 1 and 63 valid characters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires an instance of a Control, and a successful response will include the newly created instance of a Control.\u003c/p\u003e\n"],["\u003cp\u003eCreating a Control requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003ediscoveryengine.controls.create\u003c/code\u003e IAM permission on the parent resource.\u003c/p\u003e\n"]]],[],null,[]]
