This preview documentation is deprecated as of October 27, 2023. For GA documentation, go to the Vertex AI Search documentation.

Changes in GA:

Name: Discovery for Media is renamed to Vertex AI Search for media. Vertex AI Search includes media recommendations and media search.
Google Cloud Console page: Use the Agent Builder page in the console. The Discovery Engine console page is deprecated.
API reference: Continue to use the discoveryengine.googleapis.com service. The API remains the same but the documentation has moved. Go to the up-to-date, GA version of the Discovery Engine API reference in the Vertex AI Search documentation.
All changes: To see what else changed between preview and GA, see Switch from Discovery for Media to media recommendations in the Vertex AI Search documentation.

Method: projects.locations.dataStores.schemas.patch

HTTP request
Path parameters
Query parameters
Request body
Response body
Authorization scopes
IAM Permissions
Try it!

Updates a Schema.

HTTP request

PATCH https://discoveryengine.googleapis.com/v1alpha/{schema.name=projects/*/locations/*/dataStores/*/schemas/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`schema.name`	`string` Immutable. The full resource name of the schema, in the format of `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/schemas/{schema}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.

schema.name

string

Immutable. The full resource name of the schema, in the format of projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/schemas/{schema}.

This field must be a UTF-8 encoded string with a length limit of 1024 characters.

Query parameters

Parameters

Parameters
`allowMissing`	`boolean` If set to true, and the `Schema` is not found, a new `Schema` will be created. In this situation, `updateMask` is ignored.

allowMissing

boolean

If set to true, and the Schema is not found, a new Schema will be created. In this situation, updateMask is ignored.

Request body

The request body contains an instance of Schema.

Response body

If successful, the response body contains an 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 name resource:

discoveryengine.schemas.update

For more information, see the IAM documentation.