Method: projects.locations.collections.engines.create
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*}/engines
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The parent resource name, such as projects/{project}/locations/{location}/collections/{collection}.
|
Query parameters
| Parameters |
engineId |
string
Required. The ID to use for the Engine, which will become the final component of the Engine's resource name. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
|
Request body
The request body contains an instance of Engine.
Response body
If successful, the response body contains a newly created instance of Operation.
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.engines.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 page details the process of creating a new Engine resource using a POST request to a specific URL endpoint."],["The URL requires the `parent` path parameter, representing the parent resource name in the format `projects/*/locations/*/collections/*`."],["The request must include the `engineId` query parameter, which specifies the unique ID for the new Engine, adhering to RFC-1034 standards and a 63-character limit."],["A request body containing an instance of the Engine resource is required, while a successful response will include an instance of an Operation resource."],["Creating an Engine necessitates the `discoveryengine.engines.create` IAM permission on the `parent` resource and requires the `https://www.googleapis.com/auth/cloud-platform` OAuth scope for authorization."]]],[]]
