{ "resources": { "publishers": { "resources": { "models": { "methods": { "generateContent": { "path": "v1beta1/{+model}:generateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.publishers.models.generateContent", "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "description": "Generate content with multimodal inputs.", "parameters": { "model": { "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^publishers/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "model" ], "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:generateContent" }, "fetchPredictOperation": { "description": "Fetch an asynchronous online prediction operation.", "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:fetchPredictOperation", "parameters": { "endpoint": { "pattern": "^publishers/[^/]+/models/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.publishers.models.fetchPredictOperation", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+endpoint}:fetchPredictOperation", "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest" } }, "get": { "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}", "parameters": { "isHuggingFaceModel": { "description": "Optional. Boolean indicates whether the requested model is a Hugging Face model.", "type": "boolean", "location": "query" }, "name": { "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}`", "location": "path", "required": true, "pattern": "^publishers/[^/]+/models/[^/]+$", "type": "string" }, "languageCode": { "type": "string", "description": "Optional. The IETF BCP-47 language code representing the language in which the publisher model's text information should be written in.", "location": "query" }, "includeEquivalentModelGardenModelDeploymentConfigs": { "type": "boolean", "description": "Optional. Whether to cnclude the deployment configs from the equivalent Model Garden model if the requested model is a Hugging Face model.", "location": "query" }, "huggingFaceToken": { "location": "query", "type": "string", "description": "Optional. Token used to access Hugging Face gated models." }, "view": { "type": "string", "enum": [ "PUBLISHER_MODEL_VIEW_UNSPECIFIED", "PUBLISHER_MODEL_VIEW_BASIC", "PUBLISHER_MODEL_VIEW_FULL", "PUBLISHER_MODEL_VERSION_VIEW_BASIC" ], "description": "Optional. PublisherModel view specifying which fields to read.", "location": "query", "enumDescriptions": [ "The default / unset value. The API will default to the BASIC view.", "Include basic metadata about the publisher model, but not the full contents.", "Include everything.", "Include: VersionId, ModelVersionExternalName, and SupportedActions." ] } }, "id": "aiplatform.publishers.models.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModel" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a Model Garden publisher model.", "path": "v1beta1/{+name}" }, "computeTokens": { "parameterOrder": [ "endpoint" ], "description": "Return a list of tokens based on the input text.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.publishers.models.computeTokens", "path": "v1beta1/{+endpoint}:computeTokens", "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:computeTokens", "request": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensResponse" }, "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "type": "string", "pattern": "^publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to get lists of tokens and token ids." } } }, "predict": { "path": "v1beta1/{+endpoint}:predict", "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictRequest" }, "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:predict", "parameterOrder": [ "endpoint" ], "id": "aiplatform.publishers.models.predict", "httpMethod": "POST", "description": "", "parameters": { "endpoint": { "pattern": "^publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1PredictResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/models", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListPublisherModelsResponse" }, "parameters": { "orderBy": { "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending.", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListPublisherModelsResponse.next_page_token of the previous ModelGardenService.ListPublisherModels call." }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the Publisher from which to list the PublisherModels. Format: `publishers/{publisher}`", "pattern": "^publishers/[^/]+$" }, "listAllVersions": { "location": "query", "type": "boolean", "description": "Optional. List all publisher model versions if the flag is set to true." }, "filter": { "location": "query", "description": "Optional. The standard list filter.", "type": "string" }, "view": { "type": "string", "enumDescriptions": [ "The default / unset value. The API will default to the BASIC view.", "Include basic metadata about the publisher model, but not the full contents.", "Include everything.", "Include: VersionId, ModelVersionExternalName, and SupportedActions." ], "location": "query", "enum": [ "PUBLISHER_MODEL_VIEW_UNSPECIFIED", "PUBLISHER_MODEL_VIEW_BASIC", "PUBLISHER_MODEL_VIEW_FULL", "PUBLISHER_MODEL_VERSION_VIEW_BASIC" ], "description": "Optional. PublisherModel view specifying which fields to read." }, "languageCode": { "description": "Optional. The IETF BCP-47 language code representing the language in which the publisher models' text information should be written in. If not set, by default English (en).", "location": "query", "type": "string" }, "pageSize": { "description": "Optional. The standard list page size.", "type": "integer", "location": "query", "format": "int32" } }, "httpMethod": "GET", "id": "aiplatform.publishers.models.list", "description": "Lists publisher models in Model Garden.", "flatPath": "v1beta1/publishers/{publishersId}/models" }, "predictLongRunning": { "id": "aiplatform.publishers.models.predictLongRunning", "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictLongRunningRequest" }, "path": "v1beta1/{+endpoint}:predictLongRunning", "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:predictLongRunning", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string", "pattern": "^publishers/[^/]+/models/[^/]+$" } }, "parameterOrder": [ "endpoint" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "" }, "countTokens": { "response": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensResponse" }, "id": "aiplatform.publishers.models.countTokens", "description": "Perform a token counting.", "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^publishers/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensRequest" }, "parameterOrder": [ "endpoint" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:countTokens", "path": "v1beta1/{+endpoint}:countTokens" }, "streamGenerateContent": { "parameterOrder": [ "model" ], "id": "aiplatform.publishers.models.streamGenerateContent", "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "parameters": { "model": { "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^publishers/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "path": "v1beta1/{+model}:streamGenerateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Generate content with multimodal inputs with streaming support.", "flatPath": "v1beta1/publishers/{publishersId}/models/{modelsId}:streamGenerateContent" } } } } }, "projects": { "methods": { "getCacheConfig": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1CacheConfig" }, "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/cacheConfig$", "description": "Required. Name of the cache config. Format: - `projects/{project}/cacheConfig`.", "location": "path", "required": true } }, "id": "aiplatform.projects.getCacheConfig", "parameterOrder": [ "name" ], "description": "Gets a GenAI cache config.", "flatPath": "v1beta1/projects/{projectsId}/cacheConfig", "path": "v1beta1/{+name}" }, "updateCacheConfig": { "description": "Updates a cache config.", "request": { "$ref": "GoogleCloudAiplatformV1beta1CacheConfig" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.updateCacheConfig", "httpMethod": "PATCH", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Optional. The list of fields of `cache_config` to update. Supported paths are `disable_cache`, `retention_config` (and its subfields such as `retention_config.retention_type`), and the special value `*`; any other path returns `INVALID_ARGUMENT`. Fields not covered by the mask keep their stored value. If the mask is omitted, it is treated as an implied mask covering the fields populated in `cache_config`, so updating one field never clears another. `retention_config` is covered only when the request carries it. `disable_cache` is always covered: it is a bare `bool`, so the server cannot tell a request that omits it from one that sets it to `false`. `*` requests full replacement of the resource: every settable field is written from the request, clearing `retention_config` when the request omits it. It cannot be combined with other paths. Prefer naming fields explicitly -- a caller that sends `*` without knowing about a field added to `CacheConfig` later would silently reset that field." }, "name": { "description": "Identifier. Name of the cache config. Format: - `projects/{project}/cacheConfig`.", "pattern": "^projects/[^/]+/cacheConfig$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/cacheConfig", "path": "v1beta1/{+name}" }, "setPublisherModelConfig": { "parameterOrder": [ "name" ], "description": "Sets (creates or updates) configs of publisher models. For example, sets the request/response logging config.", "flatPath": "v1beta1/projects/{projectsId}:setPublisherModelConfig", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.setPublisherModelConfig", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+name}:setPublisherModelConfig", "parameters": { "name": { "pattern": "^projects/[^/]+$", "description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`.", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1SetPublisherModelConfigRequest" } }, "fetchPublisherModelConfig": { "description": "Fetches the configs of publisher models.", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`." } }, "flatPath": "v1beta1/projects/{projectsId}:fetchPublisherModelConfig", "response": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfig" }, "path": "v1beta1/{+name}:fetchPublisherModelConfig", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.fetchPublisherModelConfig" } }, "resources": { "locations": { "methods": { "askContexts": { "httpMethod": "POST", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location from which to retrieve RagContexts. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:askContexts", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.askContexts", "response": { "$ref": "GoogleCloudAiplatformV1beta1AskContextsResponse" }, "path": "v1beta1/{+parent}:askContexts", "description": "Agentic Retrieval Ask API for RAG.", "request": { "$ref": "GoogleCloudAiplatformV1beta1AskContextsRequest" } }, "augmentPrompt": { "request": { "$ref": "GoogleCloudAiplatformV1beta1AugmentPromptRequest" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.augmentPrompt", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:augmentPrompt", "description": "Given an input prompt, it returns augmented prompt from vertex rag store to guide LLM towards generating grounded responses.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+parent}:augmentPrompt", "response": { "$ref": "GoogleCloudAiplatformV1beta1AugmentPromptResponse" }, "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location from which to augment prompt. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`." } } }, "retrieveContexts": { "id": "aiplatform.projects.locations.retrieveContexts", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveContextsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:retrieveContexts", "path": "v1beta1/{+parent}:retrieveContexts", "description": "Retrieves relevant contexts for a query.", "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location from which to retrieve RagContexts. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveContextsRequest" }, "httpMethod": "POST" }, "corroborateContent": { "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1CorroborateContentRequest" }, "description": "Given an input text, it returns a score that evaluates the factuality of the text. It also extracts and returns claims from the text and provides supporting facts.", "response": { "$ref": "GoogleCloudAiplatformV1beta1CorroborateContentResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}:corroborateContent", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location from which to corroborate text. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`." } }, "id": "aiplatform.projects.locations.corroborateContent", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:corroborateContent" }, "generateSyntheticData": { "path": "v1beta1/{+location}:generateSyntheticData", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:generateSyntheticData", "description": "Generates synthetic (artificial) data based on a description", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateSyntheticDataResponse" }, "id": "aiplatform.projects.locations.generateSyntheticData", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "location" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateSyntheticDataRequest" }, "parameters": { "location": { "location": "path", "required": true, "description": "Required. The geographic location where the synthetic data generation request is processed. This should be in the format `projects/{project}/locations/{location}`. For example, `projects/my-project/locations/us-central1`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST" }, "getRagEngineConfig": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagEngineConfig" }, "description": "Gets a RagEngineConfig.", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the RagEngineConfig resource. Format: `projects/{project}/locations/{location}/ragEngineConfig`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig", "id": "aiplatform.projects.locations.getRagEngineConfig", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "generateLossClusters": { "httpMethod": "POST", "parameterOrder": [ "location" ], "parameters": { "location": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location. Format: `projects/{project}/locations/{location}`" } }, "id": "aiplatform.projects.locations.generateLossClusters", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateLossClustersRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:generateLossClusters", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Generates loss clusters from evaluation results. This is a statelss API method that would not modify the EvaluationSet resource.", "path": "v1beta1/{+location}:generateLossClusters" }, "generateUserScenarios": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "location" ], "path": "v1beta1/{+location}:generateUserScenarios", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:generateUserScenarios", "httpMethod": "POST", "description": "Generates user scenarios for agent evaluation.", "parameters": { "location": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location to run the job. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateUserScenariosRequest" }, "id": "aiplatform.projects.locations.generateUserScenarios", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateUserScenariosResponse" } }, "evaluateInstances": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateInstancesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:evaluateInstances", "parameters": { "location": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to evaluate the instances. Format: `projects/{project}/locations/{location}`" } }, "description": "Evaluates instances based on a given metric.", "httpMethod": "POST", "parameterOrder": [ "location" ], "path": "v1beta1/{+location}:evaluateInstances", "id": "aiplatform.projects.locations.evaluateInstances" }, "recommendSpec": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:recommendSpec", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponse" }, "id": "aiplatform.projects.locations.recommendSpec", "request": { "$ref": "GoogleCloudAiplatformV1beta1RecommendSpecRequest" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location from which to recommend specs. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.", "type": "string" } }, "path": "v1beta1/{+parent}:recommendSpec", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a Model's spec recommendations. This API is called by UI, SDK, and internal." }, "list": { "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+$", "description": "The resource that owns the locations collection, if applicable." }, "extraLocationTypes": { "repeated": true, "type": "string", "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page." }, "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of results to return. If not set, the service selects a default." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/locations", "response": { "$ref": "GoogleCloudLocationListLocationsResponse" }, "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "id": "aiplatform.projects.locations.list", "flatPath": "v1beta1/projects/{projectsId}/locations" }, "deployPublisherModel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:deployPublisherModel", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+destination}:deployPublisherModel", "deprecated": true, "parameters": { "destination": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to deploy the model in. Format: `projects/{project}/locations/{location}`" } }, "description": "Deploys publisher models.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest" }, "id": "aiplatform.projects.locations.deployPublisherModel", "parameterOrder": [ "destination" ] }, "updateRagEngineConfig": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The name of the RagEngineConfig. Format: `projects/{project}/locations/{location}/ragEngineConfig`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig$" } }, "description": "Updates a RagEngineConfig.", "id": "aiplatform.projects.locations.updateRagEngineConfig", "request": { "$ref": "GoogleCloudAiplatformV1beta1RagEngineConfig" }, "parameterOrder": [ "name" ] }, "generateInstanceRubrics": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:generateInstanceRubrics", "id": "aiplatform.projects.locations.generateInstanceRubrics", "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "location": { "description": "Required. The resource name of the Location to generate rubrics from. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "parameterOrder": [ "location" ], "path": "v1beta1/{+location}:generateInstanceRubrics", "description": "Generates rubrics for a given prompt. A rubric represents a single testable criterion for evaluation. One input prompt could have multiple rubrics This RPC allows users to get suggested rubrics based on provided prompt, which can then be reviewed and used for subsequent evaluations." }, "updateSemanticGovernancePolicyEngine": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicyEngine", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyEngine" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameters": { "updateMask": { "type": "string", "format": "google-fieldmask", "location": "query", "description": "Optional. Specifies the fields to be overwritten in the SemanticGovernancePolicyEngine resource by the update. The fields specified in the update_mask are relative to the resource itself. If no update_mask is provided, all fields are overwritten." }, "name": { "location": "path", "required": true, "type": "string", "description": "Identifier. The resource name of the SemanticGovernancePolicyEngine. Format: projects/{project}/locations/{location}/semanticGovernancePolicyEngine", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicyEngine$" } }, "description": "Updates a SemanticGovernancePolicyEngine. This method performs an upsert operation. If the SemanticGovernancePolicyEngine resource does not exist, it will be created. Otherwise, it will be updated.", "id": "aiplatform.projects.locations.updateSemanticGovernancePolicyEngine", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "deploy": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.deploy", "description": "Deploys a model to a new endpoint.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:deploy", "parameterOrder": [ "destination" ], "path": "v1beta1/{+destination}:deploy", "httpMethod": "POST", "parameters": { "destination": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to deploy the model in. Format: `projects/{project}/locations/{location}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployRequest" } }, "asyncRetrieveContexts": { "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location from which to retrieve RagContexts. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`." } }, "httpMethod": "POST", "description": "Asynchronous API to retrieves relevant contexts for a query.", "path": "v1beta1/{+parent}:asyncRetrieveContexts", "id": "aiplatform.projects.locations.asyncRetrieveContexts", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AsyncRetrieveContextsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:asyncRetrieveContexts" }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Resource name for the location.", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleCloudLocationLocation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}", "description": "Gets information about a location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.get" }, "getSemanticGovernancePolicyEngine": { "description": "Gets a SemanticGovernancePolicyEngine. A SemanticGovernancePolicyEngine is a singleton resource that is created when its parent is created, and deleted when its parent is deleted. This method retrieves the current state of the Semantic Governance Policy Engine.", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicyEngine$", "location": "path", "required": true, "description": "Required. The resource name of the SemanticGovernancePolicyEngine to retrieve. Format: projects/{project}/locations/{location}/semanticGovernancePolicyEngine" } }, "id": "aiplatform.projects.locations.getSemanticGovernancePolicyEngine", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyEngine" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicyEngine" }, "evaluateDataset": { "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:evaluateDataset", "parameters": { "location": { "description": "Required. The resource name of the Location to evaluate the dataset. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+location}:evaluateDataset", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateDatasetRequest" }, "parameterOrder": [ "location" ], "id": "aiplatform.projects.locations.evaluateDataset", "description": "Evaluates a dataset based on a set of given metrics." } }, "resources": { "schedules": { "methods": { "list": { "path": "v1beta1/{+parent}/schedules", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSchedulesResponse" }, "id": "aiplatform.projects.locations.schedules.list", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules", "description": "Lists Schedules in a Location.", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token. Typically obtained via ListSchedulesResponse.next_page_token of the previous ScheduleService.ListSchedules call." }, "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size. Default to 100 if not specified.", "type": "integer" }, "orderBy": { "type": "string", "description": "A comma-separated list of fields to order by. The default sort order is in ascending order. Use \"desc\" after a field name for descending. You can have multiple order_by fields provided. For example, using \"create_time desc, end_time\" will order results by create time in descending order, and if there are multiple schedules having the same create time, order them by the end time in ascending order. If order_by is not specified, it will order by default with create_time in descending order. Supported fields: * `create_time` * `start_time` * `end_time` * `next_run_time`", "location": "query" }, "filter": { "description": "Lists the Schedules that match the filter expression. The following fields are supported: * `display_name`: Supports `=`, `!=` comparisons, and `:` wildcard. * `state`: Supports `=` and `!=` comparisons. * `request`: Supports existence of the check. (e.g. `create_pipeline_job_request:*` --\u003e Schedule has create_pipeline_job_request). * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `start_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `end_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, `\u003e=` comparisons and `:*` existence check. Values must be in RFC 3339 format. * `next_run_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. Filter expressions can be combined together using logical operators (`NOT`, `AND` & `OR`). The syntax to define filter expression is based on https://google.aip.dev/160. Examples: * `state=\"ACTIVE\" AND display_name:\"my_schedule_*\"` * `NOT display_name=\"my_schedule\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `end_time\u003e\"2021-05-18T00:00:00Z\" OR NOT end_time:*` * `create_pipeline_job_request:*`", "type": "string", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to list the Schedules from. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "GET" }, "get": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}", "description": "Gets a Schedule.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.schedules.get", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the Schedule resource. Format: `projects/{project}/locations/{location}/schedules/{schedule}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$" } } }, "resume": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ResumeScheduleRequest" }, "id": "aiplatform.projects.locations.schedules.resume", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Resumes a paused Schedule to start scheduling new runs. Will mark Schedule.state to 'ACTIVE'. Only paused Schedule can be resumed. When the Schedule is resumed, new runs will be scheduled starting from the next execution time after the current time based on the time_specification in the Schedule. If Schedule.catch_up is set up true, all missed runs will be scheduled for backfill first.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:resume", "parameterOrder": [ "name" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}:resume", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$", "description": "Required. The name of the Schedule resource to be resumed. Format: `projects/{project}/locations/{location}/schedules/{schedule}`" } } }, "delete": { "httpMethod": "DELETE", "id": "aiplatform.projects.locations.schedules.delete", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the Schedule resource to be deleted. Format: `projects/{project}/locations/{location}/schedules/{schedule}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a Schedule.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}", "response": { "$ref": "GoogleLongrunningOperation" } }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "description": "Updates an active or paused Schedule. When the Schedule is updated, new runs will be scheduled starting from the updated next execution time after the update time based on the time_specification in the updated Schedule. All unstarted runs before the update time will be skipped while already created runs will NOT be paused or canceled.", "id": "aiplatform.projects.locations.schedules.patch", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$", "description": "Immutable. The resource name of the Schedule." }, "updateMask": { "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", "format": "google-fieldmask", "type": "string", "location": "query" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.schedules.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules", "response": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "httpMethod": "POST", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the Schedule in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true } }, "parameterOrder": [ "parent" ], "description": "Creates a Schedule.", "request": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "path": "v1beta1/{+parent}/schedules" }, "pause": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PauseScheduleRequest" }, "path": "v1beta1/{+name}:pause", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$", "description": "Required. The name of the Schedule resource to be paused. Format: `projects/{project}/locations/{location}/schedules/{schedule}`", "type": "string" } }, "description": "Pauses a Schedule. Will mark Schedule.state to 'PAUSED'. If the schedule is paused, no new runs will be created. Already created runs will NOT be paused or canceled.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}:pause", "id": "aiplatform.projects.locations.schedules.pause", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" } } }, "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.schedules.operations.cancel", "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.projects.locations.schedules.operations.list", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The standard list page size." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}/operations/{operationsId}:wait", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "format": "google-duration", "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.projects.locations.schedules.operations.wait", "path": "v1beta1/{+name}:wait" }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.schedules.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/schedules/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/schedules/{schedulesId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.schedules.operations.delete" } } } } }, "modelDeploymentMonitoringJobs": { "methods": { "list": { "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.list", "path": "v1beta1/{+parent}/modelDeploymentMonitoringJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelDeploymentMonitoringJobsResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs", "description": "Lists ModelDeploymentMonitoringJobs in a Location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent of the ModelDeploymentMonitoringJob. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "The standard list page size.", "location": "query" }, "readMask": { "location": "query", "type": "string", "description": "Mask specifying which fields to read", "format": "google-fieldmask" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "type": "string", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`", "location": "query" } }, "httpMethod": "GET" }, "resume": { "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ModelDeploymentMonitoringJob to resume. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`" } }, "description": "Resumes a paused ModelDeploymentMonitoringJob. It will start to run from next scheduled time. A deleted ModelDeploymentMonitoringJob can't be resumed.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}:resume", "request": { "$ref": "GoogleCloudAiplatformV1beta1ResumeModelDeploymentMonitoringJobRequest" }, "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.resume", "path": "v1beta1/{+name}:resume", "response": { "$ref": "GoogleProtobufEmpty" } }, "searchModelDeploymentMonitoringStatsAnomalies": { "path": "v1beta1/{+modelDeploymentMonitoringJob}:searchModelDeploymentMonitoringStatsAnomalies", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}:searchModelDeploymentMonitoringStatsAnomalies", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.searchModelDeploymentMonitoringStatsAnomalies", "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesResponse" }, "parameterOrder": [ "modelDeploymentMonitoringJob" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Searches Model Monitoring Statistics generated within a given time window.", "httpMethod": "POST", "parameters": { "modelDeploymentMonitoringJob": { "location": "path", "required": true, "type": "string", "description": "Required. ModelDeploymentMonitoring Job resource name. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$" } } }, "pause": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}:pause", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.pause", "description": "Pauses a ModelDeploymentMonitoringJob. If the job is running, the server makes a best effort to cancel the job. Will mark ModelDeploymentMonitoringJob.state to 'PAUSED'.", "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "Required. The resource name of the ModelDeploymentMonitoringJob to pause. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PauseModelDeploymentMonitoringJobRequest" }, "path": "v1beta1/{+name}:pause", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$", "description": "Required. The resource name of the model monitoring job to delete. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.delete", "description": "Deletes a ModelDeploymentMonitoringJob.", "parameterOrder": [ "name" ] }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob" }, "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.create", "path": "v1beta1/{+parent}/modelDeploymentMonitoringJobs", "description": "Creates a ModelDeploymentMonitoringJob. It will run periodically on a configured interval.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The parent of the ModelDeploymentMonitoringJob. Format: `projects/{project}/locations/{location}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob" }, "httpMethod": "POST" }, "get": { "description": "Gets a ModelDeploymentMonitoringJob.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$", "description": "Required. The resource name of the ModelDeploymentMonitoringJob. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`" } }, "httpMethod": "GET" }, "patch": { "parameterOrder": [ "name" ], "description": "Updates a ModelDeploymentMonitoringJob.", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.patch", "request": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "updateMask": { "type": "string", "location": "query", "description": "Required. The update mask is used to specify the fields to be overwritten in the ModelDeploymentMonitoringJob resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. For the objective config, the user can either provide the update mask for model_deployment_monitoring_objective_configs or any combination of its nested fields, such as: model_deployment_monitoring_objective_configs.objective_config.training_dataset. Updatable fields: * `display_name` * `model_deployment_monitoring_schedule_config` * `model_monitoring_alert_config` * `logging_sampling_strategy` * `labels` * `log_ttl` * `enable_monitoring_pipeline_logs` . and * `model_deployment_monitoring_objective_configs` . or * `model_deployment_monitoring_objective_configs.objective_config.training_dataset` * `model_deployment_monitoring_objective_configs.objective_config.training_prediction_skew_detection_config` * `model_deployment_monitoring_objective_configs.objective_config.prediction_drift_detection_config`", "format": "google-fieldmask" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$", "description": "Output only. Resource name of a ModelDeploymentMonitoringJob.", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}", "httpMethod": "PATCH" } }, "resources": { "operations": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.operations.delete", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}" }, "list": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+$" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.operations.wait", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" } }, "httpMethod": "POST" }, "cancel": { "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "type": "string" } } }, "get": { "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelDeploymentMonitoringJobs.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] } } } } }, "studies": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "Required. The name of the Study resource to be deleted. Format: `projects/{project}/locations/{location}/studies/{study}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "type": "string" } }, "id": "aiplatform.projects.locations.studies.delete", "description": "Deletes a Study.", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "lookup": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Study" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.studies.lookup", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies:lookup", "description": "Looks a study up using the user-defined display_name field instead of the fully qualified resource name.", "path": "v1beta1/{+parent}/studies:lookup", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to get the Study from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1LookupStudyRequest" }, "httpMethod": "POST" }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Study" }, "description": "Gets a Study by name.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.studies.get", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}", "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "description": "Required. The name of the Study resource. Format: `projects/{project}/locations/{location}/studies/{study}`" } }, "httpMethod": "GET" }, "list": { "description": "Lists all the studies in a region for an associated project.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListStudiesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies", "parameters": { "pageSize": { "description": "Optional. The maximum number of studies to return per \"page\" of results. If unspecified, service will pick an appropriate default.", "location": "query", "format": "int32", "type": "integer" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to list the Study from. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "path", "required": true }, "pageToken": { "description": "Optional. A page token to request the next page of results. If unspecified, there are no subsequent pages.", "type": "string", "location": "query" } }, "httpMethod": "GET", "path": "v1beta1/{+parent}/studies", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.studies.list" }, "create": { "id": "aiplatform.projects.locations.studies.create", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Study" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Study" }, "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location to create the CustomJob in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies", "description": "Creates a Study. A resource name will be generated after creation of the Study.", "httpMethod": "POST", "path": "v1beta1/{+parent}/studies" } }, "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.studies.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.studies.operations.list", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" } }, "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.studies.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.studies.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE" }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.studies.operations.get", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/operations/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } }, "trials": { "methods": { "listOptimalTrials": { "description": "Lists the pareto-optimal Trials for multi-objective Study or the optimal Trials for single-objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency", "id": "aiplatform.projects.locations.studies.trials.listOptimalTrials", "request": { "$ref": "GoogleCloudAiplatformV1beta1ListOptimalTrialsRequest" }, "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The name of the Study that the optimal Trial belongs to.", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListOptimalTrialsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/trials:listOptimalTrials", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials:listOptimalTrials" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "description": "Gets a Trial.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "type": "string", "description": "Required. The name of the Trial resource. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.studies.trials.get", "path": "v1beta1/{+name}" }, "stop": { "id": "aiplatform.projects.locations.studies.trials.stop", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "description": "Required. The Trial's name. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`", "type": "string", "location": "path", "required": true } }, "description": "Stops a Trial.", "request": { "$ref": "GoogleCloudAiplatformV1beta1StopTrialRequest" }, "httpMethod": "POST", "path": "v1beta1/{+name}:stop", "response": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}:stop" }, "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "parameters": { "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "description": "Required. The resource name of the Study to create the Trial in. Format: `projects/{project}/locations/{location}/studies/{study}`" } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/trials", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "description": "Adds a user provided Trial to a Study.", "id": "aiplatform.projects.locations.studies.trials.create" }, "addTrialMeasurement": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}:addTrialMeasurement", "parameters": { "trialName": { "description": "Required. The name of the trial to add measurement. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "id": "aiplatform.projects.locations.studies.trials.addTrialMeasurement", "path": "v1beta1/{+trialName}:addTrialMeasurement", "description": "Adds a measurement of the objective metrics to a Trial. This measurement is assumed to have been taken before the Trial is complete.", "parameterOrder": [ "trialName" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AddTrialMeasurementRequest" } }, "delete": { "description": "Deletes a Trial.", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The Trial's name. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.studies.trials.delete" }, "complete": { "description": "Marks a Trial as complete.", "request": { "$ref": "GoogleCloudAiplatformV1beta1CompleteTrialRequest" }, "path": "v1beta1/{+name}:complete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "description": "Required. The Trial's name. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "id": "aiplatform.projects.locations.studies.trials.complete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}:complete" }, "suggest": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials:suggest", "description": "Adds one or more Trials to a Study, with parameter values suggested by Vertex AI Vizier. Returns a long-running operation associated with the generation of Trial suggestions. When this long-running operation succeeds, it will contain a SuggestTrialsResponse.", "request": { "$ref": "GoogleCloudAiplatformV1beta1SuggestTrialsRequest" }, "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "description": "Required. The project and location that the Study belongs to. Format: `projects/{project}/locations/{location}/studies/{study}`", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+parent}/trials:suggest", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.studies.trials.suggest" }, "list": { "httpMethod": "GET", "parameters": { "pageToken": { "description": "Optional. A page token to request the next page of results. If unspecified, there are no subsequent pages.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "Optional. The number of Trials to retrieve per \"page\" of results. If unspecified, the service will pick an appropriate default." }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+$", "description": "Required. The resource name of the Study to list the Trial from. Format: `projects/{project}/locations/{location}/studies/{study}`", "location": "path", "required": true } }, "parameterOrder": [ "parent" ], "description": "Lists the Trials associated with a Study.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.studies.trials.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials", "path": "v1beta1/{+parent}/trials", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTrialsResponse" } }, "checkTrialEarlyStoppingState": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}:checkTrialEarlyStoppingState", "request": { "$ref": "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "trialName" ], "description": "Checks whether a Trial should stop or not. Returns a long-running operation. When the operation is successful, it will contain a CheckTrialEarlyStoppingStateResponse.", "httpMethod": "POST", "path": "v1beta1/{+trialName}:checkTrialEarlyStoppingState", "parameters": { "trialName": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The Trial's name. Format: `projects/{project}/locations/{location}/studies/{study}/trials/{trial}`" } }, "id": "aiplatform.projects.locations.studies.trials.checkTrialEarlyStoppingState", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}/operations", "id": "aiplatform.projects.locations.studies.trials.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ] }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.studies.trials.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string", "location": "query" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "cancel": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.studies.trials.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}:cancel" }, "get": { "id": "aiplatform.projects.locations.studies.trials.operations.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/studies/[^/]+/trials/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.studies.trials.operations.delete" } } } } } } }, "endpoints": { "methods": { "serverStreamingPredict": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:serverStreamingPredict", "parameterOrder": [ "endpoint" ], "path": "v1beta1/{+endpoint}:serverStreamingPredict", "parameters": { "endpoint": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.endpoints.serverStreamingPredict", "response": { "$ref": "GoogleCloudAiplatformV1beta1StreamingPredictResponse" }, "description": "Perform a server-side streaming online prediction request for Vertex LLM streaming.", "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamingPredictRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, "predict": { "id": "aiplatform.projects.locations.endpoints.predict", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "endpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:predict", "response": { "$ref": "GoogleCloudAiplatformV1beta1PredictResponse" }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictRequest" }, "parameters": { "endpoint": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" } }, "path": "v1beta1/{+endpoint}:predict", "description": "" }, "directRawPredict": { "parameterOrder": [ "endpoint" ], "id": "aiplatform.projects.locations.endpoints.directRawPredict", "httpMethod": "POST", "path": "v1beta1/{+endpoint}:directRawPredict", "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DirectRawPredictRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:directRawPredict", "description": "Perform an unary online prediction request to a gRPC model server for custom containers.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1DirectRawPredictResponse" } }, "get": { "description": "Gets an Endpoint.", "id": "aiplatform.projects.locations.endpoints.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1Endpoint" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint resource. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}" }, "delete": { "id": "aiplatform.projects.locations.endpoints.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "Required. The name of the Endpoint resource to be deleted. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}", "description": "Deletes an Endpoint.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "countTokens": { "id": "aiplatform.projects.locations.endpoints.countTokens", "description": "Perform a token counting.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:countTokens", "response": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensResponse" }, "parameterOrder": [ "endpoint" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensRequest" }, "path": "v1beta1/{+endpoint}:countTokens" }, "computeTokens": { "path": "v1beta1/{+endpoint}:computeTokens", "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to get lists of tokens and token ids.", "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:computeTokens", "description": "Return a list of tokens based on the input text.", "parameterOrder": [ "endpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensResponse" }, "id": "aiplatform.projects.locations.endpoints.computeTokens" }, "deployModel": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "endpoint" ], "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint resource into which to deploy a Model. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:deployModel", "httpMethod": "POST", "path": "v1beta1/{+endpoint}:deployModel", "description": "Deploys a Model into this Endpoint, creating a DeployedModel within it.", "id": "aiplatform.projects.locations.endpoints.deployModel", "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployModelRequest" } }, "getIamPolicy": { "path": "v1beta1/{+resource}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "aiplatform.projects.locations.endpoints.getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "httpMethod": "POST", "parameters": { "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer", "location": "query", "format": "int32" }, "resource": { "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "mutateDeployedModel": { "id": "aiplatform.projects.locations.endpoints.mutateDeployedModel", "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "description": "Required. The name of the Endpoint resource into which to mutate a DeployedModel. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" } }, "path": "v1beta1/{+endpoint}:mutateDeployedModel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:mutateDeployedModel", "request": { "$ref": "GoogleCloudAiplatformV1beta1MutateDeployedModelRequest" }, "description": "Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "endpoint" ] }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEndpointsResponse" }, "parameters": { "gdcZone": { "description": "Optional. Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.", "location": "query", "type": "string" }, "parent": { "type": "string", "description": "Required. The resource name of the Location from which to list the Endpoints. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageSize": { "description": "Optional. The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "readMask": { "type": "string", "format": "google-fieldmask", "location": "query", "description": "Optional. Mask specifying which fields to read." }, "filter": { "description": "Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `endpoint` supports `=` and `!=`. `endpoint` represents the Endpoint ID, i.e. the last segment of the Endpoint's resource name. * `display_name` supports `=` and `!=`. * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:*` or `labels:key` - key existence * A key including a space must be quoted. `labels.\"a key\"`. * `base_model_name` only supports `=`. Some examples: * `endpoint=1` * `displayName=\"myDisplayName\"` * `labels.myKey=\"myValue\"` * `baseModelName=\"text-bison\"`", "type": "string", "location": "query" }, "pageToken": { "description": "Optional. The standard list page token. Typically obtained via ListEndpointsResponse.next_page_token of the previous EndpointService.ListEndpoints call.", "location": "query", "type": "string" } }, "description": "Lists Endpoints in a Location.", "id": "aiplatform.projects.locations.endpoints.list", "httpMethod": "GET", "path": "v1beta1/{+parent}/endpoints", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "explain": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ExplainResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ExplainRequest" }, "path": "v1beta1/{+endpoint}:explain", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:explain", "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the explanation. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.endpoints.explain", "parameterOrder": [ "endpoint" ], "description": "Perform an online explanation. If deployed_model_id is specified, the corresponding DeployModel must have explanation_spec populated. If deployed_model_id is not specified, all DeployedModels must have explanation_spec populated." }, "streamGenerateContent": { "path": "v1beta1/{+model}:streamGenerateContent", "parameters": { "model": { "location": "path", "required": true, "type": "string", "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" } }, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "id": "aiplatform.projects.locations.endpoints.streamGenerateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "model" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "description": "Generate content with multimodal inputs with streaming support.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:streamGenerateContent" }, "fetchPredictOperation": { "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true } }, "description": "Fetch an asynchronous online prediction operation.", "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:fetchPredictOperation", "id": "aiplatform.projects.locations.endpoints.fetchPredictOperation", "parameterOrder": [ "endpoint" ], "path": "v1beta1/{+endpoint}:fetchPredictOperation", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, "predictLongRunning": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:predictLongRunning", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+endpoint}:predictLongRunning", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "endpoint" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictLongRunningRequest" }, "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`" } }, "description": "", "id": "aiplatform.projects.locations.endpoints.predictLongRunning" }, "rawPredict": { "httpMethod": "POST", "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "id": "aiplatform.projects.locations.endpoints.rawPredict", "parameterOrder": [ "endpoint" ], "description": "Perform an online prediction with an arbitrary HTTP payload. The response includes the following HTTP headers: * `X-Vertex-AI-Endpoint-Id`: ID of the Endpoint that served this prediction. * `X-Vertex-AI-Deployed-Model-Id`: ID of the Endpoint's DeployedModel that served this prediction.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RawPredictRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:rawPredict", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+endpoint}:rawPredict" }, "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", "type": "string" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Identifier. The resource name of the Endpoint." } }, "description": "Updates an Endpoint.", "id": "aiplatform.projects.locations.endpoints.patch", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}", "request": { "$ref": "GoogleCloudAiplatformV1beta1Endpoint" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Endpoint" } }, "setIamPolicy": { "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "id": "aiplatform.projects.locations.endpoints.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+resource}:setIamPolicy", "parameters": { "resource": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "response": { "$ref": "GoogleIamV1Policy" }, "httpMethod": "POST", "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:setIamPolicy" }, "undeployModel": { "description": "Undeploys a Model from an Endpoint, removing a DeployedModel from it, and freeing all resources it's using.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:undeployModel", "path": "v1beta1/{+endpoint}:undeployModel", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.endpoints.undeployModel", "httpMethod": "POST", "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Endpoint resource from which to undeploy a Model. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" } }, "parameterOrder": [ "endpoint" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1UndeployModelRequest" } }, "directPredict": { "parameters": { "endpoint": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "httpMethod": "POST", "path": "v1beta1/{+endpoint}:directPredict", "id": "aiplatform.projects.locations.endpoints.directPredict", "request": { "$ref": "GoogleCloudAiplatformV1beta1DirectPredictRequest" }, "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1DirectPredictResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:directPredict", "description": "Perform an unary online prediction request to a gRPC model server for Vertex first-party products and frameworks." }, "update": { "path": "v1beta1/{+name}:update", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.endpoints.update", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Identifier. The resource name of the Endpoint." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:update", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Updates an Endpoint with a long running operation." }, "streamRawPredict": { "parameterOrder": [ "endpoint" ], "description": "Perform a streaming online prediction with an arbitrary HTTP payload.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+endpoint}:streamRawPredict", "id": "aiplatform.projects.locations.endpoints.streamRawPredict", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:streamRawPredict", "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamRawPredictRequest" }, "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string", "location": "path", "required": true } } }, "generateContent": { "id": "aiplatform.projects.locations.endpoints.generateContent", "path": "v1beta1/{+model}:generateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "model" ], "description": "Generate content with multimodal inputs.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:generateContent", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "httpMethod": "POST", "parameters": { "model": { "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "type": "string", "location": "path", "required": true } } }, "testIamPermissions": { "path": "v1beta1/{+resource}:testIamPermissions", "id": "aiplatform.projects.locations.endpoints.testIamPermissions", "parameterOrder": [ "resource" ], "parameters": { "permissions": { "type": "string", "location": "query", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "repeated": true }, "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:testIamPermissions" }, "create": { "path": "v1beta1/{+parent}/endpoints", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates an Endpoint.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.endpoints.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1Endpoint" }, "httpMethod": "POST", "parameters": { "endpointId": { "description": "Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body.", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the Endpoint in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string" } } } }, "resources": { "chat": { "methods": { "completions": { "description": "Exposes an OpenAI-compatible endpoint for chat completions.", "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "httpMethod": "POST", "parameterOrder": [ "endpoint" ], "id": "aiplatform.projects.locations.endpoints.chat.completions", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/chat/completions", "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+endpoint}/chat/completions", "response": { "$ref": "GoogleApiHttpBody" } } } }, "deployedModels": { "resources": { "invoke": { "methods": { "invoke": { "parameterOrder": [ "endpoint", "deployedModelId", "invokeId" ], "path": "v1beta1/{+endpoint}/deployedModels/{deployedModelId}/invoke/{+invokeId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "httpMethod": "POST", "parameters": { "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "location": "path", "required": true, "type": "string" }, "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" }, "invokeId": { "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.projects.locations.endpoints.deployedModels.invoke.invoke", "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/deployedModels/{deployedModelId}/invoke/{invokeId}", "response": { "$ref": "GoogleApiHttpBody" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1InvokeRequest" } } } } } }, "operations": { "methods": { "get": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.endpoints.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/operations/{operationsId}" }, "cancel": { "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.endpoints.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/operations/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/operations", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.endpoints.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$" } } }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "parameters": { "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.endpoints.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.endpoints.operations.delete", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." } } }, "openapi": { "methods": { "completions": { "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "endpoint" ], "path": "v1beta1/{+endpoint}/completions", "request": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/openapi/completions", "parameters": { "endpoint": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/openapi$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" }, "deployedModelId": { "location": "query", "type": "string", "description": "ID of the DeployedModel that serves the invoke request." } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.endpoints.openapi.completions", "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request." }, "embeddings": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "endpoint" ], "path": "v1beta1/{+endpoint}/embeddings", "response": { "$ref": "GoogleApiHttpBody" }, "id": "aiplatform.projects.locations.endpoints.openapi.embeddings", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/openapi/embeddings", "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/openapi$", "location": "path", "required": true, "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" }, "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "type": "string", "location": "query" } }, "httpMethod": "POST", "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "request": { "$ref": "GoogleApiHttpBody" } }, "responses": { "id": "aiplatform.projects.locations.endpoints.openapi.responses", "request": { "$ref": "GoogleApiHttpBody" }, "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "parameterOrder": [ "endpoint" ], "httpMethod": "POST", "path": "v1beta1/{+endpoint}/responses", "parameters": { "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "location": "query", "type": "string" }, "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/openapi$", "type": "string", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/openapi/responses", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleApiHttpBody" } } } }, "invoke": { "methods": { "invoke": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/invoke/{invokeId}", "path": "v1beta1/{+endpoint}/invoke/{+invokeId}", "response": { "$ref": "GoogleApiHttpBody" }, "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "id": "aiplatform.projects.locations.endpoints.invoke.invoke", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "httpMethod": "POST", "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+$", "location": "path", "required": true, "type": "string" }, "invokeId": { "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1InvokeRequest" }, "parameterOrder": [ "endpoint", "invokeId" ] } } }, "responses": { "methods": { "delete": { "id": "aiplatform.projects.locations.endpoints.responses.delete", "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/responses/{responsesId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Deletes the response from the endpoint.", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. The name of the Response resource to be deleted. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}/responses/{response}`", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/responses/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}" }, "get": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleApiHttpBody" }, "description": "Gets the response from the endpoint.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}/responses/{responsesId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/[^/]+/responses/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Response resource. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}/responses/{response}`" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.endpoints.responses.get" } } }, "google": { "resources": { "science": { "methods": { "inference": { "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.endpoints.google.science.inference", "response": { "$ref": "GoogleApiHttpBody" }, "parameters": { "endpoint": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/endpoints/google$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true }, "deployedModelId": { "type": "string", "description": "ID of the DeployedModel that serves the invoke request.", "location": "query" } }, "path": "v1beta1/{+endpoint}/science/inference", "request": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/google/science/inference", "parameterOrder": [ "endpoint" ] } } } } } } }, "hyperparameterTuningJobs": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+$", "description": "Required. The name of the HyperparameterTuningJob resource to be deleted. Format: `projects/{project}/locations/{location}/hyperparameterTuningJobs/{hyperparameter_tuning_job}`" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.delete", "description": "Deletes a HyperparameterTuningJob." }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListHyperparameterTuningJobsResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs", "description": "Lists HyperparameterTuningJobs in a Location.", "path": "v1beta1/{+parent}/hyperparameterTuningJobs", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.list", "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`" }, "pageToken": { "description": "The standard list page token. Typically obtained via ListHyperparameterTuningJobsResponse.next_page_token of the previous JobService.ListHyperparameterTuningJobs call.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "readMask": { "location": "query", "description": "Mask specifying which fields to read.", "type": "string", "format": "google-fieldmask" }, "parent": { "description": "Required. The resource name of the Location to list the HyperparameterTuningJobs from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1HyperparameterTuningJob" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Gets a HyperparameterTuningJob", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.get", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the HyperparameterTuningJob resource. Format: `projects/{project}/locations/{location}/hyperparameterTuningJobs/{hyperparameter_tuning_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+$" } }, "httpMethod": "GET" }, "create": { "parameters": { "parent": { "description": "Required. The resource name of the Location to create the HyperparameterTuningJob in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1HyperparameterTuningJob" }, "httpMethod": "POST", "path": "v1beta1/{+parent}/hyperparameterTuningJobs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs", "request": { "$ref": "GoogleCloudAiplatformV1beta1HyperparameterTuningJob" }, "description": "Creates a HyperparameterTuningJob", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "cancel": { "path": "v1beta1/{+name}:cancel", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelHyperparameterTuningJobRequest" }, "httpMethod": "POST", "parameters": { "name": { "description": "Required. The name of the HyperparameterTuningJob to cancel. Format: `projects/{project}/locations/{location}/hyperparameterTuningJobs/{hyperparameter_tuning_job}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}:cancel", "description": "Cancels a HyperparameterTuningJob. Starts asynchronous cancellation on the HyperparameterTuningJob. The server makes a best effort to cancel the job, but success is not guaranteed. Clients can use JobService.GetHyperparameterTuningJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On successful cancellation, the HyperparameterTuningJob is not deleted; instead it becomes a job with a HyperparameterTuningJob.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`, and HyperparameterTuningJob.state is set to `CANCELLED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.hyperparameterTuningJobs.cancel", "response": { "$ref": "GoogleProtobufEmpty" } } }, "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.operations.cancel", "parameterOrder": [ "name" ] }, "get": { "id": "aiplatform.projects.locations.hyperparameterTuningJobs.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET" }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.hyperparameterTuningJobs.operations.list", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+/operations/[^/]+$" }, "timeout": { "format": "google-duration", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.hyperparameterTuningJobs.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "delete": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.hyperparameterTuningJobs.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}" } } } } }, "customJobs": { "resources": { "operations": { "methods": { "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.customJobs.operations.cancel", "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}/operations/{operationsId}:cancel" }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "aiplatform.projects.locations.customJobs.operations.get", "path": "v1beta1/{+name}" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.customJobs.operations.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+$", "location": "path", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" } }, "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.customJobs.operations.list" }, "wait": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.customJobs.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." } } } } } }, "methods": { "cancel": { "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelCustomJobRequest" }, "id": "aiplatform.projects.locations.customJobs.cancel", "parameterOrder": [ "name" ], "description": "Cancels a CustomJob. Starts asynchronous cancellation on the CustomJob. The server makes a best effort to cancel the job, but success is not guaranteed. Clients can use JobService.GetCustomJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On successful cancellation, the CustomJob is not deleted; instead it becomes a job with a CustomJob.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`, and CustomJob.state is set to `CANCELLED`.", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the CustomJob to cancel. Format: `projects/{project}/locations/{location}/customJobs/{custom_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+$" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1CustomJob" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs", "request": { "$ref": "GoogleCloudAiplatformV1beta1CustomJob" }, "httpMethod": "POST", "path": "v1beta1/{+parent}/customJobs", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the CustomJob in. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "path", "required": true } }, "description": "Creates a CustomJob. A created CustomJob right away will be attempted to be run.", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.customJobs.create" }, "get": { "httpMethod": "GET", "description": "Gets a CustomJob.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+$", "description": "Required. The name of the CustomJob resource. Format: `projects/{project}/locations/{location}/customJobs/{custom_job}`", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1CustomJob" }, "id": "aiplatform.projects.locations.customJobs.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs/{customJobsId}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the CustomJob resource to be deleted. Format: `projects/{project}/locations/{location}/customJobs/{custom_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/customJobs/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.customJobs.delete", "description": "Deletes a CustomJob.", "parameterOrder": [ "name" ] }, "list": { "path": "v1beta1/{+parent}/customJobs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/customJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListCustomJobsResponse" }, "httpMethod": "GET", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location to list the CustomJobs from. Format: `projects/{project}/locations/{location}`" }, "pageToken": { "type": "string", "description": "The standard list page token. Typically obtained via ListCustomJobsResponse.next_page_token of the previous JobService.ListCustomJobs call.", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The standard list page size." }, "readMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Mask specifying which fields to read." }, "filter": { "type": "string", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`", "location": "query" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists CustomJobs in a Location.", "id": "aiplatform.projects.locations.customJobs.list" } } }, "taskStores": { "resources": { "a2aTaskRecords": { "methods": { "delete": { "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords/{a2aTaskRecordsId}", "parameters": { "name": { "description": "Required. The resource name of the A2ATaskRecord to delete. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/a2aTaskRecords/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecord" }, "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes an A2ATaskRecord.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "appendEvents": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:appendEvents", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/a2aTaskRecords/[^/]+$", "description": "Required. The resource name of the A2ATaskRecord to append events to. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords/{a2aTaskRecordsId}:appendEvents", "description": "Appends A2ATaskRecordEvents to an A2ATaskRecord.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.appendEvents" }, "create": { "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.create", "path": "v1beta1/{+parent}/a2aTaskRecords", "description": "Creates an A2ATaskRecord.", "request": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecord" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecord" }, "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the TaskStore to create the A2ATaskRecord under. Format: `projects/{project}/locations/{location}/taskStores/{task_store}`", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+$" }, "a2aTaskRecordId": { "location": "query", "description": "Optional. The user defined ID to use for the A2ATaskRecord, which will become the final component of the A2ATaskRecord resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first and last characters must be a letter or number. This accepts A2A task IDs such as UUIDs, which may start with a digit.", "type": "string" } }, "httpMethod": "POST" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListA2ATaskRecordsResponse" }, "description": "Lists A2ATaskRecords in a TaskStore.", "parameters": { "filter": { "location": "query", "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `task_id` * `context_id` * `status.state` * `app_id` * `user_id` * `create_time` range (i.e. `create_time\u003e=\"2025-01-31T11:30:00-04:00\"` where the timestamp is in RFC 3339 format) Example: `context_id=\"abc\"`, `status.state=\"WORKING\"`." }, "pageSize": { "description": "Optional. The maximum number of tasks to return. The service may return fewer than this value. If unspecified, at most 10 tasks will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "type": "integer", "format": "int32", "location": "query" }, "pageToken": { "description": "Optional. The next_page_token value returned from a previous list A2ATaskRecordService.ListA2ATaskRecords call.", "type": "string", "location": "query" }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the TaskStore to list the A2ATaskRecords under. Format: `projects/{project}/locations/{location}/taskStores/{task_store}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+$" }, "orderBy": { "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. If this field is omitted, the default ordering is `task_id` descending. More detail in [AIP-132](https://google.aip.dev/132). Supported field: * `task_id` * `create_time` Example: `create_time desc`, `task_id asc`.", "type": "string", "location": "query" } }, "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.list", "path": "v1beta1/{+parent}/a2aTaskRecords", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords" }, "get": { "description": "Gets an A2ATaskRecord.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords/{a2aTaskRecordsId}", "httpMethod": "GET", "parameters": { "view": { "type": "string", "description": "Optional. The view of the A2ATaskRecord to return.", "enum": [ "A2A_TASK_RECORD_VIEW_UNSPECIFIED", "A2A_TASK_RECORD_VIEW_BASIC", "A2A_TASK_RECORD_VIEW_FULL" ], "enumDescriptions": [ "Task view unspecified.", "Task header only (status, metadata, timestamps)", "Full materialized state (artifacts + history)" ], "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/a2aTaskRecords/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the A2ATaskRecord. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`" } }, "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecord" } } }, "resources": { "events": { "methods": { "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListA2ATaskRecordEventsResponse" }, "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/a2aTaskRecords/[^/]+$", "description": "Required. The resource name of the A2ATaskRecord to list the TaskEvents under. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`", "type": "string" }, "orderBy": { "description": "Optional. Specifies the order of the returned events. If omitted, results default to `generation` in ascending order. To specify descending order, append a ` desc` suffix. For example: `generation desc`. Supported fields: * `generation` Note: Ordering directly by event timestamp (e.g., `create_time`) is not supported. Users requiring time-based traversal should use `generation` ordering and scan the results until the desired time threshold is reached (e.g., for chronological order, use default ascending and stop when `create_time` exceeds your target).", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The next_page_token value returned from a previous list A2ATaskRecordService.ListA2ATaskRecordEvents call." }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "Optional. The maximum number of events to return. The service may return fewer than this value. If unspecified, at most 100 events will be returned. The maximum value is 100; values above 100 will be coerced to 100." }, "filter": { "type": "string", "location": "query", "description": "Optional. The standard list filter. Supported fields: * `generation` * `create_time` range (i.e. `create_time\u003e=\"2025-01-31T11:30:00-04:00\"` where the timestamp is in RFC 3339 format) More detail in [AIP-160](https://google.aip.dev/160)." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.taskStores.a2aTaskRecords.events.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/a2aTaskRecords/{a2aTaskRecordsId}/events", "description": "Lists TaskEvents for an A2ATaskRecord.", "path": "v1beta1/{+parent}/events", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] } } } } }, "operations": { "methods": { "cancel": { "id": "aiplatform.projects.locations.taskStores.operations.cancel", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.taskStores.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/operations/{operationsId}" }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.taskStores.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/operations/{operationsId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } }, "list": { "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "id": "aiplatform.projects.locations.taskStores.operations.list", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true } }, "parameterOrder": [ "name" ] }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/taskStores/[^/]+/operations/[^/]+$" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/taskStores/{taskStoresId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.taskStores.operations.wait", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "deploymentResourcePools": { "methods": { "list": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools", "path": "v1beta1/{+parent}/deploymentResourcePools", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDeploymentResourcePoolsResponse" }, "id": "aiplatform.projects.locations.deploymentResourcePools.list", "description": "List DeploymentResourcePools in a location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "description": "A page token, received from a previous `ListDeploymentResourcePools` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDeploymentResourcePools` must match the call that provided the page token.", "type": "string", "location": "query" }, "pageSize": { "location": "query", "description": "The maximum number of DeploymentResourcePools to return. The service may return fewer than this value.", "type": "integer", "format": "int32" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The parent Location which owns this collection of DeploymentResourcePools. Format: `projects/{project}/locations/{location}`", "type": "string" } }, "httpMethod": "GET" }, "create": { "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.deploymentResourcePools.create", "description": "Create a DeploymentResourcePool.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The parent location resource where this DeploymentResourcePool will be created. Format: `projects/{project}/locations/{location}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/deploymentResourcePools", "request": { "$ref": "GoogleCloudAiplatformV1beta1CreateDeploymentResourcePoolRequest" } }, "patch": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "id": "aiplatform.projects.locations.deploymentResourcePools.patch", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+$", "description": "Immutable. The resource name of the DeploymentResourcePool. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "location": "path", "required": true }, "updateMask": { "description": "Required. The list of fields to update.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DeploymentResourcePool" }, "description": "Update a DeploymentResourcePool.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}", "response": { "$ref": "GoogleLongrunningOperation" } }, "queryDeployedModels": { "id": "aiplatform.projects.locations.deploymentResourcePools.queryDeployedModels", "parameters": { "pageSize": { "description": "The maximum number of DeployedModels to return. The service may return fewer than this value.", "type": "integer", "format": "int32", "location": "query" }, "deploymentResourcePool": { "description": "Required. The name of the target DeploymentResourcePool to query. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+$", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous `QueryDeployedModels` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryDeployedModels` must match the call that provided the page token." } }, "httpMethod": "GET", "path": "v1beta1/{+deploymentResourcePool}:queryDeployedModels", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "List DeployedModels that have been deployed on this DeploymentResourcePool.", "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryDeployedModelsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}:queryDeployedModels", "parameterOrder": [ "deploymentResourcePool" ] }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.deploymentResourcePools.get", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1DeploymentResourcePool" }, "parameters": { "name": { "description": "Required. The name of the DeploymentResourcePool to retrieve. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get a DeploymentResourcePool." }, "delete": { "description": "Delete a DeploymentResourcePool.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}", "parameters": { "name": { "type": "string", "description": "Required. The name of the DeploymentResourcePool to delete. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.deploymentResourcePools.delete" } }, "resources": { "operations": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.deploymentResourcePools.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.deploymentResourcePools.operations.get" }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.deploymentResourcePools.operations.cancel", "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.projects.locations.deploymentResourcePools.operations.list", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.deploymentResourcePools.operations.wait", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/deploymentResourcePools/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." } } } } }, "persistentResources": { "methods": { "delete": { "id": "aiplatform.projects.locations.persistentResources.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a PersistentResource.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "description": "Required. The name of the PersistentResource to be deleted. Format: `projects/{project}/locations/{location}/persistentResources/{persistent_resource}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+$" } } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1PersistentResource" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}", "description": "Updates a PersistentResource.", "parameters": { "updateMask": { "format": "google-fieldmask", "location": "query", "description": "Required. Specify the fields to be overwritten in the PersistentResource by the update method.", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+$", "description": "Immutable. Resource name of a PersistentResource." } }, "httpMethod": "PATCH", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.persistentResources.patch", "parameterOrder": [ "name" ] }, "get": { "description": "Gets a PersistentResource.", "id": "aiplatform.projects.locations.persistentResources.get", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the PersistentResource resource. Format: `projects/{project_id_or_number}/locations/{location_id}/persistentResources/{persistent_resource_id}`", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1PersistentResource" } }, "reboot": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}:reboot", "httpMethod": "POST", "id": "aiplatform.projects.locations.persistentResources.reboot", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the PersistentResource resource. Format: `projects/{project_id_or_number}/locations/{location_id}/persistentResources/{persistent_resource_id}`", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:reboot", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RebootPersistentResourceRequest" }, "description": "Reboots a PersistentResource." }, "list": { "id": "aiplatform.projects.locations.persistentResources.list", "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "description": "Optional. The standard list page size.", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token. Typically obtained via ListPersistentResourcesResponse.next_page_token of the previous PersistentResourceService.ListPersistentResource call." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to list the PersistentResources from. Format: `projects/{project}/locations/{location}`" } }, "path": "v1beta1/{+parent}/persistentResources", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists PersistentResources in a Location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListPersistentResourcesResponse" } }, "create": { "parameters": { "persistentResourceId": { "type": "string", "description": "Required. The ID to use for the PersistentResource, which become the final component of the PersistentResource's resource name. The maximum length is 63 characters, and valid characters are `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`.", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the PersistentResource in. Format: `projects/{project}/locations/{location}`" } }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a PersistentResource.", "path": "v1beta1/{+parent}/persistentResources", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1PersistentResource" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources", "id": "aiplatform.projects.locations.persistentResources.create" } }, "resources": { "operations": { "methods": { "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "id": "aiplatform.projects.locations.persistentResources.operations.cancel", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } } }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+$" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.persistentResources.operations.list" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.persistentResources.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string", "location": "query" } }, "httpMethod": "POST", "parameterOrder": [ "name" ] }, "get": { "id": "aiplatform.projects.locations.persistentResources.operations.get", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/persistentResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/persistentResources/{persistentResourcesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.persistentResources.operations.delete" } } } } }, "indexEndpoints": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.indexEndpoints.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}/operations/{operationsId}:cancel" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}/operations", "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.indexEndpoints.operations.list", "httpMethod": "GET", "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "format": "int32", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.indexEndpoints.operations.wait", "path": "v1beta1/{+name}:wait" }, "get": { "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.indexEndpoints.operations.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "aiplatform.projects.locations.indexEndpoints.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" } } } } }, "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates an IndexEndpoint.", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the IndexEndpoint in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1IndexEndpoint" }, "id": "aiplatform.projects.locations.indexEndpoints.create", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/indexEndpoints", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints" }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1IndexEndpoint" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1IndexEndpoint" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$", "type": "string", "description": "Output only. The resource name of the IndexEndpoint." }, "updateMask": { "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", "format": "google-fieldmask", "type": "string", "location": "query" } }, "description": "Updates an IndexEndpoint.", "httpMethod": "PATCH", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.indexEndpoints.patch" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.indexEndpoints.get", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "Required. The name of the IndexEndpoint resource. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1IndexEndpoint" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}", "path": "v1beta1/{+name}", "description": "Gets an IndexEndpoint." }, "list": { "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/indexEndpoints", "description": "Lists IndexEndpoints in a Location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location from which to list the IndexEndpoints. Format: `projects/{project}/locations/{location}`" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListIndexEndpointsResponse.next_page_token of the previous IndexEndpointService.ListIndexEndpoints call." }, "filter": { "type": "string", "location": "query", "description": "Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `index_endpoint` supports = and !=. `index_endpoint` represents the IndexEndpoint ID, ie. the last segment of the IndexEndpoint's resourcename. * `display_name` supports =, != and regex() (uses [re2](https://github.com/google/re2/wiki/Syntax) syntax) * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* or labels:key - key existence A key including a space must be quoted. `labels.\"a key\"`. Some examples: * `index_endpoint=\"1\"` * `display_name=\"myDisplayName\"` * `regex(display_name, \"^A\") -\u003e The display name starts with an A. * `labels.myKey=\"myValue\"`" }, "pageSize": { "description": "Optional. The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "readMask": { "description": "Optional. Mask specifying which fields to read.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListIndexEndpointsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints", "id": "aiplatform.projects.locations.indexEndpoints.list" }, "readIndexDatapoints": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadIndexDatapointsResponse" }, "id": "aiplatform.projects.locations.indexEndpoints.readIndexDatapoints", "description": "Reads the datapoints/vectors of the given IDs. A maximum of 1000 datapoints can be retrieved in a batch.", "path": "v1beta1/{+indexEndpoint}:readIndexDatapoints", "parameterOrder": [ "indexEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}:readIndexDatapoints", "request": { "$ref": "GoogleCloudAiplatformV1beta1ReadIndexDatapointsRequest" }, "parameters": { "indexEndpoint": { "description": "Required. The name of the index endpoint. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$" } }, "httpMethod": "POST" }, "mutateDeployedIndex": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}:mutateDeployedIndex", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.indexEndpoints.mutateDeployedIndex", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Optional. The update mask applies to the resource. The supported paths are `automatic_resources`, `dedicated_resources`, `enable_access_logging` and `deployed_index_auth_config`. When omitted, the service will perform a full update of all fields. See google.protobuf.FieldMask." }, "indexEndpoint": { "description": "Required. The name of the IndexEndpoint resource into which to deploy an Index. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployedIndex" }, "parameterOrder": [ "indexEndpoint" ], "description": "Update an existing DeployedIndex under an IndexEndpoint.", "path": "v1beta1/{+indexEndpoint}:mutateDeployedIndex" }, "undeployIndex": { "parameterOrder": [ "indexEndpoint" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}:undeployIndex", "request": { "$ref": "GoogleCloudAiplatformV1beta1UndeployIndexRequest" }, "parameters": { "indexEndpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the IndexEndpoint resource from which to undeploy an Index. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "type": "string" } }, "description": "Undeploys an Index from an IndexEndpoint, removing a DeployedIndex from it, and freeing all resources it's using.", "httpMethod": "POST", "id": "aiplatform.projects.locations.indexEndpoints.undeployIndex", "path": "v1beta1/{+indexEndpoint}:undeployIndex", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "findNeighbors": { "path": "v1beta1/{+indexEndpoint}:findNeighbors", "id": "aiplatform.projects.locations.indexEndpoints.findNeighbors", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}:findNeighbors", "request": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsRequest" }, "httpMethod": "POST", "parameters": { "indexEndpoint": { "description": "Required. The name of the index endpoint. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$" } }, "parameterOrder": [ "indexEndpoint" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsResponse" }, "description": "Finds the nearest neighbors of each vector within the request.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "deployIndex": { "id": "aiplatform.projects.locations.indexEndpoints.deployIndex", "description": "Deploys an Index into this IndexEndpoint, creating a DeployedIndex within it.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "indexEndpoint": { "description": "Required. The name of the IndexEndpoint resource into which to deploy an Index. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1DeployIndexRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}:deployIndex", "parameterOrder": [ "indexEndpoint" ], "path": "v1beta1/{+indexEndpoint}:deployIndex", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexEndpoints/{indexEndpointsId}", "description": "Deletes an IndexEndpoint.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexEndpoints/[^/]+$", "description": "Required. The name of the IndexEndpoint resource to be deleted. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.indexEndpoints.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "agents": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.projects.locations.agents.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.agents.operations.wait" }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.agents.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.agents.operations.cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/operations/{operationsId}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "aiplatform.projects.locations.agents.operations.get", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+/operations/[^/]+$" } } } } } }, "methods": { "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Agent" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}", "path": "v1beta1/{+name}", "description": "Updates an agent.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.agents.patch", "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Identifier. The resource name of the agent. Format: `projects/{project}/locations/{location}/agents/{agent}`.", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$" }, "updateMask": { "description": "Optional. The list of fields to update. If not present, all fields are updated.", "format": "google-fieldmask", "type": "string", "location": "query" } } }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleIamV1Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "path": "v1beta1/{+resource}:setIamPolicy", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:setIamPolicy", "id": "aiplatform.projects.locations.agents.setIamPolicy", "parameterOrder": [ "resource" ], "parameters": { "resource": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true } }, "httpMethod": "POST" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "Required. The resource name of the agent to delete. Format: `projects/{project}/locations/{location}/agents/{agent}`.", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$", "location": "path", "required": true }, "force": { "type": "boolean", "location": "query", "description": "Optional. If true, any `Task` belonging to this agent is deleted along with it. If false or unset and the agent still has at least one `Task`, the request fails with `FAILED_PRECONDITION` and nothing is deleted. This governs `Task` and nothing else. Resources the agent owns but a caller never named -- its AI Application and the tenant project bound to it, its Workspace identity, its service-extension binding -- are torn down with the agent on every delete, whatever this field says." } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.agents.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes an agent." }, "getIamPolicy": { "id": "aiplatform.projects.locations.agents.getIamPolicy", "parameterOrder": [ "resource" ], "httpMethod": "POST", "parameters": { "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "type": "integer", "format": "int32" }, "resource": { "type": "string", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleIamV1Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "httpMethod": "GET", "id": "aiplatform.projects.locations.agents.list", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Optional. A page token, received from a previous AgentService.ListAgents call. Provide this to retrieve the subsequent page." }, "parent": { "type": "string", "description": "Required. The resource name of the location to list agents from. Format: `projects/{project}/locations/{location}`.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. The maximum number of agents to return. The service may return fewer than this value. The maximum page size is 100; values above 100 will be coerced to 100. If unspecified, the default page size is 10." }, "orderBy": { "location": "query", "description": "Optional. A comma-separated list of fields to order by. Supported fields: * `created` * `updated` Use `desc` after a field name for descending order. Example: `created desc`.", "type": "string" }, "filter": { "description": "Optional. An [AIP-160](https://google.aip.dev/160) filter over the returned agents. An empty filter returns the unfiltered collection. Supported fields, and the operators each accepts: * `created` * `updated` * `base_agent` * `metadata.agent_type` `created` and `updated` are timestamps and take an RFC-3339 value, for example `2026-08-01T00:00:00Z`. Supported operators: `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, `\u003e=`, `:`, `AND`, `OR`, `NOT` (equivalently `-`), and parentheses. Note that `OR` binds more tightly than `AND`, so `a AND b OR c` means `a AND (b OR c)`; parentheses are recommended, not required. `metadata.agent_type` accepts only the value `\"default_agent\"`, matched exactly: `metadata.agent_type:\"default_agent\"` selects the caller's default agent, of which there is at most one, and the negated form selects the rest. Any other value is `INVALID_ARGUMENT` rather than an empty page -- `metadata` is an opaque blob, so only this one marker is indexed, and the server cannot answer a question about the others. An agent designated before the server began recording the marker is not matched by the positive form; there is no backfill. `base_agent` accepts `=` and `!=` against the value an agent was created with, and selects only among the agents you own: an agent that belongs to the project rather than to a user is never returned by a filter naming it, including the negated form. An agent created before the server began recording the value is not matched either. Example: `created \u003e \"2026-08-01T00:00:00Z\" AND updated \u003c \"2026-08-09T00:00:00Z\"`. IMPORTANT -- `base_agent` and `metadata.agent_type` select only among the agents you own. An agent that belongs to the project rather than to a user is never returned by a filter naming either of them, including a negated one: `base_agent != \"some-value\"` returns your matching agents and no project-owned agents at all. Filtering on `created` or `updated` alone is unaffected and still spans both. If you want every agent in the project, do not filter on these two fields. Not supported: any field other than those listed above, wildcards other than `field:*`, bare literals with no field name, functions, and the regular-expression operators `=~` and `!~`. A filter that names an unsupported field, exceeds 1000 characters, or nests parentheses more than 5 deep fails with `INVALID_ARGUMENT`.", "type": "string", "location": "query" } }, "path": "v1beta1/{+parent}/agents", "description": "Lists the agents in a location that belong to the caller. An agent belongs to the end user recorded as its owner when it was created, so the response holds that caller's agents and no others. It is empty for a caller that is not an end user, and an agent with no recorded owner is listed for nobody.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListAgentsResponse" } }, "testIamPermissions": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:testIamPermissions", "parameterOrder": [ "resource" ], "id": "aiplatform.projects.locations.agents.testIamPermissions", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+resource}:testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "httpMethod": "POST", "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$" }, "permissions": { "repeated": true, "type": "string", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "location": "query" } } }, "create": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.agents.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Agent" }, "path": "v1beta1/{+parent}/agents", "httpMethod": "POST", "description": "Creates an agent.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the location to create the agent in. Format: `projects/{project}/locations/{location}`.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "description": "Retrieves an agent.", "response": { "$ref": "GoogleCloudAiplatformV1beta1Agent" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.agents.get", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the agent to retrieve. Format: `projects/{project}/locations/{location}/agents/{agent}`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/agents/[^/]+$" } }, "httpMethod": "GET", "parameterOrder": [ "name" ] } } }, "edgeDevices": { "resources": { "operations": { "methods": { "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/edgeDevices/{edgeDevicesId}/operations/{operationsId}", "id": "aiplatform.projects.locations.edgeDevices.operations.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/edgeDevices/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "aiplatform.projects.locations.edgeDevices.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/edgeDevices/{edgeDevicesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/edgeDevices/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.projects.locations.edgeDevices.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/edgeDevices/{edgeDevicesId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/edgeDevices/[^/]+$", "type": "string" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size.", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "httpMethod": "GET" }, "wait": { "path": "v1beta1/{+name}:wait", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/edgeDevices/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string", "format": "google-duration" } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.edgeDevices.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/edgeDevices/{edgeDevicesId}/operations/{operationsId}:wait" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/edgeDevices/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.edgeDevices.operations.cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/edgeDevices/{edgeDevicesId}/operations/{operationsId}:cancel" } } } } }, "interactionsHttp": { "methods": { "create": { "path": "v1beta1/{+parent}/interactionsHttp", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactionsHttp", "request": { "$ref": "GenaiVertexV1beta1CreateInteractionHttpRequest" }, "parameters": { "parent": { "description": "Required. The parent resource where this interaction will be created. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API only.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.projects.locations.interactionsHttp.create", "httpMethod": "POST", "description": "Creates a new interaction.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "id": "aiplatform.projects.locations.interactionsHttp.cancel", "description": "Cancels an interaction by id. This only applies to background interactions that are still running.", "path": "v1beta1/{+name}/cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/interactionsHttp/[^/]+$", "description": "Required. The name of the interaction to cancel. Format: `interactions/{interaction}`.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactionsHttp/{interactionsHttpId}/cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleApiHttpBody" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "lastEventId": { "description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", "type": "string", "location": "query" }, "stream": { "location": "query", "description": "If true, streams the interaction events as Server-Sent Events.", "type": "boolean" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}", "pattern": "^projects/[^/]+/locations/[^/]+/interactionsHttp/[^/]+$" }, "includeInput": { "type": "boolean", "description": "If true, includes the input in the response.", "deprecated": true, "location": "query" } }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.interactionsHttp.get", "description": "Retrieves the full details of a single interaction based on its `Interaction.id`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactionsHttp/{interactionsHttpId}", "response": { "$ref": "GoogleApiHttpBody" }, "parameterOrder": [ "name" ] } } }, "evaluationRuns": { "resources": { "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationRuns.operations.list", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+$", "location": "path", "required": true }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}/operations", "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ] }, "wait": { "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+/operations/[^/]+$" }, "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.evaluationRuns.operations.wait", "parameterOrder": [ "name" ] }, "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.evaluationRuns.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationRuns.operations.get" } } } }, "methods": { "cancel": { "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "Required. The name of the EvaluationRun resource to be cancelled. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run}`", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+$", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.evaluationRuns.cancel", "description": "Cancels an Evaluation Run. Attempts to cancel a running Evaluation Run asynchronously. Status of run can be checked via GetEvaluationRun.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelEvaluationRunRequest" } }, "create": { "description": "Creates an Evaluation Run.", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRun" }, "path": "v1beta1/{+parent}/evaluationRuns", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRun" }, "id": "aiplatform.projects.locations.evaluationRuns.create", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the Evaluation Run in. Format: `projects/{project}/locations/{location}`" } } }, "list": { "httpMethod": "GET", "parameters": { "filter": { "type": "string", "description": "Optional. Filter expression that matches a subset of the EvaluationRuns to show. For field names both snake_case and camelCase are supported. For more information about filter syntax, see [AIP-160](https://google.aip.dev/160).", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous `ListEvaluationRuns` call. Provide this to retrieve the subsequent page." }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location from which to list the Evaluation Runs. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageSize": { "location": "query", "description": "Optional. The maximum number of Evaluation Runs to return.", "format": "int32", "type": "integer" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending." } }, "parameterOrder": [ "parent" ], "description": "Lists Evaluation Runs.", "id": "aiplatform.projects.locations.evaluationRuns.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEvaluationRunsResponse" }, "path": "v1beta1/{+parent}/evaluationRuns", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationRuns.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRun" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}", "description": "Gets an Evaluation Run.", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the EvaluationRun resource. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run}`", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+$", "type": "string", "location": "path", "required": true } } }, "delete": { "description": "Deletes an Evaluation Run.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationRuns.delete", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the EvaluationRun resource to be deleted. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationRuns/[^/]+$" } }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationRuns/{evaluationRunsId}" } } }, "evaluationMetrics": { "methods": { "get": { "description": "Gets an EvaluationMetric.", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the EvaluationMetric resource. Format: `projects/{project}/locations/{location}/evaluationMetrics/{evaluation_metric}`", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationMetrics/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationMetrics.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationMetric" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics/{evaluationMetricsId}" }, "delete": { "id": "aiplatform.projects.locations.evaluationMetrics.delete", "parameterOrder": [ "name" ], "description": "Deletes an EvaluationMetric.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationMetrics/[^/]+$", "description": "Required. The name of the EvaluationMetric resource to be deleted. Format: `projects/{project}/locations/{location}/evaluationMetrics/{evaluation_metric}`", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics/{evaluationMetricsId}" }, "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationMetric" }, "path": "v1beta1/{+parent}/evaluationMetrics", "description": "Creates an EvaluationMetric.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.evaluationMetrics.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationMetric" }, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the EvaluationMetric in. Format: `projects/{project}/locations/{location}`", "type": "string" }, "evaluationMetricId": { "description": "Optional. The ID to use for the EvaluationMetric, which will become the final component of the EvaluationMetric's resource name. This value should be 1-63 characters, and valid characters are /a-z-/. The first character must be a lowercase letter, and the last character must be a lowercase letter or number.", "location": "query", "type": "string" } }, "httpMethod": "POST" }, "list": { "path": "v1beta1/{+parent}/evaluationMetrics", "description": "Lists EvaluationMetrics.", "httpMethod": "GET", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the EvaluationMetrics. Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "orderBy": { "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending.", "type": "string", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous `ListEvaluationMetrics` call. Provide this to retrieve the subsequent page." }, "pageSize": { "format": "int32", "description": "Optional. The maximum number of EvaluationMetrics to return.", "type": "integer", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "Optional. Filter expression that matches a subset of the EvaluationMetrics to show. For field names both snake_case and camelCase are supported. For more information about filter syntax, see [AIP-160](https://google.aip.dev/160)." } }, "id": "aiplatform.projects.locations.evaluationMetrics.list", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEvaluationMetricsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "operations": { "methods": { "list": { "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics/{evaluationMetricsId}/operations", "id": "aiplatform.projects.locations.evaluationMetrics.operations.list", "parameters": { "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/evaluationMetrics/[^/]+$", "type": "string" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" } }, "httpMethod": "GET" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics/{evaluationMetricsId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationMetrics/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationMetrics.operations.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "get": { "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationMetrics/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationMetrics/{evaluationMetricsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.evaluationMetrics.operations.get" } } } } }, "publishers": { "resources": { "models": { "methods": { "fetchPublisherModelConfig": { "path": "v1beta1/{+name}:fetchPublisherModelConfig", "response": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfig" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:fetchPublisherModelConfig", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`.", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.publishers.models.fetchPublisherModelConfig", "description": "Fetches the configs of publisher models.", "parameterOrder": [ "name" ] }, "setPublisherModelConfig": { "description": "Sets (creates or updates) configs of publisher models. For example, sets the request/response logging config.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:setPublisherModelConfig", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.publishers.models.setPublisherModelConfig", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`." } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1SetPublisherModelConfigRequest" }, "path": "v1beta1/{+name}:setPublisherModelConfig" }, "streamGenerateContent": { "httpMethod": "POST", "parameters": { "model": { "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "description": "Generate content with multimodal inputs with streaming support.", "path": "v1beta1/{+model}:streamGenerateContent", "id": "aiplatform.projects.locations.publishers.models.streamGenerateContent", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:streamGenerateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "model" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" } }, "export": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Exports a publisher model to a user provided Google Cloud Storage bucket.", "id": "aiplatform.projects.locations.publishers.models.export", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The Location to export the model weights from Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "name": { "type": "string", "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`", "pattern": "^publishers/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:export", "httpMethod": "POST", "path": "v1beta1/{+parent}/{+name}:export", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExportPublisherModelRequest" }, "parameterOrder": [ "parent", "name" ] }, "fetchPredictOperation": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+endpoint}:fetchPredictOperation", "id": "aiplatform.projects.locations.publishers.models.fetchPredictOperation", "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:fetchPredictOperation", "description": "Fetch an asynchronous online prediction operation.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "endpoint" ], "httpMethod": "POST" }, "countTokens": { "description": "Perform a token counting.", "path": "v1beta1/{+endpoint}:countTokens", "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensResponse" }, "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:countTokens", "request": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.publishers.models.countTokens" }, "embedContent": { "parameters": { "model": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*`" } }, "httpMethod": "POST", "parameterOrder": [ "model" ], "path": "v1beta1/{+model}:embedContent", "request": { "$ref": "GoogleCloudAiplatformV1beta1EmbedContentRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:embedContent", "description": "Embed content with multimodal inputs.", "id": "aiplatform.projects.locations.publishers.models.embedContent", "response": { "$ref": "GoogleCloudAiplatformV1beta1EmbedContentResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ] }, "computeTokens": { "path": "v1beta1/{+endpoint}:computeTokens", "request": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensRequest" }, "parameterOrder": [ "endpoint" ], "id": "aiplatform.projects.locations.publishers.models.computeTokens", "response": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensResponse" }, "httpMethod": "POST", "parameters": { "endpoint": { "type": "string", "description": "Required. The name of the Endpoint requested to get lists of tokens and token ids.", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "description": "Return a list of tokens based on the input text.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:computeTokens" }, "rawPredict": { "path": "v1beta1/{+endpoint}:rawPredict", "response": { "$ref": "GoogleApiHttpBody" }, "description": "Perform an online prediction with an arbitrary HTTP payload. The response includes the following HTTP headers: * `X-Vertex-AI-Endpoint-Id`: ID of the Endpoint that served this prediction. * `X-Vertex-AI-Deployed-Model-Id`: ID of the Endpoint's DeployedModel that served this prediction.", "parameters": { "endpoint": { "type": "string", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:rawPredict", "httpMethod": "POST", "parameterOrder": [ "endpoint" ], "id": "aiplatform.projects.locations.publishers.models.rawPredict", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RawPredictRequest" } }, "predictLongRunning": { "parameterOrder": [ "endpoint" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictLongRunningRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.publishers.models.predictLongRunning", "path": "v1beta1/{+endpoint}:predictLongRunning", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:predictLongRunning", "description": "" }, "getIamPolicy": { "path": "v1beta1/{+resource}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "response": { "$ref": "GoogleIamV1Policy" }, "parameterOrder": [ "resource" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer", "location": "query" }, "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:getIamPolicy", "id": "aiplatform.projects.locations.publishers.models.getIamPolicy" }, "serverStreamingPredict": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.publishers.models.serverStreamingPredict", "response": { "$ref": "GoogleCloudAiplatformV1beta1StreamingPredictResponse" }, "description": "Perform a server-side streaming online prediction request for Vertex LLM streaming.", "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamingPredictRequest" }, "parameters": { "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:serverStreamingPredict", "path": "v1beta1/{+endpoint}:serverStreamingPredict", "parameterOrder": [ "endpoint" ] }, "streamRawPredict": { "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:streamRawPredict", "path": "v1beta1/{+endpoint}:streamRawPredict", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamRawPredictRequest" }, "description": "Perform a streaming online prediction with an arbitrary HTTP payload.", "id": "aiplatform.projects.locations.publishers.models.streamRawPredict", "httpMethod": "POST", "parameterOrder": [ "endpoint" ], "parameters": { "endpoint": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "location": "path", "required": true } } }, "generateContent": { "path": "v1beta1/{+model}:generateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "description": "Generate content with multimodal inputs.", "httpMethod": "POST", "id": "aiplatform.projects.locations.publishers.models.generateContent", "parameters": { "model": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "parameterOrder": [ "model" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:generateContent" }, "predict": { "path": "v1beta1/{+endpoint}:predict", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}:predict", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictRequest" }, "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1PredictResponse" }, "description": "", "id": "aiplatform.projects.locations.publishers.models.predict", "parameters": { "endpoint": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "httpMethod": "POST" } }, "resources": { "invoke": { "methods": { "invoke": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "path": "v1beta1/{+endpoint}/invoke/{+invokeId}", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/models/{modelsId}/invoke/{invokeId}", "parameters": { "invokeId": { "type": "string", "location": "path", "required": true }, "endpoint": { "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } }, "id": "aiplatform.projects.locations.publishers.models.invoke.invoke", "request": { "$ref": "GoogleCloudAiplatformV1beta1InvokeRequest" }, "response": { "$ref": "GoogleApiHttpBody" }, "parameterOrder": [ "endpoint", "invokeId" ] } } } } }, "v1": { "methods": { "responses": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+endpoint}/v1/responses", "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request.", "request": { "$ref": "GoogleApiHttpBody" }, "response": { "$ref": "GoogleApiHttpBody" }, "id": "aiplatform.projects.locations.publishers.v1.responses", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/v1/responses", "parameters": { "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "type": "string", "location": "query" }, "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "endpoint" ] } }, "resources": { "responses": { "methods": { "compact": { "parameterOrder": [ "endpoint" ], "request": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+endpoint}/v1/responses/compact", "id": "aiplatform.projects.locations.publishers.v1.responses.compact", "parameters": { "endpoint": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+$" }, "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "type": "string", "location": "query" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/v1/responses/compact", "description": "Forwards arbitrary HTTP requests for both streaming and non-streaming cases. To use this method, invoke_route_prefix must be set to allow the paths that will be specified in the request." }, "delete": { "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/v1/responses/{responsesId}", "id": "aiplatform.projects.locations.publishers.v1.responses.delete", "parameters": { "name": { "description": "Required. The name of the Response resource to be deleted. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}/responses/{response}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/v1/responses/[^/]+$" } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Deletes the response from the endpoint.", "parameterOrder": [ "name" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}/v1/responses/{responsesId}", "id": "aiplatform.projects.locations.publishers.v1.responses.get", "response": { "$ref": "GoogleApiHttpBody" }, "description": "Gets the response from the endpoint.", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the Response resource. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}/responses/{response}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/v1/responses/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}" } } } } } } }, "reasoningEngines": { "methods": { "cancelAsyncQuery": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:cancelAsyncQuery", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineResponse" }, "path": "v1beta1/{+name}:cancelAsyncQuery", "description": "Cancels an AsyncQueryReasoningEngine operation.", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineRequest" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.cancelAsyncQuery" }, "getIamPolicy": { "id": "aiplatform.projects.locations.reasoningEngines.getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "httpMethod": "POST", "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "options.requestedPolicyVersion": { "format": "int32", "type": "integer", "location": "query", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" } }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" }, "id": "aiplatform.projects.locations.reasoningEngines.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "parameters": { "updateMask": { "type": "string", "description": "Optional. Mask specifying which fields to update.", "format": "google-fieldmask", "location": "query" }, "name": { "location": "path", "required": true, "description": "Identifier. The resource name of the ReasoningEngine. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}", "parameterOrder": [ "name" ], "description": "Updates a reasoning engine." }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.reasoningEngines.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the ReasoningEngine in. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/reasoningEngines", "description": "Creates a reasoning engine.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "query": { "description": "Queries using a reasoning engine.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:query", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "aiplatform.projects.locations.reasoningEngines.query", "parameters": { "name": { "type": "string", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse" }, "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest" }, "path": "v1beta1/{+name}:query" }, "asyncQuery": { "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.reasoningEngines.asyncQuery", "request": { "$ref": "GoogleCloudAiplatformV1beta1AsyncQueryReasoningEngineRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:asyncQuery", "path": "v1beta1/{+name}:asyncQuery", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Async query using a reasoning engine." }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a reasoning engine.", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "Required. The name of the ReasoningEngine resource to be deleted. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true }, "force": { "type": "boolean", "location": "query", "description": "Optional. If set to true, child resources of this reasoning engine will also be deleted. Otherwise, the request will fail with FAILED_PRECONDITION error when the reasoning engine has undeleted child resources." } }, "path": "v1beta1/{+name}" }, "get": { "parameters": { "name": { "description": "Required. The name of the ReasoningEngine resource. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" }, "id": "aiplatform.projects.locations.reasoningEngines.get", "parameterOrder": [ "name" ], "description": "Gets a reasoning engine.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "streamQuery": { "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}:streamQuery", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:streamQuery", "id": "aiplatform.projects.locations.reasoningEngines.streamQuery", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleApiHttpBody" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Streams queries using a reasoning engine.", "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest" } }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.testIamPermissions", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "path": "v1beta1/{+resource}:testIamPermissions", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." }, "permissions": { "location": "query", "type": "string", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "repeated": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:testIamPermissions", "httpMethod": "POST" }, "setIamPolicy": { "response": { "$ref": "GoogleIamV1Policy" }, "id": "aiplatform.projects.locations.reasoningEngines.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "parameterOrder": [ "resource" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string" } }, "httpMethod": "POST" }, "executeCode": { "path": "v1beta1/{+name}:executeCode", "response": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteCodeResponse" }, "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteCodeRequest" }, "id": "aiplatform.projects.locations.reasoningEngines.executeCode", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}:executeCode", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "httpMethod": "POST", "description": "Executes code statelessly." }, "list": { "parameterOrder": [ "parent" ], "description": "Lists reasoning engines in a location.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "aiplatform.projects.locations.reasoningEngines.list", "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "Optional. The standard list page size." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location to list the ReasoningEngines from. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListReasoningEnginesResponse" }, "path": "v1beta1/{+parent}/reasoningEngines" } }, "resources": { "examples": { "resources": { "operations": { "methods": { "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.reasoningEngines.examples.operations.wait" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "id": "aiplatform.projects.locations.reasoningEngines.examples.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "aiplatform.projects.locations.reasoningEngines.examples.operations.get", "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.reasoningEngines.examples.operations.delete", "parameterOrder": [ "name" ] } } } } }, "operations": { "methods": { "delete": { "id": "aiplatform.projects.locations.reasoningEngines.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string" } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameterOrder": [ "name" ] }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" } }, "id": "aiplatform.projects.locations.reasoningEngines.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.reasoningEngines.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.reasoningEngines.operations.cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}:cancel" } } }, "sandboxEnvironmentTemplates": { "methods": { "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/sandboxEnvironmentTemplates", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.create", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the reasoning engine to create the SandboxEnvironmentTemplate in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`.", "location": "path", "required": true } }, "description": "Creates a SandboxEnvironmentTemplate in a given reasoning engine.", "httpMethod": "POST" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironmentTemplates` call. Provide this to retrieve the subsequent page." }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Optional. The maximum number of SandboxEnvironmentTemplates to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironmentTemplates will be returned." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the reasoning engine to list sandbox environment templates from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentTemplatesResponse" }, "path": "v1beta1/{+parent}/sandboxEnvironmentTemplates", "description": "Lists SandboxEnvironmentTemplates in a given reasoning engine." }, "get": { "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment template. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate" }, "description": "Gets details of the specific SandboxEnvironmentTemplate.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the SandboxEnvironmentTemplate to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`" } }, "httpMethod": "DELETE", "description": "Deletes the specific SandboxEnvironmentTemplate.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } }, "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.get", "path": "v1beta1/{+name}" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size.", "type": "integer" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.list" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.wait", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentTemplates.operations.cancel", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." } } } } }, "memories": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.memories.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}" }, "list": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.memories.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." } } }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string", "format": "google-duration" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to wait on." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.reasoningEngines.memories.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "aiplatform.projects.locations.reasoningEngines.memories.operations.cancel", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "id": "aiplatform.projects.locations.reasoningEngines.memories.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } }, "revisions": { "methods": { "list": { "id": "aiplatform.projects.locations.reasoningEngines.memories.revisions.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/revisions", "path": "v1beta1/{+parent}/revisions", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "description": "Optional. The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$", "description": "Required. The resource name of the Memory to list revisions for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "description": "List Memory Revisions for a Memory." }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1MemoryRevision" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/revisions/{revisionsId}", "id": "aiplatform.projects.locations.reasoningEngines.memories.revisions.get", "description": "Get a Memory Revision.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "description": "Required. The resource name of the Memory Revision to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}/revisions/{revision}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+/revisions/[^/]+$" } }, "path": "v1beta1/{+name}", "httpMethod": "GET" } } } }, "methods": { "get": { "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "id": "aiplatform.projects.locations.reasoningEngines.memories.get", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$" } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "description": "Get a Memory." }, "create": { "id": "aiplatform.projects.locations.reasoningEngines.memories.create", "description": "Create a Memory.", "path": "v1beta1/{+parent}/memories", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "parent": { "description": "Required. The resource name of the ReasoningEngine to create the Memory under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "memoryId": { "location": "query", "description": "Optional. The user defined ID to use for memory, which will become the final component of the memory resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character must be a letter, and the last character must be a letter or number.", "type": "string" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "generate": { "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories:generate", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "parent": { "description": "Required. The resource name of the ReasoningEngine to generate memories for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+parent}/memories:generate", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.reasoningEngines.memories.generate", "description": "Generate memories.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "purge": { "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest" }, "path": "v1beta1/{+parent}/memories:purge", "id": "aiplatform.projects.locations.reasoningEngines.memories.purge", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Purge memories.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to purge memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories:purge" }, "ingestEvents": { "description": "Ingests events for a Memory Bank.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/memories:ingestEvents", "id": "aiplatform.projects.locations.reasoningEngines.memories.ingestEvents", "request": { "$ref": "GoogleCloudAiplatformV1beta1IngestEventsRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ReasoningEngine to ingest events to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories:ingestEvents" }, "patch": { "description": "Update a Memory.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "id": "aiplatform.projects.locations.reasoningEngines.memories.patch", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$", "description": "Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "location": "path", "required": true }, "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to update. The following fields are immutable: * `scope` * `memory_type`", "location": "query" } } }, "rollback": { "request": { "$ref": "GoogleCloudAiplatformV1beta1RollbackMemoryRequest" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Memory to rollback. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:rollback", "id": "aiplatform.projects.locations.reasoningEngines.memories.rollback", "description": "Rollback Memory to a specific revision.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}:rollback" }, "retrieve": { "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories:retrieve", "description": "Retrieve memories.", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to retrieve memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "id": "aiplatform.projects.locations.reasoningEngines.memories.retrieve", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories:retrieve", "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "retrieveProfiles": { "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories:retrieveProfiles", "parameters": { "parent": { "description": "Required. The resource name of the ReasoningEngine to retrieve profiles from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" } }, "id": "aiplatform.projects.locations.reasoningEngines.memories.retrieveProfiles", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves profiles.", "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest" }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories:retrieveProfiles" }, "list": { "httpMethod": "GET", "parameters": { "filter": { "location": "query", "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `scope` (as a JSON string with equality match only) * `topics` (i.e. `topics.custom_memory_topic_label: \"example topic\" OR topics.managed_memory_topic: USER_PREFERENCES`)" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the ReasoningEngine to list the Memories under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "pageSize": { "description": "Optional. The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. The standard list order by string. If not specified, the default order is `create_time desc`. If specified, the default sorting order of provided fields is ascending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time`" } }, "parameterOrder": [ "parent" ], "description": "List Memories.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoriesResponse" }, "id": "aiplatform.projects.locations.reasoningEngines.memories.list", "path": "v1beta1/{+parent}/memories" }, "delete": { "id": "aiplatform.projects.locations.reasoningEngines.memories.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Delete a Memory.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/memories/[^/]+$", "description": "Required. The resource name of the Memory to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" } }, "httpMethod": "DELETE" } } }, "sandboxEnvironments": { "resources": { "operations": { "methods": { "get": { "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.operations.get", "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$" } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted." } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.operations.list", "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "location": "path", "required": true }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" } }, "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" } } } } }, "methods": { "list": { "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.list", "parameters": { "parent": { "description": "Required. The resource name of the reasoning engine to list sandbox environments from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironments` call. Provide this to retrieve the subsequent page.", "location": "query" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Optional. The maximum number of SandboxEnvironments to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironments will be returned." } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists SandboxEnvironments in a given reasoning engine.", "path": "v1beta1/{+parent}/sandboxEnvironments", "parameterOrder": [ "parent" ] }, "pause": { "path": "v1beta1/{+name}:pause", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to pause. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "httpMethod": "POST", "description": "Pauses the specific SandboxEnvironment.", "request": { "$ref": "GoogleCloudAiplatformV1beta1PauseSandboxEnvironmentRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:pause", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.pause" }, "delete": { "description": "Deletes the specific SandboxEnvironment.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "type": "string", "description": "Required. The resource name of the SandboxEnvironment to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "snapshot": { "description": "Snapshots the specific SandboxEnvironment resource and creates a SandboxEnvironmentSnapshot resource.", "path": "v1beta1/{+name}:snapshot", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.snapshot", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:snapshot", "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot" }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to snapshot. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "bidiExecute": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:bidiExecute", "path": "v1beta1/{+name}:bidiExecute", "response": { "$ref": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentResponse" }, "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.bidiExecute", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Executes using a sandbox environment with bidirectional streaming.", "request": { "$ref": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentRequest" } }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments", "httpMethod": "POST", "description": "Creates a SandboxEnvironment in a given reasoning engine.", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The resource name of the reasoning engine to create the SandboxEnvironment in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`.", "type": "string" } }, "path": "v1beta1/{+parent}/sandboxEnvironments", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "description": "Gets details of the specific SandboxEnvironment.", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "Required. The resource name of the sandbox environment. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$" } }, "httpMethod": "GET" }, "execute": { "description": "Executes using a sandbox environment.", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentRequest" }, "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.execute", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:execute", "response": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:execute", "parameterOrder": [ "name" ] }, "authorizeAccess": { "request": { "$ref": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessRequest" }, "description": "Checks whether the caller is authorized to access the sandbox environment. Authorization is performed entirely by the API infrastructure from the `method_policy` below; the handler is a no-op. A successful response means the caller holds `sandboxEnvironments.execute` on the named sandbox. Used by the sandbox data-plane proxy, which forwards the caller's credential and proxies traffic only on success.", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.authorizeAccess", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:authorizeAccess", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "type": "string", "description": "Required. The resource name of the sandbox environment to authorize access to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "path": "v1beta1/{+name}:authorizeAccess", "httpMethod": "POST" }, "resume": { "path": "v1beta1/{+name}:resume", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Resumes the specific SandboxEnvironment.", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironments.resume", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:resume", "parameters": { "name": { "description": "Required. The resource name of the sandbox environment to resume. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ResumeSandboxEnvironmentRequest" }, "httpMethod": "POST" } } }, "a2aTasks": { "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/a2aTasks/[^/]+$", "description": "Required. The resource name of the A2aTask to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/a2aTasks/{a2a_task}` or `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTasks/{a2a_task}`", "type": "string" } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Deletes an A2aTask.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks/{a2aTasksId}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.delete" }, "appendEvents": { "parameterOrder": [ "name" ], "description": "Appends TaskEvents to an A2aTask.", "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.appendEvents", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks/{a2aTasksId}:appendEvents", "response": { "$ref": "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsResponse" }, "path": "v1beta1/{+name}:appendEvents", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/a2aTasks/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the A2aTask to append events to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/a2aTasks/{a2a_task}` or `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTasks/{a2a_task}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsRequest" } }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/a2aTasks/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the A2aTask. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/a2aTasks/{a2a_task}` or `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTasks/{a2a_task}`" }, "view": { "location": "query", "description": "Optional. The view of the A2aTask to return.", "type": "string", "enumDescriptions": [ "Task view unspecified.", "Task header only (status, metadata, timestamps)", "Full materialized state (artifacts + history)" ], "enum": [ "A2A_TASK_VIEW_UNSPECIFIED", "A2A_TASK_VIEW_BASIC", "A2A_TASK_VIEW_FULL" ] } }, "description": "Gets an A2aTask.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks/{a2aTasksId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1A2aTask" } }, "create": { "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ReasoningEngine or TaskStore to create the A2aTask under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}` or `projects/{project}/locations/{location}/taskStores/{task_store}`" }, "a2aTaskId": { "description": "Required. User-defined ID of the A2aTask. This ID must be unique within the parent resource. It must be 1-63 characters, start with a lowercase letter or number, end with a lowercase letter or number, and only contain lowercase letters, numbers, and hyphens [AIP-122](https://google.aip.dev/122). Starting with a number is allowed for compatibility with the auto-generated UUID from A2A SDK.", "location": "query", "type": "string" } }, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1A2aTask" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/a2aTasks", "request": { "$ref": "GoogleCloudAiplatformV1beta1A2aTask" }, "description": "Creates an A2aTask.", "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.create" }, "list": { "description": "Lists A2aTasks for a ReasoningEngine.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks", "path": "v1beta1/{+parent}/a2aTasks", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListA2aTasksResponse" }, "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.list", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "description": "Optional. The next_page_token value returned from a previous list ListA2aTasks call.", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine or TaskStore to list the A2aTasks under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}` or `projects/{project}/locations/{location}/taskStores/{task_store}`" }, "orderBy": { "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. If this field is omitted, the default ordering is `create_time` descending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time` Example: `create_time desc`.", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. The maximum number of tasks to return. The service may return fewer than this value. If unspecified, at most 10 tasks will be returned. The maximum value is 100; values above 100 will hit exception." }, "filter": { "location": "query", "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `context_id` * `state` Example: `context_id=\"abc\"`, `state=\"WORKING\"`." } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "events": { "methods": { "list": { "id": "aiplatform.projects.locations.reasoningEngines.a2aTasks.events.list", "description": "Lists TaskEvents for an A2aTask.", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "description": "Optional. The next_page_token value returned from a previous list ListA2aTaskEvents call.", "location": "query" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order the results by. If this field is omitted, the results will be ordered by `event_sequence_number` in descending order. For each field, the default sort order is ascending. To specify descending order for a field, append a ` desc` suffix. For example: `create_time desc`. Supported fields: * `create_time` * `event_sequence_number`" }, "parent": { "description": "Required. The resource name of the A2aTask to list the TaskEvents under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/a2aTasks/{a2a_task}` or `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTasks/{a2a_task}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/a2aTasks/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "location": "query", "description": "Optional. The standard list filter. Supported fields: * `create_time` range (i.e. `create_time\u003e=\"2025-01-31T11:30:00-04:00\"` where the timestamp is in RFC 3339 format) More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "pageSize": { "description": "Optional. The maximum number of events to return. The service may return fewer than this value. If unspecified, at most 100 events will be returned. The maximum value is 100; values above 100 will hit exception.", "format": "int32", "location": "query", "type": "integer" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/events", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2aTasks/{a2aTasksId}/events", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListA2aTaskEventsResponse" }, "parameterOrder": [ "parent" ] } } } } }, "sandboxEnvironmentSnapshots": { "methods": { "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Gets details of the specific SandboxEnvironmentSnapshot.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "type": "string", "description": "Required. The resource name of the sandbox environment snapshot. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.get" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}", "description": "Deletes the specific SandboxEnvironmentSnapshot.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The resource name of the SandboxEnvironmentSnapshot to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "type": "string" } } }, "list": { "parameterOrder": [ "parent" ], "description": "Lists SandboxEnvironmentSnapshots in a given reasoning engine.", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironmentSnapshots` call. Provide this to retrieve the subsequent page." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the reasoning engine to list sandbox environments from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "filter": { "location": "query", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "pageSize": { "description": "Optional. The maximum number of SandboxEnvironmentSnapshots to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironmentSnapshots will be returned. Values above 100 will be coerced to 100.", "format": "int32", "type": "integer", "location": "query" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentSnapshotsResponse" }, "path": "v1beta1/{+parent}/sandboxEnvironmentSnapshots" } }, "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ] }, "cancel": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.cancel" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.reasoningEngines.sandboxEnvironmentSnapshots.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "sessions": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}", "description": "Deletes details of the specific Session.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sessions.delete", "httpMethod": "DELETE", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the session. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`" } } }, "compact": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:compact", "description": "Compacts the event history of a given Session, which may run an LLM summarization call and rewrite the full event history. Compaction is a storage-side rewrite that can apply a stackable pipeline of rules (event-horizon preservation, tool-response truncation, thought stripping, and LLM summarization etc.)", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}:compact", "id": "aiplatform.projects.locations.reasoningEngines.sessions.compact", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "Required. The resource name of the session to compact. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1CompactSessionRequest" }, "parameterOrder": [ "name" ] }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the specific Session.", "httpMethod": "PATCH", "parameters": { "updateMask": { "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.", "type": "string", "location": "query", "format": "google-fieldmask" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$", "description": "Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'." } }, "id": "aiplatform.projects.locations.reasoningEngines.sessions.patch" }, "appendEvent": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the session to append event to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$" } }, "description": "Appends an event to a given session.", "request": { "$ref": "GoogleCloudAiplatformV1beta1SessionEvent" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:appendEvent", "response": { "$ref": "GoogleCloudAiplatformV1beta1AppendEventResponse" }, "id": "aiplatform.projects.locations.reasoningEngines.sessions.appendEvent", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}:appendEvent" }, "get": { "id": "aiplatform.projects.locations.reasoningEngines.sessions.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "description": "Gets details of the specific Session.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The resource name of the session. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$" } } }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "description": "Creates a new Session.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions", "id": "aiplatform.projects.locations.reasoningEngines.sessions.create", "path": "v1beta1/{+parent}/sessions", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the location to create the session in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true }, "sessionId": { "type": "string", "description": "Optional. The user defined ID to use for session, which will become the final component of the session resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first and last characters must be a letter or number.", "location": "query" } }, "httpMethod": "POST" }, "list": { "description": "Lists Sessions in a given reasoning engine.", "httpMethod": "GET", "parameterOrder": [ "parent" ], "parameters": { "pageSize": { "description": "Optional. The maximum number of sessions to return. The service may return fewer than this value. If unspecified, the default page size is 100. Values greater than 100 will be capped at 100.", "location": "query", "type": "integer", "format": "int32" }, "filter": { "description": "Optional. The standard list filter. Supported fields: * `display_name` * `user_id` * `labels` Example: `display_name=\"abc\"`, `user_id=\"123\"`, `labels.key=\"value\"`.", "location": "query", "type": "string" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `create_time` * `update_time` Example: `create_time desc`." }, "parent": { "description": "Required. The resource name of the location to list sessions from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageToken": { "type": "string", "description": "Optional. The next_page_token value returned from a previous list SessionService.ListSessions call.", "location": "query" } }, "id": "aiplatform.projects.locations.reasoningEngines.sessions.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions", "path": "v1beta1/{+parent}/sessions", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSessionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "events": { "methods": { "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/events", "id": "aiplatform.projects.locations.reasoningEngines.sessions.events.list", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/events", "description": "Lists Events in a given session.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEventsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "filter": { "location": "query", "description": "Optional. The standard list filter. Supported fields: * `timestamp` range (i.e. `timestamp\u003e=\"2025-01-31T11:30:00-04:00\"` where the timestamp is in RFC 3339 format) More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `timestamp` Example: `timestamp desc`." }, "pageToken": { "description": "Optional. The next_page_token value returned from a previous list SessionService.ListEvents call.", "type": "string", "location": "query" }, "pageSize": { "description": "Optional. The maximum number of events to return. The service may return fewer than this value. If unspecified, at most 100 events will be returned. These events are ordered by timestamp in ascending order.", "type": "integer", "location": "query", "format": "int32" }, "parent": { "description": "Required. The resource name of the session to list events from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$" } } } } }, "operations": { "methods": { "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.reasoningEngines.sessions.operations.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sessions.operations.get" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+$", "type": "string", "description": "The name of the operation's parent resource." }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" } }, "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.sessions.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.reasoningEngines.sessions.operations.wait", "parameterOrder": [ "name" ], "parameters": { "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}:wait" }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.reasoningEngines.sessions.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." } } } } }, "a2a": { "resources": { "tasks": { "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "parameterOrder": [ "name", "a2aEndpoint" ] } } } }, "methods": { "subscribe": { "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}:subscribe", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks.subscribe", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "httpMethod": "GET", "parameters": { "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`.", "location": "path", "required": true, "pattern": "^tasks/[^/]+$", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis." }, "cancel": { "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}:cancel", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "a2aEndpoint": { "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^tasks/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks.cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "pushNotificationConfigs": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^tasks/[^/]+/pushNotificationConfigs$" }, "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks.pushNotificationConfigs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}/pushNotificationConfigs" }, "a2aGetReasoningEngine": { "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks.a2aGetReasoningEngine", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string", "location": "query" }, "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^tasks/[^/]+$" } }, "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" } } }, "v1": { "methods": { "tasks": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "httpMethod": "GET", "parameters": { "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true }, "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^v1/tasks$" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "card": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/card", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/card$" }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.card" }, "extendedAgentCard": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "httpMethod": "GET", "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.extendedAgentCard", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "pattern": "^v1/extendedAgentCard$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/extendedAgentCard", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } } }, "resources": { "message": { "methods": { "stream": { "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL." }, "a2aEndpoint": { "type": "string", "location": "path", "required": true, "pattern": "^v1/message$", "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/message:stream", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.message.stream", "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis." }, "send": { "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.message.send", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/message:send", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL." }, "a2aEndpoint": { "pattern": "^v1/message$", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "httpMethod": "POST", "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send" } } }, "tasks": { "methods": { "cancel": { "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks.cancel", "request": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}:cancel", "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true }, "a2aEndpoint": { "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "subscribe": { "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "a2aEndpoint": { "type": "string", "pattern": "^v1/tasks/[^/]+$", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`." } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}:subscribe", "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks.subscribe", "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "a2aGetReasoningEngine": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks.a2aGetReasoningEngine", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "a2aEndpoint": { "pattern": "^v1/tasks/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}", "httpMethod": "GET", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "pushNotificationConfigs": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string", "location": "query" } }, "httpMethod": "GET", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks.pushNotificationConfigs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ] } }, "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "id": "aiplatform.projects.locations.reasoningEngines.a2a.v1.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs/[^/]+$" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "httpMethod": "GET", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" } } } } } } }, "message": { "methods": { "stream": { "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.projects.locations.reasoningEngines.a2a.message.stream", "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string" }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream.", "type": "string", "location": "path", "required": true, "pattern": "^message$" } }, "httpMethod": "POST", "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/message:stream" }, "send": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "id": "aiplatform.projects.locations.reasoningEngines.a2a.message.send", "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/message:send", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true, "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^message$", "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "name", "a2aEndpoint" ] } } } }, "methods": { "tasks": { "id": "aiplatform.projects.locations.reasoningEngines.a2a.tasks", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/tasks", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "httpMethod": "GET", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "parameters": { "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^tasks$", "type": "string" }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "location": "path", "required": true } } }, "extendedAgentCard": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.a2a.extendedAgentCard", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "a2aEndpoint": { "pattern": "^extendedAgentCard$", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/extendedAgentCard" }, "card": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "a2aEndpoint": { "pattern": "^card$", "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/a2a/card", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.a2a.card" } } }, "feedbackEntries": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}:cancel", "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.operations.cancel", "path": "v1beta1/{+name}:cancel" }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations", "parameters": { "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+$" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.operations.wait", "path": "v1beta1/{+name}:wait", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string" }, "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}:wait", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.operations.delete", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } } } }, "methods": { "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.patch", "description": "Updates an existing FeedbackEntry. Only the fields specified in update_mask are modified. If the mask is empty, all mutable fields are replaced with the values supplied in the request.", "parameters": { "updateMask": { "format": "google-fieldmask", "location": "query", "description": "Optional. The field mask that controls which fields are updated. If unset or empty, all mutable fields of the FeedbackEntry are replaced with the values from feedback_entry.", "type": "string" }, "name": { "description": "Identifier. The resource name. Assigned by the server on create. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackEntry" } }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.delete", "path": "v1beta1/{+name}", "description": "Deletes a FeedbackEntry and its associated FeedbackContext.", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+$", "type": "string", "description": "Required. The resource name of the FeedbackEntry to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}`", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "updateFeedbackContext": { "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.updateFeedbackContext", "description": "Updates the FeedbackContext associated with a FeedbackEntry. Only the fields specified in update_mask are modified. If the mask is empty, all mutable fields are replaced with the values supplied in the request.", "httpMethod": "PATCH", "parameters": { "updateMask": { "description": "Optional. The field mask that controls which fields are updated. If unset or empty, all mutable fields of the FeedbackContext are replaced with the values from feedback_context.", "location": "query", "type": "string", "format": "google-fieldmask" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/feedbackContext$", "description": "Identifier. The resource name. Assigned by the server on create. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}/feedbackContext`", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/feedbackContext", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackContext" }, "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeedbackEntriesResponse" }, "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries", "path": "v1beta1/{+parent}/feedbackEntries", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine from which to list FeedbackEntries. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order results by, sorted in ascending order by default. Append ` desc` after a field name to sort that field in descending order. Supported fields: * `create_time` * `update_time` Example: `create_time desc`." }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous ListFeedbackEntries call.", "location": "query" }, "filter": { "description": "Optional. Standard list filter. Supported fields: * `session_id` * `user_id` * `feedback_type` * `feedback_labels`: Supports the HAS operator (`:`). For example: `feedback_labels:\"inaccurate\"`. * `create_time` * `update_time` Example: `feedback_type=\"THUMBS_DOWN\" AND feedback_labels:\"hallucination\"`.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of FeedbackEntries to return per page.", "location": "query", "format": "int32" } }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists FeedbackEntries in a ReasoningEngine." }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackEntry" }, "description": "Retrieves a single FeedbackEntry by its resource name.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.get", "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+$", "description": "Required. The resource name of the FeedbackEntry to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}`", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ] }, "getFeedbackContext": { "response": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackContext" }, "parameters": { "name": { "description": "Required. The resource name of the FeedbackContext to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}/feedbackContext`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/feedbackEntries/[^/]+/feedbackContext$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "description": "Retrieves the FeedbackContext associated with a FeedbackEntry.", "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.getFeedbackContext", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/feedbackContext", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "create": { "description": "Creates a new FeedbackEntry.", "request": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackEntry" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "parent": { "description": "Required. The resource name of the ReasoningEngine in which to create the FeedbackEntry. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$" } }, "path": "v1beta1/{+parent}/feedbackEntries", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/feedbackEntries", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.reasoningEngines.feedbackEntries.create" } } }, "runtimeRevisions": { "methods": { "list": { "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListReasoningEngineRuntimeRevisionsResponse" }, "description": "Lists runtime revisions in a reasoning engine.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions", "path": "v1beta1/{+parent}/runtimeRevisions", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to list the ReasoningEngineRuntimeRevisions from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "filter": { "type": "string", "location": "query", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160)." }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. The maximum number of ReasoningEngineRuntimeRevisions to return. The service may return fewer than this value. If unspecified, at most 50 revisions will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "type": "integer" }, "pageToken": { "location": "query", "description": "Optional. The standard list page token.", "type": "string" } }, "httpMethod": "GET", "parameterOrder": [ "parent" ] }, "query": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Queries using a reasoning engine.", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}:query", "path": "v1beta1/{+name}:query", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.query" }, "delete": { "description": "Deletes a reasoning engine revision.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.delete", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The name of the ReasoningEngineRuntimeRevision resource to be deleted. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/runtimeRevisions/{runtime_revision}`" } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "get": { "description": "Gets a reasoning engine runtime revision.", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}", "path": "v1beta1/{+name}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the ReasoningEngineRuntimeRevision resource. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/runtimeRevisions/{runtimeRevision}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineRuntimeRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ] }, "streamQuery": { "path": "v1beta1/{+name}:streamQuery", "description": "Streams queries using a reasoning engine.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}:streamQuery", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.streamQuery", "parameters": { "name": { "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest" }, "httpMethod": "POST", "response": { "$ref": "GoogleApiHttpBody" } } }, "resources": { "operations": { "methods": { "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.operations.delete", "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.operations.list", "parameterOrder": [ "name" ] }, "wait": { "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.operations.wait", "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string", "format": "google-duration" } }, "httpMethod": "POST" }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.operations.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET" }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." } } }, "a2a": { "methods": { "extendedAgentCard": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/extendedAgentCard", "parameters": { "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^extendedAgentCard$", "type": "string", "location": "path", "required": true }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.extendedAgentCard", "parameterOrder": [ "name", "a2aEndpoint" ] }, "tasks": { "httpMethod": "GET", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "type": "string", "pattern": "^tasks$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "card": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.card", "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/card", "httpMethod": "GET", "parameters": { "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^card$", "type": "string" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "message": { "methods": { "send": { "httpMethod": "POST", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.message.send", "parameters": { "a2aEndpoint": { "type": "string", "pattern": "^message$", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/message:send", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis." }, "stream": { "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "a2aEndpoint": { "pattern": "^message$", "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream." } }, "httpMethod": "POST", "request": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/message:stream", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.message.stream", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream" } } }, "v1": { "methods": { "extendedAgentCard": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/extendedAgentCard", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.extendedAgentCard", "httpMethod": "GET", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^v1/extendedAgentCard$" }, "name": { "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "tasks": { "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameters": { "name": { "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^v1/tasks$", "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" } }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks", "httpMethod": "GET", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" }, "card": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/card", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "httpMethod": "GET", "parameters": { "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^v1/card$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true } }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.card", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ] } }, "resources": { "message": { "methods": { "stream": { "httpMethod": "POST", "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "a2aEndpoint": { "pattern": "^v1/message$", "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream." }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.message.stream", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/message:stream", "response": { "$ref": "GoogleApiHttpBody" } }, "send": { "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.message.send", "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "parameters": { "a2aEndpoint": { "type": "string", "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^v1/message$", "location": "path", "required": true }, "name": { "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/message:send" } } }, "tasks": { "methods": { "a2aGetReasoningEngine": { "httpMethod": "GET", "parameters": { "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^v1/tasks/[^/]+$" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks.a2aGetReasoningEngine" }, "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}:cancel", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks.cancel", "request": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "httpMethod": "POST", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "type": "string", "pattern": "^v1/tasks/[^/]+$" }, "name": { "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "parameterOrder": [ "name", "a2aEndpoint" ] }, "subscribe": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "location": "path", "required": true }, "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`.", "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+$" } }, "httpMethod": "GET", "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks.subscribe", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}:subscribe", "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "response": { "$ref": "GoogleApiHttpBody" } }, "pushNotificationConfigs": { "parameters": { "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs$", "type": "string" } }, "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks.pushNotificationConfigs", "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs" } }, "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.v1.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameters": { "a2aEndpoint": { "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "location": "path", "required": true }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" } } } } } } }, "tasks": { "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "parameterOrder": [ "name", "a2aEndpoint" ], "httpMethod": "GET" } } } }, "methods": { "pushNotificationConfigs": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^tasks/[^/]+/pushNotificationConfigs$", "type": "string" }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" } }, "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks.pushNotificationConfigs", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}/pushNotificationConfigs" }, "a2aGetReasoningEngine": { "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks.a2aGetReasoningEngine", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string" }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "location": "path", "required": true, "pattern": "^tasks/[^/]+$" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" } } }, "subscribe": { "parameterOrder": [ "name", "a2aEndpoint" ], "httpMethod": "GET", "parameters": { "a2aEndpoint": { "pattern": "^tasks/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks.subscribe", "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleApiHttpBody" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}:subscribe", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe" }, "cancel": { "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^tasks/[^/]+$" }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "httpMethod": "POST", "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}:cancel", "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.projects.locations.reasoningEngines.runtimeRevisions.a2a.tasks.cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel" } } } } } } } } }, "evaluationExperiments": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationExperiments/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the EvaluationExperiment resource. Format: `projects/{project}/locations/{location}/evaluationExperiments/{evaluation_experiment}`" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationExperiments/{evaluationExperimentsId}", "description": "Gets an Evaluation Experiment.", "id": "aiplatform.projects.locations.evaluationExperiments.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationExperiments.delete", "description": "Deletes an Evaluation Experiment.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationExperiments/{evaluationExperimentsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/evaluationExperiments/[^/]+$", "description": "Required. The name of the EvaluationExperiment resource to be deleted. Format: `projects/{project}/locations/{location}/evaluationExperiments/{evaluation_experiment}`" } } }, "patch": { "description": "Updates an Evaluation Experiment.", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationExperiments/{evaluationExperimentsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationExperiments/[^/]+$", "description": "Identifier. The resource name of the EvaluationExperiment. This is a unique identifier. Format: `projects/{project}/locations/{location}/evaluationExperiments/{evaluation_experiment}`", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Optional. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationExperiments.patch", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "create": { "id": "aiplatform.projects.locations.evaluationExperiments.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationExperiments", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "path": "v1beta1/{+parent}/evaluationExperiments", "description": "Creates an Evaluation Experiment.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the Evaluation Experiment in. Format: `projects/{project}/locations/{location}`" } } }, "list": { "path": "v1beta1/{+parent}/evaluationExperiments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Lists Evaluation Experiments.", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the Evaluation Experiments. Format: `projects/{project}/locations/{location}`", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending." }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Optional. The maximum number of Evaluation Experiments to return." }, "filter": { "description": "Optional. Filter expression that matches a subset of the EvaluationExperiments to show. For field names both snake_case and camelCase are supported. For more information about filter syntax, see [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. A page token, received from a previous `ListEvaluationExperiments` call. Provide this to retrieve the subsequent page." } }, "id": "aiplatform.projects.locations.evaluationExperiments.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationExperiments", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEvaluationExperimentsResponse" } } } }, "featureGroups": { "methods": { "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.featureGroups.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}", "parameters": { "force": { "type": "boolean", "location": "query", "description": "If set to true, any Features under this FeatureGroup will also be deleted. (Otherwise, the request will only work if the FeatureGroup has no Features.)" }, "name": { "location": "path", "required": true, "description": "Required. The name of the FeatureGroup to be deleted. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "type": "string" } }, "description": "Deletes a single FeatureGroup.", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "setIamPolicy": { "id": "aiplatform.projects.locations.featureGroups.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$" } }, "httpMethod": "POST", "path": "v1beta1/{+resource}:setIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}:setIamPolicy" }, "get": { "id": "aiplatform.projects.locations.featureGroups.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroup" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}", "description": "Gets details of a single FeatureGroup.", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the FeatureGroup resource." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "getIamPolicy": { "parameters": { "options.requestedPolicyVersion": { "type": "integer", "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query" }, "resource": { "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$" } }, "httpMethod": "POST", "path": "v1beta1/{+resource}:getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "aiplatform.projects.locations.featureGroups.getIamPolicy", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "id": "aiplatform.projects.locations.featureGroups.patch", "parameters": { "updateMask": { "description": "Field mask is used to specify the fields to be overwritten in the FeatureGroup resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `description` * `big_query` * `big_query.entity_id_columns` * `service_agent_type`", "format": "google-fieldmask", "location": "query", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "description": "Identifier. Name of the FeatureGroup. Format: `projects/{project}/locations/{location}/featureGroups/{featureGroup}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroup" }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Updates the parameters of a single FeatureGroup.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}", "path": "v1beta1/{+name}" }, "list": { "description": "Lists FeatureGroups in a given project and location.", "id": "aiplatform.projects.locations.featureGroups.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureGroupsResponse" }, "parameters": { "filter": { "type": "string", "description": "Lists the FeatureGroups that match the filter expression. The following fields are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality and key presence. Examples: * `create_time \u003e \"2020-01-01\" OR update_time \u003e \"2020-01-01\"` FeatureGroups created or updated after 2020-01-01. * `labels.env = \"prod\"` FeatureGroups with label \"env\" set to \"prod\".", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The maximum number of FeatureGroups to return. The service may return fewer than this value. If unspecified, at most 100 FeatureGroups will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100." }, "pageToken": { "description": "A page token, received from a previous FeatureRegistryService.ListFeatureGroups call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureRegistryService.ListFeatureGroups must match the call that provided the page token.", "type": "string", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to list FeatureGroups. Format: `projects/{project}/locations/{location}`" }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported Fields: * `create_time` * `update_time`", "type": "string", "location": "query" } }, "path": "v1beta1/{+parent}/featureGroups", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups" }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "permissions": { "repeated": true, "type": "string", "location": "query", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions)." }, "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/{+resource}:testIamPermissions", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "parameterOrder": [ "resource" ], "id": "aiplatform.projects.locations.featureGroups.testIamPermissions", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}:testIamPermissions" }, "create": { "httpMethod": "POST", "path": "v1beta1/{+parent}/featureGroups", "parameters": { "featureGroupId": { "location": "query", "type": "string", "description": "Required. The ID to use for this FeatureGroup, which will become the final component of the FeatureGroup's resource name. This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within the project and location." }, "parent": { "description": "Required. The resource name of the Location to create FeatureGroups. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new FeatureGroup in a given project and location.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups", "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroup" }, "id": "aiplatform.projects.locations.featureGroups.create", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ] } }, "resources": { "features": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The name of the Features to be deleted. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}` `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureGroups.features.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Deletes a single Feature.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Feature" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureGroups.features.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}", "description": "Gets details of a single Feature.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "featureStatsAndAnomalySpec.statsTimeRange.endTime": { "type": "string", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "format": "google-datetime", "location": "query" }, "name": { "description": "Required. The name of the Feature resource. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+$", "location": "path", "required": true }, "featureStatsAndAnomalySpec.statsTimeRange.startTime": { "type": "string", "location": "query", "format": "google-datetime", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "featureStatsAndAnomalySpec.latestStatsCount": { "location": "query", "description": "Optional. If set, returns the most recent count of stats. Valid value is [0, 100]. If stats_time_range is set, return most recent count of stats within the stats_time_range.", "format": "int32", "type": "integer" } }, "httpMethod": "GET", "path": "v1beta1/{+name}" }, "batchCreate": { "parameterOrder": [ "parent" ], "description": "Creates a batch of Features in a given FeatureGroup.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "type": "string", "description": "Required. The resource name of the EntityType/FeatureGroup to create the batch of Features under. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.featureGroups.features.batchCreate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features:batchCreate", "path": "v1beta1/{+parent}/features:batchCreate", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateFeaturesRequest" } }, "patch": { "parameters": { "name": { "description": "Immutable. Name of the Feature. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}` `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}` The last part feature is assigned by the client. The feature can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given an entity type.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+$" }, "updateMask": { "description": "Field mask is used to specify the fields to be overwritten in the Features resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `description` * `labels` * `disable_monitoring` (Not supported for FeatureRegistryService Feature) * `point_of_contact` (Not supported for FeaturestoreService FeatureStore)", "format": "google-fieldmask", "location": "query", "type": "string" } }, "httpMethod": "PATCH", "description": "Updates the parameters of a single Feature.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.featureGroups.features.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Feature" } }, "create": { "id": "aiplatform.projects.locations.featureGroups.features.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1Feature" }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates a new Feature in a given FeatureGroup.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/features", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "description": "Required. The resource name of the EntityType or FeatureGroup to create a Feature. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`" }, "featureId": { "location": "query", "description": "Required. The ID to use for the Feature, which will become the final component of the Feature's resource name. This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within an EntityType/FeatureGroup.", "type": "string" } }, "httpMethod": "POST" }, "list": { "parameters": { "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous FeaturestoreService.ListFeatures call or FeatureRegistryService.ListFeatures call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeaturestoreService.ListFeatures or FeatureRegistryService.ListFeatures must match the call that provided the page token." }, "latestStatsCount": { "location": "query", "format": "int32", "description": "Only applicable for Vertex AI Feature Store (Legacy). If set, return the most recent ListFeaturesRequest.latest_stats_count of stats for each Feature in response. Valid value is [0, 10]. If number of stats exists \u003c ListFeaturesRequest.latest_stats_count, return all existing stats.", "type": "integer" }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location to list Features. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The maximum number of Features to return. The service may return fewer than this value. If unspecified, at most 1000 Features will be returned. The maximum value is 1000; any value greater than 1000 will be coerced to 1000." }, "readMask": { "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "type": "string", "location": "query" }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `feature_id` * `value_type` (Not supported for FeatureRegistry Feature) * `create_time` * `update_time`", "type": "string", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "Lists the Features that match the filter expression. The following filters are supported: * `value_type`: Supports = and != comparisons. * `create_time`: Supports =, !=, \u003c, \u003e, \u003e=, and \u003c= comparisons. Values must be in RFC 3339 format. * `update_time`: Supports =, !=, \u003c, \u003e, \u003e=, and \u003c= comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality as well as key presence. Examples: * `value_type = DOUBLE` --\u003e Features whose type is DOUBLE. * `create_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\" OR update_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\"` --\u003e EntityTypes created or updated after 2020-01-31T15:30:00.000000Z. * `labels.active = yes AND labels.env = prod` --\u003e Features having both (active: yes) and (env: prod) labels. * `labels.env: *` --\u003e Any Feature which has a label with 'env' as the key." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.featureGroups.features.list", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/features", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeaturesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Features in a given FeatureGroup.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features" } }, "resources": { "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.featureGroups.features.operations.list", "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}/operations", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+/operations/[^/]+$", "type": "string" } }, "id": "aiplatform.projects.locations.featureGroups.features.operations.wait", "path": "v1beta1/{+name}:wait" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featureGroups.features.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "get": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}", "id": "aiplatform.projects.locations.featureGroups.features.operations.get", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/features/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "operations": { "methods": { "delete": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted." } }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "id": "aiplatform.projects.locations.featureGroups.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/operations/{operationsId}" }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.featureGroups.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." } }, "httpMethod": "GET" }, "wait": { "id": "aiplatform.projects.locations.featureGroups.operations.wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "parameters": { "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/operations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureGroups.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/operations/[^/]+$" } } } } }, "featureMonitors": { "methods": { "create": { "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of FeatureGroup to create FeatureMonitor. Format: `projects/{project}/locations/{location}/featureGroups/{featuregroup}`" }, "featureMonitorId": { "location": "query", "description": "Required. The ID to use for this FeatureMonitor, which will become the final component of the FeatureGroup's resource name. This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within the FeatureGroup.", "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitor" }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.featureGroups.featureMonitors.create", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new FeatureMonitor in a given project, location and FeatureGroup.", "path": "v1beta1/{+parent}/featureMonitors" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featureGroups.featureMonitors.list", "path": "v1beta1/{+parent}/featureMonitors", "description": "Lists FeatureGroups in a given project and location.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors", "httpMethod": "GET", "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported Fields: * `create_time` * `update_time`" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+$", "type": "string", "description": "Required. The resource name of the FeatureGroup to list FeatureMonitors. Format: `projects/{project}/locations/{location}/featureGroups/{featureGroup}`" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Optional. The maximum number of FeatureGroups to return. The service may return fewer than this value. If unspecified, at most 100 FeatureMonitors will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100." }, "filter": { "type": "string", "location": "query", "description": "Optional. Lists the FeatureMonitors that match the filter expression. The following fields are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality and key presence. Examples: * `create_time \u003e \"2020-01-01\" OR update_time \u003e \"2020-01-01\"` FeatureMonitors created or updated after 2020-01-01. * `labels.env = \"prod\"` FeatureGroups with label \"env\" set to \"prod\"." }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous FeatureRegistryService.ListFeatureMonitors call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureRegistryService.ListFeatureMonitors must match the call that provided the page token.", "location": "query" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureMonitorsResponse" } }, "patch": { "parameters": { "updateMask": { "location": "query", "description": "Optional. Field mask is used to specify the fields to be overwritten in the FeatureMonitor resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `description` * `schedule_config` * `feature_selection_config`", "format": "google-fieldmask", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$", "description": "Identifier. Name of the FeatureMonitor. Format: `projects/{project}/locations/{location}/featureGroups/{featureGroup}/featureMonitors/{featureMonitor}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "PATCH", "description": "Updates the parameters of a single FeatureMonitor.", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitor" }, "path": "v1beta1/{+name}" }, "get": { "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the FeatureMonitor resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$" } }, "httpMethod": "GET", "description": "Gets details of a single FeatureMonitor.", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitor" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$", "description": "Required. The name of the FeatureMonitor to be deleted. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}/featureMonitors/{feature_monitor}`", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.delete", "description": "Deletes a single FeatureMonitor.", "parameterOrder": [ "name" ] } }, "resources": { "featureMonitorJobs": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the FeatureMonitorJob resource. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}/featureMonitors/{feature_monitor}/featureMonitorJobs/{feature_monitor_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+/featureMonitorJobs/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get a feature monitor job.", "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitorJob" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/featureMonitorJobs/{featureMonitorJobsId}", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.get" }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/featureMonitorJobs", "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitorJob" }, "description": "Creates a new feature monitor job.", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.create", "httpMethod": "POST", "path": "v1beta1/{+parent}/featureMonitorJobs", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$", "description": "Required. The resource name of FeatureMonitor to create FeatureMonitorJob. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}/featureMonitors/{feature_monitor}`" }, "featureMonitorJobId": { "format": "int64", "type": "string", "description": "Optional. Output only. System-generated ID for feature monitor job.", "location": "query" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitorJob" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "list": { "description": "List feature monitor jobs.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/featureMonitorJobs", "path": "v1beta1/{+parent}/featureMonitorJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featureGroups.featureMonitors.featureMonitorJobs.list", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous FeatureRegistryService.ListFeatureMonitorJobs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureRegistryService.ListFeatureMonitorJobs must match the call that provided the page token." }, "filter": { "location": "query", "description": "Optional. Lists the FeatureMonitorJobs that match the filter expression. The following fields are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be Examples: * `create_time \u003e \"2020-01-01\"` FeatureMonitorJobs created after 2020-01-01.", "type": "string" }, "orderBy": { "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported Fields: * `create_time`", "location": "query" }, "parent": { "description": "Required. The resource name of the FeatureMonitor to list FeatureMonitorJobs. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}/featureMonitors/{feature_monitor}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$" }, "pageSize": { "location": "query", "description": "Optional. The maximum number of FeatureMonitorJobs to return. The service may return fewer than this value. If unspecified, at most 100 FeatureMonitorJobs will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100.", "type": "integer", "format": "int32" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureMonitorJobsResponse" } } } }, "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" } }, "id": "aiplatform.projects.locations.featureGroups.featureMonitors.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "get": { "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.featureGroups.featureMonitors.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$", "type": "string" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ] }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.featureGroups.featureMonitors.operations.delete", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$" } } } } } } } } }, "featureOnlineStores": { "resources": { "featureViews": { "methods": { "getIamPolicy": { "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:getIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+resource}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.getIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." }, "options.requestedPolicyVersion": { "location": "query", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer", "format": "int32" } } }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureView" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.patch", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. Name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$" }, "updateMask": { "location": "query", "type": "string", "format": "google-fieldmask", "description": "Field mask is used to specify the fields to be overwritten in the FeatureView resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `service_agent_type` * `big_query_source` * `big_query_source.uri` * `big_query_source.entity_id_columns` * `feature_registry_source` * `feature_registry_source.feature_groups` * `sync_config` * `sync_config.cron` * `optimized_config.automatic_resources`" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the parameters of a single FeatureView." }, "get": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the FeatureView resource. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureView" }, "description": "Gets details of a single FeatureView.", "path": "v1beta1/{+name}" }, "generateFetchAccessToken": { "parameterOrder": [ "featureView" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenRequest" }, "path": "v1beta1/{+featureView}:generateFetchAccessToken", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "featureView": { "type": "string", "description": "FeatureView resource format `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}/featureViews/{featureView}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "description": "RPC to generate an access token for the given feature view. FeatureViews under the same FeatureOnlineStore share the same access token.", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:generateFetchAccessToken", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.generateFetchAccessToken" }, "sync": { "path": "v1beta1/{+featureView}:sync", "response": { "$ref": "GoogleCloudAiplatformV1beta1SyncFeatureViewResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1SyncFeatureViewRequest" }, "description": "Triggers on-demand sync for the FeatureView.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:sync", "parameterOrder": [ "featureView" ], "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.sync", "parameters": { "featureView": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "description": "Required. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`" } }, "httpMethod": "POST" }, "testIamPermissions": { "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "location": "path", "required": true }, "permissions": { "location": "query", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "type": "string", "repeated": true } }, "httpMethod": "POST", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+resource}:testIamPermissions", "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:testIamPermissions" }, "streamingFetchFeatureValues": { "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesRequest" }, "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.streamingFetchFeatureValues", "response": { "$ref": "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesResponse" }, "path": "v1beta1/{+featureView}:streamingFetchFeatureValues", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:streamingFetchFeatureValues", "parameters": { "featureView": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. FeatureView resource format `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}/featureViews/{featureView}`" } }, "parameterOrder": [ "featureView" ], "httpMethod": "POST", "description": "Bidirectional streaming RPC to fetch feature values under a FeatureView. Requests may not have a one-to-one mapping to responses and responses may be returned out-of-order to reduce latency." }, "directWrite": { "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.directWrite", "httpMethod": "POST", "path": "v1beta1/{+featureView}:directWrite", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "featureView": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "description": "FeatureView resource format `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}/featureViews/{featureView}`", "type": "string" } }, "parameterOrder": [ "featureView" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponse" }, "description": "Bidirectional streaming RPC to directly write to feature values in a feature view. Requests may not have a one-to-one mapping to responses and responses may be returned out-of-order to reduce latency.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:directWrite" }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.setIamPolicy", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$" } }, "response": { "$ref": "GoogleIamV1Policy" }, "path": "v1beta1/{+resource}:setIamPolicy", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" } }, "list": { "description": "Lists FeatureViews in a given FeatureOnlineStore.", "httpMethod": "GET", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.list", "parameters": { "pageToken": { "description": "A page token, received from a previous FeatureOnlineStoreAdminService.ListFeatureViews call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureOnlineStoreAdminService.ListFeatureViews must match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "The maximum number of FeatureViews to return. The service may return fewer than this value. If unspecified, at most 1000 FeatureViews will be returned. The maximum value is 1000; any value greater than 1000 will be coerced to 1000.", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "Lists the FeatureViews that match the filter expression. The following filters are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003e=`, and `\u003c=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003e=`, and `\u003c=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality as well as key presence. Examples: * `create_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\" OR update_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\"` --\u003e FeatureViews created or updated after 2020-01-31T15:30:00.000000Z. * `labels.active = yes AND labels.env = prod` --\u003e FeatureViews having both (active: yes) and (env: prod) labels. * `labels.env: *` --\u003e Any FeatureView which has a label with 'env' as the key." }, "orderBy": { "location": "query", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `feature_view_id` * `create_time` * `update_time`", "type": "string" }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the FeatureOnlineStore to list FeatureViews. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews", "path": "v1beta1/{+parent}/featureViews", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureViewsResponse" }, "parameterOrder": [ "parent" ] }, "delete": { "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.delete", "parameters": { "name": { "description": "Required. The name of the FeatureView to be deleted. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a single FeatureView." }, "searchNearestEntities": { "httpMethod": "POST", "parameters": { "featureView": { "description": "Required. FeatureView resource format `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}/featureViews/{featureView}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$" } }, "path": "v1beta1/{+featureView}:searchNearestEntities", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchNearestEntitiesRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:searchNearestEntities", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.searchNearestEntities", "parameterOrder": [ "featureView" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchNearestEntitiesResponse" }, "description": "Search the nearest entities under a FeatureView. Search only works for indexable feature view; if a feature view isn't indexable, returns Invalid argument response." }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews", "description": "Creates a new FeatureView in a given FeatureOnlineStore.", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureView" }, "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the FeatureOnlineStore to create FeatureViews. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}`" }, "featureViewId": { "description": "Required. The ID to use for the FeatureView, which will become the final component of the FeatureView's resource name. This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within a FeatureOnlineStore.", "location": "query", "type": "string" }, "runSyncImmediately": { "location": "query", "type": "boolean", "description": "Immutable. If set to true, one on demand sync will be run immediately, regardless whether the FeatureView.sync_config is configured or not." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+parent}/featureViews", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.create" }, "fetchFeatureValues": { "path": "v1beta1/{+featureView}:fetchFeatureValues", "parameters": { "featureView": { "type": "string", "description": "Required. FeatureView resource format `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}/featureViews/{featureView}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}:fetchFeatureValues", "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesRequest" }, "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.fetchFeatureValues", "parameterOrder": [ "featureView" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponse" }, "description": "Fetch feature values under a FeatureView." } }, "resources": { "featureViewSyncs": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+/featureViewSyncs/[^/]+$", "type": "string", "description": "Required. The name of the FeatureViewSync resource. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}/featureViewSyncs/{feature_view_sync}`" } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single FeatureViewSync.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/featureViewSyncs/{featureViewSyncsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewSync" } }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureViewSyncsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/featureViewSyncs", "description": "Lists FeatureViewSyncs in a given FeatureView.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `create_time`", "location": "query", "type": "string" }, "filter": { "description": "Lists the FeatureViewSyncs that match the filter expression. The following filters are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003e=`, and `\u003c=` comparisons. Values must be in RFC 3339 format. Examples: * `create_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\"` --\u003e FeatureViewSyncs created after 2020-01-31T15:30:00.000000Z.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of FeatureViewSyncs to return. The service may return fewer than this value. If unspecified, at most 1000 FeatureViewSyncs will be returned. The maximum value is 1000; any value greater than 1000 will be coerced to 1000." }, "parent": { "description": "Required. The resource name of the FeatureView to list FeatureViewSyncs. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous FeatureOnlineStoreAdminService.ListFeatureViewSyncs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureOnlineStoreAdminService.ListFeatureViewSyncs must match the call that provided the page token." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.featureViewSyncs.list", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/featureViewSyncs" } } }, "operations": { "methods": { "list": { "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ] }, "wait": { "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string" }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.operations.wait" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}" }, "get": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "id": "aiplatform.projects.locations.featureOnlineStores.featureViews.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/operations", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.featureOnlineStores.operations.list" }, "wait": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featureOnlineStores.operations.wait", "parameters": { "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}:wait", "httpMethod": "POST" }, "get": { "id": "aiplatform.projects.locations.featureOnlineStores.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/operations/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ] }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}", "id": "aiplatform.projects.locations.featureOnlineStores.operations.delete", "path": "v1beta1/{+name}" } } } }, "methods": { "get": { "id": "aiplatform.projects.locations.featureOnlineStores.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStore" }, "description": "Gets details of a single FeatureOnlineStore.", "parameters": { "name": { "type": "string", "description": "Required. The name of the FeatureOnlineStore resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "location": "path", "required": true } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "create": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStore" }, "path": "v1beta1/{+parent}/featureOnlineStores", "id": "aiplatform.projects.locations.featureOnlineStores.create", "description": "Creates a new FeatureOnlineStore in a given project and location.", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "featureOnlineStoreId": { "description": "Required. The ID to use for this FeatureOnlineStore, which will become the final component of the FeatureOnlineStore's resource name. This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within the project and location.", "type": "string", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to create FeatureOnlineStores. Format: `projects/{project}/locations/{location}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores" }, "list": { "id": "aiplatform.projects.locations.featureOnlineStores.list", "path": "v1beta1/{+parent}/featureOnlineStores", "description": "Lists FeatureOnlineStores in a given project and location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeatureOnlineStoresResponse" }, "parameterOrder": [ "parent" ], "parameters": { "filter": { "description": "Lists the FeatureOnlineStores that match the filter expression. The following fields are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality and key presence. Examples: * `create_time \u003e \"2020-01-01\" OR update_time \u003e \"2020-01-01\"` FeatureOnlineStores created or updated after 2020-01-01. * `labels.env = \"prod\"` FeatureOnlineStores with label \"env\" set to \"prod\".", "type": "string", "location": "query" }, "orderBy": { "location": "query", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported Fields: * `create_time` * `update_time`", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The maximum number of FeatureOnlineStores to return. The service may return fewer than this value. If unspecified, at most 100 FeatureOnlineStores will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100." }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location to list FeatureOnlineStores. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous FeatureOnlineStoreAdminService.ListFeatureOnlineStores call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeatureOnlineStoreAdminService.ListFeatureOnlineStores must match the call that provided the page token." } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "path": "v1beta1/{+resource}:testIamPermissions", "httpMethod": "POST", "parameterOrder": [ "resource" ], "parameters": { "permissions": { "location": "query", "type": "string", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "repeated": true }, "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "type": "string", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.featureOnlineStores.testIamPermissions", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}:testIamPermissions", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}:getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "id": "aiplatform.projects.locations.featureOnlineStores.getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "type": "string" }, "options.requestedPolicyVersion": { "location": "query", "type": "integer", "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "parameterOrder": [ "resource" ] }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Deletes a single FeatureOnlineStore. The FeatureOnlineStore must not contain any FeatureViews.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the FeatureOnlineStore to be deleted. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}`", "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$" }, "force": { "type": "boolean", "location": "query", "description": "If set to true, any FeatureViews and Features for this FeatureOnlineStore will also be deleted. (Otherwise, the request will only work if the FeatureOnlineStore has no FeatureViews.)" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featureOnlineStores.delete" }, "patch": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}", "id": "aiplatform.projects.locations.featureOnlineStores.patch", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStore" }, "description": "Updates the parameters of a single FeatureOnlineStore.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "description": "Identifier. Name of the FeatureOnlineStore. Format: `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}`", "type": "string", "location": "path", "required": true }, "updateMask": { "location": "query", "description": "Field mask is used to specify the fields to be overwritten in the FeatureOnlineStore resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `description` * `bigtable` * `bigtable.auto_scaling` * `bigtable.enable_multi_region_replica`", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "setIamPolicy": { "parameterOrder": [ "resource" ], "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "id": "aiplatform.projects.locations.featureOnlineStores.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featureOnlineStores/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featureOnlineStores/{featureOnlineStoresId}:setIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "path": "v1beta1/{+resource}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." } } }, "indexes": { "resources": { "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.indexes.operations.list", "parameterOrder": [ "name" ], "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.indexes.operations.wait", "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string", "format": "google-duration" } } }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.indexes.operations.cancel" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.indexes.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "id": "aiplatform.projects.locations.indexes.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}/operations/{operationsId}", "path": "v1beta1/{+name}" } } } }, "methods": { "create": { "id": "aiplatform.projects.locations.indexes.create", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes", "httpMethod": "POST", "description": "Creates an Index.", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location to create the Index in. Format: `projects/{project}/locations/{location}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/indexes", "request": { "$ref": "GoogleCloudAiplatformV1beta1Index" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "upsertDatapoints": { "description": "Add/update Datapoints into an Index.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1UpsertDatapointsRequest" }, "httpMethod": "POST", "parameterOrder": [ "index" ], "parameters": { "index": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Index resource to be updated. Format: `projects/{project}/locations/{location}/indexes/{index}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}:upsertDatapoints", "path": "v1beta1/{+index}:upsertDatapoints", "response": { "$ref": "GoogleCloudAiplatformV1beta1UpsertDatapointsResponse" }, "id": "aiplatform.projects.locations.indexes.upsertDatapoints" }, "get": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Index resource. Format: `projects/{project}/locations/{location}/indexes/{index}`" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Index" }, "description": "Gets an Index.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.indexes.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}" }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Index" }, "description": "Updates an Index.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.indexes.patch", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "Output only. The resource name of the Index.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$", "location": "path", "required": true }, "updateMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}", "httpMethod": "PATCH" }, "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "Required. The name of the Index resource to be deleted. Format: `projects/{project}/locations/{location}/indexes/{index}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes an Index. An Index can only be deleted when all its DeployedIndexes had been undeployed.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}", "id": "aiplatform.projects.locations.indexes.delete" }, "list": { "id": "aiplatform.projects.locations.indexes.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the Indexes. Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "location": "query", "description": "The standard list page token. Typically obtained via ListIndexesResponse.next_page_token of the previous IndexService.ListIndexes call.", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "readMask": { "type": "string", "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "location": "query" } }, "description": "Lists Indexes in a Location.", "path": "v1beta1/{+parent}/indexes", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListIndexesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "import": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequest" }, "description": "Imports an Index from an external source (e.g., BigQuery).", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}:import", "path": "v1beta1/{+name}:import", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Index resource to import data to. Format: `projects/{project}/locations/{location}/indexes/{index}`" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.indexes.import", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "removeDatapoints": { "response": { "$ref": "GoogleCloudAiplatformV1beta1RemoveDatapointsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/indexes/{indexesId}:removeDatapoints", "description": "Remove Datapoints from an Index.", "parameters": { "index": { "description": "Required. The name of the Index resource to be updated. Format: `projects/{project}/locations/{location}/indexes/{index}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/indexes/[^/]+$", "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "index" ], "path": "v1beta1/{+index}:removeDatapoints", "request": { "$ref": "GoogleCloudAiplatformV1beta1RemoveDatapointsRequest" }, "id": "aiplatform.projects.locations.indexes.removeDatapoints" } } }, "skills": { "methods": { "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Skill" }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.skills.create", "parameters": { "skillId": { "type": "string", "location": "query", "description": "Required. The ID to use for the Skill, which will become the final component of the Skill's resource name. If not provided, a system-generated ID will be used. This value must be 1-63 characters. Valid characters are lowercase letters, numbers, and hyphens. The first character must be a lowercase letter, and the last character must be a lowercase letter or a number. Specifically, the ID must match the regular expression: `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$` See [AIP-122](https://aip.dev/122#resource-id-segments) for more details." }, "parent": { "description": "Required. The location to create the Skill in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/skills", "parameterOrder": [ "parent" ], "description": "Create a Skill." }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills", "id": "aiplatform.projects.locations.skills.list", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSkillsResponse" }, "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The location to list the Skills in. Format: `projects/{project}/locations/{location}`", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token.", "location": "query" }, "pageSize": { "description": "Optional. The standard list page size.", "location": "query", "format": "int32", "type": "integer" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/skills", "description": "List Skills.", "parameterOrder": [ "parent" ] }, "retrieve": { "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveSkillsResponse" }, "httpMethod": "GET", "parameters": { "parent": { "type": "string", "description": "Required. The location to retrieve the Skills in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "query": { "type": "string", "location": "query", "description": "Optional. The query to find matching skills." }, "topK": { "format": "int32", "location": "query", "description": "Optional. The maximum number of skills to return. The service may return fewer than this value. If unspecified, at most 10 skills will be returned. The maximum value is 100.", "type": "integer" } }, "path": "v1beta1/{+parent}/skills:retrieve", "id": "aiplatform.projects.locations.skills.retrieve", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills:retrieve", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves skills." }, "patch": { "id": "aiplatform.projects.locations.skills.patch", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "description": "Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`", "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", "location": "path", "required": true }, "updateMask": { "type": "string", "location": "query", "description": "Optional. Mask specifying which fields to update.", "format": "google-fieldmask" } }, "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1Skill" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Update a Skill.", "path": "v1beta1/{+name}" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.skills.get", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Skill to retrieve. Format: `projects/{project}/locations/{location}/skills/{skill}`", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Skill" }, "description": "Get a Skill." }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", "description": "Required. The resource name of the Skill to delete. Format: `projects/{project}/locations/{location}/skills/{skill}`" } }, "id": "aiplatform.projects.locations.skills.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Delete a Skill." } }, "resources": { "revisions": { "methods": { "list": { "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Skill to list revisions for. Format: `projects/{project}/locations/{location}/skills/{skill}`" }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`", "location": "query", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token." }, "pageSize": { "description": "Optional. The standard list page size.", "type": "integer", "location": "query", "format": "int32" } }, "id": "aiplatform.projects.locations.skills.revisions.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSkillRevisionsResponse" }, "path": "v1beta1/{+parent}/revisions", "description": "List Skill Revisions for a Skill.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions" }, "get": { "description": "Get a Skill Revision.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.skills.revisions.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1SkillRevision" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions/{revisionsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+/revisions/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Skill Revision to retrieve. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`", "type": "string" } }, "httpMethod": "GET", "parameterOrder": [ "name" ] } } }, "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/operations", "httpMethod": "GET", "id": "aiplatform.projects.locations.skills.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } }, "id": "aiplatform.projects.locations.skills.operations.wait", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+/operations/[^/]+$", "type": "string" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.skills.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.skills.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.skills.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } } } } }, "semanticGovernancePolicies": { "resources": { "operations": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "id": "aiplatform.projects.locations.semanticGovernancePolicies.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.semanticGovernancePolicies.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to wait on." } }, "id": "aiplatform.projects.locations.semanticGovernancePolicies.operations.wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "aiplatform.projects.locations.semanticGovernancePolicies.operations.cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.semanticGovernancePolicies.operations.get" } } } }, "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the SemanticGovernancePolicy resource to be deleted. Format: `projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}`", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+$" }, "etag": { "description": "Optional. The etag of the SemanticGovernancePolicy. If an etag is provided and does not match the current etag of the SemanticGovernancePolicy, deletion will be blocked and an ABORTED error will be returned.", "type": "string", "location": "query" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a SemanticGovernancePolicy.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.semanticGovernancePolicies.delete" }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "Identifier. Resource name of the SemanticGovernancePolicy.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+$" }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. `update_mask` is used to specify the fields to be overwritten in the SemanticGovernancePolicy resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the mask is not present, then all fields that are populated in the request message will be overwritten. Set the `update_mask` to `*` to override all fields.", "type": "string" } }, "id": "aiplatform.projects.locations.semanticGovernancePolicies.patch", "description": "Updates a SemanticGovernancePolicy." }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSemanticGovernancePoliciesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies", "path": "v1beta1/{+parent}/semanticGovernancePolicies", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "Optional. The list page size. If zero, a default page size of 10 is used.", "type": "integer", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the SemanticGovernancePolicies. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.semanticGovernancePolicies.list", "description": "Lists SemanticGovernancePolicies in a given location." }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies/{semanticGovernancePoliciesId}", "id": "aiplatform.projects.locations.semanticGovernancePolicies.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "description": "Gets a SemanticGovernancePolicy.", "parameters": { "name": { "description": "Required. The name of the SemanticGovernancePolicy resource. Format: `projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}`", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicies/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET" }, "create": { "description": "Creates a SemanticGovernancePolicy.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicies", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/semanticGovernancePolicies", "request": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location into which to create the SemanticGovernancePolicy. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true }, "semanticGovernancePolicyId": { "type": "string", "location": "query", "description": "Required. The ID to use for the SemanticGovernancePolicy, which will become the final component of the SemanticGovernancePolicy's resource name. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character cannot be a number or hyphen. The last character must be a letter or a number." } }, "id": "aiplatform.projects.locations.semanticGovernancePolicies.create" } } }, "agentAnomalyDetectionScopes": { "methods": { "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentAnomalyDetectionScopes/{agentAnomalyDetectionScopesId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/agentAnomalyDetectionScopes/[^/]+$", "description": "Required. The name of the AgentAnomalyDetectionScope resource. Format: `projects/{project}/locations/{location}/agentAnomalyDetectionScopes/{agent_anomaly_detection_scope}`" } }, "id": "aiplatform.projects.locations.agentAnomalyDetectionScopes.get", "description": "Gets the details of a specific AgentAnomalyDetectionScope.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1beta1/{+name}" }, "delete": { "httpMethod": "DELETE", "id": "aiplatform.projects.locations.agentAnomalyDetectionScopes.delete", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the AgentAnomalyDetectionScope resource to be deleted. Format: `projects/{project}/locations/{location}/agentAnomalyDetectionScopes/{agent_anomaly_detection_scope}`", "pattern": "^projects/[^/]+/locations/[^/]+/agentAnomalyDetectionScopes/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentAnomalyDetectionScopes/{agentAnomalyDetectionScopesId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a specific AgentAnomalyDetectionScope." }, "create": { "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the AgentAnomalyDetectionScope in. Format: `projects/{project}/locations/{location}`" }, "agentAnomalyDetectionScopeId": { "type": "string", "description": "Required. The ID to use for the AgentAnomalyDetectionScope, which will become the final component of the AgentAnomalyDetectionScope's resource name. This value should be 1-63 characters, and valid characters are /[a-z]([a-z0-9-]{0,61}[a-z0-9])?/.", "location": "query" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope" }, "path": "v1beta1/{+parent}/agentAnomalyDetectionScopes", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentAnomalyDetectionScopes", "description": "Creates a new AgentAnomalyDetectionScope.", "id": "aiplatform.projects.locations.agentAnomalyDetectionScopes.create" }, "list": { "description": "Lists AgentAnomalyDetectionScopes in a Location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListAgentAnomalyDetectionScopesResponse" }, "path": "v1beta1/{+parent}/agentAnomalyDetectionScopes", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/agentAnomalyDetectionScopes", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to list the AgentAnomalyDetectionScopes from. Format: `projects/{project}/locations/{location}`" }, "pageSize": { "location": "query", "description": "Optional. The standard list page size. The maximum value is 100; values above 100 will be coerced to 100. If unspecified, at most 10 AgentAnomalyDetectionScopes will be returned.", "format": "int32", "type": "integer" }, "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" } }, "id": "aiplatform.projects.locations.agentAnomalyDetectionScopes.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "cachedContents": { "methods": { "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.cachedContents.get", "description": "Gets cached content configurations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/cachedContents/{cachedContentsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The resource name referring to the cached content", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/cachedContents/[^/]+$", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/cachedContents/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name referring to the cached content" } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.cachedContents.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes cached content", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/cachedContents/{cachedContentsId}" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/cachedContents", "path": "v1beta1/{+parent}/cachedContents", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListCachedContentsResponse" }, "httpMethod": "GET", "description": "Lists cached contents in a project", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The parent, which owns this collection of cached contents." }, "pageSize": { "description": "Optional. The maximum number of cached contents to return. The service may return fewer than this value. If unspecified, some default (under maximum) number of items will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { "location": "query", "type": "string", "description": "Optional. A page token, received from a previous `ListCachedContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCachedContents` must match the call that provided the page token." } }, "id": "aiplatform.projects.locations.cachedContents.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "parameters": { "name": { "location": "path", "required": true, "description": "Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content}", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/cachedContents/[^/]+$" }, "updateMask": { "description": "Required. The list of fields to update.", "location": "query", "format": "google-fieldmask", "type": "string" } }, "httpMethod": "PATCH", "response": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "id": "aiplatform.projects.locations.cachedContents.patch", "path": "v1beta1/{+name}", "description": "Updates cached content configurations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/cachedContents/{cachedContentsId}" }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "parameters": { "parent": { "description": "Required. The parent resource where the cached content will be created", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.cachedContents.create", "path": "v1beta1/{+parent}/cachedContents", "response": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "description": "Creates cached content, this call will initialize the cached content in the data storage, and users need to pay for the cache data storage.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/cachedContents", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "evaluationItems": { "resources": { "operations": { "methods": { "get": { "id": "aiplatform.projects.locations.evaluationItems.operations.get", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "id": "aiplatform.projects.locations.evaluationItems.operations.delete", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}/operations/{operationsId}" }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.evaluationItems.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}/operations" }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+/operations/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.evaluationItems.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ] } } } }, "methods": { "list": { "parameters": { "pageSize": { "location": "query", "format": "int32", "description": "Optional. The maximum number of Evaluation Items to return.", "type": "integer" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location from which to list the Evaluation Items. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true }, "pageToken": { "type": "string", "location": "query", "description": "Optional. A page token, received from a previous `ListEvaluationItems` call. Provide this to retrieve the subsequent page." }, "filter": { "type": "string", "description": "Optional. Filter expression that matches a subset of the EvaluationItems to show. For field names both snake_case and camelCase are supported. For more information about filter syntax, see [AIP-160](https://google.aip.dev/160).", "location": "query" } }, "httpMethod": "GET", "description": "Lists Evaluation Items.", "id": "aiplatform.projects.locations.evaluationItems.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEvaluationItemsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems", "path": "v1beta1/{+parent}/evaluationItems", "parameterOrder": [ "parent" ] }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the EvaluationItem resource to be deleted. Format: `projects/{project}/locations/{location}/evaluationItems/{evaluation_item}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes an Evaluation Item.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationItems.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "get": { "parameterOrder": [ "name" ], "description": "Gets an Evaluation Item.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/evaluationItems/[^/]+$", "description": "Required. The name of the EvaluationItem resource. Format: `projects/{project}/locations/{location}/evaluationItems/{evaluation_item}`" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.evaluationItems.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationItem" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems/{evaluationItemsId}" }, "create": { "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The resource name of the Location to create the Evaluation Item in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationItems", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationItem" }, "description": "Creates an Evaluation Item.", "path": "v1beta1/{+parent}/evaluationItems", "id": "aiplatform.projects.locations.evaluationItems.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationItem" } } } }, "trainingPipelines": { "methods": { "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}", "description": "Gets a TrainingPipeline.", "response": { "$ref": "GoogleCloudAiplatformV1beta1TrainingPipeline" }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.trainingPipelines.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+$", "description": "Required. The name of the TrainingPipeline resource. Format: `projects/{project}/locations/{location}/trainingPipelines/{training_pipeline}`", "type": "string" } } }, "delete": { "id": "aiplatform.projects.locations.trainingPipelines.delete", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Deletes a TrainingPipeline.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+$", "description": "Required. The name of the TrainingPipeline resource to be deleted. Format: `projects/{project}/locations/{location}/trainingPipelines/{training_pipeline}`" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}" }, "create": { "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "description": "Required. The resource name of the Location to create the TrainingPipeline in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true } }, "description": "Creates a TrainingPipeline. A created TrainingPipeline right away will be attempted to be run.", "request": { "$ref": "GoogleCloudAiplatformV1beta1TrainingPipeline" }, "id": "aiplatform.projects.locations.trainingPipelines.create", "response": { "$ref": "GoogleCloudAiplatformV1beta1TrainingPipeline" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines", "path": "v1beta1/{+parent}/trainingPipelines", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "description": "Cancels a TrainingPipeline. Starts asynchronous cancellation on the TrainingPipeline. The server makes a best effort to cancel the pipeline, but success is not guaranteed. Clients can use PipelineService.GetTrainingPipeline or other methods to check whether the cancellation succeeded or whether the pipeline completed despite cancellation. On successful cancellation, the TrainingPipeline is not deleted; instead it becomes a pipeline with a TrainingPipeline.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`, and TrainingPipeline.state is set to `CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}:cancel", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the TrainingPipeline to cancel. Format: `projects/{project}/locations/{location}/trainingPipelines/{training_pipeline}`" } }, "id": "aiplatform.projects.locations.trainingPipelines.cancel", "path": "v1beta1/{+name}:cancel", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelTrainingPipelineRequest" }, "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTrainingPipelinesResponse" }, "path": "v1beta1/{+parent}/trainingPipelines", "id": "aiplatform.projects.locations.trainingPipelines.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to list the TrainingPipelines from. Format: `projects/{project}/locations/{location}`", "type": "string" }, "filter": { "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `training_task_definition` `=`, `!=` comparisons, and `:` wildcard. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"PIPELINE_STATE_SUCCEEDED\" AND display_name:\"my_pipeline_*\"` * `state!=\"PIPELINE_STATE_FAILED\" OR display_name=\"my_pipeline\"` * `NOT display_name=\"my_pipeline\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `training_task_definition:\"*automl_text_classification*\"`", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "readMask": { "type": "string", "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token. Typically obtained via ListTrainingPipelinesResponse.next_page_token of the previous PipelineService.ListTrainingPipelines call." } }, "description": "Lists TrainingPipelines in a Location.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "operations": { "methods": { "cancel": { "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.trainingPipelines.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}:cancel" }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.trainingPipelines.operations.get" }, "list": { "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}/operations", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.trainingPipelines.operations.list" }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.trainingPipelines.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "timeout": { "location": "query", "format": "google-duration", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST" }, "delete": { "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trainingPipelines/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.trainingPipelines.operations.delete", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}" } } } } }, "memoryBanks": { "methods": { "ingestEvents": { "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ReasoningEngine to ingest events to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1IngestEventsRequest" }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.memoryBanks.ingestEvents", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Ingests events for a Memory Bank.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}:ingestEvents", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}:ingestEvents" } }, "resources": { "operations": { "methods": { "get": { "id": "aiplatform.projects.locations.memoryBanks.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.memoryBanks.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.memoryBanks.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." } }, "httpMethod": "GET", "parameterOrder": [ "name" ] }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on." } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.memoryBanks.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.memoryBanks.operations.cancel", "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ] } } }, "memories": { "resources": { "revisions": { "methods": { "list": { "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "type": "string", "description": "Optional. The standard list page token.", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. The standard list page size.", "location": "query" }, "parent": { "type": "string", "description": "Required. The resource name of the Memory to list revisions for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "location": "path", "required": true }, "filter": { "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`", "location": "query" } }, "httpMethod": "GET", "description": "List Memory Revisions for a Memory.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/revisions", "path": "v1beta1/{+parent}/revisions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse" }, "id": "aiplatform.projects.locations.memoryBanks.memories.revisions.list" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/revisions/{revisionsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1MemoryRevision" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "GET", "description": "Get a Memory Revision.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+/revisions/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Memory Revision to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}/revisions/{revision}`" } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.memoryBanks.memories.revisions.get" } } }, "operations": { "methods": { "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." } }, "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.memoryBanks.memories.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.memoryBanks.memories.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true } } }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.memoryBanks.memories.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}", "id": "aiplatform.projects.locations.memoryBanks.memories.operations.delete", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true } } }, "get": { "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.memoryBanks.memories.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}" } } } }, "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "type": "string", "description": "Required. The resource name of the Memory to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "description": "Delete a Memory.", "id": "aiplatform.projects.locations.memoryBanks.memories.delete" }, "list": { "id": "aiplatform.projects.locations.memoryBanks.memories.list", "parameterOrder": [ "parent" ], "parameters": { "orderBy": { "description": "Optional. The standard list order by string. If not specified, the default order is `create_time desc`. If specified, the default sorting order of provided fields is ascending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time`", "type": "string", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to list the Memories under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "pageSize": { "format": "int32", "location": "query", "description": "Optional. The standard list page size.", "type": "integer" }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `scope` (as a JSON string with equality match only) * `topics` (i.e. `topics.custom_memory_topic_label: \"example topic\" OR topics.managed_memory_topic: USER_PREFERENCES`)", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "Optional. The standard list page token.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoriesResponse" }, "description": "List Memories.", "path": "v1beta1/{+parent}/memories", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories" }, "purge": { "path": "v1beta1/{+parent}/memories:purge", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories:purge", "httpMethod": "POST", "description": "Purge memories.", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to purge memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.memoryBanks.memories.purge", "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest" } }, "generate": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Generate memories.", "id": "aiplatform.projects.locations.memoryBanks.memories.generate", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories:generate", "path": "v1beta1/{+parent}/memories:generate", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to generate memories for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest" } }, "rollback": { "path": "v1beta1/{+name}:rollback", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Memory to rollback. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" } }, "id": "aiplatform.projects.locations.memoryBanks.memories.rollback", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Rollback Memory to a specific revision.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RollbackMemoryRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}:rollback" }, "retrieveProfiles": { "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest" }, "description": "Retrieves profiles.", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories:retrieveProfiles", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse" }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories:retrieveProfiles", "id": "aiplatform.projects.locations.memoryBanks.memories.retrieveProfiles", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the ReasoningEngine to retrieve profiles from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "httpMethod": "PATCH", "parameters": { "updateMask": { "type": "string", "description": "Optional. Mask specifying which fields to update. The following fields are immutable: * `scope` * `memory_type`", "format": "google-fieldmask", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "description": "Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "parameterOrder": [ "name" ], "description": "Update a Memory.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.memoryBanks.memories.patch", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}" }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Create a Memory.", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories", "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "parameters": { "memoryId": { "location": "query", "type": "string", "description": "Optional. The user defined ID to use for memory, which will become the final component of the memory resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character must be a letter, and the last character must be a letter or number." }, "parent": { "description": "Required. The resource name of the ReasoningEngine to create the Memory under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$" } }, "id": "aiplatform.projects.locations.memoryBanks.memories.create", "httpMethod": "POST" }, "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.memoryBanks.memories.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories/{memoriesId}", "parameters": { "name": { "type": "string", "description": "Required. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+/memories/[^/]+$", "location": "path", "required": true } }, "description": "Get a Memory." }, "retrieve": { "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/memoryBanks/{memoryBanksId}/memories:retrieve", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to retrieve memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest" }, "httpMethod": "POST", "id": "aiplatform.projects.locations.memoryBanks.memories.retrieve", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieve memories.", "path": "v1beta1/{+parent}/memories:retrieve" } } } } }, "monitoredAgents": { "resources": { "analyzedSessions": { "methods": { "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}/analyzedSessions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "filter": { "description": "Optional. Filter expression restricting which AnalyzedSessions are returned. Supports a subset of AIP-160: a closed `detection_time` window (both bounds required), an equality on `severity`, an equality on `agent_type`, and an equality on `session_id`, joined by `AND`. Each clause is optional, may appear at most once, and may appear in any order. The `severity` value is the **canonical** `Severity` enum name -- `SEVERITY_CRITICAL`, `SEVERITY_HIGH`, `SEVERITY_MEDIUM` or `SEVERITY_LOW`. Short forms such as `\"CRITICAL\"` are rejected, as is `SEVERITY_UNSPECIFIED`. It matches sessions whose *maximum* severity equals that bucket: a session that fires at both LOW and CRITICAL matches `severity = \"SEVERITY_CRITICAL\"`, not `severity = \"SEVERITY_LOW\"`. The `agent_type` value is the canonical `AgentResource.AgentType` enum name -- `REASONING_ENGINE`, `CLOUD_RUN_SERVICE`, `GKE_WORKLOAD`, `GCE_INSTANCE`, `AGENT_TYPE_OTHER` or `AGENT_TYPE_UNSPECIFIED` -- and matches sessions run by an agent on that runtime. Unlike `severity`, `agent_type` accepts its `UNSPECIFIED` value. The two are not analogous: a session always has a computed severity bucket, so `SEVERITY_UNSPECIFIED` is never returned and filtering on it could only match nothing. `AGENT_TYPE_UNSPECIFIED` *is* returned -- it is what `AnalyzedSession.agent_type` reports for an agent whose runtime was never recorded -- so it must remain filterable. The `session_id` value is a case-sensitive exact match (no substring or prefix matching) on `AnalyzedSession.session_id`. Unlike `severity` and `agent_type` it is not a closed enum, so any non-empty value is accepted; an empty value (`session_id = \"\"`) is rejected rather than treated as \"no filter\". Example (time window, severity and runtime): ``` detection_time \u003e= \"2024-01-01T00:00:00Z\" AND detection_time \u003c= \"2024-01-08T00:00:00Z\" AND severity = \"SEVERITY_CRITICAL\" AND agent_type = \"CLOUD_RUN_SERVICE\" ``` If empty, results are restricted to the last 7 days with no severity, runtime, or session restriction. Other fields, additional operators, set membership (`IN`), and boolean combinations (`OR`, `NOT`, parentheses) are not yet supported.", "type": "string", "location": "query" }, "pageToken": { "location": "query", "description": "Optional. A page token, received from a previous `ListAnalyzedSessions` call.", "type": "string" }, "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$", "description": "Required. The parent MonitoredAgent resource. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`" }, "pageSize": { "type": "integer", "location": "query", "description": "Optional. The maximum number of analyzed sessions to return.", "format": "int32" }, "orderBy": { "description": "Optional. Comma-separated list of fields to sort by, following AIP-132 syntax. The default sort direction is ascending; append \" desc\" to a field to sort descending. Supported fields (any other field yields INVALID_ARGUMENT): * `latest_detection_time` - the session's most-recent flagged detection time. `latest_detection_time desc` puts the newest sessions first. * `max_severity_rank` - the session's bucketed maximum severity, ranked LOW=1 \u003c MEDIUM=2 \u003c HIGH=3 \u003c CRITICAL=4. `max_severity_rank desc` puts the most-severe sessions first. * `agent_display_name` - the MonitoredAgent's display name. Sorted as a STRING (case-sensitive, code-point order). If empty, defaults to `latest_detection_time desc`. Multi-field sort (for example, `max_severity_rank desc, latest_detection_time desc`) is supported. The `order_by` value MUST match the value used on the call that minted any supplied `page_token` (AIP-158). Mismatches yield INVALID_ARGUMENT.", "type": "string", "location": "query" }, "view": { "enum": [ "ANALYZED_SESSION_VIEW_UNSPECIFIED", "ANALYZED_SESSION_VIEW_BASIC", "ANALYZED_SESSION_VIEW_FULL" ], "location": "query", "type": "string", "description": "Optional. Resource view to control which fields are returned.", "enumDescriptions": [ "The default view: BASIC.", "Basic view includes only the fields needed for the list table (name, session_id, created_time, severity counts).", "Full view includes all fields, including the detailed assessment." ] } }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/analyzedSessions", "id": "aiplatform.projects.locations.monitoredAgents.analyzedSessions.list", "description": "Lists AnalyzedSessions in a MonitoredAgent." }, "aggregate": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.monitoredAgents.analyzedSessions.aggregate", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "description": "Optional. The standard list page token.", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "description": "Optional. The standard list page size. The maximum value is 100; values above 100 will be coerced to 100. If unspecified, at most 10 MonitoredAgents will be returned.", "type": "integer" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$", "description": "Required. The parent MonitoredAgent resource. Use the `-` wildcard for the monitored_agent segment to aggregate across multiple agents in the location. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`", "location": "path", "required": true, "type": "string" }, "filter": { "description": "Optional. Filter expression restricting which AnalyzedSessions are included in the aggregation. Supports a subset of the `ListAnalyzedSessionsRequest.filter` grammar: a closed `detection_time` window with both bounds required. The `severity` clause is not supported here. If empty, the aggregation covers the last 3 days. Example: ``` detection_time \u003e= \"2024-01-01T00:00:00Z\" AND detection_time \u003c= \"2024-01-08T00:00:00Z\" ```", "type": "string", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}/analyzedSessions:aggregate", "description": "Aggregates AnalyzedSessions across MonitoredAgents. To aggregate across all MonitoredAgents in a location, use the following format for the parent field: `projects/{project}/locations/{location}/monitoredAgents/-`", "path": "v1beta1/{+parent}/analyzedSessions:aggregate", "response": { "$ref": "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponse" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}/analyzedSessions/{analyzedSessionsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedSession" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the details of a specific AnalyzedSession.", "id": "aiplatform.projects.locations.monitoredAgents.analyzedSessions.get", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the AnalyzedSession resource. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}/analyzedSessions/{analyzed_session}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+/analyzedSessions/[^/]+$" }, "view": { "enum": [ "ANALYZED_SESSION_VIEW_UNSPECIFIED", "ANALYZED_SESSION_VIEW_BASIC", "ANALYZED_SESSION_VIEW_FULL" ], "type": "string", "description": "Optional. Resource view to control which fields are returned.", "enumDescriptions": [ "The default view: BASIC.", "Basic view includes only the fields needed for the list table (name, session_id, created_time, severity counts).", "Full view includes all fields, including the detailed assessment." ], "location": "query" } } } }, "resources": { "analyzedInvocations": { "methods": { "list": { "id": "aiplatform.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "type": "string", "description": "Required. The parent AnalyzedSession resource. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}/analyzedSessions/{analyzed_session}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+/analyzedSessions/[^/]+$" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListAnalyzedInvocations` call.", "location": "query" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of analyzed invocations to return.", "format": "int32", "location": "query" } }, "parameterOrder": [ "parent" ], "description": "Lists AnalyzedInvocations in a MonitoredAgent's AnalyzedSession.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}/analyzedSessions/{analyzedSessionsId}/analyzedInvocations", "path": "v1beta1/{+parent}/analyzedInvocations", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListAnalyzedInvocationsResponse" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+/analyzedSessions/[^/]+/analyzedInvocations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the AnalyzedInvocation resource. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}/analyzedSessions/{analyzed_session}/analyzedInvocations/{analyzed_invocation}`" } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedInvocation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}/analyzedSessions/{analyzedSessionsId}/analyzedInvocations/{analyzedInvocationsId}", "description": "Gets the details of a specific AnalyzedInvocation.", "id": "aiplatform.projects.locations.monitoredAgents.analyzedSessions.analyzedInvocations.get", "parameterOrder": [ "name" ] } } } } } }, "methods": { "disable": { "description": "Disables a specific MonitoredAgent.", "path": "v1beta1/{+name}:disable", "parameters": { "name": { "description": "Required. The name of the MonitoredAgent resource to be disabled. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1DisableMonitoredAgentRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}:disable", "id": "aiplatform.projects.locations.monitoredAgents.disable" }, "list": { "description": "Lists MonitoredAgents in a specific Location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMonitoredAgentsResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents", "parameters": { "parent": { "description": "Required. The resource name of the Location to list the MonitoredAgents from. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "filter": { "description": "Optional. An AIP-160 filter, currently restricted to a single equality predicate on `state`. The value must be the exact, case-sensitive name of a `MonitoredAgent.EnablementState` value: `ACTIVE`, `DISABLED`, `ENABLING`, or `ENABLEMENT_STATE_UNSPECIFIED`. A blank or absent filter returns every MonitoredAgent in the parent regardless of state; any other value returns `INVALID_ARGUMENT`. Example: ``` state = ACTIVE ```", "location": "query", "type": "string" }, "pageToken": { "description": "Optional. The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "description": "Optional. The standard list page size. The maximum value is 100; values above 100 will be coerced to 100. If unspecified, at most 10 MonitoredAgents will be returned.", "format": "int32" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.monitoredAgents.list", "path": "v1beta1/{+parent}/monitoredAgents" }, "clearTrainingData": { "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ClearTrainingDataRequest" }, "id": "aiplatform.projects.locations.monitoredAgents.clearTrainingData", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}:clearTrainingData", "description": "Clears (purges) the trained model artifacts derived from a MonitoredAgent's data. The purged model is rebuilt by the next scheduled training run. To clear every MonitoredAgent in a location's scope, use the `-` wildcard agent segment for the name field: `projects/{project}/locations/{location}/monitoredAgents/-` This is the on-demand data-deletion path for customers who have deleted the underlying logs / observability data a model was trained on. It deletes only the derived model artifacts in the tenant project (it does NOT delete the scope, tenant project, or monitoring). To stop monitoring an agent entirely, disable it via DisableMonitoredAgent. See go/aad-clear-training-data.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:clearTrainingData", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$", "description": "Required. The MonitoredAgent whose trained model artifacts to purge. Use the `-` wildcard agent segment to purge every MonitoredAgent in the scope. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`" } }, "httpMethod": "POST" }, "enable": { "id": "aiplatform.projects.locations.monitoredAgents.enable", "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$", "description": "Required. The name of the MonitoredAgent resource to be enabled. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:enable", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}:enable", "description": "Enables a specific MonitoredAgent.", "request": { "$ref": "GoogleCloudAiplatformV1beta1EnableMonitoredAgentRequest" }, "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "parameterOrder": [ "name" ], "description": "Gets the details of a specific MonitoredAgent.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.monitoredAgents.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1MonitoredAgent" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/monitoredAgents/{monitoredAgentsId}", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/monitoredAgents/[^/]+$", "description": "Required. The name of the MonitoredAgent resource. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`", "location": "path", "required": true } }, "httpMethod": "GET" } } }, "apps": { "resources": { "operations": { "methods": { "list": { "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+$", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/operations", "id": "aiplatform.projects.locations.apps.operations.list" }, "wait": { "path": "v1beta1/{+name}:wait", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string" }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.apps.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ] }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.apps.operations.delete" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.apps.operations.cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ] }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.apps.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/apps/{appsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/apps/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ] } } } } }, "pipelineJobs": { "resources": { "operations": { "methods": { "cancel": { "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.pipelineJobs.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled." } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.pipelineJobs.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}/operations", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." } }, "httpMethod": "GET" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.pipelineJobs.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.pipelineJobs.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+/operations/[^/]+$" } } }, "delete": { "id": "aiplatform.projects.locations.pipelineJobs.operations.delete", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" } } } } }, "methods": { "batchDelete": { "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/pipelineJobs:batchDelete", "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchDeletePipelineJobsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs:batchDelete", "description": "Batch deletes PipelineJobs The Operation is atomic. If it fails, none of the PipelineJobs are deleted. If it succeeds, all of the PipelineJobs are deleted.", "id": "aiplatform.projects.locations.pipelineJobs.batchDelete", "parameterOrder": [ "parent" ], "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The name of the PipelineJobs' parent resource. Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST" }, "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the PipelineJob resource to be deleted. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipeline_job}`" } }, "httpMethod": "DELETE", "description": "Deletes a PipelineJob.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}", "id": "aiplatform.projects.locations.pipelineJobs.delete" }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a PipelineJob. A PipelineJob will run immediately when created.", "parameters": { "pipelineJobId": { "description": "The ID to use for the PipelineJob, which will become the final component of the PipelineJob name. If not provided, an ID will be automatically generated. This value should be less than 128 characters, and valid characters are `/a-z-/`.", "type": "string", "location": "query" }, "parent": { "type": "string", "description": "Required. The resource name of the Location to create the PipelineJob in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.pipelineJobs.create", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs", "request": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" }, "path": "v1beta1/{+parent}/pipelineJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" } }, "list": { "description": "Lists PipelineJobs in a Location.", "id": "aiplatform.projects.locations.pipelineJobs.list", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token. Typically obtained via ListPipelineJobsResponse.next_page_token of the previous PipelineService.ListPipelineJobs call." }, "parent": { "type": "string", "description": "Required. The resource name of the Location to list the PipelineJobs from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true }, "orderBy": { "location": "query", "description": "A comma-separated list of fields to order by. The default sort order is in ascending order. Use \"desc\" after a field name for descending. You can have multiple order_by fields provided e.g. \"create_time desc, end_time\", \"end_time, start_time, update_time\" For example, using \"create_time desc, end_time\" will order results by create time in descending order, and if there are multiple jobs having the same create time, order them by the end time in ascending order. if order_by is not specified, it will order by default order is create time in descending order. Supported fields: * `create_time` * `update_time` * `end_time` * `start_time`", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "readMask": { "format": "google-fieldmask", "location": "query", "description": "Mask specifying which fields to read.", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "Lists the PipelineJobs that match the filter expression. The following fields are supported: * `pipeline_name`: Supports `=` and `!=` comparisons. * `display_name`: Supports `=`, `!=` comparisons, and `:` wildcard. * `pipeline_job_user_id`: Supports `=`, `!=` comparisons, and `:` wildcard. for example, can check if pipeline's display_name contains *step* by doing display_name:\\\"*step*\\\" * `state`: Supports `=` and `!=` comparisons. * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `end_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality and key presence. * `template_uri`: Supports `=`, `!=` comparisons, and `:` wildcard. * `template_metadata.version`: Supports `=`, `!=` comparisons, and `:` wildcard. Filter expressions can be combined together using logical operators (`AND` & `OR`). For example: `pipeline_name=\"test\" AND create_time\u003e\"2020-05-18T13:30:00Z\"`. The syntax to define filter expression is based on https://google.aip.dev/160. Examples: * `create_time\u003e\"2021-05-18T00:00:00Z\" OR update_time\u003e\"2020-05-18T00:00:00Z\"` PipelineJobs created or updated after 2020-05-18 00:00:00 UTC. * `labels.env = \"prod\"` PipelineJobs with label \"env\" set to \"prod\"." } }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListPipelineJobsResponse" }, "path": "v1beta1/{+parent}/pipelineJobs" }, "cancel": { "parameters": { "name": { "description": "Required. The name of the PipelineJob to cancel. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipeline_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}:cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.pipelineJobs.cancel", "description": "Cancels a PipelineJob. Starts asynchronous cancellation on the PipelineJob. The server makes a best effort to cancel the pipeline, but success is not guaranteed. Clients can use PipelineService.GetPipelineJob or other methods to check whether the cancellation succeeded or whether the pipeline completed despite cancellation. On successful cancellation, the PipelineJob is not deleted; instead it becomes a pipeline with a PipelineJob.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`, and PipelineJob.state is set to `CANCELLED`.", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelPipelineJobRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs/{pipelineJobsId}", "id": "aiplatform.projects.locations.pipelineJobs.get", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/pipelineJobs/[^/]+$", "description": "Required. The name of the PipelineJob resource. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipeline_job}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets a PipelineJob." }, "batchCancel": { "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCancelPipelineJobsRequest" }, "path": "v1beta1/{+parent}/pipelineJobs:batchCancel", "id": "aiplatform.projects.locations.pipelineJobs.batchCancel", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/pipelineJobs:batchCancel", "description": "Batch cancel PipelineJobs. Firstly the server will check if all the jobs are in non-terminal states, and skip the jobs that are already terminated. If the operation failed, none of the pipeline jobs are cancelled. The server will poll the states of all the pipeline jobs periodically to check the cancellation status. This operation will return an LRO.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The name of the PipelineJobs' parent resource. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "httpMethod": "POST" } } }, "nasJobs": { "resources": { "nasTrialDetails": { "methods": { "get": { "description": "Gets a NasTrialDetail.", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "Required. The name of the NasTrialDetail resource. Format: `projects/{project}/locations/{location}/nasJobs/{nas_job}/nasTrialDetails/{nas_trial_detail}`", "pattern": "^projects/[^/]+/locations/[^/]+/nasJobs/[^/]+/nasTrialDetails/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.nasJobs.nasTrialDetails.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1NasTrialDetail" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails/{nasTrialDetailsId}" }, "list": { "path": "v1beta1/{+parent}/nasTrialDetails", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}/nasTrialDetails", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListNasTrialDetailsResponse" }, "description": "List top NasTrialDetails of a NasJob.", "parameters": { "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/nasJobs/[^/]+$", "description": "Required. The name of the NasJob resource. Format: `projects/{project}/locations/{location}/nasJobs/{nas_job}`", "location": "path", "required": true }, "pageToken": { "description": "The standard list page token. Typically obtained via ListNasTrialDetailsResponse.next_page_token of the previous JobService.ListNasTrialDetails call.", "location": "query", "type": "string" } }, "id": "aiplatform.projects.locations.nasJobs.nasTrialDetails.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } }, "methods": { "delete": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.nasJobs.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "Required. The name of the NasJob resource to be deleted. Format: `projects/{project}/locations/{location}/nasJobs/{nas_job}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/nasJobs/[^/]+$" } }, "description": "Deletes a NasJob.", "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "description": "Cancels a NasJob. Starts asynchronous cancellation on the NasJob. The server makes a best effort to cancel the job, but success is not guaranteed. Clients can use JobService.GetNasJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On successful cancellation, the NasJob is not deleted; instead it becomes a job with a NasJob.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`, and NasJob.state is set to `CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelNasJobRequest" }, "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/nasJobs/[^/]+$", "description": "Required. The name of the NasJob to cancel. Format: `projects/{project}/locations/{location}/nasJobs/{nas_job}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.nasJobs.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}:cancel" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs", "httpMethod": "GET", "id": "aiplatform.projects.locations.nasJobs.list", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token. Typically obtained via ListNasJobsResponse.next_page_token of the previous JobService.ListNasJobs call." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "readMask": { "type": "string", "description": "Mask specifying which fields to read.", "location": "query", "format": "google-fieldmask" }, "parent": { "description": "Required. The resource name of the Location to list the NasJobs from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+parent}/nasJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListNasJobsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Lists NasJobs in a Location." }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1NasJob" }, "id": "aiplatform.projects.locations.nasJobs.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the NasJob in. Format: `projects/{project}/locations/{location}`" } }, "path": "v1beta1/{+parent}/nasJobs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs", "description": "Creates a NasJob", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1NasJob" } }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1NasJob" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/nasJobs/{nasJobsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameters": { "name": { "description": "Required. The name of the NasJob resource. Format: `projects/{project}/locations/{location}/nasJobs/{nas_job}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/nasJobs/[^/]+$" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.nasJobs.get", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets a NasJob" } } }, "tuningJobs": { "methods": { "processData": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ProcessDataRequest" }, "path": "v1beta1/{+parent}/tuningJobs:processData", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Processes data from a user's Cloud Storage bucket and saves the result to a destination Cloud Storage bucket. This method returns a long-running operation, and the `ProcessDataResponse` will be returned upon completion.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to process the data in. Format: `projects/{project}/locations/{location}`", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs:processData", "id": "aiplatform.projects.locations.tuningJobs.processData" }, "validateReinforcementTuningReward": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs:validateReinforcementTuningReward", "response": { "$ref": "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardResponse" }, "path": "v1beta1/{+parent}/tuningJobs:validateReinforcementTuningReward", "id": "aiplatform.projects.locations.tuningJobs.validateReinforcementTuningReward", "request": { "$ref": "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardRequest" }, "parameterOrder": [ "parent" ], "description": "Validates a reward on a given example.", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location to validate the reward in Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } } }, "optimizePrompt": { "id": "aiplatform.projects.locations.tuningJobs.optimizePrompt", "response": { "$ref": "GoogleCloudAiplatformV1beta1OptimizePromptResponse" }, "parameterOrder": [ "parent" ], "description": "Optimizes a prompt. Given a prompt, this method returns a stream of optimized prompts expanded from the original prompt.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the location to optimize the prompt in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1OptimizePromptRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs:optimizePrompt", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/tuningJobs:optimizePrompt" }, "rebaseTunedModel": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Rebase a tuned model. A rebase operation takes a model that was previously tuned on a base model version, and retunes it on a new base model version. The rebase operation creates a new tuning job and a new tuned model.", "path": "v1beta1/{+parent}/tuningJobs:rebaseTunedModel", "request": { "$ref": "GoogleCloudAiplatformV1beta1RebaseTunedModelRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs:rebaseTunedModel", "parameters": { "parent": { "description": "Required. The resource name of the location in which to rebase the Model. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "id": "aiplatform.projects.locations.tuningJobs.rebaseTunedModel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1TuningJob" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1TuningJob" }, "id": "aiplatform.projects.locations.tuningJobs.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the location to create the tuning job in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Creates a tuning job. A created tuning job will be subsequently executed to start the model tuning process.", "path": "v1beta1/{+parent}/tuningJobs" }, "list": { "description": "Lists tuning jobs in a location.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tuningJobs.list", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The resource name of the location to list the tuning jobs from. Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true }, "filter": { "description": "Optional. The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. The standard list page size." }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token. Typically obtained from ListTuningJobsResponse.next_page_token of the previous GenAiTuningService.ListTuningJobs call." } }, "path": "v1beta1/{+parent}/tuningJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTuningJobsResponse" }, "parameterOrder": [ "parent" ] }, "cancel": { "path": "v1beta1/{+name}:cancel", "description": "Cancels a tuning job. Starts an asynchronous cancellation request. The server makes a best effort to cancel the job, but success is not guaranteed. Clients can use GenAiTuningService.GetTuningJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On successful cancellation, the tuning job is not deleted. Instead, its state is set to `CANCELLED`, and `error` is set to a status with a `google.rpc.Status.code` of 1, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+$", "type": "string", "description": "Required. The name of the tuning job to cancel. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelTuningJobRequest" }, "id": "aiplatform.projects.locations.tuningJobs.cancel", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}", "id": "aiplatform.projects.locations.tuningJobs.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1TuningJob" }, "path": "v1beta1/{+name}", "description": "Gets a tuning job.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+$", "description": "Required. The name of the tuning job to retrieve. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}`" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "operations": { "methods": { "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}/operations/{operationsId}:wait", "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.tuningJobs.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tuningJobs.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+/operations/[^/]+$", "type": "string" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.tuningJobs.operations.get", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "httpMethod": "GET" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tuningJobs/{tuningJobsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "id": "aiplatform.projects.locations.tuningJobs.operations.cancel", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tuningJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } } } } } } }, "evaluationSets": { "methods": { "create": { "id": "aiplatform.projects.locations.evaluationSets.create", "description": "Creates an Evaluation Set.", "parameterOrder": [ "parent" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the Evaluation Set in. Format: `projects/{project}/locations/{location}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" }, "path": "v1beta1/{+parent}/evaluationSets", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" } }, "patch": { "id": "aiplatform.projects.locations.evaluationSets.patch", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" }, "description": "Updates an Evaluation Set.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" }, "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+$", "location": "path", "required": true, "description": "Identifier. The resource name of the EvaluationSet. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`" }, "updateMask": { "description": "Optional. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets an Evaluation Set.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" }, "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+$", "description": "Required. The name of the EvaluationSet resource. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`", "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.projects.locations.evaluationSets.get" }, "import": { "id": "aiplatform.projects.locations.evaluationSets.import", "parameterOrder": [ "parent" ], "description": "Imports an Evaluation Set.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets:import", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Parent resource name.", "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequest" }, "path": "v1beta1/{+parent}/evaluationSets:import" }, "list": { "path": "v1beta1/{+parent}/evaluationSets", "parameters": { "orderBy": { "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending.", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `ListEvaluationSets` call. Provide this to retrieve the subsequent page.", "location": "query" }, "parent": { "description": "Required. The resource name of the Location from which to list the Evaluation Sets. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. The maximum number of Evaluation Sets to return.", "type": "integer" }, "filter": { "location": "query", "description": "Optional. Filter expression that matches a subset of the EvaluationSets to show. For field names both snake_case and camelCase are supported. For more information about filter syntax, see [AIP-160](https://google.aip.dev/160).", "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets", "id": "aiplatform.projects.locations.evaluationSets.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEvaluationSetsResponse" }, "description": "Lists Evaluation Sets." }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "Required. The name of the EvaluationSet resource to be deleted. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "description": "Deletes an Evaluation Set.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}", "id": "aiplatform.projects.locations.evaluationSets.delete", "path": "v1beta1/{+name}" } }, "resources": { "operations": { "methods": { "get": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.evaluationSets.operations.get", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET" }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.evaluationSets.operations.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } } }, "list": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}/operations", "path": "v1beta1/{+name}/operations", "id": "aiplatform.projects.locations.evaluationSets.operations.list" }, "wait": { "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "parameters": { "timeout": { "type": "string", "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/evaluationSets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.evaluationSets.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationSets/{evaluationSetsId}/operations/{operationsId}:wait" } } } } }, "voices": { "methods": { "get": { "path": "v1beta1/{+name}:get", "parameters": { "name": { "description": "Required. The resource name of the custom stored voice to retrieve (for example, `voices/voice_abc123def456`).", "pattern": "^projects/[^/]+/locations/[^/]+/voices/[^/]+$", "type": "string", "location": "path", "required": true } }, "description": "Gets a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`VOICE_TYPE_PREBUILT`) cannot be retrieved via `GetVoice`; use `ListVoices` instead.", "httpMethod": "GET", "response": { "$ref": "GenaiVertexV1beta1Voice" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/voices/{voicesId}:get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.voices.get" }, "create": { "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The parent resource where this voice will be created. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API.", "location": "path", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/voices:create", "id": "aiplatform.projects.locations.voices.create", "description": "Creates a custom voice from a natural-language prompt (`VOICE_TYPE_PROMPTED`) or from reference and consent audio recordings (`VOICE_TYPE_REPLICATED`).", "path": "v1beta1/{+parent}/voices:create", "request": { "$ref": "GoogleLearningVertexApiInteractionsV1beta1CreateVoiceRequest" }, "response": { "$ref": "GenaiVertexV1beta1Voice" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.voices.delete", "description": "Deletes a custom stored voice (`store = true`) by resource name. Prebuilt catalog voices (`\"prebuilt\"`) cannot be deleted.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/voices/{voicesId}:delete", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/voices/[^/]+$", "description": "Required. The resource name of the custom stored voice to delete (for example, `voices/voice_abc123def456`).", "location": "path", "required": true } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}:delete", "response": { "$ref": "GoogleLearningVertexApiInteractionsV1beta1DeleteVoiceResponse" } }, "list": { "id": "aiplatform.projects.locations.voices.list", "path": "v1beta1/{+parent}/voices:list", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "GoogleLearningVertexApiInteractionsV1beta1ListVoicesResponse" }, "parameters": { "search": { "description": "Optional. Free-text substring search query matched case-insensitively against both `display_name` and `description`. Maximum 2048 bytes.", "type": "string", "location": "query" }, "pageToken": { "type": "string", "description": "A page token, received from a previous `ListVoices` call. Provide this to retrieve the subsequent page. When paginating, all filter query parameters (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type`, and `search`) must match the call that returned this token; otherwise the request fails with `INVALID_ARGUMENT`. `page_size` may change between pages.", "location": "query" }, "context": { "location": "query", "type": "string", "description": "Optional. Filter by intended context or domain (e.g. \"News, Commercial\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified contexts (OR).", "repeated": true }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "Optional. The maximum number of voices to return per page. The service may return fewer than this value. If unspecified, at most 50 voices are returned. The maximum value is 1000; values above 1000 are coerced to 1000." }, "gender": { "type": "string", "description": "Optional. Filter by gender presentation (e.g. \"female\", \"male\", \"neutral\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified genders (OR).", "location": "query", "repeated": true }, "type": { "description": "Optional. Filter by voice type. Accepts `\"prebuilt\"`, `\"replicated\"`, `\"prompted\"` (case-insensitive). If multiple values are specified, matches voices with any of the specified types (OR).", "repeated": true, "location": "query", "type": "string" }, "persona": { "location": "query", "type": "string", "description": "Optional. Filter by vocal persona (e.g. \"Warm, Friendly\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified personas (OR).", "repeated": true }, "languageCode": { "type": "string", "location": "query", "repeated": true, "description": "Optional. Filter by BCP-47 language code (e.g. \"en-US\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified language codes (OR)." }, "pitch": { "location": "query", "description": "Optional. Filter by vocal pitch. Accepts `\"low\"`, `\"medium\"`, `\"high\"` (case-insensitive). If multiple values are specified, matches voices with any of the specified pitches (OR).", "type": "string", "repeated": true }, "accent": { "location": "query", "description": "Optional. Filter by accent description (e.g. \"American\", \"British\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified accents (OR).", "repeated": true, "type": "string" }, "regionCode": { "location": "query", "description": "Optional. Filter by ISO 3166-1 alpha-2 or UN M.49 region code (e.g. \"US\", \"001\"). Case-insensitive exact match. If multiple values are specified, matches voices with any of the specified region codes (OR).", "repeated": true, "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The parent that owns this collection of voices. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API.", "type": "string" } }, "description": "Lists custom stored voices owned by the caller as well as prebuilt system voices from Google's voice catalog.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/voices:list" } } }, "interactions": { "methods": { "create": { "parameters": { "locationsId": { "type": "string", "location": "path", "required": true }, "projectsId": { "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactions:create", "id": "aiplatform.projects.locations.interactions.create", "request": { "$ref": "GenaiVertexV1beta1CreateInteractionRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactions:create", "parameterOrder": [ "projectsId", "locationsId" ], "response": { "$ref": "GenaiVertexV1beta1Interaction" }, "description": "Creates an interaction.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "deprecated": true, "parameters": { "name": { "description": "Required. The name of the interaction to delete. Format: interactions/{interaction}", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/interactions/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactions/{interactionsId}", "httpMethod": "DELETE", "response": { "$ref": "GenaiVertexV1beta1DeleteInteractionResponse" }, "description": "Deletes an interaction.", "id": "aiplatform.projects.locations.interactions.delete" }, "createStream": { "description": "Creates an interaction and streams the response.", "path": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactions:createStream", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "projectsId": { "type": "string", "location": "path", "required": true }, "locationsId": { "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "GenaiVertexV1beta1CreateInteractionRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/interactions:createStream", "parameterOrder": [ "projectsId", "locationsId" ], "id": "aiplatform.projects.locations.interactions.createStream", "response": { "$ref": "GenaiVertexV1beta1InteractionStreamingEvent" } } } }, "tensorboards": { "methods": { "get": { "path": "v1beta1/{+name}", "parameters": { "name": { "description": "Required. The name of the Tensorboard resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1Tensorboard" }, "description": "Gets a Tensorboard.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}", "id": "aiplatform.projects.locations.tensorboards.get" }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.tensorboards.create", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the Tensorboard in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/tensorboards", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Creates a Tensorboard.", "request": { "$ref": "GoogleCloudAiplatformV1beta1Tensorboard" } }, "readSize": { "id": "aiplatform.projects.locations.tensorboards.readSize", "parameters": { "tensorboard": { "description": "Required. The name of the Tensorboard resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "location": "path", "required": true } }, "description": "Returns the storage size for a given TensorBoard instance.", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardSizeResponse" }, "parameterOrder": [ "tensorboard" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}:readSize", "path": "v1beta1/{+tensorboard}:readSize", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.tensorboards.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTensorboardsResponse" }, "parameters": { "orderBy": { "location": "query", "type": "string", "description": "Field to use to sort the list." }, "parent": { "description": "Required. The resource name of the Location to list Tensorboards. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous TensorboardService.ListTensorboards call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to TensorboardService.ListTensorboards must match the call that provided the page token." }, "filter": { "location": "query", "type": "string", "description": "Lists the Tensorboards that match the filter expression." }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of Tensorboards to return. The service may return fewer than this value. If unspecified, at most 100 Tensorboards are returned. The maximum value is 100; values above 100 are coerced to 100." }, "readMask": { "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "type": "string", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards", "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/tensorboards", "description": "Lists Tensorboards in a Location." }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.tensorboards.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "description": "Required. The name of the Tensorboard to be deleted. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "description": "Deletes a Tensorboard.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}" }, "readUsage": { "id": "aiplatform.projects.locations.tensorboards.readUsage", "httpMethod": "GET", "parameters": { "tensorboard": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Tensorboard resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}:readUsage", "description": "Returns a list of monthly active users for a given TensorBoard instance.", "parameterOrder": [ "tensorboard" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+tensorboard}:readUsage", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponse" } }, "patch": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "type": "string", "description": "Output only. Name of the Tensorboard. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "location": "path", "required": true }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Required. Field mask is used to specify the fields to be overwritten in the Tensorboard resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it's in the mask. If the user does not provide a mask then all fields are overwritten if new values are specified." } }, "httpMethod": "PATCH", "id": "aiplatform.projects.locations.tensorboards.patch", "request": { "$ref": "GoogleCloudAiplatformV1beta1Tensorboard" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}", "description": "Updates a Tensorboard." }, "batchRead": { "id": "aiplatform.projects.locations.tensorboards.batchRead", "parameterOrder": [ "tensorboard" ], "path": "v1beta1/{+tensorboard}:batchRead", "description": "Reads multiple TensorboardTimeSeries' data. The data point number limit is 1000 for scalars, 100 for tensors and blob references. If the number of data points stored is less than the limit, all data is returned. Otherwise, the number limit of data points is randomly selected from this time series and returned.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchReadTensorboardTimeSeriesDataResponse" }, "parameters": { "timeSeries": { "type": "string", "description": "Required. The resource names of the TensorboardTimeSeries to read data from. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`", "location": "query", "repeated": true }, "tensorboard": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "description": "Required. The resource name of the Tensorboard containing TensorboardTimeSeries to read data from. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`. The TensorboardTimeSeries referenced by time_series must be sub resources of this Tensorboard.", "location": "path", "required": true } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}:batchRead" } }, "resources": { "operations": { "methods": { "list": { "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "location": "path", "required": true }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tensorboards.operations.list", "parameterOrder": [ "name" ] }, "wait": { "parameters": { "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.tensorboards.operations.wait" }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.tensorboards.operations.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/operations/{operationsId}", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.tensorboards.operations.cancel" }, "get": { "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.tensorboards.operations.get" } } }, "experiments": { "resources": { "runs": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.projects.locations.tensorboards.experiments.runs.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations", "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "format": "int32", "location": "query" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$", "location": "path", "required": true }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.operations.wait", "parameters": { "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST" }, "cancel": { "id": "aiplatform.projects.locations.tensorboards.experiments.runs.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tensorboards.experiments.runs.operations.delete", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "httpMethod": "DELETE" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.tensorboards.experiments.runs.operations.get", "path": "v1beta1/{+name}" } } }, "timeSeries": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } } }, "cancel": { "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel" }, "list": { "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.operations.list", "parameters": { "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations" }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.operations.wait", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.operations.get", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } }, "methods": { "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "description": "Creates a TensorboardTimeSeries.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "path": "v1beta1/{+parent}/timeSeries", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the TensorboardRun to create the TensorboardTimeSeries in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$" }, "tensorboardTimeSeriesId": { "description": "Optional. The user specified unique ID to use for the TensorboardTimeSeries, which becomes the final component of the TensorboardTimeSeries's resource name. This value should match \"a-z0-9{0, 127}\"", "type": "string", "location": "query" } }, "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.create" }, "get": { "description": "Gets a TensorboardTimeSeries.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the TensorboardTimeSeries resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+name}" }, "read": { "description": "Reads a TensorboardTimeSeries' data. By default, if the number of data points stored is less than 1000, all data is returned. Otherwise, 1000 data points is randomly selected from this time series and returned. This value can be changed by changing max_data_points, which can't be greater than 10k.", "path": "v1beta1/{+tensorboardTimeSeries}:read", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.read", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}:read", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardTimeSeriesDataResponse" }, "parameters": { "maxDataPoints": { "description": "The maximum number of TensorboardTimeSeries' data to return. This value should be a positive integer. This value can be set to -1 to return all data.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "description": "Reads the TensorboardTimeSeries' data that match the filter expression.", "location": "query", "type": "string" }, "tensorboardTimeSeries": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$", "description": "Required. The resource name of the TensorboardTimeSeries to read data from. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`", "location": "path", "required": true } }, "parameterOrder": [ "tensorboardTimeSeries" ] }, "exportTensorboardTimeSeries": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "tensorboardTimeSeries" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}:exportTensorboardTimeSeries", "parameters": { "tensorboardTimeSeries": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the TensorboardTimeSeries to export data from. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`" } }, "httpMethod": "POST", "path": "v1beta1/{+tensorboardTimeSeries}:exportTensorboardTimeSeries", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest" }, "description": "Exports a TensorboardTimeSeries' data. Data is returned in paginated responses.", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.exportTensorboardTimeSeries" }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.delete", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$", "type": "string", "description": "Required. The name of the TensorboardTimeSeries to be deleted. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`" } }, "description": "Deletes a TensorboardTimeSeries." }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Output only. Name of the TensorboardTimeSeries.", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the TensorboardTimeSeries resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it's in the mask. If the user does not provide a mask then all fields are overwritten if new values are specified.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.patch", "parameterOrder": [ "name" ], "description": "Updates a TensorboardTimeSeries.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" } }, "readBlobData": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}:readBlobData", "parameterOrder": [ "timeSeries" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardBlobDataResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "httpMethod": "GET", "parameters": { "blobIds": { "description": "IDs of the blobs to read.", "repeated": true, "location": "query", "type": "string" }, "timeSeries": { "description": "Required. The resource name of the TensorboardTimeSeries to list Blobs. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}/timeSeries/{time_series}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$", "type": "string" } }, "path": "v1beta1/{+timeSeries}:readBlobData", "description": "Gets bytes of TensorboardBlobs. This is to allow reading blob data stored in consumer project's Cloud Storage bucket without users having to obtain Cloud Storage access permission.", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.readBlobData" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.tensorboards.experiments.runs.timeSeries.list", "description": "Lists TensorboardTimeSeries in a Location.", "path": "v1beta1/{+parent}/timeSeries", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTensorboardTimeSeriesResponse" }, "httpMethod": "GET", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the TensorboardRun to list TensorboardTimeSeries. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$", "location": "path", "required": true }, "orderBy": { "description": "Field to use to sort the list.", "location": "query", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous TensorboardService.ListTensorboardTimeSeries call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to TensorboardService.ListTensorboardTimeSeries must match the call that provided the page token." }, "pageSize": { "format": "int32", "type": "integer", "description": "The maximum number of TensorboardTimeSeries to return. The service may return fewer than this value. If unspecified, at most 50 TensorboardTimeSeries are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", "location": "query" }, "readMask": { "type": "string", "format": "google-fieldmask", "description": "Mask specifying which fields to read.", "location": "query" }, "filter": { "description": "Lists the TensorboardTimeSeries that match the filter expression.", "location": "query", "type": "string" } } } } } }, "methods": { "create": { "id": "aiplatform.projects.locations.tensorboards.experiments.runs.create", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "path": "v1beta1/{+parent}/runs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs", "parameters": { "tensorboardRunId": { "type": "string", "location": "query", "description": "Required. The ID to use for the Tensorboard run, which becomes the final component of the Tensorboard run's resource name. This value should be 1-128 characters, and valid characters are `/a-z-/`." }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "description": "Required. The resource name of the TensorboardExperiment to create the TensorboardRun in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`", "type": "string" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a TensorboardRun." }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.tensorboards.experiments.runs.list", "httpMethod": "GET", "parameters": { "filter": { "location": "query", "type": "string", "description": "Lists the TensorboardRuns that match the filter expression." }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous TensorboardService.ListTensorboardRuns call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to TensorboardService.ListTensorboardRuns must match the call that provided the page token." }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The maximum number of TensorboardRuns to return. The service may return fewer than this value. If unspecified, at most 50 TensorboardRuns are returned. The maximum value is 1000; values above 1000 are coerced to 1000." }, "readMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Mask specifying which fields to read." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the TensorboardExperiment to list TensorboardRuns. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`" }, "orderBy": { "location": "query", "description": "Field to use to sort the list.", "type": "string" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTensorboardRunsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+parent}/runs", "description": "Lists TensorboardRuns in a Location." }, "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Gets a TensorboardRun.", "parameters": { "name": { "type": "string", "description": "Required. The name of the TensorboardRun resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" } }, "batchCreate": { "path": "v1beta1/{+parent}/runs:batchCreate", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.batchCreate", "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsRequest" }, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "description": "Required. The resource name of the TensorboardExperiment to create the TensorboardRuns in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}` The parent field in the CreateTensorboardRunRequest messages must match this field.", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsResponse" }, "description": "Batch create TensorboardRuns.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs:batchCreate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "path": "v1beta1/{+name}", "description": "Updates a TensorboardRun.", "httpMethod": "PATCH", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.patch", "parameters": { "name": { "type": "string", "description": "Output only. Name of the TensorboardRun. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$" }, "updateMask": { "location": "query", "description": "Required. Field mask is used to specify the fields to be overwritten in the TensorboardRun resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it's in the mask. If the user does not provide a mask then all fields are overwritten if new values are specified.", "type": "string", "format": "google-fieldmask" } } }, "delete": { "parameters": { "name": { "description": "Required. The name of the TensorboardRun to be deleted. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes a TensorboardRun.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.tensorboards.experiments.runs.delete" }, "write": { "parameterOrder": [ "tensorboardRun" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tensorboards.experiments.runs.write", "httpMethod": "POST", "parameters": { "tensorboardRun": { "type": "string", "description": "Required. The resource name of the TensorboardRun to write data to. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}:write", "path": "v1beta1/{+tensorboardRun}:write", "response": { "$ref": "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataResponse" }, "description": "Write time series data points into multiple TensorboardTimeSeries under a TensorboardRun. If any data fail to be ingested, an error is returned." } } }, "operations": { "methods": { "delete": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.tensorboards.experiments.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}", "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.tensorboards.experiments.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." } } }, "wait": { "id": "aiplatform.projects.locations.tensorboards.experiments.operations.wait", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}:wait", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string", "format": "google-duration" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.tensorboards.experiments.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.tensorboards.experiments.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST" } } } }, "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments", "id": "aiplatform.projects.locations.tensorboards.experiments.create", "description": "Creates a TensorboardExperiment.", "path": "v1beta1/{+parent}/experiments", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "parameters": { "parent": { "description": "Required. The resource name of the Tensorboard to create the TensorboardExperiment in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$", "type": "string", "location": "path", "required": true }, "tensorboardExperimentId": { "type": "string", "location": "query", "description": "Required. The ID to use for the Tensorboard experiment, which becomes the final component of the Tensorboard experiment's resource name. This value should be 1-128 characters, and valid characters are `/a-z-/`." } }, "httpMethod": "POST" }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.tensorboards.experiments.get", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets a TensorboardExperiment.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the TensorboardExperiment resource. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" } }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}", "id": "aiplatform.projects.locations.tensorboards.experiments.patch", "response": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates a TensorboardExperiment.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "parameters": { "name": { "location": "path", "required": true, "description": "Output only. Name of the TensorboardExperiment. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "Required. Field mask is used to specify the fields to be overwritten in the TensorboardExperiment resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field is overwritten if it's in the mask. If the user does not provide a mask then all fields are overwritten if new values are specified." } } }, "list": { "id": "aiplatform.projects.locations.tensorboards.experiments.list", "description": "Lists TensorboardExperiments in a Location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListTensorboardExperimentsResponse" }, "path": "v1beta1/{+parent}/experiments", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Tensorboard to list TensorboardExperiments. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+$" }, "pageSize": { "location": "query", "description": "The maximum number of TensorboardExperiments to return. The service may return fewer than this value. If unspecified, at most 50 TensorboardExperiments are returned. The maximum value is 1000; values above 1000 are coerced to 1000.", "format": "int32", "type": "integer" }, "readMask": { "description": "Mask specifying which fields to read.", "type": "string", "format": "google-fieldmask", "location": "query" }, "filter": { "type": "string", "description": "Lists the TensorboardExperiments that match the filter expression.", "location": "query" }, "orderBy": { "description": "Field to use to sort the list.", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous TensorboardService.ListTensorboardExperiments call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to TensorboardService.ListTensorboardExperiments must match the call that provided the page token." } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments" }, "write": { "id": "aiplatform.projects.locations.tensorboards.experiments.write", "parameterOrder": [ "tensorboardExperiment" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataRequest" }, "parameters": { "tensorboardExperiment": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the TensorboardExperiment to write data to. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataResponse" }, "httpMethod": "POST", "path": "v1beta1/{+tensorboardExperiment}:write", "description": "Write time series data points of multiple TensorboardTimeSeries in multiple TensorboardRun's. If any data fail to be ingested, an error is returned.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}:write" }, "batchCreate": { "id": "aiplatform.projects.locations.tensorboards.experiments.batchCreate", "parameterOrder": [ "parent" ], "description": "Batch create TensorboardTimeSeries that belong to a TensorboardExperiment.", "path": "v1beta1/{+parent}:batchCreate", "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesResponse" }, "parameters": { "parent": { "description": "Required. The resource name of the TensorboardExperiment to create the TensorboardTimeSeries in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}` The TensorboardRuns referenced by the parent fields in the CreateTensorboardTimeSeriesRequest messages must be sub resources of this TensorboardExperiment.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}:batchCreate" }, "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/tensorboards/[^/]+/experiments/[^/]+$", "description": "Required. The name of the TensorboardExperiment to be deleted. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.tensorboards.experiments.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes a TensorboardExperiment.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/tensorboards/{tensorboardsId}/experiments/{experimentsId}" } } } } }, "ragCorpora": { "resources": { "ragDataSchemas": { "methods": { "batchCreate": { "description": "Batch Create one or more RagDataSchemas", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas:batchCreate", "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The resource name of the RagCorpus to create the RagDataSchemas in. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateRagDataSchemasRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.batchCreate", "path": "v1beta1/{+parent}/ragDataSchemas:batchCreate" }, "batchDelete": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas:batchDelete", "path": "v1beta1/{+parent}/ragDataSchemas:batchDelete", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "description": "Required. The resource name of the RagCorpus from which to delete the RagDataSchemas. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchDeleteRagDataSchemasRequest" }, "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.batchDelete", "parameterOrder": [ "parent" ], "description": "Batch Deletes one or more RagDataSchemas" }, "list": { "description": "Lists RagDataSchemas in a Location.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/ragDataSchemas", "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.list", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListRagDataSchemasResponse.next_page_token of the previous VertexRagDataService.ListRagDataSchemas call." }, "pageSize": { "format": "int32", "description": "Optional. The standard list page size. The maximum value is 100. If not specified, a default value of 100 will be used.", "location": "query", "type": "integer" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "description": "Required. The resource name of the RagCorpus from which to list the RagDataSchemas. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "location": "path", "required": true } }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListRagDataSchemasResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas" }, "create": { "parameters": { "ragDataSchemaId": { "location": "query", "type": "string", "description": "Optional. The ID to use for the RagDataSchema, which will become the final component of the RagDataSchema's resource name if the user chooses to specify. Otherwise, RagDataSchema id will be generated by system. This value should be up to 63 characters, and valid characters are /a-z-/. The first character must be a letter, the last could be a letter or a number." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "description": "Required. The resource name of the RagCorpus to create the RagDataSchema in. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1RagDataSchema" }, "description": "Creates a RagDataSchema.", "path": "v1beta1/{+parent}/ragDataSchemas", "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1RagDataSchema" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas" }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragDataSchemas/[^/]+$", "type": "string", "description": "Required. The name of the RagDataSchema resource. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragDataSchemas/{rag_data_schema}`" } }, "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a RagDataSchema.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas/{ragDataSchemasId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagDataSchema" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragDataSchemas/{ragDataSchemasId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a RagDataSchema.", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragDataSchemas/[^/]+$", "description": "Required. The name of the RagDataSchema resource to be deleted. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragDataSchemas/{rag_data_schema}`", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.ragDataSchemas.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "ragFiles": { "resources": { "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations", "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.operations.list", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations" }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.ragCorpora.ragFiles.operations.wait" }, "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.operations.cancel", "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.operations.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.ragFiles.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}" } } }, "ragMetadata": { "methods": { "batchDelete": { "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The resource name of the RagFile from which to delete the RagMetadata. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/ragMetadata:batchDelete", "description": "Batch Deletes one or more RagMetadata.", "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchDeleteRagMetadataRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.batchDelete", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata:batchDelete" }, "create": { "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The parent resource where this metadata will be created. Format: `projects/{project_number}/locations/{location_id}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`" }, "ragMetadataId": { "description": "Optional. The ID to use for the metadata, which will become the final component of the metadata's resource name if the user chooses to specify. Otherwise, metadata id will be generated by system. This value should be up to 63 characters, and valid characters are /a-z-/. The first character must be a letter, the last could be a letter or a number.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" }, "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.create", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" }, "description": "Creates a RagMetadata.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/ragMetadata" }, "batchCreate": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/ragMetadata:batchCreate", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The parent resource where the RagMetadata will be created. Format: `projects/{project_number}/locations/{location_id}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata:batchCreate", "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateRagMetadataRequest" }, "description": "Batch Create one or more RagMetadatas", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.batchCreate" }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/ragMetadata/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the RagMetadata resource. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}/ragMetadata/{rag_metadata}`" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata/{ragMetadataId}", "path": "v1beta1/{+name}", "description": "Gets a RagMetadata.", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.get", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListRagMetadataResponse" }, "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "Optional. The standard list page size. The maximum value is 100. If not specified, a default value of 100 will be used.", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListRagMetadataResponse.next_page_token of the previous VertexRagDataService.ListRagMetadata call.", "location": "query" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "type": "string", "description": "Required. The resource name of the RagFile from which to list the RagMetadata. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata", "path": "v1beta1/{+parent}/ragMetadata", "description": "Lists RagMetadata in a RagFile.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata/{ragMetadataId}", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.patch", "path": "v1beta1/{+name}", "httpMethod": "PATCH", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" }, "parameters": { "name": { "location": "path", "required": true, "description": "Identifier. Resource name of the RagMetadata. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}/ragMetadata/{rag_metadata}`", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/ragMetadata/[^/]+$", "type": "string" } }, "description": "Updates a RagMetadata.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" } }, "delete": { "id": "aiplatform.projects.locations.ragCorpora.ragFiles.ragMetadata.delete", "description": "Deletes a RagMetadata.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+/ragMetadata/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the RagMetadata resource to be deleted. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}/ragMetadata/{rag_metadata}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/ragMetadata/{ragMetadataId}", "httpMethod": "DELETE", "path": "v1beta1/{+name}" } } } }, "methods": { "delete": { "id": "aiplatform.projects.locations.ragCorpora.ragFiles.delete", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a RagFile.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the RagFile resource to be deleted. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`", "type": "string" }, "forceDelete": { "type": "boolean", "location": "query", "description": "Optional. If set to true, any errors generated by external vector database during the deletion will be ignored. The default value is false." } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE" }, "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagFile" }, "id": "aiplatform.projects.locations.ragCorpora.ragFiles.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a RagFile.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/ragFiles/[^/]+$", "description": "Required. The name of the RagFile resource. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET" }, "list": { "description": "Lists RagFiles in a RagCorpus.", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the RagCorpus from which to list the RagFiles. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$" }, "pageSize": { "location": "query", "description": "Optional. The standard list page size. The maximum value is 100. If not specified, a default value of 100 will be used.", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token. Typically obtained via ListRagFilesResponse.next_page_token of the previous VertexRagDataService.ListRagFiles call." } }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListRagFilesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.list", "path": "v1beta1/{+parent}/ragFiles" }, "import": { "path": "v1beta1/{+parent}/ragFiles:import", "id": "aiplatform.projects.locations.ragCorpora.ragFiles.import", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles:import", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "type": "string", "description": "Required. The name of the RagCorpus resource into which to import files. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportRagFilesRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Import files from Google Cloud Storage or Google Drive into a RagCorpus." } } }, "operations": { "methods": { "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/operations/{operationsId}", "id": "aiplatform.projects.locations.ragCorpora.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/operations/[^/]+$", "location": "path", "required": true } } }, "list": { "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.operations.list", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.projects.locations.ragCorpora.operations.wait" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/operations/{operationsId}:cancel" } } } }, "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "force": { "description": "Optional. If set to true, any RagFiles in this RagCorpus will also be deleted. Otherwise, the request will only work if the RagCorpus has no RagFiles.", "type": "boolean", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "description": "Required. The name of the RagCorpus resource to be deleted. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`" }, "forceDelete": { "description": "Optional. If set to true, any errors generated by external vector database during the deletion will be ignored. The default value is false.", "location": "query", "type": "boolean" } }, "description": "Deletes a RagCorpus.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.delete", "response": { "$ref": "GoogleLongrunningOperation" } }, "patch": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Output only. The resource name of the RagCorpus.", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$" } }, "httpMethod": "PATCH", "id": "aiplatform.projects.locations.ragCorpora.patch", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Updates a RagCorpus.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}", "request": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpus" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the RagCorpora. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListRagCorporaResponse.next_page_token of the previous VertexRagDataService.ListRagCorpora call.", "location": "query" }, "pageSize": { "format": "int32", "description": "Optional. The standard list page size. The maximum value is 100. If not specified, a default value of 100 will be used.", "location": "query", "type": "integer" } }, "id": "aiplatform.projects.locations.ragCorpora.list", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora", "description": "Lists RagCorpora in a Location.", "path": "v1beta1/{+parent}/ragCorpora", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListRagCorporaResponse" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}", "path": "v1beta1/{+name}", "description": "Gets a RagCorpus.", "response": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpus" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.ragCorpora.get", "parameters": { "name": { "description": "Required. The name of the RagCorpus resource. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.ragCorpora.create", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the RagCorpus in. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpus" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora", "description": "Creates a RagCorpus.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/ragCorpora" } } }, "modelMonitors": { "methods": { "searchModelMonitoringAlerts": { "path": "v1beta1/{+modelMonitor}:searchModelMonitoringAlerts", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}:searchModelMonitoringAlerts", "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsResponse" }, "httpMethod": "POST", "parameters": { "modelMonitor": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$", "description": "Required. ModelMonitor resource name. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Returns the Model Monitoring alerts.", "parameterOrder": [ "modelMonitor" ], "id": "aiplatform.projects.locations.modelMonitors.searchModelMonitoringAlerts", "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsRequest" } }, "list": { "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1beta1/{+parent}/modelMonitors", "parameters": { "filter": { "location": "query", "description": "The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "readMask": { "location": "query", "description": "Mask specifying which fields to read.", "type": "string", "format": "google-fieldmask" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to list the ModelMonitors from. Format: `projects/{project}/locations/{location}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors", "description": "Lists ModelMonitors in a Location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelMonitorsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelMonitors.list" }, "create": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelMonitors.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/modelMonitors", "description": "Creates a ModelMonitor.", "httpMethod": "POST", "parameters": { "modelMonitorId": { "location": "query", "description": "Optional. The ID to use for the Model Monitor, which will become the final component of the model monitor resource name. The maximum length is 63 characters, and valid characters are `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`.", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the ModelMonitor in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitor" } }, "searchModelMonitoringStats": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}:searchModelMonitoringStats", "path": "v1beta1/{+modelMonitor}:searchModelMonitoringStats", "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsRequest" }, "id": "aiplatform.projects.locations.modelMonitors.searchModelMonitoringStats", "httpMethod": "POST", "parameters": { "modelMonitor": { "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$", "type": "string", "description": "Required. ModelMonitor resource name. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`", "location": "path", "required": true } }, "parameterOrder": [ "modelMonitor" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsResponse" }, "description": "Searches Model Monitoring Stats generated within a given time window.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelMonitors.delete", "description": "Deletes a ModelMonitor.", "parameters": { "force": { "description": "Optional. Force delete the model monitor with schedules.", "location": "query", "type": "boolean" }, "name": { "description": "Required. The name of the ModelMonitor resource to be deleted. Format: `projects/{project}/locations/{location}/modelMonitords/{model_monitor}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$" } }, "httpMethod": "DELETE" }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitor" }, "id": "aiplatform.projects.locations.modelMonitors.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}", "parameterOrder": [ "name" ], "description": "Gets a ModelMonitor.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$", "description": "Required. The name of the ModelMonitor resource. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "patch": { "description": "Updates a ModelMonitor.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitor" }, "id": "aiplatform.projects.locations.modelMonitors.patch", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$", "description": "Immutable. Resource name of the ModelMonitor. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`." }, "updateMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Required. Mask specifying which fields to update." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}", "httpMethod": "PATCH" } }, "resources": { "modelMonitoringJobs": { "methods": { "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJob" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "description": "Required. The resource name of the ModelMonitoringJob. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}/modelMonitoringJobs/{model_monitoring_job}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/modelMonitoringJobs/[^/]+$" } }, "description": "Gets a ModelMonitoringJob.", "httpMethod": "GET", "id": "aiplatform.projects.locations.modelMonitors.modelMonitoringJobs.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/modelMonitoringJobs/{modelMonitoringJobsId}" }, "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.modelMonitors.modelMonitoringJobs.delete", "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/modelMonitoringJobs/{modelMonitoringJobsId}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/modelMonitoringJobs/[^/]+$", "description": "Required. The resource name of the model monitoring job to delete. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}/modelMonitoringJobs/{model_monitoring_job}`" } }, "description": "Deletes a ModelMonitoringJob.", "response": { "$ref": "GoogleLongrunningOperation" } }, "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJob" }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/modelMonitoringJobs", "request": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJob" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/modelMonitoringJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a ModelMonitoringJob.", "parameters": { "modelMonitoringJobId": { "location": "query", "type": "string", "description": "Optional. The ID to use for the Model Monitoring Job, which will become the final component of the model monitoring job resource name. The maximum length is 63 characters, and valid characters are `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`." }, "parent": { "type": "string", "description": "Required. The parent of the ModelMonitoringJob. Format: `projects/{project}/locations/{location}/modelMoniitors/{model_monitor}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$" } }, "id": "aiplatform.projects.locations.modelMonitors.modelMonitoringJobs.create", "httpMethod": "POST" }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelMonitoringJobsResponse" }, "path": "v1beta1/{+parent}/modelMonitoringJobs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/modelMonitoringJobs", "id": "aiplatform.projects.locations.modelMonitors.modelMonitoringJobs.list", "description": "Lists ModelMonitoringJobs. Callers may choose to read across multiple Monitors as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of modelMonitor id in the parent. Format `projects/{project_id}/locations/{location}/moodelMonitors/-/modelMonitoringJobs`", "httpMethod": "GET", "parameters": { "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "readMask": { "description": "Mask specifying which fields to read", "type": "string", "format": "google-fieldmask", "location": "query" }, "filter": { "location": "query", "description": "The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The parent of the ModelMonitoringJob. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.modelMonitors.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel" }, "list": { "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.modelMonitors.operations.list" }, "wait": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.modelMonitors.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.modelMonitors.operations.get", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/modelMonitors/{modelMonitorsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.modelMonitors.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/modelMonitors/[^/]+/operations/[^/]+$" } } } } } } }, "extensionControllers": { "resources": { "operations": { "methods": { "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/extensionControllers/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensionControllers/{extensionControllersId}/operations", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.extensionControllers.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "id": "aiplatform.projects.locations.extensionControllers.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensionControllers/{extensionControllersId}/operations/{operationsId}:wait", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/extensionControllers/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "get": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/extensionControllers/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource." } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.extensionControllers.operations.get", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensionControllers/{extensionControllersId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/extensionControllers/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensionControllers/{extensionControllersId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.extensionControllers.operations.cancel", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel" }, "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/extensionControllers/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.extensionControllers.operations.delete", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensionControllers/{extensionControllersId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." } } } } }, "solvers": { "resources": { "operations": { "methods": { "get": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/solvers/{solversId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/solvers/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.solvers.operations.get" }, "list": { "id": "aiplatform.projects.locations.solvers.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/solvers/{solversId}/operations", "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/solvers/[^/]+$", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/solvers/{solversId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/solvers/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.solvers.operations.delete" } } } } }, "datasets": { "methods": { "export": { "description": "Exports data from a Dataset.", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExportDataRequest" }, "path": "v1beta1/{+name}:export", "id": "aiplatform.projects.locations.datasets.export", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "description": "Required. The name of the Dataset resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:export" }, "assess": { "parameters": { "name": { "description": "Required. The name of the Dataset resource. Used only for MULTIMODAL datasets. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:assess", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.datasets.assess", "request": { "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequest" }, "description": "Assesses the state or validity of the dataset with respect to a given use case.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:assess" }, "setIamPolicy": { "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.datasets.setIamPolicy", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "path": "v1beta1/{+resource}:setIamPolicy" }, "create": { "id": "aiplatform.projects.locations.datasets.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to create the Dataset in. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "description": "Creates a Dataset.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets", "path": "v1beta1/{+parent}/datasets", "parameterOrder": [ "parent" ] }, "searchDataItems": { "id": "aiplatform.projects.locations.datasets.searchDataItems", "description": "Searches DataItems in a Dataset.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:searchDataItems", "httpMethod": "GET", "parameters": { "annotationsLimit": { "description": "If set, only up to this many of Annotations will be returned per DataItemView. The maximum value is 1000. If not set, the maximum value will be used.", "format": "int32", "location": "query", "type": "integer" }, "dataItemFilter": { "description": "An expression for filtering the DataItem that will be returned. * `data_item_id` - for = or !=. * `labeled` - for = or !=. * `has_annotation(ANNOTATION_SPEC_ID)` - true only for DataItem that have at least one annotation with annotation_spec_id = `ANNOTATION_SPEC_ID` in the context of SavedQuery or DataLabelingJob. For example: * `data_item=1` * `has_annotation(5)`", "type": "string", "location": "query" }, "fieldMask": { "format": "google-fieldmask", "type": "string", "location": "query", "description": "Mask specifying which fields of DataItemView to read." }, "pageSize": { "description": "Requested page size. Server may return fewer results than requested. Default and maximum page size is 100.", "location": "query", "type": "integer", "format": "int32" }, "dataLabelingJob": { "location": "query", "type": "string", "description": "The resource name of a DataLabelingJob. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}` If this field is set, all of the search will be done in the context of this DataLabelingJob." }, "orderByAnnotation.orderBy": { "description": "A comma-separated list of annotation fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Must also specify saved_query.", "type": "string", "location": "query" }, "orderByDataItem": { "location": "query", "type": "string", "description": "A comma-separated list of data item fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending." }, "annotationsFilter": { "description": "An expression for filtering the Annotations that will be returned per DataItem. * `annotation_spec_id` - for = or !=.", "type": "string", "deprecated": true, "location": "query" }, "annotationFilters": { "description": "An expression that specifies what Annotations will be returned per DataItem. Annotations satisfied either of the conditions will be returned. * `annotation_spec_id` - for = or !=. Must specify `saved_query_id=` - saved query id that annotations should belong to.", "location": "query", "repeated": true, "type": "string" }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending.", "deprecated": true, "location": "query", "type": "string" }, "savedQuery": { "type": "string", "description": "The resource name of a SavedQuery(annotation set in UI). Format: `projects/{project}/locations/{location}/datasets/{dataset}/savedQueries/{saved_query}` All of the search will be done in the context of this SavedQuery.", "location": "query", "deprecated": true }, "pageToken": { "description": "A token identifying a page of results for the server to return Typically obtained via SearchDataItemsResponse.next_page_token of the previous DatasetService.SearchDataItems call.", "type": "string", "location": "query" }, "dataset": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "type": "string", "description": "Required. The resource name of the Dataset from which to search DataItems. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "location": "path", "required": true }, "orderByAnnotation.savedQuery": { "location": "query", "description": "Required. Saved query of the Annotation. Only Annotations belong to this saved query will be considered for ordering.", "type": "string" } }, "path": "v1beta1/{+dataset}:searchDataItems", "parameterOrder": [ "dataset" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchDataItemsResponse" } }, "delete": { "id": "aiplatform.projects.locations.datasets.delete", "description": "Deletes a Dataset.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Dataset to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}", "path": "v1beta1/{+name}" }, "import": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:import", "path": "v1beta1/{+name}:import", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.datasets.import", "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportDataRequest" }, "description": "Imports data into a Dataset.", "parameterOrder": [ "name" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "Required. The name of the Dataset resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "location": "path", "required": true } } }, "list": { "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "location": "query", "type": "string", "description": "An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `display_name`: supports = and != * `metadata_schema_uri`: supports = and != * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels.\"a key\"`. Some examples: * `displayName=\"myDisplayName\"` * `labels.myKey=\"myValue\"`" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "readMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Mask specifying which fields to read." }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time`", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Dataset's parent resource. Format: `projects/{project}/locations/{location}`" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.datasets.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDatasetsResponse" }, "description": "Lists Datasets in a Location.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets", "path": "v1beta1/{+parent}/datasets" }, "testIamPermissions": { "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:testIamPermissions", "parameterOrder": [ "resource" ], "path": "v1beta1/{+resource}:testIamPermissions", "id": "aiplatform.projects.locations.datasets.testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "type": "string", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true }, "permissions": { "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "repeated": true, "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "patch": { "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "location": "path", "required": true, "description": "Output only. Identifier. The resource name of the Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "string" }, "updateMask": { "type": "string", "format": "google-fieldmask", "location": "query", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name` * `description` * `labels`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.datasets.patch", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}", "description": "Updates a Dataset.", "response": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" } }, "getIamPolicy": { "parameterOrder": [ "resource" ], "id": "aiplatform.projects.locations.datasets.getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "options.requestedPolicyVersion": { "location": "query", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "type": "integer", "format": "int32" }, "resource": { "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$" } } }, "assemble": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.datasets.assemble", "description": "Assembles each row of a multimodal dataset and writes the result into a BigQuery table.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}:assemble", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "path": "v1beta1/{+name}:assemble", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Dataset resource (used only for MULTIMODAL datasets). Format: `projects/{project}/locations/{location}/datasets/{dataset}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1AssembleDataRequest" } }, "get": { "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}", "parameters": { "readMask": { "type": "string", "format": "google-fieldmask", "description": "Mask specifying which fields to read.", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the Dataset resource.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$" } }, "id": "aiplatform.projects.locations.datasets.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "description": "Gets a Dataset.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } }, "resources": { "operations": { "methods": { "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "id": "aiplatform.projects.locations.datasets.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/operations/{operationsId}" }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.datasets.operations.get", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/operations", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.operations.list" }, "wait": { "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.datasets.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.datasets.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+name}:cancel" } } }, "datasetVersions": { "methods": { "create": { "id": "aiplatform.projects.locations.datasets.datasetVersions.create", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Dataset resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions", "description": "Create a version from a Dataset.", "path": "v1beta1/{+parent}/datasetVersions", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "parameterOrder": [ "name" ], "description": "Gets a Dataset version.", "path": "v1beta1/{+name}", "parameters": { "readMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Mask specifying which fields to read." }, "name": { "type": "string", "description": "Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.datasets.datasetVersions.get" }, "list": { "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions", "parameters": { "filter": { "location": "query", "type": "string", "description": "Optional. The standard list filter." }, "pageSize": { "location": "query", "description": "Optional. The standard list page size.", "format": "int32", "type": "integer" }, "readMask": { "description": "Optional. Mask specifying which fields to read.", "format": "google-fieldmask", "type": "string", "location": "query" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Dataset to list DatasetVersions from. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" }, "pageToken": { "description": "Optional. The standard list page token.", "type": "string", "location": "query" }, "orderBy": { "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending.", "location": "query" } }, "description": "Lists DatasetVersions in a Dataset.", "id": "aiplatform.projects.locations.datasets.datasetVersions.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDatasetVersionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/datasetVersions" }, "patch": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "description": "Updates a DatasetVersion.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.datasets.datasetVersions.patch", "httpMethod": "PATCH", "parameters": { "updateMask": { "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name`", "type": "string", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$", "type": "string", "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" } }, "restore": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the DatasetVersion resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "type": "string" } }, "description": "Restores a dataset version.", "httpMethod": "GET", "id": "aiplatform.projects.locations.datasets.datasetVersions.restore", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:restore", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}:restore", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "delete": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.datasetVersions.delete", "description": "Deletes a Dataset version.", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/datasetVersions/[^/]+$", "description": "Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "savedQueries": { "methods": { "list": { "httpMethod": "GET", "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "orderBy": { "location": "query", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending.", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "readMask": { "description": "Mask specifying which fields to read.", "location": "query", "type": "string", "format": "google-fieldmask" }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "description": "Required. The resource name of the Dataset to list SavedQueries from. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" } }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/savedQueries", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists SavedQueries in a Dataset.", "id": "aiplatform.projects.locations.datasets.savedQueries.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSavedQueriesResponse" } }, "delete": { "id": "aiplatform.projects.locations.datasets.savedQueries.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+$", "description": "Required. The resource name of the SavedQuery to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/savedQueries/{saved_query}`", "location": "path", "required": true } }, "description": "Deletes a SavedQuery.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}" } }, "resources": { "operations": { "methods": { "cancel": { "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.savedQueries.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "id": "aiplatform.projects.locations.datasets.savedQueries.operations.list", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+$" }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations" }, "wait": { "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query", "format": "google-duration" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.projects.locations.datasets.savedQueries.operations.wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.datasets.savedQueries.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.savedQueries.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." } } } } }, "annotationSpecs": { "resources": { "operations": { "methods": { "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.datasets.annotationSpecs.operations.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.datasets.annotationSpecs.operations.delete", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted." } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+$", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.datasets.annotationSpecs.operations.list", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.datasets.annotationSpecs.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "POST" }, "cancel": { "id": "aiplatform.projects.locations.datasets.annotationSpecs.operations.cancel", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" } } } } }, "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "readMask": { "type": "string", "format": "google-fieldmask", "description": "Mask specifying which fields to read.", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/annotationSpecs/[^/]+$", "description": "Required. The name of the AnnotationSpec resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}`" } }, "httpMethod": "GET", "description": "Gets an AnnotationSpec.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1AnnotationSpec" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.annotationSpecs.get" } } }, "dataItems": { "methods": { "list": { "id": "aiplatform.projects.locations.datasets.dataItems.list", "path": "v1beta1/{+parent}/dataItems", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "readMask": { "type": "string", "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "location": "query" }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+$", "description": "Required. The resource name of the Dataset to list DataItems from. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "orderBy": { "location": "query", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending.", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." } }, "description": "Lists DataItems in a Dataset.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDataItemsResponse" } } }, "resources": { "annotations": { "resources": { "operations": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.datasets.dataItems.annotations.operations.delete" }, "cancel": { "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.datasets.dataItems.annotations.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.datasets.dataItems.annotations.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The standard list page size." }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.datasets.dataItems.annotations.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "aiplatform.projects.locations.datasets.dataItems.annotations.operations.wait", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" } } } } }, "methods": { "list": { "path": "v1beta1/{+parent}/annotations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListAnnotationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations", "parameters": { "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "readMask": { "description": "Mask specifying which fields to read.", "location": "query", "format": "google-fieldmask", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+$", "description": "Required. The resource name of the DataItem to list Annotations from. Format: `projects/{project}/locations/{location}/datasets/{dataset}/dataItems/{data_item}`", "location": "path", "required": true }, "orderBy": { "type": "string", "location": "query", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.datasets.dataItems.annotations.list", "description": "Lists Annotations belongs to a dataitem.", "parameterOrder": [ "parent" ] } } }, "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.datasets.dataItems.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/operations", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "id": "aiplatform.projects.locations.datasets.dataItems.operations.wait" }, "cancel": { "id": "aiplatform.projects.locations.datasets.dataItems.operations.cancel", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "delete": { "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.datasets.dataItems.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}", "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "id": "aiplatform.projects.locations.datasets.dataItems.operations.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" } } } } } } }, "specialistPools": { "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The parent Project name for the new SpecialistPool. The form is `projects/{project}/locations/{location}`.", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "description": "Creates a SpecialistPool.", "httpMethod": "POST", "path": "v1beta1/{+parent}/specialistPools", "id": "aiplatform.projects.locations.specialistPools.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1SpecialistPool" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools" }, "get": { "parameterOrder": [ "name" ], "description": "Gets a SpecialistPool.", "id": "aiplatform.projects.locations.specialistPools.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of the SpecialistPool resource. The form is `projects/{project}/locations/{location}/specialistPools/{specialist_pool}`.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1SpecialistPool" }, "path": "v1beta1/{+name}" }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.specialistPools.patch", "description": "Updates a SpecialistPool.", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1SpecialistPool" }, "parameters": { "name": { "description": "Required. The resource name of the SpecialistPool.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+$", "type": "string" }, "updateMask": { "description": "Required. The update mask applies to the resource.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "path": "v1beta1/{+name}" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a SpecialistPool as well as all Specialists in the pool.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.specialistPools.delete", "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameters": { "force": { "description": "If set to true, any specialist managers in this SpecialistPool will also be deleted. (Otherwise, the request will only work if the SpecialistPool has no specialist managers.)", "type": "boolean", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the SpecialistPool to delete. Format: `projects/{project}/locations/{location}/specialistPools/{specialist_pool}`", "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+$" } } }, "list": { "parameters": { "pageToken": { "type": "string", "description": "The standard list page token. Typically obtained by ListSpecialistPoolsResponse.next_page_token of the previous SpecialistPoolService.ListSpecialistPools call. Return first page if empty.", "location": "query" }, "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The name of the SpecialistPool's parent resource. Format: `projects/{project}/locations/{location}`" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "readMask": { "location": "query", "description": "Mask specifying which fields to read. FieldMask represents a set of", "type": "string", "format": "google-fieldmask" } }, "httpMethod": "GET", "description": "Lists SpecialistPools in a Location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSpecialistPoolsResponse" }, "id": "aiplatform.projects.locations.specialistPools.list", "path": "v1beta1/{+parent}/specialistPools", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools" } }, "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.specialistPools.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "aiplatform.projects.locations.specialistPools.operations.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" } }, "list": { "id": "aiplatform.projects.locations.specialistPools.operations.list", "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.specialistPools.operations.wait", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+/operations/[^/]+$" }, "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "delete": { "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/specialistPools/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/specialistPools/{specialistPoolsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.specialistPools.operations.delete" } } } } }, "onlineEvaluators": { "methods": { "activate": { "id": "aiplatform.projects.locations.onlineEvaluators.activate", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ActivateOnlineEvaluatorRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}:activate", "path": "v1beta1/{+name}:activate", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$", "type": "string", "description": "Required. The name of the OnlineEvaluator to activate. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "location": "path", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Activates an OnlineEvaluator." }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListOnlineEvaluatorsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators", "parameters": { "parent": { "description": "Required. The parent resource of the OnlineEvaluators to list. Format: projects/{project}/locations/{location}.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return. Based on aip.dev/158.", "type": "string", "location": "query" }, "pageSize": { "description": "Optional. The maximum number of OnlineEvaluators to return. The service may return fewer than this value. If unspecified, at most 100 OnlineEvaluators will be returned. The maximum value is 100; values above 100 will be coerced to 100. Based on aip.dev/158.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "location": "query", "description": "Optional. Standard list filter. Supported fields: * `create_time` * `update_time` * `agent_resource` Example: `create_time\u003e\"2026-01-01T00:00:00-04:00\"` where the timestamp is in RFC 3339 format) Based on aip.dev/160.", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order by. The default sorting order is ascending. Use \"desc\" after a field name for descending. Supported fields: * `create_time` * `update_time` Example: `create_time desc`. Based on aip.dev/132." } }, "httpMethod": "GET", "path": "v1beta1/{+parent}/onlineEvaluators", "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.onlineEvaluators.list", "description": "Lists the OnlineEvaluators for the given project and location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators", "id": "aiplatform.projects.locations.onlineEvaluators.create", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The parent resource where the OnlineEvaluator will be created. Format: projects/{project}/locations/{location}.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates an OnlineEvaluator in the given project and location.", "path": "v1beta1/{+parent}/onlineEvaluators", "request": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluator" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ] }, "delete": { "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}", "parameters": { "name": { "description": "Required. The name of the OnlineEvaluator to delete. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Deletes an OnlineEvaluator.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.onlineEvaluators.delete" }, "get": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$", "description": "Required. The name of the OnlineEvaluator to retrieve. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "type": "string" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.onlineEvaluators.get", "description": "Gets details of an OnlineEvaluator.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluator" } }, "suspend": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}:suspend", "request": { "$ref": "GoogleCloudAiplatformV1beta1SuspendOnlineEvaluatorRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.onlineEvaluators.suspend", "path": "v1beta1/{+name}:suspend", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The name of the OnlineEvaluator to suspend. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Suspends an OnlineEvaluator. When an OnlineEvaluator is suspended, it won't run any evaluations until it is activated again.", "parameterOrder": [ "name" ] }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluator" }, "description": "Updates the fields of an OnlineEvaluator.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "id": "aiplatform.projects.locations.onlineEvaluators.patch", "parameters": { "updateMask": { "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.", "type": "string", "location": "query", "format": "google-fieldmask" }, "name": { "type": "string", "location": "path", "required": true, "description": "Identifier. The resource name of the OnlineEvaluator. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$" } }, "path": "v1beta1/{+name}" } }, "resources": { "operations": { "methods": { "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.projects.locations.onlineEvaluators.operations.cancel" }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "parameters": { "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.onlineEvaluators.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.onlineEvaluators.operations.wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}:wait" }, "delete": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.onlineEvaluators.operations.delete", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+/operations/[^/]+$" } } }, "get": { "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.onlineEvaluators.operations.get", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/onlineEvaluators/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}" } } } } }, "dataLabelingJobs": { "resources": { "operations": { "methods": { "delete": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.dataLabelingJobs.operations.delete", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+/operations/[^/]+$" } } }, "get": { "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.dataLabelingJobs.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+$" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.dataLabelingJobs.operations.list" }, "wait": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.dataLabelingJobs.operations.wait" }, "cancel": { "id": "aiplatform.projects.locations.dataLabelingJobs.operations.cancel", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } } } } }, "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a DataLabelingJob.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.dataLabelingJobs.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}", "parameters": { "name": { "type": "string", "description": "Required. The name of the DataLabelingJob to be deleted. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+$", "location": "path", "required": true } } }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs", "path": "v1beta1/{+parent}/dataLabelingJobs", "description": "Lists DataLabelingJobs in a Location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDataLabelingJobsResponse" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.dataLabelingJobs.list", "httpMethod": "GET", "parameters": { "orderBy": { "location": "query", "type": "string", "description": "A comma-separated list of fields to order by, sorted in ascending order by default. Use `desc` after a field name for descending." }, "parent": { "description": "Required. The parent of the DataLabelingJob. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "readMask": { "type": "string", "description": "Mask specifying which fields to read. FieldMask represents a set of symbolic field paths. For example, the mask can be `paths: \"name\"`. The \"name\" here is a field in DataLabelingJob. If this field is not set, all fields of the DataLabelingJob are returned.", "format": "google-fieldmask", "location": "query" } } }, "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The name of the DataLabelingJob. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.dataLabelingJobs.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}", "description": "Gets a DataLabelingJob.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1DataLabelingJob" } }, "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelDataLabelingJobRequest" }, "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the DataLabelingJob. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/dataLabelingJobs/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs/{dataLabelingJobsId}:cancel", "description": "Cancels a DataLabelingJob. Success of cancellation is not guaranteed.", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.dataLabelingJobs.cancel" }, "create": { "response": { "$ref": "GoogleCloudAiplatformV1beta1DataLabelingJob" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DataLabelingJob" }, "description": "Creates a DataLabelingJob.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dataLabelingJobs", "id": "aiplatform.projects.locations.dataLabelingJobs.create", "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "description": "Required. The parent of the DataLabelingJob. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "path": "v1beta1/{+parent}/dataLabelingJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" } } }, "extensions": { "methods": { "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "description": "Identifier. The resource name of the Extension.", "location": "path", "required": true }, "updateMask": { "description": "Required. Mask specifying which fields to update. Supported fields: * `display_name` * `description` * `runtime_config` * `tool_use_examples` * `manifest.description`", "type": "string", "location": "query", "format": "google-fieldmask" } }, "path": "v1beta1/{+name}", "description": "Updates an Extension.", "id": "aiplatform.projects.locations.extensions.patch", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Extension" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Extension" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "query": { "request": { "$ref": "GoogleCloudAiplatformV1beta1QueryExtensionRequest" }, "httpMethod": "POST", "description": "Queries an extension with a default controller.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "type": "string", "description": "Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:query", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryExtensionResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}:query", "id": "aiplatform.projects.locations.extensions.query" }, "import": { "parameters": { "parent": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to import the Extension in. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "description": "Imports an Extension.", "id": "aiplatform.projects.locations.extensions.import", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/extensions:import", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Extension" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions:import" }, "execute": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Executes the request against a given extension.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:execute", "response": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteExtensionResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteExtensionRequest" }, "id": "aiplatform.projects.locations.extensions.execute", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}:execute", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "type": "string", "description": "Required. Name (identifier) of the extension; Format: `projects/{project}/locations/{location}/extensions/{extension}`", "location": "path", "required": true } }, "httpMethod": "POST" }, "list": { "path": "v1beta1/{+parent}/extensions", "description": "Lists Extensions in a location.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location to list the Extensions from. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "orderBy": { "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`.", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "Optional. The standard list filter. Supported fields: * `display_name` * `create_time` * `update_time` More detail in [AIP-160](https://google.aip.dev/160)." }, "pageToken": { "type": "string", "description": "Optional. The standard list page token.", "location": "query" }, "pageSize": { "type": "integer", "description": "Optional. The standard list page size.", "location": "query", "format": "int32" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListExtensionsResponse" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "id": "aiplatform.projects.locations.extensions.list" }, "delete": { "description": "Deletes an Extension.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "description": "Required. The name of the Extension resource to be deleted. Format: `projects/{project}/locations/{location}/extensions/{extension}`", "type": "string" } }, "id": "aiplatform.projects.locations.extensions.delete" }, "get": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the Extension resource. Format: `projects/{project}/locations/{location}/extensions/{extension}`", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.extensions.get", "description": "Gets an Extension.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Extension" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}" } }, "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.projects.locations.extensions.operations.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+/operations/[^/]+$" } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+$", "type": "string", "description": "The name of the operation's parent resource." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" } }, "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}/operations", "id": "aiplatform.projects.locations.extensions.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ] }, "wait": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.projects.locations.extensions.operations.wait", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query", "format": "google-duration" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.extensions.operations.cancel", "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel" }, "get": { "id": "aiplatform.projects.locations.extensions.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/extensions/{extensionsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/extensions/[^/]+/operations/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "models": { "methods": { "upload": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1UploadModelRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "description": "Uploads a Model artifact into Vertex AI.", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location into which to upload the Model. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models:upload", "httpMethod": "POST", "id": "aiplatform.projects.locations.models.upload", "path": "v1beta1/{+parent}/models:upload" }, "mergeVersionAliases": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Model" }, "description": "Merges a set of aliases for a Model version.", "path": "v1beta1/{+name}:mergeVersionAliases", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:mergeVersionAliases", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the model version to merge aliases, with a version ID explicitly included. Example: `projects/{project}/locations/{location}/models/{model}@1234`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1MergeVersionAliasesRequest" }, "id": "aiplatform.projects.locations.models.mergeVersionAliases", "httpMethod": "POST", "parameterOrder": [ "name" ] }, "deleteVersion": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:deleteVersion", "path": "v1beta1/{+name}:deleteVersion", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "type": "string", "description": "Required. The name of the model version to be deleted, with a version ID explicitly included. Example: `projects/{project}/locations/{location}/models/{model}@1234`", "location": "path", "required": true } }, "description": "Deletes a Model version. Model version can only be deleted if there are no DeployedModels created from it. Deleting the only version in the Model is not allowed. Use DeleteModel for deleting the Model instead.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.models.deleteVersion" }, "testIamPermissions": { "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "id": "aiplatform.projects.locations.models.testIamPermissions", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "httpMethod": "POST", "parameters": { "permissions": { "location": "query", "repeated": true, "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "type": "string" }, "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "location": "path", "required": true } } }, "copy": { "id": "aiplatform.projects.locations.models.copy", "path": "v1beta1/{+parent}/models:copy", "parameters": { "parent": { "description": "Required. The resource name of the Location into which to copy the Model. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "description": "Copies an already existing Vertex AI Model into the specified Location. The source Model must exist in the same Project. When copying custom Models, the users themselves are responsible for Model.metadata content to be region-agnostic, as well as making sure that any resources (e.g. files) it depends on remain accessible.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models:copy", "request": { "$ref": "GoogleCloudAiplatformV1beta1CopyModelRequest" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "updateExplanationDataset": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Incrementally update the dataset used for an examples model.", "path": "v1beta1/{+model}:updateExplanationDataset", "request": { "$ref": "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetRequest" }, "parameters": { "model": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "description": "Required. The resource name of the Model to update. Format: `projects/{project}/locations/{location}/models/{model}`" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:updateExplanationDataset", "parameterOrder": [ "model" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.models.updateExplanationDataset" }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}", "id": "aiplatform.projects.locations.models.patch", "response": { "$ref": "GoogleCloudAiplatformV1beta1Model" }, "path": "v1beta1/{+name}", "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1Model" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Identifier. The resource name of the Model." }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask." } }, "description": "Updates a Model.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "setIamPolicy": { "parameterOrder": [ "resource" ], "response": { "$ref": "GoogleIamV1Policy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:setIamPolicy", "id": "aiplatform.projects.locations.models.setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "parameters": { "resource": { "type": "string", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$" } }, "httpMethod": "POST", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "path": "v1beta1/{+resource}:setIamPolicy" }, "listVersions": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token. Typically obtained via next_page_token of the previous ListModelVersions call." }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `create_time` * `update_time` Example: `update_time asc, create_time desc`.", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "type": "string", "description": "Required. The name of the model to list versions for." }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "readMask": { "description": "Mask specifying which fields to read.", "location": "query", "type": "string", "format": "google-fieldmask" }, "filter": { "location": "query", "type": "string", "description": "An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels.\"a key\"`. Some examples: * `labels.myKey=\"myValue\"`" } }, "description": "Lists versions of the specified model.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelVersionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:listVersions", "id": "aiplatform.projects.locations.models.listVersions", "path": "v1beta1/{+name}:listVersions" }, "listCheckpoints": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelVersionCheckpointsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:listCheckpoints", "parameters": { "pageToken": { "description": "Optional. The standard list page token. Typically obtained via next_page_token of the previous ListModelVersionCheckpoints call.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "description": "Optional. The standard list page size.", "format": "int32", "type": "integer" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "description": "Required. The name of the model version to list checkpoints for. `projects/{project}/locations/{location}/models/{model}@{version}` Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` If no version ID or alias is specified, the latest version will be used.", "location": "path", "required": true } }, "httpMethod": "GET", "description": "Lists checkpoints of the specified model version.", "id": "aiplatform.projects.locations.models.listCheckpoints", "path": "v1beta1/{+name}:listCheckpoints" }, "export": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Exports a trained, exportable Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExportModelRequest" }, "path": "v1beta1/{+name}:export", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:export", "parameters": { "name": { "description": "Required. The resource name of the Model to export. The resource name may contain version id or version alias to specify the version, if no version is specified, the default version will be exported.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "type": "string" } }, "id": "aiplatform.projects.locations.models.export", "httpMethod": "POST", "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/models", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelsResponse" }, "id": "aiplatform.projects.locations.models.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models", "description": "Lists Models in a Location.", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The resource name of the Location to list the Models from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "The standard list page size.", "location": "query" }, "readMask": { "type": "string", "format": "google-fieldmask", "description": "Mask specifying which fields to read.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token. Typically obtained via ListModelsResponse.next_page_token of the previous ModelService.ListModels call.", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `model` supports = and !=. `model` represents the Model ID, i.e. the last segment of the Model's resource name. * `display_name` supports = and != * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels.\"a key\"`. * `base_model_name` only supports = Some examples: * `model=1234` * `displayName=\"myDisplayName\"` * `labels.myKey=\"myValue\"` * `baseModelName=\"text-bison\"`" } }, "httpMethod": "GET" }, "getIamPolicy": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "path": "v1beta1/{+resource}:getIamPolicy", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}:getIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "type": "string", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." }, "options.requestedPolicyVersion": { "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "format": "int32" } }, "response": { "$ref": "GoogleIamV1Policy" }, "parameterOrder": [ "resource" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.models.getIamPolicy" }, "delete": { "description": "Deletes a Model. A model cannot be deleted if any Endpoint resource has a DeployedModel based on the model in its deployed_models field.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}", "parameters": { "name": { "type": "string", "description": "Required. The name of the Model resource to be deleted. Format: `projects/{project}/locations/{location}/models/{model}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.models.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Model" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}", "id": "aiplatform.projects.locations.models.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the Model resource. Format: `projects/{project}/locations/{location}/models/{model}` In order to retrieve a specific version of the model, also provide the version ID or version alias. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` If no version ID or alias is specified, the \"default\" version will be returned. The \"default\" version alias is created for the first version of the model, and can be moved to other versions later on. There will be exactly one default version.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "description": "Gets a Model." } }, "resources": { "evaluations": { "methods": { "import": { "description": "Imports an externally generated ModelEvaluation.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "description": "Required. The name of the parent model resource. Format: `projects/{project}/locations/{location}/models/{model}`", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.models.evaluations.import", "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportModelEvaluationRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluation" }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/evaluations:import", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations:import" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}", "id": "aiplatform.projects.locations.models.evaluations.get", "description": "Gets a ModelEvaluation.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of the ModelEvaluation resource. Format: `projects/{project}/locations/{location}/models/{model}/evaluations/{evaluation}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+$" } }, "path": "v1beta1/{+name}" }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelEvaluationsResponse" }, "id": "aiplatform.projects.locations.models.evaluations.list", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "description": "The standard list page size.", "format": "int32", "location": "query" }, "readMask": { "type": "string", "location": "query", "description": "Mask specifying which fields to read.", "format": "google-fieldmask" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "parent": { "description": "Required. The resource name of the Model to list the ModelEvaluations from. Format: `projects/{project}/locations/{location}/models/{model}`", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token. Typically obtained via ListModelEvaluationsResponse.next_page_token of the previous ModelService.ListModelEvaluations call." } }, "path": "v1beta1/{+parent}/evaluations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Lists ModelEvaluations in a Model.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations" } }, "resources": { "slices": { "methods": { "list": { "path": "v1beta1/{+parent}/slices", "description": "Lists ModelEvaluationSlices in a ModelEvaluation.", "httpMethod": "GET", "id": "aiplatform.projects.locations.models.evaluations.slices.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/slices", "parameters": { "pageToken": { "location": "query", "description": "The standard list page token. Typically obtained via ListModelEvaluationSlicesResponse.next_page_token of the previous ModelService.ListModelEvaluationSlices call.", "type": "string" }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the ModelEvaluation to list the ModelEvaluationSlices from. Format: `projects/{project}/locations/{location}/models/{model}/evaluations/{evaluation}`", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+$" }, "filter": { "description": "The standard list filter. * `slice.dimension` - for =.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "readMask": { "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListModelEvaluationSlicesResponse" } }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSlice" }, "id": "aiplatform.projects.locations.models.evaluations.slices.get", "parameterOrder": [ "name" ], "description": "Gets a ModelEvaluationSlice.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/slices/{slicesId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "Required. The name of the ModelEvaluationSlice resource. Format: `projects/{project}/locations/{location}/models/{model}/evaluations/{evaluation}/slices/{slice}`", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/slices/[^/]+$", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "httpMethod": "GET" }, "batchImport": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/slices/{slicesId}:batchImport", "path": "v1beta1/{+parent}:batchImport", "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsRequest" }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "description": "Imports a list of externally generated EvaluatedAnnotations.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/slices/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the parent ModelEvaluationSlice resource. Format: `projects/{project}/locations/{location}/models/{model}/evaluations/{evaluation}/slices/{slice}`", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.models.evaluations.slices.batchImport" } } }, "operations": { "methods": { "cancel": { "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.models.evaluations.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.models.evaluations.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}", "httpMethod": "GET" }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "id": "aiplatform.projects.locations.models.evaluations.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/operations" }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.models.evaluations.operations.wait", "parameterOrder": [ "name" ] }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.models.evaluations.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } } } } } } }, "operations": { "methods": { "delete": { "id": "aiplatform.projects.locations.models.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/operations/{operationsId}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.models.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/operations" }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.models.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.models.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/operations/{operationsId}" }, "cancel": { "id": "aiplatform.projects.locations.models.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/models/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/models/{modelsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" } } } } } }, "notebookExecutionJobs": { "methods": { "get": { "description": "Gets a NotebookExecutionJob.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJob" }, "id": "aiplatform.projects.locations.notebookExecutionJobs.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the NotebookExecutionJob resource.", "type": "string" }, "view": { "description": "Optional. The NotebookExecutionJob view. Defaults to BASIC.", "enumDescriptions": [ "When unspecified, the API defaults to the BASIC view.", "Includes all fields except for direct notebook inputs.", "Includes all fields." ], "enum": [ "NOTEBOOK_EXECUTION_JOB_VIEW_UNSPECIFIED", "NOTEBOOK_EXECUTION_JOB_VIEW_BASIC", "NOTEBOOK_EXECUTION_JOB_VIEW_FULL" ], "location": "query", "type": "string" } } }, "create": { "description": "Creates a NotebookExecutionJob.", "parameters": { "notebookExecutionJobId": { "location": "query", "type": "string", "description": "Optional. User specified ID for the NotebookExecutionJob." }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the NotebookExecutionJob. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.notebookExecutionJobs.create", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJob" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs", "path": "v1beta1/{+parent}/notebookExecutionJobs" }, "reportEvent": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}:reportEvent", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.notebookExecutionJobs.reportEvent", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+$", "description": "Required. The name of the NotebookExecutionJob resource. Format: `projects/{project}/locations/{location}/notebookExecutionJobs/{notebook_execution_jobs}`", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ReportExecutionEventResponse" }, "path": "v1beta1/{+name}:reportEvent", "description": "", "request": { "$ref": "GoogleCloudAiplatformV1beta1ReportExecutionEventRequest" } }, "generateAccessToken": { "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateAccessTokenResponse" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateAccessTokenRequest" }, "path": "v1beta1/{+name}:generateAccessToken", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}:generateAccessToken", "id": "aiplatform.projects.locations.notebookExecutionJobs.generateAccessToken", "description": "Internal only: Called from Compute Engine instance to obtain EUC for owner Anonymous access: authenticates caller using VM identity JWT. Design doc: go/colab-on-vertex-euc-dd", "parameters": { "name": { "description": "Required. The name of the resource requesting the OAuth2 token. Format: `projects/{project}/locations/{location}/notebookRuntimes/{notebook_runtime}` `projects/{project}/locations/{location}/notebookExecutionJobs/{notebook_execution_job}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+$" } }, "httpMethod": "POST" }, "delete": { "id": "aiplatform.projects.locations.notebookExecutionJobs.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+$", "description": "Required. The name of the NotebookExecutionJob resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+name}", "description": "Deletes a NotebookExecutionJob." }, "list": { "path": "v1beta1/{+parent}/notebookExecutionJobs", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListNotebookExecutionJobsResponse" }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token. Typically obtained via ListNotebookExecutionJobsResponse.next_page_token of the previous NotebookService.ListNotebookExecutionJobs call." }, "filter": { "location": "query", "type": "string", "description": "Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `notebookExecutionJob` supports = and !=. `notebookExecutionJob` represents the NotebookExecutionJob ID. * `displayName` supports = and != and regex. * `schedule` supports = and != and regex. Some examples: * `notebookExecutionJob=\"123\"` * `notebookExecutionJob=\"my-execution-job\"` * `displayName=\"myDisplayName\"` and `displayName=~\"myDisplayNameRegex\"`" }, "view": { "location": "query", "enum": [ "NOTEBOOK_EXECUTION_JOB_VIEW_UNSPECIFIED", "NOTEBOOK_EXECUTION_JOB_VIEW_BASIC", "NOTEBOOK_EXECUTION_JOB_VIEW_FULL" ], "type": "string", "enumDescriptions": [ "When unspecified, the API defaults to the BASIC view.", "Includes all fields except for direct notebook inputs.", "Includes all fields." ], "description": "Optional. The NotebookExecutionJob view. Defaults to BASIC." }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. The standard list page size." }, "parent": { "description": "Required. The resource name of the Location from which to list the NotebookExecutionJobs. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists NotebookExecutionJobs in a Location.", "id": "aiplatform.projects.locations.notebookExecutionJobs.list" } }, "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.notebookExecutionJobs.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}:cancel" }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.notebookExecutionJobs.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "parameterOrder": [ "name" ] }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.notebookExecutionJobs.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "list": { "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" }, "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+$" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" } }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.notebookExecutionJobs.operations.list", "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.notebookExecutionJobs.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookExecutionJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ] } } } } }, "metadataStores": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The resource name of the MetadataStore to retrieve. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.metadataStores.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1MetadataStore" }, "description": "Retrieves a specific MetadataStore.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}", "parameterOrder": [ "name" ] }, "delete": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the MetadataStore to delete. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`" }, "force": { "deprecated": true, "type": "boolean", "description": "Deprecated: Field is no longer supported.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes a single MetadataStore and all its child resources (Artifacts, Executions, and Contexts).", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.metadataStores.delete" }, "create": { "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location where the MetadataStore should be created. Format: `projects/{project}/locations/{location}/`", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "metadataStoreId": { "location": "query", "type": "string", "description": "The {metadatastore} portion of the resource name with the format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}` If not provided, the MetadataStore's ID will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are `/a-z-/`. Must be unique across all MetadataStores in the parent Location. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting MetadataStore.)" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.metadataStores.create", "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1MetadataStore" }, "parameterOrder": [ "parent" ], "description": "Initializes a MetadataStore, including allocation of resources.", "path": "v1beta1/{+parent}/metadataStores", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores" }, "list": { "id": "aiplatform.projects.locations.metadataStores.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores", "httpMethod": "GET", "path": "v1beta1/{+parent}/metadataStores", "parameterOrder": [ "parent" ], "parameters": { "parent": { "description": "Required. The Location whose MetadataStores should be listed. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true }, "pageSize": { "description": "The maximum number of Metadata Stores to return. The service may return fewer. Must be in range 1-100, inclusive. Defaults to 100.", "location": "query", "format": "int32", "type": "integer" }, "pageToken": { "description": "A page token, received from a previous MetadataService.ListMetadataStores call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters must match the call that provided the page token. (Otherwise the request will fail with INVALID_ARGUMENT error.)", "type": "string", "location": "query" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMetadataStoresResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists MetadataStores for a Location." } }, "resources": { "executions": { "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "id": "aiplatform.projects.locations.metadataStores.executions.create", "path": "v1beta1/{+parent}/executions", "response": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "description": "Creates an Execution associated with a MetadataStore.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions", "parameters": { "executionId": { "description": "The {execution} portion of the resource name with the format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}` If not provided, the Execution's ID will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are `/a-z-/`. Must be unique across all Executions in the parent MetadataStore. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting Execution.)", "type": "string", "location": "query" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "description": "Required. The resource name of the MetadataStore where the Execution should be created. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ] }, "queryExecutionInputsAndOutputs": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "execution" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1LineageSubgraph" }, "path": "v1beta1/{+execution}:queryExecutionInputsAndOutputs", "id": "aiplatform.projects.locations.metadataStores.executions.queryExecutionInputsAndOutputs", "description": "Obtains the set of input and output Artifacts for this Execution, in the form of LineageSubgraph that also contains the Execution and connecting Events.", "parameters": { "execution": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$", "description": "Required. The resource name of the Execution whose input and output Artifacts should be retrieved as a LineageSubgraph. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}:queryExecutionInputsAndOutputs", "httpMethod": "GET" }, "purge": { "description": "Purges Executions.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.metadataStores.executions.purge", "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeExecutionsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions:purge", "parameterOrder": [ "parent" ], "parameters": { "parent": { "description": "Required. The metadata store to purge Executions from. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/executions:purge" }, "addExecutionEvents": { "parameterOrder": [ "execution" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}:addExecutionEvents", "response": { "$ref": "GoogleCloudAiplatformV1beta1AddExecutionEventsResponse" }, "path": "v1beta1/{+execution}:addExecutionEvents", "request": { "$ref": "GoogleCloudAiplatformV1beta1AddExecutionEventsRequest" }, "id": "aiplatform.projects.locations.metadataStores.executions.addExecutionEvents", "httpMethod": "POST", "parameters": { "execution": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$", "type": "string", "description": "Required. The resource name of the Execution that the Events connect Artifacts with. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Adds Events to the specified Execution. An Event indicates whether an Artifact was used as an input or output for an Execution. If an Event already exists between the Execution and the Artifact, the Event is skipped." }, "list": { "path": "v1beta1/{+parent}/executions", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListExecutionsResponse" }, "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous MetadataService.ListExecutions call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters must match the call that provided the page token. (Otherwise the request will fail with an INVALID_ARGUMENT error.)" }, "filter": { "location": "query", "description": "Filter specifying the boolean condition for the Executions to satisfy in order to be part of the result set. The syntax to define filter query is based on https://google.aip.dev/160. Following are the supported set of filters: * **Attribute filtering**: For example: `display_name = \"test\"`. Supported fields include: `name`, `display_name`, `state`, `schema_title`, `create_time`, and `update_time`. Time fields, such as `create_time` and `update_time`, require values specified in RFC-3339 format. For example: `create_time = \"2020-11-19T11:30:00-04:00\"`. * **Metadata field**: To filter on metadata fields use traversal operation as follows: `metadata..` For example: `metadata.field_1.number_value = 10.0` In case the field name contains special characters (such as colon), one can embed it inside double quote. For example: `metadata.\"field:1\".number_value = 10.0` * **Context based filtering**: To filter Executions based on the contexts to which they belong use the function operator with the full resource name: `in_context()`. For example: `in_context(\"projects//locations//metadataStores//contexts/\")` Each of the above supported filters can be combined together using logical operators (`AND` & `OR`). Maximum nested expression depth allowed is 5. For example: `display_name = \"test\" AND metadata.field1.bool_value = true`.", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "How the list of messages is ordered. Specify the values to order by and an ordering operation. The default sorting order is ascending. To specify descending order for a field, users append a \" desc\" suffix; for example: \"foo desc, bar\". Subfields are specified with a `.` character, such as foo.bar. see https://google.aip.dev/132#ordering for more details." }, "pageSize": { "description": "The maximum number of Executions to return. The service may return fewer. Must be in range 1-100, inclusive. Defaults to 100.", "format": "int32", "location": "query", "type": "integer" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "location": "path", "required": true, "description": "Required. The MetadataStore whose Executions should be listed. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "type": "string" } }, "id": "aiplatform.projects.locations.metadataStores.executions.list", "description": "Lists Executions in the MetadataStore.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "parameters": { "allowMissing": { "description": "If set to true, and the Execution is not found, a new Execution is created.", "location": "query", "type": "boolean" }, "name": { "description": "Output only. The resource name of the Execution.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$" }, "updateMask": { "location": "query", "type": "string", "description": "Optional. A FieldMask indicating which fields should be updated.", "format": "google-fieldmask" } }, "description": "Updates a stored Execution.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}", "id": "aiplatform.projects.locations.metadataStores.executions.patch", "response": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Execution" } }, "get": { "parameterOrder": [ "name" ], "description": "Retrieves a specific Execution.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "parameters": { "name": { "description": "Required. The resource name of the Execution to retrieve. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.metadataStores.executions.get", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "id": "aiplatform.projects.locations.metadataStores.executions.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}", "description": "Deletes an Execution.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the Execution to delete. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$" }, "etag": { "type": "string", "location": "query", "description": "Optional. The etag of the Execution to delete. If this is provided, it must match the server's etag. Otherwise, the request will fail with a FAILED_PRECONDITION." } }, "httpMethod": "DELETE" } }, "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.metadataStores.executions.operations.delete", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}/operations", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.metadataStores.executions.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.projects.locations.metadataStores.executions.operations.wait", "parameters": { "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}:cancel", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.projects.locations.metadataStores.executions.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ] }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.metadataStores.executions.operations.get", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "metadataSchemas": { "methods": { "list": { "path": "v1beta1/{+parent}/metadataSchemas", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "description": "Lists MetadataSchemas.", "id": "aiplatform.projects.locations.metadataStores.metadataSchemas.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMetadataSchemasResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/metadataSchemas", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The maximum number of MetadataSchemas to return. The service may return fewer. Must be in range 1-100, inclusive. Defaults to 100." }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "description": "Required. The MetadataStore whose MetadataSchemas should be listed. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "type": "string", "location": "path", "required": true }, "filter": { "type": "string", "location": "query", "description": "A query to filter available MetadataSchemas for matching results." }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous MetadataService.ListMetadataSchemas call. Provide this to retrieve the next page. When paginating, all other provided parameters must match the call that provided the page token. (Otherwise the request will fail with INVALID_ARGUMENT error.)" } } }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1MetadataSchema" }, "parameters": { "metadataSchemaId": { "description": "The {metadata_schema} portion of the resource name with the format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/metadataSchemas/{metadataschema}` If not provided, the MetadataStore's ID will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are `/a-z-/`. Must be unique across all MetadataSchemas in the parent Location. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting MetadataSchema.)", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "description": "Required. The resource name of the MetadataStore where the MetadataSchema should be created. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+parent}/metadataSchemas", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1MetadataSchema" }, "id": "aiplatform.projects.locations.metadataStores.metadataSchemas.create", "description": "Creates a MetadataSchema.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/metadataSchemas" }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1MetadataSchema" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.metadataStores.metadataSchemas.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/metadataSchemas/{metadataSchemasId}", "path": "v1beta1/{+name}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the MetadataSchema to retrieve. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/metadataSchemas/{metadataschema}`", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/metadataSchemas/[^/]+$" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves a specific MetadataSchema." } } }, "contexts": { "resources": { "operations": { "methods": { "list": { "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.metadataStores.contexts.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.metadataStores.contexts.operations.wait", "parameterOrder": [ "name" ] }, "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.metadataStores.contexts.operations.cancel", "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } } }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.metadataStores.contexts.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.projects.locations.metadataStores.contexts.operations.get", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } }, "methods": { "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "description": "Creates a Context associated with a MetadataStore.", "id": "aiplatform.projects.locations.metadataStores.contexts.create", "response": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/contexts", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts", "parameters": { "contextId": { "description": "The {context} portion of the resource name with the format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`. If not provided, the Context's ID will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are `/a-z-/`. Must be unique across all Contexts in the parent MetadataStore. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting Context.)", "type": "string", "location": "query" }, "parent": { "type": "string", "description": "Required. The resource name of the MetadataStore where the Context should be created. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$" } } }, "patch": { "description": "Updates a stored Context.", "response": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "id": "aiplatform.projects.locations.metadataStores.contexts.patch", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Immutable. The resource name of the Context." }, "allowMissing": { "type": "boolean", "location": "query", "description": "If set to true, and the Context is not found, a new Context is created." }, "updateMask": { "description": "Optional. A FieldMask indicating which fields should be updated.", "type": "string", "format": "google-fieldmask", "location": "query" } }, "httpMethod": "PATCH", "path": "v1beta1/{+name}", "request": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListContextsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/contexts", "id": "aiplatform.projects.locations.metadataStores.contexts.list", "description": "Lists Contexts on the MetadataStore.", "parameters": { "filter": { "location": "query", "type": "string", "description": "Filter specifying the boolean condition for the Contexts to satisfy in order to be part of the result set. The syntax to define filter query is based on https://google.aip.dev/160. Following are the supported set of filters: * **Attribute filtering**: For example: `display_name = \"test\"`. Supported fields include: `name`, `display_name`, `schema_title`, `create_time`, and `update_time`. Time fields, such as `create_time` and `update_time`, require values specified in RFC-3339 format. For example: `create_time = \"2020-11-19T11:30:00-04:00\"`. * **Metadata field**: To filter on metadata fields use traversal operation as follows: `metadata..`. For example: `metadata.field_1.number_value = 10.0`. In case the field name contains special characters (such as colon), one can embed it inside double quote. For example: `metadata.\"field:1\".number_value = 10.0` * **Parent Child filtering**: To filter Contexts based on parent-child relationship use the HAS operator as follows: ``` parent_contexts: \"projects//locations//metadataStores//contexts/\" child_contexts: \"projects//locations//metadataStores//contexts/\" ``` Each of the above supported filters can be combined together using logical operators (`AND` & `OR`). Maximum nested expression depth allowed is 5. For example: `display_name = \"test\" AND metadata.field1.bool_value = true`." }, "pageToken": { "location": "query", "description": "A page token, received from a previous MetadataService.ListContexts call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters must match the call that provided the page token. (Otherwise the request will fail with INVALID_ARGUMENT error.)", "type": "string" }, "parent": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "description": "Required. The MetadataStore whose Contexts should be listed. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of Contexts to return. The service may return fewer. Must be in range 1-100, inclusive. Defaults to 100." }, "orderBy": { "description": "How the list of messages is ordered. Specify the values to order by and an ordering operation. The default sorting order is ascending. To specify descending order for a field, users append a \" desc\" suffix; for example: \"foo desc, bar\". Subfields are specified with a `.` character, such as foo.bar. see https://google.aip.dev/132#ordering for more details.", "type": "string", "location": "query" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "removeContextChildren": { "description": "Remove a set of children contexts from a parent Context. If any of the child Contexts were NOT added to the parent Context, they are simply skipped.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}:removeContextChildren", "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1RemoveContextChildrenResponse" }, "parameters": { "context": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "description": "Required. The resource name of the parent Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`", "location": "path", "required": true } }, "parameterOrder": [ "context" ], "id": "aiplatform.projects.locations.metadataStores.contexts.removeContextChildren", "path": "v1beta1/{+context}:removeContextChildren", "request": { "$ref": "GoogleCloudAiplatformV1beta1RemoveContextChildrenRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "addContextArtifactsAndExecutions": { "id": "aiplatform.projects.locations.metadataStores.contexts.addContextArtifactsAndExecutions", "parameterOrder": [ "context" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsResponse" }, "parameters": { "context": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "type": "string", "description": "Required. The resource name of the Context that the Artifacts and Executions belong to. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`" } }, "httpMethod": "POST", "path": "v1beta1/{+context}:addContextArtifactsAndExecutions", "description": "Adds a set of Artifacts and Executions to a Context. If any of the Artifacts or Executions have already been added to a Context, they are simply skipped.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}:addContextArtifactsAndExecutions" }, "purge": { "httpMethod": "POST", "description": "Purges Contexts.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "type": "string", "description": "Required. The metadata store to purge Contexts from. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts:purge", "id": "aiplatform.projects.locations.metadataStores.contexts.purge", "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeContextsRequest" }, "path": "v1beta1/{+parent}/contexts:purge", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.metadataStores.contexts.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}", "description": "Deletes a stored Context.", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameters": { "force": { "type": "boolean", "description": "The force deletion semantics is still undefined. Users should not use this field.", "location": "query" }, "name": { "location": "path", "required": true, "description": "Required. The resource name of the Context to delete. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$" }, "etag": { "location": "query", "description": "Optional. The etag of the Context to delete. If this is provided, it must match the server's etag. Otherwise, the request will fail with a FAILED_PRECONDITION.", "type": "string" } } }, "get": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "parameters": { "name": { "description": "Required. The resource name of the Context to retrieve. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "description": "Retrieves a specific Context.", "id": "aiplatform.projects.locations.metadataStores.contexts.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}" }, "addContextChildren": { "id": "aiplatform.projects.locations.metadataStores.contexts.addContextChildren", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}:addContextChildren", "response": { "$ref": "GoogleCloudAiplatformV1beta1AddContextChildrenResponse" }, "description": "Adds a set of Contexts as children to a parent Context. If any of the child Contexts have already been added to the parent Context, they are simply skipped. If this call would create a cycle or cause any Context to have more than 10 parents, the request will fail with an INVALID_ARGUMENT error.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AddContextChildrenRequest" }, "httpMethod": "POST", "parameters": { "context": { "location": "path", "required": true, "description": "Required. The resource name of the parent Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$" } }, "parameterOrder": [ "context" ], "path": "v1beta1/{+context}:addContextChildren" }, "queryContextLineageSubgraph": { "parameterOrder": [ "context" ], "parameters": { "context": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/contexts/[^/]+$", "type": "string", "description": "Required. The resource name of the Context whose Artifacts and Executions should be retrieved as a LineageSubgraph. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/contexts/{context}` The request may error with FAILED_PRECONDITION if the number of Artifacts, the number of Executions, or the number of Events that would be returned for the Context exceeds 1000.", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.metadataStores.contexts.queryContextLineageSubgraph", "description": "Retrieves Artifacts and Executions within the specified Context, connected by Event edges and returned as a LineageSubgraph.", "response": { "$ref": "GoogleCloudAiplatformV1beta1LineageSubgraph" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/contexts/{contextsId}:queryContextLineageSubgraph", "path": "v1beta1/{+context}:queryContextLineageSubgraph" } } }, "operations": { "methods": { "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/operations/{operationsId}", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.metadataStores.operations.delete", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE" }, "list": { "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" } }, "id": "aiplatform.projects.locations.metadataStores.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "id": "aiplatform.projects.locations.metadataStores.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "timeout": { "type": "string", "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/operations/{operationsId}", "id": "aiplatform.projects.locations.metadataStores.operations.get" }, "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/operations/{operationsId}:cancel", "httpMethod": "POST", "id": "aiplatform.projects.locations.metadataStores.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" } } } }, "artifacts": { "methods": { "purge": { "description": "Purges Artifacts.", "id": "aiplatform.projects.locations.metadataStores.artifacts.purge", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts:purge", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The metadata store to purge Artifacts from. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "type": "string" } }, "path": "v1beta1/{+parent}/artifacts:purge", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeArtifactsRequest" } }, "queryArtifactLineageSubgraph": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}:queryArtifactLineageSubgraph", "parameterOrder": [ "artifact" ], "id": "aiplatform.projects.locations.metadataStores.artifacts.queryArtifactLineageSubgraph", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1LineageSubgraph" }, "parameters": { "maxHops": { "format": "int32", "location": "query", "type": "integer", "description": "Specifies the size of the lineage graph in terms of number of hops from the specified artifact. Negative Value: INVALID_ARGUMENT error is returned 0: Only input artifact is returned. No value: Transitive closure is performed to return the complete graph." }, "artifact": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Artifact whose Lineage needs to be retrieved as a LineageSubgraph. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}` The request may error with FAILED_PRECONDITION if the number of Artifacts, the number of Executions, or the number of Events that would be returned for the Context exceeds 1000." }, "filter": { "type": "string", "description": "Filter specifying the boolean condition for the Artifacts to satisfy in order to be part of the Lineage Subgraph. The syntax to define filter query is based on https://google.aip.dev/160. The supported set of filters include the following: * **Attribute filtering**: For example: `display_name = \"test\"` Supported fields include: `name`, `display_name`, `uri`, `state`, `schema_title`, `create_time`, and `update_time`. Time fields, such as `create_time` and `update_time`, require values specified in RFC-3339 format. For example: `create_time = \"2020-11-19T11:30:00-04:00\"` * **Metadata field**: To filter on metadata fields use traversal operation as follows: `metadata..`. For example: `metadata.field_1.number_value = 10.0` In case the field name contains special characters (such as colon), one can embed it inside double quote. For example: `metadata.\"field:1\".number_value = 10.0` Each of the above supported filter types can be combined together using logical operators (`AND` & `OR`). Maximum nested expression depth allowed is 5. For example: `display_name = \"test\" AND metadata.field1.bool_value = true`.", "location": "query" } }, "path": "v1beta1/{+artifact}:queryArtifactLineageSubgraph", "description": "Retrieves lineage of an Artifact represented through Artifacts and Executions connected by Event edges and returned as a LineageSubgraph.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts", "description": "Creates an Artifact associated with a MetadataStore.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/artifacts", "parameters": { "artifactId": { "type": "string", "description": "The {artifact} portion of the resource name with the format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}` If not provided, the Artifact's ID will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are `/a-z-/`. Must be unique across all Artifacts in the parent MetadataStore. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting Artifact.)", "location": "query" }, "parent": { "description": "Required. The resource name of the MetadataStore where the Artifact should be created. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$", "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.metadataStores.artifacts.create" }, "get": { "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The resource name of the Artifact to retrieve. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+$" } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "description": "Retrieves a specific Artifact.", "id": "aiplatform.projects.locations.metadataStores.artifacts.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}" }, "patch": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}", "parameters": { "allowMissing": { "type": "boolean", "location": "query", "description": "If set to true, and the Artifact is not found, a new Artifact is created." }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Optional. A FieldMask indicating which fields should be updated." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Output only. The resource name of the Artifact." } }, "httpMethod": "PATCH", "path": "v1beta1/{+name}", "description": "Updates a stored Artifact.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "id": "aiplatform.projects.locations.metadataStores.artifacts.patch" }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the Artifact to delete. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+$", "type": "string" }, "etag": { "description": "Optional. The etag of the Artifact to delete. If this is provided, it must match the server's etag. Otherwise, the request will fail with a FAILED_PRECONDITION.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes an Artifact.", "id": "aiplatform.projects.locations.metadataStores.artifacts.delete" }, "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListArtifactsResponse" }, "description": "Lists Artifacts in the MetadataStore.", "path": "v1beta1/{+parent}/artifacts", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts", "parameterOrder": [ "parent" ], "parameters": { "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The maximum number of Artifacts to return. The service may return fewer. Must be in range 1-100, inclusive. Defaults to 100." }, "filter": { "description": "Filter specifying the boolean condition for the Artifacts to satisfy in order to be part of the result set. The syntax to define filter query is based on https://google.aip.dev/160. The supported set of filters include the following: * **Attribute filtering**: For example: `display_name = \"test\"`. Supported fields include: `name`, `display_name`, `uri`, `state`, `schema_title`, `create_time`, and `update_time`. Time fields, such as `create_time` and `update_time`, require values specified in RFC-3339 format. For example: `create_time = \"2020-11-19T11:30:00-04:00\"` * **Metadata field**: To filter on metadata fields use traversal operation as follows: `metadata..`. For example: `metadata.field_1.number_value = 10.0` In case the field name contains special characters (such as colon), one can embed it inside double quote. For example: `metadata.\"field:1\".number_value = 10.0` * **Context based filtering**: To filter Artifacts based on the contexts to which they belong, use the function operator with the full resource name `in_context()`. For example: `in_context(\"projects//locations//metadataStores//contexts/\")` Each of the above supported filter types can be combined together using logical operators (`AND` & `OR`). Maximum nested expression depth allowed is 5. For example: `display_name = \"test\" AND metadata.field1.bool_value = true`.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous MetadataService.ListArtifacts call. Provide this to retrieve the subsequent page. When paginating, all other provided parameters must match the call that provided the page token. (Otherwise the request will fail with INVALID_ARGUMENT error.)" }, "parent": { "type": "string", "description": "Required. The MetadataStore whose Artifacts should be listed. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+$" }, "orderBy": { "type": "string", "description": "How the list of messages is ordered. Specify the values to order by and an ordering operation. The default sorting order is ascending. To specify descending order for a field, users append a \" desc\" suffix; for example: \"foo desc, bar\". Subfields are specified with a `.` character, such as foo.bar. see https://google.aip.dev/132#ordering for more details.", "location": "query" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.metadataStores.artifacts.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "operations": { "methods": { "list": { "id": "aiplatform.projects.locations.metadataStores.artifacts.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+$", "type": "string", "description": "The name of the operation's parent resource." }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The standard list page size." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.metadataStores.artifacts.operations.wait" }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.metadataStores.artifacts.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" } }, "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.projects.locations.metadataStores.artifacts.operations.cancel" }, "get": { "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.metadataStores.artifacts.operations.get", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" } } } } } } } }, "notebookRuntimeTemplates": { "methods": { "create": { "id": "aiplatform.projects.locations.notebookRuntimeTemplates.create", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Creates a NotebookRuntimeTemplate.", "path": "v1beta1/{+parent}/notebookRuntimeTemplates", "request": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to create the NotebookRuntimeTemplate. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "notebookRuntimeTemplateId": { "type": "string", "description": "Optional. User specified ID for the notebook runtime template.", "location": "query" } }, "httpMethod": "POST" }, "testIamPermissions": { "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "path": "v1beta1/{+resource}:testIamPermissions", "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.testIamPermissions", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}:testIamPermissions", "parameterOrder": [ "resource" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$", "type": "string" }, "permissions": { "repeated": true, "type": "string", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "location": "query" } }, "httpMethod": "POST" }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}", "description": "Updates a NotebookRuntimeTemplate.", "response": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate" }, "id": "aiplatform.projects.locations.notebookRuntimeTemplates.patch", "path": "v1beta1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$", "description": "The resource name of the NotebookRuntimeTemplate." }, "updateMask": { "type": "string", "location": "query", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Input format: `{paths: \"${updated_field}\"}` Updatable fields: * `encryption_spec.kms_key_name` * `display_name` * `software_config.post_startup_script_config.post_startup_script` * `software_config.post_startup_script_config.post_startup_script_url` * `software_config.post_startup_script_config.post_startup_script_behavior` * `software_config.env` * `software_config.colab_image.release_name` * `software_config.custom_container_config.image_uri`", "format": "google-fieldmask" } } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "GET", "description": "Gets a NotebookRuntimeTemplate.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$", "description": "Required. The name of the NotebookRuntimeTemplate resource. Format: `projects/{project}/locations/{location}/notebookRuntimeTemplates/{notebook_runtime_template}`", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate" }, "id": "aiplatform.projects.locations.notebookRuntimeTemplates.get" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.notebookRuntimeTemplates.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListNotebookRuntimeTemplatesResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1beta1/{+parent}/notebookRuntimeTemplates", "parameters": { "filter": { "description": "Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `notebookRuntimeTemplate` supports = and !=. `notebookRuntimeTemplate` represents the NotebookRuntimeTemplate ID, i.e. the last segment of the NotebookRuntimeTemplate's resource name. * `display_name` supports = and != * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels.\"a key\"`. * `notebookRuntimeType` supports = and !=. notebookRuntimeType enum: [USER_DEFINED, ONE_CLICK]. * `machineType` supports = and !=. * `acceleratorType` supports = and !=. Some examples: * `notebookRuntimeTemplate=notebookRuntimeTemplate123` * `displayName=\"myDisplayName\"` * `labels.myKey=\"myValue\"` * `notebookRuntimeType=USER_DEFINED` * `machineType=e2-standard-4` * `acceleratorType=NVIDIA_TESLA_T4`", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the NotebookRuntimeTemplates. Format: `projects/{project}/locations/{location}`" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. The standard list page size.", "location": "query" }, "readMask": { "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to read.", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token. Typically obtained via ListNotebookRuntimeTemplatesResponse.next_page_token of the previous NotebookService.ListNotebookRuntimeTemplates call." }, "orderBy": { "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`.", "type": "string" } }, "description": "Lists NotebookRuntimeTemplates in a Location." }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "response": { "$ref": "GoogleIamV1Policy" }, "path": "v1beta1/{+resource}:setIamPolicy", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string" } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}:setIamPolicy", "parameterOrder": [ "resource" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "id": "aiplatform.projects.locations.notebookRuntimeTemplates.setIamPolicy" }, "getIamPolicy": { "response": { "$ref": "GoogleIamV1Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.getIamPolicy", "httpMethod": "POST", "parameters": { "options.requestedPolicyVersion": { "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "format": "int32", "type": "integer" }, "resource": { "location": "path", "required": true, "type": "string", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}:getIamPolicy", "parameterOrder": [ "resource" ], "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "httpMethod": "DELETE", "description": "Deletes a NotebookRuntimeTemplate.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the NotebookRuntimeTemplate resource to be deleted. Format: `projects/{project}/locations/{location}/notebookRuntimeTemplates/{notebook_runtime_template}`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.notebookRuntimeTemplates.delete" } }, "resources": { "operations": { "methods": { "list": { "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+$" }, "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.operations.list" }, "wait": { "path": "v1beta1/{+name}:wait", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.operations.wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted." } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.notebookRuntimeTemplates.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.operations.cancel", "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimeTemplates/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.notebookRuntimeTemplates.operations.get", "parameterOrder": [ "name" ] } } } } }, "evaluationTasks": { "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationTasks/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationTasks/{evaluationTasksId}/operations/{operationsId}", "id": "aiplatform.projects.locations.evaluationTasks.operations.delete" }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationTasks/{evaluationTasksId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationTasks/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.evaluationTasks.operations.list" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationTasks/{evaluationTasksId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.evaluationTasks.operations.wait", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/evaluationTasks/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" } } }, "get": { "id": "aiplatform.projects.locations.evaluationTasks.operations.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/evaluationTasks/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/evaluationTasks/{evaluationTasksId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "migratableResources": { "resources": { "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.migratableResources.operations.list", "path": "v1beta1/{+name}/operations", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/migratableResources/[^/]+$" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources/{migratableResourcesId}/operations", "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources/{migratableResourcesId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.migratableResources.operations.wait", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/migratableResources/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources/{migratableResourcesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.migratableResources.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/migratableResources/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources/{migratableResourcesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.migratableResources.operations.get", "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/migratableResources/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources/{migratableResourcesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.migratableResources.operations.cancel", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/migratableResources/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "path": "v1beta1/{+name}:cancel" } } } }, "methods": { "search": { "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The location that the migratable resources should be searched from. It's the Vertex AI location that the resources can be migrated to, not the resources' original location. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "POST", "description": "Searches all of the resources in automl.googleapis.com, datalabeling.googleapis.com and ml.googleapis.com that can be migrated to Vertex AI's given location.", "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchMigratableResourcesResponse" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.migratableResources.search", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/migratableResources:search", "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchMigratableResourcesRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources:search" }, "batchMigrate": { "id": "aiplatform.projects.locations.migratableResources.batchMigrate", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/migratableResources:batchMigrate", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Batch migrates resources from ml.googleapis.com, automl.googleapis.com, and datalabeling.googleapis.com to Vertex AI.", "path": "v1beta1/{+parent}/migratableResources:batchMigrate", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The location of the migrated resource will live in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesRequest" } } } }, "featurestores": { "methods": { "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "description": "Required. The name of the Featurestore to be deleted. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`", "location": "path", "required": true, "type": "string" }, "force": { "description": "If set to true, any EntityTypes and Features for this Featurestore will also be deleted. (Otherwise, the request will only work if the Featurestore has no EntityTypes.)", "type": "boolean", "location": "query" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}", "id": "aiplatform.projects.locations.featurestores.delete", "description": "Deletes a single Featurestore. The Featurestore must not contain any EntityTypes or `force` must be set to true for the request to succeed." }, "searchFeatures": { "id": "aiplatform.projects.locations.featurestores.searchFeatures", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Searches Features matching a query in a given project.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores:searchFeatures", "httpMethod": "GET", "path": "v1beta1/{+location}/featurestores:searchFeatures", "parameters": { "pageSize": { "format": "int32", "description": "The maximum number of Features to return. The service may return fewer than this value. If unspecified, at most 100 Features will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100.", "type": "integer", "location": "query" }, "location": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to search Features. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageToken": { "type": "string", "description": "A page token, received from a previous FeaturestoreService.SearchFeatures call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeaturestoreService.SearchFeatures, except `page_size`, must match the call that provided the page token.", "location": "query" }, "query": { "type": "string", "location": "query", "description": "Query string that is a conjunction of field-restricted queries and/or field-restricted filters. Field-restricted queries and filters can be combined using `AND` to form a conjunction. A field query is in the form FIELD:QUERY. This implicitly checks if QUERY exists as a substring within Feature's FIELD. The QUERY and the FIELD are converted to a sequence of words (i.e. tokens) for comparison. This is done by: * Removing leading/trailing whitespace and tokenizing the search value. Characters that are not one of alphanumeric `[a-zA-Z0-9]`, underscore `_`, or asterisk `*` are treated as delimiters for tokens. `*` is treated as a wildcard that matches characters within a token. * Ignoring case. * Prepending an asterisk to the first and appending an asterisk to the last token in QUERY. A QUERY must be either a singular token or a phrase. A phrase is one or multiple words enclosed in double quotation marks (\"). With phrases, the order of the words is important. Words in the phrase must be matching in order and consecutively. Supported FIELDs for field-restricted queries: * `feature_id` * `description` * `entity_type_id` Examples: * `feature_id: foo` --\u003e Matches a Feature with ID containing the substring `foo` (eg. `foo`, `foofeature`, `barfoo`). * `feature_id: foo*feature` --\u003e Matches a Feature with ID containing the substring `foo*feature` (eg. `foobarfeature`). * `feature_id: foo AND description: bar` --\u003e Matches a Feature with ID containing the substring `foo` and description containing the substring `bar`. Besides field queries, the following exact-match filters are supported. The exact-match filters do not support wildcards. Unlike field-restricted queries, exact-match filters are case-sensitive. * `feature_id`: Supports = comparisons. * `description`: Supports = comparisons. Multi-token filters should be enclosed in quotes. * `entity_type_id`: Supports = comparisons. * `value_type`: Supports = and != comparisons. * `labels`: Supports key-value equality as well as key presence. * `featurestore_id`: Supports = comparisons. Examples: * `description = \"foo bar\"` --\u003e Any Feature with description exactly equal to `foo bar` * `value_type = DOUBLE` --\u003e Features whose type is DOUBLE. * `labels.active = yes AND labels.env = prod` --\u003e Features having both (active: yes) and (env: prod) labels. * `labels.env: *` --\u003e Any Feature which has a label with `env` as the key." } }, "parameterOrder": [ "location" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchFeaturesResponse" } }, "get": { "httpMethod": "GET", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}", "id": "aiplatform.projects.locations.featurestores.get", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the Featurestore resource." } }, "description": "Gets details of a single Featurestore.", "response": { "$ref": "GoogleCloudAiplatformV1beta1Featurestore" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "batchReadFeatureValues": { "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequest" }, "parameterOrder": [ "featurestore" ], "parameters": { "featurestore": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Featurestore from which to query Feature values. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`", "type": "string" } }, "id": "aiplatform.projects.locations.featurestores.batchReadFeatureValues", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+featurestore}:batchReadFeatureValues", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Batch reads Feature values from a Featurestore. This API enables batch reading Feature values, where each read instance in the batch may read Feature values of entities from one or more EntityTypes. Point-in-time correctness is guaranteed for Feature values of each read instance as of each instance's read timestamp.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}:batchReadFeatureValues" }, "list": { "httpMethod": "GET", "parameters": { "filter": { "type": "string", "location": "query", "description": "Lists the featurestores that match the filter expression. The following fields are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. Values must be in RFC 3339 format. * `online_serving_config.fixed_node_count`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003c=`, and `\u003e=` comparisons. * `labels`: Supports key-value equality and key presence. Examples: * `create_time \u003e \"2020-01-01\" OR update_time \u003e \"2020-01-01\"` Featurestores created or updated after 2020-01-01. * `labels.env = \"prod\"` Featurestores with label \"env\" set to \"prod\"." }, "pageSize": { "description": "The maximum number of Featurestores to return. The service may return fewer than this value. If unspecified, at most 100 Featurestores will be returned. The maximum value is 100; any value greater than 100 will be coerced to 100.", "location": "query", "type": "integer", "format": "int32" }, "readMask": { "description": "Mask specifying which fields to read.", "location": "query", "type": "string", "format": "google-fieldmask" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Location to list Featurestores. Format: `projects/{project}/locations/{location}`" }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported Fields: * `create_time` * `update_time` * `online_serving_config.fixed_node_count`", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "A page token, received from a previous FeaturestoreService.ListFeaturestores call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeaturestoreService.ListFeaturestores must match the call that provided the page token.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores", "description": "Lists Featurestores in a given project and location.", "path": "v1beta1/{+parent}/featurestores", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeaturestoresResponse" }, "id": "aiplatform.projects.locations.featurestores.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "setIamPolicy": { "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}:setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "id": "aiplatform.projects.locations.featurestores.setIamPolicy" }, "testIamPermissions": { "parameterOrder": [ "resource" ], "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "parameters": { "resource": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field." } }, "httpMethod": "POST", "id": "aiplatform.projects.locations.featurestores.testIamPermissions", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleIamV1TestIamPermissionsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}:testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions" }, "getIamPolicy": { "path": "v1beta1/{+resource}:getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}:getIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "request": { "$ref": "GoogleIamV1GetIamPolicyRequest" }, "parameterOrder": [ "resource" ], "id": "aiplatform.projects.locations.featurestores.getIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string" } } }, "patch": { "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featurestores.patch", "description": "Updates the parameters of a single Featurestore.", "httpMethod": "PATCH", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}", "parameters": { "updateMask": { "description": "Field mask is used to specify the fields to be overwritten in the Featurestore resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `labels` * `online_serving_config.fixed_node_count` * `online_serving_config.scaling` * `online_storage_ttl_days`", "type": "string", "location": "query", "format": "google-fieldmask" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "location": "path", "required": true, "description": "Output only. Name of the Featurestore. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`" } }, "path": "v1beta1/{+name}", "request": { "$ref": "GoogleCloudAiplatformV1beta1Featurestore" }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1Featurestore" }, "path": "v1beta1/{+parent}/featurestores", "id": "aiplatform.projects.locations.featurestores.create", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores", "parameters": { "parent": { "description": "Required. The resource name of the Location to create Featurestores. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "featurestoreId": { "type": "string", "location": "query", "description": "Required. The ID to use for this Featurestore, which will become the final component of the Featurestore's resource name. This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within the project and location." } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new Featurestore in a given project and location." } }, "resources": { "entityTypes": { "resources": { "operations": { "methods": { "list": { "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.projects.locations.featurestores.entityTypes.operations.wait", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$" }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.featurestores.entityTypes.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "POST" }, "get": { "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}", "id": "aiplatform.projects.locations.featurestores.entityTypes.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "delete": { "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}", "parameterOrder": [ "name" ] } } }, "features": { "resources": { "operations": { "methods": { "cancel": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.featurestores.entityTypes.features.operations.cancel" }, "list": { "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" } }, "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.features.operations.list", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.featurestores.entityTypes.features.operations.wait", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$" }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" } }, "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.featurestores.entityTypes.features.operations.delete", "parameterOrder": [ "name" ] }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}", "id": "aiplatform.projects.locations.featurestores.entityTypes.features.operations.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } } } } }, "methods": { "batchCreate": { "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "Required. The resource name of the EntityType/FeatureGroup to create the batch of Features under. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchCreateFeaturesRequest" }, "description": "Creates a batch of Features in a given EntityType.", "path": "v1beta1/{+parent}/features:batchCreate", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features:batchCreate", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.featurestores.entityTypes.features.batchCreate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Feature" }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features", "httpMethod": "POST", "parameters": { "featureId": { "type": "string", "description": "Required. The ID to use for the Feature, which will become the final component of the Feature's resource name. This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within an EntityType/FeatureGroup.", "location": "query" }, "parent": { "description": "Required. The resource name of the EntityType or FeatureGroup to create a Feature. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$" } }, "parameterOrder": [ "parent" ], "description": "Creates a new Feature in a given EntityType.", "path": "v1beta1/{+parent}/features", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.features.create" }, "delete": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}", "id": "aiplatform.projects.locations.featurestores.entityTypes.features.delete", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. The name of the Features to be deleted. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}` `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "description": "Deletes a single Feature." }, "list": { "description": "Lists Features in a given EntityType.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListFeaturesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.features.list", "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "location": "query", "type": "string", "description": "A page token, received from a previous FeaturestoreService.ListFeatures call or FeatureRegistryService.ListFeatures call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeaturestoreService.ListFeatures or FeatureRegistryService.ListFeatures must match the call that provided the page token." }, "latestStatsCount": { "description": "Only applicable for Vertex AI Feature Store (Legacy). If set, return the most recent ListFeaturesRequest.latest_stats_count of stats for each Feature in response. Valid value is [0, 10]. If number of stats exists \u003c ListFeaturesRequest.latest_stats_count, return all existing stats.", "location": "query", "format": "int32", "type": "integer" }, "filter": { "description": "Lists the Features that match the filter expression. The following filters are supported: * `value_type`: Supports = and != comparisons. * `create_time`: Supports =, !=, \u003c, \u003e, \u003e=, and \u003c= comparisons. Values must be in RFC 3339 format. * `update_time`: Supports =, !=, \u003c, \u003e, \u003e=, and \u003c= comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality as well as key presence. Examples: * `value_type = DOUBLE` --\u003e Features whose type is DOUBLE. * `create_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\" OR update_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\"` --\u003e EntityTypes created or updated after 2020-01-31T15:30:00.000000Z. * `labels.active = yes AND labels.env = prod` --\u003e Features having both (active: yes) and (env: prod) labels. * `labels.env: *` --\u003e Any Feature which has a label with 'env' as the key.", "type": "string", "location": "query" }, "pageSize": { "location": "query", "description": "The maximum number of Features to return. The service may return fewer than this value. If unspecified, at most 1000 Features will be returned. The maximum value is 1000; any value greater than 1000 will be coerced to 1000.", "type": "integer", "format": "int32" }, "readMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Mask specifying which fields to read." }, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `feature_id` * `value_type` (Not supported for FeatureRegistry Feature) * `create_time` * `update_time`", "location": "query", "type": "string" }, "parent": { "description": "Required. The resource name of the Location to list Features. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$" } }, "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features", "path": "v1beta1/{+parent}/features" }, "patch": { "response": { "$ref": "GoogleCloudAiplatformV1beta1Feature" }, "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.features.patch", "parameters": { "name": { "description": "Immutable. Name of the Feature. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}` `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}` The last part feature is assigned by the client. The feature can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given an entity type.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+$" }, "updateMask": { "format": "google-fieldmask", "location": "query", "type": "string", "description": "Field mask is used to specify the fields to be overwritten in the Features resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `description` * `labels` * `disable_monitoring` (Not supported for FeatureRegistryService Feature) * `point_of_contact` (Not supported for FeaturestoreService FeatureStore)" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}", "httpMethod": "PATCH", "description": "Updates the parameters of a single Feature.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Feature" } }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Feature" }, "id": "aiplatform.projects.locations.featurestores.entityTypes.features.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single Feature.", "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "Required. The name of the Feature resource. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+$", "location": "path", "required": true }, "featureStatsAndAnomalySpec.statsTimeRange.startTime": { "type": "string", "format": "google-datetime", "location": "query", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "featureStatsAndAnomalySpec.statsTimeRange.endTime": { "location": "query", "format": "google-datetime", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "type": "string" }, "featureStatsAndAnomalySpec.latestStatsCount": { "description": "Optional. If set, returns the most recent count of stats. Valid value is [0, 100]. If stats_time_range is set, return most recent count of stats within the stats_time_range.", "format": "int32", "type": "integer", "location": "query" } }, "parameterOrder": [ "name" ] } } } }, "methods": { "importFeatureValues": { "id": "aiplatform.projects.locations.featurestores.entityTypes.importFeatureValues", "path": "v1beta1/{+entityType}:importFeatureValues", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Imports Feature values into the Featurestore from a source storage. The progress of the import is tracked by the returned operation. The imported features are guaranteed to be visible to subsequent read operations after the operation is marked as successfully done. If an import operation fails, the Feature values returned from reads and exports may be inconsistent. If consistency is required, the caller must retry the same import request again and wait till the new operation returned is marked as successfully done. There are also scenarios where the caller can cause inconsistency. - Source data for import contains multiple distinct Feature values for the same entity ID and timestamp. - Source is modified during an import. This includes adding, updating, or removing source data and/or metadata. Examples of updating metadata include but are not limited to changing storage location, storage class, or retention policy. - Online serving cluster is under-provisioned.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:importFeatureValues", "httpMethod": "POST", "parameters": { "entityType": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the EntityType grouping the Features for which values are being imported. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequest" }, "parameterOrder": [ "entityType" ] }, "setIamPolicy": { "request": { "$ref": "GoogleIamV1SetIamPolicyRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:setIamPolicy", "httpMethod": "POST", "id": "aiplatform.projects.locations.featurestores.entityTypes.setIamPolicy", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string" } }, "path": "v1beta1/{+resource}:setIamPolicy", "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "response": { "$ref": "GoogleIamV1Policy" } }, "streamingReadFeatureValues": { "parameterOrder": [ "entityType" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.streamingReadFeatureValues", "path": "v1beta1/{+entityType}:streamingReadFeatureValues", "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamingReadFeatureValuesRequest" }, "description": "Reads Feature values for multiple entities. Depending on their size, data for different entities may be broken up across multiple responses.", "parameters": { "entityType": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the entities' type. Value format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`. For example, for a machine learning model predicting user clicks on a website, an EntityType ID could be `user`.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:streamingReadFeatureValues", "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "path": "v1beta1/{+parent}/entityTypes", "id": "aiplatform.projects.locations.featurestores.entityTypes.list", "parameters": { "pageToken": { "type": "string", "description": "A page token, received from a previous FeaturestoreService.ListEntityTypes call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FeaturestoreService.ListEntityTypes must match the call that provided the page token.", "location": "query" }, "filter": { "description": "Lists the EntityTypes that match the filter expression. The following filters are supported: * `create_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003e=`, and `\u003c=` comparisons. Values must be in RFC 3339 format. * `update_time`: Supports `=`, `!=`, `\u003c`, `\u003e`, `\u003e=`, and `\u003c=` comparisons. Values must be in RFC 3339 format. * `labels`: Supports key-value equality as well as key presence. Examples: * `create_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\" OR update_time \u003e \\\"2020-01-31T15:30:00.000000Z\\\"` --\u003e EntityTypes created or updated after 2020-01-31T15:30:00.000000Z. * `labels.active = yes AND labels.env = prod` --\u003e EntityTypes having both (active: yes) and (env: prod) labels. * `labels.env: *` --\u003e Any EntityType which has a label with 'env' as the key.", "location": "query", "type": "string" }, "orderBy": { "type": "string", "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `entity_type_id` * `create_time` * `update_time`", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "description": "Required. The resource name of the Featurestore to list EntityTypes. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`", "location": "path", "required": true, "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of EntityTypes to return. The service may return fewer than this value. If unspecified, at most 1000 EntityTypes will be returned. The maximum value is 1000; any value greater than 1000 will be coerced to 1000." }, "readMask": { "type": "string", "location": "query", "description": "Mask specifying which fields to read.", "format": "google-fieldmask" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEntityTypesResponse" }, "description": "Lists EntityTypes in a given Featurestore.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes" }, "exportFeatureValues": { "parameterOrder": [ "entityType" ], "description": "Exports Feature values from all the entities of a target EntityType.", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:exportFeatureValues", "id": "aiplatform.projects.locations.featurestores.entityTypes.exportFeatureValues", "path": "v1beta1/{+entityType}:exportFeatureValues", "parameters": { "entityType": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "Required. The resource name of the EntityType from which to export Feature values. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`" } }, "httpMethod": "POST" }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1EntityType" }, "id": "aiplatform.projects.locations.featurestores.entityTypes.patch", "response": { "$ref": "GoogleCloudAiplatformV1beta1EntityType" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "location": "path", "required": true, "description": "Immutable. Name of the EntityType. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` The last part entity_type is assigned by the client. The entity_type can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z and underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given a featurestore.", "type": "string" }, "updateMask": { "type": "string", "format": "google-fieldmask", "location": "query", "description": "Field mask is used to specify the fields to be overwritten in the EntityType resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then only the non-empty fields present in the request will be overwritten. Set the update_mask to `*` to override all fields. Updatable fields: * `description` * `labels` * `monitoring_config.snapshot_analysis.disabled` * `monitoring_config.snapshot_analysis.monitoring_interval_days` * `monitoring_config.snapshot_analysis.staleness_days` * `monitoring_config.import_features_analysis.state` * `monitoring_config.import_features_analysis.anomaly_detection_baseline` * `monitoring_config.numerical_threshold_config.value` * `monitoring_config.categorical_threshold_config.value` * `offline_storage_ttl_days`" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the parameters of a single EntityType.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "get": { "description": "Gets details of a single EntityType.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the EntityType resource. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`" } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.featurestores.entityTypes.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1EntityType" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}", "path": "v1beta1/{+name}" }, "writeFeatureValues": { "request": { "$ref": "GoogleCloudAiplatformV1beta1WriteFeatureValuesRequest" }, "parameterOrder": [ "entityType" ], "description": "Writes Feature values of one or more entities of an EntityType. The Feature values are merged into existing entities if any. The Feature values to be written must have timestamp within the online storage retention.", "id": "aiplatform.projects.locations.featurestores.entityTypes.writeFeatureValues", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1WriteFeatureValuesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:writeFeatureValues", "path": "v1beta1/{+entityType}:writeFeatureValues", "parameters": { "entityType": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "Required. The resource name of the EntityType for the entities being written. Value format: `projects/{project}/locations/{location}/featurestores/ {featurestore}/entityTypes/{entityType}`. For example, for a machine learning model predicting user clicks on a website, an EntityType ID could be `user`.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST" }, "deleteFeatureValues": { "request": { "$ref": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequest" }, "parameterOrder": [ "entityType" ], "id": "aiplatform.projects.locations.featurestores.entityTypes.deleteFeatureValues", "path": "v1beta1/{+entityType}:deleteFeatureValues", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:deleteFeatureValues", "description": "Delete Feature values from Featurestore. The progress of the deletion is tracked by the returned operation. The deleted feature values are guaranteed to be invisible to subsequent read operations after the operation is marked as successfully done. If a delete feature values operation fails, the feature values returned from reads and exports may be inconsistent. If consistency is required, the caller must retry the same delete request again and wait till the new operation returned is marked as successfully done.", "parameters": { "entityType": { "type": "string", "description": "Required. The resource name of the EntityType grouping the Features for which values are being deleted from. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "testIamPermissions": { "httpMethod": "POST", "id": "aiplatform.projects.locations.featurestores.entityTypes.testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "parameters": { "permissions": { "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "repeated": true, "location": "query", "type": "string" }, "resource": { "location": "path", "required": true, "description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$" } }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:testIamPermissions", "response": { "$ref": "GoogleIamV1TestIamPermissionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ] }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "Required. The name of the EntityType to be deleted. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}`" }, "force": { "location": "query", "description": "If set to true, any Features for this EntityType will also be deleted. (Otherwise, the request will only work if the EntityType has no Features.)", "type": "boolean" } }, "id": "aiplatform.projects.locations.featurestores.entityTypes.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes a single EntityType. The EntityType must not have any Features or `force` must be set to true for the request to succeed." }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.projects.locations.featurestores.entityTypes.create", "parameterOrder": [ "parent" ], "description": "Creates a new EntityType in a given Featurestore.", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes", "parameters": { "entityTypeId": { "description": "Required. The ID to use for the EntityType, which will become the final component of the EntityType's resource name. This value may be up to 60 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within a featurestore.", "location": "query", "type": "string" }, "parent": { "description": "Required. The resource name of the Featurestore to create EntityTypes. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/entityTypes", "request": { "$ref": "GoogleCloudAiplatformV1beta1EntityType" } }, "readFeatureValues": { "id": "aiplatform.projects.locations.featurestores.entityTypes.readFeatureValues", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:readFeatureValues", "description": "Reads Feature values of a specific entity of an EntityType. For reading feature values of multiple entities of an EntityType, please use StreamingReadFeatureValues.", "parameters": { "entityType": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "description": "Required. The resource name of the EntityType for the entity being read. Value format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`. For example, for a machine learning model predicting user clicks on a website, an EntityType ID could be `user`.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponse" }, "parameterOrder": [ "entityType" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesRequest" }, "path": "v1beta1/{+entityType}:readFeatureValues" }, "getIamPolicy": { "parameterOrder": [ "resource" ], "path": "v1beta1/{+resource}:getIamPolicy", "id": "aiplatform.projects.locations.featurestores.entityTypes.getIamPolicy", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/entityTypes/{entityTypesId}:getIamPolicy", "response": { "$ref": "GoogleIamV1Policy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "resource": { "description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/entityTypes/[^/]+$", "location": "path", "required": true, "type": "string" }, "options.requestedPolicyVersion": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "httpMethod": "POST" } } }, "operations": { "methods": { "cancel": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/operations/{operationsId}:cancel", "id": "aiplatform.projects.locations.featurestores.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/operations", "id": "aiplatform.projects.locations.featurestores.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+$", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The standard list page size." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" } } }, "wait": { "id": "aiplatform.projects.locations.featurestores.operations.wait", "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query", "format": "google-duration" }, "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/operations/{operationsId}:wait" }, "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.featurestores.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/featurestores/{featurestoresId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/featurestores/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.featurestores.operations.delete", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "operations": { "methods": { "cancel": { "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.operations.cancel" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.operations.delete" }, "get": { "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "id": "aiplatform.projects.locations.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" } }, "id": "aiplatform.projects.locations.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "parameters": { "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.projects.locations.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." } } }, "exampleStores": { "resources": { "operations": { "methods": { "get": { "id": "aiplatform.projects.locations.exampleStores.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}/operations/{operationsId}", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+/operations/[^/]+$" } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "httpMethod": "POST", "id": "aiplatform.projects.locations.exampleStores.operations.cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.projects.locations.exampleStores.operations.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "httpMethod": "GET" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}/operations/{operationsId}:wait", "id": "aiplatform.projects.locations.exampleStores.operations.wait", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.exampleStores.operations.delete" } } } }, "methods": { "searchExamples": { "path": "v1beta1/{+exampleStore}:searchExamples", "id": "aiplatform.projects.locations.exampleStores.searchExamples", "httpMethod": "POST", "parameters": { "exampleStore": { "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "type": "string", "description": "Required. The name of the ExampleStore resource that examples are retrieved from. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1SearchExamplesRequest" }, "description": "Search for similar Examples for given selection criteria.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SearchExamplesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}:searchExamples", "parameterOrder": [ "exampleStore" ] }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores", "httpMethod": "GET", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to list the ExampleStores from. Format: `projects/{project}/locations/{location}`", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "filter": { "type": "string", "location": "query", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160)." }, "pageSize": { "description": "Optional. The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "location": "query", "description": "Optional. The standard list page token.", "type": "string" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ListExampleStoresResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.exampleStores.list", "parameterOrder": [ "parent" ], "description": "List ExampleStores in a Location.", "path": "v1beta1/{+parent}/exampleStores" }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}", "description": "Delete an ExampleStore.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "type": "string", "description": "Required. The resource name of the ExampleStore to be deleted. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`" } }, "id": "aiplatform.projects.locations.exampleStores.delete" }, "patch": { "id": "aiplatform.projects.locations.exampleStores.patch", "request": { "$ref": "GoogleCloudAiplatformV1beta1ExampleStore" }, "description": "Update an ExampleStore.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "description": "Identifier. The resource name of the ExampleStore. This is a unique identifier. Format: projects/{project}/locations/{location}/exampleStores/{example_store}" }, "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to update. Supported fields: * `display_name` * `description`", "location": "query" } }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}", "httpMethod": "PATCH" }, "get": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}", "id": "aiplatform.projects.locations.exampleStores.get", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the ExampleStore. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ExampleStore" }, "parameterOrder": [ "name" ], "description": "Get an ExampleStore." }, "removeExamples": { "httpMethod": "POST", "path": "v1beta1/{+exampleStore}:removeExamples", "parameters": { "exampleStore": { "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "description": "Required. The name of the ExampleStore resource that the examples should be removed from. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.exampleStores.removeExamples", "description": "Remove Examples from the Example Store.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}:removeExamples", "response": { "$ref": "GoogleCloudAiplatformV1beta1RemoveExamplesResponse" }, "parameterOrder": [ "exampleStore" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RemoveExamplesRequest" } }, "create": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/exampleStores:create", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Create an ExampleStore.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores:create", "id": "aiplatform.projects.locations.exampleStores.create", "httpMethod": "POST", "parameters": { "exampleStore.description": { "description": "Optional. Description of the ExampleStore.", "type": "string", "location": "query" }, "exampleStore.updateTime": { "format": "google-datetime", "description": "Output only. Timestamp when this ExampleStore was most recently updated.", "location": "query", "type": "string" }, "exampleStore.exampleStoreConfig.vertexEmbeddingModel": { "location": "query", "description": "Required. The embedding model to be used for vector embedding. Immutable. Supported models: * \"text-embedding-005\" * \"text-multilingual-embedding-002\"", "type": "string" }, "exampleStore.createTime": { "description": "Output only. Timestamp when this ExampleStore was created.", "location": "query", "format": "google-datetime", "type": "string" }, "exampleStore.displayName": { "location": "query", "description": "Required. Display name of the ExampleStore.", "type": "string" }, "exampleStore.name": { "description": "Identifier. The resource name of the ExampleStore. This is a unique identifier. Format: projects/{project}/locations/{location}/exampleStores/{example_store}", "location": "query", "type": "string" }, "parent": { "description": "Required. The resource name of the Location to create the ExampleStore in. Format: `projects/{project}/locations/{location}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true } } }, "fetchExamples": { "path": "v1beta1/{+exampleStore}:fetchExamples", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.exampleStores.fetchExamples", "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}:fetchExamples", "parameters": { "exampleStore": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$", "description": "Required. The name of the ExampleStore resource that the examples should be fetched from. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1FetchExamplesResponse" }, "description": "Get Examples from the Example Store.", "parameterOrder": [ "exampleStore" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchExamplesRequest" } }, "upsertExamples": { "httpMethod": "POST", "parameters": { "exampleStore": { "description": "Required. The name of the ExampleStore resource that examples are added to or updated in. Format: `projects/{project}/locations/{location}/exampleStores/{example_store}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/exampleStores/[^/]+$" } }, "id": "aiplatform.projects.locations.exampleStores.upsertExamples", "parameterOrder": [ "exampleStore" ], "path": "v1beta1/{+exampleStore}:upsertExamples", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Create or update Examples in the Example Store.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/exampleStores/{exampleStoresId}:upsertExamples", "response": { "$ref": "GoogleCloudAiplatformV1beta1UpsertExamplesResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1UpsertExamplesRequest" } } } }, "ragEngineConfig": { "resources": { "operations": { "methods": { "get": { "id": "aiplatform.projects.locations.ragEngineConfig.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.projects.locations.ragEngineConfig.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel" }, "delete": { "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig/operations/{operationsId}", "id": "aiplatform.projects.locations.ragEngineConfig.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.ragEngineConfig.operations.list", "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig$", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig/operations" }, "wait": { "id": "aiplatform.projects.locations.ragEngineConfig.operations.wait", "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragEngineConfig/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/ragEngineConfig/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "type": "string", "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "parameterOrder": [ "name" ] } } } } }, "servingProfiles": { "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles", "description": "Creates a ServingProfile.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.locations.servingProfiles.create", "httpMethod": "POST", "parameters": { "servingProfileId": { "description": "Required. The ID to use for the ServingProfile, which will become the final component of the ServingProfile's resource name. This value should be 1-63 characters, and valid characters are `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Location to create the ServingProfile in. Format: `projects/{project}/locations/{location}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfile" }, "path": "v1beta1/{+parent}/servingProfiles" }, "patch": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfile" }, "id": "aiplatform.projects.locations.servingProfiles.patch", "request": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfile" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}", "description": "Updates a ServingProfile.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+$", "location": "path", "required": true, "description": "Identifier. The resource name of the ServingProfile.", "type": "string" }, "updateMask": { "description": "Optional. The list of fields to update; see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask. If omitted, all populated (non-empty) mutable fields are updated; if set to `[\"*\"]`, all mutable fields are fully replaced (unpopulated values are cleared).", "format": "google-fieldmask", "location": "query", "type": "string" } }, "path": "v1beta1/{+name}", "httpMethod": "PATCH" }, "list": { "httpMethod": "GET", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The resource name of the Location to list the ServingProfiles from. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true }, "pageSize": { "location": "query", "description": "Optional. The standard list page size. If unspecified, at most 100 ServingProfiles will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The standard list page token." } }, "path": "v1beta1/{+parent}/servingProfiles", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListServingProfilesResponse" }, "description": "Lists ServingProfiles in a Location.", "id": "aiplatform.projects.locations.servingProfiles.list", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles" }, "get": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfile" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+$", "type": "string", "description": "Required. The name of the ServingProfile resource. Format: `projects/{project}/locations/{location}/servingProfiles/{serving_profile}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a ServingProfile.", "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}", "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.servingProfiles.get" }, "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the ServingProfile resource to be deleted. Format: `projects/{project}/locations/{location}/servingProfiles/{serving_profile}`" } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.servingProfiles.delete", "description": "Deletes a ServingProfile." } }, "resources": { "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}/operations", "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+$" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." } }, "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.projects.locations.servingProfiles.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.servingProfiles.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.projects.locations.servingProfiles.operations.delete", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "cancel": { "id": "aiplatform.projects.locations.servingProfiles.operations.cancel", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel" }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/servingProfiles/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.servingProfiles.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/servingProfiles/{servingProfilesId}/operations/{operationsId}" } } } } }, "notebookRuntimes": { "methods": { "upgrade": { "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the NotebookRuntime resource to be upgrade. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "type": "string" } }, "id": "aiplatform.projects.locations.notebookRuntimes.upgrade", "httpMethod": "POST", "path": "v1beta1/{+name}:upgrade", "description": "Upgrades a NotebookRuntime.", "request": { "$ref": "GoogleCloudAiplatformV1beta1UpgradeNotebookRuntimeRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:upgrade", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "parameterOrder": [ "parent" ], "description": "Lists NotebookRuntimes in a Location.", "path": "v1beta1/{+parent}/notebookRuntimes", "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "Optional. The standard list page size.", "location": "query" }, "readMask": { "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to read.", "location": "query", "type": "string" }, "filter": { "location": "query", "description": "Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `notebookRuntime` supports = and !=. `notebookRuntime` represents the NotebookRuntime ID, i.e. the last segment of the NotebookRuntime's resource name. * `displayName` supports = and != and regex. * `notebookRuntimeTemplate` supports = and !=. `notebookRuntimeTemplate` represents the NotebookRuntimeTemplate ID, i.e. the last segment of the NotebookRuntimeTemplate's resource name. * `healthState` supports = and !=. healthState enum: [HEALTHY, UNHEALTHY, HEALTH_STATE_UNSPECIFIED]. * `runtimeState` supports = and !=. runtimeState enum: [RUNTIME_STATE_UNSPECIFIED, RUNNING, BEING_STARTED, BEING_STOPPED, STOPPED, BEING_UPGRADED, ERROR, INVALID]. * `runtimeUser` supports = and !=. * API version is UI only: `uiState` supports = and !=. uiState enum: [UI_RESOURCE_STATE_UNSPECIFIED, UI_RESOURCE_STATE_BEING_CREATED, UI_RESOURCE_STATE_ACTIVE, UI_RESOURCE_STATE_BEING_DELETED, UI_RESOURCE_STATE_CREATION_FAILED]. * `notebookRuntimeType` supports = and !=. notebookRuntimeType enum: [USER_DEFINED, ONE_CLICK]. * `machineType` supports = and !=. * `acceleratorType` supports = and !=. Some examples: * `notebookRuntime=\"notebookRuntime123\"` * `displayName=\"myDisplayName\"` and `displayName=~\"myDisplayNameRegex\"` * `notebookRuntimeTemplate=\"notebookRuntimeTemplate321\"` * `healthState=HEALTHY` * `runtimeState=RUNNING` * `runtimeUser=\"test@google.com\"` * `uiState=UI_RESOURCE_STATE_BEING_DELETED` * `notebookRuntimeType=USER_DEFINED` * `machineType=e2-standard-4` * `acceleratorType=NVIDIA_TESLA_T4`", "type": "string" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token. Typically obtained via ListNotebookRuntimesResponse.next_page_token of the previous NotebookService.ListNotebookRuntimes call.", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location from which to list the NotebookRuntimes. Format: `projects/{project}/locations/{location}`" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`." } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.notebookRuntimes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListNotebookRuntimesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes" }, "assign": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Assigns a NotebookRuntime to a user for a particular Notebook file. This method will either returns an existing assignment or generates a new one.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes:assign", "request": { "$ref": "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Location to get the NotebookRuntime assignment. Format: `projects/{project}/locations/{location}`" } }, "path": "v1beta1/{+parent}/notebookRuntimes:assign", "httpMethod": "POST", "id": "aiplatform.projects.locations.notebookRuntimes.assign" }, "delete": { "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the NotebookRuntime resource to be deleted. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner." } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a NotebookRuntime.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.notebookRuntimes.delete" }, "reportEvent": { "request": { "$ref": "GoogleCloudAiplatformV1beta1ReportRuntimeEventRequest" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1ReportRuntimeEventResponse" }, "description": "", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:reportEvent", "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "description": "Required. The name of the NotebookRuntime resource. Format: `projects/{project}/locations/{location}/notebookRuntimes/{notebook_runtime}`", "location": "path", "required": true } }, "id": "aiplatform.projects.locations.notebookRuntimes.reportEvent", "path": "v1beta1/{+name}:reportEvent", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "stop": { "id": "aiplatform.projects.locations.notebookRuntimes.stop", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:stop", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:stop", "parameters": { "name": { "description": "Required. The name of the NotebookRuntime resource to be stopped. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$" } }, "description": "Stops a NotebookRuntime.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "generateAccessToken": { "parameters": { "name": { "description": "Required. The name of the resource requesting the OAuth2 token. Format: `projects/{project}/locations/{location}/notebookRuntimes/{notebook_runtime}` `projects/{project}/locations/{location}/notebookExecutionJobs/{notebook_execution_job}`", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:generateAccessToken", "id": "aiplatform.projects.locations.notebookRuntimes.generateAccessToken", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateAccessTokenResponse" }, "parameterOrder": [ "name" ], "description": "Internal only: Called from Compute Engine instance to obtain EUC for owner Anonymous access: authenticates caller using VM identity JWT. Design doc: go/colab-on-vertex-euc-dd", "path": "v1beta1/{+name}:generateAccessToken", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateAccessTokenRequest" } }, "start": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}:start", "parameters": { "name": { "type": "string", "description": "Required. The name of the NotebookRuntime resource to be started. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$" } }, "id": "aiplatform.projects.locations.notebookRuntimes.start", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:start", "description": "Starts a NotebookRuntime.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1StartNotebookRuntimeRequest" }, "parameterOrder": [ "name" ] }, "get": { "id": "aiplatform.projects.locations.notebookRuntimes.get", "description": "Gets a NotebookRuntime.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the NotebookRuntime resource. Instead of checking whether the name is in valid NotebookRuntime resource name format, directly throw NotFound exception if there is no such NotebookRuntime in spanner.", "type": "string" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntime" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}" } }, "resources": { "operations": { "methods": { "get": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.projects.locations.notebookRuntimes.operations.get", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.projects.locations.notebookRuntimes.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "cancel": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.projects.locations.notebookRuntimes.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "POST" }, "list": { "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}/operations", "httpMethod": "GET", "id": "aiplatform.projects.locations.notebookRuntimes.operations.list", "parameters": { "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/notebookRuntimes/[^/]+/operations/[^/]+$" }, "timeout": { "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.notebookRuntimes.operations.wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}:wait" } } } } }, "semanticGovernancePolicyEngine": { "methods": { "deprovision": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/semanticGovernancePolicyEngine:deprovision", "httpMethod": "POST", "description": "Deprovisions the SemanticGovernancePolicyEngine, tearing down the associated tenant project, GKE cluster, and PSC service attachments. This operation is irreversible. Returns a long-running operation; poll for completion. The response contains the SemanticGovernancePolicyEngine in DEPROVISIONING state.", "parameters": { "name": { "description": "Required. The resource name of the SemanticGovernancePolicyEngine to deprovision. Format: projects/{project}/locations/{location}/semanticGovernancePolicyEngine", "pattern": "^projects/[^/]+/locations/[^/]+/semanticGovernancePolicyEngine$", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DeprovisionSemanticGovernancePolicyEngineRequest" }, "id": "aiplatform.projects.locations.semanticGovernancePolicyEngine.deprovision", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:deprovision" } } }, "batchPredictionJobs": { "methods": { "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/batchPredictionJobs", "description": "Creates a BatchPredictionJob. A BatchPredictionJob once created will right away be attempted to start.", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/batchPredictionJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.locations.batchPredictionJobs.create", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location to create the BatchPredictionJob in. Format: `projects/{project}/locations/{location}`", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } } }, "list": { "path": "v1beta1/{+parent}/batchPredictionJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The resource name of the Location to list the BatchPredictionJobs from. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "readMask": { "type": "string", "description": "Mask specifying which fields to read.", "location": "query", "format": "google-fieldmask" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `model_display_name` supports `=`, `!=` comparisons. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`" }, "pageToken": { "type": "string", "description": "The standard list page token. Typically obtained via ListBatchPredictionJobsResponse.next_page_token of the previous JobService.ListBatchPredictionJobs call.", "location": "query" } }, "id": "aiplatform.projects.locations.batchPredictionJobs.list", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/batchPredictionJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListBatchPredictionJobsResponse" }, "description": "Lists BatchPredictionJobs in a Location." }, "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/batchPredictionJobs/{batchPredictionJobsId}:cancel", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelBatchPredictionJobRequest" }, "description": "Cancels a BatchPredictionJob. Starts asynchronous cancellation on the BatchPredictionJob. The server makes the best effort to cancel the job, but success is not guaranteed. Clients can use JobService.GetBatchPredictionJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On a successful cancellation, the BatchPredictionJob is not deleted;instead its BatchPredictionJob.state is set to `CANCELLED`. Any files already outputted by the job are not deleted.", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/batchPredictionJobs/[^/]+$", "type": "string", "description": "Required. The name of the BatchPredictionJob to cancel. Format: `projects/{project}/locations/{location}/batchPredictionJobs/{batch_prediction_job}`", "location": "path", "required": true } }, "path": "v1beta1/{+name}:cancel", "id": "aiplatform.projects.locations.batchPredictionJobs.cancel" }, "get": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/batchPredictionJobs/{batchPredictionJobsId}", "parameters": { "name": { "description": "Required. The name of the BatchPredictionJob resource. Format: `projects/{project}/locations/{location}/batchPredictionJobs/{batch_prediction_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/batchPredictionJobs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.projects.locations.batchPredictionJobs.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "description": "Gets a BatchPredictionJob" }, "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Deletes a BatchPredictionJob. Can only be called on jobs that already finished.", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the BatchPredictionJob resource to be deleted. Format: `projects/{project}/locations/{location}/batchPredictionJobs/{batch_prediction_job}`", "pattern": "^projects/[^/]+/locations/[^/]+/batchPredictionJobs/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/batchPredictionJobs/{batchPredictionJobsId}", "id": "aiplatform.projects.locations.batchPredictionJobs.delete" } } } } }, "modelGardenEula": { "methods": { "check": { "path": "v1beta1/{+parent}/modelGardenEula:check", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The project requesting access for named model. The format is `projects/{project}`.", "pattern": "^projects/[^/]+$", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1CheckPublisherModelEulaAcceptanceRequest" }, "flatPath": "v1beta1/projects/{projectsId}/modelGardenEula:check", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Checks the EULA acceptance status of a publisher model.", "response": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelEulaAcceptance" }, "parameterOrder": [ "parent" ], "id": "aiplatform.projects.modelGardenEula.check" }, "accept": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1AcceptPublisherModelEulaRequest" }, "flatPath": "v1beta1/projects/{projectsId}/modelGardenEula:accept", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The project requesting access for named model. The format is `projects/{project}`.", "type": "string", "location": "path", "required": true, "pattern": "^projects/[^/]+$" } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelEulaAcceptance" }, "description": "Accepts the EULA acceptance status of a publisher model.", "id": "aiplatform.projects.modelGardenEula.accept", "path": "v1beta1/{+parent}/modelGardenEula:accept", "parameterOrder": [ "parent" ] } } }, "publishers": { "resources": { "models": { "methods": { "enableModel": { "parameters": { "parent": { "description": "Required. The project requesting access for named model. Format: `projects/{project}`", "pattern": "^projects/[^/]+$", "location": "path", "required": true, "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^publishers/[^/]+/models/[^/]+$", "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}`", "type": "string" } }, "httpMethod": "POST", "description": "Enables model for the project if prerequisites are met (e.g. completed questionnaire and consents, or an active Private Offer).", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.projects.publishers.models.enableModel", "parameterOrder": [ "parent", "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1EnableModelResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1EnableModelRequest" }, "flatPath": "v1beta1/projects/{projectsId}/publishers/{publishersId}/models/{modelsId}:enableModel", "path": "v1beta1/{+parent}/{+name}:enableModel" } } } } } } }, "apps": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/apps/{appsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.apps.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^apps/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "list": { "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "type": "string", "pattern": "^apps/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/apps/{appsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "id": "aiplatform.apps.operations.list" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/apps/{appsId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "name": { "pattern": "^apps/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string" }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" } }, "id": "aiplatform.apps.operations.wait", "path": "v1beta1/{+name}:wait" }, "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.apps.operations.get", "flatPath": "v1beta1/apps/{appsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "pattern": "^apps/[^/]+/operations/[^/]+$", "location": "path", "required": true } } }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^apps/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.apps.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/apps/{appsId}/operations/{operationsId}:cancel" } } } } }, "evaluationSets": { "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^evaluationSets/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/evaluationSets/{evaluationSetsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.evaluationSets.operations.delete" }, "list": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/evaluationSets/{evaluationSetsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^evaluationSets/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.evaluationSets.operations.list" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^evaluationSets/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "id": "aiplatform.evaluationSets.operations.wait", "flatPath": "v1beta1/evaluationSets/{evaluationSetsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "get": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^evaluationSets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/evaluationSets/{evaluationSetsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.evaluationSets.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "modelDeploymentMonitoringJobs": { "resources": { "operations": { "methods": { "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "flatPath": "v1beta1/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "id": "aiplatform.modelDeploymentMonitoringJobs.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "pattern": "^modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "httpMethod": "GET", "flatPath": "v1beta1/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}", "id": "aiplatform.modelDeploymentMonitoringJobs.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "parameterOrder": [ "name" ], "id": "aiplatform.modelDeploymentMonitoringJobs.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations", "parameters": { "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^modelDeploymentMonitoringJobs/[^/]+$" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1beta1/{+name}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.modelDeploymentMonitoringJobs.operations.wait", "parameters": { "name": { "pattern": "^modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}:wait" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/modelDeploymentMonitoringJobs/{modelDeploymentMonitoringJobsId}/operations/{operationsId}", "id": "aiplatform.modelDeploymentMonitoringJobs.operations.delete", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^modelDeploymentMonitoringJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." } } } } }, "models": { "resources": { "operations": { "methods": { "get": { "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^models/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "httpMethod": "GET", "id": "aiplatform.models.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/models/{modelsId}/operations/{operationsId}", "path": "v1beta1/{+name}" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^models/[^/]+/operations/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/models/{modelsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.models.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "list": { "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "name": { "location": "path", "required": true, "pattern": "^models/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "id": "aiplatform.models.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/models/{modelsId}/operations" }, "wait": { "id": "aiplatform.models.operations.wait", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/models/{modelsId}/operations/{operationsId}:wait", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^models/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^models/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "id": "aiplatform.models.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/models/{modelsId}/operations/{operationsId}" } } }, "evaluations": { "resources": { "operations": { "methods": { "get": { "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "id": "aiplatform.models.evaluations.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}", "id": "aiplatform.models.evaluations.operations.delete", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "httpMethod": "DELETE" }, "list": { "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^models/[^/]+/evaluations/[^/]+$" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" } }, "id": "aiplatform.models.evaluations.operations.list", "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/models/{modelsId}/evaluations/{evaluationsId}/operations" }, "wait": { "id": "aiplatform.models.evaluations.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" }, "name": { "type": "string", "pattern": "^models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "POST" }, "cancel": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/models/{modelsId}/evaluations/{evaluationsId}/operations/{operationsId}:cancel", "id": "aiplatform.models.evaluations.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^models/[^/]+/evaluations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "httpMethod": "POST" } } } } } } }, "extensionControllers": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.extensionControllers.operations.list", "flatPath": "v1beta1/extensionControllers/{extensionControllersId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "pattern": "^extensionControllers/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "flatPath": "v1beta1/extensionControllers/{extensionControllersId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.extensionControllers.operations.wait", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "location": "query", "format": "google-duration", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "pattern": "^extensionControllers/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST" }, "delete": { "parameters": { "name": { "pattern": "^extensionControllers/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/extensionControllers/{extensionControllersId}/operations/{operationsId}", "path": "v1beta1/{+name}", "id": "aiplatform.extensionControllers.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "cancel": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/extensionControllers/{extensionControllersId}/operations/{operationsId}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^extensionControllers/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.extensionControllers.operations.cancel", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/extensionControllers/{extensionControllersId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^extensionControllers/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.extensionControllers.operations.get", "parameterOrder": [ "name" ] } } } } }, "evaluationItems": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/evaluationItems/{evaluationItemsId}/operations/{operationsId}", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^evaluationItems/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string" } }, "parameterOrder": [ "name" ], "id": "aiplatform.evaluationItems.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^evaluationItems/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/evaluationItems/{evaluationItemsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.evaluationItems.operations.get", "path": "v1beta1/{+name}" }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.evaluationItems.operations.list", "flatPath": "v1beta1/evaluationItems/{evaluationItemsId}/operations", "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "pattern": "^evaluationItems/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" } }, "parameterOrder": [ "name" ] }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.evaluationItems.operations.wait", "parameters": { "name": { "pattern": "^evaluationItems/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/evaluationItems/{evaluationItemsId}/operations/{operationsId}:wait" } } } } }, "customJobs": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.customJobs.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/customJobs/{customJobsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^customJobs/[^/]+$", "type": "string" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^customJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "id": "aiplatform.customJobs.operations.wait", "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/customJobs/{customJobsId}/operations/{operationsId}:wait" }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.customJobs.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^customJobs/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/customJobs/{customJobsId}/operations/{operationsId}" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.customJobs.operations.cancel", "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^customJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "flatPath": "v1beta1/customJobs/{customJobsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "flatPath": "v1beta1/customJobs/{customJobsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.customJobs.operations.get", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^customJobs/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}" } } } } }, "evaluationMetrics": { "resources": { "operations": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/evaluationMetrics/{evaluationMetricsId}/operations/{operationsId}", "id": "aiplatform.evaluationMetrics.operations.delete", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^evaluationMetrics/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted." } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.evaluationMetrics.operations.list", "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true, "pattern": "^evaluationMetrics/[^/]+$" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/evaluationMetrics/{evaluationMetricsId}/operations" }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.evaluationMetrics.operations.get", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^evaluationMetrics/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/evaluationMetrics/{evaluationMetricsId}/operations/{operationsId}" } } } } }, "metadataStores": { "resources": { "operations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "name": { "pattern": "^metadataStores/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" } }, "flatPath": "v1beta1/metadataStores/{metadataStoresId}/operations", "id": "aiplatform.metadataStores.operations.list", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/operations/{operationsId}:wait", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^metadataStores/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string", "location": "query" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.metadataStores.operations.wait" }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^metadataStores/[^/]+/operations/[^/]+$" } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.metadataStores.operations.get" }, "cancel": { "parameterOrder": [ "name" ], "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^metadataStores/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.metadataStores.operations.cancel", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.metadataStores.operations.delete", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^metadataStores/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" } } } }, "executions": { "resources": { "operations": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.metadataStores.executions.operations.delete", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string" } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.metadataStores.executions.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "pattern": "^metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "id": "aiplatform.metadataStores.executions.operations.cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "flatPath": "v1beta1/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.metadataStores.executions.operations.list", "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "name": { "pattern": "^metadataStores/[^/]+/executions/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/executions/{executionsId}/operations", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "wait": { "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string", "pattern": "^metadataStores/[^/]+/executions/[^/]+/operations/[^/]+$" }, "timeout": { "location": "query", "format": "google-duration", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "id": "aiplatform.metadataStores.executions.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/metadataStores/{metadataStoresId}/executions/{executionsId}/operations/{operationsId}:wait" } } } } }, "artifacts": { "resources": { "operations": { "methods": { "list": { "parameterOrder": [ "name" ], "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^metadataStores/[^/]+/artifacts/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.metadataStores.artifacts.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.metadataStores.artifacts.operations.wait", "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "pattern": "^metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string" } } }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}:cancel", "id": "aiplatform.metadataStores.artifacts.operations.cancel", "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "pattern": "^metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "path": "v1beta1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$", "type": "string" } }, "flatPath": "v1beta1/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.metadataStores.artifacts.operations.get" }, "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.metadataStores.artifacts.operations.delete", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^metadataStores/[^/]+/artifacts/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/metadataStores/{metadataStoresId}/artifacts/{artifactsId}/operations/{operationsId}" } } } } }, "contexts": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}", "id": "aiplatform.metadataStores.contexts.operations.delete", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string", "pattern": "^metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^metadataStores/[^/]+/contexts/[^/]+$", "type": "string" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "id": "aiplatform.metadataStores.contexts.operations.list" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}:wait", "parameters": { "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "id": "aiplatform.metadataStores.contexts.operations.wait", "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.metadataStores.contexts.operations.get", "httpMethod": "GET", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^metadataStores/[^/]+/contexts/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/metadataStores/{metadataStoresId}/contexts/{contextsId}/operations/{operationsId}:cancel", "id": "aiplatform.metadataStores.contexts.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." } } } } } } }, "vertexExpress": { "resources": { "Eligibility": { "methods": { "check": { "description": "Checks whether the user is eligible to sign up for Vertex AI Express Mode.", "id": "aiplatform.vertexExpress.Eligibility.check", "parameterOrder": [], "path": "v1beta1/vertexExpress/Eligibility:check", "parameters": {}, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1CheckSignUpEligibilityResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/vertexExpress/Eligibility:check" } } } }, "methods": { "retrieveExpressProject": { "id": "aiplatform.vertexExpress.retrieveExpressProject", "description": "Retrieves the project for Vertex AI Express Mode.", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveExpressProjectResponse" }, "parameterOrder": [], "flatPath": "v1beta1/vertexExpress:retrieveExpressProject", "parameters": { "getDefaultApiKey": { "description": "Optional. Whether to return the default API key string in the response.", "type": "boolean", "location": "query" } }, "path": "v1beta1/vertexExpress:retrieveExpressProject", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "signUp": { "parameterOrder": [], "parameters": {}, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1ExpressProject" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1SignUpRequest" }, "description": "Signs up the user for Vertex AI Express Mode. If the user is already signed up, the existing ExpressProject will be returned.", "path": "v1beta1/vertexExpress:signUp", "flatPath": "v1beta1/vertexExpress:signUp", "id": "aiplatform.vertexExpress.signUp" } } }, "migratableResources": { "resources": { "operations": { "methods": { "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "name": { "pattern": "^migratableResources/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "id": "aiplatform.migratableResources.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/migratableResources/{migratableResourcesId}/operations" }, "wait": { "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^migratableResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.migratableResources.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/migratableResources/{migratableResourcesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait" }, "delete": { "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^migratableResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/migratableResources/{migratableResourcesId}/operations/{operationsId}", "id": "aiplatform.migratableResources.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" } }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^migratableResources/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "id": "aiplatform.migratableResources.operations.cancel", "flatPath": "v1beta1/migratableResources/{migratableResourcesId}/operations/{operationsId}:cancel" }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^migratableResources/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/migratableResources/{migratableResourcesId}/operations/{operationsId}", "id": "aiplatform.migratableResources.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "trainingPipelines": { "resources": { "operations": { "methods": { "cancel": { "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^trainingPipelines/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}:cancel", "id": "aiplatform.trainingPipelines.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "description": "The standard list page size.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "pattern": "^trainingPipelines/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" } }, "httpMethod": "GET", "id": "aiplatform.trainingPipelines.operations.list", "flatPath": "v1beta1/trainingPipelines/{trainingPipelinesId}/operations" }, "wait": { "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.trainingPipelines.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^trainingPipelines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}", "id": "aiplatform.trainingPipelines.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^trainingPipelines/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ] }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.trainingPipelines.operations.delete", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "flatPath": "v1beta1/trainingPipelines/{trainingPipelinesId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^trainingPipelines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } } } } } } }, "featureGroups": { "resources": { "features": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.featureGroups.features.operations.delete", "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^featureGroups/[^/]+/features/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameters": { "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^featureGroups/[^/]+/features/[^/]+$", "location": "path", "required": true }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "format": "int32", "type": "integer" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featureGroups/{featureGroupsId}/features/{featuresId}/operations", "id": "aiplatform.featureGroups.features.operations.list", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" }, "name": { "pattern": "^featureGroups/[^/]+/features/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "id": "aiplatform.featureGroups.features.operations.wait" }, "get": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^featureGroups/[^/]+/features/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/featureGroups/{featureGroupsId}/features/{featuresId}/operations/{operationsId}", "httpMethod": "GET", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.featureGroups.features.operations.get" } } } } }, "featureMonitors": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.featureGroups.featureMonitors.operations.delete", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.featureGroups.featureMonitors.operations.get", "flatPath": "v1beta1/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "flatPath": "v1beta1/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^featureGroups/[^/]+/featureMonitors/[^/]+$" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "id": "aiplatform.featureGroups.featureMonitors.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "aiplatform.featureGroups.featureMonitors.operations.wait", "flatPath": "v1beta1/featureGroups/{featureGroupsId}/featureMonitors/{featureMonitorsId}/operations/{operationsId}:wait", "parameters": { "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "pattern": "^featureGroups/[^/]+/featureMonitors/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "operations": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/featureGroups/{featureGroupsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^featureGroups/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.featureGroups.operations.delete" }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^featureGroups/[^/]+$" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." } }, "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/featureGroups/{featureGroupsId}/operations", "parameterOrder": [ "name" ], "id": "aiplatform.featureGroups.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/featureGroups/{featureGroupsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.featureGroups.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^featureGroups/[^/]+/operations/[^/]+$" } } }, "wait": { "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^featureGroups/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "id": "aiplatform.featureGroups.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featureGroups/{featureGroupsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait" } } } } }, "semanticGovernancePolicies": { "resources": { "operations": { "methods": { "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.semanticGovernancePolicies.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^semanticGovernancePolicies/[^/]+$", "type": "string", "location": "path", "required": true }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations" }, "wait": { "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^semanticGovernancePolicies/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.semanticGovernancePolicies.operations.wait", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ] }, "delete": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.semanticGovernancePolicies.operations.delete", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^semanticGovernancePolicies/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}", "httpMethod": "DELETE" }, "cancel": { "parameterOrder": [ "name" ], "id": "aiplatform.semanticGovernancePolicies.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^semanticGovernancePolicies/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^semanticGovernancePolicies/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "id": "aiplatform.semanticGovernancePolicies.operations.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1beta1/{+name}", "flatPath": "v1beta1/semanticGovernancePolicies/{semanticGovernancePoliciesId}/operations/{operationsId}" } } } } }, "deploymentResourcePools": { "resources": { "operations": { "methods": { "delete": { "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.deploymentResourcePools.operations.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^deploymentResourcePools/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}" }, "list": { "flatPath": "v1beta1/deploymentResourcePools/{deploymentResourcePoolsId}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.deploymentResourcePools.operations.list", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^deploymentResourcePools/[^/]+$", "location": "path", "required": true } } }, "wait": { "flatPath": "v1beta1/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "id": "aiplatform.deploymentResourcePools.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^deploymentResourcePools/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" } } }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.deploymentResourcePools.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^deploymentResourcePools/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "POST" }, "get": { "id": "aiplatform.deploymentResourcePools.operations.get", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^deploymentResourcePools/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/deploymentResourcePools/{deploymentResourcePoolsId}/operations/{operationsId}" } } } } }, "reasoningEngines": { "methods": { "executeCode": { "id": "aiplatform.reasoningEngines.executeCode", "path": "v1beta1/{+name}:executeCode", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}:executeCode", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteCodeResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteCodeRequest" }, "parameterOrder": [ "name" ], "description": "Executes code statelessly.", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string" } } }, "delete": { "id": "aiplatform.reasoningEngines.delete", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a reasoning engine.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The name of the ReasoningEngine resource to be deleted. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "force": { "type": "boolean", "description": "Optional. If set to true, child resources of this reasoning engine will also be deleted. Otherwise, the request will fail with FAILED_PRECONDITION error when the reasoning engine has undeleted child resources.", "location": "query" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}", "response": { "$ref": "GoogleLongrunningOperation" } }, "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Identifier. The resource name of the ReasoningEngine. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "updateMask": { "type": "string", "description": "Optional. Mask specifying which fields to update.", "format": "google-fieldmask", "location": "query" } }, "description": "Updates a reasoning engine.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}", "id": "aiplatform.reasoningEngines.patch", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" } }, "query": { "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse" }, "path": "v1beta1/{+name}:query", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Queries using a reasoning engine.", "request": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}:query", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "id": "aiplatform.reasoningEngines.query" }, "list": { "flatPath": "v1beta1/reasoningEngines", "id": "aiplatform.reasoningEngines.list", "description": "Lists reasoning engines in a location.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "location": "query", "description": "Required. The resource name of the Location to list the ReasoningEngines from. Format: `projects/{project}/locations/{location}`", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160)." }, "pageSize": { "type": "integer", "description": "Optional. The standard list page size.", "location": "query", "format": "int32" }, "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" } }, "parameterOrder": [], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListReasoningEnginesResponse" }, "path": "v1beta1/reasoningEngines" }, "streamQuery": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest" }, "response": { "$ref": "GoogleApiHttpBody" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "path": "v1beta1/{+name}:streamQuery", "description": "Streams queries using a reasoning engine.", "id": "aiplatform.reasoningEngines.streamQuery", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}:streamQuery" }, "create": { "id": "aiplatform.reasoningEngines.create", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/reasoningEngines", "parameters": { "parent": { "type": "string", "location": "query", "description": "Required. The resource name of the Location to create the ReasoningEngine in. Format: `projects/{project}/locations/{location}`" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [], "request": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" }, "flatPath": "v1beta1/reasoningEngines", "description": "Creates a reasoning engine." }, "cancelAsyncQuery": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}:cancelAsyncQuery", "id": "aiplatform.reasoningEngines.cancelAsyncQuery", "request": { "$ref": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineRequest" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineResponse" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "description": "Cancels an AsyncQueryReasoningEngine operation.", "path": "v1beta1/{+name}:cancelAsyncQuery" }, "asyncQuery": { "request": { "$ref": "GoogleCloudAiplatformV1beta1AsyncQueryReasoningEngineRequest" }, "parameterOrder": [ "name" ], "description": "Async query using a reasoning engine.", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}:asyncQuery", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:asyncQuery", "id": "aiplatform.reasoningEngines.asyncQuery", "parameters": { "name": { "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "type": "string" } }, "httpMethod": "POST" }, "get": { "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the ReasoningEngine resource. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" }, "description": "Gets a reasoning engine.", "id": "aiplatform.reasoningEngines.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } }, "resources": { "memories": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.reasoningEngines.memories.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "id": "aiplatform.reasoningEngines.memories.operations.wait", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.reasoningEngines.memories.operations.cancel" }, "delete": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.memories.operations.delete", "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } } }, "get": { "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.reasoningEngines.memories.operations.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/operations/{operationsId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "revisions": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1MemoryRevision" }, "description": "Get a Memory Revision.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/revisions/{revisionsId}", "parameters": { "name": { "description": "Required. The resource name of the Memory Revision to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}/revisions/{revision}`", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/memories/[^/]+/revisions/[^/]+$", "type": "string" } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.memories.revisions.get", "path": "v1beta1/{+name}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "type": "integer", "description": "Optional. The standard list page size.", "location": "query", "format": "int32" }, "parent": { "description": "Required. The resource name of the Memory to list revisions for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`", "type": "string", "location": "query" } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.memories.revisions.list", "description": "List Memory Revisions for a Memory.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse" }, "path": "v1beta1/{+parent}/revisions", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}/revisions", "parameterOrder": [ "parent" ] } } } }, "methods": { "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoriesResponse" }, "parameterOrder": [ "parent" ], "id": "aiplatform.reasoningEngines.memories.list", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories", "description": "List Memories.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" }, "parent": { "type": "string", "description": "Required. The resource name of the ReasoningEngine to list the Memories under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true }, "orderBy": { "type": "string", "location": "query", "description": "Optional. The standard list order by string. If not specified, the default order is `create_time desc`. If specified, the default sorting order of provided fields is ascending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time`" }, "filter": { "location": "query", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `scope` (as a JSON string with equality match only) * `topics` (i.e. `topics.custom_memory_topic_label: \"example topic\" OR topics.managed_memory_topic: USER_PREFERENCES`)", "type": "string" }, "pageSize": { "format": "int32", "description": "Optional. The standard list page size.", "location": "query", "type": "integer" } }, "path": "v1beta1/{+parent}/memories" }, "generate": { "path": "v1beta1/{+parent}/memories:generate", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories:generate", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest" }, "description": "Generate memories.", "id": "aiplatform.reasoningEngines.memories.generate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to generate memories for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } } }, "create": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Create a Memory.", "parameterOrder": [ "parent" ], "id": "aiplatform.reasoningEngines.memories.create", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to create the Memory under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "memoryId": { "location": "query", "description": "Optional. The user defined ID to use for memory, which will become the final component of the memory resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character must be a letter, and the last character must be a letter or number.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+parent}/memories" }, "patch": { "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "type": "string", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$" }, "updateMask": { "description": "Optional. Mask specifying which fields to update. The following fields are immutable: * `scope` * `memory_type`", "format": "google-fieldmask", "type": "string", "location": "query" } }, "parameterOrder": [ "name" ], "description": "Update a Memory.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "id": "aiplatform.reasoningEngines.memories.patch", "response": { "$ref": "GoogleLongrunningOperation" } }, "retrieve": { "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest" }, "id": "aiplatform.reasoningEngines.memories.retrieve", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories:retrieve", "description": "Retrieve memories.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ReasoningEngine to retrieve memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$" } }, "path": "v1beta1/{+parent}/memories:retrieve", "httpMethod": "POST", "parameterOrder": [ "parent" ] }, "purge": { "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories:purge", "httpMethod": "POST", "description": "Purge memories.", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to purge memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.memories.purge", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories:purge" }, "rollback": { "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.memories.rollback", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Memory to rollback. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RollbackMemoryRequest" }, "httpMethod": "POST", "path": "v1beta1/{+name}:rollback", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}:rollback", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Rollback Memory to a specific revision." }, "retrieveProfiles": { "description": "Retrieves profiles.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.memories.retrieveProfiles", "path": "v1beta1/{+parent}/memories:retrieveProfiles", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories:retrieveProfiles", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest" }, "httpMethod": "POST", "parameters": { "parent": { "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to retrieve profiles from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } } }, "ingestEvents": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories:ingestEvents", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the ReasoningEngine to ingest events to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Ingests events for a Memory Bank.", "path": "v1beta1/{+parent}/memories:ingestEvents", "request": { "$ref": "GoogleCloudAiplatformV1beta1IngestEventsRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.memories.ingestEvents" }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$", "description": "Required. The resource name of the Memory to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "path": "v1beta1/{+name}", "description": "Delete a Memory.", "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.memories.delete" }, "get": { "id": "aiplatform.reasoningEngines.memories.get", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^reasoningEngines/[^/]+/memories/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Get a Memory.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/memories/{memoriesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1Memory" } } } }, "sandboxEnvironmentTemplates": { "methods": { "get": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}", "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment template. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "description": "Gets details of the specific SandboxEnvironmentTemplate.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "delete": { "description": "Deletes the specific SandboxEnvironmentTemplate.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}", "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.delete", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the SandboxEnvironmentTemplate to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}" }, "list": { "httpMethod": "GET", "parameterOrder": [ "parent" ], "parameters": { "pageSize": { "description": "Optional. The maximum number of SandboxEnvironmentTemplates to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironmentTemplates will be returned.", "type": "integer", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironmentTemplates` call. Provide this to retrieve the subsequent page.", "location": "query" }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the reasoning engine to list sandbox environment templates from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$", "type": "string" }, "filter": { "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.list", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates", "description": "Lists SandboxEnvironmentTemplates in a given reasoning engine.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentTemplatesResponse" }, "path": "v1beta1/{+parent}/sandboxEnvironmentTemplates" }, "create": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.create", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates", "description": "Creates a SandboxEnvironmentTemplate in a given reasoning engine.", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the reasoning engine to create the SandboxEnvironmentTemplate in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`." } }, "path": "v1beta1/{+parent}/sandboxEnvironmentTemplates", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate" } } }, "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.operations.cancel", "path": "v1beta1/{+name}:cancel" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.operations.list", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "location": "query", "description": "The standard list page size.", "type": "integer", "format": "int32" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+$", "description": "The name of the operation's parent resource." } }, "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.operations.wait", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.operations.get", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "delete": { "httpMethod": "DELETE", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentTemplates/{sandboxEnvironmentTemplatesId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentTemplates/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.reasoningEngines.sandboxEnvironmentTemplates.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}" } } } } }, "sandboxEnvironmentSnapshots": { "methods": { "delete": { "parameterOrder": [ "name" ], "description": "Deletes the specific SandboxEnvironmentSnapshot.", "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the SandboxEnvironmentSnapshot to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}" }, "list": { "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists SandboxEnvironmentSnapshots in a given reasoning engine.", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentSnapshotsResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1beta1/{+parent}/sandboxEnvironmentSnapshots", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots", "parameters": { "pageToken": { "location": "query", "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironmentSnapshots` call. Provide this to retrieve the subsequent page.", "type": "string" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of SandboxEnvironmentSnapshots to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironmentSnapshots will be returned. Values above 100 will be coerced to 100.", "format": "int32", "location": "query" }, "parent": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The resource name of the reasoning engine to list sandbox environments from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "filter": { "location": "query", "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160)." } } }, "get": { "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "type": "string", "description": "Required. The resource name of the sandbox environment snapshot. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Gets details of the specific SandboxEnvironmentSnapshot." } }, "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}:cancel", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}:cancel", "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.operations.cancel" }, "get": { "httpMethod": "GET", "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.operations.get", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}" }, "list": { "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+$", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.reasoningEngines.sandboxEnvironmentSnapshots.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sandboxEnvironmentSnapshots/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration" } }, "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironmentSnapshots/{sandboxEnvironmentSnapshotsId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } } } }, "operations": { "methods": { "get": { "id": "aiplatform.reasoningEngines.operations.get", "httpMethod": "GET", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } } }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/operations" }, "wait": { "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "pattern": "^reasoningEngines/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}:wait", "id": "aiplatform.reasoningEngines.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.operations.delete", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" } } } }, "examples": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.examples.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "location": "path", "required": true } } }, "get": { "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.examples.operations.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } }, "wait": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on." }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.reasoningEngines.examples.operations.wait", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/examples/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.reasoningEngines.examples.operations.cancel", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/examples/{examplesId}/operations/{operationsId}:cancel" } } } } }, "runtimeRevisions": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "description": "The name of the operation's parent resource." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "format": "int32", "location": "query" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "aiplatform.reasoningEngines.runtimeRevisions.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.runtimeRevisions.operations.get", "parameterOrder": [ "name" ] }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "id": "aiplatform.reasoningEngines.runtimeRevisions.operations.delete", "httpMethod": "DELETE" } } }, "a2a": { "resources": { "tasks": { "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameters": { "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" }, "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$" } }, "httpMethod": "GET" } } } }, "methods": { "pushNotificationConfigs": { "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks.pushNotificationConfigs", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}/pushNotificationConfigs", "parameters": { "a2aEndpoint": { "pattern": "^tasks/[^/]+/pushNotificationConfigs$", "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." } }, "httpMethod": "GET" }, "subscribe": { "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks.subscribe", "httpMethod": "GET", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "pattern": "^tasks/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`.", "type": "string" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string" } }, "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}:subscribe", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "$ref": "GoogleApiHttpBody" } }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks.cancel", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}:cancel", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "type": "string", "pattern": "^tasks/[^/]+$", "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "httpMethod": "POST", "description": "Send post request for reasoning engine instance via the A2A post protocol apis." }, "a2aGetReasoningEngine": { "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks.a2aGetReasoningEngine", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks/{tasksId}", "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "pattern": "^tasks/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis." } } }, "message": { "methods": { "stream": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/message:stream", "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "POST", "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream.", "pattern": "^message$", "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.message.stream" }, "send": { "request": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.message.send", "httpMethod": "POST", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^message$" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/message:send", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "parameterOrder": [ "name", "a2aEndpoint" ] } } }, "v1": { "methods": { "card": { "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" }, "a2aEndpoint": { "pattern": "^v1/card$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.card", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/card", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" } }, "tasks": { "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" }, "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks$", "location": "path", "required": true }, "name": { "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis." }, "extendedAgentCard": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/extendedAgentCard", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^v1/extendedAgentCard$", "type": "string" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "httpMethod": "GET", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.extendedAgentCard", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ] } }, "resources": { "message": { "methods": { "stream": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/message:stream", "httpMethod": "POST", "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.message.stream", "parameters": { "a2aEndpoint": { "pattern": "^v1/message$", "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream." }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "response": { "$ref": "GoogleApiHttpBody" }, "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream" }, "send": { "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/message:send", "parameterOrder": [ "name", "a2aEndpoint" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.message.send", "parameters": { "a2aEndpoint": { "pattern": "^v1/message$", "location": "path", "required": true, "type": "string", "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "tasks": { "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string" }, "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "description": "Get request for reasoning engine instance via the A2A get protocol apis." } } } }, "methods": { "cancel": { "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks.cancel", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^v1/tasks/[^/]+$", "type": "string" }, "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}:cancel" }, "subscribe": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks.subscribe", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "a2aEndpoint": { "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`.", "pattern": "^v1/tasks/[^/]+$" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}:subscribe", "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "response": { "$ref": "GoogleApiHttpBody" } }, "pushNotificationConfigs": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs$", "location": "path", "required": true, "type": "string" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks.pushNotificationConfigs", "description": "Get request for reasoning engine instance via the A2A get protocol apis." }, "a2aGetReasoningEngine": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+$" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.v1.tasks.a2aGetReasoningEngine", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/v1/tasks/{tasksId}", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis." } } } } } }, "methods": { "tasks": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/tasks", "parameterOrder": [ "name", "a2aEndpoint" ], "httpMethod": "GET", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^tasks$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.tasks", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" }, "extendedAgentCard": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/extendedAgentCard", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "httpMethod": "GET", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^extendedAgentCard$", "type": "string" }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.extendedAgentCard", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ] }, "card": { "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "httpMethod": "GET", "parameters": { "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^card$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string" }, "name": { "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$" } }, "id": "aiplatform.reasoningEngines.runtimeRevisions.a2a.card", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}/a2a/card", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" } } } } }, "methods": { "streamQuery": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest" }, "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string" } }, "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.runtimeRevisions.streamQuery", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+name}:streamQuery", "description": "Streams queries using a reasoning engine.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}:streamQuery" }, "query": { "description": "Queries using a reasoning engine.", "id": "aiplatform.reasoningEngines.runtimeRevisions.query", "path": "v1beta1/{+name}:query", "response": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/runtimeRevisions/{runtimeRevisionsId}:query", "request": { "$ref": "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/runtimeRevisions/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the ReasoningEngine resource to use. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "httpMethod": "POST" } } }, "a2a": { "resources": { "tasks": { "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "parameters": { "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^tasks/[^/]+/pushNotificationConfigs/[^/]+$", "type": "string" }, "name": { "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.a2a.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" } } } }, "methods": { "cancel": { "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "id": "aiplatform.reasoningEngines.a2a.tasks.cancel", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL." }, "a2aEndpoint": { "type": "string", "pattern": "^tasks/[^/]+$", "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "location": "path", "required": true } }, "httpMethod": "POST", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}:cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "a2aGetReasoningEngine": { "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.reasoningEngines.a2a.tasks.a2aGetReasoningEngine", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}", "parameters": { "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" }, "a2aEndpoint": { "type": "string", "pattern": "^tasks/[^/]+$", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "name": { "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$", "type": "string" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "httpMethod": "GET", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" } }, "subscribe": { "parameterOrder": [ "name", "a2aEndpoint" ], "httpMethod": "GET", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "pattern": "^tasks/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`." }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}:subscribe", "id": "aiplatform.reasoningEngines.a2a.tasks.subscribe", "response": { "$ref": "GoogleApiHttpBody" } }, "pushNotificationConfigs": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "id": "aiplatform.reasoningEngines.a2a.tasks.pushNotificationConfigs", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks/{tasksId}/pushNotificationConfigs", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "a2aEndpoint": { "type": "string", "pattern": "^tasks/[^/]+/pushNotificationConfigs$", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`" }, "name": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis." } } }, "message": { "methods": { "send": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/message:send", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "location": "path", "required": true }, "a2aEndpoint": { "location": "path", "required": true, "type": "string", "pattern": "^message$", "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send" } }, "httpMethod": "POST", "id": "aiplatform.reasoningEngines.a2a.message.send", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send" }, "stream": { "id": "aiplatform.reasoningEngines.a2a.message.stream", "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "$ref": "GoogleApiHttpBody" }, "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parameters": { "name": { "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "type": "string", "pattern": "^reasoningEngines/[^/]+$" }, "a2aEndpoint": { "pattern": "^message$", "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/message:stream", "httpMethod": "POST", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream" } } }, "v1": { "methods": { "extendedAgentCard": { "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/extendedAgentCard", "id": "aiplatform.reasoningEngines.a2a.v1.extendedAgentCard", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^v1/extendedAgentCard$", "location": "path", "required": true } }, "httpMethod": "GET" }, "card": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." }, "a2aEndpoint": { "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^v1/card$", "type": "string" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/card", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.reasoningEngines.a2a.v1.card", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } } }, "tasks": { "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameters": { "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" }, "a2aEndpoint": { "pattern": "^v1/tasks$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "location": "path", "required": true }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$" } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.a2a.v1.tasks", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks" } }, "resources": { "tasks": { "methods": { "subscribe": { "id": "aiplatform.reasoningEngines.a2a.v1.tasks.subscribe", "response": { "$ref": "GoogleApiHttpBody" }, "httpMethod": "GET", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The full resource path of the reasoning engine, captured from the URL." }, "a2aEndpoint": { "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+$", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123:subscribe`.", "type": "string" } }, "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}:subscribe", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:subscribe", "description": "Stream get request for reasoning engine instance via the A2A stream get protocol apis." }, "pushNotificationConfigs": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs$" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query", "type": "string" }, "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.reasoningEngines.a2a.v1.tasks.pushNotificationConfigs", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" }, "cancel": { "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "id": "aiplatform.reasoningEngines.a2a.v1.tasks.cancel", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}:cancel", "response": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "httpMethod": "POST", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL." }, "a2aEndpoint": { "pattern": "^v1/tasks/[^/]+$", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:cancel" }, "a2aGetReasoningEngine": { "response": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}", "parameterOrder": [ "name", "a2aEndpoint" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.a2a.v1.tasks.a2aGetReasoningEngine", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "a2aEndpoint": { "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true, "pattern": "^v1/tasks/[^/]+$" }, "historyLength": { "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string", "location": "query" } }, "httpMethod": "GET" } }, "resources": { "pushNotificationConfigs": { "methods": { "a2aGetReasoningEngine": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name", "a2aEndpoint" ], "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.reasoningEngines.a2a.v1.tasks.pushNotificationConfigs.a2aGetReasoningEngine", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/tasks/{tasksId}/pushNotificationConfigs/{pushNotificationConfigsId}", "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^v1/tasks/[^/]+/pushNotificationConfigs/[^/]+$" }, "name": { "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true }, "historyLength": { "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "type": "string" } }, "httpMethod": "GET", "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}" } } } } }, "message": { "methods": { "send": { "request": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:send", "id": "aiplatform.reasoningEngines.a2a.v1.message.send", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/message:send", "httpMethod": "POST", "parameters": { "a2aEndpoint": { "type": "string", "location": "path", "required": true, "description": "Required. The a2a endpoint path, captured from the URL. e.g., v1/message:send", "pattern": "^v1/message$" }, "name": { "location": "path", "required": true, "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "pattern": "^reasoningEngines/[^/]+$" } }, "description": "Send post request for reasoning engine instance via the A2A post protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "stream": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/v1/message:stream", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.a2a.v1.message.stream", "response": { "$ref": "GoogleApiHttpBody" }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}:stream", "parameters": { "name": { "type": "string", "description": "Required. The full resource path of the reasoning engine, captured from the URL.", "pattern": "^reasoningEngines/[^/]+$", "location": "path", "required": true }, "a2aEndpoint": { "location": "path", "required": true, "type": "string", "description": "Required. The http endpoint extracted from the URL path. e.g., v1/message:stream.", "pattern": "^v1/message$" } }, "httpMethod": "POST", "request": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "description": "Streams queries using a reasoning engine instance via the A2A streaming protocol apis.", "parameterOrder": [ "name", "a2aEndpoint" ] } } } } } }, "methods": { "tasks": { "parameterOrder": [ "name", "a2aEndpoint" ], "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/tasks", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "a2aEndpoint": { "pattern": "^tasks$", "type": "string", "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "location": "path", "required": true }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "type": "string", "location": "query", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." } }, "id": "aiplatform.reasoningEngines.a2a.tasks", "httpMethod": "GET", "description": "Get request for reasoning engine instance via the A2A get protocol apis." }, "extendedAgentCard": { "parameterOrder": [ "name", "a2aEndpoint" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/extendedAgentCard", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "id": "aiplatform.reasoningEngines.a2a.extendedAgentCard", "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+$" }, "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^extendedAgentCard$" }, "historyLength": { "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned.", "location": "query" } } }, "card": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/a2a/card", "description": "Get request for reasoning engine instance via the A2A get protocol apis.", "path": "v1beta1/{+name}/a2a/{+a2aEndpoint}", "parameterOrder": [ "name", "a2aEndpoint" ], "parameters": { "a2aEndpoint": { "location": "path", "required": true, "description": "Required. The http endpoint extracted from the URL path. i.e. `v1/tasks/123`", "type": "string", "pattern": "^card$" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The full resource path of the reasoning engine, captured from the URL. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "historyLength": { "location": "query", "type": "string", "description": "Optional. The optional query parameter for the getTask endpoint. Mapped from \"?history_length=\". This indicates how many turns of history to return. If not set, the default value is 0, which means all the history will be returned." } }, "id": "aiplatform.reasoningEngines.a2a.card", "httpMethod": "GET" } } }, "sandboxEnvironments": { "methods": { "delete": { "parameterOrder": [ "name" ], "description": "Deletes the specific SandboxEnvironment.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "Required. The resource name of the SandboxEnvironment to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.sandboxEnvironments.delete", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "pause": { "parameterOrder": [ "name" ], "description": "Pauses the specific SandboxEnvironment.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironments.pause", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:pause", "path": "v1beta1/{+name}:pause", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1PauseSandboxEnvironmentRequest" }, "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource name of the sandbox environment to pause. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "type": "string" } } }, "bidiExecute": { "response": { "$ref": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:bidiExecute", "id": "aiplatform.reasoningEngines.sandboxEnvironments.bidiExecute", "description": "Executes using a sandbox environment with bidirectional streaming.", "request": { "$ref": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentRequest" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "path": "v1beta1/{+name}:bidiExecute", "httpMethod": "POST", "parameterOrder": [ "name" ] }, "authorizeAccess": { "response": { "$ref": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessResponse" }, "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to authorize access to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "description": "Checks whether the caller is authorized to access the sandbox environment. Authorization is performed entirely by the API infrastructure from the `method_policy` below; the handler is a no-op. A successful response means the caller holds `sandboxEnvironments.execute` on the named sandbox. Used by the sandbox data-plane proxy, which forwards the caller's credential and proxies traffic only on success.", "httpMethod": "POST", "id": "aiplatform.reasoningEngines.sandboxEnvironments.authorizeAccess", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:authorizeAccess", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:authorizeAccess", "request": { "$ref": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessRequest" } }, "get": { "description": "Gets details of the specific SandboxEnvironment.", "path": "v1beta1/{+name}", "id": "aiplatform.reasoningEngines.sandboxEnvironments.get", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "Required. The resource name of the sandbox environment. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "parameterOrder": [ "name" ] }, "resume": { "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1ResumeSandboxEnvironmentRequest" }, "path": "v1beta1/{+name}:resume", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:resume", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to resume. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Resumes the specific SandboxEnvironment.", "id": "aiplatform.reasoningEngines.sandboxEnvironments.resume", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "snapshot": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:snapshot", "httpMethod": "POST", "description": "Snapshots the specific SandboxEnvironment resource and creates a SandboxEnvironmentSnapshot resource.", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the sandbox environment to snapshot. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.sandboxEnvironments.snapshot", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:snapshot", "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot" } }, "list": { "description": "Lists SandboxEnvironments in a given reasoning engine.", "id": "aiplatform.reasoningEngines.sandboxEnvironments.list", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentsResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments", "parameters": { "pageSize": { "type": "integer", "location": "query", "description": "Optional. The maximum number of SandboxEnvironments to return. The service may return fewer than this value. If unspecified, at most 100 SandboxEnvironments will be returned.", "format": "int32" }, "parent": { "description": "Required. The resource name of the reasoning engine to list sandbox environments from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$" }, "filter": { "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" }, "pageToken": { "description": "Optional. The standard list page token, received from a previous `ListSandboxEnvironments` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" } }, "path": "v1beta1/{+parent}/sandboxEnvironments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "execute": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}:execute", "id": "aiplatform.reasoningEngines.sandboxEnvironments.execute", "path": "v1beta1/{+name}:execute", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentResponse" }, "httpMethod": "POST", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "type": "string", "description": "Required. The resource name of the sandbox environment to execute. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironments/{sandbox_environment}`", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentRequest" }, "description": "Executes using a sandbox environment.", "parameterOrder": [ "name" ] }, "create": { "description": "Creates a SandboxEnvironment in a given reasoning engine.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The resource name of the reasoning engine to create the SandboxEnvironment in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`.", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments", "path": "v1beta1/{+parent}/sandboxEnvironments", "id": "aiplatform.reasoningEngines.sandboxEnvironments.create", "request": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "response": { "$ref": "GoogleLongrunningOperation" } } }, "resources": { "operations": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironments.operations.get", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "id": "aiplatform.reasoningEngines.sandboxEnvironments.operations.delete", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "list": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" } }, "id": "aiplatform.reasoningEngines.sandboxEnvironments.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "wait": { "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}:wait", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironments.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "cancel": { "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sandboxEnvironments/{sandboxEnvironmentsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sandboxEnvironments.operations.cancel", "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/sandboxEnvironments/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST" } } } } }, "sessions": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.reasoningEngines.sessions.operations.cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}:cancel", "httpMethod": "POST" }, "list": { "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations", "httpMethod": "GET", "parameters": { "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sessions.operations.list" }, "wait": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "id": "aiplatform.reasoningEngines.sessions.operations.wait", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}:wait" }, "get": { "path": "v1beta1/{+name}", "id": "aiplatform.reasoningEngines.sessions.operations.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.reasoningEngines.sessions.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } } } } }, "events": { "methods": { "list": { "response": { "$ref": "GoogleCloudAiplatformV1beta1ListEventsResponse" }, "parameters": { "filter": { "description": "Optional. The standard list filter. Supported fields: * `timestamp` range (i.e. `timestamp\u003e=\"2025-01-31T11:30:00-04:00\"` where the timestamp is in RFC 3339 format) More detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `timestamp` Example: `timestamp desc`." }, "pageToken": { "type": "string", "location": "query", "description": "Optional. The next_page_token value returned from a previous list SessionService.ListEvents call." }, "pageSize": { "description": "Optional. The maximum number of events to return. The service may return fewer than this value. If unspecified, at most 100 events will be returned. These events are ordered by timestamp in ascending order.", "type": "integer", "format": "int32", "location": "query" }, "parent": { "type": "string", "description": "Required. The resource name of the session to list events from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$" } }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.reasoningEngines.sessions.events.list", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}/events", "description": "Lists Events in a given session.", "path": "v1beta1/{+parent}/events" } } } }, "methods": { "appendEvent": { "response": { "$ref": "GoogleCloudAiplatformV1beta1AppendEventResponse" }, "parameters": { "name": { "description": "Required. The resource name of the session to append event to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "type": "string", "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Appends an event to a given session.", "request": { "$ref": "GoogleCloudAiplatformV1beta1SessionEvent" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}:appendEvent", "id": "aiplatform.reasoningEngines.sessions.appendEvent", "path": "v1beta1/{+name}:appendEvent" }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "sessionId": { "location": "query", "type": "string", "description": "Optional. The user defined ID to use for session, which will become the final component of the session resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first and last characters must be a letter or number." }, "parent": { "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+$", "description": "Required. The resource name of the location to create the session in. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/sessions", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions", "id": "aiplatform.reasoningEngines.sessions.create", "description": "Creates a new Session.", "request": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the session. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$", "type": "string" } }, "httpMethod": "DELETE", "id": "aiplatform.reasoningEngines.sessions.delete", "description": "Deletes details of the specific Session.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}" }, "get": { "id": "aiplatform.reasoningEngines.sessions.get", "response": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}", "description": "Gets details of the specific Session.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the session. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`" } }, "httpMethod": "GET", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] }, "list": { "parameters": { "pageSize": { "type": "integer", "description": "Optional. The maximum number of sessions to return. The service may return fewer than this value. If unspecified, the default page size is 100. Values greater than 100 will be capped at 100.", "format": "int32", "location": "query" }, "parent": { "location": "path", "required": true, "description": "Required. The resource name of the location to list sessions from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "pattern": "^reasoningEngines/[^/]+$", "type": "string" }, "pageToken": { "location": "query", "description": "Optional. The next_page_token value returned from a previous list SessionService.ListSessions call.", "type": "string" }, "orderBy": { "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `create_time` * `update_time` Example: `create_time desc`.", "type": "string" }, "filter": { "description": "Optional. The standard list filter. Supported fields: * `display_name` * `user_id` * `labels` Example: `display_name=\"abc\"`, `user_id=\"123\"`, `labels.key=\"value\"`.", "location": "query", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListSessionsResponse" }, "id": "aiplatform.reasoningEngines.sessions.list", "parameterOrder": [ "parent" ], "description": "Lists Sessions in a given reasoning engine.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+parent}/sessions" }, "patch": { "request": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1Session" }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/sessions/{sessionsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "description": "Updates the specific Session.", "parameterOrder": [ "name" ], "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "description": "Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/sessions/[^/]+$" }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. Field mask is used to control which fields get updated. If the mask is not present, all fields will be updated.", "type": "string" } }, "id": "aiplatform.reasoningEngines.sessions.patch" } } }, "feedbackEntries": { "resources": { "operations": { "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+name}", "id": "aiplatform.reasoningEngines.feedbackEntries.operations.delete", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "id": "aiplatform.reasoningEngines.feedbackEntries.operations.list", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^reasoningEngines/[^/]+/feedbackEntries/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string", "location": "query" } }, "id": "aiplatform.reasoningEngines.feedbackEntries.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "get": { "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.reasoningEngines.feedbackEntries.operations.get" }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^reasoningEngines/[^/]+/feedbackEntries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "flatPath": "v1beta1/reasoningEngines/{reasoningEnginesId}/feedbackEntries/{feedbackEntriesId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.reasoningEngines.feedbackEntries.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } }, "solvers": { "resources": { "operations": { "methods": { "delete": { "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^solvers/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/solvers/{solversId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.solvers.operations.delete" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "id": "aiplatform.solvers.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/solvers/{solversId}/operations", "parameterOrder": [ "name" ], "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^solvers/[^/]+$", "location": "path", "required": true }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "httpMethod": "GET" }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^solvers/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "parameterOrder": [ "name" ], "id": "aiplatform.solvers.operations.get", "flatPath": "v1beta1/solvers/{solversId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "notebookRuntimeTemplates": { "resources": { "operations": { "methods": { "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^notebookRuntimeTemplates/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.notebookRuntimeTemplates.operations.get" }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^notebookRuntimeTemplates/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "id": "aiplatform.notebookRuntimeTemplates.operations.cancel", "flatPath": "v1beta1/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "id": "aiplatform.notebookRuntimeTemplates.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^notebookRuntimeTemplates/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1beta1/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^notebookRuntimeTemplates/[^/]+$", "description": "The name of the operation's parent resource." }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "id": "aiplatform.notebookRuntimeTemplates.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ] }, "wait": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^notebookRuntimeTemplates/[^/]+/operations/[^/]+$", "type": "string" }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.notebookRuntimeTemplates.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/notebookRuntimeTemplates/{notebookRuntimeTemplatesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "batchPredictionJobs": { "methods": { "create": { "flatPath": "v1beta1/batchPredictionJobs", "description": "Creates a BatchPredictionJob. A BatchPredictionJob once created will right away be attempted to start.", "parameterOrder": [], "httpMethod": "POST", "id": "aiplatform.batchPredictionJobs.create", "parameters": { "parent": { "description": "Required. The resource name of the Location to create the BatchPredictionJob in. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "query" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/batchPredictionJobs" }, "list": { "parameterOrder": [], "path": "v1beta1/batchPredictionJobs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/batchPredictionJobs", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListBatchPredictionJobsResponse" }, "description": "Lists BatchPredictionJobs in a Location.", "id": "aiplatform.batchPredictionJobs.list", "httpMethod": "GET", "parameters": { "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "readMask": { "location": "query", "format": "google-fieldmask", "description": "Mask specifying which fields to read.", "type": "string" }, "parent": { "description": "Required. The resource name of the Location to list the BatchPredictionJobs from. Format: `projects/{project}/locations/{location}`", "type": "string", "location": "query" }, "pageToken": { "location": "query", "description": "The standard list page token. Typically obtained via ListBatchPredictionJobsResponse.next_page_token of the previous JobService.ListBatchPredictionJobs call.", "type": "string" }, "filter": { "description": "The standard list filter. Supported fields: * `display_name` supports `=`, `!=` comparisons, and `:` wildcard. * `model_display_name` supports `=`, `!=` comparisons. * `state` supports `=`, `!=` comparisons. * `create_time` supports `=`, `!=`,`\u003c`, `\u003c=`,`\u003e`, `\u003e=` comparisons. `create_time` must be in RFC 3339 format. * `labels` supports general map functions that is: `labels.key=value` - key:value equality `labels.key:* - key existence Some examples of using the filter are: * `state=\"JOB_STATE_SUCCEEDED\" AND display_name:\"my_job_*\"` * `state!=\"JOB_STATE_FAILED\" OR display_name=\"my_job\"` * `NOT display_name=\"my_job\"` * `create_time\u003e\"2021-05-18T00:00:00Z\"` * `labels.keyA=valueA` * `labels.keyB:*`", "type": "string", "location": "query" } } }, "get": { "id": "aiplatform.batchPredictionJobs.get", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the BatchPredictionJob resource. Format: `projects/{project}/locations/{location}/batchPredictionJobs/{batch_prediction_job}`", "pattern": "^batchPredictionJobs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/batchPredictionJobs/{batchPredictionJobsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" }, "path": "v1beta1/{+name}", "description": "Gets a BatchPredictionJob" } } }, "taskStores": { "resources": { "operations": { "methods": { "list": { "parameters": { "name": { "location": "path", "required": true, "pattern": "^taskStores/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" } }, "flatPath": "v1beta1/taskStores/{taskStoresId}/operations", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.taskStores.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.taskStores.operations.wait", "path": "v1beta1/{+name}:wait", "parameters": { "name": { "pattern": "^taskStores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/taskStores/{taskStoresId}/operations/{operationsId}:wait" }, "delete": { "id": "aiplatform.taskStores.operations.delete", "flatPath": "v1beta1/taskStores/{taskStoresId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^taskStores/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE" }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/taskStores/{taskStoresId}/operations/{operationsId}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^taskStores/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.taskStores.operations.cancel" }, "get": { "path": "v1beta1/{+name}", "id": "aiplatform.taskStores.operations.get", "flatPath": "v1beta1/taskStores/{taskStoresId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^taskStores/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." } } } } }, "skills": { "resources": { "operations": { "methods": { "cancel": { "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.skills.operations.cancel", "flatPath": "v1beta1/skills/{skillsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^skills/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } } }, "delete": { "id": "aiplatform.skills.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/skills/{skillsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^skills/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "get": { "parameters": { "name": { "type": "string", "pattern": "^skills/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "path": "v1beta1/{+name}", "flatPath": "v1beta1/skills/{skillsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "id": "aiplatform.skills.operations.get" }, "list": { "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "description": "The standard list page size.", "format": "int32", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^skills/[^/]+$", "location": "path", "required": true }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/skills/{skillsId}/operations", "id": "aiplatform.skills.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "flatPath": "v1beta1/skills/{skillsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true, "pattern": "^skills/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "id": "aiplatform.skills.operations.wait" } } } } }, "memoryBanks": { "methods": { "ingestEvents": { "id": "aiplatform.memoryBanks.ingestEvents", "parameterOrder": [ "parent" ], "description": "Ingests events for a Memory Bank.", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}:ingestEvents", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1IngestEventsRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "pattern": "^memoryBanks/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to ingest events to. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "path": "v1beta1/{+parent}:ingestEvents", "httpMethod": "POST" } }, "resources": { "operations": { "methods": { "list": { "id": "aiplatform.memoryBanks.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^memoryBanks/[^/]+$", "location": "path", "required": true }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "httpMethod": "GET", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/operations", "parameterOrder": [ "name" ] }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/operations/{operationsId}:wait", "id": "aiplatform.memoryBanks.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^memoryBanks/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^memoryBanks/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.memoryBanks.operations.cancel", "httpMethod": "POST", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^memoryBanks/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "id": "aiplatform.memoryBanks.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ] }, "get": { "path": "v1beta1/{+name}", "httpMethod": "GET", "id": "aiplatform.memoryBanks.operations.get", "parameters": { "name": { "type": "string", "pattern": "^memoryBanks/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "memories": { "methods": { "get": { "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}", "description": "Get a Memory.", "response": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "parameterOrder": [ "name" ], "id": "aiplatform.memoryBanks.memories.get", "path": "v1beta1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^memoryBanks/[^/]+/memories/[^/]+$", "description": "Required. The resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "location": "path", "required": true } } }, "rollback": { "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}:rollback", "description": "Rollback Memory to a specific revision.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.memoryBanks.memories.rollback", "path": "v1beta1/{+name}:rollback", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource name of the Memory to rollback. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^memoryBanks/[^/]+/memories/[^/]+$", "type": "string", "location": "path", "required": true } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1RollbackMemoryRequest" } }, "list": { "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories", "parameters": { "pageToken": { "description": "Optional. The standard list page token.", "type": "string", "location": "query" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. The standard list order by string. If not specified, the default order is `create_time desc`. If specified, the default sorting order of provided fields is ascending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time`" }, "parent": { "location": "path", "required": true, "type": "string", "pattern": "^memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to list the Memories under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" }, "filter": { "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `scope` (as a JSON string with equality match only) * `topics` (i.e. `topics.custom_memory_topic_label: \"example topic\" OR topics.managed_memory_topic: USER_PREFERENCES`)", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "description": "Optional. The standard list page size.", "location": "query" } }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.memoryBanks.memories.list", "description": "List Memories.", "path": "v1beta1/{+parent}/memories" }, "retrieveProfiles": { "description": "Retrieves profiles.", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest" }, "parameters": { "parent": { "description": "Required. The resource name of the ReasoningEngine to retrieve profiles from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true, "pattern": "^memoryBanks/[^/]+$" } }, "httpMethod": "POST", "path": "v1beta1/{+parent}/memories:retrieveProfiles", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse" }, "id": "aiplatform.memoryBanks.memories.retrieveProfiles", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories:retrieveProfiles" }, "purge": { "parameterOrder": [ "parent" ], "description": "Purge memories.", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories:purge", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "pattern": "^memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to purge memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "path": "v1beta1/{+parent}/memories:purge", "id": "aiplatform.memoryBanks.memories.purge", "request": { "$ref": "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "retrieve": { "path": "v1beta1/{+parent}/memories:retrieve", "id": "aiplatform.memoryBanks.memories.retrieve", "response": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse" }, "description": "Retrieve memories.", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories:retrieve", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest" }, "httpMethod": "POST", "parameters": { "parent": { "pattern": "^memoryBanks/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the ReasoningEngine to retrieve memories from. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "description": "Create a Memory.", "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/memories", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.memoryBanks.memories.create", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories", "parameters": { "memoryId": { "description": "Optional. The user defined ID to use for memory, which will become the final component of the memory resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character must be a letter, and the last character must be a letter or number.", "type": "string", "location": "query" }, "parent": { "pattern": "^memoryBanks/[^/]+$", "description": "Required. The resource name of the ReasoningEngine to create the Memory under. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^memoryBanks/[^/]+/memories/[^/]+$", "description": "Required. The resource name of the Memory to delete. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "type": "string", "location": "path", "required": true } }, "description": "Delete a Memory.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.memoryBanks.memories.delete" }, "patch": { "parameterOrder": [ "name" ], "id": "aiplatform.memoryBanks.memories.patch", "description": "Update a Memory.", "parameters": { "name": { "location": "path", "required": true, "description": "Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^memoryBanks/[^/]+/memories/[^/]+$", "type": "string" }, "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to update. The following fields are immutable: * `scope` * `memory_type`", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "PATCH", "request": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}", "path": "v1beta1/{+name}" }, "generate": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.memoryBanks.memories.generate", "path": "v1beta1/{+parent}/memories:generate", "description": "Generate memories.", "parameters": { "parent": { "pattern": "^memoryBanks/[^/]+$", "type": "string", "description": "Required. The resource name of the ReasoningEngine to generate memories for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "location": "path", "required": true } }, "httpMethod": "POST", "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest" }, "parameterOrder": [ "parent" ], "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories:generate" } }, "resources": { "operations": { "methods": { "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.memoryBanks.memories.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}" }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "path": "v1beta1/{+name}", "id": "aiplatform.memoryBanks.memories.operations.get", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "name": { "type": "string", "pattern": "^memoryBanks/[^/]+/memories/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true } }, "id": "aiplatform.memoryBanks.memories.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on." }, "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "id": "aiplatform.memoryBanks.memories.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}:wait" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.memoryBanks.memories.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^memoryBanks/[^/]+/memories/[^/]+/operations/[^/]+$" } } } } }, "revisions": { "methods": { "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse" }, "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/revisions", "path": "v1beta1/{+parent}/revisions", "parameters": { "parent": { "type": "string", "location": "path", "required": true, "description": "Required. The resource name of the Memory to list revisions for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`", "pattern": "^memoryBanks/[^/]+/memories/[^/]+$" }, "filter": { "type": "string", "description": "Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`", "location": "query" }, "pageSize": { "format": "int32", "description": "Optional. The standard list page size.", "type": "integer", "location": "query" }, "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.memoryBanks.memories.revisions.list", "description": "List Memory Revisions for a Memory." }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/memoryBanks/{memoryBanksId}/memories/{memoriesId}/revisions/{revisionsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1MemoryRevision" }, "id": "aiplatform.memoryBanks.memories.revisions.get", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The resource name of the Memory Revision to retrieve. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}/revisions/{revision}`", "pattern": "^memoryBanks/[^/]+/memories/[^/]+/revisions/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "description": "Get a Memory Revision." } } } } } } }, "dataLabelingJobs": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.dataLabelingJobs.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^dataLabelingJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/dataLabelingJobs/{dataLabelingJobsId}/operations", "id": "aiplatform.dataLabelingJobs.operations.list", "path": "v1beta1/{+name}/operations", "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "description": "The standard list page size.", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^dataLabelingJobs/[^/]+$", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.dataLabelingJobs.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^dataLabelingJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" } } }, "cancel": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^dataLabelingJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "parameterOrder": [ "name" ], "id": "aiplatform.dataLabelingJobs.operations.cancel", "flatPath": "v1beta1/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "id": "aiplatform.dataLabelingJobs.operations.get", "flatPath": "v1beta1/dataLabelingJobs/{dataLabelingJobsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^dataLabelingJobs/[^/]+/operations/[^/]+$" } } } } } } }, "notebookExecutionJobs": { "resources": { "operations": { "methods": { "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.notebookExecutionJobs.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "type": "string", "pattern": "^notebookExecutionJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "flatPath": "v1beta1/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}", "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/notebookExecutionJobs/{notebookExecutionJobsId}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameters": { "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "name": { "pattern": "^notebookExecutionJobs/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.notebookExecutionJobs.operations.list" }, "wait": { "httpMethod": "POST", "parameters": { "name": { "pattern": "^notebookExecutionJobs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "id": "aiplatform.notebookExecutionJobs.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait" }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^notebookExecutionJobs/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.notebookExecutionJobs.operations.cancel", "parameterOrder": [ "name" ] }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/notebookExecutionJobs/{notebookExecutionJobsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.notebookExecutionJobs.operations.get", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^notebookExecutionJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } } } } } } }, "indexes": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/indexes/{indexesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "id": "aiplatform.indexes.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^indexes/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled." } } }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^indexes/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/indexes/{indexesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.indexes.operations.get" }, "list": { "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^indexes/[^/]+$", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "httpMethod": "GET", "id": "aiplatform.indexes.operations.list", "flatPath": "v1beta1/indexes/{indexesId}/operations" }, "wait": { "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true, "pattern": "^indexes/[^/]+/operations/[^/]+$" }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" } }, "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.indexes.operations.wait", "flatPath": "v1beta1/indexes/{indexesId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "id": "aiplatform.indexes.operations.delete", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^indexes/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/indexes/{indexesId}/operations/{operationsId}", "parameterOrder": [ "name" ] } } } } }, "evaluationTasks": { "resources": { "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^evaluationTasks/[^/]+$" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" } }, "id": "aiplatform.evaluationTasks.operations.list", "flatPath": "v1beta1/evaluationTasks/{evaluationTasksId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations" }, "wait": { "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.evaluationTasks.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^evaluationTasks/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." }, "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/evaluationTasks/{evaluationTasksId}/operations/{operationsId}:wait" }, "delete": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.evaluationTasks.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/evaluationTasks/{evaluationTasksId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^evaluationTasks/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ] }, "get": { "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^evaluationTasks/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.evaluationTasks.operations.get", "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/evaluationTasks/{evaluationTasksId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ] } } } } }, "onlineEvaluators": { "resources": { "operations": { "methods": { "cancel": { "id": "aiplatform.onlineEvaluators.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^onlineEvaluators/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:cancel" }, "list": { "parameters": { "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "pattern": "^onlineEvaluators/[^/]+$", "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/onlineEvaluators/{onlineEvaluatorsId}/operations", "id": "aiplatform.onlineEvaluators.operations.list" }, "wait": { "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.onlineEvaluators.operations.wait", "parameterOrder": [ "name" ], "parameters": { "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration" }, "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^onlineEvaluators/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "flatPath": "v1beta1/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}:wait" }, "get": { "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "id": "aiplatform.onlineEvaluators.operations.get", "httpMethod": "GET", "parameters": { "name": { "pattern": "^onlineEvaluators/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true } } }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.onlineEvaluators.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/onlineEvaluators/{onlineEvaluatorsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^onlineEvaluators/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } } } } } }, "agents": { "resources": { "operations": { "methods": { "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.agents.operations.cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^agents/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/agents/{agentsId}/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.agents.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "flatPath": "v1beta1/agents/{agentsId}/operations", "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The standard list page size." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^agents/[^/]+$", "location": "path", "required": true, "type": "string" } }, "path": "v1beta1/{+name}/operations" }, "wait": { "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^agents/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/agents/{agentsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.agents.operations.wait" }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^agents/[^/]+/operations/[^/]+$" } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/agents/{agentsId}/operations/{operationsId}", "id": "aiplatform.agents.operations.get", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^agents/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/agents/{agentsId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.agents.operations.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } } } }, "servingProfiles": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/servingProfiles/{servingProfilesId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^servingProfiles/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "id": "aiplatform.servingProfiles.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size.", "type": "integer" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^servingProfiles/[^/]+$", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/servingProfiles/{servingProfilesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.servingProfiles.operations.list", "path": "v1beta1/{+name}/operations" }, "wait": { "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "id": "aiplatform.servingProfiles.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^servingProfiles/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } }, "httpMethod": "POST", "flatPath": "v1beta1/servingProfiles/{servingProfilesId}/operations/{operationsId}:wait" }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/servingProfiles/{servingProfilesId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^servingProfiles/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST", "id": "aiplatform.servingProfiles.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1beta1/servingProfiles/{servingProfilesId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "id": "aiplatform.servingProfiles.operations.get", "parameters": { "name": { "location": "path", "required": true, "pattern": "^servingProfiles/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "ragEngineConfig": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.ragEngineConfig.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^ragEngineConfig/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "flatPath": "v1beta1/ragEngineConfig/operations/{operationsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ] }, "list": { "flatPath": "v1beta1/ragEngineConfig/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.ragEngineConfig.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "pattern": "^ragEngineConfig$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "timeout": { "location": "query", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" }, "name": { "type": "string", "pattern": "^ragEngineConfig/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true } }, "flatPath": "v1beta1/ragEngineConfig/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.ragEngineConfig.operations.wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait" }, "get": { "flatPath": "v1beta1/ragEngineConfig/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.ragEngineConfig.operations.get", "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^ragEngineConfig/operations/[^/]+$" } } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/ragEngineConfig/operations/{operationsId}", "parameterOrder": [ "name" ], "id": "aiplatform.ragEngineConfig.operations.delete", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^ragEngineConfig/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE" } } } } }, "media": { "methods": { "upload": { "response": { "$ref": "GoogleCloudAiplatformV1beta1UploadRagFileResponse" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1UploadRagFileRequest" }, "id": "aiplatform.media.upload", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles:upload", "path": "v1beta1/{+parent}/ragFiles:upload", "supportsMediaUpload": true, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/ragCorpora/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the RagCorpus resource into which to upload the file. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "type": "string" } }, "httpMethod": "POST", "mediaUpload": { "accept": [ "*/*" ], "protocols": { "simple": { "multipart": true, "path": "/upload/v1beta1/{+parent}/ragFiles:upload" } } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Upload a file into a RagCorpus." } } }, "modelMonitors": { "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "pattern": "^modelMonitors/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/modelMonitors/{modelMonitorsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.modelMonitors.operations.delete" }, "get": { "flatPath": "v1beta1/modelMonitors/{modelMonitorsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.modelMonitors.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^modelMonitors/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } } }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/modelMonitors/{modelMonitorsId}/operations/{operationsId}:cancel", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^modelMonitors/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "id": "aiplatform.modelMonitors.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "parameters": { "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "name": { "pattern": "^modelMonitors/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/modelMonitors/{modelMonitorsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.modelMonitors.operations.list" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/modelMonitors/{modelMonitorsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^modelMonitors/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" } }, "httpMethod": "POST", "id": "aiplatform.modelMonitors.operations.wait" } } } } }, "hyperparameterTuningJobs": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.hyperparameterTuningJobs.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations", "parameterOrder": [ "name" ], "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The standard list page size." }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^hyperparameterTuningJobs/[^/]+$", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET" }, "wait": { "flatPath": "v1beta1/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}:wait", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.hyperparameterTuningJobs.operations.wait" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.hyperparameterTuningJobs.operations.cancel", "parameters": { "name": { "pattern": "^hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "httpMethod": "POST", "flatPath": "v1beta1/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}:cancel" }, "get": { "parameters": { "name": { "type": "string", "pattern": "^hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}", "id": "aiplatform.hyperparameterTuningJobs.operations.get", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "id": "aiplatform.hyperparameterTuningJobs.operations.delete", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^hyperparameterTuningJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/hyperparameterTuningJobs/{hyperparameterTuningJobsId}/operations/{operationsId}" } } } } }, "schedules": { "resources": { "operations": { "methods": { "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "type": "string", "pattern": "^schedules/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "httpMethod": "GET", "id": "aiplatform.schedules.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/schedules/{schedulesId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/schedules/{schedulesId}/operations/{operationsId}", "id": "aiplatform.schedules.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string", "pattern": "^schedules/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/schedules/{schedulesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "pattern": "^schedules/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "id": "aiplatform.schedules.operations.cancel", "httpMethod": "POST" }, "list": { "id": "aiplatform.schedules.operations.list", "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageSize": { "location": "query", "type": "integer", "description": "The standard list page size.", "format": "int32" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "pattern": "^schedules/[^/]+$", "type": "string" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/schedules/{schedulesId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations" }, "wait": { "flatPath": "v1beta1/schedules/{schedulesId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "id": "aiplatform.schedules.operations.wait", "parameters": { "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" }, "name": { "pattern": "^schedules/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait" } } } } }, "operations": { "methods": { "delete": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "id": "aiplatform.operations.delete", "flatPath": "v1beta1/operations/{operationsId}" }, "list": { "parameters": { "name": { "type": "string", "location": "query", "description": "The name of the operation's parent resource." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.operations.list", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [], "path": "v1beta1/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/operations" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.operations.wait", "parameters": { "name": { "pattern": "^operations/[^/]+$", "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" } }, "httpMethod": "POST", "parameterOrder": [ "name" ] }, "get": { "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.operations.get", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^operations/[^/]+$" } }, "httpMethod": "GET", "flatPath": "v1beta1/operations/{operationsId}" }, "cancel": { "id": "aiplatform.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/operations/{operationsId}:cancel" } } }, "persistentResources": { "resources": { "operations": { "methods": { "get": { "flatPath": "v1beta1/persistentResources/{persistentResourcesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "id": "aiplatform.persistentResources.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^persistentResources/[^/]+/operations/[^/]+$", "type": "string" } }, "path": "v1beta1/{+name}" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/persistentResources/{persistentResourcesId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^persistentResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "id": "aiplatform.persistentResources.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel" }, "list": { "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "name": { "pattern": "^persistentResources/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size.", "type": "integer" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" } }, "id": "aiplatform.persistentResources.operations.list", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/persistentResources/{persistentResourcesId}/operations" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/persistentResources/{persistentResourcesId}/operations/{operationsId}:wait", "parameters": { "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "type": "string", "pattern": "^persistentResources/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.persistentResources.operations.wait" }, "delete": { "id": "aiplatform.persistentResources.operations.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^persistentResources/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/persistentResources/{persistentResourcesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "edgeDevices": { "resources": { "operations": { "methods": { "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^edgeDevices/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "flatPath": "v1beta1/edgeDevices/{edgeDevicesId}/operations/{operationsId}", "id": "aiplatform.edgeDevices.operations.delete" }, "list": { "id": "aiplatform.edgeDevices.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^edgeDevices/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/edgeDevices/{edgeDevicesId}/operations" }, "wait": { "flatPath": "v1beta1/edgeDevices/{edgeDevicesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^edgeDevices/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.edgeDevices.operations.wait", "httpMethod": "POST", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^edgeDevices/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/edgeDevices/{edgeDevicesId}/operations/{operationsId}", "id": "aiplatform.edgeDevices.operations.get" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "pattern": "^edgeDevices/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled." } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/edgeDevices/{edgeDevicesId}/operations/{operationsId}:cancel", "id": "aiplatform.edgeDevices.operations.cancel" } } } } }, "endpoints": { "methods": { "countTokens": { "parameters": { "endpoint": { "type": "string", "description": "Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "pattern": "^endpoints/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "Perform a token counting.", "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensResponse" }, "path": "v1beta1/{+endpoint}:countTokens", "id": "aiplatform.endpoints.countTokens", "request": { "$ref": "GoogleCloudAiplatformV1beta1CountTokensRequest" }, "flatPath": "v1beta1/endpoints/{endpointsId}:countTokens" }, "predict": { "id": "aiplatform.endpoints.predict", "path": "v1beta1/{+endpoint}:predict", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictRequest" }, "parameterOrder": [ "endpoint" ], "parameters": { "endpoint": { "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "pattern": "^endpoints/[^/]+$", "location": "path", "required": true } }, "flatPath": "v1beta1/endpoints/{endpointsId}:predict", "description": "", "response": { "$ref": "GoogleCloudAiplatformV1beta1PredictResponse" } }, "predictLongRunning": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.endpoints.predictLongRunning", "parameters": { "endpoint": { "type": "string", "location": "path", "required": true, "pattern": "^endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`" } }, "httpMethod": "POST", "path": "v1beta1/{+endpoint}:predictLongRunning", "request": { "$ref": "GoogleCloudAiplatformV1beta1PredictLongRunningRequest" }, "flatPath": "v1beta1/endpoints/{endpointsId}:predictLongRunning", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "description": "", "parameterOrder": [ "endpoint" ] }, "streamGenerateContent": { "path": "v1beta1/{+model}:streamGenerateContent", "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "description": "Generate content with multimodal inputs with streaming support.", "parameterOrder": [ "model" ], "parameters": { "model": { "pattern": "^endpoints/[^/]+$", "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string", "location": "path", "required": true } }, "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "httpMethod": "POST", "id": "aiplatform.endpoints.streamGenerateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "flatPath": "v1beta1/endpoints/{endpointsId}:streamGenerateContent" }, "generateContent": { "parameterOrder": [ "model" ], "path": "v1beta1/{+model}:generateContent", "httpMethod": "POST", "description": "Generate content with multimodal inputs.", "parameters": { "model": { "type": "string", "description": "Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "location": "path", "required": true, "pattern": "^endpoints/[^/]+$" } }, "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentRequest" }, "id": "aiplatform.endpoints.generateContent", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponse" }, "flatPath": "v1beta1/endpoints/{endpointsId}:generateContent" }, "fetchPredictOperation": { "description": "Fetch an asynchronous online prediction operation.", "httpMethod": "POST", "parameters": { "endpoint": { "location": "path", "required": true, "pattern": "^endpoints/[^/]+$", "description": "Required. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "path": "v1beta1/{+endpoint}:fetchPredictOperation", "flatPath": "v1beta1/endpoints/{endpointsId}:fetchPredictOperation", "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest" }, "id": "aiplatform.endpoints.fetchPredictOperation" }, "computeTokens": { "path": "v1beta1/{+endpoint}:computeTokens", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "endpoint" ], "flatPath": "v1beta1/endpoints/{endpointsId}:computeTokens", "response": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensResponse" }, "httpMethod": "POST", "request": { "$ref": "GoogleCloudAiplatformV1beta1ComputeTokensRequest" }, "parameters": { "endpoint": { "type": "string", "description": "Required. The name of the Endpoint requested to get lists of tokens and token ids.", "location": "path", "required": true, "pattern": "^endpoints/[^/]+$" } }, "description": "Return a list of tokens based on the input text.", "id": "aiplatform.endpoints.computeTokens" } }, "resources": { "operations": { "methods": { "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.endpoints.operations.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/endpoints/{endpointsId}/operations/{operationsId}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^endpoints/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ] }, "get": { "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^endpoints/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/endpoints/{endpointsId}/operations/{operationsId}", "id": "aiplatform.endpoints.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ] }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/endpoints/{endpointsId}/operations", "id": "aiplatform.endpoints.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true, "pattern": "^endpoints/[^/]+$" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "pattern": "^endpoints/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/endpoints/{endpointsId}/operations/{operationsId}:wait", "id": "aiplatform.endpoints.operations.wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "cancel": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^endpoints/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/endpoints/{endpointsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.endpoints.operations.cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GoogleProtobufEmpty" } } } }, "chat": { "methods": { "completions": { "flatPath": "v1beta1/endpoints/{endpointsId}/chat/completions", "path": "v1beta1/{+endpoint}/chat/completions", "parameterOrder": [ "endpoint" ], "response": { "$ref": "GoogleApiHttpBody" }, "request": { "$ref": "GoogleApiHttpBody" }, "id": "aiplatform.endpoints.chat.completions", "description": "Exposes an OpenAI-compatible endpoint for chat completions.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/cloud-platform.read-only" ], "parameters": { "endpoint": { "location": "path", "required": true, "type": "string", "pattern": "^endpoints/[^/]+$", "description": "Required. The name of the endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" } } } } } } }, "v1beta1": { "methods": { "evaluateInstances": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest" }, "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "flatPath": "v1beta1:evaluateInstances", "id": "aiplatform.evaluateInstances", "description": "Evaluates instances based on a given metric.", "response": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateInstancesResponse" }, "path": "v1beta1:evaluateInstances" }, "generateInstanceRubrics": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsRequest" }, "parameterOrder": [], "parameters": {}, "httpMethod": "POST", "response": { "$ref": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsResponse" }, "id": "aiplatform.generateInstanceRubrics", "path": "v1beta1:generateInstanceRubrics", "flatPath": "v1beta1:generateInstanceRubrics", "description": "Generates rubrics for a given prompt. A rubric represents a single testable criterion for evaluation. One input prompt could have multiple rubrics This RPC allows users to get suggested rubrics based on provided prompt, which can then be reviewed and used for subsequent evaluations." }, "evaluateDataset": { "path": "v1beta1:evaluateDataset", "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateDatasetRequest" }, "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": {}, "flatPath": "v1beta1:evaluateDataset", "httpMethod": "POST", "id": "aiplatform.evaluateDataset", "parameterOrder": [], "description": "Evaluates a dataset based on a set of given metrics.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "ragCorpora": { "resources": { "operations": { "methods": { "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "type": "string", "pattern": "^ragCorpora/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "id": "aiplatform.ragCorpora.operations.cancel" }, "get": { "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^ragCorpora/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.ragCorpora.operations.get" }, "list": { "parameterOrder": [ "name" ], "id": "aiplatform.ragCorpora.operations.list", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true, "pattern": "^ragCorpora/[^/]+$" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" } }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/operations", "path": "v1beta1/{+name}/operations" }, "wait": { "id": "aiplatform.ragCorpora.operations.wait", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^ragCorpora/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.ragCorpora.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "pattern": "^ragCorpora/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." } } }, "ragFiles": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.ragCorpora.ragFiles.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } }, "httpMethod": "DELETE" }, "list": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "pattern": "^ragCorpora/[^/]+/ragFiles/[^/]+$", "type": "string", "location": "path", "required": true }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "id": "aiplatform.ragCorpora.ragFiles.operations.list" }, "wait": { "id": "aiplatform.ragCorpora.ragFiles.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "format": "google-duration", "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "location": "path", "required": true, "type": "string", "pattern": "^ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on." } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}:cancel", "id": "aiplatform.ragCorpora.ragFiles.operations.cancel", "parameterOrder": [ "name" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "flatPath": "v1beta1/ragCorpora/{ragCorporaId}/ragFiles/{ragFilesId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "GET", "parameters": { "name": { "pattern": "^ragCorpora/[^/]+/ragFiles/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "id": "aiplatform.ragCorpora.ragFiles.operations.get" } } } } } } }, "notebookRuntimes": { "resources": { "operations": { "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^notebookRuntimes/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "id": "aiplatform.notebookRuntimes.operations.delete", "parameterOrder": [ "name" ], "flatPath": "v1beta1/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^notebookRuntimes/[^/]+$", "location": "path", "required": true }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" }, "returnPartialSuccess": { "type": "boolean", "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." } }, "id": "aiplatform.notebookRuntimes.operations.list", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "flatPath": "v1beta1/notebookRuntimes/{notebookRuntimesId}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}:wait", "id": "aiplatform.notebookRuntimes.operations.wait", "path": "v1beta1/{+name}:wait", "parameters": { "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" }, "name": { "type": "string", "pattern": "^notebookRuntimes/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "parameterOrder": [ "name" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.notebookRuntimes.operations.cancel", "flatPath": "v1beta1/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled.", "pattern": "^notebookRuntimes/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ] }, "get": { "parameters": { "name": { "type": "string", "pattern": "^notebookRuntimes/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/notebookRuntimes/{notebookRuntimesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "id": "aiplatform.notebookRuntimes.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "pipelineJobs": { "resources": { "operations": { "methods": { "list": { "id": "aiplatform.pipelineJobs.operations.list", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/pipelineJobs/{pipelineJobsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "location": "path", "required": true, "pattern": "^pipelineJobs/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "format": "int32", "location": "query", "description": "The standard list page size.", "type": "integer" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "flatPath": "v1beta1/pipelineJobs/{pipelineJobsId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^pipelineJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "location": "path", "required": true }, "timeout": { "format": "google-duration", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.pipelineJobs.operations.wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.pipelineJobs.operations.cancel", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^pipelineJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/pipelineJobs/{pipelineJobsId}/operations/{operationsId}:cancel" }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.pipelineJobs.operations.get", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "pattern": "^pipelineJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/pipelineJobs/{pipelineJobsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string", "pattern": "^pipelineJobs/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/pipelineJobs/{pipelineJobsId}/operations/{operationsId}", "id": "aiplatform.pipelineJobs.operations.delete" } } } } }, "tuningJobs": { "resources": { "operations": { "methods": { "delete": { "flatPath": "v1beta1/tuningJobs/{tuningJobsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.tuningJobs.operations.delete", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^tuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } } }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/tuningJobs/{tuningJobsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource.", "pattern": "^tuningJobs/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.tuningJobs.operations.get" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/tuningJobs/{tuningJobsId}/operations/{operationsId}:wait", "httpMethod": "POST", "id": "aiplatform.tuningJobs.operations.wait", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^tuningJobs/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "parameterOrder": [ "name" ] }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/tuningJobs/{tuningJobsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^tuningJobs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.tuningJobs.operations.cancel" } } } } }, "evaluationRuns": { "resources": { "operations": { "methods": { "get": { "flatPath": "v1beta1/evaluationRuns/{evaluationRunsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^evaluationRuns/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "id": "aiplatform.evaluationRuns.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/evaluationRuns/{evaluationRunsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^evaluationRuns/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "id": "aiplatform.evaluationRuns.operations.delete", "httpMethod": "DELETE" }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.evaluationRuns.operations.list", "flatPath": "v1beta1/evaluationRuns/{evaluationRunsId}/operations", "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "pattern": "^evaluationRuns/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.evaluationRuns.operations.wait", "parameters": { "timeout": { "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "type": "string" }, "name": { "location": "path", "required": true, "pattern": "^evaluationRuns/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string" } }, "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/evaluationRuns/{evaluationRunsId}/operations/{operationsId}:wait" } } } } }, "exampleStores": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.exampleStores.operations.delete", "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^exampleStores/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/exampleStores/{exampleStoresId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "aiplatform.exampleStores.operations.list", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "pattern": "^exampleStores/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "flatPath": "v1beta1/exampleStores/{exampleStoresId}/operations", "path": "v1beta1/{+name}/operations" }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "id": "aiplatform.exampleStores.operations.wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/exampleStores/{exampleStoresId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true, "pattern": "^exampleStores/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^exampleStores/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/exampleStores/{exampleStoresId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.exampleStores.operations.get", "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^exampleStores/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1beta1/exampleStores/{exampleStoresId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.exampleStores.operations.cancel" } } } } }, "featurestores": { "resources": { "entityTypes": { "resources": { "operations": { "methods": { "cancel": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "id": "aiplatform.featurestores.entityTypes.operations.cancel", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.featurestores.entityTypes.operations.get", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}" }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.featurestores.entityTypes.operations.delete", "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}", "httpMethod": "DELETE" }, "list": { "id": "aiplatform.featurestores.entityTypes.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "parameters": { "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^featurestores/[^/]+/entityTypes/[^/]+$" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } }, "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "aiplatform.featurestores.entityTypes.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "type": "string" } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait" } } }, "features": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.featurestores.entityTypes.features.operations.delete", "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "id": "aiplatform.featurestores.entityTypes.features.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+$", "location": "path", "required": true }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations", "path": "v1beta1/{+name}/operations" }, "wait": { "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" }, "timeout": { "format": "google-duration", "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "id": "aiplatform.featurestores.entityTypes.features.operations.wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "id": "aiplatform.featurestores.entityTypes.features.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}" }, "cancel": { "flatPath": "v1beta1/featurestores/{featurestoresId}/entityTypes/{entityTypesId}/features/{featuresId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "pattern": "^featurestores/[^/]+/entityTypes/[^/]+/features/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.featurestores.entityTypes.features.operations.cancel", "path": "v1beta1/{+name}:cancel" } } } } } } }, "operations": { "methods": { "delete": { "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featurestores/{featurestoresId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "id": "aiplatform.featurestores.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^featurestores/[^/]+/operations/[^/]+$" } } }, "get": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "flatPath": "v1beta1/featurestores/{featurestoresId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^featurestores/[^/]+/operations/[^/]+$" } }, "httpMethod": "GET", "id": "aiplatform.featurestores.operations.get" }, "list": { "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "name": { "pattern": "^featurestores/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "id": "aiplatform.featurestores.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/featurestores/{featurestoresId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "flatPath": "v1beta1/featurestores/{featurestoresId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.featurestores.operations.wait", "httpMethod": "POST", "parameters": { "name": { "pattern": "^featurestores/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ] }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "id": "aiplatform.featurestores.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/featurestores/{featurestoresId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "pattern": "^featurestores/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST" } } } } }, "tensorboards": { "resources": { "operations": { "methods": { "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.tensorboards.operations.get", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^tensorboards/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "httpMethod": "GET" }, "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/tensorboards/{tensorboardsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.tensorboards.operations.delete", "path": "v1beta1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/operations/[^/]+$", "type": "string" } }, "httpMethod": "DELETE" }, "list": { "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "name": { "pattern": "^tensorboards/[^/]+$", "description": "The name of the operation's parent resource.", "type": "string", "location": "path", "required": true }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" } }, "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/tensorboards/{tensorboardsId}/operations", "path": "v1beta1/{+name}/operations", "id": "aiplatform.tensorboards.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to wait on.", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/operations/[^/]+$" }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "location": "query", "format": "google-duration" } }, "httpMethod": "POST", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.tensorboards.operations.wait" }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "flatPath": "v1beta1/tensorboards/{tensorboardsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "id": "aiplatform.tensorboards.operations.cancel" } } }, "experiments": { "resources": { "operations": { "methods": { "delete": { "id": "aiplatform.tensorboards.experiments.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "type": "string", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}" }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "pageSize": { "description": "The standard list page size.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "pattern": "^tensorboards/[^/]+/experiments/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations", "id": "aiplatform.tensorboards.experiments.operations.list", "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "format": "google-duration", "type": "string", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "id": "aiplatform.tensorboards.experiments.operations.wait", "parameterOrder": [ "name" ] }, "get": { "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.tensorboards.experiments.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$" } }, "path": "v1beta1/{+name}", "httpMethod": "GET", "parameterOrder": [ "name" ] }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.tensorboards.experiments.operations.cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/operations/{operationsId}:cancel" } } }, "runs": { "resources": { "timeSeries": { "resources": { "operations": { "methods": { "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.tensorboards.experiments.runs.timeSeries.operations.delete", "path": "v1beta1/{+name}", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}" }, "list": { "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "name": { "type": "string", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+$" } }, "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "id": "aiplatform.tensorboards.experiments.runs.timeSeries.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "parameters": { "timeout": { "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration" }, "name": { "description": "The name of the operation resource to wait on.", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "id": "aiplatform.tensorboards.experiments.runs.timeSeries.operations.wait" }, "cancel": { "id": "aiplatform.tensorboards.experiments.runs.timeSeries.operations.cancel", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.tensorboards.experiments.runs.timeSeries.operations.get", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/timeSeries/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/timeSeries/{timeSeriesId}/operations/{operationsId}" } } } } }, "operations": { "methods": { "list": { "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "id": "aiplatform.tensorboards.experiments.runs.operations.list", "httpMethod": "GET", "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+$" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" } } }, "wait": { "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$" } }, "id": "aiplatform.tensorboards.experiments.runs.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ] }, "delete": { "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.tensorboards.experiments.runs.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } } }, "get": { "path": "v1beta1/{+name}", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}", "parameters": { "name": { "type": "string", "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.tensorboards.experiments.runs.operations.get" }, "cancel": { "path": "v1beta1/{+name}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "type": "string", "location": "path", "required": true, "pattern": "^tensorboards/[^/]+/experiments/[^/]+/runs/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.tensorboards.experiments.runs.operations.cancel", "flatPath": "v1beta1/tensorboards/{tensorboardsId}/experiments/{experimentsId}/runs/{runsId}/operations/{operationsId}:cancel" } } } } } } } } }, "interactions": { "methods": { "getPoll": { "response": { "$ref": "GenaiVertexV1beta1Interaction" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:poll", "flatPath": "v1beta1/interactions/{interactionsId}:poll", "id": "aiplatform.interactions.getPoll", "description": "Fully typed proto, unary version of GetInteraction that returns Interaction proto.", "parameters": { "stream": { "type": "boolean", "description": "If true, streams the interaction events as Server-Sent Events.", "location": "query" }, "lastEventId": { "description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", "type": "string", "location": "query" }, "includeInput": { "location": "query", "type": "boolean", "deprecated": true, "description": "If true, includes the input in the response." }, "name": { "description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}", "pattern": "^interactions/[^/]+$", "type": "string", "location": "path", "required": true } }, "httpMethod": "GET" }, "getStream": { "flatPath": "v1beta1/interactions/{interactionsId}:stream", "id": "aiplatform.interactions.getStream", "parameterOrder": [ "name" ], "response": { "$ref": "GenaiVertexV1beta1InteractionStreamingEvent" }, "httpMethod": "GET", "parameters": { "name": { "pattern": "^interactions/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}" }, "stream": { "description": "If true, streams the interaction events as Server-Sent Events.", "location": "query", "type": "boolean" }, "includeInput": { "location": "query", "deprecated": true, "type": "boolean", "description": "If true, includes the input in the response." }, "lastEventId": { "type": "string", "description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", "location": "query" } }, "description": "Fully typed proto, streaming version of GetInteraction that returns Interaction proto.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:stream" }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/interactions/{interactionsId}:cancel", "path": "v1beta1/{+name}:cancel", "response": { "$ref": "GenaiVertexV1beta1Interaction" }, "id": "aiplatform.interactions.cancel", "description": "Cancels an interaction.", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^interactions/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the interaction to cancel. Format: `interactions/{interaction}`.", "type": "string" } } } } }, "indexEndpoints": { "resources": { "operations": { "methods": { "cancel": { "flatPath": "v1beta1/indexEndpoints/{indexEndpointsId}/operations/{operationsId}:cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^indexEndpoints/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "type": "string" } }, "id": "aiplatform.indexEndpoints.operations.cancel", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel" }, "list": { "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "The standard list page size.", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "name": { "pattern": "^indexEndpoints/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "description": "The standard list filter.", "type": "string", "location": "query" } }, "id": "aiplatform.indexEndpoints.operations.list", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/indexEndpoints/{indexEndpointsId}/operations" }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.indexEndpoints.operations.wait", "flatPath": "v1beta1/indexEndpoints/{indexEndpointsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^indexEndpoints/[^/]+/operations/[^/]+$", "location": "path", "required": true }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration", "type": "string" } }, "path": "v1beta1/{+name}:wait" }, "delete": { "parameterOrder": [ "name" ], "id": "aiplatform.indexEndpoints.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/indexEndpoints/{indexEndpointsId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "pattern": "^indexEndpoints/[^/]+/operations/[^/]+$", "type": "string" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "aiplatform.indexEndpoints.operations.get", "parameterOrder": [ "name" ], "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "pattern": "^indexEndpoints/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource.", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "flatPath": "v1beta1/indexEndpoints/{indexEndpointsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "extensions": { "resources": { "operations": { "methods": { "cancel": { "flatPath": "v1beta1/extensions/{extensionsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "pattern": "^extensions/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled." } }, "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "id": "aiplatform.extensions.operations.cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/extensions/{extensionsId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.extensions.operations.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^extensions/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true } } }, "list": { "id": "aiplatform.extensions.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/extensions/{extensionsId}/operations", "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "pattern": "^extensions/[^/]+$", "type": "string", "location": "path", "required": true }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "description": "The standard list page size.", "format": "int32" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } } }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "httpMethod": "POST", "parameters": { "timeout": { "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string" }, "name": { "pattern": "^extensions/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/extensions/{extensionsId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "id": "aiplatform.extensions.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" } }, "delete": { "path": "v1beta1/{+name}", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^extensions/[^/]+/operations/[^/]+$" } }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/extensions/{extensionsId}/operations/{operationsId}", "id": "aiplatform.extensions.operations.delete", "response": { "$ref": "GoogleProtobufEmpty" } } } } } }, "studies": { "resources": { "trials": { "resources": { "operations": { "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string", "pattern": "^studies/[^/]+/trials/[^/]+/operations/[^/]+$" } }, "flatPath": "v1beta1/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}", "id": "aiplatform.studies.trials.operations.delete", "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}" }, "get": { "flatPath": "v1beta1/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}", "id": "aiplatform.studies.trials.operations.get", "path": "v1beta1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^studies/[^/]+/trials/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ] }, "list": { "id": "aiplatform.studies.trials.operations.list", "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/studies/{studiesId}/trials/{trialsId}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "httpMethod": "GET", "parameters": { "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "name": { "type": "string", "location": "path", "required": true, "pattern": "^studies/[^/]+/trials/[^/]+$", "description": "The name of the operation's parent resource." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." } } }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^studies/[^/]+/trials/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "type": "string", "format": "google-duration", "location": "query" } }, "parameterOrder": [ "name" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "flatPath": "v1beta1/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}:wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "id": "aiplatform.studies.trials.operations.wait" }, "cancel": { "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "pattern": "^studies/[^/]+/trials/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "POST", "flatPath": "v1beta1/studies/{studiesId}/trials/{trialsId}/operations/{operationsId}:cancel", "id": "aiplatform.studies.trials.operations.cancel" } } } } }, "operations": { "methods": { "get": { "id": "aiplatform.studies.operations.get", "flatPath": "v1beta1/studies/{studiesId}/operations/{operationsId}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "pattern": "^studies/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/studies/{studiesId}/operations/{operationsId}", "parameters": { "name": { "pattern": "^studies/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "path": "v1beta1/{+name}", "httpMethod": "DELETE", "id": "aiplatform.studies.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "pattern": "^studies/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "flatPath": "v1beta1/studies/{studiesId}/operations/{operationsId}:cancel", "id": "aiplatform.studies.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/studies/{studiesId}/operations", "parameterOrder": [ "name" ], "parameters": { "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^studies/[^/]+$" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" } }, "id": "aiplatform.studies.operations.list", "httpMethod": "GET" }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.studies.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/studies/{studiesId}/operations/{operationsId}:wait", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "pattern": "^studies/[^/]+/operations/[^/]+$" }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done." } } } } }, "featureOnlineStores": { "resources": { "featureViews": { "resources": { "operations": { "methods": { "delete": { "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.featureOnlineStores.featureViews.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}" }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}", "id": "aiplatform.featureOnlineStores.featureViews.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource.", "pattern": "^featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$", "type": "string" } } }, "list": { "id": "aiplatform.featureOnlineStores.featureViews.operations.list", "parameters": { "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The standard list page size." }, "name": { "pattern": "^featureOnlineStores/[^/]+/featureViews/[^/]+$", "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations" }, "wait": { "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^featureOnlineStores/[^/]+/featureViews/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" } }, "id": "aiplatform.featureOnlineStores.featureViews.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/featureViews/{featureViewsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait" } } } } }, "operations": { "methods": { "delete": { "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "id": "aiplatform.featureOnlineStores.operations.delete", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^featureOnlineStores/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to be deleted." } }, "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}" }, "get": { "path": "v1beta1/{+name}", "id": "aiplatform.featureOnlineStores.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "description": "The name of the operation resource.", "location": "path", "required": true, "pattern": "^featureOnlineStores/[^/]+/operations/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "list": { "path": "v1beta1/{+name}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/operations", "parameters": { "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" }, "name": { "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^featureOnlineStores/[^/]+$", "location": "path", "required": true } }, "id": "aiplatform.featureOnlineStores.operations.list", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "parameters": { "name": { "pattern": "^featureOnlineStores/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource to wait on." }, "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" } }, "httpMethod": "POST", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/featureOnlineStores/{featureOnlineStoresId}/operations/{operationsId}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.featureOnlineStores.operations.wait", "path": "v1beta1/{+name}:wait", "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "specialistPools": { "resources": { "operations": { "methods": { "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1beta1/specialistPools/{specialistPoolsId}/operations", "id": "aiplatform.specialistPools.operations.list", "parameters": { "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^specialistPools/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." } }, "path": "v1beta1/{+name}/operations", "httpMethod": "GET", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "parameters": { "name": { "description": "The name of the operation resource to wait on.", "pattern": "^specialistPools/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true }, "timeout": { "type": "string", "format": "google-duration", "location": "query", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "flatPath": "v1beta1/specialistPools/{specialistPoolsId}/operations/{operationsId}:wait", "id": "aiplatform.specialistPools.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.specialistPools.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/specialistPools/{specialistPoolsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^specialistPools/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" } }, "cancel": { "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/specialistPools/{specialistPoolsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "pattern": "^specialistPools/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be cancelled." } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "path": "v1beta1/{+name}:cancel", "id": "aiplatform.specialistPools.operations.cancel" }, "get": { "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^specialistPools/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "httpMethod": "GET", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.specialistPools.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/specialistPools/{specialistPoolsId}/operations/{operationsId}" } } } } }, "datasets": { "methods": { "list": { "flatPath": "v1beta1/datasets", "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDatasetsResponse" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/datasets", "parameterOrder": [], "description": "Lists Datasets in a Location.", "id": "aiplatform.datasets.list", "httpMethod": "GET", "parameters": { "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time`", "type": "string", "location": "query" }, "parent": { "description": "Required. The name of the Dataset's parent resource. Format: `projects/{project}/locations/{location}`", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "readMask": { "description": "Mask specifying which fields to read.", "format": "google-fieldmask", "type": "string", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `display_name`: supports = and != * `metadata_schema_uri`: supports = and != * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels.\"a key\"`. Some examples: * `displayName=\"myDisplayName\"` * `labels.myKey=\"myValue\"`" } } }, "delete": { "flatPath": "v1beta1/datasets/{datasetsId}", "path": "v1beta1/{+name}", "description": "Deletes a Dataset.", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "location": "path", "required": true, "pattern": "^datasets/[^/]+$", "description": "Required. The resource name of the Dataset to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "string" } }, "id": "aiplatform.datasets.delete", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "create": { "httpMethod": "POST", "parameters": { "parent": { "type": "string", "description": "Required. The resource name of the Location to create the Dataset in. Format: `projects/{project}/locations/{location}`", "location": "query" } }, "flatPath": "v1beta1/datasets", "parameterOrder": [], "id": "aiplatform.datasets.create", "path": "v1beta1/datasets", "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "description": "Creates a Dataset." }, "get": { "path": "v1beta1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "readMask": { "description": "Mask specifying which fields to read.", "location": "query", "format": "google-fieldmask", "type": "string" }, "name": { "description": "Required. The name of the Dataset resource.", "location": "path", "required": true, "type": "string", "pattern": "^datasets/[^/]+$" } }, "id": "aiplatform.datasets.get", "flatPath": "v1beta1/datasets/{datasetsId}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "description": "Gets a Dataset.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "description": "Updates a Dataset.", "request": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.datasets.patch", "flatPath": "v1beta1/datasets/{datasetsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+$", "description": "Output only. Identifier. The resource name of the Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" }, "updateMask": { "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name` * `description` * `labels`", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ] } }, "resources": { "dataItems": { "resources": { "operations": { "methods": { "cancel": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.datasets.dataItems.operations.cancel", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$" } }, "httpMethod": "POST" }, "list": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "name": { "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string", "pattern": "^datasets/[^/]+/dataItems/[^/]+$" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The standard list page size." }, "returnPartialSuccess": { "location": "query", "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation." }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" } }, "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/operations", "id": "aiplatform.datasets.dataItems.operations.list", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameterOrder": [ "name" ] }, "wait": { "httpMethod": "POST", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "required": true, "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$" }, "timeout": { "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query" } }, "id": "aiplatform.datasets.dataItems.operations.wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "response": { "$ref": "GoogleLongrunningOperation" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "pattern": "^datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation resource." } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "id": "aiplatform.datasets.dataItems.operations.get" }, "delete": { "parameterOrder": [ "name" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "id": "aiplatform.datasets.dataItems.operations.delete", "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/operations/{operationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^datasets/[^/]+/dataItems/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } } } } }, "annotations": { "resources": { "operations": { "methods": { "delete": { "response": { "$ref": "GoogleProtobufEmpty" }, "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "The name of the operation resource to be deleted.", "pattern": "^datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$" } }, "httpMethod": "DELETE", "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.datasets.dataItems.annotations.operations.delete" }, "get": { "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}", "id": "aiplatform.datasets.dataItems.annotations.operations.get", "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "name": { "description": "The name of the operation resource.", "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$" } }, "parameterOrder": [ "name" ] }, "list": { "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "parameters": { "name": { "pattern": "^datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The standard list filter." }, "pageSize": { "format": "int32", "description": "The standard list page size.", "location": "query", "type": "integer" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "pageToken": { "location": "query", "type": "string", "description": "The standard list page token." } }, "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "path": "v1beta1/{+name}/operations", "id": "aiplatform.datasets.dataItems.annotations.operations.list" }, "wait": { "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}:wait", "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "format": "google-duration", "location": "query", "type": "string" }, "name": { "type": "string", "pattern": "^datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to wait on." } }, "httpMethod": "POST", "path": "v1beta1/{+name}:wait", "parameterOrder": [ "name" ], "id": "aiplatform.datasets.dataItems.annotations.operations.wait" }, "cancel": { "path": "v1beta1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "pattern": "^datasets/[^/]+/dataItems/[^/]+/annotations/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "id": "aiplatform.datasets.dataItems.annotations.operations.cancel", "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v1beta1/datasets/{datasetsId}/dataItems/{dataItemsId}/annotations/{annotationsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } }, "datasetVersions": { "methods": { "list": { "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "description": "Optional. The standard list page size.", "type": "integer", "location": "query" }, "readMask": { "format": "google-fieldmask", "description": "Optional. Mask specifying which fields to read.", "type": "string", "location": "query" }, "pageToken": { "description": "Optional. The standard list page token.", "location": "query", "type": "string" }, "filter": { "location": "query", "description": "Optional. The standard list filter.", "type": "string" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending." }, "parent": { "description": "Required. The resource name of the Dataset to list DatasetVersions from. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "pattern": "^datasets/[^/]+$", "type": "string", "location": "path", "required": true } }, "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1ListDatasetVersionsResponse" }, "id": "aiplatform.datasets.datasetVersions.list", "parameterOrder": [ "parent" ], "path": "v1beta1/{+parent}/datasetVersions", "description": "Lists DatasetVersions in a Dataset." }, "create": { "description": "Create a version from a Dataset.", "parameterOrder": [ "parent" ], "request": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "response": { "$ref": "GoogleLongrunningOperation" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "description": "Required. The name of the Dataset resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+$" } }, "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions", "httpMethod": "POST", "id": "aiplatform.datasets.datasetVersions.create", "path": "v1beta1/{+parent}/datasetVersions" }, "delete": { "description": "Deletes a Dataset version.", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}", "id": "aiplatform.datasets.datasetVersions.delete", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$" } }, "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "parameterOrder": [ "name" ] }, "restore": { "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the DatasetVersion resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Restores a dataset version.", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.datasets.datasetVersions.restore", "path": "v1beta1/{+name}:restore", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}:restore" }, "get": { "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "id": "aiplatform.datasets.datasetVersions.get", "description": "Gets a Dataset version.", "parameterOrder": [ "name" ], "parameters": { "readMask": { "format": "google-fieldmask", "location": "query", "description": "Mask specifying which fields to read.", "type": "string" }, "name": { "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$", "location": "path", "required": true, "description": "Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "type": "string" } }, "httpMethod": "GET", "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}" }, "patch": { "response": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "flatPath": "v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}", "id": "aiplatform.datasets.datasetVersions.patch", "parameters": { "name": { "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`", "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+/datasetVersions/[^/]+$" }, "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name`" } }, "httpMethod": "PATCH", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates a DatasetVersion.", "path": "v1beta1/{+name}" } } }, "savedQueries": { "resources": { "operations": { "methods": { "get": { "flatPath": "v1beta1/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.datasets.savedQueries.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameterOrder": [ "name" ], "httpMethod": "GET", "path": "v1beta1/{+name}", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "description": "The name of the operation resource." } }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1beta1/{+name}", "parameters": { "name": { "pattern": "^datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1beta1/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}", "id": "aiplatform.datasets.savedQueries.operations.delete", "parameterOrder": [ "name" ] }, "list": { "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "path": "v1beta1/{+name}/operations", "flatPath": "v1beta1/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations", "id": "aiplatform.datasets.savedQueries.operations.list", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameters": { "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "name": { "location": "path", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "pattern": "^datasets/[^/]+/savedQueries/[^/]+$" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageSize": { "location": "query", "description": "The standard list page size.", "format": "int32", "type": "integer" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "wait": { "response": { "$ref": "GoogleLongrunningOperation" }, "parameters": { "timeout": { "format": "google-duration", "location": "query", "type": "string", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "httpMethod": "POST", "id": "aiplatform.datasets.savedQueries.operations.wait", "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}:wait", "path": "v1beta1/{+name}:wait", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^datasets/[^/]+/savedQueries/[^/]+/operations/[^/]+$" } }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "httpMethod": "POST", "response": { "$ref": "GoogleProtobufEmpty" }, "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/savedQueries/{savedQueriesId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.datasets.savedQueries.operations.cancel", "path": "v1beta1/{+name}:cancel" } } } } }, "annotationSpecs": { "resources": { "operations": { "methods": { "list": { "parameters": { "pageToken": { "type": "string", "location": "query", "description": "The standard list page token." }, "name": { "description": "The name of the operation's parent resource.", "pattern": "^datasets/[^/]+/annotationSpecs/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "The standard list page size." }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean", "location": "query" } }, "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations", "id": "aiplatform.datasets.annotationSpecs.operations.list", "path": "v1beta1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" } }, "wait": { "parameters": { "timeout": { "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used.", "location": "query", "format": "google-duration", "type": "string" }, "name": { "description": "The name of the operation resource to wait on.", "type": "string", "pattern": "^datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "location": "path", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "id": "aiplatform.datasets.annotationSpecs.operations.wait", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "flatPath": "v1beta1/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}:wait" }, "cancel": { "id": "aiplatform.datasets.annotationSpecs.operations.cancel", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "path": "v1beta1/{+name}:cancel", "flatPath": "v1beta1/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "location": "path", "required": true, "pattern": "^datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled." } } }, "get": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "description": "The name of the operation resource.", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleLongrunningOperation" }, "id": "aiplatform.datasets.annotationSpecs.operations.get", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/annotationSpecs/{annotationSpecsId}/operations/{operationsId}", "id": "aiplatform.datasets.annotationSpecs.operations.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^datasets/[^/]+/annotationSpecs/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true } }, "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "path": "v1beta1/{+name}" } } } } }, "operations": { "methods": { "get": { "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^datasets/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource." } }, "id": "aiplatform.datasets.operations.get", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1beta1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1beta1/datasets/{datasetsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/datasets/{datasetsId}/operations/{operationsId}", "path": "v1beta1/{+name}", "response": { "$ref": "GoogleProtobufEmpty" }, "httpMethod": "DELETE", "id": "aiplatform.datasets.operations.delete", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^datasets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted." } } }, "list": { "id": "aiplatform.datasets.operations.list", "parameters": { "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" }, "filter": { "type": "string", "location": "query", "description": "The standard list filter." }, "pageSize": { "description": "The standard list page size.", "type": "integer", "location": "query", "format": "int32" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "name": { "pattern": "^datasets/[^/]+$", "type": "string", "location": "path", "required": true, "description": "The name of the operation's parent resource." } }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}/operations", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "flatPath": "v1beta1/datasets/{datasetsId}/operations", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "wait": { "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done.", "path": "v1beta1/{+name}:wait", "id": "aiplatform.datasets.operations.wait", "flatPath": "v1beta1/datasets/{datasetsId}/operations/{operationsId}:wait", "httpMethod": "POST", "parameters": { "name": { "pattern": "^datasets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to wait on.", "type": "string", "location": "path", "required": true }, "timeout": { "location": "query", "type": "string", "format": "google-duration", "description": "The maximum duration to wait before timing out. If left blank, the wait will be at most the time permitted by the underlying HTTP/RPC protocol. If RPC context deadline is also specified, the shorter one will be used." } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleLongrunningOperation" } }, "cancel": { "httpMethod": "POST", "parameters": { "name": { "type": "string", "pattern": "^datasets/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true } }, "id": "aiplatform.datasets.operations.cancel", "parameterOrder": [ "name" ], "flatPath": "v1beta1/datasets/{datasetsId}/operations/{operationsId}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "scopes": [ "https://www.googleapis.com/auth/aiplatform", "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1beta1/{+name}:cancel" } } } } } }, "title": "Agent Platform API", "protocol": "rest", "ownerDomain": "google.com", "revision": "20261012", "version": "v1beta1", "endpoints": [ { "endpointUrl": "https://africa-south1-aiplatform.googleapis.com/", "location": "africa-south1", "description": "Locational Endpoint" }, { "description": "Locational Endpoint", "location": "asia-east1", "endpointUrl": "https://asia-east1-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "location": "asia-east2", "endpointUrl": "https://asia-east2-aiplatform.googleapis.com/" }, { "location": "asia-northeast1", "endpointUrl": "https://asia-northeast1-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "location": "asia-northeast2", "endpointUrl": "https://asia-northeast2-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "location": "asia-northeast3", "endpointUrl": "https://asia-northeast3-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "endpointUrl": "https://asia-south1-aiplatform.googleapis.com/", "location": "asia-south1", "description": "Locational Endpoint" }, { "description": "Locational Endpoint", "location": "asia-south2", "endpointUrl": "https://asia-south2-aiplatform.googleapis.com/" }, { "endpointUrl": "https://asia-southeast1-aiplatform.googleapis.com/", "location": "asia-southeast1", "description": "Locational Endpoint" }, { "description": "Locational Endpoint", "location": "asia-southeast2", "endpointUrl": "https://asia-southeast2-aiplatform.googleapis.com/" }, { "endpointUrl": "https://asia-southeast3-aiplatform.googleapis.com/", "location": "asia-southeast3", "description": "Locational Endpoint" }, { "endpointUrl": "https://australia-southeast1-aiplatform.googleapis.com/", "description": "Locational Endpoint", "location": "australia-southeast1" }, { "endpointUrl": "https://australia-southeast2-aiplatform.googleapis.com/", "location": "australia-southeast2", "description": "Locational Endpoint" }, { "location": "europe-central2", "endpointUrl": "https://europe-central2-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "location": "europe-north1", "endpointUrl": "https://europe-north1-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "location": "europe-north2", "description": "Locational Endpoint", "endpointUrl": "https://europe-north2-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "endpointUrl": "https://europe-southwest1-aiplatform.googleapis.com/", "location": "europe-southwest1" }, { "endpointUrl": "https://europe-west1-aiplatform.googleapis.com/", "location": "europe-west1", "description": "Locational Endpoint" }, { "location": "europe-west10", "endpointUrl": "https://europe-west10-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "endpointUrl": "https://europe-west15-aiplatform.googleapis.com/", "location": "europe-west15", "description": "Locational Endpoint" }, { "endpointUrl": "https://europe-west2-aiplatform.googleapis.com/", "description": "Locational Endpoint", "location": "europe-west2" }, { "endpointUrl": "https://europe-west3-aiplatform.googleapis.com/", "description": "Locational Endpoint", "location": "europe-west3" }, { "location": "europe-west4", "description": "Locational Endpoint", "endpointUrl": "https://europe-west4-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "endpointUrl": "https://europe-west6-aiplatform.googleapis.com/", "location": "europe-west6" }, { "description": "Locational Endpoint", "endpointUrl": "https://europe-west8-aiplatform.googleapis.com/", "location": "europe-west8" }, { "description": "Locational Endpoint", "location": "europe-west9", "endpointUrl": "https://europe-west9-aiplatform.googleapis.com/" }, { "endpointUrl": "https://europe-west12-aiplatform.googleapis.com/", "description": "Locational Endpoint", "location": "europe-west12" }, { "description": "Locational Endpoint", "endpointUrl": "https://me-central1-aiplatform.googleapis.com/", "location": "me-central1" }, { "location": "me-central2", "description": "Locational Endpoint", "endpointUrl": "https://me-central2-aiplatform.googleapis.com/" }, { "location": "me-west1", "description": "Locational Endpoint", "endpointUrl": "https://me-west1-aiplatform.googleapis.com/" }, { "location": "northamerica-northeast1", "endpointUrl": "https://northamerica-northeast1-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "description": "Locational Endpoint", "location": "northamerica-northeast2", "endpointUrl": "https://northamerica-northeast2-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "endpointUrl": "https://southamerica-east1-aiplatform.googleapis.com/", "location": "southamerica-east1" }, { "endpointUrl": "https://southamerica-west1-aiplatform.googleapis.com/", "description": "Locational Endpoint", "location": "southamerica-west1" }, { "endpointUrl": "https://us-central1-aiplatform.googleapis.com/", "location": "us-central1", "description": "Locational Endpoint" }, { "location": "us-central2", "description": "Locational Endpoint", "endpointUrl": "https://us-central2-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "location": "us-east1", "endpointUrl": "https://us-east1-aiplatform.googleapis.com/" }, { "location": "us-east4", "description": "Locational Endpoint", "endpointUrl": "https://us-east4-aiplatform.googleapis.com/" }, { "endpointUrl": "https://us-east7-aiplatform.googleapis.com/", "location": "us-east7", "description": "Locational Endpoint" }, { "location": "us-south1", "description": "Locational Endpoint", "endpointUrl": "https://us-south1-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "endpointUrl": "https://us-west1-aiplatform.googleapis.com/", "location": "us-west1" }, { "endpointUrl": "https://us-west2-aiplatform.googleapis.com/", "location": "us-west2", "description": "Locational Endpoint" }, { "location": "us-west3", "endpointUrl": "https://us-west3-aiplatform.googleapis.com/", "description": "Locational Endpoint" }, { "location": "us-west4", "description": "Locational Endpoint", "endpointUrl": "https://us-west4-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "location": "us-east5", "endpointUrl": "https://us-east5-aiplatform.googleapis.com/" }, { "description": "Locational Endpoint", "location": "us-west8", "endpointUrl": "https://us-west8-aiplatform.googleapis.com/" }, { "location": "us", "description": "Regional Endpoint", "endpointUrl": "https://aiplatform.us.rep.googleapis.com/" }, { "endpointUrl": "https://aiplatform.eu.rep.googleapis.com/", "location": "eu", "description": "Regional Endpoint" }, { "endpointUrl": "https://aiplatform-preprod.us.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us" }, { "description": "Regional Endpoint", "endpointUrl": "https://aiplatform-preprod.eu.rep.googleapis.com/", "location": "eu" } ], "version_module": true, "schemas": { "GoogleCloudAiplatformV1beta1ListNotebookRuntimeTemplatesResponse": { "description": "Response message for NotebookService.ListNotebookRuntimeTemplates.", "properties": { "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListNotebookRuntimeTemplatesRequest.page_token to obtain that page.", "type": "string" }, "notebookRuntimeTemplates": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate" }, "description": "List of NotebookRuntimeTemplates in the requested page." } }, "id": "GoogleCloudAiplatformV1beta1ListNotebookRuntimeTemplatesResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1SecretRef": { "description": "Reference to a secret stored in the Cloud Secret Manager that will provide the value for this environment variable.", "properties": { "secret": { "type": "string", "description": "Required. The name of the secret in Cloud Secret Manager. Format: {secret_name}." }, "version": { "type": "string", "description": "The Cloud Secret Manager secret version. Can be 'latest' for the latest version, an integer for a specific version, or a version alias." } }, "id": "GoogleCloudAiplatformV1beta1SecretRef", "type": "object" }, "GoogleCloudAiplatformV1beta1ListAgentAnomalyDetectionScopesResponse": { "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "agentAnomalyDetectionScopes": { "description": "A list of AgentAnomalyDetectionScopes that matches the specified filter in the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope" } } }, "id": "GoogleCloudAiplatformV1beta1ListAgentAnomalyDetectionScopesResponse", "type": "object", "description": "Response message for AgentAnomalyDetectionService.ListAgentAnomalyDetectionScopes." }, "GoogleCloudAiplatformV1beta1DeployRequestModelConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DeployRequestModelConfig", "properties": { "modelDisplayName": { "description": "Optional. The user-specified display name of the uploaded model. If not set, a default name will be used.", "type": "string" }, "acceptEula": { "description": "Optional. Whether the user accepts the End User License Agreement (EULA) for the model.", "type": "boolean" }, "containerSpec": { "description": "Optional. The specification of the container that is to be used when deploying. If not set, the default container spec will be used.", "$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec" }, "huggingFaceCacheEnabled": { "type": "boolean", "description": "Optional. If true, the model will deploy with a cached version instead of directly downloading the model artifacts from Hugging Face. This is suitable for VPC-SC users with limited internet access." }, "modelUserId": { "description": "Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. When not provided, Vertex AI will generate a value for this ID. When Model Registry model is provided, this field will be ignored. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", "type": "string" }, "huggingFaceAccessToken": { "description": "Optional. The Hugging Face read access token used to access the model artifacts of gated models.", "type": "string" } }, "description": "The model config to use for the deployment." }, "GoogleCloudAiplatformV1beta1GenerateAccessTokenRequest": { "description": "Request message for NotebookInternalService.GenerateAccessToken.", "id": "GoogleCloudAiplatformV1beta1GenerateAccessTokenRequest", "type": "object", "properties": { "vmToken": { "type": "string", "description": "Required. The VM identity token (a JWT) for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity" } } }, "GoogleCloudAiplatformV1beta1MemoryMetadataValue": { "id": "GoogleCloudAiplatformV1beta1MemoryMetadataValue", "type": "object", "description": "Memory metadata.", "properties": { "stringValue": { "description": "Represents a string value.", "type": "string" }, "doubleValue": { "format": "double", "description": "Represents a double value.", "type": "number" }, "timestampValue": { "type": "string", "description": "Represents a timestamp value. When filtering on timestamp values, only the seconds field will be compared.", "format": "google-datetime" }, "boolValue": { "description": "Represents a boolean value.", "type": "boolean" } } }, "GoogleCloudAiplatformV1beta1PurgeContextsResponse": { "description": "Response message for MetadataService.PurgeContexts.", "id": "GoogleCloudAiplatformV1beta1PurgeContextsResponse", "properties": { "purgeCount": { "format": "int64", "description": "The number of Contexts that this request deleted (or, if `force` is false, the number of Contexts that will be deleted). This can be an estimate.", "type": "string" }, "purgeSample": { "items": { "type": "string" }, "description": "A sample of the Context names that will be deleted. Only populated if `force` is set to false. The maximum number of samples is 100 (it is possible to return fewer).", "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningExample": { "description": "User-facing format for Gemini Reinforcement Tuning examples on Vertex.", "properties": { "contents": { "description": "Multi-turn contents that represents the Prompt.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "systemInstruction": { "description": "Corresponds to system_instruction in user-facing GenerateContentRequest.", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "references": { "type": "object", "description": "References for the given prompt. The key is the name of the reference, and the value is the reference itself. Users can use this field together with the reward configurations to calculate rewards for reinforcement tuning. For example, users can set the following references: ``` { \"concise_answer\": \"Yes\", \"verbose_answer\": \"The answer is Yes\" } ``` Then in a ReinforcementTuningCodeExecutionRewardScorer reward function config, for example, they can define a python code snippet as follows: ``` def evaluate(example, response) -\u003e float: response_str = response.get(\"parts\", [])0 references = example.get(\"references\", {}) if response_str == references.get(\"concise_answer\"): return 1.0 return -1.0 ``` In this case, references can serve the purpose of holding the ground truth of this example in the training/validation dataset.", "additionalProperties": { "type": "string" } }, "tools": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "description": "Optional. Corresponds to tools in user-facing GenerateContentRequest.", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningExample" }, "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMapping": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMapping", "properties": { "idColumn": { "type": "string", "description": "Required. The column with unique identifiers for each data point." }, "restricts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingRestrict" }, "description": "Optional. List of restricts for string values.", "type": "array" }, "metadataColumns": { "type": "array", "items": { "type": "string" }, "description": "Optional. List of columns containing metadata to be included in the index." }, "embeddingColumn": { "description": "Required. The column with the vector embeddings for each data point.", "type": "string" }, "numericRestricts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingNumericRestrict" }, "description": "Optional. List of restricts for numeric values.", "type": "array" } }, "description": "Mapping of datapoint fields to column names for columnar data sources." }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt": { "description": "Prompt variation that stores preambles in separate fields.", "properties": { "outputPrefixes": { "type": "array", "description": "Preamble: The output prefixes before each example output.", "items": { "type": "string" } }, "inputPrefixes": { "description": "Preamble: The input prefixes before each example input.", "items": { "type": "string" }, "type": "array" }, "infillSuffix": { "description": "Preamble: For infill prompt, the suffix after expected model response.", "type": "string" }, "promptMessage": { "description": "The prompt message.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage" }, "infillPrefix": { "type": "string", "description": "Preamble: For infill prompt, the prefix before expected model response." }, "interactionData": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecInteractionData", "description": "Data for interaction use case." }, "context": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Preamble: The context of the prompt." }, "examples": { "type": "array", "description": "Preamble: A set of examples for expected model response.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList" } }, "contentMetadata": { "type": "array", "description": "Optional. Metadata the model returned with each of `prompt_message.contents`, such as citations and grounding sources. This maps 1:1 to PromptMessage.contents; an entry is empty when its content has no metadata.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata" } }, "predictionInputs": { "description": "Preamble: The input test data for prediction. Each PartList in this field represents one text-only input set for a single model request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList" } }, "appBuilderData": { "description": "Data for app builder use case.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderData" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt" }, "GoogleCloudAiplatformV1beta1RetrievalConfig": { "properties": { "latLng": { "description": "The location of the user.", "$ref": "GoogleTypeLatLng" }, "languageCode": { "type": "string", "description": "The language code of the user." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RetrievalConfig", "description": "Retrieval config." }, "GenaiVertexV1beta1CodeMenderAgentConfig": { "type": "object", "properties": { "sessionConfig": { "$ref": "GenaiVertexV1beta1CodeMenderAgentConfigSessionConfig", "description": "Optional session-specific configurations to override default agent behavior." }, "sessionId": { "type": "string", "description": "Parameter for grouping multiple interactions that belong to the same CodeMender session." }, "fixRequest": { "$ref": "GenaiVertexV1beta1CodeMenderAgentConfigFixRequest", "description": "Parameters for fixing vulnerabilities." }, "findRequest": { "description": "Parameters for finding vulnerabilities.", "$ref": "GenaiVertexV1beta1CodeMenderAgentConfigFindRequest" }, "model": { "description": "The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.", "type": "string" } }, "id": "GenaiVertexV1beta1CodeMenderAgentConfig", "description": "Configuration for the CodeMender agent." }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpec": { "type": "object", "description": "The specification of a SandboxEnvironment.", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpec", "properties": { "codeExecutionEnvironment": { "description": "Optional. The code execution environment.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecCodeExecutionEnvironment" }, "useGkeTd": { "description": "Optional. Immutable. Whether to provision the SandboxEnvironment via the GKE TD pool. Immutable.", "type": "boolean" }, "shellEnvironment": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecShellEnvironment", "description": "Optional. The shell environment for executing shell commands and scripts." }, "computerUseEnvironment": { "description": "Optional. The computer use environment.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecComputerUseEnvironment" } } }, "GoogleCloudAiplatformV1beta1IndexDatapoint": { "properties": { "featureVector": { "description": "Required. Feature embedding vector for dense index. An array of numbers with the length of [NearestNeighborSearchConfig.dimensions].", "items": { "type": "number", "format": "float" }, "type": "array" }, "embeddingMetadata": { "type": "object", "description": "Optional. The key-value map of additional metadata for the datapoint.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "datapointId": { "type": "string", "description": "Required. Unique identifier of the datapoint." }, "crowdingTag": { "description": "Optional. CrowdingTag of the datapoint, the number of neighbors to return in each crowding can be configured during query.", "$ref": "GoogleCloudAiplatformV1beta1IndexDatapointCrowdingTag" }, "restricts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapointRestriction" }, "description": "Optional. List of Restrict of the datapoint, used to perform \"restricted searches\" where boolean rule are used to filter the subset of the database eligible for matching. This uses categorical tokens. See: https://cloud.google.com/vertex-ai/docs/matching-engine/filtering", "type": "array" }, "sparseEmbedding": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapointSparseEmbedding", "description": "Optional. Feature embedding vector for sparse index." }, "numericRestricts": { "type": "array", "description": "Optional. List of Restrict of the datapoint, used to perform \"restricted searches\" where boolean rule are used to filter the subset of the database eligible for matching. This uses numeric comparisons.", "items": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapointNumericRestriction" } } }, "description": "A datapoint of Index.", "id": "GoogleCloudAiplatformV1beta1IndexDatapoint", "type": "object" }, "GoogleCloudAiplatformV1beta1RougeSpec": { "id": "GoogleCloudAiplatformV1beta1RougeSpec", "properties": { "rougeType": { "type": "string", "description": "Optional. Supported rouge types are rougen[1-9], rougeL, and rougeLsum." }, "splitSummaries": { "description": "Optional. Whether to split summaries while using rougeLsum.", "type": "boolean" }, "useStemmer": { "description": "Optional. Whether to use stemmer to compute rouge score.", "type": "boolean" } }, "description": "Spec for rouge score metric - calculates the recall of n-grams in prediction as compared to reference - returns a score ranging between 0 and 1.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfigTools": { "type": "object", "description": "Represents a list of tools for an agent.", "properties": { "tool": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "description": "Optional. List of tools: each tool can have multiple function declarations." } }, "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfigTools" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInput": { "description": "Input for question answering correctness metric.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInput", "type": "object", "properties": { "metricSpec": { "description": "Required. Spec for question answering correctness score metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessSpec" }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInstance", "description": "Required. Question answering correctness instance." } } }, "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources", "properties": { "reviewSnippets": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet" }, "description": "Snippets of reviews that were used to generate the answer.", "type": "array" } }, "description": "The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content." }, "GoogleCloudAiplatformV1beta1StudySpecDecayCurveAutomatedStoppingSpec": { "description": "The decay curve automated stopping rule builds a Gaussian Process Regressor to predict the final objective value of a Trial based on the already completed Trials and the intermediate measurements of the current Trial. Early stopping is requested for the current Trial if there is very low probability to exceed the optimal value found so far.", "id": "GoogleCloudAiplatformV1beta1StudySpecDecayCurveAutomatedStoppingSpec", "type": "object", "properties": { "useElapsedDuration": { "type": "boolean", "description": "True if Measurement.elapsed_duration is used as the x-axis of each Trials Decay Curve. Otherwise, Measurement.step_count will be used as the x-axis." } } }, "GoogleCloudAiplatformV1beta1ResumeSandboxEnvironmentRequest": { "description": "Request message for SandboxEnvironmentService.ResumeSandboxEnvironment.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ResumeSandboxEnvironmentRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1QueryExtensionResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1QueryExtensionResponse", "description": "Response message for ExtensionExecutionService.QueryExtension.", "properties": { "steps": { "description": "Steps of extension or LLM interaction, can contain function call, function response, or text response. The last step contains the final response to the query.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array" }, "failureMessage": { "type": "string", "description": "Failure message if any." } } }, "GoogleCloudAiplatformV1beta1SchemaPredictionResult": { "properties": { "key": { "description": "Optional user-provided key from the input instance.", "type": "string" }, "instance": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "User's input instance. Struct is used here instead of Any so that JsonFormat does not append an extra \"@type\" field when we convert the proto to JSON.", "type": "object" }, "error": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPredictionResultError", "description": "The error result. Do not set prediction if this is set." }, "prediction": { "description": "The prediction result. Value is used here instead of Any so that JsonFormat does not append an extra \"@type\" field when we convert the proto to JSON and so we can represent array of objects. Do not set error if this is set.", "type": "any" } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictionResult", "description": "Represents a line of JSONL in the batch prediction output file.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunDataSource": { "type": "object", "properties": { "evaluationSet": { "description": "The EvaluationSet resource name. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`", "type": "string" }, "bigqueryRequestSet": { "description": "Evaluation data in bigquery.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryRequestSet" } }, "description": "The data source for the evaluation run.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunDataSource" }, "GoogleCloudAiplatformV1beta1UpdateSpecialistPoolOperationMetadata": { "type": "object", "description": "Runtime operation metadata for SpecialistPoolService.UpdateSpecialistPool.", "id": "GoogleCloudAiplatformV1beta1UpdateSpecialistPoolOperationMetadata", "properties": { "specialistPool": { "description": "Output only. The name of the SpecialistPool to which the specialists are being added. Format: `projects/{project_id}/locations/{location_id}/specialistPools/{specialist_pool}`", "readOnly": true, "type": "string" }, "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1AgentModelConfig": { "description": "Selects the model configuration for an agent. Starts with just the model id/alias; extensible with further model parameters without a breaking change.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AgentModelConfig", "properties": { "temperature": { "description": "Optional. Sampling temperature for the model's generation config (valid range (0.0, 2.0]); a value outside that range leaves the backend default standing.", "format": "float", "type": "number" }, "model": { "description": "Optional. Publisher model resource name (an `aiplatform.googleapis.com/PublisherModel`) of the form \"publishers/{publisher}/models/{model}\", e.g. \"publishers/anthropic/models/claude-opus-4-8\" or \"publishers/google/models/gemini-3-flash\". Empty means the agent's default gemini model.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ListPersistentResourcesResponse": { "properties": { "persistentResources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1PersistentResource" }, "type": "array" }, "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListPersistentResourcesRequest.page_token to obtain that page.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ListPersistentResourcesResponse", "description": "Response message for PersistentResourceService.ListPersistentResources", "type": "object" }, "GoogleCloudAiplatformV1beta1ListCustomJobsResponse": { "id": "GoogleCloudAiplatformV1beta1ListCustomJobsResponse", "description": "Response message for JobService.ListCustomJobs", "type": "object", "properties": { "customJobs": { "description": "List of CustomJobs in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1CustomJob" } }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListCustomJobsRequest.page_token to obtain that page.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1NearestNeighborQueryNumericFilter": { "id": "GoogleCloudAiplatformV1beta1NearestNeighborQueryNumericFilter", "properties": { "valueFloat": { "type": "number", "description": "float value type.", "format": "float" }, "valueDouble": { "description": "double value type.", "type": "number", "format": "double" }, "op": { "type": "string", "enumDescriptions": [ "Unspecified operator.", "Entities are eligible if their value is \u003c the query's.", "Entities are eligible if their value is \u003c= the query's.", "Entities are eligible if their value is == the query's.", "Entities are eligible if their value is \u003e= the query's.", "Entities are eligible if their value is \u003e the query's.", "Entities are eligible if their value is != the query's." ], "description": "Optional. This MUST be specified for queries and must NOT be specified for database points.", "enum": [ "OPERATOR_UNSPECIFIED", "LESS", "LESS_EQUAL", "EQUAL", "GREATER_EQUAL", "GREATER", "NOT_EQUAL" ] }, "valueInt": { "description": "int value type.", "format": "int64", "type": "string" }, "name": { "description": "Required. Column name in BigQuery that used as filters.", "type": "string" } }, "description": "Numeric filter is used to search a subset of the entities by using boolean rules on numeric columns. For example: Database Point 0: {name: \"a\" value_int: 42} {name: \"b\" value_float: 1.0} Database Point 1: {name: \"a\" value_int: 10} {name: \"b\" value_float: 2.0} Database Point 2: {name: \"a\" value_int: -1} {name: \"b\" value_float: 3.0} Query: {name: \"a\" value_int: 12 operator: LESS} // Matches Point 1, 2 {name: \"b\" value_float: 2.0 operator: EQUAL} // Matches Point 1", "type": "object" }, "GoogleCloudAiplatformV1beta1FluencyInput": { "description": "Input for fluency metric.", "id": "GoogleCloudAiplatformV1beta1FluencyInput", "type": "object", "properties": { "instance": { "description": "Required. Fluency instance.", "$ref": "GoogleCloudAiplatformV1beta1FluencyInstance" }, "metricSpec": { "description": "Required. Spec for fluency score metric.", "$ref": "GoogleCloudAiplatformV1beta1FluencySpec" } } }, "GenaiVertexV1beta1Tool": { "type": "object", "id": "GenaiVertexV1beta1Tool", "description": "A tool that can be used by the model.", "properties": { "fileSearch": { "$ref": "GenaiVertexV1beta1FileSearch", "description": "A tool that can be used by the model to search files." }, "googleSearch": { "$ref": "GenaiVertexV1beta1GoogleSearch", "description": "A tool that can be used by the model to search Google." }, "googleMaps": { "$ref": "GenaiVertexV1beta1GoogleMaps", "description": "A tool that can be used by the model to search Google Maps." }, "mcpServer": { "description": "A MCPServer is a server that can be called by the model to perform actions.", "$ref": "GenaiVertexV1beta1McpServer" }, "function": { "$ref": "GenaiVertexV1beta1Function", "description": "A function that can be used by the model." }, "computerUse": { "$ref": "GenaiVertexV1beta1ComputerUse", "description": "Tool to support the model interacting directly with the computer." }, "codeExecution": { "$ref": "GenaiVertexV1beta1CodeExecution", "description": "A tool that can be used by the model to execute code." }, "urlContext": { "description": "A tool that can be used by the model to fetch URL context.", "$ref": "GenaiVertexV1beta1UrlContext" }, "retrieval": { "description": "A tool that can be used by the model to retrieve files.", "$ref": "GenaiVertexV1beta1Retrieval" } } }, "GoogleCloudAiplatformV1beta1CompleteTrialRequest": { "id": "GoogleCloudAiplatformV1beta1CompleteTrialRequest", "description": "Request message for VizierService.CompleteTrial.", "type": "object", "properties": { "trialInfeasible": { "description": "Optional. True if the Trial cannot be run with the given Parameter, and final_measurement will be ignored.", "type": "boolean" }, "infeasibleReason": { "type": "string", "description": "Optional. A human readable reason why the trial was infeasible. This should only be provided if `trial_infeasible` is true." }, "finalMeasurement": { "$ref": "GoogleCloudAiplatformV1beta1Measurement", "description": "Optional. If provided, it will be used as the completed Trial's final_measurement; Otherwise, the service will auto-select a previously reported measurement as the final-measurement" } } }, "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentTemplatesResponse": { "properties": { "sandboxEnvironmentTemplates": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate" }, "type": "array", "description": "The SandboxEnvironmentTemplates matching the request." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListSandboxEnvironmentTemplatesRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentTemplatesResponse", "description": "Response message for SandboxEnvironmentService.ListSandboxEnvironmentTemplates." }, "GoogleCloudAiplatformV1beta1GoogleSearchRetrieval": { "type": "object", "description": "Tool to retrieve public web data for grounding, powered by Google.", "properties": { "dynamicRetrievalConfig": { "$ref": "GoogleCloudAiplatformV1beta1DynamicRetrievalConfig", "description": "Specifies the dynamic retrieval configuration for the given source." } }, "id": "GoogleCloudAiplatformV1beta1GoogleSearchRetrieval" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpec": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpec", "properties": { "containerSpec": { "description": "Deploy from a container image with a defined entrypoint and commands.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecContainerSpec" }, "serviceAccount": { "type": "string", "description": "Optional. The service account that the Reasoning Engine artifact runs as. It should have \"roles/storage.objectViewer\" for reading the user project's Cloud Storage and \"roles/aiplatform.user\" for using Vertex extensions. If not specified, the Vertex AI Reasoning Engine Service Agent in the project will be used." }, "identityType": { "description": "Optional. The identity type to use for the Reasoning Engine. If not specified, the `service_account` field will be used if set, otherwise the default Vertex AI Reasoning Engine Service Agent in the project will be used.", "enum": [ "IDENTITY_TYPE_UNSPECIFIED", "SERVICE_ACCOUNT", "AGENT_IDENTITY" ], "enumDescriptions": [ "Default value. Use a custom service account if the `service_account` field is set, otherwise use the default Vertex AI Reasoning Engine Service Agent in the project. Same behavior as SERVICE_ACCOUNT.", "Use a custom service account if the `service_account` field is set, otherwise use the default Vertex AI Reasoning Engine Service Agent in the project.", "Use Agent Identity. The `service_account` field must not be set." ], "type": "string" }, "packageSpec": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec", "description": "Optional. User provided package spec of the ReasoningEngine. Ignored when users directly specify a deployment image through `deployment_spec.first_party_image_override`, but keeping the field_behavior to avoid introducing breaking changes. The `deployment_source` field should not be set if `package_spec` is specified." }, "deploymentSpec": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec", "description": "Optional. The specification of a Reasoning Engine deployment." }, "effectiveIdentity": { "readOnly": true, "type": "string", "description": "Output only. The identity to use for the Reasoning Engine. It can contain one of the following values: * service-{project}@gcp-sa-aiplatform-re.googleapis.com (for SERVICE_AGENT identity type) * {name}@{project}.gserviceaccount.com (for SERVICE_ACCOUNT identity type) * agents.global.{org}.system.id.goog/resources/aiplatform/projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine} (for AGENT_IDENTITY identity type)" }, "buildSpec": { "description": "Optional. Configuration for building container image.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecBuildSpec" }, "classMethods": { "type": "array", "description": "Optional. Declarations for object class methods in OpenAPI specification format.", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "sourceCodeSpec": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpec", "description": "Deploy from source code files with a defined entrypoint." }, "agentFramework": { "type": "string", "description": "Optional. The OSS agent framework used to develop the agent. Currently supported values: \"google-adk\", \"langchain\", \"langgraph\", \"ag2\", \"llama-index\", \"custom\"." }, "agentCard": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. The A2A Agent Card for the agent (if available). It follows the specification at https://a2a-protocol.org/latest/specification/#5-agent-discovery-the-agent-card." } }, "description": "ReasoningEngine configurations", "type": "object" }, "GoogleCloudAiplatformV1beta1ToolCallValidResults": { "id": "GoogleCloudAiplatformV1beta1ToolCallValidResults", "description": "Results for tool call valid metric.", "type": "object", "properties": { "toolCallValidMetricValues": { "type": "array", "description": "Output only. Tool call valid metric values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolCallValidMetricValue" }, "readOnly": true } } }, "GoogleCloudAiplatformV1beta1ListCachedContentsResponse": { "description": "Response with a list of CachedContents.", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "cachedContents": { "items": { "$ref": "GoogleCloudAiplatformV1beta1CachedContent" }, "type": "array", "description": "List of cached contents." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListCachedContentsResponse" }, "GoogleCloudAiplatformV1beta1SampleConfig": { "id": "GoogleCloudAiplatformV1beta1SampleConfig", "type": "object", "description": "Active learning data sampling config. For every active learning labeling iteration, it will select a batch of data based on the sampling strategy.", "properties": { "sampleStrategy": { "type": "string", "enum": [ "SAMPLE_STRATEGY_UNSPECIFIED", "UNCERTAINTY" ], "description": "Field to choose sampling strategy. Sampling strategy will decide which data should be selected for human labeling in every batch.", "enumDescriptions": [ "Default will be treated as UNCERTAINTY.", "Sample the most uncertain data to label." ] }, "followingBatchSamplePercentage": { "type": "integer", "format": "int32", "description": "The percentage of data needed to be labeled in each following batch (except the first batch)." }, "initialBatchSamplePercentage": { "type": "integer", "format": "int32", "description": "The percentage of data needed to be labeled in the first batch." } } }, "GoogleCloudAiplatformV1beta1EvaluationItem": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationItem", "description": "EvaluationItem is a single evaluation request or result. The content of an EvaluationItem is immutable - it cannot be updated once created. EvaluationItems can be deleted when no longer needed.", "properties": { "evaluationItemType": { "type": "string", "enum": [ "EVALUATION_ITEM_TYPE_UNSPECIFIED", "REQUEST", "RESULT" ], "enumDescriptions": [ "The default value. This value is unused.", "The EvaluationItem is a request to evaluate.", "The EvaluationItem is the result of evaluation." ], "description": "Required. The type of the EvaluationItem." }, "error": { "description": "Output only. Error for the evaluation item.", "readOnly": true, "$ref": "GoogleRpcStatus" }, "labels": { "description": "Optional. Labels for the EvaluationItem.", "type": "object", "additionalProperties": { "type": "string" } }, "gcsUri": { "description": "The Cloud Storage object where the request or response is stored.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when this item was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "evaluationRequest": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRequest", "description": "The request to evaluate." }, "evaluationResponse": { "description": "Output only. The response from evaluation.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationResult", "readOnly": true }, "displayName": { "description": "Required. The display name of the EvaluationItem.", "type": "string" }, "name": { "type": "string", "description": "Identifier. The resource name of the EvaluationItem. Format: `projects/{project}/locations/{location}/evaluationItems/{evaluation_item}`" }, "metadata": { "description": "Optional. Metadata for the EvaluationItem.", "type": "any" } } }, "GoogleCloudAiplatformV1beta1ListDatasetVersionsResponse": { "id": "GoogleCloudAiplatformV1beta1ListDatasetVersionsResponse", "description": "Response message for DatasetService.ListDatasetVersions.", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "datasetVersions": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DatasetVersion" }, "description": "A list of DatasetVersions that matches the specified filter in the request." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoActionRecognitionPredictionResult": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoActionRecognitionPredictionResult", "properties": { "timeSegmentStart": { "description": "The beginning, inclusive, of the video's time segment in which the AnnotationSpec has been identified. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end.", "format": "google-duration", "type": "string" }, "confidence": { "format": "float", "description": "The Model's confidence in correction of this prediction, higher value means higher confidence.", "type": "number" }, "timeSegmentEnd": { "type": "string", "description": "The end, exclusive, of the video's time segment in which the AnnotationSpec has been identified. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end.", "format": "google-duration" }, "id": { "type": "string", "description": "The resource ID of the AnnotationSpec that had been identified." }, "displayName": { "description": "The display name of the AnnotationSpec that had been identified.", "type": "string" } }, "type": "object", "description": "Prediction output format for Video Action Recognition." }, "GenaiVertexV1beta1ToolResultStep": { "type": "object", "description": "Tool result step.", "properties": { "googleSearchResult": { "$ref": "GenaiVertexV1beta1GoogleSearchResultStep" }, "callId": { "type": "string", "description": "Required. ID to match the ID from the function call block." }, "signature": { "type": "string", "description": "A signature hash for backend validation.", "format": "byte" }, "codeExecutionResult": { "$ref": "GenaiVertexV1beta1CodeExecutionResultStep" }, "functionResult": { "$ref": "GenaiVertexV1beta1FunctionResultStep" }, "retrievalResult": { "$ref": "GenaiVertexV1beta1RetrievalResultStep" }, "urlContextResult": { "$ref": "GenaiVertexV1beta1UrlContextResultStep" }, "processingResult": { "$ref": "GenaiVertexV1beta1ProcessingResultStep" }, "fileSearchResult": { "$ref": "GenaiVertexV1beta1FileSearchResultStep" }, "googleMapsResult": { "$ref": "GenaiVertexV1beta1GoogleMapsResultStep" }, "mcpServerToolResult": { "$ref": "GenaiVertexV1beta1McpServerToolResultStep" } }, "id": "GenaiVertexV1beta1ToolResultStep" }, "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpec": { "type": "object", "properties": { "notificationChannelConfigs": { "type": "array", "description": "Notification channel config.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecNotificationChannelConfig" } }, "emailConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecEmailConfig", "description": "Email alert config." }, "enableCloudLogging": { "type": "boolean", "description": "Dump the anomalies to Cloud Logging. The anomalies will be put to json payload encoded from proto google.cloud.aiplatform.logging.ModelMonitoringAnomaliesLogEntry. This can be further sinked to Pub/Sub or any other services supported by Cloud Logging." } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpec", "description": "Notification spec(email, notification channel) for model monitoring statistics/alerts." }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpec": { "description": "Represents a single parameter to optimize.", "type": "object", "properties": { "scaleType": { "description": "How the parameter should be scaled. Leave unset for `CATEGORICAL` parameters.", "enumDescriptions": [ "By default, no scaling is applied.", "Scales the feasible space to (0, 1) linearly.", "Scales the feasible space logarithmically to (0, 1). The entire feasible space must be strictly positive.", "Scales the feasible space \"reverse\" logarithmically to (0, 1). The result is that values close to the top of the feasible space are spread out more than points near the bottom. The entire feasible space must be strictly positive." ], "type": "string", "enum": [ "SCALE_TYPE_UNSPECIFIED", "UNIT_LINEAR_SCALE", "UNIT_LOG_SCALE", "UNIT_REVERSE_LOG_SCALE" ] }, "conditionalParameterSpecs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpec" }, "type": "array", "description": "A conditional parameter node is active if the parameter's value matches the conditional node's parent_value_condition. If two items in conditional_parameter_specs have the same name, they must have disjoint parent_value_condition." }, "discreteValueSpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDiscreteValueSpec", "description": "The value spec for a 'DISCRETE' parameter." }, "doubleValueSpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDoubleValueSpec", "description": "The value spec for a 'DOUBLE' parameter." }, "integerValueSpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecIntegerValueSpec", "description": "The value spec for an 'INTEGER' parameter." }, "categoricalValueSpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecCategoricalValueSpec", "description": "The value spec for a 'CATEGORICAL' parameter." }, "parameterId": { "description": "Required. The ID of the parameter. Must not contain whitespaces and must be unique amongst all ParameterSpecs.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpec" }, "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfig": { "properties": { "model": { "type": "string", "description": "Optional. The fully qualified name of the publisher model or endpoint to use. Anthropic and Llama third-party models are also supported through Model Garden. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Third-party model formats: `projects/{project}/locations/{location}/publishers/anthropic/models/{model}` or `projects/{project}/locations/{location}/publishers/llama/models/{model}` Endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" }, "agentRunConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfig", "description": "Optional. Agent run config." }, "promptTemplate": { "description": "Optional. The prompt template used for inference. The values for variables in the prompt template are defined in EvaluationItem.EvaluationPrompt.PromptTemplateData.values. If not specified, the prompt template in the EvaluationConfig will be used.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigPromptTemplate" }, "agents": { "description": "Optional. Contains the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AgentConfig" }, "type": "object" }, "agentConfig": { "description": "Optional. Deprecated: Use `agents` instead. Agent config used to generate responses.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigInferenceAgentConfig", "deprecated": true }, "parallelism": { "description": "Optional. The parallelism of the evaluation run for the inference step. If not specified, the default parallelism will be used.", "format": "int32", "type": "integer" }, "generationConfig": { "description": "Optional. Generation config.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfig", "type": "object", "description": "Defines the configuration for a candidate model or agent being evaluated. `InferenceConfig` encapsulates all the necessary information to invoke or scrape the candidate during the evaluation run. This includes direct model inference parameters, agent execution settings, and multi-turn scraping configurations (such as user simulators). It serves as the primary representation of the candidate across different stages of the evaluation process." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationAutoTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationAutoTransformation", "description": "Training pipeline will infer the proper transformation based on the statistic of dataset.", "properties": { "columnName": { "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GenerationConfigModelConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerationConfigModelConfig", "properties": { "featureSelectionPreference": { "enumDescriptions": [ "Unspecified feature selection preference.", "Prefer higher quality over lower cost.", "Balanced feature selection preference.", "Prefer lower cost over higher quality." ], "type": "string", "enum": [ "FEATURE_SELECTION_PREFERENCE_UNSPECIFIED", "PRIORITIZE_QUALITY", "BALANCED", "PRIORITIZE_COST" ], "description": "Required. Feature selection preference." } }, "description": "Config for model selection." }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSourceDirectMemory": { "description": "A direct memory to upload to Memory Bank.", "properties": { "fact": { "description": "Required. The fact to consolidate with existing memories.", "type": "string" }, "topics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryTopicId" }, "description": "Optional. The topics that the consolidated memories should be associated with.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSourceDirectMemory", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryExactMatchSpec": { "id": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchSpec", "description": "Spec for TrajectoryExactMatch metric - returns 1 if tool calls in the reference trajectory exactly match the predicted trajectory, else 0.", "type": "object", "properties": {} }, "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces": { "properties": { "url": { "type": "string" }, "placeId": { "type": "string" }, "reviewSnippets": { "items": { "$ref": "GenaiVertexV1beta1ReviewSnippet" }, "type": "array" }, "name": { "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessResult": { "type": "object", "properties": { "score": { "readOnly": true, "type": "number", "description": "Output only. Question Answering Correctness score.", "format": "float" }, "confidence": { "format": "float", "description": "Output only. Confidence for question answering correctness score.", "type": "number", "readOnly": true }, "explanation": { "type": "string", "readOnly": true, "description": "Output only. Explanation for question answering correctness score." } }, "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessResult", "description": "Spec for question answering correctness result." }, "GoogleCloudAiplatformV1beta1MultiSpeakerVoiceConfig": { "description": "Configuration for a multi-speaker text-to-speech request.", "properties": { "speakerVoiceConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SpeakerVoiceConfig" }, "type": "array", "description": "Required. A list of configurations for the voices of the speakers. Exactly two speaker voice configurations must be provided." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MultiSpeakerVoiceConfig" }, "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingNumericRestrict": { "type": "object", "properties": { "valueType": { "type": "string", "enumDescriptions": [ "Should not be used.", "Represents 64 bit integer.", "Represents 32 bit float.", "Represents 64 bit float." ], "description": "Required. Numeric type of the restrict. Must be consistent for all datapoints within the namespace.", "enum": [ "VALUE_TYPE_UNSPECIFIED", "INT", "FLOAT", "DOUBLE" ] }, "namespace": { "type": "string", "description": "Required. The namespace of the restrict." }, "valueColumn": { "description": "Optional. The column containing the numeric value.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingNumericRestrict", "description": "Restrictions on numeric values." }, "GoogleCloudAiplatformV1beta1Session": { "properties": { "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your Sessions. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "expireTime": { "type": "string", "description": "Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input. The minimum value is 24 hours from the time of creation.", "format": "google-datetime" }, "updateTime": { "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when the session was updated.", "readOnly": true }, "ttl": { "description": "Optional. Input only. The TTL for this session. The minimum value is 24 hours.", "type": "string", "format": "google-duration" }, "userId": { "description": "Required. Immutable. String id provided by the user", "type": "string" }, "displayName": { "description": "Optional. The display name of the session.", "type": "string" }, "createTime": { "readOnly": true, "description": "Output only. Timestamp when the session was created.", "format": "google-datetime", "type": "string" }, "sessionState": { "description": "Optional. Session specific memory which stores key conversation points.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "name": { "type": "string", "description": "Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'." } }, "type": "object", "description": "A session contains a set of actions between users and Vertex agents.", "id": "GoogleCloudAiplatformV1beta1Session" }, "GoogleCloudAiplatformV1beta1Measurement": { "properties": { "metrics": { "type": "array", "description": "Output only. A list of metrics got by evaluating the objective functions using suggested Parameter values.", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1MeasurementMetric" } }, "stepCount": { "format": "int64", "type": "string", "description": "Output only. The number of steps the machine learning model has been trained for. Must be non-negative.", "readOnly": true }, "elapsedDuration": { "format": "google-duration", "type": "string", "readOnly": true, "description": "Output only. Time that the Trial has been running at the point of this Measurement." } }, "type": "object", "description": "A message representing a Measurement of a Trial. A Measurement contains the Metrics got by executing a Trial using suggested hyperparameter values.", "id": "GoogleCloudAiplatformV1beta1Measurement" }, "GoogleCloudAiplatformV1beta1GroundingMetadataSourceFlaggingUri": { "type": "object", "properties": { "flagContentUri": { "description": "The URI that can be used to flag the content.", "type": "string" }, "sourceId": { "type": "string", "description": "The ID of the place or review." } }, "id": "GoogleCloudAiplatformV1beta1GroundingMetadataSourceFlaggingUri", "description": "A URI that can be used to flag a place or review for inappropriate content. This is populated only when the grounding source is Google Maps." }, "GoogleCloudAiplatformV1beta1QueryDeployedModelsResponse": { "properties": { "deployedModels": { "type": "array", "deprecated": true, "description": "DEPRECATED Use deployed_model_refs instead.", "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModel" } }, "deployedModelRefs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModelRef" }, "type": "array", "description": "References to the DeployedModels that share the specified deploymentResourcePool." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "totalDeployedModelCount": { "format": "int32", "type": "integer", "description": "The total number of DeployedModels on this DeploymentResourcePool." }, "totalEndpointCount": { "description": "The total number of Endpoints that have DeployedModels on this DeploymentResourcePool.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1QueryDeployedModelsResponse", "type": "object", "description": "Response message for QueryDeployedModels method." }, "GenaiVertexV1beta1VertexAISearchConfig": { "type": "object", "properties": { "engine": { "description": "Optional. Used to specify Vertex AI Search engine.", "type": "string" }, "datastores": { "description": "Optional. Used to specify Vertex AI Search datastores.", "type": "array", "items": { "type": "string" } } }, "id": "GenaiVertexV1beta1VertexAISearchConfig", "description": "Used to specify configuration for VertexAISearch." }, "GoogleCloudAiplatformV1beta1SearchEntryPoint": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SearchEntryPoint", "description": "An entry point for displaying Google Search results. A `SearchEntryPoint` is populated when the grounding source for a model's response is Google Search. It provides information that you can use to display the search results in your application.", "properties": { "renderedContent": { "description": "Optional. An HTML snippet that can be embedded in a web page or an application's webview. This snippet displays a search result, including the title, URL, and a brief description of the search result.", "type": "string" }, "sdkBlob": { "description": "Optional. A base64-encoded JSON object that contains a list of search queries and their corresponding search URLs. This information can be used to build a custom search UI.", "type": "string", "format": "byte" } } }, "GoogleCloudAiplatformV1beta1FeatureSelector": { "id": "GoogleCloudAiplatformV1beta1FeatureSelector", "properties": { "idMatcher": { "description": "Required. Matches Features based on ID.", "$ref": "GoogleCloudAiplatformV1beta1IdMatcher" } }, "type": "object", "description": "Selector for Features of an EntityType." }, "GoogleCloudAiplatformV1beta1CometSpec": { "description": "Spec for Comet metric.", "properties": { "version": { "enum": [ "COMET_VERSION_UNSPECIFIED", "COMET_22_SRC_REF" ], "enumDescriptions": [ "Comet version unspecified.", "Comet 22 for translation + source + reference (source-reference-combined)." ], "description": "Required. Which version to use for evaluation.", "type": "string" }, "targetLanguage": { "description": "Optional. Target language in BCP-47 format. Covers both prediction and reference.", "type": "string" }, "sourceLanguage": { "description": "Optional. Source language in BCP-47 format.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1CometSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchMigrateResourcesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesRequest", "properties": { "migrateResourceRequests": { "description": "Required. The request messages specifying the resources to migrate. They must be in the same location as the destination. Up to 50 resources can be migrated in one batch.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequest" }, "type": "array" } }, "description": "Request message for MigrationService.BatchMigrateResources." }, "GoogleCloudAiplatformV1beta1CustomJob": { "id": "GoogleCloudAiplatformV1beta1CustomJob", "properties": { "name": { "readOnly": true, "description": "Output only. Resource name of a CustomJob.", "type": "string" }, "jobSpec": { "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec", "description": "Required. Job spec." }, "encryptionSpec": { "description": "Customer-managed encryption key options for a CustomJob. If this is set, then all resources created by the CustomJob will be encrypted with the provided encryption key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "updateTime": { "format": "google-datetime", "description": "Output only. Time when the CustomJob was most recently updated.", "readOnly": true, "type": "string" }, "displayName": { "description": "Required. The display name of the CustomJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "startTime": { "readOnly": true, "description": "Output only. Time when the CustomJob for the first time entered the `JOB_STATE_RUNNING` state.", "format": "google-datetime", "type": "string" }, "createTime": { "description": "Output only. Time when the CustomJob was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "labels": { "description": "The labels with user-defined metadata to organize CustomJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "type": "object", "additionalProperties": { "type": "string" } }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "state": { "type": "string", "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "readOnly": true, "description": "Output only. The detailed state of the job.", "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ] }, "endTime": { "description": "Output only. Time when the CustomJob entered any of the following states: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`.", "readOnly": true, "type": "string", "format": "google-datetime" }, "satisfiesPzi": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "webAccessUris": { "description": "Output only. URIs for accessing [interactive shells](https://cloud.google.com/vertex-ai/docs/training/monitor-debug-interactive-shell) (one URI for each training node). Only available if job_spec.enable_web_access is `true`. The keys are names of each node in the training job; for example, `workerpool0-0` for the primary node, `workerpool1-0` for the first node in the second worker pool, and `workerpool1-1` for the second node in the second worker pool. The values are the URIs for each node's interactive shell.", "additionalProperties": { "type": "string" }, "readOnly": true, "type": "object" }, "error": { "description": "Output only. Only populated when job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "readOnly": true, "$ref": "GoogleRpcStatus" } }, "description": "Represents a job that runs custom workloads such as a Docker container or a Python package. A CustomJob can have multiple worker pools and each worker pool can have its own machine and input spec. A CustomJob will be cleaned up once the job enters terminal state (failed or succeeded).", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecDataDriftSpec": { "type": "object", "description": "Data drift monitoring spec. Data drift measures the distribution distance between the current dataset and a baseline dataset. A typical use case is to detect data drift between the recent production serving dataset and the training dataset, or to compare the recent production dataset with a dataset from a previous period.", "properties": { "features": { "description": "Feature names / Prediction output names interested in monitoring. These should be a subset of the input feature names or prediction output names specified in the monitoring schema. If the field is not specified all features / prediction outputs outlied in the monitoring schema will be used.", "type": "array", "items": { "type": "string" } }, "featureAlertConditions": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition" }, "type": "object", "description": "Per feature alert condition will override default alert condition." }, "categoricalMetricType": { "type": "string", "description": "Supported metrics type: * l_infinity * jensen_shannon_divergence" }, "defaultNumericAlertCondition": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition", "description": "Default alert condition for all the numeric features." }, "numericMetricType": { "description": "Supported metrics type: * jensen_shannon_divergence", "type": "string" }, "defaultCategoricalAlertCondition": { "description": "Default alert condition for all the categorical features.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecDataDriftSpec" }, "GoogleCloudAiplatformV1beta1Endpoint": { "id": "GoogleCloudAiplatformV1beta1Endpoint", "type": "object", "description": "Models are deployed into it, and afterwards Endpoint is called to obtain predictions and explanations.", "properties": { "clientConnectionConfig": { "description": "Configurations that are applied to the endpoint for online prediction.", "$ref": "GoogleCloudAiplatformV1beta1ClientConnectionConfig" }, "deployedModels": { "description": "Output only. The models deployed in this Endpoint. To add or remove DeployedModels use EndpointService.DeployModel and EndpointService.UndeployModel respectively.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModel" } }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "privateServiceConnectConfig": { "$ref": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig", "description": "Optional. Configuration for private service connect. network and private_service_connect_config are mutually exclusive." }, "publisherModelConfig": { "description": "Optional. Configuration for a Publisher Model. This message contains details about a publisher model used with this Endpoint, such as logging config or data sharing settings.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfig" }, "trafficSplit": { "additionalProperties": { "type": "integer", "format": "int32" }, "type": "object", "description": "A map from a DeployedModel's ID to the percentage of this Endpoint's traffic that should be forwarded to that DeployedModel. If a DeployedModel's ID is not listed in this map, then it receives no traffic. The traffic percentage values must add up to 100, or map must be empty if the Endpoint is to not accept any traffic at a moment." }, "encryptionSpec": { "description": "Customer-managed encryption key spec for an Endpoint. If set, this Endpoint and all sub-resources of this Endpoint will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "enablePrivateServiceConnect": { "type": "boolean", "deprecated": true, "description": "Deprecated: If true, expose the Endpoint via private service connect. Only one of the fields, network or enable_private_service_connect, can be set." }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this Endpoint was created." }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "dedicatedEndpointEnabled": { "description": "If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitation will be removed soon.", "type": "boolean" }, "gdcConfig": { "description": "Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.", "$ref": "GoogleCloudAiplatformV1beta1GdcConfig" }, "network": { "type": "string", "description": "Optional. The full name of the Google Compute Engine [network](https://cloud.google.com//compute/docs/networks-and-firewalls#networks) to which the Endpoint should be peered. Private services access must already be configured for the network. If left unspecified, the Endpoint is not peered with any network. Only one of the fields, network or enable_private_service_connect, can be set. [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert): `projects/{project}/global/networks/{network}`. Where `{project}` is a project number, as in `12345`, and `{network}` is network name." }, "predictRequestResponseLoggingConfig": { "description": "Configures the request-response logging for online prediction.", "$ref": "GoogleCloudAiplatformV1beta1PredictRequestResponseLoggingConfig" }, "description": { "description": "The description of the Endpoint.", "type": "string" }, "dedicatedEndpointDns": { "type": "string", "description": "Output only. DNS of the dedicated endpoint. Will only be populated if dedicated_endpoint_enabled is true. Depending on the features enabled, uid might be a random number or a string. For example, if fast_tryout is enabled, uid will be fasttryout. Format: `https://{endpoint_id}.{region}-{uid}.prediction.vertexai.goog`.", "readOnly": true }, "genAiAdvancedFeaturesConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig", "description": "Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported." }, "etag": { "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the Endpoint. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your Endpoints. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "name": { "description": "Identifier. The resource name of the Endpoint.", "type": "string" }, "modelDeploymentMonitoringJob": { "readOnly": true, "type": "string", "description": "Output only. Resource name of the Model Monitoring job associated with this Endpoint if monitoring is enabled by JobService.CreateModelDeploymentMonitoringJob. Format: `projects/{project}/locations/{location}/modelDeploymentMonitoringJobs/{model_deployment_monitoring_job}`" }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this Endpoint was last updated.", "format": "google-datetime", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1JiraSource": { "id": "GoogleCloudAiplatformV1beta1JiraSource", "type": "object", "description": "The Jira source for the ImportRagFilesRequest.", "properties": { "jiraQueries": { "type": "array", "description": "Required. The Jira queries.", "items": { "$ref": "GoogleCloudAiplatformV1beta1JiraSourceJiraQueries" } } } }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoClassificationPredictionParams": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoClassificationPredictionParams", "properties": { "shotClassification": { "type": "boolean", "description": "Set to true to request shot-level classification. Vertex AI determines the boundaries for each camera shot in the entire time segment of the video that user specified in the input instance. Vertex AI then returns labels and their confidence scores for each detected shot, along with the start and end time of the shot. WARNING: Model evaluation is not done for this classification type, the quality of it depends on the training data, but there are no metrics provided to describe that quality. Default value is false" }, "oneSecIntervalClassification": { "description": "Set to true to request classification for a video at one-second intervals. Vertex AI returns labels and their confidence scores for each second of the entire time segment of the video that user specified in the input WARNING: Model evaluation is not done for this classification type, the quality of it depends on the training data, but there are no metrics provided to describe that quality. Default value is false", "type": "boolean" }, "maxPredictions": { "description": "The Model only returns up to that many top, by confidence score, predictions per instance. If this number is very high, the Model may return fewer predictions. Default value is 10,000.", "format": "int32", "type": "integer" }, "confidenceThreshold": { "description": "The Model only returns predictions with at least this confidence score. Default value is 0.0", "format": "float", "type": "number" }, "segmentClassification": { "description": "Set to true to request segment-level classification. Vertex AI returns labels and their confidence scores for the entire time segment of the video that user specified in the input instance. Default value is true", "type": "boolean" } }, "type": "object", "description": "Prediction model parameters for Video Classification." }, "GoogleCloudAiplatformV1beta1SchemaVideoDataItem": { "properties": { "gcsUri": { "type": "string", "description": "Required. Google Cloud Storage URI points to the original video in user's bucket. The video is up to 50 GB in size and up to 3 hour in duration." }, "mimeType": { "description": "Output only. The mime type of the content of the video. Only the videos in below listed mime types are supported. Supported mime_type: - video/mp4 - video/avi - video/quicktime", "type": "string", "readOnly": true } }, "type": "object", "description": "Payload of Video DataItem.", "id": "GoogleCloudAiplatformV1beta1SchemaVideoDataItem" }, "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetResponse": { "description": "Response message of ModelService.UpdateExplanationDataset operation.", "id": "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetResponse", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint": { "type": "object", "description": "Config representing a model hosted on Vertex Prediction Endpoint.", "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint", "properties": { "endpoint": { "type": "string", "description": "Required. The endpoint resource name. Format: `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}` or `projects/{project}/locations/{location}/endpoints/{endpoint}`" }, "model": { "description": "Output only. The resource name of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model. Pattern: `projects/{project}/locations/{location}/models/{model}`", "readOnly": true, "type": "string" }, "modelVersionId": { "readOnly": true, "type": "string", "description": "Output only. Version ID of the model that is deployed on the endpoint. Present only when the endpoint is not a publisher model." } } }, "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext": { "type": "object", "properties": { "documentName": { "description": "Output only. The full resource name of the referenced Vertex AI Search document. This is used to identify the specific document that was retrieved. The format is `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.", "readOnly": true, "type": "string" }, "ragChunk": { "description": "Additional context for a Retrieval-Augmented Generation (RAG) retrieval result. This is populated only when the RAG retrieval tool is used.", "$ref": "GoogleCloudAiplatformV1beta1RagChunk" }, "title": { "description": "The title of the retrieved data source.", "type": "string" }, "uri": { "description": "The URI of the retrieved data source.", "type": "string" }, "text": { "description": "The content of the retrieved data source.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext", "description": "Context retrieved from a data source to ground the model's response. This is used when a retrieval tool fetches information from a user-provided corpus or a public dataset." }, "GoogleCloudAiplatformV1beta1ExplainResponseConcurrentExplanation": { "type": "object", "properties": { "explanations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Explanation" }, "description": "The explanations of the Model's PredictResponse.predictions. It has the same number of elements as instances to be explained." } }, "id": "GoogleCloudAiplatformV1beta1ExplainResponseConcurrentExplanation", "description": "This message is a wrapper grouping Concurrent Explanations." }, "GoogleCloudAiplatformV1beta1TrajectoryPrecisionResults": { "type": "object", "description": "Results for TrajectoryPrecision metric.", "id": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionResults", "properties": { "trajectoryPrecisionMetricValues": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionMetricValue" }, "description": "Output only. TrajectoryPrecision metric values.", "type": "array", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecasting": { "properties": { "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingMetadata" }, "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputs", "description": "The input parameters of this TrainingJob." } }, "description": "A TrainingJob that trains and uploads an AutoML Forecasting Model.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecasting" }, "GoogleCloudAiplatformV1beta1SearchExamplesResponse": { "id": "GoogleCloudAiplatformV1beta1SearchExamplesResponse", "type": "object", "properties": { "results": { "description": "The results of searching for similar examples.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SearchExamplesResponseSimilarExample" } } }, "description": "Response message for ExampleStoreService.SearchExamples." }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobGcsNotebookSource": { "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobGcsNotebookSource", "properties": { "uri": { "type": "string", "description": "The Cloud Storage uri pointing to the ipynb file. Format: `gs://bucket/notebook_file.ipynb`" }, "generation": { "description": "The version of the Cloud Storage object to read. If unset, the current version of the object is read. See https://cloud.google.com/storage/docs/metadata#generation-number.", "type": "string" } }, "type": "object", "description": "The Cloud Storage uri for the input notebook." }, "GoogleCloudAiplatformV1beta1SchemaVertex": { "id": "GoogleCloudAiplatformV1beta1SchemaVertex", "properties": { "x": { "type": "number", "format": "double", "description": "X coordinate of the vertex, normalized to [0.0, 1.0]." }, "y": { "format": "double", "description": "Y coordinate of the vertex, normalized to [0.0, 1.0].", "type": "number" } }, "description": "Represents a 2D point in the image. Vertex coordinates are normalized to be relative to the original image dimensions and range from 0 to 1. The origin of the coordinate system (0,0) is the top-left corner of the image. x increases to the right, and y increases to the bottom.", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryExactMatchResults": { "description": "Results for TrajectoryExactMatch metric.", "id": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchResults", "properties": { "trajectoryExactMatchMetricValues": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchMetricValue" }, "readOnly": true, "description": "Output only. TrajectoryExactMatch metric values." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AggregationResult": { "id": "GoogleCloudAiplatformV1beta1AggregationResult", "description": "The aggregation result for a single metric.", "properties": { "pairwiseMetricResult": { "description": "Result for pairwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricResult" }, "aggregationMetric": { "description": "Aggregation metric.", "enumDescriptions": [ "Unspecified aggregation metric.", "Average aggregation metric. Not supported for Pairwise metric.", "Mode aggregation metric.", "Standard deviation aggregation metric. Not supported for pairwise metric.", "Variance aggregation metric. Not supported for pairwise metric.", "Minimum aggregation metric. Not supported for pairwise metric.", "Maximum aggregation metric. Not supported for pairwise metric.", "Median aggregation metric. Not supported for pairwise metric.", "90th percentile aggregation metric. Not supported for pairwise metric.", "95th percentile aggregation metric. Not supported for pairwise metric.", "99th percentile aggregation metric. Not supported for pairwise metric." ], "type": "string", "enum": [ "AGGREGATION_METRIC_UNSPECIFIED", "AVERAGE", "MODE", "STANDARD_DEVIATION", "VARIANCE", "MINIMUM", "MAXIMUM", "MEDIAN", "PERCENTILE_P90", "PERCENTILE_P95", "PERCENTILE_P99" ] }, "exactMatchMetricValue": { "description": "Results for exact match metric.", "$ref": "GoogleCloudAiplatformV1beta1ExactMatchMetricValue" }, "pointwiseMetricResult": { "description": "Result for pointwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricResult" }, "rougeMetricValue": { "description": "Results for rouge metric.", "$ref": "GoogleCloudAiplatformV1beta1RougeMetricValue" }, "bleuMetricValue": { "description": "Results for bleu metric.", "$ref": "GoogleCloudAiplatformV1beta1BleuMetricValue" }, "customCodeExecutionResult": { "description": "Result for code execution metric.", "$ref": "GoogleCloudAiplatformV1beta1CustomCodeExecutionResult" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ManualBatchTuningParameters": { "properties": { "batchSize": { "type": "integer", "format": "int32", "description": "Immutable. The number of the records (e.g. instances) of the operation given in each batch to a machine replica. Machine type, and size of a single record should be considered when setting this parameter, higher value speeds up the batch operation's execution, but too high value will result in a whole batch not fitting in a machine's memory, and the whole operation will fail. The default value is 64." } }, "id": "GoogleCloudAiplatformV1beta1ManualBatchTuningParameters", "description": "Manual batch tuning parameters.", "type": "object" }, "GoogleCloudAiplatformV1beta1ComputeTokensResponse": { "id": "GoogleCloudAiplatformV1beta1ComputeTokensResponse", "type": "object", "properties": { "tokensInfo": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TokensInfo" }, "description": "Lists of tokens info from the input. A ComputeTokensRequest could have multiple instances with a prompt in each instance. We also need to return lists of tokens info for the request with multiple instances.", "type": "array" } }, "description": "Response message for ComputeTokens RPC call." }, "GoogleCloudAiplatformV1beta1ExecutableCode": { "description": "Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the `CodeExecution` tool, in which the code will be automatically executed, and a corresponding CodeExecutionResult will also be generated.", "properties": { "language": { "enum": [ "LANGUAGE_UNSPECIFIED", "PYTHON" ], "type": "string", "description": "Required. Programming language of the `code`.", "enumDescriptions": [ "Unspecified language. This value should not be used.", "Python \u003e= 3.10, with numpy and simpy available." ] }, "id": { "type": "string", "description": "Optional. Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`." }, "code": { "description": "Required. The code to be executed.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExecutableCode", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTextTransformation": { "description": "Training pipeline will perform following transformation functions. * The text as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index.", "properties": { "columnName": { "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTextTransformation" }, "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInstance": { "type": "object", "properties": { "context": { "description": "Required. Text to be summarized.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the candidate model." }, "baselinePrediction": { "description": "Required. Output of the baseline model.", "type": "string" }, "reference": { "type": "string", "description": "Optional. Ground truth used to compare against the prediction." }, "instruction": { "description": "Required. Summarization prompt for LLM.", "type": "string" } }, "description": "Spec for pairwise summarization quality instance.", "id": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInstance" }, "GoogleCloudAiplatformV1beta1EvaluationConfig": { "id": "GoogleCloudAiplatformV1beta1EvaluationConfig", "type": "object", "properties": { "metrics": { "type": "array", "description": "Required. The metrics used for evaluation.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Metric" } }, "inferenceGenerationConfig": { "description": "Optional. Configuration options for inference generation and outputs. If not set, default generation parameters are used.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" }, "autoraterConfig": { "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig", "description": "Optional. Autorater config for evaluation." }, "outputConfig": { "description": "Required. Config for evaluation output.", "$ref": "GoogleCloudAiplatformV1beta1OutputConfig" }, "datasetCustomMetrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DatasetCustomMetric" }, "type": "array", "description": "Optional. Specifications for custom dataset-level aggregations." } }, "description": "Evaluation Config for Tuning Job." }, "GoogleCloudAiplatformV1beta1GroundednessInput": { "id": "GoogleCloudAiplatformV1beta1GroundednessInput", "description": "Input for groundedness metric.", "properties": { "metricSpec": { "description": "Required. Spec for groundedness metric.", "$ref": "GoogleCloudAiplatformV1beta1GroundednessSpec" }, "instance": { "description": "Required. Groundedness instance.", "$ref": "GoogleCloudAiplatformV1beta1GroundednessInstance" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageSegmentationPredictionParams": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageSegmentationPredictionParams", "description": "Prediction model parameters for Image Segmentation.", "properties": { "confidenceThreshold": { "format": "float", "type": "number", "description": "When the model predicts category of pixels of the image, it will only provide predictions for pixels that it is at least this much confident about. All other pixels will be classified as background. Default value is 0.5." } } }, "GoogleCloudAiplatformV1beta1ToolExaAiSearch": { "description": "ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding.", "properties": { "apiKey": { "type": "string", "description": "Required. The API key for ExaAiSearch." }, "customConfigs": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. This field can be used to pass any parameter from the Exa.ai Search API." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolExaAiSearch" }, "GoogleCloudAiplatformV1beta1ImportFeatureValuesOperationMetadata": { "properties": { "invalidRowCount": { "format": "int64", "description": "The number of rows in input source that weren't imported due to either * Not having any featureValues. * Having a null entityId. * Having a null timestamp. * Not being parsable (applicable for CSV sources).", "type": "string" }, "importedEntityCount": { "type": "string", "description": "Number of entities that have been imported by the operation.", "format": "int64" }, "timestampOutsideRetentionRowsCount": { "format": "int64", "type": "string", "description": "The number rows that weren't ingested due to having timestamps outside the retention boundary." }, "blockingOperationIds": { "type": "array", "description": "List of ImportFeatureValues operations running under a single EntityType that are blocking this operation.", "items": { "type": "string", "format": "int64" } }, "importedFeatureValueCount": { "type": "string", "format": "int64", "description": "Number of Feature values that have been imported by the operation." }, "sourceUris": { "description": "The source URI from where Feature values are imported.", "items": { "type": "string" }, "type": "array" }, "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Featurestore import Feature values." } }, "description": "Details of operations that perform import Feature values.", "id": "GoogleCloudAiplatformV1beta1ImportFeatureValuesOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomalies": { "description": "Statistics and anomalies generated by Model Monitoring.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomalies", "type": "object", "properties": { "featureStats": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomaliesFeatureHistoricStatsAnomalies" }, "description": "A list of historical Stats and Anomalies generated for all Features.", "type": "array" }, "deployedModelId": { "type": "string", "description": "Deployed Model ID." }, "objective": { "type": "string", "description": "Model Monitoring Objective those stats and anomalies belonging to.", "enum": [ "MODEL_DEPLOYMENT_MONITORING_OBJECTIVE_TYPE_UNSPECIFIED", "RAW_FEATURE_SKEW", "RAW_FEATURE_DRIFT", "FEATURE_ATTRIBUTION_SKEW", "FEATURE_ATTRIBUTION_DRIFT" ], "enumDescriptions": [ "Default value, should not be set.", "Raw feature values' stats to detect skew between Training-Prediction datasets.", "Raw feature values' stats to detect drift between Serving-Prediction datasets.", "Feature attribution scores to detect skew between Training-Prediction datasets.", "Feature attribution scores to detect skew between Prediction datasets collected within different time windows." ] }, "anomalyCount": { "type": "integer", "format": "int32", "description": "Number of anomalies within all stats." } } }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigPinecone": { "type": "object", "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigPinecone", "properties": { "indexName": { "description": "Pinecone index name. This value cannot be changed after it's set.", "type": "string" } }, "description": "The config for the Pinecone." }, "GoogleCloudAiplatformV1beta1XprofConfig": { "properties": { "gcsBucketUri": { "type": "string", "description": "Required. User-owned Cloud Storage bucket (gs://) in the user project." } }, "id": "GoogleCloudAiplatformV1beta1XprofConfig", "type": "object", "description": "XprofConfig contains the configuration for managed XProf." }, "GoogleCloudAiplatformV1beta1FluencySpec": { "id": "GoogleCloudAiplatformV1beta1FluencySpec", "properties": { "version": { "type": "integer", "format": "int32", "description": "Optional. Which version to use for evaluation." } }, "description": "Spec for fluency score metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoActionRecognition": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoActionRecognition", "type": "object", "description": "A TrainingJob that trains and uploads an AutoML Video Action Recognition Model.", "properties": { "inputs": { "description": "The input parameters of this TrainingJob.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoActionRecognitionInputs" } } }, "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail": { "properties": { "publicMessage": { "type": "string", "description": "Public messages contains actionable items for the error cause." }, "errorCause": { "description": "The error root cause returned by CreatePipelineJob API.", "enum": [ "ERROR_CAUSE_UNSPECIFIED", "INVALID_PIPELINE_SPEC_FORMAT", "INVALID_PIPELINE_SPEC", "INVALID_DEPLOYMENT_CONFIG", "INVALID_DEPLOYMENT_SPEC", "INVALID_INSTANCE_SCHEMA", "INVALID_CUSTOM_JOB", "INVALID_CONTAINER_SPEC", "INVALID_NOTIFICATION_EMAIL_SETUP", "INVALID_SERVICE_ACCOUNT_SETUP", "INVALID_KMS_SETUP", "INVALID_NETWORK_SETUP", "INVALID_PIPELINE_TASK_SPEC", "INVALID_PIPELINE_TASK_ARTIFACT", "INVALID_IMPORTER_SPEC", "INVALID_RESOLVER_SPEC", "INVALID_RUNTIME_PARAMETERS", "CLOUD_API_NOT_ENABLED", "INVALID_GCS_INPUT_URI", "INVALID_GCS_OUTPUT_URI", "INVALID_COMPONENT_SPEC", "INVALID_DAG_OUTPUTS_SPEC", "INVALID_DAG_SPEC", "INSUFFICIENT_QUOTA", "INTERNAL" ], "enumDescriptions": [ "Should never be used.", "IR Pipeline Spec can not been parsed to yaml or json format.", "A pipeline spec is invalid.", "A deployment config is invalid.", "A deployment spec is invalid.", "An instance schema is invalid.", "A custom job is invalid.", "A container spec is invalid.", "Notification email setup is invalid.", "Service account setup is invalid.", "KMS setup is invalid.", "Network setup is invalid.", "Task spec is invalid.", "Task artifact is invalid.", "Importer spec is invalid.", "Resolver spec is invalid.", "Runtime Parameters are invalid.", "Cloud API not enabled.", "Invalid Cloud Storage input uri", "Invalid Cloud Storage output uri", "Component spec of pipeline is invalid.", "DagOutputsSpec is invalid.", "DagSpec is invalid.", "Project does not have enough quota.", "An internal error with unknown cause." ], "type": "string" } }, "description": "Create API error message for Vertex Pipeline.", "type": "object", "id": "CloudAiPlatformCommonCreatePipelineJobApiErrorDetail" }, "GoogleCloudAiplatformV1beta1EvaluationPromptPromptTemplateData": { "properties": { "values": { "description": "The values for fields in the prompt template.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "object" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationPromptPromptTemplateData", "type": "object", "description": "Message to hold a prompt template and the values to populate the template." }, "GoogleCloudAiplatformV1beta1GenerateLossClustersResponse": { "description": "Response message for EvaluationAnalyticsService.GenerateLossClusters.", "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerateLossClustersResponse", "properties": { "results": { "items": { "$ref": "GoogleCloudAiplatformV1beta1LossAnalysisResult" }, "description": "The analysis results, one per config provided in the request.", "type": "array" }, "analysisTime": { "format": "google-datetime", "type": "string", "description": "The timestamp when this analysis was completed." } } }, "GoogleIamV1TestIamPermissionsResponse": { "description": "Response message for `TestIamPermissions` method.", "properties": { "permissions": { "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "type": "array", "items": { "type": "string" } } }, "type": "object", "id": "GoogleIamV1TestIamPermissionsResponse" }, "GoogleCloudAiplatformV1beta1ExportPublisherModelRequest": { "properties": { "destination": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "Required. The target where we are exporting the model weights to" } }, "type": "object", "description": "Request message for ModelGardenService.ExportPublisherModel.", "id": "GoogleCloudAiplatformV1beta1ExportPublisherModelRequest" }, "GoogleCloudAiplatformV1beta1ImportIndexRequest": { "id": "GoogleCloudAiplatformV1beta1ImportIndexRequest", "type": "object", "properties": { "isCompleteOverwrite": { "type": "boolean", "description": "Optional. If true, completely replace existing index data. Must be true for streaming update indexes." }, "config": { "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfig", "description": "Required. Configuration for importing data from an external source." } }, "description": "Request message for IndexService.ImportIndex." }, "GoogleCloudAiplatformV1beta1ToolGoogleSearchWebSearch": { "description": "Standard web search for grounding and related configurations. Only text results are returned.", "id": "GoogleCloudAiplatformV1beta1ToolGoogleSearchWebSearch", "type": "object", "properties": {} }, "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigHybridSearch": { "properties": { "alpha": { "type": "number", "format": "float", "description": "Optional. Alpha value controls the weight between dense and sparse vector search results." } }, "type": "object", "description": "Config for Hybrid Search.", "id": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigHybridSearch" }, "GoogleCloudAiplatformV1beta1IndexStats": { "type": "object", "description": "Stats of the Index.", "id": "GoogleCloudAiplatformV1beta1IndexStats", "properties": { "sparseVectorsCount": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. The number of sparse vectors in the Index." }, "vectorsCount": { "format": "int64", "readOnly": true, "description": "Output only. The number of dense vectors in the Index.", "type": "string" }, "shardsCount": { "readOnly": true, "format": "int32", "description": "Output only. The number of shards in the Index.", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1VeoHyperParameters": { "properties": { "tuningTask": { "type": "string", "enum": [ "TUNING_TASK_UNSPECIFIED", "TUNING_TASK_I2V", "TUNING_TASK_T2V", "TUNING_TASK_R2V" ], "description": "The tuning task for Veo.", "enumDescriptions": [ "Default value. This value is unused.", "Tuning task for image to video.", "Tuning task for text to video.", "Tuning task for reference to video." ] }, "veoDataMixtureRatio": { "format": "double", "description": "Optional. The ratio of Google internal dataset to use in the training mixture, in range of `[0, 1)`. If `0.2`, it means 20% of Google internal dataset and 80% of user dataset will be used for training. If not set, the default value is 0.1.", "type": "number" }, "learningRateMultiplier": { "description": "Optional. Multiplier for adjusting the default learning rate.", "format": "double", "type": "number" }, "adapterSize": { "enum": [ "ADAPTER_SIZE_UNSPECIFIED", "ADAPTER_SIZE_EIGHT", "ADAPTER_SIZE_SIXTEEN", "ADAPTER_SIZE_THIRTY_TWO" ], "enumDescriptions": [ "Adapter size is unspecified.", "Adapter size 8. This is the default adapter size for Veo LoRA tuning.", "Adapter size 16.", "Adapter size 32." ], "description": "Optional. The adapter size for LoRA tuning.", "type": "string" }, "epochCount": { "format": "int64", "type": "string", "description": "Optional. Number of complete passes the model makes over the entire training dataset during training." }, "tuningSpeed": { "description": "The speed of the tuning job. Only supported for Veo 3.0 models.", "type": "string", "enumDescriptions": [ "The default / unset value. For Veo 3.0 models, this defaults to FAST.", "Regular tuning speed.", "Fast tuning speed." ], "enum": [ "TUNING_SPEED_UNSPECIFIED", "REGULAR", "FAST" ] } }, "description": "Hyperparameters for Veo.", "id": "GoogleCloudAiplatformV1beta1VeoHyperParameters", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateServingProfileOperationMetadata": { "properties": { "genericMetadata": { "description": "Output only. The standard operation metadata for Vertex AI.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateServingProfileOperationMetadata", "description": "Runtime operation metadata for ServingProfileService.CreateServingProfile." }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSource": { "type": "object", "properties": { "adkConfig": { "description": "Required. The ADK configuration.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSourceAdkConfig" }, "inlineSource": { "description": "Optional. Any additional files needed to interpret the config. If a `requirements.txt` file is present in the `inline_source`, the corresponding packages will be installed. If no `requirements.txt` file is present in `inline_source`, then the latest version of `google-adk` will be installed for interpreting the ADK config.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource" } }, "description": "Specification for the deploying from agent config.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSource" }, "GoogleCloudAiplatformV1beta1PipelineTaskDetailArtifactList": { "id": "GoogleCloudAiplatformV1beta1PipelineTaskDetailArtifactList", "type": "object", "properties": { "artifacts": { "description": "Output only. A list of artifact metadata.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" } } }, "description": "A list of artifact metadata." }, "GoogleCloudAiplatformV1beta1CitationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CitationMetadata", "description": "A collection of citations that apply to a piece of generated content.", "properties": { "citations": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1Citation" }, "description": "Output only. A list of citations for the content." } } }, "GoogleCloudAiplatformV1beta1UndeployIndexResponse": { "description": "Response message for IndexEndpointService.UndeployIndex.", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1UndeployIndexResponse" }, "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInstance", "properties": { "predictedTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for predicted tool call trajectory." }, "referenceTrajectory": { "description": "Required. Spec for reference tool call trajectory.", "$ref": "GoogleCloudAiplatformV1beta1Trajectory" } }, "description": "Spec for TrajectoryInOrderMatch instance." }, "GoogleCloudAiplatformV1beta1ResourceRuntimeSpec": { "description": "Configuration for the runtime on a PersistentResource instance, including but not limited to: * Service accounts used to run the workloads. * Whether to make it a dedicated Ray Cluster.", "properties": { "raySpec": { "description": "Optional. Ray cluster configuration. Required when creating a dedicated RayCluster on the PersistentResource.", "$ref": "GoogleCloudAiplatformV1beta1RaySpec" }, "serviceAccountSpec": { "description": "Optional. Configure the use of workload identity on the PersistentResource", "$ref": "GoogleCloudAiplatformV1beta1ServiceAccountSpec" } }, "id": "GoogleCloudAiplatformV1beta1ResourceRuntimeSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessSpec": { "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessSpec", "type": "object", "properties": { "useReference": { "description": "Optional. Whether to use instance.reference to compute question answering helpfulness.", "type": "boolean" }, "version": { "type": "integer", "format": "int32", "description": "Optional. Which version to use for evaluation." } }, "description": "Spec for question answering helpfulness metric." }, "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessResponse": { "description": "Response message for SandboxEnvironmentExecutionService.AuthorizeSandboxEnvironmentAccess. Intentionally empty: a successful response is the authorization result.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistributionDatasetBucket": { "id": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistributionDatasetBucket", "type": "object", "description": "Dataset bucket used to create a histogram for the distribution given a population of values.", "properties": { "left": { "description": "Output only. Left bound of the bucket.", "readOnly": true, "format": "double", "type": "number" }, "count": { "type": "number", "description": "Output only. Number of values in the bucket.", "readOnly": true, "format": "double" }, "right": { "readOnly": true, "description": "Output only. Right bound of the bucket.", "type": "number", "format": "double" } } }, "GoogleCloudAiplatformV1beta1RetrieveContextsResponse": { "properties": { "contexts": { "description": "The contexts of the query.", "$ref": "GoogleCloudAiplatformV1beta1RagContexts" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RetrieveContextsResponse", "description": "Response message for VertexRagService.RetrieveContexts." }, "GoogleCloudAiplatformV1beta1TaskArtifact": { "type": "object", "properties": { "metadata": { "type": "object", "description": "Optional. Additional metadata for the artifact. For A2A, the URIs of the extensions that were used to produce this artifact will be stored here.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "artifactId": { "description": "Required. The unique identifier of the artifact within the task. This id is provided by the creator of the artifact.", "type": "string" }, "displayName": { "description": "Optional. The human-readable name of the artifact provided by the creator.", "type": "string" }, "description": { "description": "Optional. A human readable description of the artifact.", "type": "string" }, "parts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Part" }, "type": "array", "description": "Required. The content of the artifact." } }, "id": "GoogleCloudAiplatformV1beta1TaskArtifact", "description": "Represents a single artifact produced by a task. sample: artifacts: { artifact_id: \"image-12345\" name: \"Generated Sunset Image\" description: \"A beautiful sunset over the mountains, generated by the user's request.\" parts: { inline_data: { mime_type: \"image/png\" data: \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAA=\" } } }" }, "GoogleCloudAiplatformV1beta1NfsMount": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NfsMount", "properties": { "mountPoint": { "description": "Required. Destination mount path. The NFS will be mounted for the user under /mnt/nfs/", "type": "string" }, "path": { "type": "string", "description": "Required. Source path exported from NFS server. Has to start with '/', and combined with the ip address, it indicates the source mount path in the form of `server:path`" }, "server": { "type": "string", "description": "Required. IP address of the NFS server." } }, "description": "Represents a mount configuration for Network File System (NFS) to mount." }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponse": { "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponse", "type": "object", "description": "Response message for FeaturestoreService.DeleteFeatureValues.", "properties": { "selectEntity": { "description": "Response for request specifying the entities to delete", "$ref": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectEntity" }, "selectTimeRangeAndFeature": { "$ref": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectTimeRangeAndFeature", "description": "Response for request specifying time range and feature" } } }, "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequest", "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Optional. Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store. Timestamp, if present, must not have higher than millisecond precision." }, "bigqueryReadInstances": { "description": "Similar to csv_read_instances, but from BigQuery source.", "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource" }, "destination": { "description": "Required. Specifies output location and format.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValueDestination" }, "entityTypeSpecs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestEntityTypeSpec" }, "type": "array", "description": "Required. Specifies EntityType grouping Features to read values of and settings." }, "csvReadInstances": { "description": "Each read instance consists of exactly one read timestamp and one or more entity IDs identifying entities of the corresponding EntityTypes whose Features are requested. Each output instance contains Feature values of requested entities concatenated together as of the read time. An example read instance may be `foo_entity_id, bar_entity_id, 2020-01-01T10:00:00.123Z`. An example output instance may be `foo_entity_id, bar_entity_id, 2020-01-01T10:00:00.123Z, foo_entity_feature1_value, bar_entity_feature2_value`. Timestamp in each read instance must be millisecond-aligned. `csv_read_instances` are read instances stored in a plain-text CSV file. The header should be: [ENTITY_TYPE_ID1], [ENTITY_TYPE_ID2], ..., timestamp The columns can be in any order. Values in the timestamp column must use the RFC 3339 format, e.g. `2012-07-30T10:43:17.123Z`.", "$ref": "GoogleCloudAiplatformV1beta1CsvSource" }, "passThroughFields": { "items": { "$ref": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestPassThroughField" }, "type": "array", "description": "When not empty, the specified fields in the *_read_instances source will be joined as-is in the output, in addition to those fields from the Featurestore Entity. For BigQuery source, the type of the pass-through values will be automatically inferred. For CSV source, the pass-through values will be passed as opaque bytes." } }, "description": "Request message for FeaturestoreService.BatchReadFeatureValues." }, "GoogleCloudAiplatformV1beta1DirectUploadSource": { "id": "GoogleCloudAiplatformV1beta1DirectUploadSource", "description": "The input content is encapsulated and uploaded in the request.", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1WriteFeatureValuesResponse": { "description": "Response message for FeaturestoreOnlineServingService.WriteFeatureValues.", "id": "GoogleCloudAiplatformV1beta1WriteFeatureValuesResponse", "type": "object", "properties": {} }, "GenaiVertexV1beta1GoogleSearchResultStep": { "type": "object", "properties": { "result": { "description": "Required. The results of the Google Search.", "items": { "$ref": "GenaiVertexV1beta1GoogleSearchResultStepGoogleSearchResultItem" }, "type": "array" }, "isError": { "type": "boolean", "description": "Whether the Google Search resulted in an error." } }, "description": "Google Search result step.", "id": "GenaiVertexV1beta1GoogleSearchResultStep" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToAction": { "description": "Actions could take on this Publisher Model.", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToAction", "properties": { "openNotebooks": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenNotebooks", "description": "Optional. Open notebooks of the PublisherModel." }, "openFineTuningPipelines": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenFineTuningPipelines", "description": "Optional. Open fine-tuning pipelines of the PublisherModel." }, "openGenie": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences", "description": "Optional. Open Genie / Playground." }, "multiDeployVertex": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployVertex", "description": "Optional. Multiple setups to deploy the PublisherModel to Vertex Endpoint." }, "createApplication": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences", "description": "Optional. Create application using the PublisherModel." }, "deployGke": { "description": "Optional. Deploy PublisherModel to Google Kubernetes Engine.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployGke" }, "requestAccess": { "description": "Optional. Request for access.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "viewRestApi": { "description": "Optional. To view Rest API docs.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionViewRestApi" }, "openEvaluationPipeline": { "description": "Optional. Open evaluation pipeline of the PublisherModel.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "openFineTuningPipeline": { "description": "Optional. Open fine-tuning pipeline of the PublisherModel.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "deploy": { "description": "Optional. Deploy the PublisherModel to Vertex Endpoint.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeploy" }, "openNotebook": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences", "description": "Optional. Open notebook of the PublisherModel." }, "openGenerationAiStudio": { "description": "Optional. Open in Generation AI Studio.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "openPromptTuningPipeline": { "description": "Optional. Open prompt-tuning pipeline of the PublisherModel.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RubricCritiqueResult": { "properties": { "verdict": { "readOnly": true, "description": "Output only. Verdict for the rubric - true if the rubric is met, false otherwise.", "type": "boolean" }, "rubric": { "type": "string", "readOnly": true, "description": "Output only. Rubric to be evaluated." } }, "description": "Rubric critique result.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RubricCritiqueResult" }, "GoogleCloudAiplatformV1beta1DeployRequestCustomModel": { "description": "The custom model to deploy from model weights in a Google Cloud Storage URI or Model Registry model.", "properties": { "gcsUri": { "type": "string", "description": "Immutable. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model)." }, "modelId": { "deprecated": true, "type": "string", "description": "Optional. Deprecated. Use ModelConfig.model_user_id instead." } }, "id": "GoogleCloudAiplatformV1beta1DeployRequestCustomModel", "type": "object" }, "GoogleCloudAiplatformV1beta1ResourcePoolAutoscalingSpec": { "type": "object", "description": "The min/max number of replicas allowed if enabling autoscaling", "id": "GoogleCloudAiplatformV1beta1ResourcePoolAutoscalingSpec", "properties": { "minReplicaCount": { "description": "Optional. min replicas in the node pool, must be ≤ replica_count and \u003c max_replica_count or will throw error. For autoscaling enabled Ray-on-Vertex, we allow min_replica_count of a resource_pool to be 0 to match the OSS Ray behavior(https://docs.ray.io/en/latest/cluster/vms/user-guides/configuring-autoscaling.html#cluster-config-parameters). As for Persistent Resource, the min_replica_count must be \u003e 0, we added a corresponding validation inside CreatePersistentResourceRequestValidator.java.", "format": "int64", "type": "string" }, "maxReplicaCount": { "description": "Optional. max replicas in the node pool, must be ≥ replica_count and \u003e min_replica_count or will throw error", "type": "string", "format": "int64" } } }, "GoogleCloudAiplatformV1beta1EvaluationResult": { "description": "Evaluation result.", "properties": { "metric": { "description": "Required. The metric that was evaluated.", "type": "string" }, "evaluationRun": { "description": "Required. The evaluation run that was used to generate the result. Format: projects/{project}/locations/{location}/evaluationRuns/{evaluation_run}", "type": "string" }, "candidateResults": { "items": { "$ref": "GoogleCloudAiplatformV1beta1CandidateResult" }, "description": "Optional. The results for the metric.", "type": "array" }, "request": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRequest", "description": "Required. The request that was evaluated." }, "evaluationRequest": { "description": "Required. The request item that was evaluated. Format: projects/{project}/locations/{location}/evaluationItems/{evaluation_item}", "type": "string" }, "metadata": { "description": "Optional. Metadata about the evaluation result.", "type": "any" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationResult" }, "GoogleCloudAiplatformV1beta1LogprobsResultCandidate": { "id": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate", "description": "A single token and its associated log probability.", "type": "object", "properties": { "token": { "description": "The token's string representation.", "type": "string" }, "tokenId": { "format": "int32", "description": "The token's numerical ID. While the `token` field provides the string representation of the token, the `token_id` is the numerical representation that the model uses internally. This can be useful for developers who want to build custom logic based on the model's vocabulary.", "type": "integer" }, "logProbability": { "description": "The log probability of this token. A higher value indicates that the model was more confident in this token. The log probability can be used to assess the relative likelihood of different tokens and to identify when the model is uncertain.", "format": "float", "type": "number" } } }, "GoogleCloudAiplatformV1beta1ServingProfile": { "description": "Configures the serving behavior for a resource-less GenAI serving.", "id": "GoogleCloudAiplatformV1beta1ServingProfile", "properties": { "scope": { "description": "Required. The specific API this ServingProfile applies to.", "enum": [ "SERVING_PROFILE_SCOPE_UNSPECIFIED", "GEMINI_LIVE", "INTERACTIONS_API", "RESPONSE_API" ], "type": "string", "enumDescriptions": [ "Default value. This value is unused. When users create a ServingProfile, they must choose a scope.", "The scope for Gemini Live.", "The scope for Interactions API.", "The scope for Response API." ] }, "createTime": { "type": "string", "readOnly": true, "description": "Output only. Timestamp when the ServingProfile was created.", "format": "google-datetime" }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when the ServingProfile was last updated." }, "displayName": { "type": "string", "description": "Required. The display name of the ServingProfile. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "description": { "description": "Optional. The description of the ServingProfile.", "type": "string" }, "cmekConfig": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfileCmekConfig", "description": "CMEK configuration for the ServingProfile." }, "name": { "description": "Identifier. The resource name of the ServingProfile.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1InvokeRequest": { "properties": { "httpBody": { "description": "The invoke method input. Supports HTTP headers and arbitrary data payload.", "$ref": "GoogleApiHttpBody" }, "deployedModelId": { "description": "ID of the DeployedModel that serves the invoke request.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1InvokeRequest", "description": "Request message for PredictionService.Invoke.", "type": "object" }, "GoogleCloudAiplatformV1beta1UpgradeNotebookRuntimeRequest": { "type": "object", "description": "Request message for NotebookService.UpgradeNotebookRuntime.", "id": "GoogleCloudAiplatformV1beta1UpgradeNotebookRuntimeRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingSpec": { "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingSpec", "description": "Spec for RubricBasedInstructionFollowing metric - returns rubrics and verdicts corresponding to rubrics along with overall score." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobSpec": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobSpec", "properties": { "trialJobSpec": { "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec", "description": "The spec of a trial job. The same spec applies to the CustomJobs created in all the trials." }, "maxFailedTrialCount": { "type": "integer", "format": "int32", "description": "The number of failed Trials that need to be seen before failing the HyperparameterTuningJob. If set to 0, Vertex AI decides how many Trials must fail before the whole job fails." }, "studySpec": { "description": "Study configuration of the HyperparameterTuningJob.", "$ref": "GoogleCloudAiplatformV1beta1StudySpec" }, "parallelTrialCount": { "description": "The desired number of Trials to run in parallel.", "format": "int32", "type": "integer" }, "maxTrialCount": { "format": "int32", "description": "The desired total number of Trials.", "type": "integer" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageObjectDetectionPredictionInstance": { "description": "Prediction input format for Image Object Detection.", "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageObjectDetectionPredictionInstance", "properties": { "mimeType": { "description": "The MIME type of the content of the image. Only the images in below listed MIME types are supported. - image/jpeg - image/gif - image/png - image/webp - image/bmp - image/tiff - image/vnd.microsoft.icon", "type": "string" }, "content": { "type": "string", "description": "The image bytes or Cloud Storage URI to make the prediction on." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CustomOutputFormatConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CustomOutputFormatConfig", "properties": { "returnRawOutput": { "type": "boolean", "description": "Optional. Whether to return raw output." } }, "description": "Spec for custom output format configuration." }, "GoogleCloudAiplatformV1beta1DataItem": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DataItem", "description": "A piece of data in a Dataset. Could be an image, a video, a document or plain text.", "properties": { "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "satisfiesPzi": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." }, "payload": { "description": "Required. The data that the DataItem represents (for example, an image or a text snippet). The schema of the payload is stored in the parent Dataset's metadata schema's dataItemSchemaUri field.", "type": "any" }, "name": { "readOnly": true, "description": "Output only. The resource name of the DataItem.", "type": "string" }, "labels": { "description": "Optional. The labels with user-defined metadata to organize your DataItems. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one DataItem(System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "type": "object", "additionalProperties": { "type": "string" } }, "createTime": { "description": "Output only. Timestamp when this DataItem was created.", "type": "string", "format": "google-datetime", "readOnly": true }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when this DataItem was last updated." } } }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsGeneralTextGenerationEvaluationMetrics": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsGeneralTextGenerationEvaluationMetrics", "type": "object", "properties": { "rougeLSum": { "type": "number", "format": "float", "description": "ROUGE-L (Longest Common Subsequence) scoring at summary level." }, "bleu": { "type": "number", "description": "BLEU (bilingual evaluation understudy) scores based on sacrebleu implementation.", "format": "float" } } }, "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfig", "properties": { "bigQuerySourceConfig": { "description": "Configuration for importing data from a BigQuery table.", "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigBigQuerySourceConfig" } }, "description": "Configuration for importing data from an external source." }, "GoogleCloudAiplatformV1beta1ToolCallValidSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolCallValidSpec", "properties": {}, "description": "Spec for tool call valid metric." }, "GoogleCloudAiplatformV1beta1EvaluationRequest": { "properties": { "rubrics": { "description": "Optional. Named groups of rubrics associated with this prompt. The key is a user-defined name for the rubric group.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1RubricGroup" }, "type": "object" }, "candidateResponses": { "items": { "$ref": "GoogleCloudAiplatformV1beta1CandidateResponse" }, "type": "array", "description": "Optional. Responses from model under test and other baseline models for comparison." }, "goldenResponse": { "description": "Optional. The Ideal response or ground truth.", "$ref": "GoogleCloudAiplatformV1beta1CandidateResponse" }, "prompt": { "description": "Optional. The request/prompt to evaluate.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationPrompt" } }, "type": "object", "description": "A single evaluation request supporting input for both single-turn model generation and multi-turn agent execution traces. Valid input modes: 1. Inference Mode: `prompt` is set (containing text or AgentData context). 2. Offline Eval Mode: `prompt` is unset, and `candidate_responses` contains `agent_data` (the completed execution trace). Validation Rule: Either `prompt` must be set, OR at least one of the `candidate_responses` must contain `agent_data`. Metrics receive each candidate as an `EvaluationInstance`, whose fields are the names metrics can reference: `prompt` -\u003e `prompt`, the candidate -\u003e `response` (or `agent_eval_data` for `agent_data`), `golden_response` -\u003e `reference`, `rubrics` -\u003e `rubric_groups`, and `prompt.prompt_template_data.values` and `extra_context` -\u003e `other_data`.", "id": "GoogleCloudAiplatformV1beta1EvaluationRequest" }, "GoogleCloudAiplatformV1beta1PublisherModelConfigClaudeFeatureConfig": { "id": "GoogleCloudAiplatformV1beta1PublisherModelConfigClaudeFeatureConfig", "type": "object", "properties": { "advancedAiEnabled": { "type": "boolean", "description": "Optional. Indicates whether the customer has enabled advanced AI features for this publisher model (data retention opt-in). See b/528731813. This is the source of truth; the deprecated `cyber_verification_program_enabled` is no longer consulted on read." }, "cyberVerificationProgramEnabled": { "type": "boolean", "description": "Optional. Deprecated: use `advanced_ai_enabled` instead. Indicates whether the customer has enabled the Cyber Verification Program (CVP) for this publisher model (data retention opt-in). See b/528731813.", "deprecated": true } }, "description": "Config for Claude-specific features." }, "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode": { "type": "object", "description": "The configuration for manual routing. When manual routing is specified, the model will be selected based on the model name provided.", "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode", "properties": { "modelName": { "type": "string", "description": "The name of the model to use. Only public LLM models are accepted." } } }, "GoogleCloudAiplatformV1beta1MigrateResourceRequest": { "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequest", "description": "Config of migrating one resource from automl.googleapis.com, datalabeling.googleapis.com and ml.googleapis.com to Vertex AI.", "type": "object", "properties": { "migrateMlEngineModelVersionConfig": { "description": "Config for migrating Version in ml.googleapis.com to Vertex AI's Model.", "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateMlEngineModelVersionConfig" }, "migrateDataLabelingDatasetConfig": { "deprecated": true, "description": "Deprecated: Data labeling service is shut down. Config for migrating Dataset in datalabeling.googleapis.com to Vertex AI's Dataset.", "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfig" }, "migrateAutomlModelConfig": { "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlModelConfig", "description": "Config for migrating Model in automl.googleapis.com to Vertex AI's Model." }, "migrateAutomlDatasetConfig": { "description": "Config for migrating Dataset in automl.googleapis.com to Vertex AI's Dataset.", "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlDatasetConfig" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputs": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputs", "type": "object", "properties": { "timeColumn": { "description": "The name of the column that identifies time order in the time series. This column must be available at forecast.", "type": "string" }, "unavailableAtForecastColumns": { "items": { "type": "string" }, "description": "Names of columns that are unavailable when a forecast is requested. This column contains information for the given entity (identified by the time_series_identifier_column) that is unknown before the forecast For example, actual weather on a given day.", "type": "array" }, "timeSeriesAttributeColumns": { "description": "Column names that should be used as attribute columns. The value of these columns does not vary as a function of time. For example, store ID or item color.", "items": { "type": "string" }, "type": "array" }, "transformations": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformation" }, "type": "array", "description": "Each transformation will apply transform function to given input column. And the result will be used for training. When creating transformation for BigQuery Struct column, the column should be flattened using \".\" as the delimiter." }, "timeSeriesIdentifierColumn": { "description": "The name of the column that identifies the time series.", "type": "string" }, "targetColumn": { "type": "string", "description": "The name of the column that the Model is to predict values for. This column must be unavailable at forecast." }, "windowConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionWindowConfig", "description": "Config containing strategy for generating sliding windows." }, "hierarchyConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHierarchyConfig", "description": "Configuration that defines the hierarchical relationship of time series and parameters for hierarchical forecasting strategies." }, "forecastHorizon": { "description": "The amount of time into the future for which forecasted values for the target are returned. Expressed in number of units defined by the `data_granularity` field.", "format": "int64", "type": "string" }, "dataGranularity": { "description": "Expected difference in time granularity between rows in the data.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsGranularity" }, "holidayRegions": { "description": "The geographical region based on which the holiday effect is applied in modeling by adding holiday categorical array feature that include all holidays matching the date. This option only allowed when data_granularity is day. By default, holiday effect modeling is disabled. To turn it on, specify the holiday region using this option.", "type": "array", "items": { "type": "string" } }, "weightColumn": { "description": "Column name that should be used as the weight column. Higher values in this column give more importance to the row during model training. The column must have numeric values between 0 and 10000 inclusively; 0 means the row is ignored for training. If weight column field is not set, then all rows are assumed to have equal weight of 1.", "type": "string" }, "availableAtForecastColumns": { "type": "array", "description": "Names of columns that are available and provided when a forecast is requested. These columns contain information for the given entity (identified by the time_series_identifier_column column) that is known at forecast. For example, predicted weather for a specific day.", "items": { "type": "string" } }, "enableProbabilisticInference": { "description": "If probabilistic inference is enabled, the model will fit a distribution that captures the uncertainty of a prediction. At inference time, the predictive distribution is used to make a point prediction that minimizes the optimization objective. For example, the mean of a predictive distribution is the point prediction that minimizes RMSE loss. If quantiles are specified, then the quantiles of the distribution are also returned. The optimization objective cannot be minimize-quantile-loss.", "type": "boolean" }, "trainBudgetMilliNodeHours": { "format": "int64", "type": "string", "description": "Required. The train budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The training cost of the model will not exceed this budget. The final cost will be attempted to be close to the budget, though may end up being (even) noticeably smaller - at the backend's discretion. This especially may happen when further model training ceases to provide any improvements. If the budget is set to a value known to be insufficient to train a model for the given dataset, the training won't be attempted and will error. The train budget must be between 1,000 and 72,000 milli node hours, inclusive." }, "quantiles": { "items": { "format": "double", "type": "number" }, "description": "Quantiles to use for minimize-quantile-loss `optimization_objective`, or for probabilistic inference. Up to 5 quantiles are allowed of values between 0 and 1, exclusive. Required if the value of optimization_objective is minimize-quantile-loss. Represents the percent quantiles to use for that objective. Quantiles must be unique.", "type": "array" }, "validationOptions": { "type": "string", "description": "Validation options for the data validation component. The available options are: * \"fail-pipeline\" - default, will validate against the validation and fail the pipeline if it fails. * \"ignore-validation\" - ignore the results of the validation and continue" }, "contextWindow": { "format": "int64", "description": "The amount of time into the past training and prediction data is used for model training and prediction respectively. Expressed in number of units defined by the `data_granularity` field.", "type": "string" }, "additionalExperiments": { "type": "array", "description": "Additional experiment flags for the time series forcasting training.", "items": { "type": "string" } }, "optimizationObjective": { "type": "string", "description": "Objective function the model is optimizing towards. The training process creates a model that optimizes the value of the objective function over the validation set. The supported optimization objectives: * \"minimize-rmse\" (default) - Minimize root-mean-squared error (RMSE). * \"minimize-mae\" - Minimize mean-absolute error (MAE). * \"minimize-rmsle\" - Minimize root-mean-squared log error (RMSLE). * \"minimize-rmspe\" - Minimize root-mean-squared percentage error (RMSPE). * \"minimize-wape-mae\" - Minimize the combination of weighted absolute percentage error (WAPE) and mean-absolute-error (MAE). * \"minimize-quantile-loss\" - Minimize the quantile loss at the quantiles defined in `quantiles`. * \"minimize-mape\" - Minimize the mean absolute percentage error." }, "exportEvaluatedDataItemsConfig": { "description": "Configuration for exporting test set predictions to a BigQuery table. If this configuration is absent, then the export is not performed.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformation": { "properties": { "text": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTextTransformation" }, "auto": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationAutoTransformation" }, "categorical": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationCategoricalTransformation" }, "numeric": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationNumericTransformation" }, "timestamp": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTimestampTransformation" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformation" }, "GoogleCloudAiplatformV1beta1ExecuteCodeRequest": { "properties": { "inputs": { "type": "array", "description": "Required. The inputs used for the stateless code execution.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" } } }, "id": "GoogleCloudAiplatformV1beta1ExecuteCodeRequest", "type": "object", "description": "Request message for SandboxEnvironmentExecutionService.ExecuteCode." }, "GenaiVertexV1beta1VoiceReplicatedVoice": { "description": "Input only. Parameters for replicated voice generation. Required on input when `type` is `\"replicated\"`. Not returned in responses.", "type": "object", "properties": { "sourceAudio": { "$ref": "GenaiVertexV1beta1AudioData", "description": "Required. The reference audio sample of the speaker's voice to replicate. Must be an unmodified recording of an adult human voice." }, "consentAudio": { "description": "Required. Audio recording of the same speaker reading the required consent phrase, confirming authorization to replicate the voice.", "$ref": "GenaiVertexV1beta1AudioData" } }, "id": "GenaiVertexV1beta1VoiceReplicatedVoice" }, "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfig": { "description": "The config for the corpus type of the RagCorpus.", "type": "object", "properties": { "memoryCorpus": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigMemoryCorpus", "description": "Optional. Config for the memory corpus." }, "documentCorpus": { "description": "Optional. Config for the document corpus.", "$ref": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigDocumentCorpus" } }, "id": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfig" }, "GoogleCloudAiplatformV1beta1Execution": { "type": "object", "properties": { "description": { "type": "string", "description": "Description of the Execution" }, "etag": { "type": "string", "description": "An eTag used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "schemaVersion": { "description": "The version of the schema in `schema_title` to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when this Execution was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "metadata": { "description": "Properties of the Execution. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "labels": { "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your Executions. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Execution (System labels are excluded).", "type": "object" }, "displayName": { "type": "string", "description": "User provided display name of the Execution. May be up to 128 Unicode characters." }, "updateTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this Execution was last updated." }, "state": { "type": "string", "description": "The state of this Execution. This is a property of the Execution, and does not imply or capture any ongoing process. This property is managed by clients (such as Vertex AI Pipelines) and the system does not prescribe or check the validity of state transitions.", "enumDescriptions": [ "Unspecified Execution state", "The Execution is new", "The Execution is running", "The Execution has finished running", "The Execution has failed", "The Execution completed through Cache hit.", "The Execution was cancelled." ], "enum": [ "STATE_UNSPECIFIED", "NEW", "RUNNING", "COMPLETE", "FAILED", "CACHED", "CANCELLED" ] }, "name": { "description": "Output only. The resource name of the Execution.", "type": "string", "readOnly": true }, "schemaTitle": { "description": "The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1Execution", "description": "Instance of a general execution." }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorStateDetails": { "description": "Contains additional information about the state of the OnlineEvaluator.", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorStateDetails", "type": "object", "properties": { "message": { "type": "string", "readOnly": true, "description": "Output only. Human-readable message describing the state of the OnlineEvaluator." } } }, "GenaiVertexV1beta1UrlContextCallStep": { "properties": { "arguments": { "description": "Required. The arguments to pass to the URL context.", "$ref": "GenaiVertexV1beta1UrlContextCallStepUrlContextCallStepArguments" } }, "id": "GenaiVertexV1beta1UrlContextCallStep", "description": "URL context call step.", "type": "object" }, "GoogleCloudAiplatformV1beta1ExportModelResponse": { "type": "object", "properties": {}, "description": "Response message of ModelService.ExportModel operation.", "id": "GoogleCloudAiplatformV1beta1ExportModelResponse" }, "GoogleCloudAiplatformV1beta1TaskArtifactChange": { "properties": { "addedArtifacts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TaskArtifact" }, "type": "array", "description": "Optional. A list of brand-new artifacts created in this event." }, "updatedArtifacts": { "description": "Optional. A list of existing artifacts that were modified in this event.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TaskArtifact" } }, "deletedArtifactIds": { "description": "Optional. A list of artifact IDs that were removed in this event.", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1TaskArtifactChange", "description": "Describes changes to the artifact list.", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Featurestore batch read Features values." } }, "description": "Details of operations that batch reads Feature values.", "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesOperationMetadata" }, "GoogleCloudAiplatformV1beta1MeasurementMetric": { "type": "object", "properties": { "metricId": { "description": "Output only. The ID of the Metric. The Metric should be defined in StudySpec's Metrics.", "type": "string", "readOnly": true }, "value": { "description": "Output only. The value for this metric.", "readOnly": true, "format": "double", "type": "number" } }, "description": "A message representing a metric in the measurement.", "id": "GoogleCloudAiplatformV1beta1MeasurementMetric" }, "GoogleCloudAiplatformV1beta1FeatureViewSync": { "id": "GoogleCloudAiplatformV1beta1FeatureViewSync", "properties": { "runTime": { "description": "Output only. Time when this FeatureViewSync is finished.", "readOnly": true, "$ref": "GoogleTypeInterval" }, "finalStatus": { "description": "Output only. Final status of the FeatureViewSync.", "$ref": "GoogleRpcStatus", "readOnly": true }, "syncSummary": { "description": "Output only. Summary of the sync job.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1FeatureViewSyncSyncSummary" }, "satisfiesPzs": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "createTime": { "description": "Output only. Time when this FeatureViewSync is created. Creation of a FeatureViewSync means that the job is pending / waiting for sufficient resources but may not have started the actual data transfer yet.", "type": "string", "readOnly": true, "format": "google-datetime" }, "satisfiesPzi": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "name": { "description": "Identifier. Name of the FeatureViewSync. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}/featureViewSyncs/{feature_view_sync}`", "type": "string" } }, "description": "FeatureViewSync is a representation of sync operation which copies data from data source to Feature View in Online Store.", "type": "object" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsAudioControlConfig": { "properties": { "useTargetAudioFromVideo": { "description": "Optional. When true, uses the audio track from the input video as the target audio instead of regenerating it. Mutually exclusive with `target_audio` below. Requires the input to be a video file, not an image sequence.", "type": "boolean" }, "targetAudio": { "description": "Optional. Audio file to use as the target audio input to Omni. Only used when `use_target_audio_from_video` is false. Cannot be set simultaneously with `use_target_audio_from_video = true`.", "$ref": "CloudAiLargeModelsVisionGenerateVideoRequestAudio" } }, "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsAudioControlConfig", "description": "Configuration for audio control." }, "GoogleCloudAiplatformV1beta1AutomaticResources": { "type": "object", "description": "A description of resources that to large degree are decided by Agent Platform, and require only a modest additional configuration. Each Model supporting these resources documents its specific guidelines.", "properties": { "minReplicaCount": { "format": "int32", "description": "Immutable. The minimum number of replicas that will be always deployed on. If traffic against it increases, it may dynamically be deployed onto more replicas up to max_replica_count, and as traffic decreases, some of these extra replicas may be freed. If the requested value is too large, the deployment will error.", "type": "integer" }, "maxReplicaCount": { "description": "Immutable. The maximum number of replicas that may be deployed on when the traffic against it increases. If the requested value is too large, the deployment will error, but if deployment succeeds then the ability to scale to that many replicas is guaranteed (barring service outages). If traffic increases beyond what its replicas at maximum may handle, a portion of the traffic will be dropped. If this value is not provided, a no upper bound for scaling under heavy traffic will be assume, though Agent Platform may be unable to scale beyond certain replica number.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1AutomaticResources" }, "GoogleCloudAiplatformV1beta1Study": { "description": "A message representing a Study.", "properties": { "studySpec": { "description": "Required. Configuration of the Study.", "$ref": "GoogleCloudAiplatformV1beta1StudySpec" }, "createTime": { "description": "Output only. Time at which the study was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "state": { "enumDescriptions": [ "The study state is unspecified.", "The study is active.", "The study is stopped due to an internal error.", "The study is done when the service exhausts the parameter search space or max_trial_count is reached." ], "type": "string", "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "INACTIVE", "COMPLETED" ], "description": "Output only. The detailed state of a Study." }, "name": { "readOnly": true, "description": "Output only. The name of a study. The study's globally unique identifier. Format: `projects/{project}/locations/{location}/studies/{study}`", "type": "string" }, "inactiveReason": { "readOnly": true, "description": "Output only. A human readable reason why the Study is inactive. This should be empty if a study is ACTIVE or COMPLETED.", "type": "string" }, "displayName": { "description": "Required. Describes the Study, default value is empty string.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1Study", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationCategoricalTransformation": { "type": "object", "description": "Training pipeline will perform following transformation functions. * The categorical string as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index. * Categories that appear less than 5 times in the training dataset are treated as the \"unknown\" category. The \"unknown\" category gets its own special lookup index and resulting embedding.", "properties": { "columnName": { "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationCategoricalTransformation" }, "GenaiVertexV1beta1AudioData": { "properties": { "mimeType": { "description": "Required. The IANA MIME type of the audio data (for example, `audio/wav` or `audio/mpeg`).", "type": "string" }, "data": { "type": "string", "format": "byte", "description": "Required. The raw audio bytes." } }, "id": "GenaiVertexV1beta1AudioData", "description": "Audio payload used for voice creation.", "type": "object" }, "GoogleCloudAiplatformV1beta1TimeSeriesDataPoint": { "properties": { "scalar": { "description": "A scalar value.", "$ref": "GoogleCloudAiplatformV1beta1Scalar" }, "wallTime": { "description": "Wall clock timestamp when this data point is generated by the end user.", "type": "string", "format": "google-datetime" }, "blobs": { "description": "A blob sequence value.", "$ref": "GoogleCloudAiplatformV1beta1TensorboardBlobSequence" }, "step": { "description": "Step index of this data point within the run.", "type": "string", "format": "int64" }, "tensor": { "description": "A tensor value.", "$ref": "GoogleCloudAiplatformV1beta1TensorboardTensor" } }, "type": "object", "description": "A TensorboardTimeSeries data point.", "id": "GoogleCloudAiplatformV1beta1TimeSeriesDataPoint" }, "GoogleCloudAiplatformV1beta1RuntimeConfig": { "properties": { "defaultParams": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. Default parameters that will be set for all the execution of this extension. If specified, the parameter values can be overridden by values in [[ExecuteExtensionRequest.operation_params]] at request time. The struct should be in a form of map with param name as the key and actual param value as the value. E.g. If this operation requires a param \"name\" to be set to \"abc\". you can set this to something like {\"name\": \"abc\"}." }, "codeInterpreterRuntimeConfig": { "description": "Code execution runtime configurations for code interpreter extension.", "$ref": "GoogleCloudAiplatformV1beta1RuntimeConfigCodeInterpreterRuntimeConfig" }, "vertexAiSearchRuntimeConfig": { "$ref": "GoogleCloudAiplatformV1beta1RuntimeConfigVertexAISearchRuntimeConfig", "description": "Runtime configuration for Vertex AI Search extension." } }, "description": "Runtime configuration to run the extension.", "id": "GoogleCloudAiplatformV1beta1RuntimeConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTextDataItem": { "type": "object", "properties": { "gcsUri": { "type": "string", "description": "Output only. Google Cloud Storage URI points to a copy of the original text in the Vertex-managed bucket in the user's project. The text file is up to 10MB in size.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1SchemaTextDataItem", "description": "Payload of Text DataItem." }, "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlModelConfig": { "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlModelConfig", "description": "Config for migrating Model in automl.googleapis.com to Vertex AI's Model.", "properties": { "model": { "description": "Required. Full resource name of automl Model. Format: `projects/{project}/locations/{location}/models/{model}`.", "type": "string" }, "modelDisplayName": { "description": "Optional. Display name of the model in Vertex AI. System will pick a display name if unspecified.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SummarizationQualityInstance": { "id": "GoogleCloudAiplatformV1beta1SummarizationQualityInstance", "properties": { "instruction": { "description": "Required. Summarization prompt for LLM.", "type": "string" }, "context": { "type": "string", "description": "Required. Text to be summarized." }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" } }, "type": "object", "description": "Spec for summarization quality instance." }, "GoogleCloudAiplatformV1beta1ColabImage": { "id": "GoogleCloudAiplatformV1beta1ColabImage", "type": "object", "properties": { "releaseName": { "description": "Optional. The release name of the NotebookRuntime Colab image, e.g. \"py310\". If not specified, detault to the latest release.", "type": "string" }, "description": { "readOnly": true, "type": "string", "description": "Output only. A human-readable description of the specified colab image release, populated by the system. Example: \"Python 3.10\", \"Latest - current Python 3.11\"" } }, "description": "Colab image of the runtime." }, "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTarget": { "properties": { "vertexModel": { "description": "Model in Vertex AI Model Registry.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTargetVertexModelSource" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTarget", "description": "The monitoring target refers to the entity that is subject to analysis. e.g. Vertex AI Model version." }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfig": { "properties": { "granularTtlConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfigGranularTtlConfig", "description": "Optional. The granular TTL configuration of the memories in the Memory Bank." }, "memoryRevisionDefaultTtl": { "format": "google-duration", "description": "Optional. The default TTL duration of the memory revisions in the Memory Bank. This applies to all operations that create a memory revision. If not set, a default TTL of 365 days will be used.", "type": "string" }, "defaultTtl": { "format": "google-duration", "description": "Optional. The default TTL duration of the memories in the Memory Bank. This applies to all operations that create or update a memory.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfig", "description": "Configuration for automatically setting the TTL (\"time-to-live\") of the memories in the Memory Bank.", "type": "object" }, "GoogleCloudAiplatformV1beta1ExamplesExampleGcsSource": { "type": "object", "description": "The Cloud Storage input instances.", "id": "GoogleCloudAiplatformV1beta1ExamplesExampleGcsSource", "properties": { "dataFormat": { "enum": [ "DATA_FORMAT_UNSPECIFIED", "JSONL" ], "enumDescriptions": [ "Format unspecified, used when unset.", "Examples are stored in JSONL files." ], "type": "string", "description": "The format in which instances are given, if not specified, assume it's JSONL format. Currently only JSONL format is supported." }, "gcsSource": { "description": "The Cloud Storage location for the input instances.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" } } }, "GenaiVertexV1beta1WordInfo": { "properties": { "speaker": { "description": "Optional. Speaker label for this word (e.g. \"spk_1\", \"spk_2\"). Present when diarization_mode is set in TranscriptionConfig.", "type": "string" }, "text": { "type": "string", "description": "The transcribed word." }, "startOffset": { "type": "string", "description": "Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains \"word\".", "format": "google-duration" }, "endOffset": { "description": "End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains \"word\".", "format": "google-duration", "type": "string" } }, "description": "Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.", "type": "object", "id": "GenaiVertexV1beta1WordInfo" }, "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig": { "type": "object", "description": "This contains flag for manually disabling transfer learning for a study. The names of prior studies being used for transfer learning (if any) are also listed here.", "properties": { "priorStudyNames": { "items": { "type": "string" }, "description": "Output only. Names of previously completed studies", "type": "array", "readOnly": true }, "disableTransferLearning": { "description": "Flag to to manually prevent vizier from using transfer learning on a new study. Otherwise, vizier will automatically determine whether or not to use transfer learning.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig" }, "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentSnapshotsResponse": { "description": "Response message for SandboxEnvironmentService.ListSandboxEnvironmentSnapshots.", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListSandboxEnvironmentSnapshotsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages." }, "sandboxEnvironmentSnapshots": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot" }, "type": "array", "description": "The SandboxEnvironmentSnapshots matching the request." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentSnapshotsResponse" }, "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsRequest": { "description": "Request message for MetadataService.AddContextArtifactsAndExecutions.", "properties": { "executions": { "items": { "type": "string" }, "description": "The resource names of the Executions to associate with the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", "type": "array" }, "artifacts": { "items": { "type": "string" }, "description": "The resource names of the Artifacts to attribute to the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsRequest" }, "GoogleCloudAiplatformV1beta1Value": { "type": "object", "properties": { "doubleValue": { "type": "number", "format": "double", "description": "A double value." }, "stringValue": { "description": "A string value.", "type": "string" }, "intValue": { "type": "string", "format": "int64", "description": "An integer value." } }, "id": "GoogleCloudAiplatformV1beta1Value", "description": "Value is the value of the field." }, "GoogleCloudAiplatformV1beta1SmoothGradConfig": { "properties": { "featureNoiseSigma": { "$ref": "GoogleCloudAiplatformV1beta1FeatureNoiseSigma", "description": "This is similar to noise_sigma, but provides additional flexibility. A separate noise sigma can be provided for each feature, which is useful if their distributions are different. No noise is added to features that are not set. If this field is unset, noise_sigma will be used for all features." }, "noiseSigma": { "type": "number", "description": "This is a single float value and will be used to add noise to all the features. Use this field when all features are normalized to have the same distribution: scale to range [0, 1], [-1, 1] or z-scoring, where features are normalized to have 0-mean and 1-variance. Learn more about [normalization](https://developers.google.com/machine-learning/data-prep/transform/normalization). For best results the recommended value is about 10% - 20% of the standard deviation of the input feature. Refer to section 3.2 of the SmoothGrad paper: https://arxiv.org/pdf/1706.03825.pdf. Defaults to 0.1. If the distribution is different per feature, set feature_noise_sigma instead for each feature.", "format": "float" }, "noisySampleCount": { "format": "int32", "description": "The number of gradient samples to use for approximation. The higher this number, the more accurate the gradient is, but the runtime complexity increases by this factor as well. Valid range of its value is [1, 50]. Defaults to 3.", "type": "integer" } }, "description": "Config for SmoothGrad approximation of gradients. When enabled, the gradients are approximated by averaging the gradients from noisy samples in the vicinity of the inputs. Adding noise can help improve the computed gradients. Refer to this paper for more details: https://arxiv.org/pdf/1706.03825.pdf", "type": "object", "id": "GoogleCloudAiplatformV1beta1SmoothGradConfig" }, "GenaiVertexV1beta1Error": { "type": "object", "properties": { "code": { "type": "string", "description": "A URI that identifies the error type." }, "message": { "description": "A human-readable error message.", "type": "string" } }, "id": "GenaiVertexV1beta1Error", "description": "Error message from an interaction." }, "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsListConfig": { "properties": { "valueSchema": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetails", "description": "The value's data type in the list." } }, "id": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsListConfig", "description": "Config for List data type.", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfig": { "type": "object", "properties": { "enableFeatureAttributes": { "type": "boolean", "description": "If want to analyze the Vertex Explainable AI feature attribute scores or not. If set to true, Vertex AI will log the feature attributions from explain response and do the skew/drift detection for them." }, "explanationBaseline": { "description": "Predictions generated by the BatchPredictionJob using baseline dataset.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfigExplanationBaseline" } }, "description": "The config for integrating with Vertex Explainable AI. Only applicable if the Model has explanation_spec populated.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfig" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTextExtractionPredictionResult": { "type": "object", "description": "Prediction output format for Text Extraction.", "properties": { "confidences": { "description": "The Model's confidences in correctness of the predicted IDs, higher value means higher confidence. Order matches the Ids.", "items": { "format": "float", "type": "number" }, "type": "array" }, "displayNames": { "description": "The display names of the AnnotationSpecs that had been identified, order matches the IDs.", "type": "array", "items": { "type": "string" } }, "ids": { "items": { "type": "string", "format": "int64" }, "description": "The resource IDs of the AnnotationSpecs that had been identified, ordered by the confidence score descendingly.", "type": "array" }, "textSegmentEndOffsets": { "items": { "format": "int64", "type": "string" }, "type": "array", "description": "The end offsets, inclusive, of the text segment in which the AnnotationSpec has been identified. Expressed as a zero-based number of characters as measured from the start of the text snippet." }, "textSegmentStartOffsets": { "description": "The start offsets, inclusive, of the text segment in which the AnnotationSpec has been identified. Expressed as a zero-based number of characters as measured from the start of the text snippet.", "type": "array", "items": { "type": "string", "format": "int64" } } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTextExtractionPredictionResult" }, "GoogleCloudAiplatformV1beta1EnableModelResponse": { "description": "Response message for ModelGardenService.EnableModel.", "id": "GoogleCloudAiplatformV1beta1EnableModelResponse", "properties": { "publisherEndpoint": { "type": "string", "description": "Output only. The publisher endpoint that the project is enabled for. Format: `projects/{project}/locations/{location}/publishers/{publisher}/models/{publisher_model}`", "readOnly": true }, "enablementState": { "readOnly": true, "type": "string", "enum": [ "ENABLEMENT_STATE_UNSPECIFIED", "ENABLEMENT_STATE_SUCCEEDED", "ENABLEMENT_STATE_FAILED" ], "enumDescriptions": [ "The PublisherModel enable status is unclear. The API will default to this value.", "The PublisherModel is enabled successfully.", "The PublisherModel is failed to enable" ], "description": "Output only. The result of the model enablement." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationSpecOverride": { "id": "GoogleCloudAiplatformV1beta1ExplanationSpecOverride", "properties": { "metadata": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataOverride", "description": "The metadata to be overridden. If not specified, no metadata is overridden." }, "parameters": { "description": "The parameters to be overridden. Note that the attribution method cannot be changed. If not specified, no parameter is overridden.", "$ref": "GoogleCloudAiplatformV1beta1ExplanationParameters" }, "examplesOverride": { "$ref": "GoogleCloudAiplatformV1beta1ExamplesOverride", "description": "The example-based explanations parameter overrides." } }, "description": "The ExplanationSpec entries that can be overridden at online explanation time.", "type": "object" }, "GoogleCloudAiplatformV1beta1SignUpRequest": { "type": "object", "description": "Request message for ExpressModeService.SignUp.", "properties": { "getDefaultApiKey": { "description": "Optional. Whether to return the default API key string in the response.", "type": "boolean" }, "region": { "description": "Required. The desired region for the express project.", "type": "string" }, "tosAccepted": { "description": "Required. Whether the Terms of Service are accepted.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1SignUpRequest" }, "GoogleCloudAiplatformV1beta1Part": { "description": "A datatype containing media that is part of a multi-part Content message. A `Part` consists of data which has an associated datatype. A `Part` must contain one of the accepted types in `Part.data`. For media types that are not text, `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.", "type": "object", "properties": { "functionCall": { "description": "Optional. A predicted function call returned from the model. This contains the name of the function to call and the arguments to pass to the function.", "$ref": "GoogleCloudAiplatformV1beta1FunctionCall" }, "audioTranscription": { "$ref": "GoogleCloudAiplatformV1beta1AudioTranscription", "description": "Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data." }, "executableCode": { "description": "Optional. Code generated by the model that is intended to be executed.", "$ref": "GoogleCloudAiplatformV1beta1ExecutableCode" }, "speechMetadata": { "$ref": "GoogleCloudAiplatformV1beta1SpeechMetadata", "description": "Optional. Turn-level metadata for speech generation (e.g. Daikon speaker/style). May be set alongside `text` to attach speaker and style information to a text part." }, "thought": { "type": "boolean", "description": "Optional. Indicates whether the `part` represents the model's thought process or reasoning." }, "inlineData": { "$ref": "GoogleCloudAiplatformV1beta1Blob", "description": "Optional. The inline data content of the part. This can be used to include images, audio, or video in a request." }, "mediaProcessing": { "type": "string", "description": "Optional. How the model processes this part's media for understanding. Only meaningful for video parts (`inline_data` or `file_data` with video mime). Non-video parts ignore this field.", "enum": [ "MEDIA_PROCESSING_UNSPECIFIED", "STATIC", "AGENTIC" ], "enumDescriptions": [ "Defaults to model-specific processing.", "Fixed-rate frame extraction. All frames placed in context.", "Model-driven dynamic navigation. Recommended for most use cases." ] }, "codeExecutionResult": { "description": "Optional. The result of executing the ExecutableCode.", "$ref": "GoogleCloudAiplatformV1beta1CodeExecutionResult" }, "fileData": { "description": "Optional. The URI-based data of the part. This can be used to include files from Google Cloud Storage.", "$ref": "GoogleCloudAiplatformV1beta1FileData" }, "mediaResolution": { "description": "per part media resolution. Media resolution for the input media.", "$ref": "GoogleCloudAiplatformV1beta1PartMediaResolution" }, "videoMetadata": { "description": "Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data.", "$ref": "GoogleCloudAiplatformV1beta1VideoMetadata" }, "text": { "description": "Optional. The text content of the part. When sent from the VSCode Gemini Code Assist extension, references to @mentioned items will be converted to markdown boldface text. For example `@my-repo` will be converted to and sent as `**my-repo**` by the IDE agent.", "type": "string" }, "functionResponse": { "$ref": "GoogleCloudAiplatformV1beta1FunctionResponse", "description": "Optional. The result of a function call. This is used to provide the model with the result of a function call that it predicted." }, "thoughtSignature": { "type": "string", "format": "byte", "description": "Optional. An opaque signature for the thought so it can be reused in subsequent requests." } }, "id": "GoogleCloudAiplatformV1beta1Part" }, "GoogleCloudAiplatformV1beta1MemoryFilter": { "description": "Filter to apply when retrieving memories.", "type": "object", "properties": { "value": { "description": "Represents the value to compare to.", "$ref": "GoogleCloudAiplatformV1beta1MemoryMetadataValue" }, "key": { "description": "Represents the key of the filter. For example, \"author\" would apply to `metadata` entries with the key \"author\".", "type": "string" }, "negate": { "type": "boolean", "description": "Indicates whether the filter will be negated." }, "op": { "type": "string", "enumDescriptions": [ "Represents an unspecified operator. Defaults to EQUAL.", "Equal to.", "Greater than.", "Less than." ], "description": "Represents the operator to apply to the filter. If not set, then EQUAL will be used.", "enum": [ "OPERATOR_UNSPECIFIED", "EQUAL", "GREATER_THAN", "LESS_THAN" ] } }, "id": "GoogleCloudAiplatformV1beta1MemoryFilter" }, "GoogleCloudAiplatformV1beta1StructFieldValue": { "description": "One field of a Struct (or object) type feature value.", "properties": { "name": { "type": "string", "description": "Name of the field in the struct feature." }, "value": { "$ref": "GoogleCloudAiplatformV1beta1FeatureValue", "description": "The value for this field." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1StructFieldValue" }, "GoogleCloudAiplatformV1beta1MutateDeployedModelResponse": { "id": "GoogleCloudAiplatformV1beta1MutateDeployedModelResponse", "properties": { "deployedModel": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModel", "description": "The DeployedModel that's being mutated." } }, "type": "object", "description": "Response message for EndpointService.MutateDeployedModel." }, "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecRange": { "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecRange", "description": "A range of values for slice(s). `low` is inclusive, `high` is exclusive.", "properties": { "low": { "description": "Inclusive low value for the range.", "format": "float", "type": "number" }, "high": { "description": "Exclusive high value for the range.", "format": "float", "type": "number" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest": { "description": "Request message for MemoryBankService.RetrieveProfiles.", "properties": { "scope": { "additionalProperties": { "type": "string" }, "description": "Required. The scope of the profiles to retrieve.", "type": "object" } }, "id": "GoogleCloudAiplatformV1beta1RetrieveProfilesRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPromptInstancePromptExecution": { "properties": { "arguments": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptInstanceVariableValue" }, "description": "Maps variable names to their value.", "type": "object" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptInstancePromptExecution", "description": "A prompt instance's parameters set that contains a set of variable values." }, "GoogleCloudAiplatformV1beta1EvaluationExperiment": { "id": "GoogleCloudAiplatformV1beta1EvaluationExperiment", "description": "EvaluationExperiment is a resource that represents an experiment for iterating on and visualizing evaluation runs.", "properties": { "name": { "description": "Identifier. The resource name of the EvaluationExperiment. This is a unique identifier. Format: `projects/{project}/locations/{location}/evaluationExperiments/{evaluation_experiment}`", "type": "string" }, "updateTime": { "format": "google-datetime", "description": "Output only. Timestamp when this experiment was last updated.", "type": "string", "readOnly": true }, "createTime": { "format": "google-datetime", "description": "Output only. Timestamp when this experiment was created.", "type": "string", "readOnly": true }, "displayName": { "description": "Required. The display name of the evaluation experiment.", "type": "string" }, "labels": { "type": "object", "description": "Optional. Labels for the evaluation experiment.", "additionalProperties": { "type": "string" } }, "metadata": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object", "description": "Optional. Metadata about the evaluation experiment, can be used by the caller to store additional tracking information about the experiment." }, "evaluationRuns": { "items": { "type": "string" }, "description": "Required. The EvaluationRuns that are part of this experiment.", "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionCustomTask": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionCustomTask", "properties": { "inputs": { "description": "The input parameters of this CustomTask.", "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec" }, "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionCustomJobMetadata" } }, "type": "object", "description": "A TrainingJob that trains a custom code Model." }, "GoogleCloudAiplatformV1beta1ArtifactTypeSchema": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ArtifactTypeSchema", "description": "The definition of a artifact type in MLMD.", "properties": { "instanceSchema": { "description": "Contains a raw YAML string, describing the format of the properties of the type.", "type": "string" }, "schemaTitle": { "type": "string", "description": "The name of the type. The format of the title must be: `.`. Examples: - `aiplatform.Model` - `acme.CustomModel` When this field is set, the type must be pre-registered in the MLMD store." }, "schemaUri": { "deprecated": true, "type": "string", "description": "Points to a YAML file stored on Cloud Storage describing the format. Deprecated. Use PipelineArtifactTypeSchema.schema_title or PipelineArtifactTypeSchema.instance_schema instead." }, "schemaVersion": { "type": "string", "description": "The schema version of the artifact. If the value is not set, it defaults to the latest version in the system." } } }, "GoogleCloudAiplatformV1beta1FlexStart": { "id": "GoogleCloudAiplatformV1beta1FlexStart", "properties": { "maxRuntimeDuration": { "description": "The max duration of the deployment is max_runtime_duration. The deployment will be terminated after the duration. The max_runtime_duration can be set up to 7 days.", "format": "google-duration", "type": "string" } }, "type": "object", "description": "FlexStart is used to schedule the deployment workload on DWS resource. It contains the max duration of the deployment." }, "GoogleCloudAiplatformV1beta1SearchExamplesResponseSimilarExample": { "type": "object", "properties": { "example": { "description": "The example that is similar to the searched query.", "$ref": "GoogleCloudAiplatformV1beta1Example" }, "similarityScore": { "type": "number", "description": "The similarity score of this example.", "format": "float" } }, "id": "GoogleCloudAiplatformV1beta1SearchExamplesResponseSimilarExample", "description": "The result of the similar example." }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDoubleValueSpec": { "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDoubleValueSpec", "type": "object", "description": "Value specification for a parameter in `DOUBLE` type.", "properties": { "minValue": { "format": "double", "description": "Required. Inclusive minimum value of the parameter.", "type": "number" }, "maxValue": { "format": "double", "description": "Required. Inclusive maximum value of the parameter.", "type": "number" }, "defaultValue": { "format": "double", "description": "A default value for a `DOUBLE` parameter that is assumed to be a relatively good starting point. Unset value signals that there is no offered starting point. Currently only supported by the Vertex AI Vizier service. Not supported by HyperparameterTuningJob or TrainingPipeline.", "type": "number" } } }, "GoogleCloudAiplatformV1beta1ListNasTrialDetailsResponse": { "id": "GoogleCloudAiplatformV1beta1ListNasTrialDetailsResponse", "type": "object", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListNasTrialDetailsRequest.page_token to obtain that page.", "type": "string" }, "nasTrialDetails": { "type": "array", "description": "List of top NasTrials in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NasTrialDetail" } } }, "description": "Response message for JobService.ListNasTrialDetails" }, "GoogleCloudAiplatformV1beta1DeployRequest": { "description": "Request message for ModelGardenService.Deploy.", "properties": { "huggingFaceModelId": { "type": "string", "description": "The Hugging Face model to deploy. Format: Hugging Face model ID like `google/gemma-2-2b-it`." }, "customModel": { "description": "The custom model to deploy from a Google Cloud Storage URI.", "$ref": "GoogleCloudAiplatformV1beta1DeployRequestCustomModel" }, "publisherModelName": { "type": "string", "description": "The Model Garden model to deploy. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`." }, "deployConfig": { "description": "Optional. The deploy config to use for the deployment. If not specified, the default deploy config will be used.", "$ref": "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig" }, "modelConfig": { "$ref": "GoogleCloudAiplatformV1beta1DeployRequestModelConfig", "description": "Optional. The model config to use for the deployment. If not specified, the default model config will be used." }, "endpointConfig": { "description": "Optional. The endpoint config to use for the deployment. If not specified, the default endpoint config will be used.", "$ref": "GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1DeployRequest" }, "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfig": { "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfig", "properties": { "migrateDataLabelingAnnotatedDatasetConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfigMigrateDataLabelingAnnotatedDatasetConfig" }, "description": "Optional. Configs for migrating AnnotatedDataset in datalabeling.googleapis.com to Vertex AI's SavedQuery. The specified AnnotatedDatasets have to belong to the datalabeling Dataset.", "type": "array" }, "datasetDisplayName": { "description": "Optional. Display name of the Dataset in Vertex AI. System will pick a display name if unspecified.", "type": "string" }, "dataset": { "description": "Required. Full resource name of data labeling Dataset. Format: `projects/{project}/datasets/{dataset}`.", "type": "string" } }, "description": "Config for migrating Dataset in datalabeling.googleapis.com to Vertex AI's Dataset.", "type": "object" }, "GenaiVertexV1beta1StepList": { "id": "GenaiVertexV1beta1StepList", "type": "object", "properties": { "steps": { "description": "The steps of the list.", "items": { "$ref": "GenaiVertexV1beta1Step" }, "type": "array" } }, "description": "A list of Steps." }, "GoogleCloudAiplatformV1beta1NasJobSpec": { "id": "GoogleCloudAiplatformV1beta1NasJobSpec", "type": "object", "description": "Represents the spec of a NasJob.", "properties": { "resumeNasJobId": { "description": "The ID of the existing NasJob in the same Project and Location which will be used to resume search. search_space_spec and nas_algorithm_spec are obtained from previous NasJob hence should not provide them again for this NasJob.", "type": "string" }, "searchSpaceSpec": { "type": "string", "description": "It defines the search space for Neural Architecture Search (NAS)." }, "multiTrialAlgorithmSpec": { "$ref": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpec", "description": "The spec of multi-trial algorithms." } } }, "GenaiVertexV1beta1RetrievalResultDelta": { "description": "Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. ToolResultDelta.type", "type": "object", "properties": { "isError": { "type": "boolean", "description": "Whether the retrieval resulted in an error." } }, "id": "GenaiVertexV1beta1RetrievalResultDelta" }, "GoogleCloudAiplatformV1beta1Annotation": { "properties": { "labels": { "description": "Optional. The labels with user-defined metadata to organize your Annotations. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Annotation(System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable. Following system labels exist for each Annotation: * \"aiplatform.googleapis.com/annotation_set_name\": optional, name of the UI's annotation set this Annotation belongs to. If not set, the Annotation is not visible in the UI. * \"aiplatform.googleapis.com/payload_schema\": output only, its value is the payload_schema's title.", "additionalProperties": { "type": "string" }, "type": "object" }, "payload": { "description": "Required. The schema of the payload can be found in payload_schema.", "type": "any" }, "annotationSource": { "readOnly": true, "description": "Output only. The source of the Annotation.", "$ref": "GoogleCloudAiplatformV1beta1UserActionReference" }, "etag": { "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when this Annotation was created.", "readOnly": true }, "payloadSchemaUri": { "description": "Required. Google Cloud Storage URI points to a YAML file describing payload. The schema is defined as an [OpenAPI 3.0.2 Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/annotation/, note that the chosen schema must be consistent with the parent Dataset's metadata.", "type": "string" }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this Annotation was last updated.", "readOnly": true }, "name": { "description": "Output only. Resource name of the Annotation.", "readOnly": true, "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Annotation", "description": "Used to assign specific AnnotationSpec to a particular area of a DataItem or the whole part of the DataItem." }, "GoogleCloudAiplatformV1beta1DeployModelRequest": { "id": "GoogleCloudAiplatformV1beta1DeployModelRequest", "type": "object", "properties": { "deployedModel": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModel", "description": "Required. The DeployedModel to be created within the Endpoint. Note that Endpoint.traffic_split must be updated for the DeployedModel to start receiving traffic, either as part of this call, or via EndpointService.UpdateEndpoint." }, "trafficSplit": { "description": "A map from a DeployedModel's ID to the percentage of this Endpoint's traffic that should be forwarded to that DeployedModel. If this field is non-empty, then the Endpoint's traffic_split will be overwritten with it. To refer to the ID of the just being deployed Model, a \"0\" should be used, and the actual ID of the new DeployedModel will be filled in its place by this method. The traffic percentage values must add up to 100. If this field is empty, then the Endpoint's traffic_split is not updated.", "additionalProperties": { "format": "int32", "type": "integer" }, "type": "object" } }, "description": "Request message for EndpointService.DeployModel." }, "GoogleCloudAiplatformV1beta1SavedQuery": { "type": "object", "properties": { "supportAutomlTraining": { "readOnly": true, "description": "Output only. If the Annotations belonging to the SavedQuery can be used for AutoML training.", "type": "boolean" }, "metadata": { "type": "any", "description": "Some additional information about the SavedQuery." }, "annotationSpecCount": { "type": "integer", "description": "Output only. Number of AnnotationSpecs in the context of the SavedQuery.", "readOnly": true, "format": "int32" }, "etag": { "description": "Used to perform a consistent read-modify-write update. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when this SavedQuery was created." }, "annotationFilter": { "description": "Output only. Filters on the Annotations in the dataset.", "type": "string", "readOnly": true }, "displayName": { "description": "Required. The user-defined name of the SavedQuery. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "problemType": { "description": "Required. Problem type of the SavedQuery. Allowed values: * IMAGE_CLASSIFICATION_SINGLE_LABEL * IMAGE_CLASSIFICATION_MULTI_LABEL * IMAGE_BOUNDING_POLY * IMAGE_BOUNDING_BOX * TEXT_CLASSIFICATION_SINGLE_LABEL * TEXT_CLASSIFICATION_MULTI_LABEL * TEXT_EXTRACTION * TEXT_SENTIMENT * VIDEO_CLASSIFICATION * VIDEO_OBJECT_TRACKING", "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when SavedQuery was last updated.", "type": "string" }, "name": { "type": "string", "readOnly": true, "description": "Output only. Resource name of the SavedQuery." } }, "id": "GoogleCloudAiplatformV1beta1SavedQuery", "description": "A SavedQuery is a view of the dataset. It references a subset of annotations by problem type and filters." }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpec": { "properties": { "rubricGroupKey": { "description": "Use a pre-defined group of rubrics associated with the input content. This refers to a key in the `rubric_groups` map of `RubricEnhancedContents`.", "type": "string" }, "metricPromptTemplate": { "description": "Optional. Template for the prompt used by the judge model to evaluate against rubrics.", "type": "string" }, "judgeAutoraterConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig", "description": "Optional. Optional configuration for the judge LLM (Autorater). The definition of AutoraterConfig needs to be provided." }, "rubricGenerationSpec": { "description": "Dynamically generate rubrics for evaluation using this specification.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricGenerationSpec" }, "inlineRubrics": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpecRepeatedRubrics", "description": "Use rubrics provided directly in the spec." } }, "type": "object", "description": "Specification for a metric that is based on rubrics.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpec" }, "GoogleCloudAiplatformV1beta1ListModelVersionCheckpointsResponse": { "description": "Response message for ModelService.ListModelVersionCheckpoints", "properties": { "checkpoints": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelVersionCheckpoint" }, "description": "List of Model Version checkpoints.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListModelVersionCheckpointsRequest.page_token to obtain that page." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListModelVersionCheckpointsResponse" }, "GoogleCloudAiplatformV1beta1ListNasJobsResponse": { "type": "object", "properties": { "nasJobs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NasJob" }, "description": "List of NasJobs in the requested page. NasJob.nas_job_output of the jobs will not be returned." }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListNasJobsRequest.page_token to obtain that page." } }, "description": "Response message for JobService.ListNasJobs", "id": "GoogleCloudAiplatformV1beta1ListNasJobsResponse" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfig": { "description": "Agent Gateway configuration for a Reasoning Engine deployment.", "properties": { "clientToAgentConfig": { "description": "Optional. Configuration for traffic targeting the Reasoning Engine. When unset, incoming traffic is not routed through an Agent Gateway.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigClientToAgentConfig" }, "agentToAnywhereConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigAgentToAnywhereConfig", "description": "Optional. Configuration for traffic originating from the Reasoning Engine. When unset, outgoing traffic is not routed through an Agent Gateway." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfig" }, "GoogleCloudAiplatformV1beta1ToolNameMatchMetricValue": { "description": "Tool name match metric value for an instance.", "properties": { "score": { "description": "Output only. Tool name match score.", "format": "float", "readOnly": true, "type": "number" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolNameMatchMetricValue" }, "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringObjectiveConfig": { "properties": { "objectiveConfig": { "description": "The objective config of for the modelmonitoring job of this deployed model.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfig" }, "deployedModelId": { "description": "The DeployedModel ID of the objective config.", "type": "string" } }, "type": "object", "description": "ModelDeploymentMonitoringObjectiveConfig contains the pair of deployed_model_id to ModelMonitoringObjectiveConfig.", "id": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringObjectiveConfig" }, "GenaiVertexV1beta1FileSearchCallStep": { "id": "GenaiVertexV1beta1FileSearchCallStep", "properties": {}, "description": "File Search call step.", "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSource", "properties": { "events": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSourceEvent" }, "description": "Required. The source content (i.e. chat history) to generate memories from.", "type": "array" } }, "description": "Defines a direct source of content from which to generate the memories." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetricsConfidenceMetrics": { "properties": { "boundingBoxIou": { "type": "number", "format": "float", "description": "Bounding box intersection-over-union precision. Measures how well the bounding boxes overlap between each other (e.g. complete overlap or just barely above iou_threshold)." }, "confidenceThreshold": { "format": "float", "type": "number", "description": "The confidence threshold value used to compute the metrics." }, "mismatchRate": { "description": "Mismatch rate, which measures the tracking consistency, i.e. correctness of instance ID continuity.", "format": "float", "type": "number" }, "trackingPrecision": { "type": "number", "format": "float", "description": "Tracking precision." }, "trackingRecall": { "format": "float", "description": "Tracking recall.", "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetricsConfidenceMetrics", "type": "object", "description": "Metrics for a single confidence threshold." }, "GoogleCloudAiplatformV1beta1ListServingProfilesResponse": { "properties": { "servingProfiles": { "type": "array", "description": "Output only. A list of ServingProfiles.", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1ServingProfile" } }, "nextPageToken": { "description": "Output only. A token to retrieve the next page of results.", "readOnly": true, "type": "string" } }, "description": "Response message for ServingProfileService.ListServingProfiles.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListServingProfilesResponse" }, "GoogleIamV1Binding": { "id": "GoogleIamV1Binding", "properties": { "role": { "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", "type": "string" }, "members": { "type": "array", "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", "items": { "type": "string" } }, "condition": { "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "$ref": "GoogleTypeExpr" } }, "description": "Associates `members`, or principals, with a `role`.", "type": "object" }, "GoogleCloudAiplatformV1beta1CoherenceResult": { "type": "object", "description": "Spec for coherence result.", "properties": { "score": { "format": "float", "readOnly": true, "description": "Output only. Coherence score.", "type": "number" }, "explanation": { "type": "string", "readOnly": true, "description": "Output only. Explanation for coherence score." }, "confidence": { "description": "Output only. Confidence for coherence score.", "readOnly": true, "format": "float", "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1CoherenceResult" }, "GenaiVertexV1beta1UrlContextCallContentUrlContextCallArguments": { "type": "object", "description": "The arguments to pass to the URL context.", "id": "GenaiVertexV1beta1UrlContextCallContentUrlContextCallArguments", "properties": { "urls": { "type": "array", "description": "The URLs to fetch.", "items": { "type": "string" } } } }, "GenaiVertexV1beta1AgentInteraction": { "type": "object", "id": "GenaiVertexV1beta1AgentInteraction", "description": "Interaction for generating the completion using agents.", "properties": { "codeMenderConfig": { "$ref": "GenaiVertexV1beta1CodeMenderAgentConfig" }, "dynamicConfig": { "$ref": "GenaiVertexV1beta1DynamicAgentConfig" }, "agent": { "description": "The name of the `Agent` used for generating the completion.", "type": "string" }, "antigravityConfig": { "description": "Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.", "$ref": "GenaiVertexV1beta1AntigravityAgentConfig" }, "deepResearchConfig": { "$ref": "GenaiVertexV1beta1DeepResearchAgentConfig" } } }, "GoogleCloudAiplatformV1beta1SupervisedTuningSpec": { "description": "Tuning Spec for Supervised Tuning for first party models.", "properties": { "evaluationConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationConfig", "description": "Optional. Evaluation Config for Tuning Job." }, "tuningMode": { "enumDescriptions": [ "Tuning mode is unspecified.", "Full fine-tuning mode.", "PEFT adapter tuning mode." ], "type": "string", "description": "Tuning mode.", "enum": [ "TUNING_MODE_UNSPECIFIED", "TUNING_MODE_FULL", "TUNING_MODE_PEFT_ADAPTER" ] }, "trainingDatasetUri": { "description": "Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.", "type": "string" }, "validationDatasetUri": { "type": "string", "description": "Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset." }, "exportLastCheckpointOnly": { "description": "Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false.", "type": "boolean" }, "hyperParameters": { "description": "Optional. Hyperparameters for SFT.", "$ref": "GoogleCloudAiplatformV1beta1SupervisedHyperParameters" } }, "id": "GoogleCloudAiplatformV1beta1SupervisedTuningSpec", "type": "object" }, "GenaiVertexV1beta1VideoConfig": { "type": "object", "properties": { "task": { "enum": [ "TASK_UNSPECIFIED", "TEXT_TO_VIDEO", "IMAGE_TO_VIDEO", "REFERENCE_TO_VIDEO", "EDIT", "EXTEND" ], "description": "Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.", "enumDescriptions": [ "Unspecified task. The task is inferred from the input prompt and media.", "Generates video solely from a text prompt.", "Generates video from one or two source images. The first image defines the starting frame, and the optional second image defines the ending frame.", "Generates video using reference media (such as images, audio, or video).", "Modifies an existing input video.", "Extends an existing input video." ], "type": "string" } }, "id": "GenaiVertexV1beta1VideoConfig", "description": "Configuration options for video generation." }, "GenaiVertexV1beta1EnvironmentConfigEgressRule": { "type": "object", "id": "GenaiVertexV1beta1EnvironmentConfigEgressRule", "description": "A single domain allowlist rule with optional header injection.", "properties": { "domain": { "description": "Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains.", "type": "string" }, "transform": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Headers to inject into requests matching this rule. Key: header name (e.g., \"Authorization\"). Value: header value (e.g., \"Bearer your-token\")." }, "mode": { "enum": [ "NETWORK_MODE_UNSPECIFIED", "DISABLED" ], "enumDescriptions": [ "Default value. Unused.", "All network egress is blocked." ], "description": "Network egress mode. Set via the `\"allowlist\": \"disabled\"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig": { "properties": { "destinationBigqueryUri": { "description": "URI of desired destination BigQuery table. Expected format: `bq://{project_id}:{dataset_id}:{table}` If not specified, then results are exported to the following auto-created BigQuery table: `{project_id}:export_evaluated_examples_{model_name}_{yyyy_MM_dd'T'HH_mm_ss_SSS'Z'}.evaluated_examples`", "type": "string" }, "overrideExistingTable": { "description": "If true and an export destination is specified, then the contents of the destination are overwritten. Otherwise, if the export destination already exists, then the export operation fails.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig", "description": "Configuration for exporting test set predictions to a BigQuery table.", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateRagMetadataRequest": { "type": "object", "description": "Request message for CreateRagMetadata.", "properties": { "ragMetadataId": { "type": "string", "description": "Optional. The ID to use for the metadata, which will become the final component of the metadata's resource name if the user chooses to specify. Otherwise, metadata id will be generated by system. This value should be up to 63 characters, and valid characters are /a-z-/. The first character must be a letter, the last could be a letter or a number." }, "parent": { "type": "string", "description": "Required. The parent resource where this metadata will be created. Format: `projects/{project_number}/locations/{location_id}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}`" }, "ragMetadata": { "description": "Required. The metadata to create.", "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" } }, "id": "GoogleCloudAiplatformV1beta1CreateRagMetadataRequest" }, "GoogleCloudAiplatformV1beta1MemoryTopicId": { "description": "A memory topic identifier. This will be used to label a Memory and to restrict which topics are eligible for generation or retrieval.", "id": "GoogleCloudAiplatformV1beta1MemoryTopicId", "properties": { "managedMemoryTopic": { "enumDescriptions": [ "Represents an unspecified topic. This value should not be used.", "Represents significant personal information about the User like first names, relationships, hobbies, important dates.", "Represents stated or implied likes, dislikes, preferred styles, or patterns.", "Represents important milestones or conclusions within the dialogue.", "Represents information that the user explicitly requested to remember or forget." ], "enum": [ "MANAGED_TOPIC_ENUM_UNSPECIFIED", "USER_PERSONAL_INFO", "USER_PREFERENCES", "KEY_CONVERSATION_DETAILS", "EXPLICIT_INSTRUCTIONS" ], "description": "Optional. Represents the managed memory topic.", "type": "string" }, "customMemoryTopicLabel": { "description": "Optional. Represents the custom memory topic label.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInput": { "id": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInput", "type": "object", "description": "Instances and metric spec for TrajectorySingleToolUse metric.", "properties": { "metricSpec": { "description": "Required. Spec for TrajectorySingleToolUse metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseSpec" }, "instances": { "description": "Required. Repeated TrajectorySingleToolUse instance.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInstance" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic": { "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic", "properties": {}, "description": "Basic tier is a cost-effective and low compute tier suitable for the following cases: * Experimenting with RagManagedDb. * Small data size. * Latency insensitive workload. * Only using RAG Engine with external vector DBs. NOTE: This is the default tier under Spanner mode if not explicitly chosen.", "type": "object" }, "GoogleCloudAiplatformV1beta1PreTunedModel": { "id": "GoogleCloudAiplatformV1beta1PreTunedModel", "description": "A pre-tuned model for continuous tuning.", "type": "object", "properties": { "tunedModelName": { "type": "string", "description": "The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}`" }, "checkpointId": { "type": "string", "description": "Optional. The source checkpoint id. If not specified, the default checkpoint will be used." }, "baseModel": { "type": "string", "readOnly": true, "description": "Output only. The name of the base model this PreTunedModel was tuned from." } } }, "GenaiVertexV1beta1LocalEnvironmentConfig": { "type": "object", "id": "GenaiVertexV1beta1LocalEnvironmentConfig", "properties": {}, "description": "Configuration for an environment that lives on the client connection rather than in a server-managed sandbox. When set (via Interaction.local_environment), the agent's filesystem and shell are treated as living on the client: the agent's built-in environment operations (e.g. reading/listing/editing files and running commands) are suspended on the server and yielded back to the client to execute, with their results returned on a subsequent turn. This is mutually exclusive with a server-managed `EnvironmentConfig` (remote_environment), since the environment is either on the client or in a server sandbox, never both. This governs only the agent's built-in environment. Client-declared function tools are always executed on the client regardless of this field." }, "GoogleCloudAiplatformV1beta1ReinforcementTuningRewardInfo": { "description": "The reward info for a reward function.", "properties": { "errorStatus": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. In case of an error for this reward, this field will be populated with a detailed error status." }, "reward": { "type": "number", "readOnly": true, "description": "Output only. The calculated reward for the reward function.", "format": "float" }, "userRequestedAuxInfo": { "type": "string", "description": "Output only. The user-requested auxiliary info for the reward function. This field is set only if the Cloud Run reward function configured by user returns a \"user_requested_aux_info\". Refer to ReinforcementTuningCloudRunRewardScorer for more details.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningRewardInfo", "type": "object" }, "GoogleCloudAiplatformV1beta1ListRagFilesResponse": { "type": "object", "description": "Response message for VertexRagDataService.ListRagFiles.", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListRagFilesRequest.page_token to obtain that page.", "type": "string" }, "ragFiles": { "items": { "$ref": "GoogleCloudAiplatformV1beta1RagFile" }, "description": "List of RagFiles in the requested page.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ListRagFilesResponse" }, "GoogleCloudAiplatformV1beta1EmbedContentResponseEmbedding": { "description": "A list of floats representing an embedding.", "properties": { "values": { "items": { "type": "number", "format": "float" }, "description": "Embedding vector values.", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1EmbedContentResponseEmbedding" }, "GoogleCloudAiplatformV1beta1CorpusStatus": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CorpusStatus", "description": "RagCorpus status.", "properties": { "state": { "enumDescriptions": [ "This state is not supposed to happen.", "RagCorpus resource entry is initialized, but hasn't done validation.", "RagCorpus is provisioned successfully and is ready to serve.", "RagCorpus is in a problematic situation. See `error_message` field for details." ], "readOnly": true, "type": "string", "description": "Output only. RagCorpus life state.", "enum": [ "UNKNOWN", "INITIALIZED", "ACTIVE", "ERROR" ] }, "errorStatus": { "readOnly": true, "description": "Output only. Only when the `state` field is ERROR.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1UploadRagFileResponse": { "type": "object", "description": "Response message for VertexRagDataService.UploadRagFile.", "properties": { "error": { "$ref": "GoogleRpcStatus", "description": "The error that occurred while processing the RagFile." }, "ragFile": { "$ref": "GoogleCloudAiplatformV1beta1RagFile", "description": "The RagFile that had been uploaded into the RagCorpus." } }, "id": "GoogleCloudAiplatformV1beta1UploadRagFileResponse" }, "GoogleCloudAiplatformV1beta1DeploySolverOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1DeploySolverOperationMetadata", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The generic operation information." } }, "type": "object", "description": "Runtime operation information for SolverService.DeploySolver." }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageClassificationPredictionParams": { "type": "object", "properties": { "confidenceThreshold": { "type": "number", "format": "float", "description": "The Model only returns predictions with at least this confidence score. Default value is 0.0" }, "maxPredictions": { "type": "integer", "format": "int32", "description": "The Model only returns up to that many top, by confidence score, predictions per instance. If this number is very high, the Model may return fewer predictions. Default value is 10." } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageClassificationPredictionParams", "description": "Prediction model parameters for Image Classification." }, "GoogleCloudAiplatformV1beta1ExportModelRequestOutputConfig": { "description": "Output configuration for the Model export.", "id": "GoogleCloudAiplatformV1beta1ExportModelRequestOutputConfig", "type": "object", "properties": { "imageDestination": { "description": "The Google Container Registry or Artifact Registry uri where the Model container image will be copied to. This field should only be set when the `exportableContent` field of the [Model.supported_export_formats] object contains `IMAGE`.", "$ref": "GoogleCloudAiplatformV1beta1ContainerRegistryDestination" }, "exportFormatId": { "description": "The ID of the format in which the Model must be exported. Each Model lists the export formats it supports. If no value is provided here, then the first from the list of the Model's supported formats is used by default.", "type": "string" }, "artifactDestination": { "description": "The Cloud Storage location where the Model artifact is to be written to. Under the directory given as the destination a new one with name \"`model-export--`\", where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format, will be created. Inside, the Model and any of its supporting files will be written. This field should only be set when the `exportableContent` field of the [Model.supported_export_formats] object contains `ARTIFACT`.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" } } }, "GoogleCloudAiplatformV1beta1PipelineTaskDetailPipelineTaskStatus": { "properties": { "error": { "readOnly": true, "description": "Output only. The error that occurred during the state. May be set when the state is any of the non-final state (PENDING/RUNNING/CANCELLING) or FAILED state. If the state is FAILED, the error here is final and not going to be retried. If the state is a non-final state, the error indicates a system-error being retried.", "$ref": "GoogleRpcStatus" }, "state": { "description": "Output only. The state of the task.", "enumDescriptions": [ "Unspecified.", "Specifies pending state for the task.", "Specifies task is being executed.", "Specifies task completed successfully.", "Specifies Task cancel is in pending state.", "Specifies task is being cancelled.", "Specifies task was cancelled.", "Specifies task failed.", "Specifies task was skipped due to cache hit.", "Specifies that the task was not triggered because the task's trigger policy is not satisfied. The trigger policy is specified in the `condition` field of PipelineJob.pipeline_spec." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "PENDING", "RUNNING", "SUCCEEDED", "CANCEL_PENDING", "CANCELLING", "CANCELLED", "FAILED", "SKIPPED", "NOT_TRIGGERED" ] }, "updateTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Update time of this status." } }, "type": "object", "description": "A single record of the task status.", "id": "GoogleCloudAiplatformV1beta1PipelineTaskDetailPipelineTaskStatus" }, "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputInfo": { "id": "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputInfo", "properties": { "bigqueryOutputTable": { "readOnly": true, "description": "Output only. The name of the BigQuery table created, in `predictions_` format, into which the prediction output is written. Can be used by UI to generate the BigQuery output path, for example.", "type": "string" }, "gcsOutputDirectory": { "type": "string", "readOnly": true, "description": "Output only. The full path of the Cloud Storage directory created, into which the prediction output is written." }, "vertexMultimodalDatasetName": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the Vertex Managed Dataset created, into which the prediction output is written. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" }, "bigqueryOutputDataset": { "type": "string", "description": "Output only. The path of the BigQuery dataset created, in `bq://projectId.bqDatasetId` format, into which the prediction output is written.", "readOnly": true } }, "description": "Further describes this job's output. Supplements output_config.", "type": "object" }, "GoogleCloudAiplatformV1beta1DiskSpec": { "id": "GoogleCloudAiplatformV1beta1DiskSpec", "description": "Represents the spec of disk options.", "properties": { "bootDiskType": { "description": "Type of the boot disk. For non-A3U machines, the default value is \"pd-ssd\", for A3U machines, the default value is \"hyperdisk-balanced\". Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive), \"pd-standard\" (Persistent Disk Hard Disk Drive) or \"hyperdisk-balanced\".", "type": "string" }, "bootDiskSizeGb": { "type": "integer", "description": "Size in GB of the boot disk (default is 100GB).", "format": "int32" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PredictSchemata": { "id": "GoogleCloudAiplatformV1beta1PredictSchemata", "description": "Contains the schemata used in Model's predictions and explanations via PredictionService.Predict, PredictionService.Explain and BatchPredictionJob.", "properties": { "instanceSchemaUri": { "type": "string", "description": "Immutable. Points to a YAML file stored on Google Cloud Storage describing the format of a single instance, which are used in PredictRequest.instances, ExplainRequest.instances and BatchPredictionJob.input_config. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). AutoML Models always have this field populated by Vertex AI. Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access." }, "parametersSchemaUri": { "type": "string", "description": "Immutable. Points to a YAML file stored on Google Cloud Storage describing the parameters of prediction and explanation via PredictRequest.parameters, ExplainRequest.parameters and BatchPredictionJob.model_parameters. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). AutoML Models always have this field populated by Vertex AI, if no parameters are supported, then it is set to an empty string. Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access." }, "predictionSchemaUri": { "description": "Immutable. Points to a YAML file stored on Google Cloud Storage describing the format of a single prediction produced by this Model, which are returned via PredictResponse.predictions, ExplainResponse.explanations, and BatchPredictionJob.output_config. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). AutoML Models always have this field populated by Vertex AI. Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListModelEvaluationSlicesResponse": { "id": "GoogleCloudAiplatformV1beta1ListModelEvaluationSlicesResponse", "properties": { "modelEvaluationSlices": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSlice" }, "description": "List of ModelEvaluations in the requested page." }, "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListModelEvaluationSlicesRequest.page_token to obtain that page.", "type": "string" } }, "description": "Response message for ModelService.ListModelEvaluationSlices.", "type": "object" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfig": { "description": "Configuration for egress control of sandbox instances.", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfig", "properties": { "networkAttachment": { "description": "Optional. The name of the customer VPC `NetworkAttachment` used to draw a PSC interface IP into the customer VPC for sandbox egress.", "type": "string" }, "dnsPeeringConfigs": { "type": "array", "description": "Optional. DNS peering configurations that allow sandbox egress to resolve customer-internal domains via the customer VPC.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfigDnsPeeringConfig" } }, "internetAccess": { "description": "Optional. Whether to allow internet access.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExportFractionSplit": { "id": "GoogleCloudAiplatformV1beta1ExportFractionSplit", "type": "object", "description": "Assigns the input data to training, validation, and test sets as per the given fractions. Any of `training_fraction`, `validation_fraction` and `test_fraction` may optionally be provided, they must sum to up to 1. If the provided ones sum to less than 1, the remainder is assigned to sets as decided by Vertex AI. If none of the fractions are set, by default roughly 80% of data is used for training, 10% for validation, and 10% for test.", "properties": { "validationFraction": { "type": "number", "description": "The fraction of the input data that is to be used to validate the Model.", "format": "double" }, "trainingFraction": { "type": "number", "description": "The fraction of the input data that is to be used to train the Model.", "format": "double" }, "testFraction": { "format": "double", "type": "number", "description": "The fraction of the input data that is to be used to evaluate the Model." } } }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfig": { "description": "Deprecated: Use `google.cloud.aiplatform.master.AgentConfig` in `agent_eval_data` instead. Configuration for an Agent.", "type": "object", "properties": { "tools": { "description": "List of tools.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfigTools" }, "description": { "description": "Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly.", "type": "string" }, "toolsText": { "type": "string", "description": "A JSON string containing a list of tools available to an agent with info such as name, description, parameters and required parameters." }, "agentId": { "description": "Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map.", "type": "string" }, "developerInstruction": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData", "description": "Optional. Contains instructions from the developer for the agent. Can be static or a dynamic prompt template used with the `AgentEvent.state_delta` field." }, "subAgents": { "description": "Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the directed edges in the agent system graph topology.", "type": "array", "items": { "type": "string" } }, "agentType": { "description": "Optional. The type or class of the agent (e.g., \"LlmAgent\", \"RouterAgent\", \"ToolUseAgent\"). Useful for the autorater to understand the expected behavior of the agent.", "type": "string" } }, "deprecated": true, "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfig" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeContainerImage": { "properties": { "repository": { "description": "Required. The path to the container image repository. For example: `gcr.io/{project_id}/{image_name}`.", "type": "string" }, "tag": { "description": "Optional. The tag of the container image. If unset, defaults to `latest`.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeContainerImage", "description": "The definition of a user-provided container image to run the notebook execution in. Mirrors `google.cloud.notebooks.v2.ContainerImage`." }, "GoogleCloudAiplatformV1beta1SlackSourceSlackChannelsSlackChannel": { "properties": { "channelId": { "description": "Required. The Slack channel ID.", "type": "string" }, "endTime": { "description": "Optional. The ending timestamp for messages to import.", "format": "google-datetime", "type": "string" }, "startTime": { "description": "Optional. The starting timestamp for messages to import.", "format": "google-datetime", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SlackSourceSlackChannelsSlackChannel", "type": "object", "description": "SlackChannel contains the Slack channel ID and the time range to import." }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreEmbeddingManagement": { "deprecated": true, "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreEmbeddingManagement", "type": "object", "properties": { "enabled": { "description": "Optional. Immutable. Whether to enable embedding management in this FeatureOnlineStore. It's immutable after creation to ensure the FeatureOnlineStore availability.", "type": "boolean" } }, "description": "Deprecated: This sub message is no longer needed anymore and embedding management is automatically enabled when specifying Optimized storage type. Contains settings for embedding management." }, "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineResponse": { "description": "Response message for ReasoningEngineExecutionService.CancelAsyncQueryReasoningEngine.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1RemoveExamplesRequest": { "type": "object", "description": "Request message for ExampleStoreService.RemoveExamples.", "id": "GoogleCloudAiplatformV1beta1RemoveExamplesRequest", "properties": { "exampleIds": { "items": { "type": "string" }, "type": "array", "description": "Optional. Example IDs to remove. If both metadata filters and Example IDs are specified, the metadata filters will be applied to the specified examples in order to identify which should be removed." }, "storedContentsExampleFilter": { "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleFilter", "description": "The metadata filters for StoredContentsExamples." } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationAutoTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationAutoTransformation", "properties": { "columnName": { "type": "string" } }, "description": "Training pipeline will infer the proper transformation based on the statistic of dataset.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunMetric": { "properties": { "rubricBasedMetricSpec": { "description": "Spec for rubric based metric.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpec" }, "metricConfig": { "$ref": "GoogleCloudAiplatformV1beta1Metric", "description": "The metric config." }, "computationBasedMetricSpec": { "description": "Spec for a computation based metric.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec" }, "metricResourceName": { "description": "Optional. The resource name of the metric definition.", "type": "string" }, "predefinedMetricSpec": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec", "description": "Spec for a pre-defined metric." }, "metric": { "description": "Required. The name of the metric.", "type": "string" }, "llmBasedMetricSpec": { "description": "Spec for an LLM based metric.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricLLMBasedMetricSpec" } }, "description": "The metric used for evaluation runs.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetric", "type": "object" }, "GoogleCloudAiplatformV1beta1PartnerModelTuningSpec": { "description": "Tuning spec for Partner models.", "properties": { "hyperParameters": { "type": "object", "description": "Hyperparameters for tuning. The accepted hyper_parameters and their valid range of values will differ depending on the base model.", "additionalProperties": { "type": "any" } }, "validationDatasetUri": { "type": "string", "description": "Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file." }, "trainingDatasetUri": { "description": "Required. Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1PartnerModelTuningSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitor": { "properties": { "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "modelMonitoringSchema": { "description": "Monitoring Schema is to specify the model's features, prediction outputs and ground truth properties. It is used to extract pertinent data from the dataset and to process features based on their properties. Make sure that the schema aligns with your dataset, if it does not, we will be unable to extract data from the dataset. It is required for most models, but optional for Vertex AI AutoML Tables unless the schem information is not available.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringSchema" }, "updateTime": { "description": "Output only. Timestamp when this ModelMonitor was updated most recently.", "readOnly": true, "type": "string", "format": "google-datetime" }, "trainingDataset": { "description": "Optional training dataset used to train the model. It can serve as a reference dataset to identify changes in production.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInput" }, "notificationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpec", "description": "Optional default notification spec, it can be overridden in the ModelMonitoringJob notification spec." }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "explanationSpec": { "description": "Optional model explanation spec. It is used for feature attribution monitoring.", "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec" }, "displayName": { "type": "string", "description": "The display name of the ModelMonitor. The name can be up to 128 characters long and can consist of any UTF-8." }, "name": { "description": "Immutable. Resource name of the ModelMonitor. Format: `projects/{project}/locations/{location}/modelMonitors/{model_monitor}`.", "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Timestamp when this ModelMonitor was created.", "readOnly": true, "type": "string" }, "tabularObjective": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecTabularObjective", "description": "Optional default tabular model monitoring objective." }, "modelMonitoringTarget": { "description": "The entity that is subject to analysis. Currently only models in Vertex AI Model Registry are supported. If you want to analyze the model which is outside the Vertex AI, you could register a model in Vertex AI Model Registry using just a display name.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTarget" }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a ModelMonitor. If set, this ModelMonitor and all sub-resources of this ModelMonitor will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "outputSpec": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringOutputSpec", "description": "Optional default monitoring metrics/logs export spec, it can be overridden in the ModelMonitoringJob output spec. If not specified, a default Google Cloud Storage bucket will be created under your project." } }, "description": "Vertex AI Model Monitoring Service serves as a central hub for the analysis and visualization of data quality and performance related to models. ModelMonitor stands as a top level resource for overseeing your model monitoring tasks.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitor" }, "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataResponse": { "description": "Response message for TensorboardService.ExportTensorboardTimeSeriesData.", "properties": { "timeSeriesDataPoints": { "description": "The returned time series data points.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TimeSeriesDataPoint" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1Attribution": { "id": "GoogleCloudAiplatformV1beta1Attribution", "type": "object", "description": "Attribution that explains a particular prediction output.", "properties": { "outputName": { "readOnly": true, "type": "string", "description": "Output only. Name of the explain output. Specified as the key in ExplanationMetadata.outputs." }, "featureAttributions": { "readOnly": true, "type": "any", "description": "Output only. Attributions of each explained feature. Features are extracted from the prediction instances according to explanation metadata for inputs. The value is a struct, whose keys are the name of the feature. The values are how much the feature in the instance contributed to the predicted result. The format of the value is determined by the feature's input format: * If the feature is a scalar value, the attribution value is a floating number. * If the feature is an array of scalar values, the attribution value is an array. * If the feature is a struct, the attribution value is a struct. The keys in the attribution value struct are the same as the keys in the feature struct. The formats of the values in the attribution struct are determined by the formats of the values in the feature struct. The ExplanationMetadata.feature_attributions_schema_uri field, pointed to by the ExplanationSpec field of the Endpoint.deployed_models object, points to the schema file that describes the features and their attribution values (if it is populated)." }, "outputDisplayName": { "type": "string", "description": "Output only. The display name of the output identified by output_index. For example, the predicted class name by a multi-classification Model. This field is only populated iff the Model predicts display names as a separate field along with the explained output. The predicted display name must has the same shape of the explained output, and can be located using output_index.", "readOnly": true }, "outputIndex": { "readOnly": true, "description": "Output only. The index that locates the explained prediction output. If the prediction output is a scalar value, output_index is not populated. If the prediction output has multiple dimensions, the length of the output_index list is the same as the number of dimensions of the output. The i-th element in output_index is the element index of the i-th dimension of the output vector. Indices start from 0.", "items": { "format": "int32", "type": "integer" }, "type": "array" }, "approximationError": { "description": "Output only. Error of feature_attributions caused by approximation used in the explanation method. Lower value means more precise attributions. * For Sampled Shapley attribution, increasing path_count might reduce the error. * For Integrated Gradients attribution, increasing step_count might reduce the error. * For XRAI attribution, increasing step_count might reduce the error. See [this introduction](/vertex-ai/docs/explainable-ai/overview) for more information.", "format": "double", "type": "number", "readOnly": true }, "instanceOutputValue": { "type": "number", "readOnly": true, "format": "double", "description": "Output only. Model predicted output on the corresponding explanation instance. The field name of the output is determined by the key in ExplanationMetadata.outputs. If the Model predicted output has multiple dimensions, this is the value in the output located by output_index." }, "baselineOutputValue": { "format": "double", "readOnly": true, "description": "Output only. Model predicted output if the input instance is constructed from the baselines of all the features defined in ExplanationMetadata.inputs. The field name of the output is determined by the key in ExplanationMetadata.outputs. If the Model's predicted output has multiple dimensions (rank \u003e 1), this is the value in the output located by output_index. If there are multiple baselines, their output values are averaged.", "type": "number" } } }, "GoogleCloudAiplatformV1beta1SchemaVisualInspectionMaskSavedQueryMetadata": { "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaVisualInspectionMaskSavedQueryMetadata" }, "GoogleCloudAiplatformV1beta1ExternalApiSimpleSearchParams": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ExternalApiSimpleSearchParams", "description": "The search parameters to use for SIMPLE_SEARCH spec.", "properties": {} }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectTimeRangeAndFeature": { "type": "object", "description": "Message to select time range and feature. Values of the selected feature generated within an inclusive time range will be deleted. Using this option permanently deletes the feature values from the specified feature IDs within the specified time range. This might include data from the online storage. If you want to retain any deleted historical data in the online storage, you must re-ingest it.", "properties": { "timeRange": { "$ref": "GoogleTypeInterval", "description": "Required. Select feature generated within a half-inclusive time range. The time range is lower inclusive and upper exclusive." }, "skipOnlineStorageDelete": { "description": "If set, data will not be deleted from online storage. When time range is older than the data in online storage, setting this to be true will make the deletion have no impact on online serving.", "type": "boolean" }, "featureSelector": { "description": "Required. Selectors choosing which feature values to be deleted from the EntityType.", "$ref": "GoogleCloudAiplatformV1beta1FeatureSelector" } }, "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectTimeRangeAndFeature" }, "GoogleCloudAiplatformV1beta1DisableXmanagerOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1DisableXmanagerOperationMetadata", "description": "Metadata message for DisableXmanager RPC.", "type": "object", "properties": { "genericMetadata": { "description": "Output only. Operation metadata for DisableXmanager.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progress": { "description": "Output only. Progress Message for DisableXmanager LRO", "readOnly": true, "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationSentenceFileInput": { "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationSentenceFileInput", "properties": { "fileInputSource": { "description": "Inlined file source.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationFileInputSource" }, "gcsInputSource": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationGcsInputSource", "description": "Cloud Storage file source." } }, "type": "object" }, "GenaiVertexV1beta1ToolCallStep": { "description": "Tool call step.", "properties": { "fileSearchCall": { "$ref": "GenaiVertexV1beta1FileSearchCallStep" }, "googleSearchCall": { "$ref": "GenaiVertexV1beta1GoogleSearchCallStep" }, "id": { "description": "Required. A unique ID for this specific tool call.", "type": "string" }, "codeExecutionCall": { "$ref": "GenaiVertexV1beta1CodeExecutionCallStep" }, "signature": { "format": "byte", "description": "A signature hash for backend validation.", "type": "string" }, "mcpServerToolCall": { "$ref": "GenaiVertexV1beta1McpServerToolCallStep" }, "urlContextCall": { "$ref": "GenaiVertexV1beta1UrlContextCallStep" }, "googleMapsCall": { "$ref": "GenaiVertexV1beta1GoogleMapsCallStep" }, "functionCall": { "$ref": "GenaiVertexV1beta1FunctionCallStep" }, "processingCall": { "$ref": "GenaiVertexV1beta1ProcessingCallStep" }, "retrievalCall": { "$ref": "GenaiVertexV1beta1RetrievalCallStep" } }, "id": "GenaiVertexV1beta1ToolCallStep", "type": "object" }, "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigSnapshotAnalysis": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigSnapshotAnalysis", "description": "Configuration of the Featurestore's Snapshot Analysis Based Monitoring. This type of analysis generates statistics for each Feature based on a snapshot of the latest feature value of each entities every monitoring_interval.", "properties": { "stalenessDays": { "format": "int32", "description": "Customized export features time window for snapshot analysis. Unit is one day. Default value is 3 weeks. Minimum value is 1 day. Maximum value is 4000 days.", "type": "integer" }, "monitoringInterval": { "deprecated": true, "format": "google-duration", "description": "Configuration of the snapshot analysis based monitoring pipeline running interval. The value is rolled up to full day. If both monitoring_interval_days and the deprecated `monitoring_interval` field are set when creating/updating EntityTypes/Features, monitoring_interval_days will be used.", "type": "string" }, "monitoringIntervalDays": { "format": "int32", "type": "integer", "description": "Configuration of the snapshot analysis based monitoring pipeline running interval. The value indicates number of days." }, "disabled": { "type": "boolean", "description": "The monitoring schedule for snapshot analysis. For EntityType-level config: unset / disabled = true indicates disabled by default for Features under it; otherwise by default enable snapshot analysis monitoring with monitoring_interval for Features under it. Feature-level config: disabled = true indicates disabled regardless of the EntityType-level config; unset monitoring_interval indicates going with EntityType-level config; otherwise run snapshot analysis monitoring with monitoring_interval regardless of the EntityType-level config. Explicitly Disable the snapshot analysis based monitoring." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TaskStateChange": { "id": "GoogleCloudAiplatformV1beta1TaskStateChange", "type": "object", "properties": { "newState": { "description": "Required. The new state of the task.", "enum": [ "STATE_UNSPECIFIED", "SUBMITTED", "WORKING", "COMPLETED", "CANCELLED", "FAILED", "REJECTED", "INPUT_REQUIRED", "AUTH_REQUIRED", "PAUSED" ], "enumDescriptions": [ "Task state unspecified. Default value if not set.", "Task is submitted and waiting to be processed.", "Task is actively being processed.", "Task is finished.", "Task is cancelled.", "Task has failed.", "Task is rejected by the system.", "Task requires input from the user.", "Task requires auth (e.g. OAuth) from the user.", "Task is paused." ], "type": "string" } }, "description": "A message representing a change in a task's state." }, "GoogleCloudAiplatformV1beta1Tool": { "properties": { "exaAiSearch": { "description": "Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation", "$ref": "GoogleCloudAiplatformV1beta1ToolExaAiSearch" }, "retrieval": { "$ref": "GoogleCloudAiplatformV1beta1Retrieval", "description": "Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation." }, "urlContext": { "description": "Optional. Tool to support URL context retrieval.", "$ref": "GoogleCloudAiplatformV1beta1UrlContext" }, "computerUse": { "description": "Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.", "$ref": "GoogleCloudAiplatformV1beta1ToolComputerUse" }, "googleSearch": { "description": "Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google.", "$ref": "GoogleCloudAiplatformV1beta1ToolGoogleSearch" }, "codeExecution": { "$ref": "GoogleCloudAiplatformV1beta1ToolCodeExecution", "description": "Optional. CodeExecution tool type. Enables the model to execute code as part of generation." }, "enterpriseWebSearch": { "$ref": "GoogleCloudAiplatformV1beta1EnterpriseWebSearch", "description": "Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance." }, "functionDeclarations": { "description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FunctionDeclaration" }, "type": "array" }, "googleSearchRetrieval": { "description": "Optional. Specialized retrieval tool that is powered by Google Search.", "$ref": "GoogleCloudAiplatformV1beta1GoogleSearchRetrieval", "deprecated": true }, "parallelAiSearch": { "description": "Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation", "$ref": "GoogleCloudAiplatformV1beta1ToolParallelAiSearch" }, "googleMaps": { "description": "Optional. GoogleMaps tool type. Tool to support Google Maps in Model.", "$ref": "GoogleCloudAiplatformV1beta1GoogleMaps" } }, "id": "GoogleCloudAiplatformV1beta1Tool", "description": "Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).", "type": "object" }, "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse": { "id": "GoogleCloudAiplatformV1beta1ListMemoryRevisionsResponse", "type": "object", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "memoryRevisions": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryRevision" }, "description": "The list of Memory Revisions in the request page." } }, "description": "Response message for MemoryBankService.ListMemoryRevisions." }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeploy": { "description": "Model metadata that is needed for UploadModel or DeployModel/CreateEndpoint requests.", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeploy", "properties": { "artifactUri": { "type": "string", "description": "Optional. The path to the directory containing the Model artifact and any of its supporting files." }, "title": { "description": "Required. The title of the regional resource reference.", "type": "string" }, "dedicatedResources": { "description": "A description of resources that are dedicated to the DeployedModel, and that need a higher degree of manual configuration.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "containerSpec": { "description": "Optional. The specification of the container that is to be used when deploying this Model in Vertex AI. Not present for Large Models.", "$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec" }, "sharedResources": { "type": "string", "description": "The resource name of the shared DeploymentResourcePool to deploy on. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`" }, "deployMetadata": { "description": "Optional. Metadata information about this deployment config.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployDeployMetadata" }, "publicArtifactUri": { "type": "string", "description": "Optional. The signed URI for ephemeral Cloud Storage access to model artifact." }, "largeModelReference": { "description": "Optional. Large model reference. When this is set, model_artifact_spec is not needed.", "$ref": "GoogleCloudAiplatformV1beta1LargeModelReference" }, "modelDisplayName": { "type": "string", "description": "Optional. Default model display name." }, "automaticResources": { "description": "A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration.", "$ref": "GoogleCloudAiplatformV1beta1AutomaticResources" }, "deployTaskName": { "type": "string", "description": "Optional. The name of the deploy task (e.g., \"text to image generation\")." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PredictLongRunningRequest": { "properties": { "labels": { "type": "object", "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", "additionalProperties": { "type": "string" } }, "instances": { "items": { "type": "any" }, "type": "array", "description": "Required. The instances that are the input to the prediction call. A DeployedModel may have an upper limit on the number of instances it supports per request, and when it is exceeded the prediction call errors in case of AutoML Models, or, in case of customer created Models, the behaviour is as documented by that Model. The schema of any single instance may be specified via Endpoint's DeployedModels' Model's PredictSchemata's instance_schema_uri." }, "parameters": { "type": "any", "description": "Optional. The parameters that govern the prediction. The schema of the parameters may be specified via Endpoint's DeployedModels' Model's PredictSchemata's parameters_schema_uri." } }, "type": "object", "description": "Request message for PredictionService.PredictLongRunning.", "id": "GoogleCloudAiplatformV1beta1PredictLongRunningRequest" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePair": { "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePair", "type": "object", "description": "A pair of sentences used as reference in source and target languages.", "properties": { "sourceSentence": { "type": "string", "description": "Source sentence in the sentence pair." }, "targetSentence": { "type": "string", "description": "Target sentence in the sentence pair." } } }, "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfigAuthProvider": { "properties": { "allowedIssuers": { "type": "array", "items": { "type": "string" }, "description": "A list of allowed JWT issuers. Each entry must be a valid Google service account, in the following format: `service-account-name@project-id.iam.gserviceaccount.com`" }, "audiences": { "items": { "type": "string" }, "description": "The list of JWT [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). that are allowed to access. A JWT containing any of these audiences will be accepted.", "type": "array" } }, "type": "object", "description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).", "id": "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfigAuthProvider" }, "GenaiVertexV1beta1FunctionResultStep": { "id": "GenaiVertexV1beta1FunctionResultStep", "description": "Result of a function tool call.", "type": "object", "properties": { "isError": { "description": "Whether the tool call resulted in an error.", "type": "boolean" }, "result": { "$ref": "GenaiVertexV1beta1Value", "description": "Required. The result of the tool call." }, "name": { "description": "The name of the tool that was called.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1MutateDeployedModelOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "id": "GoogleCloudAiplatformV1beta1MutateDeployedModelOperationMetadata", "description": "Runtime operation information for EndpointService.MutateDeployedModel.", "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineJob": { "description": "An instance of a machine learning PipelineJob.", "id": "GoogleCloudAiplatformV1beta1PipelineJob", "type": "object", "properties": { "network": { "description": "The full name of the Compute Engine [network](/compute/docs/networks-and-firewalls#networks) to which the Pipeline Job's workload should be peered. For example, `projects/12345/global/networks/myVPC`. [Format](/compute/docs/reference/rest/v1/networks/insert) is of the form `projects/{project}/global/networks/{network}`. Where {project} is a project number, as in `12345`, and {network} is a network name. Private services access must already be configured for the network. Pipeline job will apply the network configuration to the Google Cloud resources being launched, if applied, such as Vertex AI Training or Dataflow job. If left unspecified, the workload is not peered with any network.", "type": "string" }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "templateUri": { "description": "A template uri from where the PipelineJob.pipeline_spec, if empty, will be downloaded. Currently, only uri from Vertex Template Registry & Gallery is supported. Reference to https://cloud.google.com/vertex-ai/docs/pipelines/create-pipeline-template.", "type": "string" }, "serviceAccount": { "type": "string", "description": "The service account that the pipeline workload runs as. If not specified, the Compute Engine default service account in the project will be used. See https://cloud.google.com/compute/docs/access/service-accounts#default_service_account Users starting the pipeline must have the `iam.serviceAccounts.actAs` permission on this service account." }, "runtimeConfig": { "description": "Runtime config of the pipeline.", "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig" }, "preflightValidations": { "type": "boolean", "description": "Optional. Whether to do component level validations before job creation." }, "originalPipelineJobId": { "type": "string", "format": "int64", "description": "Optional. The original pipeline job id if this pipeline job is a rerun of a previous pipeline job." }, "templateMetadata": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1PipelineTemplateMetadata", "description": "Output only. Pipeline template metadata. Will fill up fields if PipelineJob.template_uri is from supported template registry." }, "displayName": { "type": "string", "description": "The display name of the Pipeline. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "labels": { "type": "object", "description": "The labels with user-defined metadata to organize PipelineJob. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. Note there is some reserved label key for Vertex AI Pipelines. - `vertex-ai-pipelines-run-billing-id`, user set value will get overrided.", "additionalProperties": { "type": "string" } }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. Pipeline creation time.", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the PipelineJob." }, "endTime": { "format": "google-datetime", "type": "string", "description": "Output only. Pipeline end time.", "readOnly": true }, "jobDetail": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJobDetail", "readOnly": true, "description": "Output only. The details of pipeline run. Not available in the list view." }, "satisfiesPzi": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "updateTime": { "description": "Output only. Timestamp when this PipelineJob was most recently updated.", "type": "string", "readOnly": true, "format": "google-datetime" }, "scheduleName": { "readOnly": true, "description": "Output only. The schedule resource name. Only returned if the Pipeline is created by Schedule API.", "type": "string" }, "reservedIpRanges": { "type": "array", "description": "A list of names for the reserved ip ranges under the VPC network that can be used for this Pipeline Job's workload. If set, we will deploy the Pipeline Job's workload within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network. Example: ['vertex-ai-ip-range'].", "items": { "type": "string" } }, "pscInterfaceConfig": { "description": "Optional. Configuration for PSC-I for PipelineJob.", "$ref": "GoogleCloudAiplatformV1beta1PscInterfaceConfig" }, "pipelineTaskRerunConfigs": { "description": "Optional. The rerun configs for each task in the pipeline job. By default, the rerun will: 1. Use the same input artifacts as the original run. 2. Use the same input parameters as the original run. 3. Skip all the tasks that are already succeeded in the original run. 4. Rerun all the tasks that are not succeeded in the original run. By providing this field, users can override the default behavior and specify the rerun config for each task.", "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfig" }, "type": "array" }, "startTime": { "description": "Output only. Pipeline start time.", "format": "google-datetime", "readOnly": true, "type": "string" }, "error": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. The error that occurred during pipeline execution. Only populated when the pipeline's state is FAILED or CANCELLED." }, "state": { "description": "Output only. The detailed state of the job.", "readOnly": true, "enumDescriptions": [ "The pipeline state is unspecified.", "The pipeline has been created or resumed, and processing has not yet begun.", "The service is preparing to run the pipeline.", "The pipeline is in progress.", "The pipeline completed successfully.", "The pipeline failed.", "The pipeline is being cancelled. From this state, the pipeline may only go to either PIPELINE_STATE_SUCCEEDED, PIPELINE_STATE_FAILED or PIPELINE_STATE_CANCELLED.", "The pipeline has been cancelled.", "The pipeline has been stopped, and can be resumed." ], "enum": [ "PIPELINE_STATE_UNSPECIFIED", "PIPELINE_STATE_QUEUED", "PIPELINE_STATE_PENDING", "PIPELINE_STATE_RUNNING", "PIPELINE_STATE_SUCCEEDED", "PIPELINE_STATE_FAILED", "PIPELINE_STATE_CANCELLING", "PIPELINE_STATE_CANCELLED", "PIPELINE_STATE_PAUSED" ], "type": "string" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key spec for a pipelineJob. If set, this PipelineJob and all of its sub-resources will be secured by this key." }, "pipelineSpec": { "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "A compiled definition of a pipeline, represented as a `JSON` object. Defines the structure of the pipeline, including its components, tasks, and parameters. This specification is generated by compiling a pipeline function defined in `Python` using the `Kubeflow Pipelines SDK`." } } }, "GoogleCloudAiplatformV1beta1Artifact": { "id": "GoogleCloudAiplatformV1beta1Artifact", "type": "object", "properties": { "displayName": { "description": "User provided display name of the Artifact. May be up to 128 Unicode characters.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when this Artifact was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "uri": { "description": "The uniform resource identifier of the artifact file. May be empty if there is no actual artifact file.", "type": "string" }, "schemaTitle": { "type": "string", "description": "The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store." }, "state": { "description": "The state of this Artifact. This is a property of the Artifact, and does not imply or capture any ongoing process. This property is managed by clients (such as Vertex AI Pipelines), and the system does not prescribe or check the validity of state transitions.", "enumDescriptions": [ "Unspecified state for the Artifact.", "A state used by systems like Vertex AI Pipelines to indicate that the underlying data item represented by this Artifact is being created.", "A state indicating that the Artifact should exist, unless something external to the system deletes it." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "PENDING", "LIVE" ] }, "name": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the Artifact." }, "schemaVersion": { "type": "string", "description": "The version of the schema in schema_name to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store." }, "description": { "type": "string", "description": "Description of the Artifact" }, "updateTime": { "description": "Output only. Timestamp when this Artifact was last updated.", "readOnly": true, "type": "string", "format": "google-datetime" }, "metadata": { "description": "Properties of the Artifact. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "etag": { "description": "An eTag used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "labels": { "description": "The labels with user-defined metadata to organize your Artifacts. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Artifact (System labels are excluded).", "type": "object", "additionalProperties": { "type": "string" } } }, "description": "Instance of a general artifact." }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectSource": { "properties": { "config": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectConfig", "description": "Required. The Developer Connect configuration that defines the specific repository, revision, and directory to use as the source code root." } }, "description": "Specifies source code to be fetched from a Git repository managed through the Developer Connect service.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectSource", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalArrayTransformation": { "type": "object", "description": "Treats the column as categorical array and performs following transformation functions. * For each element in the array, convert the category name to a dictionary lookup index and generate an embedding for each index. Combine the embedding of all elements into a single embedding using the mean. * Empty arrays treated as an embedding of zeroes.", "properties": { "columnName": { "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalArrayTransformation" }, "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInstance": { "id": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInstance", "description": "Spec for TrajectorySingleToolUse instance.", "properties": { "predictedTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for predicted tool call trajectory." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ToolCallValidInstance": { "id": "GoogleCloudAiplatformV1beta1ToolCallValidInstance", "type": "object", "properties": { "reference": { "type": "string", "description": "Required. Ground truth used to compare against the prediction." }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } }, "description": "Spec for tool call valid instance." }, "CloudAiLargeModelsVisionGenerateVideoExperimentsSpatialAlignmentConfig": { "description": "Configuration for spatial alignment.", "type": "object", "properties": { "enable": { "description": "Optional. If true, enable alignment.", "type": "boolean" } }, "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsSpatialAlignmentConfig" }, "GoogleCloudAiplatformV1beta1CreateDeploymentResourcePoolOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateDeploymentResourcePoolOperationMetadata", "description": "Runtime operation information for CreateDeploymentResourcePool method.", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1BatchCreateFeaturesOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1BatchCreateFeaturesOperationMetadata", "type": "object", "description": "Details of operations that perform batch create Features.", "properties": { "genericMetadata": { "description": "Operation metadata for Feature.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1CometInput": { "description": "Input for Comet metric.", "id": "GoogleCloudAiplatformV1beta1CometInput", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1CometSpec", "description": "Required. Spec for comet metric." }, "instance": { "description": "Required. Comet instance.", "$ref": "GoogleCloudAiplatformV1beta1CometInstance" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1UpdateFeatureViewOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UpdateFeatureViewOperationMetadata", "properties": { "genericMetadata": { "description": "Operation metadata for FeatureView Update.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "description": "Details of operations that perform update FeatureView." }, "GoogleCloudAiplatformV1beta1ExactMatchMetricValue": { "description": "Exact match metric value for an instance.", "id": "GoogleCloudAiplatformV1beta1ExactMatchMetricValue", "type": "object", "properties": { "score": { "format": "float", "type": "number", "description": "Output only. Exact match score.", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1FailedRubric": { "properties": { "classificationRationale": { "type": "string", "description": "The rationale provided by the Loss Analysis Classifier for why this failure maps to this specific Loss Cluster. e.g., \"The agent claimed an action without a tool call, matching 'Hallucination of Action'.\"" }, "rubricId": { "type": "string", "description": "The unique ID of the rubric (if available from the metric source). Clients use this ID to query the corresponding rubric verdict." } }, "type": "object", "description": "Represents a specific failed rubric and the associated analysis.", "id": "GoogleCloudAiplatformV1beta1FailedRubric" }, "GoogleCloudAiplatformV1beta1ToolNameMatchInstance": { "properties": { "reference": { "type": "string", "description": "Required. Ground truth used to compare against the prediction." }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } }, "id": "GoogleCloudAiplatformV1beta1ToolNameMatchInstance", "description": "Spec for tool name match instance.", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsResponse": { "description": "Response message for ModelMonitoringService.SearchModelMonitoringStats.", "properties": { "monitoringStats": { "description": "Stats retrieved for requested objectives.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStats" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "The page token that can be used by the next ModelMonitoringService.SearchModelMonitoringStats call." } }, "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecSearchTrialSpec": { "id": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecSearchTrialSpec", "type": "object", "properties": { "maxFailedTrialCount": { "type": "integer", "description": "The number of failed trials that need to be seen before failing the NasJob. If set to 0, Vertex AI decides how many trials must fail before the whole job fails.", "format": "int32" }, "maxParallelTrialCount": { "type": "integer", "format": "int32", "description": "Required. The maximum number of trials to run in parallel." }, "maxTrialCount": { "description": "Required. The maximum number of Neural Architecture Search (NAS) trials to run.", "format": "int32", "type": "integer" }, "searchTrialJobSpec": { "description": "Required. The spec of a search trial job. The same spec applies to all search trials.", "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec" } }, "description": "Represent spec for search trials." }, "GoogleCloudAiplatformV1beta1CreateNotebookExecutionJobRequest": { "properties": { "parent": { "description": "Required. The resource name of the Location to create the NotebookExecutionJob. Format: `projects/{project}/locations/{location}`", "type": "string" }, "notebookExecutionJobId": { "description": "Optional. User specified ID for the NotebookExecutionJob.", "type": "string" }, "notebookExecutionJob": { "description": "Required. The NotebookExecutionJob to create.", "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJob" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateNotebookExecutionJobRequest", "description": "Request message for [NotebookService.CreateNotebookExecutionJob]" }, "GoogleCloudAiplatformV1beta1SearchDataItemsResponse": { "id": "GoogleCloudAiplatformV1beta1SearchDataItemsResponse", "description": "Response message for DatasetService.SearchDataItems.", "properties": { "nextPageToken": { "description": "A token to retrieve next page of results. Pass to SearchDataItemsRequest.page_token to obtain that page.", "type": "string" }, "dataItemViews": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DataItemView" }, "description": "The DataItemViews read." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ProbeTcpSocketAction": { "id": "GoogleCloudAiplatformV1beta1ProbeTcpSocketAction", "description": "TcpSocketAction probes the health of a container by opening a TCP socket connection.", "properties": { "port": { "format": "int32", "description": "Number of the port to access on the container. Number must be in the range 1 to 65535.", "type": "integer" }, "host": { "type": "string", "description": "Optional: Host name to connect to, defaults to the model serving container's IP." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RubricGenerationSpec": { "properties": { "modelConfig": { "description": "Configuration for the model used in rubric generation. Configs including sampling count and base model can be specified here. Flipping is not supported for rubric generation.", "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig" }, "rubricContentType": { "enum": [ "RUBRIC_CONTENT_TYPE_UNSPECIFIED", "PROPERTY", "NL_QUESTION_ANSWER", "PYTHON_CODE_ASSERTION" ], "enumDescriptions": [ "The content type to generate is not specified.", "Generate rubrics based on properties.", "Generate rubrics in an NL question answer format.", "Generate rubrics in a unit test format." ], "description": "The type of rubric content to be generated.", "type": "string" }, "promptTemplate": { "type": "string", "description": "Template for the prompt used to generate rubrics. The details should be updated based on the most-recent recipe requirements." }, "rubricTypeOntology": { "items": { "type": "string" }, "type": "array", "description": "Optional. An optional, pre-defined list of allowed types for generated rubrics. If this field is provided, it implies `include_rubric_type` should be true, and the generated rubric types should be chosen from this ontology." } }, "type": "object", "description": "Specification for how rubrics should be generated.", "id": "GoogleCloudAiplatformV1beta1RubricGenerationSpec" }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestCloudTraceSource": { "type": "object", "description": "Source for loading traces directly from Cloud Trace.", "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestCloudTraceSource", "properties": { "agentResource": { "description": "Optional. Restricts the imported spans to a single agent. Accepts either of two forms, matching `OnlineEvaluator.agent_resource`: * a project-scoped resource name, matched against the `cloud.resource_id` resource attribute that Vertex AI Agent Engine agents are stamped with; * an Agent Registry agent URN, matched against the `gen_ai.main_agent.id` resource attribute that agents on GKE, and any other runtime that stamps it, are identified by. Scopes `session_ids` selection only. Traces named explicitly in `trace_ids` are imported as given and are NOT filtered by this field, because the caller has already identified them. Setting this field with only `trace_ids` therefore has no effect. When unset, spans are selected by session or trace ID alone. That is the pre-existing behavior and it remains the correct one for a session whose agents run in several deployments, because each deployment stamps its own `gen_ai.main_agent.id` and filtering on one of them would silently truncate the trajectory.", "type": "string" }, "traceIds": { "type": "array", "description": "Optional. Trace IDs to import.", "items": { "type": "string" } }, "sessionIds": { "items": { "type": "string" }, "description": "Optional. Session IDs to import traces for. If both trace_ids and session_ids are specified, the union of the two will be imported.", "type": "array" }, "projectId": { "description": "Required. Project ID for the Cloud Trace.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest": { "description": "Request message for EndpointService.UpdateEndpointLongRunning.", "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateEndpointLongRunningRequest", "properties": { "endpoint": { "description": "Required. The Endpoint which replaces the resource on the server. Currently we only support updating the `client_connection_config` field, all the other fields' update will be blocked.", "$ref": "GoogleCloudAiplatformV1beta1Endpoint" } } }, "GoogleCloudAiplatformV1beta1UserActionReference": { "id": "GoogleCloudAiplatformV1beta1UserActionReference", "description": "References an API call. It contains more information about long running operation and Jobs that are triggered by the API call.", "properties": { "method": { "type": "string", "description": "The method name of the API RPC call. For example, \"/google.cloud.aiplatform.{apiVersion}.DatasetService.CreateDataset\"" }, "operation": { "description": "For API calls that return a long running operation. Resource name of the long running operation. Format: `projects/{project}/locations/{location}/operations/{operation}`", "type": "string" }, "dataLabelingJob": { "type": "string", "description": "For API calls that start a LabelingJob. Resource name of the LabelingJob. Format: `projects/{project}/locations/{location}/dataLabelingJobs/{data_labeling_job}`" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AnalyzedSession": { "description": "Represents an analyzed session for a monitored agent.", "properties": { "agentState": { "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The agent is successfully enabled and active.", "The agent is in the process of being enabled.", "The agent is disabled." ], "type": "string", "enum": [ "ENABLEMENT_STATE_UNSPECIFIED", "ACTIVE", "ENABLING", "DISABLED" ], "readOnly": true, "description": "Output only. The current enablement state of the MonitoredAgent that owns this session (for example, ACTIVE, DISABLED, or ENABLING). Defaults to ENABLEMENT_STATE_UNSPECIFIED when the agent is not enrolled or its state is unknown." }, "name": { "type": "string", "description": "Identifier. The resource name of the AnalyzedSession." }, "agentResourceName": { "readOnly": true, "type": "string", "description": "Output only. The resource name or identifier of the agent that ran this session. Matches `AgentResource.agent` on the corresponding `MonitoredAgent`, so the format depends on that agent's `AgentResource.agent_type`: * `REASONING_ENGINE`: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}` * `CLOUD_RUN_SERVICE`, `GKE_WORKLOAD`, `GCE_INSTANCE`: the resource name of the agent's runtime. * `AGENT_TYPE_OTHER`: a stable identifier for the agent." }, "assessment": { "description": "Output only. Overall security assessment. Populated only in FULL view.", "$ref": "GoogleCloudAiplatformV1beta1Assessment", "readOnly": true }, "userId": { "type": "string", "description": "Output only. The user ID.", "readOnly": true }, "agentDisplayName": { "type": "string", "readOnly": true, "description": "Output only. The human-readable display name of the MonitoredAgent that owns this session. May be empty when the session's agent is not enrolled as a MonitoredAgent; the `agent_resource_name` is always present and can be used as a fallback identifier." }, "createTime": { "description": "Output only. The creation time of the session.", "type": "string", "readOnly": true, "format": "google-datetime" }, "location": { "type": "string", "description": "Output only. The Google Cloud location (region) of the agent that ran this session (for example, `us-central1`). Empty when the agent is not enrolled or its location is unknown.", "readOnly": true }, "sessionId": { "description": "Output only. The session ID.", "readOnly": true, "type": "string" }, "sessionState": { "readOnly": true, "description": "Output only. The state of the session.", "enumDescriptions": [ "The session state is unspecified.", "The session has not yet been analyzed.", "The session has been analyzed and no anomalies were flagged.", "The session has been analyzed and at least one anomaly was flagged.", "The session was analyzed by the LLM judge, which did not flag any anomalies." ], "type": "string", "enum": [ "SESSION_STATE_UNSPECIFIED", "SESSION_STATE_UNANALYZED", "SESSION_STATE_NOT_FLAGGED", "SESSION_STATE_FLAGGED", "SESSION_STATE_LLM_UNFLAGGED" ] }, "agentType": { "enumDescriptions": [ "The default value, used when the runtime type is unspecified.", "The agent runs on the Gemini Enterprise Agent Platform Agent Runtime (Reasoning Engine).", "The agent runs as a Google Cloud Run service.", "The agent runs as a workload on Google Kubernetes Engine.", "The agent runs on a Compute Engine instance.", "The agent runs on another runtime, such as a self-hosted, on-premises, or non-Google Cloud environment, or any runtime not represented by the values above." ], "readOnly": true, "type": "string", "description": "Output only. The runtime that the agent which ran this session is hosted on (for example, `CLOUD_RUN_SERVICE`). `AGENT_TYPE_UNSPECIFIED` means the runtime is unknown to this service -- the agent is not enrolled as a `MonitoredAgent`, or was enrolled before its runtime was recorded. That is distinct from `AGENT_TYPE_OTHER`, which means the runtime is known and is not one of the enumerated Google Cloud runtimes.", "enum": [ "AGENT_TYPE_UNSPECIFIED", "REASONING_ENGINE", "CLOUD_RUN_SERVICE", "GKE_WORKLOAD", "GCE_INSTANCE", "AGENT_TYPE_OTHER" ] }, "latestAnalyzedTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. The latest analyzed time of the session." }, "severities": { "type": "object", "description": "Output only. Map of severity counts for listing analyzed sessions. The key is the string representation of Severity. Populated in BASIC view only.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedSessionSeveritySummary" }, "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1AnalyzedSession", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInstance", "properties": { "referenceTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for reference tool call trajectory." }, "predictedTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for predicted tool call trajectory." } }, "description": "Spec for TrajectoryAnyOrderMatch instance." }, "GoogleCloudAiplatformV1beta1PointwiseMetricInstance": { "properties": { "contentMapInstance": { "description": "Key-value contents for the mutlimodality input, including text, image, video, audio, and pdf, etc. The key is placeholder in metric prompt template, and the value is the multimodal content.", "$ref": "GoogleCloudAiplatformV1beta1ContentMap" }, "jsonInstance": { "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PointwiseMetricSpec.instance_prompt_template.", "type": "string" } }, "description": "Pointwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PointwiseMetricInstance" }, "GenaiVertexV1beta1VideoContentMediaProcessing": { "type": "object", "id": "GenaiVertexV1beta1VideoContentMediaProcessing", "properties": { "static": { "$ref": "GenaiVertexV1beta1VideoContentStaticMediaProcessing" } } }, "GoogleCloudAiplatformV1beta1ContainerSpec": { "id": "GoogleCloudAiplatformV1beta1ContainerSpec", "type": "object", "description": "The spec of a Container.", "properties": { "args": { "items": { "type": "string" }, "description": "The arguments to be passed when starting the container.", "type": "array" }, "imageUri": { "description": "Required. The URI of a container image in the Container Registry that is to be run on each worker replica.", "type": "string" }, "env": { "type": "array", "description": "Environment variables to be passed to the container. Maximum limit is 100.", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" } }, "command": { "items": { "type": "string" }, "description": "The command to be invoked when the container is started. It overrides the entrypoint instruction in Dockerfile when provided.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1CoherenceInput": { "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1CoherenceSpec", "description": "Required. Spec for coherence score metric." }, "instance": { "description": "Required. Coherence instance.", "$ref": "GoogleCloudAiplatformV1beta1CoherenceInstance" } }, "type": "object", "description": "Input for coherence metric.", "id": "GoogleCloudAiplatformV1beta1CoherenceInput" }, "GoogleCloudAiplatformV1beta1ExtensionOperation": { "id": "GoogleCloudAiplatformV1beta1ExtensionOperation", "properties": { "operationId": { "description": "Operation ID that uniquely identifies the operations among the extension. See: \"Operation Object\" in https://swagger.io/specification/. This field is parsed from the OpenAPI spec. For HTTP extensions, if it does not exist in the spec, we will generate one from the HTTP method and path.", "type": "string" }, "functionDeclaration": { "description": "Output only. Structured representation of a function declaration as defined by the OpenAPI Spec.", "$ref": "GoogleCloudAiplatformV1beta1FunctionDeclaration", "readOnly": true } }, "type": "object", "description": "Operation of an extension." }, "GoogleCloudAiplatformV1beta1TaskOutput": { "properties": { "artifacts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TaskArtifact" }, "description": "Optional. A list of artifacts (files, data) produced by the task.", "type": "array" } }, "description": "Represents the final output of a task.", "id": "GoogleCloudAiplatformV1beta1TaskOutput", "type": "object" }, "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse": { "id": "GoogleCloudAiplatformV1beta1RetrieveProfilesResponse", "properties": { "profiles": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1MemoryProfile" }, "description": "The retrieved structured profiles, which match the schemas under the requested scope. The key is the ID of the schema that the profile is linked with, which corresponds to the `schema_id` defined inside the `SchemaConfig`, under `StructuredMemoryCustomizationConfig`.", "type": "object" } }, "type": "object", "description": "Response message for MemoryBankService.RetrieveProfiles." }, "GoogleCloudAiplatformV1beta1TokensInfo": { "id": "GoogleCloudAiplatformV1beta1TokensInfo", "properties": { "role": { "type": "string", "description": "Optional. Optional fields for the role from the corresponding Content." }, "tokenIds": { "description": "A list of token ids from the input.", "items": { "format": "int64", "type": "string" }, "type": "array" }, "tokens": { "description": "A list of tokens from the input.", "type": "array", "items": { "type": "string", "format": "byte" } } }, "type": "object", "description": "Tokens info with a list of tokens and the corresponding list of token ids." }, "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentRequest": { "properties": { "inputs": { "description": "Required. The inputs to the sandbox environment.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" }, "type": "array" } }, "type": "object", "description": "Request message for SandboxEnvironmentExecutionService.BidiExecuteSandboxEnvironment.", "id": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentRequest" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationPrompt": { "description": "Prompt variation for Translation use case.", "properties": { "sourceLanguageCode": { "type": "string", "description": "The source language code." }, "option": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationOption", "description": "The translation option." }, "targetLanguageCode": { "description": "The target language code.", "type": "string" }, "promptMessage": { "description": "The prompt message.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage" }, "example": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationExample", "description": "The translation example." } }, "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationPrompt", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionCustomJobMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionCustomJobMetadata", "type": "object", "properties": { "backingCustomJob": { "description": "The resource name of the CustomJob that has been created to carry out this custom task.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1StreamingReadFeatureValuesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1StreamingReadFeatureValuesRequest", "description": "Request message for FeaturestoreOnlineServingService.StreamingReadFeatureValues.", "properties": { "featureSelector": { "description": "Required. Selector choosing Features of the target EntityType. Feature IDs will be deduplicated.", "$ref": "GoogleCloudAiplatformV1beta1FeatureSelector" }, "entityIds": { "description": "Required. IDs of entities to read Feature values of. The maximum number of IDs is 100. For example, for a machine learning model predicting user clicks on a website, an entity ID could be `user_123`.", "items": { "type": "string" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1MemoryConjunctionFilter": { "description": "A conjunction of filters that will be combined using AND logic.", "properties": { "filters": { "description": "Represents filters that will be combined using AND logic.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryFilter" }, "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryConjunctionFilter" }, "GenaiVertexV1beta1SafetySetting": { "properties": { "type": { "enumDeprecated": [ false, false, false, false, false, true, false, false, false, false, false ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Content that promotes violence or incites hatred against individuals or groups based on certain attributes.", "Content that promotes, facilitates, or enables dangerous activities.", "Abusive, threatening, or content intended to bully, torment, or ridicule.", "Content that contains sexually explicit material.", "Deprecated: Election filter is not longer supported. The harm category is civic integrity.", "Images that contain hate speech.", "Images that contain dangerous content.", "Images that contain harassment.", "Images that contain sexually explicit content.", "Prompts designed to bypass safety filters." ], "description": "Required. The type of harm category to be blocked.", "enum": [ "HARM_CATEGORY_UNSPECIFIED", "HARM_CATEGORY_HATE_SPEECH", "HARM_CATEGORY_DANGEROUS_CONTENT", "HARM_CATEGORY_HARASSMENT", "HARM_CATEGORY_SEXUALLY_EXPLICIT", "HARM_CATEGORY_CIVIC_INTEGRITY", "HARM_CATEGORY_IMAGE_HATE", "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", "HARM_CATEGORY_IMAGE_HARASSMENT", "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", "HARM_CATEGORY_JAILBREAK" ] }, "threshold": { "type": "string", "enumDescriptions": [ "The harm block threshold is unspecified.", "Block content with a low harm probability or higher.", "Block content with a medium harm probability or higher.", "Block content with a high harm probability.", "Do not block any content, regardless of its harm probability.", "Turn off the safety filter entirely." ], "description": "Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.", "enum": [ "HARM_BLOCK_THRESHOLD_UNSPECIFIED", "BLOCK_LOW_AND_ABOVE", "BLOCK_MEDIUM_AND_ABOVE", "BLOCK_ONLY_HIGH", "BLOCK_NONE", "OFF" ] }, "method": { "enumDescriptions": [ "The harm block method is unspecified.", "The harm block method uses both probability and severity scores.", "The harm block method uses the probability score." ], "enum": [ "HARM_BLOCK_METHOD_UNSPECIFIED", "SEVERITY", "PROBABILITY" ], "description": "Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.", "type": "string" } }, "description": "A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.", "id": "GenaiVertexV1beta1SafetySetting", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsResponse": { "properties": { "totalNumberAlerts": { "description": "The total number of alerts retrieved by the requested objectives.", "format": "int64", "type": "string" }, "modelMonitoringAlerts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlert" }, "type": "array", "description": "Alerts retrieved for the requested objectives. Sorted by alert time descendingly." }, "nextPageToken": { "description": "The page token that can be used by the next ModelMonitoringService.SearchModelMonitoringAlerts call.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsResponse", "description": "Response message for ModelMonitoringService.SearchModelMonitoringAlerts.", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInstance": { "properties": { "referenceTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for reference tool call trajectory." }, "predictedTrajectory": { "description": "Required. Spec for predicted tool call trajectory.", "$ref": "GoogleCloudAiplatformV1beta1Trajectory" } }, "id": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInstance", "description": "Spec for TrajectoryPrecision instance.", "type": "object" }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectEntity": { "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectEntity", "type": "object", "description": "Message to select entity. If an entity id is selected, all the feature values corresponding to the entity id will be deleted, including the entityId.", "properties": { "entityIdSelector": { "$ref": "GoogleCloudAiplatformV1beta1EntityIdSelector", "description": "Required. Selectors choosing feature values of which entity id to be deleted from the EntityType." } } }, "GoogleCloudAiplatformV1beta1ReadTensorboardTimeSeriesDataResponse": { "properties": { "timeSeriesData": { "description": "The returned time series data.", "$ref": "GoogleCloudAiplatformV1beta1TimeSeriesData" } }, "type": "object", "description": "Response message for TensorboardService.ReadTensorboardTimeSeriesData.", "id": "GoogleCloudAiplatformV1beta1ReadTensorboardTimeSeriesDataResponse" }, "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJobLatestMonitoringPipelineMetadata": { "id": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJobLatestMonitoringPipelineMetadata", "properties": { "runTime": { "type": "string", "description": "The time that most recent monitoring pipelines that is related to this run.", "format": "google-datetime" }, "status": { "description": "The status of the most recent monitoring pipeline.", "$ref": "GoogleRpcStatus" } }, "type": "object", "description": "All metadata of most recent monitoring pipelines." }, "GoogleCloudAiplatformV1beta1UserScenario": { "id": "GoogleCloudAiplatformV1beta1UserScenario", "description": "Output of user scenario generation.", "type": "object", "properties": { "startingPrompt": { "description": "Starting prompt for the conversation between simulated user and agent under the test.", "type": "string" }, "testCaseTitle": { "type": "string", "description": "Represents a short 3-5 word title for eval test case." }, "conversationPlan": { "type": "string", "description": "Conversation plan to drive multi-turn agent run and get simulated agent eval dataset." } } }, "GoogleCloudAiplatformV1beta1IndexDatapointRestriction": { "type": "object", "id": "GoogleCloudAiplatformV1beta1IndexDatapointRestriction", "description": "Restriction of a datapoint which describe its attributes(tokens) from each of several attribute categories(namespaces).", "properties": { "namespace": { "type": "string", "description": "The namespace of this restriction. e.g.: color." }, "allowList": { "description": "The attributes to allow in this namespace. e.g.: 'red'", "items": { "type": "string" }, "type": "array" }, "denyList": { "description": "The attributes to deny in this namespace. e.g.: 'blue'", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetDestination": { "id": "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetDestination", "description": "The details for a Vertex Multimodal Dataset output.", "type": "object", "properties": { "displayName": { "type": "string", "description": "Optional. Display name of the output dataset." }, "bigqueryDestination": { "description": "Optional. The destination of the underlying BigQuery table that will be created for the output Multimodal Dataset. If not specified, the BigQuery table will be created in a default BigQuery dataset.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination" } } }, "GoogleCloudAiplatformV1beta1PredictRequestResponseLoggingConfig": { "id": "GoogleCloudAiplatformV1beta1PredictRequestResponseLoggingConfig", "type": "object", "description": "Configuration for logging request-response to a BigQuery table.", "properties": { "enableOtelLogging": { "description": "This field is used for large models. If true, in addition to the original large model logs, logs will be converted in OTel schema format, and saved in otel_log column. Default value is false.", "type": "boolean" }, "enabled": { "description": "If logging is enabled or not.", "type": "boolean" }, "errorSamplingRate": { "format": "double", "description": "Optional. Percentage of failed requests to be logged, expressed as a fraction in range [0,1]. Only non-transient errors will be logged (currently `500/Internal` errors).", "type": "number" }, "samplingRate": { "description": "Percentage of requests to be logged, expressed as a fraction in range(0,1].", "type": "number", "format": "double" }, "requestResponseLoggingSchemaVersion": { "readOnly": true, "description": "Output only. The schema version used in creating the BigQuery table for the request response logging. The versions are \"v1\" and \"v2\". The current default version is \"v1\".", "type": "string" }, "bigqueryDestination": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", "description": "BigQuery table for logging. If only given a project, a new dataset will be created with name `logging__` where will be made BigQuery-dataset-name compatible (e.g. most special characters will become underscores). If no table name is given, a new table will be created with name `request_response_logging`" } } }, "GoogleCloudAiplatformV1beta1ServiceAccountSpec": { "description": "Configuration for the use of custom service account to run the workloads.", "type": "object", "properties": { "enableCustomServiceAccount": { "description": "Required. If true, custom user-managed service account is enforced to run any workloads (for example, Vertex Jobs) on the resource. Otherwise, uses the [Vertex AI Custom Code Service Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents).", "type": "boolean" }, "serviceAccount": { "description": "Optional. Required when all below conditions are met * `enable_custom_service_account` is true; * any runtime is specified via `ResourceRuntimeSpec` on creation time, for example, Ray The users must have `iam.serviceAccounts.actAs` permission on this service account and then the specified runtime containers will run as it. Do not set this field if you want to submit jobs using custom service account to this PersistentResource after creation, but only specify the `service_account` inside the job.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ServiceAccountSpec" }, "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestFullExport": { "id": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestFullExport", "properties": { "startTime": { "type": "string", "format": "google-datetime", "description": "Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store. Timestamp, if present, must not have higher than millisecond precision." }, "endTime": { "description": "Exports Feature values as of this timestamp. If not set, retrieve values as of now. Timestamp, if present, must not have higher than millisecond precision.", "format": "google-datetime", "type": "string" } }, "description": "Describes exporting all historical Feature values of all entities of the EntityType between [start_time, end_time].", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseResults": { "id": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseResults", "properties": { "trajectorySingleToolUseMetricValues": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseMetricValue" }, "description": "Output only. TrajectorySingleToolUse metric values.", "readOnly": true } }, "description": "Results for TrajectorySingleToolUse metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderDataLinkedResource": { "properties": { "displayName": { "type": "string", "description": "A user-friendly name for the data source shown in the UI." }, "name": { "description": "The unique resource name of the data source. The format is determined by the 'type' field. For type \"SAVED_PROMPT\": projects/{project}/locations/{location}/datasets/{dataset} For type \"AI_AGENT\": projects/{project}/locations/{location}/agents/{agent}", "type": "string" }, "type": { "type": "string", "description": "The type of the linked resource. e.g., \"SAVED_PROMPT\", \"AI_AGENT\" This string corresponds to the name of the LinkedResourceType enum member. See: google3/cloud/console/web/ai/platform/llm/prompts/build/services/specs_repository_service/linked_resources/linked_resource.ts" } }, "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderDataLinkedResource", "description": "A linked resource attached to the application by the user.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList": { "description": "A list of elements and information that make up a portion of prompt.", "properties": { "parts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Part" }, "description": "A list of elements that can be part of a prompt." } }, "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList", "type": "object" }, "GenaiVertexV1beta1Step": { "description": "A step in the interaction.", "properties": { "modelOutput": { "$ref": "GenaiVertexV1beta1ModelOutputStep" }, "userInput": { "description": "DO NOT USE -- These are for 3P JSON only", "$ref": "GenaiVertexV1beta1UserInputStep" }, "toolResult": { "$ref": "GenaiVertexV1beta1ToolResultStep" }, "toolCall": { "$ref": "GenaiVertexV1beta1ToolCallStep" }, "thought": { "$ref": "GenaiVertexV1beta1ThoughtStep" } }, "id": "GenaiVertexV1beta1Step", "type": "object" }, "GoogleCloudAiplatformV1beta1TaskStatusDetailsChange": { "id": "GoogleCloudAiplatformV1beta1TaskStatusDetailsChange", "description": "Represents a change to the task's status details.", "type": "object", "properties": { "newTaskStatus": { "description": "Required. The complete state of the task's status *after* the change.", "$ref": "GoogleCloudAiplatformV1beta1TaskStatusDetails" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHierarchyConfig": { "properties": { "groupTotalWeight": { "description": "The weight of the loss for predictions aggregated over time series in the same group.", "format": "double", "type": "number" }, "groupTemporalTotalWeight": { "type": "number", "format": "double", "description": "The weight of the loss for predictions aggregated over both the horizon and time series in the same hierarchy group." }, "temporalTotalWeight": { "format": "double", "type": "number", "description": "The weight of the loss for predictions aggregated over the horizon for a single time series." }, "groupColumns": { "type": "array", "items": { "type": "string" }, "description": "A list of time series attribute column names that define the time series hierarchy. Only one level of hierarchy is supported, ex. 'region' for a hierarchy of stores or 'department' for a hierarchy of products. If multiple columns are specified, time series will be grouped by their combined values, ex. ('blue', 'large') for 'color' and 'size', up to 5 columns are accepted. If no group columns are specified, all time series are considered to be part of the same group." } }, "description": "Configuration that defines the hierarchical relationship of time series and parameters for hierarchical forecasting strategies.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHierarchyConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1ListBatchPredictionJobsResponse": { "id": "GoogleCloudAiplatformV1beta1ListBatchPredictionJobsResponse", "description": "Response message for JobService.ListBatchPredictionJobs", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListBatchPredictionJobsRequest.page_token to obtain that page." }, "batchPredictionJobs": { "description": "List of BatchPredictionJobs in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJob" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1IndexPrivateEndpoints": { "type": "object", "id": "GoogleCloudAiplatformV1beta1IndexPrivateEndpoints", "properties": { "pscAutomatedEndpoints": { "description": "Output only. PscAutomatedEndpoints is populated if private service connect is enabled if PscAutomatedConfig is set.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1PscAutomatedEndpoints" } }, "matchGrpcAddress": { "type": "string", "description": "Output only. The ip address used to send match gRPC requests.", "readOnly": true }, "serviceAttachment": { "readOnly": true, "type": "string", "description": "Output only. The name of the service attachment resource. Populated if private service connect is enabled." } }, "description": "IndexPrivateEndpoints proto is used to provide paths for users to send requests via private endpoints (e.g. private service access, private service connect). To send request via private service access, use match_grpc_address. To send request via private service connect, use service_attachment." }, "GoogleCloudAiplatformV1beta1TaskEvent": { "description": "An event that occurred for a task. Note that TaskEvent is just a record of task's change. Hence, it's not a Cloud resource.", "properties": { "createTime": { "description": "Output only. The create time of the event.", "readOnly": true, "type": "string", "format": "google-datetime" }, "eventSequenceNumber": { "description": "Required. The sequence number of the event. This is used to uniquely identify the event within the task and order events chronologically. This is a id generated by the SDK.", "format": "int64", "type": "string" }, "eventData": { "$ref": "GoogleCloudAiplatformV1beta1TaskEventData", "description": "Required. The delta associated with the event." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TaskEvent" }, "GoogleCloudAiplatformV1beta1CompactionConfigEventEditingConfig": { "id": "GoogleCloudAiplatformV1beta1CompactionConfigEventEditingConfig", "type": "object", "properties": { "mode": { "type": "string", "description": "Required. The event-editing mode. Only `AUTO` is supported for MVP.", "enum": [ "MODE_UNSPECIFIED", "AUTO" ], "enumDescriptions": [ "Unspecified. Requests must set an explicit mode.", "Platform-managed editing with server-side defaults (e.g. 5KB tool-response truncation threshold)." ] } }, "description": "Configuration for event-history editing-based compaction. When set, the event history is rewritten in place using deterministic rules (e.g. truncating/masking oversized tool responses, stripping model thoughts)." }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest": { "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequest", "properties": { "disableMemoryRevisions": { "type": "boolean", "description": "Optional. If true, no revisions will be created for this request." }, "revisionLabels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. Labels to be applied to the generated memory revisions. For example, you can use this to label a revision with its data source." }, "revisionTtl": { "format": "google-duration", "description": "Optional. The TTL for the revision. The expiration time is computed: now + TTL.", "type": "string" }, "directContentsSource": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSource", "description": "Defines a direct source of content as the source content from which to generate memories." }, "revisionExpireTime": { "format": "google-datetime", "type": "string", "description": "Optional. Timestamp of when the revision is considered expired. If not set, the memory revision will be kept until manually deleted." }, "vertexSessionSource": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestVertexSessionSource", "description": "Defines a Vertex Session as the source content from which to generate memories." }, "metadata": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1MemoryMetadataValue" }, "description": "Optional. User-provided metadata for the generated memories. This is not generated by Memory Bank.", "type": "object" }, "directMemoriesSource": { "description": "Defines a direct source of memories that should be uploaded to Memory Bank. This is similar to `CreateMemory`, but it allows for consolidation between these new memories and existing memories for the same scope.", "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSource" }, "allowedTopics": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryTopicId" }, "description": "Optional. Restricts memory generation to a subset of memory topics." }, "scope": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The scope of the memories that should be generated. Memories will be consolidated across memories with the same scope. Must be provided unless the scope is defined in the source content. If `scope` is provided, it will override the scope defined in the source content. Scope values cannot contain the wildcard character '*'." }, "timeZone": { "type": "string", "description": "Optional. The time zone of the conversation or caller, used as the baseline for resolving relative time expressions (e.g., \"yesterday\") and formatting timestamps. If not set, \"UTC\" is used. Must be a valid IANA Time Zone Database name, e.g. \"America/New_York\"." }, "metadataMergeStrategy": { "description": "Optional. The strategy to use when applying metadata to existing memories.", "enumDescriptions": [ "Unspecified metadata merge strategy. If unspecified, the default behavior is to overwrite existing metadata (`OVERWRITE`).", "Replace the metadata of the updated memories with the new metadata.", "Append new metadata to the existing metadata. If there are duplicate keys, the existing values will be overwritten.", "Restrict consolidation to memories that have exactly the same metadata as the request. If a memory doesn't have the same metadata, it is not eligible for consolidation." ], "enum": [ "METADATA_MERGE_STRATEGY_UNSPECIFIED", "OVERWRITE", "MERGE", "REQUIRE_EXACT_MATCH" ], "type": "string" }, "disableConsolidation": { "description": "Optional. If true, generated memories will not be consolidated with existing memories; all generated memories will be added as new memories regardless of whether they are duplicates of or contradictory to existing memories. By default, memory consolidation is enabled.", "type": "boolean" } }, "description": "Request message for MemoryBankService.GenerateMemories. Maximum size is 8 MB.", "type": "object" }, "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateMlEngineModelVersionConfig": { "properties": { "modelVersion": { "description": "Required. Full resource name of ml engine model version. Format: `projects/{project}/models/{model}/versions/{version}`.", "type": "string" }, "modelDisplayName": { "type": "string", "description": "Required. Display name of the model in Vertex AI. System will pick a display name if unspecified." }, "endpoint": { "type": "string", "description": "Required. The ml.googleapis.com endpoint that this model version should be migrated from. Example values: * ml.googleapis.com * us-centrall-ml.googleapis.com * europe-west4-ml.googleapis.com * asia-east1-ml.googleapis.com" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateMlEngineModelVersionConfig", "description": "Config for migrating version in ml.googleapis.com to Vertex AI's Model." }, "GoogleCloudAiplatformV1beta1RubricGroup": { "type": "object", "id": "GoogleCloudAiplatformV1beta1RubricGroup", "description": "A group of rubrics, used for grouping rubrics based on a metric or a version.", "properties": { "displayName": { "type": "string", "description": "Human-readable name for the group. This should be unique within a given context if used for display or selection. Example: \"Instruction Following V1\", \"Content Quality - Summarization Task\"." }, "rubrics": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Rubric" }, "description": "Rubrics that are part of this group." }, "groupId": { "type": "string", "description": "Unique identifier for the group." } } }, "GenaiVertexV1beta1ImageConfig": { "description": "The configuration for image interaction.", "properties": { "imageSize": { "type": "string", "description": "Specifies the size of generated images. Supported values are `1K`, `2K`, `4K`. If not specified, the model will use default value `1K`." }, "aspectRatio": { "description": "The aspect ratio of the image to generate. Supported aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9. If not specified, the model will choose a default aspect ratio based on any reference images provided.", "type": "string" } }, "deprecated": true, "type": "object", "id": "GenaiVertexV1beta1ImageConfig" }, "GoogleCloudAiplatformV1beta1ListEvaluationRunsResponse": { "description": "Response message for EvaluationManagementService.ListEvaluationRuns.", "type": "object", "properties": { "evaluationRuns": { "description": "List of EvaluationRuns in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRun" } }, "nextPageToken": { "description": "A token to retrieve the next page of results.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ListEvaluationRunsResponse" }, "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimpleRetrievalParams": { "properties": { "pageToken": { "type": "string", "description": "Optional. A page token, received from a previous `RetrieveMemories` call. Provide this to retrieve the subsequent page." }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of memories to return. The service may return fewer than this value. If unspecified, at most 3 memories will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimpleRetrievalParams", "description": "Parameters for simple (non-similarity search) retrieval.", "type": "object" }, "GoogleCloudAiplatformV1beta1RawOutput": { "type": "object", "properties": { "rawOutput": { "type": "array", "readOnly": true, "description": "Output only. Raw output string.", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1RawOutput", "description": "Raw output." }, "GoogleCloudAiplatformV1beta1ModelSourceInfo": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelSourceInfo", "description": "Detail description of the source information of the model.", "properties": { "copy": { "description": "If this Model is copy of another Model. If true then source_type pertains to the original.", "type": "boolean" }, "sourceType": { "enumDescriptions": [ "Should not be used.", "The Model is uploaded by automl training pipeline.", "The Model is uploaded by user or custom training pipeline.", "The Model is registered and sync'ed from BigQuery ML.", "The Model is saved or tuned from Model Garden.", "The Model is saved or tuned from Genie.", "The Model is uploaded by text embedding finetuning pipeline.", "The Model is saved or tuned from Marketplace." ], "enum": [ "MODEL_SOURCE_TYPE_UNSPECIFIED", "AUTOML", "CUSTOM", "BQML", "MODEL_GARDEN", "GENIE", "CUSTOM_TEXT_EMBEDDING", "MARKETPLACE" ], "type": "string", "description": "Type of the model source." } } }, "GenaiVertexV1beta1CodeMenderAgentConfigFileContent": { "properties": { "content": { "description": "The UTF-8 encoded text content of the file.", "type": "string" }, "path": { "description": "The relative path of the file from the project root.", "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1CodeMenderAgentConfigFileContent", "description": "Content of a single file in the codebase." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsRegressionEvaluationMetrics": { "type": "object", "properties": { "meanAbsoluteError": { "type": "number", "description": "Mean Absolute Error (MAE).", "format": "float" }, "rootMeanSquaredLogError": { "type": "number", "description": "Root mean squared log error. Undefined when there are negative ground truth values or predictions.", "format": "float" }, "rootMeanSquaredError": { "type": "number", "format": "float", "description": "Root Mean Squared Error (RMSE)." }, "meanAbsolutePercentageError": { "format": "float", "description": "Mean absolute percentage error. Infinity when there are zeros in the ground truth.", "type": "number" }, "rSquared": { "format": "float", "type": "number", "description": "Coefficient of determination as Pearson correlation coefficient. Undefined when ground truth or predictions are constant or near constant." } }, "description": "Metrics for regression evaluation results.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsRegressionEvaluationMetrics" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecPackageSpec", "properties": { "pickleObjectGcsUri": { "description": "Optional. The Cloud Storage URI of the pickled python object.", "type": "string" }, "dependencyFilesGcsUri": { "description": "Optional. The Cloud Storage URI of the dependency files in tar.gz format.", "type": "string" }, "requirementsGcsUri": { "description": "Optional. The Cloud Storage URI of the `requirements.txt` file", "type": "string" }, "pythonVersion": { "description": "Optional. The Python version. Supported values are 3.10, 3.11, 3.12, 3.13, 3.14. If not specified, the default value is 3.10.", "type": "string" } }, "description": "User-provided package specification, containing pickled object and package requirements.", "type": "object" }, "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetRequest": { "description": "Request message for ModelService.UpdateExplanationDataset.", "id": "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetRequest", "properties": { "examples": { "description": "The example config containing the location of the dataset.", "$ref": "GoogleCloudAiplatformV1beta1Examples" } }, "type": "object" }, "GenaiVertexV1beta1GoogleMapsResultDelta": { "properties": { "result": { "type": "array", "description": "The results of the Google Maps.", "items": { "$ref": "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResult" } } }, "type": "object", "id": "GenaiVertexV1beta1GoogleMapsResultDelta" }, "GoogleCloudAiplatformV1beta1MetricxInput": { "properties": { "metricSpec": { "description": "Required. Spec for Metricx metric.", "$ref": "GoogleCloudAiplatformV1beta1MetricxSpec" }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1MetricxInstance", "description": "Required. Metricx instance." } }, "id": "GoogleCloudAiplatformV1beta1MetricxInput", "description": "Input for MetricX metric.", "type": "object" }, "CloudAiLargeModelsVisionGenerateVideoExperiments": { "description": "Experimental parameters for video generation.", "properties": { "modelName": { "description": "Model names, as defined in: xyz ", "type": "string" }, "proEdit": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsProEditConfig", "description": "Configuration for Pro Edit." }, "promptInputs": { "description": "Prompt chunks for \"ProModel\" prompting. If set, the prompt will not be rewritten, and top-level prompt ignored.", "$ref": "CloudAiLargeModelsVisionPromptInputs" }, "videoTransformMaskGcsUri": { "deprecated": true, "type": "string", "description": "GCS URI of the grayscale video mask for Differential Diffusion. Maps to sdedit_video_tmax_scale_map " }, "outpaintConfig": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfig", "description": "Config for Outpainting task." }, "videoTransform": { "description": "Video transform configuration for omni editing models.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsVideoTransform" }, "numDiffusionSteps": { "type": "integer", "format": "int32", "description": "Number of diffusion steps" }, "requestOriginTag": { "description": "Optional tag for tracking the source of this request. Allowed values: \"colab\", \"comfyui\", \"curl\", \"flowresearch\", \"vertexstudio\". Unrecognized tags are recorded as \"unknown\" in metrics. Tags do not affect video generation behavior. Up to 16 characters, ASCII alphanumeric, hyphens, and underscores only.", "type": "string" }, "anchorLastFrame": { "type": "boolean", "description": "Optional. If true, anchors the last frame in video generation by generating a custom border mask." }, "customParameters": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Generic key-value pairs for experimental parameters. This allows adding new parameters without changing the dataplane binary.", "type": "object" }, "seamless": { "description": "Parameters for seamless (edge-continuous) video generation, enabling temporal looping and/or spatial tessellation.", "$ref": "CloudAiLargeModelsVisionSeamless" }, "humanPose": { "description": "Human pose parameters for Pose Control", "$ref": "CloudAiLargeModelsVisionHumanPose" }, "loraConfig": { "description": "Optional. LoRA configuration for Omni editing/stylization models.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfig" }, "exrColorSpaceOverride": { "description": "Optional. Colorspace to be used for all EXR inputs.", "type": "string" }, "audioControl": { "description": "Optional. Audio control configuration.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsAudioControlConfig" }, "allowMeteredBilling": { "type": "boolean", "description": "If false, when a non-subscription customer tries to call an experimental feature, the request will be rejected. This field has no effect for subscription customers." }, "conditioningFrames": { "items": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsConditioningFrame" }, "type": "array", "description": "Conditioning frames for veo experimental models ONLY, not to be confused with keyframes (ID:31) in GenerateVideoRequest." }, "spatialAlignment": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsSpatialAlignmentConfig", "description": "Optional. Spatial alignment configuration." }, "modelEndpointOverride": { "description": "Optional. BNS override for model backend. Enabled only for local and autopush environments by the flag `lvm_allow_model_zoo_bns_override`.", "type": "string" }, "colorAlignment": { "description": "Optional. Color alignment configuration.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsColorAlignmentConfig" }, "schedulingConfig": { "description": "Optional. Scheduling configuration.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsVESchedulingConfig" }, "originalRequestJson": { "description": "The original REST API request JSON sent by the user, in the instances/parameters format. Preserved for saving alongside output artifacts so users can reproduce their requests. This field is populated by the API handler and is not user-settable.", "type": "string" }, "cfgScale": { "format": "float", "description": "CFG scale for video-transform, perf-generation, a2v, video-textures models.", "type": "number" }, "superResConfig": { "description": "Config for the Pro Super Res upsampling task.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsSuperResConfig" }, "videoTransformStrength": { "type": "number", "format": "float", "description": "SDEdit: Scalar noise level (0.0 to 1.0) Maps to sdedit_tmax ", "deprecated": true }, "truncateInputVideo": { "type": "boolean", "description": "If true (default), truncate input videos that exceed the model's maximum frame count by applying a frame_selection_config to __video_file__ inputs. Set to false to preserve the existing fail-fast behavior." }, "codec": { "type": "string", "enum": [ "VIDEO_CODEC_UNSPECIFIED", "VIDEO_CODEC_H264", "VIDEO_CODEC_PRORES", "VIDEO_CODEC_DNXHR" ], "enumDescriptions": [ "", "", "", "" ], "description": "Optional. Video codec to use for output." }, "omniRewriter": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsOmniRewriterConfig", "description": "Optional. Omni Rewriter configuration." } }, "id": "CloudAiLargeModelsVisionGenerateVideoExperiments", "type": "object" }, "GoogleCloudAiplatformV1beta1PurgeExecutionsRequest": { "id": "GoogleCloudAiplatformV1beta1PurgeExecutionsRequest", "description": "Request message for MetadataService.PurgeExecutions.", "type": "object", "properties": { "filter": { "type": "string", "description": "Required. A required filter matching the Executions to be purged. E.g., `update_time \u003c= 2020-11-19T11:30:00-04:00`." }, "force": { "type": "boolean", "description": "Optional. Flag to indicate to actually perform the purge. If `force` is set to false, the method will return a sample of Execution names that would be deleted." } } }, "GoogleCloudAiplatformV1beta1EvaluateDatasetRequest": { "id": "GoogleCloudAiplatformV1beta1EvaluateDatasetRequest", "properties": { "metrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Metric" }, "description": "Required. The metrics used for evaluation.", "type": "array" }, "location": { "description": "Required. The resource name of the Location to evaluate the dataset. Format: `projects/{project}/locations/{location}`", "type": "string" }, "dataset": { "description": "Required. The dataset used for evaluation.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationDataset" }, "outputConfig": { "description": "Required. Config for evaluation output.", "$ref": "GoogleCloudAiplatformV1beta1OutputConfig" }, "autoraterConfig": { "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig", "description": "Optional. Autorater config used for evaluation. Currently only publisher Gemini models are supported. Format: `projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL}.`" } }, "description": "Request message for EvaluationService.EvaluateDataset.", "type": "object" }, "GenaiVertexV1beta1RetrievalCallDelta": { "id": "GenaiVertexV1beta1RetrievalCallDelta", "properties": { "arguments": { "$ref": "GenaiVertexV1beta1RetrievalCallStepRetrievalStepArguments", "description": "Required. The arguments to pass to the Retrieval tool." }, "retrievalType": { "enum": [ "RETRIEVAL_TYPE_UNSPECIFIED", "RETRIEVAL_TYPE_VERTEX_AI_SEARCH", "RETRIEVAL_TYPE_RAG_STORE", "RETRIEVAL_TYPE_EXA_AI_SEARCH", "RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" ], "enumDescriptions": [ "", "", "", "", "" ], "description": "The type of retrieval tools.", "type": "string" } }, "description": "Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.", "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModel": { "type": "object", "properties": { "frameworks": { "type": "array", "items": { "type": "string" }, "description": "Optional. Additional information about the model's Frameworks." }, "launchStage": { "enum": [ "LAUNCH_STAGE_UNSPECIFIED", "EXPERIMENTAL", "PRIVATE_PREVIEW", "PUBLIC_PREVIEW", "GA" ], "type": "string", "enumDescriptions": [ "The model launch stage is unspecified.", "Used to indicate the PublisherModel is at Experimental launch stage, available to a small set of customers.", "Used to indicate the PublisherModel is at Private Preview launch stage, only available to a small set of customers, although a larger set of customers than an Experimental launch. Previews are the first launch stage used to get feedback from customers.", "Used to indicate the PublisherModel is at Public Preview launch stage, available to all customers, although not supported for production workloads.", "Used to indicate the PublisherModel is at GA launch stage, available to all customers and ready for production workload." ], "description": "Optional. Indicates the launch stage of the model." }, "versionState": { "enumDescriptions": [ "The version state is unspecified.", "Used to indicate the version is stable.", "Used to indicate the version is unstable." ], "type": "string", "description": "Optional. Indicates the state of the model version.", "enum": [ "VERSION_STATE_UNSPECIFIED", "VERSION_STATE_STABLE", "VERSION_STATE_UNSTABLE" ] }, "predictSchemata": { "description": "Optional. The schemata that describes formats of the PublisherModel's predictions and explanations as given and returned via PredictionService.Predict.", "$ref": "GoogleCloudAiplatformV1beta1PredictSchemata" }, "name": { "readOnly": true, "description": "Output only. Identifier. The resource name of the PublisherModel.", "type": "string" }, "parent": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelParent", "description": "Optional. The parent that this model was customized from. E.g., Vision API, Natural Language API, LaMDA, T5, etc. Foundation models don't have parents." }, "publisherModelTemplate": { "description": "Optional. Output only. Immutable. Used to indicate this model has a publisher model and provide the template of the publisher model resource name.", "type": "string", "readOnly": true }, "supportedActions": { "description": "Optional. Supported call-to-action options.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToAction" }, "versionId": { "type": "string", "readOnly": true, "description": "Output only. Immutable. The version ID of the PublisherModel. A new version is committed when a new model version is uploaded under an existing model id. It is an auto-incrementing decimal number in string representation." }, "openSourceCategory": { "description": "Required. Indicates the open source category of the publisher model.", "enum": [ "OPEN_SOURCE_CATEGORY_UNSPECIFIED", "PROPRIETARY", "GOOGLE_OWNED_OSS_WITH_GOOGLE_CHECKPOINT", "THIRD_PARTY_OWNED_OSS_WITH_GOOGLE_CHECKPOINT", "GOOGLE_OWNED_OSS", "THIRD_PARTY_OWNED_OSS" ], "type": "string", "enumDescriptions": [ "The open source category is unspecified, which should not be used.", "Used to indicate the PublisherModel is not open sourced.", "Used to indicate the PublisherModel is a Google-owned open source model w/ Google checkpoint.", "Used to indicate the PublisherModel is a 3p-owned open source model w/ Google checkpoint.", "Used to indicate the PublisherModel is a Google-owned pure open source model.", "Used to indicate the PublisherModel is a 3p-owned pure open source model." ] } }, "id": "GoogleCloudAiplatformV1beta1PublisherModel", "description": "A Model Garden Publisher Model." }, "CloudAiLargeModelsVisionRaiInfoDetectedLabels": { "type": "object", "description": "Filters returning list of deteceted labels, scores, and bounding boxes.", "properties": { "raiCategory": { "description": "The RAI category for the deteceted labels.", "type": "string" }, "entities": { "description": "The list of detected entities for the rai signal.", "items": { "$ref": "CloudAiLargeModelsVisionRaiInfoDetectedLabelsEntity" }, "type": "array" } }, "id": "CloudAiLargeModelsVisionRaiInfoDetectedLabels" }, "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInput": { "id": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInput", "properties": { "metricSpec": { "description": "Required. Spec for TrajectoryInOrderMatch metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchSpec" }, "instances": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInstance" }, "type": "array", "description": "Required. Repeated TrajectoryInOrderMatch instance." } }, "description": "Instances and metric spec for TrajectoryInOrderMatch metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryStructuredContent": { "description": "Represents the structured value of the memory.", "properties": { "schemaId": { "description": "Required. Represents the schema ID for which this structured memory belongs to.", "type": "string" }, "data": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Required. Represents the structured value of the memory.", "type": "object" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryStructuredContent" }, "GenaiVertexV1beta1McpServerToolResultDelta": { "properties": { "serverName": { "type": "string" }, "name": { "type": "string" }, "result": { "$ref": "GenaiVertexV1beta1Value" } }, "id": "GenaiVertexV1beta1McpServerToolResultDelta", "type": "object" }, "GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters": { "id": "GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters", "properties": { "citationThreshold": { "type": "number", "description": "Optional. Only return claims with citation score larger than the threshold.", "format": "double" } }, "description": "Parameters that can be overrided per request.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListFeatureViewsResponse": { "type": "object", "properties": { "featureViews": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureView" }, "type": "array", "description": "The FeatureViews matching the request." }, "nextPageToken": { "description": "A token, which can be sent as ListFeatureViewsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for FeatureOnlineStoreAdminService.ListFeatureViews.", "id": "GoogleCloudAiplatformV1beta1ListFeatureViewsResponse" }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValues": { "properties": { "dataKey": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey", "description": "The data key." }, "features": { "description": "List of features to write.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeature" } } }, "description": "A data key and associated feature values to write to the feature view.", "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValues" }, "GoogleCloudAiplatformV1beta1SchemaTextSentimentAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaTextSentimentAnnotation", "type": "object", "properties": { "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "sentimentMax": { "type": "integer", "description": "The sentiment max score for text.", "format": "int32" }, "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." }, "sentiment": { "type": "integer", "description": "The sentiment score for text.", "format": "int32" } }, "description": "Annotation details specific to text sentiment." }, "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingResult": { "description": "Result for RubricBasedInstructionFollowing metric.", "id": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingResult", "properties": { "score": { "readOnly": true, "description": "Output only. Overall score for the instruction following.", "format": "float", "type": "number" }, "rubricCritiqueResults": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1RubricCritiqueResult" }, "description": "Output only. List of per rubric critique results.", "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig": { "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig", "properties": { "hybridSearchConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig", "description": "Configuration for hybrid search." }, "vertexPredictionEndpoint": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint", "description": "The Vertex AI Prediction Endpoint that either refers to a publisher model or an endpoint that is hosting a 1P fine-tuned text embedding model. Endpoints hosting non-1P fine-tuned text embedding models are currently not supported. This is used for dense vector search." } }, "description": "Config for the embedding model to use for RAG.", "type": "object" }, "GoogleCloudAiplatformV1beta1Candidate": { "properties": { "avgLogprobs": { "format": "double", "readOnly": true, "type": "number", "description": "Output only. The average log probability of the tokens in this candidate. This is a length-normalized score that can be used to compare the quality of candidates of different lengths. A higher average log probability suggests a more confident and coherent response." }, "urlContextMetadata": { "$ref": "GoogleCloudAiplatformV1beta1UrlContextMetadata", "readOnly": true, "description": "Output only. Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL." }, "safetyRatings": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SafetyRating" }, "description": "Output only. A list of ratings for the safety of a response candidate. There is at most one rating per category.", "type": "array", "readOnly": true }, "groundingMetadata": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1GroundingMetadata", "description": "Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content." }, "finishMessage": { "description": "Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set.", "type": "string", "readOnly": true }, "content": { "description": "Output only. The content of the candidate.", "$ref": "GoogleCloudAiplatformV1beta1Content", "readOnly": true }, "index": { "readOnly": true, "format": "int32", "description": "Output only. The 0-based index of this candidate in the list of generated responses. This is useful for distinguishing between multiple candidates when `candidate_count` \u003e 1.", "type": "integer" }, "finishReason": { "type": "string", "enumDescriptions": [ "The finish reason is unspecified.", "The model reached a natural stopping point or a configured stop sequence.", "The model generated the maximum number of tokens allowed by the `max_output_tokens` parameter.", "The model stopped generating because the content potentially violates safety policies. NOTE: When streaming, the `content` field is empty if content filters block the output.", "The model stopped generating because the content may be a recitation from a source.", "The model stopped generating for a reason not otherwise specified.", "The model stopped generating because the content contains a term from a configured blocklist.", "The model stopped generating because the content may be prohibited.", "The model stopped generating because the content may contain sensitive personally identifiable information (SPII).", "The model generated a function call that is syntactically invalid and can't be parsed.", "The model response was blocked by Model Armor.", "The generated image potentially violates safety policies.", "The generated image may contain prohibited content.", "The generated image may be a recitation from a source.", "The image generation stopped for a reason not otherwise specified.", "The model generated a function call that is semantically invalid. This can happen, for example, if function calling is not enabled or the generated function is not in the function declaration.", "The model was expected to generate an image, but didn't.", "Finishes due to malformed response.", "Token generation was stopped because the response reached the per-request token limit, but generation is not yet complete. The model response can be continued via a subsequent request using the returned `continuation_token`." ], "description": "Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating.", "enum": [ "FINISH_REASON_UNSPECIFIED", "STOP", "MAX_TOKENS", "SAFETY", "RECITATION", "OTHER", "BLOCKLIST", "PROHIBITED_CONTENT", "SPII", "MALFORMED_FUNCTION_CALL", "MODEL_ARMOR", "IMAGE_SAFETY", "IMAGE_PROHIBITED_CONTENT", "IMAGE_RECITATION", "IMAGE_OTHER", "UNEXPECTED_TOOL_CALL", "NO_IMAGE", "MALFORMED_RESPONSE", "CONTINUATION" ], "readOnly": true }, "logprobsResult": { "description": "Output only. The detailed log probability information for the tokens in this candidate. This is useful for debugging, understanding model uncertainty, and identifying potential \"hallucinations\".", "$ref": "GoogleCloudAiplatformV1beta1LogprobsResult", "readOnly": true }, "citationMetadata": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1CitationMetadata", "description": "Output only. A collection of citations that apply to the generated content." }, "continuationToken": { "format": "byte", "readOnly": true, "description": "Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation.", "type": "string" } }, "type": "object", "description": "A response candidate generated from the model.", "id": "GoogleCloudAiplatformV1beta1Candidate" }, "GoogleCloudAiplatformV1beta1AddContextChildrenResponse": { "properties": {}, "description": "Response message for MetadataService.AddContextChildren.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AddContextChildrenResponse" }, "GoogleCloudAiplatformV1beta1RougeInstance": { "description": "Spec for rouge instance.", "id": "GoogleCloudAiplatformV1beta1RougeInstance", "properties": { "reference": { "description": "Required. Ground truth used to compare against the prediction.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ExplanationSpec", "properties": { "parameters": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationParameters", "description": "Required. Parameters that configure explaining of the Model's predictions." }, "metadata": { "description": "Optional. Metadata describing the Model's input and output for explanation.", "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadata" } }, "description": "Specification of Model explanation." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextSentimentEvaluationMetrics": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextSentimentEvaluationMetrics", "properties": { "recall": { "format": "float", "description": "Recall.", "type": "number" }, "meanAbsoluteError": { "format": "float", "type": "number", "description": "Mean absolute error. Only set for ModelEvaluations, not for ModelEvaluationSlices." }, "f1Score": { "description": "The harmonic mean of recall and precision.", "type": "number", "format": "float" }, "confusionMatrix": { "description": "Confusion matrix of the evaluation. Only set for ModelEvaluations, not for ModelEvaluationSlices.", "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix" }, "linearKappa": { "description": "Linear weighted kappa. Only set for ModelEvaluations, not for ModelEvaluationSlices.", "format": "float", "type": "number" }, "precision": { "description": "Precision.", "type": "number", "format": "float" }, "meanSquaredError": { "description": "Mean squared error. Only set for ModelEvaluations, not for ModelEvaluationSlices.", "format": "float", "type": "number" }, "quadraticKappa": { "format": "float", "description": "Quadratic weighted kappa. Only set for ModelEvaluations, not for ModelEvaluationSlices.", "type": "number" } }, "type": "object", "description": "Model evaluation metrics for text sentiment problems." }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderData": { "description": "Defines data for an application builder.", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderData", "properties": { "linkedResources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderDataLinkedResource" }, "type": "array", "description": "Linked resources attached to the application by the user." }, "framework": { "enum": [ "FRAMEWORK_UNSPECIFIED", "REACT", "ANGULAR" ], "description": "Optional. Framework used to build the application.", "enumDescriptions": [ "Unspecified framework.", "React framework.", "Angular framework." ], "type": "string" }, "codeRepositoryState": { "description": "Serialized state of the code repository. This string will typically contain a JSON representation of the UI's CodeRepositoryService state (files, folders, content, and any metadata). The UI is responsible for serialization and deserialization.", "type": "string" }, "deployedRegions": { "items": { "type": "string" }, "description": "Optional. The Cloud Run regions in which the application is currently deployed. Used to rediscover and redeploy the app in the regions it already runs in, which may differ from the prompt's location.", "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingChunkMaps": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GroundingChunkMaps", "properties": { "title": { "description": "The title of the place.", "type": "string" }, "route": { "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsRoute", "description": "Output only. Route information.", "readOnly": true }, "uri": { "type": "string", "description": "The URI of the place." }, "text": { "type": "string", "description": "The text of the place answer." }, "placeId": { "type": "string", "description": "This Place's resource name, in `places/{place_id}` format. This can be used to look up the place in the Google Maps API." }, "placeAnswerSources": { "description": "The sources that were used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as URIs to flag content.", "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources" } }, "description": "A `Maps` chunk is a piece of evidence that comes from Google Maps, containing information about places or routes. This is used to provide the user with rich, location-based information." }, "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerStringMatchExpression": { "description": "Evaluates parsed response using match type against the expression. Returns `true` if `MatchOperation(target, expression)` evaluates to `true`, and `false` otherwise.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerStringMatchExpression", "properties": { "expression": { "description": "A string or a regular expression to match against for evaluating rewards. Users can also provide a references map of `{key: value}` whose `value` will be used to replace the placeholder {{references.key}} in the expression. For example, if the following `references` are defined in the training / validation dataset: ``` { \"systemInstruction\": ..., \"contents\": ..., \"references\": { \"concise_answer\": \"Yes\", \"verbose_answer\": \"The answer is Yes\" } } ``` and if users define the following StringMatchExpression: { \"matchOperation\": \"REGEX_CONTAINS\", \"expression\": \".*{{references.concise_answer}}.*\" } On evaluating the reward for each sample response, this StringMatchExpression will be substituted as: ``` { \"matchOperation\": \"REGEX_CONTAINS\", \"expression\": \".*Yes.*\" } ```", "type": "string" }, "matchOperation": { "enumDescriptions": [ "Default value. A user error will be returned if not set.", "Equivalent to [GoogleSQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#regexp_contains) `REGEX_CONTAINS(target, expression)`.", "The match operation returns `true` if expression is a substring of the target.", "The match operation returns `true` expression is an exact match of the target." ], "enum": [ "MATCH_OPERATION_UNSPECIFIED", "REGEX_CONTAINS", "PARTIAL_MATCH", "EXACT_MATCH" ], "description": "Match operation to use for evaluating rewards.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsRequest", "description": "Request message for ModelService.BatchImportEvaluatedAnnotations", "properties": { "evaluatedAnnotations": { "description": "Required. Evaluated annotations resource to be imported.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluatedAnnotation" } } } }, "GenaiVertexV1beta1RetrievalCallStep": { "type": "object", "properties": { "arguments": { "$ref": "GenaiVertexV1beta1RetrievalCallStepRetrievalStepArguments", "description": "Required. The arguments to pass to the retrieval tool." }, "retrievalType": { "type": "string", "description": "The type of retrieval tools.", "enumDescriptions": [ "", "", "", "", "" ], "enum": [ "RETRIEVAL_TYPE_UNSPECIFIED", "RETRIEVAL_TYPE_VERTEX_AI_SEARCH", "RETRIEVAL_TYPE_RAG_STORE", "RETRIEVAL_TYPE_EXA_AI_SEARCH", "RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" ] } }, "id": "GenaiVertexV1beta1RetrievalCallStep", "description": "Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used." }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec": { "properties": { "secretEnv": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SecretEnvVar" }, "type": "array", "description": "Optional. Environment variables where the value is a secret in Cloud Secret Manager. To use this feature, add 'Secret Manager Secret Accessor' role (roles/secretmanager.secretAccessor) to AI Platform Reasoning Engine Service Agent." }, "maxInstances": { "format": "int32", "type": "integer", "description": "Optional. The maximum number of application instances that can be launched to handle increased traffic. Defaults to 100. Range: [1, 1000]. If VPC-SC or PSC-I is enabled, the acceptable range is [1, 100]." }, "minInstances": { "type": "integer", "format": "int32", "description": "Optional. The minimum number of application instances that will be kept running at all times. Defaults to 1. Range: [0, 75]." }, "pscInterfaceConfig": { "description": "Optional. Configuration for PSC-I.", "$ref": "GoogleCloudAiplatformV1beta1PscInterfaceConfig" }, "keepAliveProbe": { "description": "Optional. Specifies the configuration for keep-alive probe. Contains configuration on a specified endpoint that a deployment host should use to keep the container alive based on the probe settings.", "$ref": "GoogleCloudAiplatformV1beta1KeepAliveProbe" }, "agentGatewayConfig": { "description": "Optional. Agent Gateway configuration for the Reasoning Engine deployment.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfig" }, "env": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" }, "description": "Optional. Environment variables to be set with the Reasoning Engine deployment. The environment variables can be updated through the UpdateReasoningEngine API." }, "resourceLimits": { "description": "Optional. Resource limits for each container. Only 'cpu' and 'memory' keys are supported. Defaults to {\"cpu\": \"4\", \"memory\": \"4Gi\"}. * The only supported values for CPU are '1', '2', '4', '6' and '8'. For more information, go to https://cloud.google.com/run/docs/configuring/cpu. * The only supported values for memory are '1Gi', '2Gi', ... '32 Gi'. * For required cpu on different memory values, go to https://cloud.google.com/run/docs/configuring/memory-limits", "type": "object", "additionalProperties": { "type": "string" } }, "agentServerMode": { "type": "string", "enumDescriptions": [ "Unspecified agent server mode. Do not use.", "Stable agent server mode. This mode has everything stable and well-tested features agent engine offers.", "Experimental agent server mode. This mode contains experimental features." ], "description": "The agent server mode.", "enum": [ "AGENT_SERVER_MODE_UNSPECIFIED", "STABLE", "EXPERIMENTAL" ] }, "containerConcurrency": { "format": "int32", "type": "integer", "description": "Optional. Concurrency for each container and agent server. Recommended value: 2 * cpu + 1. Defaults to 9." } }, "description": "The specification of a Reasoning Engine deployment.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec" }, "GoogleCloudAiplatformV1beta1EvaluationInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationInstance", "properties": { "interactionsDataSource": { "description": "Optional. Source for populating `AgentData` from an Interactions API interaction. If set, no other agent data source fields (`cloud_trace_agent_data_source`, `agent_eval_data`, `agent_data`) may be set. The request will be rejected with INVALID_ARGUMENT if multiple agent data sources are provided.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInteractionsDataSource" }, "response": { "description": "Optional. Data used to populate placeholder `response` in a metric prompt template.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData" }, "otherData": { "description": "Optional. Other data used to populate placeholders based on their key. If a key conflicts with a field in the EvaluationInstance (e.g. `prompt`), the value of the field will take precedence over the value in other_data.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceMapInstance" }, "rubricGroups": { "description": "Optional. Named groups of rubrics associated with the prompt. This is used for rubric-based evaluations where rubrics can be referenced by a key. The key could represent versions, associated metrics, etc.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1RubricGroup" } }, "prompt": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData", "description": "Optional. Data used to populate placeholder `prompt` in a metric prompt template." }, "agentEvalData": { "description": "Optional. Data used for agent evaluation.", "$ref": "GoogleCloudAiplatformV1beta1AgentData" }, "reference": { "description": "Optional. Data used to populate placeholder `reference` in a metric prompt template.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData" }, "agentData": { "description": "Optional. Deprecated: Use `agent_eval_data` instead. Data used for agent evaluation.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentData", "deprecated": true } }, "description": "A single instance to be evaluated. Instances are used to specify the input data for evaluation, from simple string comparisons to complex, multi-turn model evaluations" }, "GoogleCloudAiplatformV1beta1GenerateContentResponse": { "description": "Response message for [PredictionService.GenerateContent].", "properties": { "candidates": { "description": "Output only. Generated candidates.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Candidate" }, "readOnly": true, "type": "array" }, "modelVersion": { "readOnly": true, "type": "string", "description": "Output only. The model version used to generate the response." }, "promptFeedback": { "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback", "description": "Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations.", "readOnly": true }, "usageMetadata": { "description": "Usage metadata about the response(s).", "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata" }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when the request is made to the server.", "type": "string" }, "responseId": { "type": "string", "readOnly": true, "description": "Output only. response_id is used to identify each response. It is the encoding of the event_id." } }, "id": "GoogleCloudAiplatformV1beta1GenerateContentResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTextClassificationAnnotation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTextClassificationAnnotation", "properties": { "annotationSpecId": { "description": "The resource Id of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" } }, "description": "Annotation details specific to text classification." }, "GoogleCloudAiplatformV1beta1ListDataLabelingJobsResponse": { "type": "object", "description": "Response message for JobService.ListDataLabelingJobs.", "id": "GoogleCloudAiplatformV1beta1ListDataLabelingJobsResponse", "properties": { "dataLabelingJobs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DataLabelingJob" }, "description": "A list of DataLabelingJobs that matches the specified filter in the request." }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1RebootPersistentResourceOperationMetadata": { "type": "object", "properties": { "genericMetadata": { "description": "Operation metadata for PersistentResource.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progressMessage": { "description": "Progress Message for Reboot LRO", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RebootPersistentResourceOperationMetadata", "description": "Details of operations that perform reboot PersistentResource." }, "GoogleCloudAiplatformV1beta1SchemaTextSegment": { "description": "The text segment inside of DataItem.", "type": "object", "properties": { "endOffset": { "format": "uint64", "type": "string", "description": "Zero-based character index of the first character past the end of the text segment (counting character from the beginning of the text). The character at the end_offset is NOT included in the text segment." }, "content": { "description": "The text content in the segment for output only.", "type": "string" }, "startOffset": { "format": "uint64", "type": "string", "description": "Zero-based character index of the first character of the text segment (counting characters from the beginning of the text)." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTextSegment" }, "GoogleCloudAiplatformV1beta1SchemaTextExtractionAnnotation": { "type": "object", "properties": { "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "textSegment": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTextSegment", "description": "The segment of the text content." }, "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTextExtractionAnnotation", "description": "Annotation details specific to text extraction." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextExtractionEvaluationMetrics": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextExtractionEvaluationMetrics", "properties": { "confusionMatrix": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix", "description": "Confusion matrix of the evaluation. Only set for Models where number of AnnotationSpecs is no more than 10. Only set for ModelEvaluations, not for ModelEvaluationSlices." }, "confidenceMetrics": { "type": "array", "description": "Metrics that have confidence thresholds. Precision-recall curve can be derived from them.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextExtractionEvaluationMetricsConfidenceMetrics" } } }, "type": "object", "description": "Metrics for text extraction evaluation results." }, "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequest": { "properties": { "settings": { "description": "Per-Feature export settings.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DestinationFeatureSetting" } }, "snapshotExport": { "description": "Exports the latest Feature values of all entities of the EntityType within a time range.", "$ref": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestSnapshotExport" }, "featureSelector": { "description": "Required. Selects Features to export values of.", "$ref": "GoogleCloudAiplatformV1beta1FeatureSelector" }, "fullExport": { "description": "Exports all historical values of all entities of the EntityType within a time range", "$ref": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestFullExport" }, "destination": { "$ref": "GoogleCloudAiplatformV1beta1FeatureValueDestination", "description": "Required. Specifies destination location and format." } }, "id": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequest", "type": "object", "description": "Request message for FeaturestoreService.ExportFeatureValues." }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeature": { "properties": { "valueAndTimestamp": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeatureFeatureValueAndTimestamp", "description": "Feature value and timestamp." }, "value": { "$ref": "GoogleCloudAiplatformV1beta1FeatureValue", "description": "Feature value. A user provided timestamp may be set in the `FeatureValue.metadata.generate_time` field." }, "name": { "type": "string", "description": "Feature short name." } }, "type": "object", "description": "Feature name & value pair.", "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeature" }, "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadata", "description": "The metadata of Multimodal Datasets.", "properties": { "geminiRequestReadConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiRequestReadConfig", "description": "The configuration for how to read Gemini requests from the dataset." }, "keyColumnName": { "type": "string", "description": "The name of the column in the BigQuery table that contains the keys of the rows." }, "inputConfig": { "description": "Specifies the input source and configuration.", "$ref": "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataMultimodalDatasetInputConfig" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValue": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValue", "properties": { "doubleValue": { "description": "Double.", "format": "double", "type": "number" }, "distributionValue": { "description": "Distribution.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValueDistributionDataValue" } }, "description": "Typed value of the statistics." }, "GoogleCloudAiplatformV1beta1SchemaTextSentimentSavedQueryMetadata": { "description": "The metadata of SavedQuery contains TextSentiment Annotations.", "properties": { "sentimentMax": { "format": "int32", "type": "integer", "description": "The maximum sentiment of sentiment Anntoation in this SavedQuery." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTextSentimentSavedQueryMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchDeletePipelineJobsRequest": { "properties": { "names": { "type": "array", "description": "Required. The names of the PipelineJobs to delete. A maximum of 32 PipelineJobs can be deleted in a batch. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipelineJob}`", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1BatchDeletePipelineJobsRequest", "description": "Request message for PipelineService.BatchDeletePipelineJobs.", "type": "object" }, "GoogleCloudAiplatformV1beta1VoiceConfig": { "description": "Configuration for a voice.", "properties": { "voice": { "type": "string", "description": "Optional. The speaker identifier for synthesis. Supported formats: * Speaker name for prebuilt voices (for example, `Orus` or `Kore`). * Voice ID for stored voices (for example, `voice_xxx`). * Voice replication key (for example, `voicekey_xxx`)." }, "replicatedVoiceConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReplicatedVoiceConfig", "description": "Optional. The configuration for a replicated voice. This enables users to replicate a voice from an audio sample." }, "prebuiltVoiceConfig": { "$ref": "GoogleCloudAiplatformV1beta1PrebuiltVoiceConfig", "description": "The configuration for a prebuilt voice." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1VoiceConfig" }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigSimilaritySearchConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigSimilaritySearchConfig", "description": "Configuration for how to perform similarity search on memories.", "properties": { "embeddingModel": { "description": "Required. The model used to generate embeddings to lookup similar memories. Format: `projects/{project}/locations/{location}/publishers/google/models/{model}`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionInputs": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionInputs", "type": "object", "properties": { "uptrainBaseModelId": { "description": "The ID of `base` model for upTraining. If it is specified, the new model will be upTrained based on the `base` model for upTraining. Otherwise, the new model will be trained from scratch. The `base` model for upTraining must be in the same Project and Location as the new Model to train, and have the same modelType.", "type": "string" }, "disableEarlyStopping": { "type": "boolean", "description": "Use the entire training budget. This disables the early stopping feature. When false the early stopping feature is enabled, which means that AutoML Image Object Detection might stop training before the entire training budget has been used." }, "budgetMilliNodeHours": { "description": "The training budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The actual metadata.costMilliNodeHours will be equal or less than this value. If further model training ceases to provide any improvements, it will stop without using the full budget and the metadata.successfulStopReason will be `model-converged`. Note, node_hour = actual_hour * number_of_nodes_involved. For modelType `cloud`(default), the budget must be between 20,000 and 900,000 milli node hours, inclusive. The default value is 216,000 which represents one day in wall time, considering 9 nodes are used. For model types `mobile-tf-low-latency-1`, `mobile-tf-versatile-1`, `mobile-tf-high-accuracy-1` the training budget must be between 1,000 and 100,000 milli node hours, inclusive. The default value is 24,000 which represents one day in wall time on a single node that is used.", "type": "string", "format": "int64" }, "tunableParameter": { "description": "Trainer type for Vision TrainRequest.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutomlImageTrainingTunableParameter" }, "modelType": { "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD_HIGH_ACCURACY_1", "CLOUD_LOW_LATENCY_1", "CLOUD_1", "MOBILE_TF_LOW_LATENCY_1", "MOBILE_TF_VERSATILE_1", "MOBILE_TF_HIGH_ACCURACY_1", "CLOUD_STREAMING_1", "SPINENET", "YOLO" ], "type": "string", "enumDescriptions": [ "Should not be set.", "A model best tailored to be used within Google Cloud, and which cannot be exported. Expected to have a higher latency, but should also have a higher prediction quality than other cloud models.", "A model best tailored to be used within Google Cloud, and which cannot be exported. Expected to have a low latency, but may have lower prediction quality than other cloud models.", "A model best tailored to be used within Google Cloud, and which cannot be exported. Compared to the CLOUD_HIGH_ACCURACY_1 and CLOUD_LOW_LATENCY_1 models above, it is expected to have higher prediction quality and lower latency.", "A model that, in addition to being available within Google Cloud can also be exported (see ModelService.ExportModel) and used on a mobile or edge device with TensorFlow afterwards. Expected to have low latency, but may have lower prediction quality than other mobile models.", "A model that, in addition to being available within Google Cloud can also be exported (see ModelService.ExportModel) and used on a mobile or edge device with TensorFlow afterwards.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) and used on a mobile or edge device with TensorFlow afterwards. Expected to have a higher latency, but should also have a higher prediction quality than other mobile models.", "A model best tailored to be used within Google Cloud, and which cannot be exported. Expected to best support predictions in streaming with lower latency and lower prediction quality than other cloud models.", "SpineNet for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally.", "YOLO for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally." ] } } }, "GoogleCloudAiplatformV1beta1SpeakerVoiceConfig": { "description": "Configuration for a single speaker in a multi-speaker setup.", "properties": { "voiceConfig": { "description": "Required. The configuration for the voice of this speaker.", "$ref": "GoogleCloudAiplatformV1beta1VoiceConfig" }, "speaker": { "type": "string", "description": "Required. The name of the speaker. This should be the same as the speaker name used in the prompt." } }, "id": "GoogleCloudAiplatformV1beta1SpeakerVoiceConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentResponse": { "properties": { "outputs": { "description": "The outputs from the sandbox environment.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" } } }, "description": "Response message for SandboxEnvironmentExecutionService.Execute.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentResponse" }, "GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec": { "type": "object", "properties": { "trainingDatasetUri": { "description": "Required. Cloud Storage path to file containing training dataset for preference optimization tuning. The dataset must be formatted as a JSONL file.", "type": "string" }, "hyperParameters": { "description": "Optional. Hyperparameters for Preference Optimization.", "$ref": "GoogleCloudAiplatformV1beta1PreferenceOptimizationHyperParameters" }, "validationDatasetUri": { "description": "Optional. Cloud Storage path to file containing validation dataset for preference optimization tuning. The dataset must be formatted as a JSONL file.", "type": "string" }, "exportLastCheckpointOnly": { "description": "Optional. If set to true, disable intermediate checkpoints for Preference Optimization and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for Preference Optimization. Default is false.", "type": "boolean" } }, "description": "Tuning Spec for Preference Optimization.", "id": "GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec" }, "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessSpec": { "description": "Spec for summarization helpfulness score metric.", "properties": { "useReference": { "type": "boolean", "description": "Optional. Whether to use instance.reference to compute summarization helpfulness." }, "version": { "type": "integer", "format": "int32", "description": "Optional. Which version to use for evaluation." } }, "id": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataRecordError": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataRecordError", "properties": { "embeddingId": { "description": "Empty if the embedding id is failed to parse.", "type": "string" }, "errorType": { "description": "The error type of this record.", "enum": [ "ERROR_TYPE_UNSPECIFIED", "EMPTY_LINE", "INVALID_JSON_SYNTAX", "INVALID_CSV_SYNTAX", "INVALID_AVRO_SYNTAX", "INVALID_EMBEDDING_ID", "EMBEDDING_SIZE_MISMATCH", "NAMESPACE_MISSING", "PARSING_ERROR", "DUPLICATE_NAMESPACE", "OP_IN_DATAPOINT", "MULTIPLE_VALUES", "INVALID_NUMERIC_VALUE", "INVALID_ENCODING", "INVALID_SPARSE_DIMENSIONS", "INVALID_TOKEN_VALUE", "INVALID_SPARSE_EMBEDDING", "INVALID_EMBEDDING", "INVALID_EMBEDDING_METADATA", "EMBEDDING_METADATA_EXCEEDS_SIZE_LIMIT", "DUPLICATE_ID" ], "enumDescriptions": [ "Default, shall not be used.", "The record is empty.", "Invalid json format.", "Invalid csv format.", "Invalid avro format.", "The embedding id is not valid.", "The size of the dense embedding vectors does not match with the specified dimension.", "The `namespace` field is missing.", "Generic catch-all error. Only used for validation failure where the root cause cannot be easily retrieved programmatically.", "There are multiple restricts with the same `namespace` value.", "Numeric restrict has operator specified in datapoint.", "Numeric restrict has multiple values specified.", "Numeric restrict has invalid numeric value specified.", "File is not in UTF_8 format.", "Error parsing sparse dimensions field.", "Token restrict value is invalid.", "Invalid sparse embedding.", "Invalid dense embedding.", "Invalid embedding metadata.", "Embedding metadata exceeds size limit.", "Multiple input records share the same datapoint id. The input conversion pipeline performs non-deterministic last-write-wins de-duplication and emits one error per duplicated id." ], "type": "string" }, "errorMessage": { "description": "A human-readable message that is shown to the user to help them fix the error. Note that this message may change from time to time, your code should check against error_type as the source of truth.", "type": "string" }, "sourceGcsUri": { "description": "Cloud Storage URI pointing to the original file in user's bucket.", "type": "string" }, "rawRecord": { "description": "The original content of this record.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseSpec": { "description": "Spec for TrajectorySingleToolUse metric - returns 1 if tool is present in the predicted trajectory, else 0.", "type": "object", "properties": { "toolName": { "type": "string", "description": "Required. Spec for tool name to be checked for in the predicted trajectory." } }, "id": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseSpec" }, "GoogleCloudAiplatformV1beta1SearchMigratableResourcesRequest": { "description": "Request message for MigrationService.SearchMigratableResources.", "id": "GoogleCloudAiplatformV1beta1SearchMigratableResourcesRequest", "type": "object", "properties": { "filter": { "type": "string", "description": "A filter for your search. You can use the following types of filters: * Resource type filters. The following strings filter for a specific type of MigratableResource: * `ml_engine_model_version:*` * `automl_model:*` * `automl_dataset:*` * `data_labeling_dataset:*` * \"Migrated or not\" filters. The following strings filter for resources that either have or have not already been migrated: * `last_migrate_time:*` filters for migrated resources. * `NOT last_migrate_time:*` filters for not yet migrated resources." }, "pageSize": { "type": "integer", "description": "The standard page size. The default and maximum value is 100.", "format": "int32" }, "pageToken": { "description": "The standard page token.", "type": "string" } } }, "GoogleCloudLocationListLocationsResponse": { "id": "GoogleCloudLocationListLocationsResponse", "type": "object", "description": "The response message for Locations.ListLocations.", "properties": { "locations": { "type": "array", "items": { "$ref": "GoogleCloudLocationLocation" }, "description": "A list of locations that matches the specified filter in the request." }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } } }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopeInactivityTrigger": { "type": "object", "description": "Configuration for inactivity based session completion.", "properties": { "threshold": { "type": "string", "format": "google-duration", "description": "Required. The amount of time that must pass with no new traces before a session is considered ready for evaluation. This is a required field if InactivityTrigger is used. The value must be a positive duration no greater than 7 days (604800 seconds)." } }, "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopeInactivityTrigger" }, "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy": { "type": "object", "properties": { "name": { "description": "Identifier. Resource name of the SemanticGovernancePolicy.", "type": "string" }, "agentResponseCustomization": { "description": "Optional. Settings for customizing the agent's response to end users when this policy is evaluated, such as messages displayed when the policy denies a request.", "$ref": "GoogleCloudAiplatformV1beta1AgentResponseCustomization" }, "displayName": { "description": "Optional. The user-defined name of the SemanticGovernancePolicy.", "type": "string" }, "agentIdentity": { "description": "Output only. Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks. For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity Format: `principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME` Example: `principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID`", "readOnly": true, "type": "string" }, "createTime": { "type": "string", "description": "Output only. Timestamp when this SemanticGovernancePolicy was created.", "readOnly": true, "format": "google-datetime" }, "mcpTools": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyMcpTool" }, "description": "Optional. The McpTools that are affected by this policy.", "type": "array" }, "description": { "description": "Optional. The description of the SemanticGovernancePolicy.", "type": "string" }, "dryRun": { "description": "Optional. If true, this policy is evaluated and its result is reported, but the policy is not enforced: a violation does not block the agent's action. Use this to validate a policy against real traffic before turning enforcement on. Defaults to `false`, meaning the policy is enforced. This setting applies only to this policy. If the SemanticGovernancePolicyEngine for the project is itself in dry run, every policy behaves as dry run regardless of this field.", "type": "boolean" }, "updateTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this SemanticGovernancePolicy was last updated." }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write transactions. If provided, the request will only succeed if the etag matches the current value. Otherwise, an ABORTED error will be returned." }, "agent": { "type": "string", "description": "Required. The name of the agent in Agent Registry that is affected by this policy. Format: `projects/{project}/locations/{location}/agents/{agent}`" }, "naturalLanguageConstraint": { "type": "string", "description": "Required. The natural language constraint of the SemanticGovernancePolicy." } }, "description": "Represents a governance policy applied to a specific Agent and optionally a specific Tool within that Agent.", "id": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy" }, "GoogleCloudAiplatformV1beta1OptimizePromptRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1OptimizePromptRequest", "description": "Request message for GenAiTuningService.OptimizePrompt.", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. The content of the prompt to optimize." }, "optimizationTarget": { "enum": [ "OPTIMIZATION_TARGET_UNSPECIFIED", "OPTIMIZATION_TARGET_GENERAL", "OPTIMIZATION_TARGET_GEMINI_NANO", "OPTIMIZATION_TARGET_FEW_SHOT_RUBRICS", "OPTIMIZATION_TARGET_FEW_SHOT_TARGET_RESPONSE" ], "description": "Optional. The optimization strategy to use.", "type": "string", "enumDescriptions": [ "Unspecified optimization target. Defaults to `OPTIMIZATION_TARGET_GENERAL`.", "Optimizes the prompt for quality using a zero-shot approach.", "Optimizes the prompt for Gemini Nano models.", "Optimizes the prompt using few-shot examples with rubrics.", "Optimizes the prompt using few-shot examples with a target response." ] } } }, "GoogleCloudAiplatformV1beta1FeatureSelectionConfigFeatureConfig": { "properties": { "featureId": { "description": "Required. The ID of the feature resource. Final component of the Feature's resource name.", "type": "string" }, "driftThreshold": { "format": "double", "type": "number", "description": "Optional. Drift threshold. If calculated difference with baseline data larger than threshold, it will be considered as the feature has drift. If not present, the threshold will be default to 0.3. Must be in range [0, 1)." } }, "type": "object", "description": "Feature configuration.", "id": "GoogleCloudAiplatformV1beta1FeatureSelectionConfigFeatureConfig" }, "GoogleCloudAiplatformV1beta1FeatureNoiseSigma": { "description": "Noise sigma by features. Noise sigma represents the standard deviation of the gaussian kernel that will be used to add noise to interpolated inputs prior to computing gradients.", "type": "object", "properties": { "noiseSigma": { "description": "Noise sigma per feature. No noise is added to features that are not set.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureNoiseSigmaNoiseSigmaForFeature" } } }, "id": "GoogleCloudAiplatformV1beta1FeatureNoiseSigma" }, "GoogleCloudLocationLocation": { "properties": { "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}" }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "name": { "type": "string", "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`" }, "metadata": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object" } }, "id": "GoogleCloudLocationLocation", "description": "A resource that represents a Google Cloud location.", "type": "object" }, "GoogleCloudAiplatformV1beta1SummarizationVerbosityResult": { "properties": { "score": { "description": "Output only. Summarization Verbosity score.", "readOnly": true, "format": "float", "type": "number" }, "confidence": { "readOnly": true, "format": "float", "type": "number", "description": "Output only. Confidence for summarization verbosity score." }, "explanation": { "description": "Output only. Explanation for summarization verbosity score.", "readOnly": true, "type": "string" } }, "type": "object", "description": "Spec for summarization verbosity result.", "id": "GoogleCloudAiplatformV1beta1SummarizationVerbosityResult" }, "GoogleCloudAiplatformV1beta1ToolParallelAiSearch": { "properties": { "customConfigs": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { \"source_policy\": { \"include_domains\": [\"google.com\", \"wikipedia.org\"], \"exclude_domains\": [\"example.com\"] }, \"fetch_policy\": { \"max_age_seconds\": 3600 } }" }, "apiKey": { "type": "string", "description": "Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details." }, "enableDataRetention": { "deprecated": true, "type": "boolean", "description": "Optional. Deprecated: Use `enable_zero_data_retention` instead. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is \"false\" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is \"true\", the Parallel Web Search for Grounding - ZDR subscription will be used." }, "enableZeroDataRetention": { "description": "Optional. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is \"false\" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is \"true\", the Parallel Web Search for Grounding - ZDR subscription will be used.", "type": "boolean" } }, "description": "ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding.", "id": "GoogleCloudAiplatformV1beta1ToolParallelAiSearch", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfig": { "type": "object", "description": "Configuration for Agent Run.", "properties": { "userSimulatorConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfigUserSimulatorConfig", "description": "The configuration for a user simulator that uses an LLM to generate messages on behalf of the user." }, "discoveryEngineAssistantConfig": { "$ref": "GoogleCloudAiplatformV1beta1DiscoveryEngineAssistantConfig", "description": "Optional. Config for scraping a Discovery Engine Assistant. The scraping service runs the assistant via the Discovery Engine AssistantService and returns the resulting trajectory for evaluation." }, "geminiAgentConfig": { "description": "Optional. Config for scraping a Gemini Agent via the Interactions API. The scraping service creates interactions against the agent and returns the resulting interaction traces for evaluation.", "$ref": "GoogleCloudAiplatformV1beta1GeminiAgentConfig" }, "sessionInput": { "description": "Optional. The session input to get agent running results.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigSessionInput" }, "agentEngine": { "type": "string", "description": "Optional. The resource name of the Agent Engine. Format: projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine} For example: projects/123/locations/us-central1/reasoningEngines/456" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfig" }, "GoogleCloudAiplatformV1beta1ListTrialsResponse": { "id": "GoogleCloudAiplatformV1beta1ListTrialsResponse", "type": "object", "description": "Response message for VizierService.ListTrials.", "properties": { "trials": { "description": "The Trials associated with the Study.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Trial" } }, "nextPageToken": { "description": "Pass this token as the `page_token` field of the request for a subsequent call. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ExportFeatureValuesOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1ExportFeatureValuesOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "Operation metadata for Featurestore export Feature values.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Details of operations that exports Features values." }, "GoogleCloudAiplatformV1beta1StopTrialRequest": { "id": "GoogleCloudAiplatformV1beta1StopTrialRequest", "type": "object", "description": "Request message for VizierService.StopTrial.", "properties": {} }, "GoogleCloudAiplatformV1beta1RubricVerdict": { "id": "GoogleCloudAiplatformV1beta1RubricVerdict", "description": "Represents the verdict of an evaluation against a single rubric.", "properties": { "reasoning": { "description": "Optional. Human-readable reasoning or explanation for the verdict. This can include specific examples or details from the evaluated content that justify the given verdict.", "type": "string" }, "verdict": { "type": "boolean", "description": "Required. Outcome of the evaluation against the rubric, represented as a boolean. `true` indicates a \"Pass\", `false` indicates a \"Fail\"." }, "evaluatedRubric": { "description": "Required. The full rubric definition that was evaluated. Storing this ensures the verdict is self-contained and understandable, especially if the original rubric definition changes or was dynamically generated.", "$ref": "GoogleCloudAiplatformV1beta1Rubric" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectEntity": { "properties": { "offlineStorageDeletedEntityRowCount": { "format": "int64", "description": "The count of deleted entity rows in the offline storage. Each row corresponds to the combination of an entity ID and a timestamp. One entity ID can have multiple rows in the offline storage.", "type": "string" }, "onlineStorageDeletedEntityCount": { "description": "The count of deleted entities in the online storage. Each entity ID corresponds to one entity.", "type": "string", "format": "int64" } }, "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectEntity", "description": "Response message if the request uses the SelectEntity option.", "type": "object" }, "GoogleCloudAiplatformV1beta1FindNeighborsResponseNeighbor": { "type": "object", "description": "A neighbor of the query vector.", "properties": { "datapoint": { "description": "The datapoint of the neighbor. Note that full datapoints are returned only when \"return_full_datapoint\" is set to true. Otherwise, only the \"datapoint_id\" and \"crowding_tag\" fields are populated.", "$ref": "GoogleCloudAiplatformV1beta1IndexDatapoint" }, "sparseDistance": { "description": "The distance between the neighbor and the query sparse_embedding.", "type": "number", "format": "double" }, "distance": { "format": "double", "type": "number", "description": "The distance between the neighbor and the dense embedding query." } }, "id": "GoogleCloudAiplatformV1beta1FindNeighborsResponseNeighbor" }, "GoogleCloudAiplatformV1beta1GatewayConfig": { "id": "GoogleCloudAiplatformV1beta1GatewayConfig", "type": "object", "properties": { "subnetwork": { "description": "Optional. The URI of the subnetwork resource where PSC-E will be provisioned. if not provided `default` subnet will be used from the same {location} Format: projects/{project}/regions/{region}/subnetworks/{subnetwork}", "type": "string" }, "allowedProjects": { "description": "Optional. Additional consumer projects permitted to attach their own PSC endpoint to this gateway's ServiceAttachment. This is the \"decoupled\" mode, where the customer creates the PSC endpoint in a project other than this gateway's `network` project. Each listed project is VPC-SC enforced: it must be within the caller's service perimeter. The owning SemanticGovernancePolicyEngine's own project is always permitted implicitly and need not be listed. Format: `projects/{project}` (ID or number).", "items": { "type": "string" }, "type": "array" }, "state": { "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The Gateway is being provisioned.", "The Gateway is active and ready to use.", "The Gateway is being de-provisioned.", "The Gateway is inactive.", "The Gateway failed to be provisioned." ], "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "ACTIVE", "DEPROVISIONING", "INACTIVE", "FAILED" ], "description": "Output only. The state of the Gateway configuration.", "type": "string" }, "network": { "description": "Optional. The URI of the network resource where PSC-E will be provisioned. if not provided `default` network will be used. Format: projects/{project}/global/networks/{network}", "type": "string" }, "pscEndpoint": { "type": "string", "readOnly": true, "description": "Output only. The self-link or name of the Private Service Connect endpoint forwarding rule." }, "ipAddress": { "description": "Output only. The private IP address of the PSC endpoint.", "type": "string", "readOnly": true }, "dnsRecord": { "type": "string", "description": "Output only. The fully qualified record name of the created A-record in Cloud DNS.", "readOnly": true }, "dnsZoneName": { "description": "Optional. Name of the private Cloud DNS managed zone in which to create the gateway's A-record. This is the managed zone's own name, not its DNS name: for a zone serving `example.internal.`, this field takes the zone name, such as `my-private-zone`. The zone's DNS name is combined with a generated per-gateway label to form the record's fully qualified name, which must stay within the 255-octet DNS limit. If the full name is too long, gateway provisioning fails when it attempts to create the DNS record.", "type": "string" } }, "description": "Configuration for a single gateway." }, "GoogleCloudAiplatformV1beta1BatchReadTensorboardTimeSeriesDataResponse": { "properties": { "timeSeriesData": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TimeSeriesData" }, "description": "The returned time series data.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1BatchReadTensorboardTimeSeriesDataResponse", "type": "object", "description": "Response message for TensorboardService.BatchReadTensorboardTimeSeriesData." }, "GenaiVertexV1beta1GenerationConfig": { "properties": { "videoConfig": { "description": "Configuration for video generation.", "$ref": "GenaiVertexV1beta1VideoConfig" }, "thinkingSummaries": { "enum": [ "THINKING_SUMMARIES_UNSPECIFIED", "THINKING_SUMMARIES_AUTO", "THINKING_SUMMARIES_NONE" ], "description": "Whether to include thought summaries in the response.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Auto thinking summaries.", "No thinking summaries." ] }, "maxOutputTokens": { "description": "The maximum number of tokens to include in the response.", "type": "integer", "format": "int32" }, "toolChoiceMode": { "enum": [ "TOOL_CHOICE_TYPE_UNSPECIFIED", "AUTO", "ANY", "NONE", "VALIDATED" ], "description": "The mode of the tool choice.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Auto tool choice.", "Any tool choice.", "No tool choice.", "Validated tool choice." ] }, "stopSequences": { "description": "A list of character sequences that will stop output interaction.", "type": "array", "items": { "type": "string" } }, "seed": { "description": "Seed used in decoding for reproducibility.", "type": "integer", "format": "int32" }, "thinkingLevel": { "enum": [ "THINKING_LEVEL_UNSPECIFIED", "THINKING_LEVEL_MINIMAL", "THINKING_LEVEL_LOW", "THINKING_LEVEL_MEDIUM", "THINKING_LEVEL_HIGH" ], "description": "The level of thought tokens that the model should generate.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Little to no thinking.", "Low thinking level.", "Medium thinking level.", "High thinking level." ] }, "structuredSpeechConfig": { "description": "Speech and multi-speaker configuration.", "$ref": "GenaiVertexV1beta1SpeakerConfig" }, "temperature": { "type": "number", "format": "float", "deprecated": true, "description": "Controls the randomness of the output." }, "topP": { "deprecated": true, "description": "The maximum cumulative probability of tokens to consider when sampling.", "format": "float", "type": "number" }, "imageConfig": { "$ref": "GenaiVertexV1beta1ImageConfig", "deprecated": true, "description": "Configuration for image interaction." }, "transcriptionConfig": { "$ref": "GenaiVertexV1beta1TranscriptionConfig", "description": "Optional. Configuration for speech recognition (transcription). If present, ASR is enabled." }, "toolChoiceConfig": { "$ref": "GenaiVertexV1beta1ToolChoiceConfig", "description": "The config for the tool choice." } }, "id": "GenaiVertexV1beta1GenerationConfig", "type": "object", "description": "Configuration parameters for model interactions." }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectTimeRangeAndFeature": { "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesResponseSelectTimeRangeAndFeature", "type": "object", "description": "Response message if the request uses the SelectTimeRangeAndFeature option.", "properties": { "onlineStorageModifiedEntityCount": { "type": "string", "format": "int64", "description": "The count of modified entities in the online storage. Each entity ID corresponds to one entity. Within each entity, only the features specified in the request are deleted." }, "impactedFeatureCount": { "type": "string", "format": "int64", "description": "The count of the features or columns impacted. This is the same as the feature count in the request." }, "offlineStorageModifiedEntityRowCount": { "type": "string", "format": "int64", "description": "The count of modified entity rows in the offline storage. Each row corresponds to the combination of an entity ID and a timestamp. One entity ID can have multiple rows in the offline storage. Within each row, only the features specified in the request are deleted." } } }, "GoogleCloudAiplatformV1beta1UserScenarioGenerationConfig": { "description": "User scenario generation configuration.", "id": "GoogleCloudAiplatformV1beta1UserScenarioGenerationConfig", "type": "object", "properties": { "userScenarioCount": { "type": "string", "format": "int64", "description": "Required. The number of user scenarios to generate. The maximum number of scenarios that can be generated is 100." }, "modelName": { "description": "Optional. The model name to use for generation. It can be model name, e.g. \"gemini-3-pro-preview\". or the fully qualified name of the publisher model or endpoint. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" }, "environmentData": { "description": "Optional. Environment data in string type.", "type": "string" }, "simulationInstruction": { "description": "Optional. Simulation instruction to guide the user scenario generation.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1QuestionAnsweringQualitySpec": { "properties": { "version": { "description": "Optional. Which version to use for evaluation.", "type": "integer", "format": "int32" }, "useReference": { "description": "Optional. Whether to use instance.reference to compute question answering quality.", "type": "boolean" } }, "type": "object", "description": "Spec for question answering quality score metric.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualitySpec" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbANN": { "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbANN", "description": "Config for ANN search. RagManagedDb uses a tree-based structure to partition data and facilitate faster searches. As a tradeoff, it requires longer indexing time and manual triggering of index rebuild via the ImportRagFiles and UpdateRagCorpus API.", "type": "object", "properties": { "treeDepth": { "format": "int32", "type": "integer", "description": "The depth of the tree-based structure. Only depth values of 2 and 3 are supported. Recommended value is 2 if you have if you have O(10K) files in the RagCorpus and set this to 3 if more than that. Default value is 2." }, "leafCount": { "type": "integer", "format": "int32", "description": "Number of leaf nodes in the tree-based structure. Each leaf node contains groups of closely related vectors along with their corresponding centroid. Recommended value is 10 * sqrt(num of RagFiles in your RagCorpus). Default value is 500." } } }, "GoogleCloudAiplatformV1beta1FeatureGroupBigQuery": { "properties": { "entityIdColumns": { "items": { "type": "string" }, "type": "array", "description": "Optional. Columns to construct entity_id / row keys. If not provided defaults to `entity_id`." }, "timeSeries": { "description": "Optional. If the source is a time-series source, this can be set to control how downstream sources (ex: FeatureView ) will treat time-series sources. If not set, will treat the source as a time-series source with `feature_timestamp` as timestamp column and no scan boundary.", "$ref": "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries" }, "staticDataSource": { "type": "boolean", "description": "Optional. Set if the data source is not a time-series." }, "bigQuerySource": { "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource", "description": "Required. Immutable. The BigQuery source URI that points to either a BigQuery Table or View." }, "dense": { "description": "Optional. If set, all feature values will be fetched from a single row per unique entityId including nulls. If not set, will collapse all rows for each unique entityId into a singe row with any non-null values if present, if no non-null values are present will sync null. ex: If source has schema `(entity_id, feature_timestamp, f0, f1)` and the following rows: `(e1, 2020-01-01T10:00:00.123Z, 10, 15)` `(e1, 2020-02-01T10:00:00.123Z, 20, null)` If dense is set, `(e1, 20, null)` is synced to online stores. If dense is not set, `(e1, 20, 15)` is synced to online stores.", "type": "boolean" } }, "description": "Input source type for BigQuery Tables and Views.", "id": "GoogleCloudAiplatformV1beta1FeatureGroupBigQuery", "type": "object" }, "GoogleCloudAiplatformV1beta1SessionEvent": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SessionEvent", "description": "An event represents a message from either the user or agent.", "properties": { "errorCode": { "description": "Optional. Error code if the response is an error. Code varies by model.", "type": "string" }, "author": { "type": "string", "description": "Required. The name of the agent that sent the event, or user." }, "errorMessage": { "type": "string", "description": "Optional. Error message if the response is an error." }, "rawEvent": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Optional. Weakly typed raw event data in proto struct format.", "type": "object" }, "content": { "description": "Optional. Content of the event provided by the author.", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "invocationId": { "type": "string", "description": "Required. The invocation id of the event, multiple events can have the same invocation id." }, "timestamp": { "description": "Required. Timestamp when the event was created on client side.", "type": "string", "format": "google-datetime" }, "eventMetadata": { "$ref": "GoogleCloudAiplatformV1beta1EventMetadata", "description": "Optional. Metadata relating to this event." }, "actions": { "$ref": "GoogleCloudAiplatformV1beta1EventActions", "description": "Optional. Actions executed by the agent." }, "name": { "description": "Identifier. The resource name of the event. Format:`projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}/events/{event}`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringInput": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInput", "description": "Model monitoring data input spec.", "properties": { "vertexEndpointLogs": { "description": "Vertex AI Endpoint request & response logging.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputVertexEndpointLogs" }, "batchPredictionOutput": { "description": "Vertex AI Batch prediction Job.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputBatchPredictionOutput" }, "timeInterval": { "$ref": "GoogleTypeInterval", "description": "The time interval (pair of start_time and end_time) for which results should be returned." }, "columnizedDataset": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDataset", "description": "Columnized dataset." }, "timeOffset": { "description": "The time offset setting for which results should be returned.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputTimeOffset" } } }, "GoogleCloudAiplatformV1beta1AssembleDataRequest": { "description": "Request message for DatasetService.AssembleData. Used only for MULTIMODAL datasets.", "id": "GoogleCloudAiplatformV1beta1AssembleDataRequest", "type": "object", "properties": { "geminiRequestReadConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiRequestReadConfig", "description": "Optional. The read config for the dataset." } } }, "GoogleCloudAiplatformV1beta1RagRetrievalConfigRanking": { "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRanking", "type": "object", "properties": { "rankService": { "description": "Optional. Config for Rank Service.", "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingRankService" }, "llmRanker": { "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingLlmRanker", "description": "Optional. Config for LlmRanker." } }, "description": "Config for ranking and reranking." }, "GoogleCloudAiplatformV1beta1AssessDataRequest": { "description": "Request message for DatasetService.AssessData. Used only for MULTIMODAL datasets.", "properties": { "tuningResourceUsageAssessmentConfig": { "description": "Optional. Configuration for the tuning resource usage assessment.", "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig" }, "batchPredictionResourceUsageAssessmentConfig": { "description": "Optional. Configuration for the batch prediction resource usage assessment.", "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionResourceUsageAssessmentConfig" }, "batchPredictionValidationAssessmentConfig": { "description": "Optional. Configuration for the batch prediction validation assessment.", "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionValidationAssessmentConfig" }, "tuningValidationAssessmentConfig": { "description": "Optional. Configuration for the tuning validation assessment.", "$ref": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig" }, "geminiRequestReadConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiRequestReadConfig", "description": "Optional. The Gemini request read config for the dataset." } }, "id": "GoogleCloudAiplatformV1beta1AssessDataRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1UpdateOnlineEvaluatorOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Generic operation metadata." } }, "description": "Metadata for the UpdateOnlineEvaluator operation.", "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateOnlineEvaluatorOperationMetadata" }, "GoogleCloudAiplatformV1beta1Checkpoint": { "properties": { "step": { "format": "int64", "type": "string", "description": "The step of the checkpoint." }, "checkpointId": { "description": "The ID of the checkpoint.", "type": "string" }, "epoch": { "format": "int64", "description": "The epoch of the checkpoint.", "type": "string" } }, "type": "object", "description": "Describes the machine learning model version checkpoint.", "id": "GoogleCloudAiplatformV1beta1Checkpoint" }, "GoogleCloudAiplatformV1beta1CreateExtensionControllerOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateExtensionControllerOperationMetadata", "type": "object", "description": "Details of ExtensionControllerService.CreateExtensionController operation.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The common part of the operation metadata." } } }, "GoogleCloudAiplatformV1beta1TaskMetadataChange": { "description": "An event representing a change to the task's top-level metadata. example: metadata_change: { new_metadata: { \"name\": \"My task\", } update_mask: { paths: \"name\" } }", "properties": { "newMetadata": { "description": "Required. The complete state of the metadata object *after* the change.", "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "updateMask": { "description": "Optional. A field mask indicating which paths in the Struct were changed. If not set, all fields will be updated. go/aip-internal/cloud-standard/2412", "format": "google-fieldmask", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TaskMetadataChange" }, "GoogleCloudAiplatformV1beta1ListContextsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListContextsRequest.page_token to retrieve the next page. If this field is not populated, there are no subsequent pages." }, "contexts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Context" }, "description": "The Contexts retrieved from the MetadataStore." } }, "type": "object", "description": "Response message for MetadataService.ListContexts.", "id": "GoogleCloudAiplatformV1beta1ListContextsResponse" }, "GoogleCloudAiplatformV1beta1Scalar": { "type": "object", "id": "GoogleCloudAiplatformV1beta1Scalar", "description": "One point viewable on a scalar metric plot.", "properties": { "value": { "description": "Value of the point at this step / timestamp.", "format": "double", "type": "number" } } }, "GoogleCloudAiplatformV1beta1ExportModelRequest": { "id": "GoogleCloudAiplatformV1beta1ExportModelRequest", "type": "object", "properties": { "outputConfig": { "description": "Required. The desired output location and configuration.", "$ref": "GoogleCloudAiplatformV1beta1ExportModelRequestOutputConfig" } }, "description": "Request message for ModelService.ExportModel." }, "GoogleCloudAiplatformV1beta1CancelNasJobRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CancelNasJobRequest", "description": "Request message for JobService.CancelNasJob.", "properties": {} }, "GoogleCloudAiplatformV1beta1AddExecutionEventsResponse": { "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1AddExecutionEventsResponse", "description": "Response message for MetadataService.AddExecutionEvents." }, "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolygonAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolygonAnnotation", "type": "object", "properties": { "vertexes": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaVertex" }, "description": "The vertexes are connected one by one and the last vertex is connected to the first one to represent a polygon.", "type": "array" }, "annotationSpecId": { "description": "The resource Id of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "displayName": { "type": "string", "description": "The display name of the AnnotationSpec that this Annotation pertains to." } }, "description": "Represents a polygon in image." }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingPredictionSkewDetectionConfig": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingPredictionSkewDetectionConfig", "description": "The config for Training & Prediction data skew detection. It specifies the training dataset sources and the skew detection parameters.", "type": "object", "properties": { "attributionScoreSkewThresholds": { "description": "Key is the feature name and value is the threshold. The threshold here is against attribution score distance between the training and prediction feature.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig" } }, "defaultSkewThreshold": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig", "description": "Skew anomaly detection threshold used by all features. When the per-feature thresholds are not set, this field can be used to specify a threshold for all features." }, "skewThresholds": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig" }, "description": "Key is the feature name and value is the threshold. If a feature needs to be monitored for skew, a value threshold must be configured for that feature. The threshold here is against feature distribution distance between the training and prediction feature.", "type": "object" } } }, "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsRequest": { "description": "Request message for AppendA2aTaskEvents.", "properties": { "generation": { "type": "string", "format": "int64", "description": "Optional. The current task generation." }, "taskEvents": { "description": "Required. The events to append. The number of events to append must be less than or equal to 100. Otherwise, an exception will be thrown. Used only if the parent is a ReasoningEngine.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TaskEvent" } }, "events": { "description": "Optional. The events to append. Used only if the parent is a TaskStore.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskEvent" } } }, "id": "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsRequest", "type": "object" }, "GoogleTypeColor": { "properties": { "red": { "type": "number", "format": "float", "description": "The amount of red in the color as a value in the interval [0, 1]." }, "blue": { "format": "float", "type": "number", "description": "The amount of blue in the color as a value in the interval [0, 1]." }, "alpha": { "description": "The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0).", "format": "float", "type": "number" }, "green": { "type": "number", "format": "float", "description": "The amount of green in the color as a value in the interval [0, 1]." } }, "type": "object", "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "id": "GoogleTypeColor" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecTabularObjective": { "description": "Tabular monitoring objective.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecTabularObjective", "properties": { "featureDriftSpec": { "description": "Input feature distribution drift monitoring spec.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecDataDriftSpec" }, "predictionOutputDriftSpec": { "description": "Prediction output distribution drift monitoring spec.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecDataDriftSpec" }, "featureAttributionSpec": { "description": "Feature attribution monitoring spec.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecFeatureAttributionSpec" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfig": { "description": "Config for the Vector DB to use for RAG.", "type": "object", "properties": { "weaviate": { "description": "The config for the Weaviate.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigWeaviate" }, "vertexFeatureStore": { "description": "The config for the Vertex Feature Store.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexFeatureStore" }, "vertexVectorSearch": { "description": "The config for the Vertex Vector Search.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexVectorSearch" }, "ragEmbeddingModelConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig", "description": "Optional. Immutable. The embedding model config of the Vector DB." }, "ragManagedVertexVectorSearch": { "description": "The config for the RAG-managed Vertex Vector Search 2.0.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedVertexVectorSearch" }, "apiAuth": { "description": "Authentication config for the chosen Vector DB.", "$ref": "GoogleCloudAiplatformV1beta1ApiAuth" }, "ragManagedDb": { "description": "The config for the RAG-managed Vector DB.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDb" }, "pinecone": { "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigPinecone", "description": "The config for the Pinecone." } }, "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfig" }, "GoogleCloudAiplatformV1beta1ModelMonitoringTabularStats": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringTabularStats", "description": "A collection of data points that describes the time-varying values of a tabular metric.", "properties": { "dataPoints": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPoint" }, "description": "The data points of this time series. When listing time series, points are returned in reverse time order." }, "statsName": { "type": "string", "description": "The stats name." }, "objectiveType": { "type": "string", "description": "One of the supported monitoring objectives: `raw-feature-drift` `prediction-output-drift` `feature-attribution`" } } }, "GoogleCloudAiplatformV1beta1LossAnalysisConfig": { "description": "Configuration for the loss analysis job.", "properties": { "metric": { "type": "string", "description": "Required. The metric to analyze (e.g., \"tool_use_quality\"). This filters the EvaluationItems in the EvalSet to only those where EvaluationResult.metric matches this value." }, "candidate": { "description": "Required. The candidate model/agent to analyze (e.g., \"gemini-3.0-pro\"). This targets the specific CandidateResult within the EvaluationResult.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1LossAnalysisConfig" }, "GoogleCloudAiplatformV1beta1SchemaPromptApiSchema": { "description": "The A2 schema of a prompt.", "type": "object", "properties": { "multimodalPrompt": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecMultimodalPrompt", "description": "Multimodal prompt which embeds preambles to prompt string." }, "translationPrompt": { "description": "The prompt variation for Translation use case.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationPrompt" }, "structuredPrompt": { "description": "The prompt variation that stores preambles in separate fields.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt" }, "executions": { "type": "array", "description": "A list of execution instances for constructing a ready-to-use prompt.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptInstancePromptExecution" } }, "apiSchemaVersion": { "description": "The Schema version that represents changes to the API behavior.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaPromptApiSchema" }, "GoogleCloudAiplatformV1beta1RagRetrievalConfig": { "description": "Specifies the context retrieval config.", "type": "object", "properties": { "filter": { "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfigFilter", "description": "Optional. Config for filters." }, "ranking": { "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRanking", "description": "Optional. Config for ranking and reranking." }, "hybridSearch": { "description": "Optional. Config for Hybrid Search.", "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfigHybridSearch" }, "topK": { "type": "integer", "format": "int32", "description": "Optional. The number of contexts to retrieve." } }, "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfig" }, "GenaiVertexV1beta1TextContent": { "type": "object", "id": "GenaiVertexV1beta1TextContent", "properties": { "text": { "description": "Required. The text content.", "type": "string" }, "annotations": { "type": "array", "description": "Citation information for model-generated content.", "items": { "$ref": "GenaiVertexV1beta1TextContentAnnotation" } } }, "description": "A text content block. " }, "GoogleCloudAiplatformV1beta1ReadTensorboardSizeResponse": { "id": "GoogleCloudAiplatformV1beta1ReadTensorboardSizeResponse", "type": "object", "description": "Response message for TensorboardService.ReadTensorboardSize.", "properties": { "storageSizeByte": { "description": "Payload storage size for the TensorBoard", "format": "int64", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalTransformation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalTransformation", "properties": { "columnName": { "type": "string" } }, "description": "Training pipeline will perform following transformation functions. * The categorical string as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index. * Categories that appear less than 5 times in the training dataset are treated as the \"unknown\" category. The \"unknown\" category gets its own special lookup index and resulting embedding." }, "GoogleCloudAiplatformV1beta1ListOptimalTrialsResponse": { "description": "Response message for VizierService.ListOptimalTrials.", "properties": { "optimalTrials": { "description": "The pareto-optimal Trials for multiple objective Study or the optimal trial for single objective Study. The definition of pareto-optimal can be checked in wiki page. https://en.wikipedia.org/wiki/Pareto_efficiency", "items": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ListOptimalTrialsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1A2aTaskHistoryAppend": { "type": "object", "properties": { "message": { "description": "Required. The message to append to the task history.", "$ref": "GoogleCloudAiplatformV1beta1A2aTaskMessage" } }, "id": "GoogleCloudAiplatformV1beta1A2aTaskHistoryAppend", "description": "An event payload that appends a new message to the task history." }, "CloudAiLargeModelsVisionGenerateVideoResponseVideo": { "type": "object", "properties": { "bytesBase64Encoded": { "type": "string", "description": "Base64 encoded bytes string representing the video." }, "experimentsMetadata": { "description": "Optional metadata returned from experimental requests. Likely only includes the rewritten prompt chunks.", "$ref": "CloudAiLargeModelsVisionGenerateVideoExperiments", "deprecated": true }, "experimentsResponse": { "$ref": "CloudAiLargeModelsVisionExperimentsResponse", "description": "Optional response returned from experimental requests." }, "gcsUri": { "type": "string", "description": "Cloud Storage URI where the generated video is written." }, "mimeType": { "description": "The MIME type of the content of the video. - video/mp4", "type": "string" } }, "id": "CloudAiLargeModelsVisionGenerateVideoResponseVideo" }, "GoogleCloudAiplatformV1beta1SuspendOnlineEvaluatorOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1SuspendOnlineEvaluatorOperationMetadata", "properties": { "genericMetadata": { "description": "Common part of operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Metadata for the SuspendOnlineEvaluator operation.", "type": "object" }, "GoogleCloudAiplatformV1beta1CancelPipelineJobRequest": { "description": "Request message for PipelineService.CancelPipelineJob.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CancelPipelineJobRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1FeatureViewOptimizedConfig": { "properties": { "automaticResources": { "description": "Optional. A description of resources that the FeatureView uses, which to large degree are decided by Vertex AI, and optionally allows only a modest additional configuration. If min_replica_count is not set, the default value is 2. If max_replica_count is not set, the default value is 6. The max allowed replica count is 1000.", "$ref": "GoogleCloudAiplatformV1beta1AutomaticResources" } }, "type": "object", "description": "Configuration for FeatureViews created in Optimized FeatureOnlineStore.", "id": "GoogleCloudAiplatformV1beta1FeatureViewOptimizedConfig" }, "GoogleCloudAiplatformV1beta1CometResult": { "description": "Spec for Comet result - calculates the comet score for the given instance using the version specified in the spec.", "properties": { "score": { "description": "Output only. Comet score. Range depends on version.", "readOnly": true, "type": "number", "format": "float" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CometResult" }, "GoogleCloudAiplatformV1beta1SummarizationQualitySpec": { "description": "Spec for summarization quality score metric.", "type": "object", "properties": { "version": { "type": "integer", "description": "Optional. Which version to use for evaluation.", "format": "int32" }, "useReference": { "description": "Optional. Whether to use instance.reference to compute summarization quality.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1SummarizationQualitySpec" }, "GenaiVertexV1beta1RagStoreConfigRagResource": { "type": "object", "id": "GenaiVertexV1beta1RagStoreConfigRagResource", "properties": { "ragCorpus": { "description": "Optional. RagCorpora resource name.", "type": "string" }, "ragFileIds": { "description": "Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.", "type": "array", "items": { "type": "string" } } }, "description": "The definition of the Rag resource." }, "GenaiVertexV1beta1RetrievalCallStepRetrievalStepArguments": { "description": "The arguments to pass to Retrieval tools.", "id": "GenaiVertexV1beta1RetrievalCallStepRetrievalStepArguments", "type": "object", "properties": { "queries": { "items": { "type": "string" }, "type": "array", "description": "Queries for Retrieval information." } } }, "GoogleCloudAiplatformV1beta1Featurestore": { "id": "GoogleCloudAiplatformV1beta1Featurestore", "description": "Vertex AI Feature Store provides a centralized repository for organizing, storing, and serving ML features. The Featurestore is a top-level container for your features and their values.", "properties": { "labels": { "description": "Optional. The labels with user-defined metadata to organize your Featurestore. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one Featurestore(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "additionalProperties": { "type": "string" }, "type": "object" }, "etag": { "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "onlineStorageTtlDays": { "type": "integer", "description": "Optional. TTL in days for feature values that will be stored in online serving storage. The Feature Store online storage periodically removes obsolete feature values older than `online_storage_ttl_days` since the feature generation time. Note that `online_storage_ttl_days` should be less than or equal to `offline_storage_ttl_days` for each EntityType under a featurestore. If not set, default to 4000 days", "format": "int32" }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this Featurestore was created.", "readOnly": true }, "encryptionSpec": { "description": "Optional. Customer-managed encryption key spec for data storage. If set, both of the online and offline data storage will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "satisfiesPzs": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." }, "updateTime": { "description": "Output only. Timestamp when this Featurestore was last updated.", "format": "google-datetime", "type": "string", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. Name of the Featurestore. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}`" }, "state": { "readOnly": true, "description": "Output only. State of the featurestore.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "STABLE", "UPDATING" ], "enumDescriptions": [ "Default value. This value is unused.", "State when the featurestore configuration is not being updated and the fields reflect the current configuration of the featurestore. The featurestore is usable in this state.", "The state of the featurestore configuration when it is being updated. During an update, the fields reflect either the original configuration or the updated configuration of the featurestore. For example, `online_serving_config.fixed_node_count` can take minutes to update. While the update is in progress, the featurestore is in the UPDATING state, and the value of `fixed_node_count` can be the original value or the updated value, depending on the progress of the operation. Until the update completes, the actual number of nodes can still be the original value of `fixed_node_count`. The featurestore is still usable in this state." ] }, "onlineServingConfig": { "description": "Optional. Config for online storage resources. The field should not co-exist with the field of `OnlineStoreReplicationConfig`. If both of it and OnlineStoreReplicationConfig are unset, the feature store will not have an online store and cannot be used for online serving.", "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfig" }, "satisfiesPzi": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TrainingPipeline": { "description": "The TrainingPipeline orchestrates tasks associated with training a Model. It always executes the training task, and optionally may also export data from Vertex AI's Dataset which becomes the training input, upload the Model to Vertex AI, and evaluate the Model.", "properties": { "encryptionSpec": { "description": "Customer-managed encryption key spec for a TrainingPipeline. If set, this TrainingPipeline will be secured by this key. Note: Model trained by this TrainingPipeline is also secured by this key if model_to_upload is not set separately.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "startTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Time when the TrainingPipeline for the first time entered the `PIPELINE_STATE_RUNNING` state." }, "modelToUpload": { "description": "Describes the Model that may be uploaded (via ModelService.UploadModel) by this TrainingPipeline. The TrainingPipeline's training_task_definition should make clear whether this Model description should be populated, and if there are any special requirements regarding how it should be filled. If nothing is mentioned in the training_task_definition, then it should be assumed that this field should not be filled and the training task either uploads the Model without a need of this information, or that training task does not support uploading a Model as part of the pipeline. When the Pipeline's state becomes `PIPELINE_STATE_SUCCEEDED` and the trained Model had been uploaded into Vertex AI, then the model_to_upload's resource name is populated. The Model is always uploaded into the Project and Location in which this pipeline is.", "$ref": "GoogleCloudAiplatformV1beta1Model" }, "trainingTaskMetadata": { "description": "Output only. The metadata information as specified in the training_task_definition's `metadata`. This metadata is an auxiliary runtime and final information about the training task. While the pipeline is running this information is populated only at a best effort basis. Only present if the pipeline's training_task_definition contains `metadata` object.", "type": "any", "readOnly": true }, "labels": { "type": "object", "description": "The labels with user-defined metadata to organize TrainingPipelines. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "additionalProperties": { "type": "string" } }, "displayName": { "type": "string", "description": "Required. The user-defined name of this TrainingPipeline." }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Time when the TrainingPipeline was most recently updated." }, "trainingTaskInputs": { "description": "Required. The training task's parameter(s), as specified in the training_task_definition's `inputs`.", "type": "any" }, "modelId": { "description": "Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", "type": "string" }, "error": { "description": "Output only. Only populated when the pipeline's state is `PIPELINE_STATE_FAILED` or `PIPELINE_STATE_CANCELLED`.", "$ref": "GoogleRpcStatus", "readOnly": true }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Time when the TrainingPipeline was created." }, "endTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time when the TrainingPipeline entered any of the following states: `PIPELINE_STATE_SUCCEEDED`, `PIPELINE_STATE_FAILED`, `PIPELINE_STATE_CANCELLED`." }, "trainingTaskDefinition": { "description": "Required. A Google Cloud Storage path to the YAML file that defines the training task which is responsible for producing the model artifact, and may also include additional auxiliary work. The definition files that can be used here are found in gs://google-cloud-aiplatform/schema/trainingjob/definition/. Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access.", "type": "string" }, "name": { "readOnly": true, "description": "Output only. Resource name of the TrainingPipeline.", "type": "string" }, "parentModel": { "description": "Optional. When specify this field, the `model_to_upload` will not be uploaded as a new model, instead, it will become a new version of this `parent_model`.", "type": "string" }, "state": { "enumDescriptions": [ "The pipeline state is unspecified.", "The pipeline has been created or resumed, and processing has not yet begun.", "The service is preparing to run the pipeline.", "The pipeline is in progress.", "The pipeline completed successfully.", "The pipeline failed.", "The pipeline is being cancelled. From this state, the pipeline may only go to either PIPELINE_STATE_SUCCEEDED, PIPELINE_STATE_FAILED or PIPELINE_STATE_CANCELLED.", "The pipeline has been cancelled.", "The pipeline has been stopped, and can be resumed." ], "readOnly": true, "type": "string", "description": "Output only. The detailed state of the pipeline.", "enum": [ "PIPELINE_STATE_UNSPECIFIED", "PIPELINE_STATE_QUEUED", "PIPELINE_STATE_PENDING", "PIPELINE_STATE_RUNNING", "PIPELINE_STATE_SUCCEEDED", "PIPELINE_STATE_FAILED", "PIPELINE_STATE_CANCELLING", "PIPELINE_STATE_CANCELLED", "PIPELINE_STATE_PAUSED" ] }, "inputDataConfig": { "description": "Specifies Vertex AI owned input data that may be used for training the Model. The TrainingPipeline's training_task_definition should make clear whether this config is used and if there are any special requirements on how it should be filled. If nothing about this config is mentioned in the training_task_definition, then it should be assumed that the TrainingPipeline does not depend on this configuration.", "$ref": "GoogleCloudAiplatformV1beta1InputDataConfig" } }, "id": "GoogleCloudAiplatformV1beta1TrainingPipeline", "type": "object" }, "GenaiVertexV1beta1TextContentAnnotation": { "properties": { "placeCitation": { "description": "A place citation annotation.", "$ref": "GenaiVertexV1beta1PlaceCitation" }, "wordInfo": { "description": "Word-level ASR annotation with timing and speaker info.", "$ref": "GenaiVertexV1beta1WordInfo" }, "startIndex": { "type": "integer", "description": "Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.", "format": "int32" }, "urlCitation": { "description": "NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.", "$ref": "GenaiVertexV1beta1UrlCitation" }, "speechMetadata": { "description": "Speech annotation for text content.", "$ref": "GenaiVertexV1beta1SpeechAnnotation" }, "endIndex": { "format": "int32", "description": "End of the attributed segment, exclusive.", "type": "integer" }, "fileCitation": { "description": "A file citation annotation.", "$ref": "GenaiVertexV1beta1FileCitation" } }, "description": "Citation information for model-generated content.", "id": "GenaiVertexV1beta1TextContentAnnotation", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelContainerSpec": { "properties": { "ports": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Port" }, "description": "Immutable. List of ports to expose from the container. Vertex AI sends any prediction requests that it receives to the first port on this list. Vertex AI also sends [liveness and health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#liveness) to this port. If you do not specify this field, it defaults to following value: ```json [ { \"containerPort\": 8080 } ] ``` Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).", "type": "array" }, "args": { "items": { "type": "string" }, "description": "Immutable. Specifies arguments for the command that runs when the container starts. This overrides the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd). Specify this field as an array of executable and arguments, similar to a Docker `CMD`'s \"default parameters\" form. If you don't specify this field but do specify the command field, then the command from the `command` field runs without any additional arguments. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). If you don't specify this field and don't specify the `command` field, then the container's [`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#cmd) and `CMD` determine what runs based on their default behavior. See the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `args` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).", "type": "array" }, "healthRoute": { "type": "string", "description": "Immutable. HTTP path on the container to send health checks to. Vertex AI intermittently sends GET requests to this path on the container's IP address and port to check that the container is healthy. Read more about [health checks](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#health). For example, if you set this field to `/bar`, then Vertex AI intermittently sends a GET request to the `/bar` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/ DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)" }, "imageUri": { "type": "string", "description": "Required. Immutable. URI of the Docker image to be used as the custom container for serving predictions. This URI must identify an image in Artifact Registry or Container Registry. Learn more about the [container publishing requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#publishing), including permissions requirements for the Vertex AI Service Agent. The container image is ingested upon ModelService.UploadModel, stored internally, and this original path is afterwards not used. To learn about the requirements for the Docker image itself, see [Custom container requirements](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#). You can use the URI to one of Vertex AI's [pre-built container images for prediction](https://cloud.google.com/vertex-ai/docs/predictions/pre-built-containers) in this field." }, "env": { "type": "array", "description": "Immutable. List of environment variables to set in the container. After the container starts running, code running in the container can read these environment variables. Additionally, the command and args fields can reference these variables. Later entries in this list can also reference earlier entries. For example, the following example sets the variable `VAR_2` to have the value `foo bar`: ```json [ { \"name\": \"VAR_1\", \"value\": \"foo\" }, { \"name\": \"VAR_2\", \"value\": \"$(VAR_1) bar\" } ] ``` If you switch the order of the variables in the example, then the expansion does not occur. This field corresponds to the `env` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB.", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" } }, "command": { "items": { "type": "string" }, "description": "Immutable. Specifies the command that runs when the container starts. This overrides the container's [ENTRYPOINT](https://docs.docker.com/engine/reference/builder/#entrypoint). Specify this field as an array of executable and arguments, similar to a Docker `ENTRYPOINT`'s \"exec\" form, not its \"shell\" form. If you do not specify this field, then the container's `ENTRYPOINT` runs, in conjunction with the args field or the container's [`CMD`](https://docs.docker.com/engine/reference/builder/#cmd), if either exists. If this field is not specified and the container does not have an `ENTRYPOINT`, then refer to the Docker documentation about [how `CMD` and `ENTRYPOINT` interact](https://docs.docker.com/engine/reference/builder/#understand-how-cmd-and-entrypoint-interact). If you specify this field, then you can also specify the `args` field to provide additional arguments for this command. However, if you specify this field, then the container's `CMD` is ignored. See the [Kubernetes documentation about how the `command` and `args` fields interact with a container's `ENTRYPOINT` and `CMD`](https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#notes). In this field, you can reference [environment variables set by Vertex AI](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables) and environment variables set in the env field. You cannot reference environment variables set in the Docker image. In order for environment variables to be expanded, reference them by using the following syntax: $( VARIABLE_NAME) Note that this differs from Bash variable expansion, which does not use parentheses. If a variable cannot be resolved, the reference in the input string is used unchanged. To avoid variable expansion, you can escape this syntax with `$$`; for example: $$(VARIABLE_NAME) This field corresponds to the `command` field of the Kubernetes Containers [v1 core API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).", "type": "array" }, "invokeRoutePrefix": { "description": "Immutable. Invoke route prefix for the custom container. \"/*\" is the only supported value right now. By setting this field, any non-root route on this model will be accessible with invoke http call eg: \"/invoke/foo/bar\", however the [PredictionService.Invoke] RPC is not supported yet. Only one of `predict_route` or `invoke_route_prefix` can be set, and we default to using `predict_route` if this field is not set. If this field is set, the Model can only be deployed to dedicated endpoint.", "type": "string" }, "sharedMemorySizeMb": { "type": "string", "description": "Immutable. The amount of the VM memory to reserve as the shared memory for the model in megabytes.", "format": "int64" }, "predictRoute": { "type": "string", "description": "Immutable. HTTP path on the container to send prediction requests to. Vertex AI forwards requests sent using projects.locations.endpoints.predict to this path on the container's IP address and port. Vertex AI then returns the container's response in the API response. For example, if you set this field to `/foo`, then when Vertex AI receives a prediction request, it forwards the request body in a POST request to the `/foo` path on the port of your container specified by the first value of this `ModelContainerSpec`'s ports field. If you don't specify this field, it defaults to the following value when you deploy this Model to an Endpoint: /v1/endpoints/ENDPOINT/deployedModels/DEPLOYED_MODEL:predict The placeholders in this value are replaced as follows: * ENDPOINT: The last segment (following `endpoints/`)of the Endpoint.name][] field of the Endpoint where this Model has been deployed. (Vertex AI makes this value available to your container code as the [`AIP_ENDPOINT_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).) * DEPLOYED_MODEL: DeployedModel.id of the `DeployedModel`. (Vertex AI makes this value available to your container code as the [`AIP_DEPLOYED_MODEL_ID` environment variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)" }, "livenessProbe": { "$ref": "GoogleCloudAiplatformV1beta1Probe", "description": "Immutable. Specification for Kubernetes liveness probe." }, "healthProbe": { "description": "Immutable. Specification for Kubernetes readiness probe.", "$ref": "GoogleCloudAiplatformV1beta1Probe" }, "startupProbe": { "$ref": "GoogleCloudAiplatformV1beta1Probe", "description": "Immutable. Specification for Kubernetes startup probe." }, "deploymentTimeout": { "format": "google-duration", "type": "string", "description": "Immutable. Deployment timeout. Limit for deployment timeout is 2 hours." }, "grpcPorts": { "type": "array", "description": "Immutable. List of ports to expose from the container. Vertex AI sends gRPC prediction requests that it receives to the first port on this list. Vertex AI also sends liveness and health checks to this port. If you do not specify this field, gRPC requests to the container will be disabled. Vertex AI does not use ports other than the first one listed. This field corresponds to the `ports` field of the Kubernetes Containers v1 core API.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Port" } } }, "type": "object", "description": "Specification of a container for serving predictions. Some fields in this message correspond to fields in the [Kubernetes Container v1 core specification](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.23/#container-v1-core).", "id": "GoogleCloudAiplatformV1beta1ModelContainerSpec" }, "GoogleCloudAiplatformV1beta1EvaluationSet": { "id": "GoogleCloudAiplatformV1beta1EvaluationSet", "description": "EvaluationSet is a collection of related EvaluationItems that are evaluated together.", "properties": { "metadata": { "type": "any", "description": "Optional. Metadata for the EvaluationSet." }, "name": { "type": "string", "description": "Identifier. The resource name of the EvaluationSet. Format: `projects/{project}/locations/{location}/evaluationSets/{evaluation_set}`" }, "agentConfigs": { "description": "Optional. Static configurations for each agent associated with the items in this set. Key: `agent_id` (matches the `author` field in `events`). Value: The static configuration of the agent.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AgentConfig" }, "type": "object" }, "updateTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Timestamp when this item was last updated." }, "evaluationItems": { "type": "array", "items": { "type": "string" }, "description": "Required. The EvaluationItems that are part of this dataset." }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this item was created." }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Optional. Customer-managed encryption key spec for this EvaluationSet. If set, this EvaluationSet and its sub-resources will be secured by this key." }, "displayName": { "description": "Required. The display name of the EvaluationSet.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagManagedDbConfig": { "properties": { "basic": { "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic", "deprecated": true, "description": "Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the Basic tier." }, "enterprise": { "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigEnterprise", "description": "Sets the RagManagedDb to the Enterprise tier.", "deprecated": true }, "unprovisioned": { "description": "Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the Unprovisioned tier.", "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned" }, "spanner": { "description": "Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the default mode (w/ Basic Tier) if not explicitly chosen.", "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner" }, "serverless": { "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless", "description": "Sets the backend to be the serverless mode offered by RAG Engine." }, "scaled": { "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled", "description": "Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the Scaled tier.", "deprecated": true } }, "description": "Configuration message for RagManagedDb used by RagEngine.", "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfig", "type": "object" }, "GenaiVertexV1beta1UrlContextResultDelta": { "type": "object", "properties": { "result": { "items": { "$ref": "GenaiVertexV1beta1UrlContextResultContentUrlContextResult" }, "type": "array" }, "isError": { "type": "boolean" } }, "id": "GenaiVertexV1beta1UrlContextResultDelta" }, "GoogleCloudAiplatformV1beta1UndeployIndexRequest": { "description": "Request message for IndexEndpointService.UndeployIndex.", "id": "GoogleCloudAiplatformV1beta1UndeployIndexRequest", "properties": { "deployedIndexId": { "type": "string", "description": "Required. The ID of the DeployedIndex to be undeployed from the IndexEndpoint." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSlice": { "description": "Definition of a slice.", "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSlice", "properties": { "dimension": { "type": "string", "description": "Output only. The dimension of the slice. Well-known dimensions are: * `annotationSpec`: This slice is on the test data that has either ground truth or prediction with AnnotationSpec.display_name equals to value. * `slice`: This slice is a user customized slice defined by its SliceSpec.", "readOnly": true }, "sliceSpec": { "readOnly": true, "description": "Output only. Specification for how the data was sliced.", "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpec" }, "value": { "readOnly": true, "type": "string", "description": "Output only. The value of the dimension in this slice." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimilaritySearchParams": { "id": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimilaritySearchParams", "type": "object", "description": "Parameters for semantic similarity search based retrieval.", "properties": { "searchQuery": { "description": "Required. Query to use for similarity search retrieval. If provided, then the parent ReasoningEngine must have ReasoningEngineContextSpec.MemoryBankConfig.SimilaritySearchConfig set.", "type": "string" }, "topK": { "description": "Optional. The maximum number of memories to return. The service may return fewer than this value. If unspecified, at most 3 memories will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "format": "int32", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStore": { "id": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStore", "properties": { "ragResources": { "type": "array", "description": "Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support.", "items": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRagResource" } }, "ragCorpora": { "items": { "type": "string" }, "description": "Optional. Deprecated. Please use rag_resources to specify the data source.", "type": "array", "deprecated": true }, "vectorDistanceThreshold": { "format": "double", "deprecated": true, "description": "Optional. Only return contexts with vector distance smaller than the threshold.", "type": "number" } }, "type": "object", "description": "The data source for Vertex RagStore." }, "GoogleCloudAiplatformV1beta1AskContextsRequest": { "properties": { "query": { "description": "Required. Single RAG retrieve query.", "$ref": "GoogleCloudAiplatformV1beta1RagQuery" }, "tools": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "type": "array", "description": "Optional. The tools to use for AskContexts." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1AskContextsRequest", "description": "Agentic Retrieval Ask API for RAG. Request message for VertexRagService.AskContexts." }, "GoogleCloudAiplatformV1beta1RuntimeArtifact": { "description": "The definition of a runtime artifact.", "properties": { "properties": { "type": "object", "description": "The properties of the artifact. Deprecated. Use RuntimeArtifact.metadata instead.", "deprecated": true, "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Value" } }, "name": { "type": "string", "description": "The name of an artifact." }, "type": { "$ref": "GoogleCloudAiplatformV1beta1ArtifactTypeSchema", "description": "The type of the artifact." }, "customProperties": { "deprecated": true, "type": "object", "description": "The custom properties of the artifact. Deprecated. Use RuntimeArtifact.metadata instead.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Value" } }, "metadata": { "type": "object", "description": "Properties of the Artifact.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "uri": { "type": "string", "description": "The URI of the artifact." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RuntimeArtifact" }, "GoogleCloudAiplatformV1beta1GenerationConfig": { "properties": { "frequencyPenalty": { "type": "number", "description": "Optional. Penalizes tokens based on their frequency in the generated text. A positive value helps to reduce the repetition of words and phrases. Valid values can range from [-2.0, 2.0].", "format": "float" }, "topP": { "format": "float", "description": "Optional. Specifies the nucleus sampling threshold. The model considers only the smallest set of tokens whose cumulative probability is at least `top_p`. This helps generate more diverse and less repetitive responses. For example, a `top_p` of 0.9 means the model considers tokens until the cumulative probability of the tokens to select from reaches 0.9. It's recommended to adjust either temperature or `top_p`, but not both.", "type": "number" }, "responseLogprobs": { "description": "Optional. If set to true, the log probabilities of the output tokens are returned. Log probabilities are the logarithm of the probability of a token appearing in the output. A higher log probability means the token is more likely to be generated. This can be useful for analyzing the model's confidence in its own output and for debugging.", "type": "boolean" }, "temperature": { "description": "Optional. Controls the randomness of the output. A higher temperature results in more creative and diverse responses, while a lower temperature makes the output more predictable and focused. The valid range is (0.0, 2.0].", "type": "number", "format": "float" }, "logprobs": { "description": "Optional. The number of top log probabilities to return for each token. This can be used to see which other tokens were considered likely candidates for a given position. A higher value will return more options, but it will also increase the size of the response.", "format": "int32", "type": "integer" }, "mediaResolution": { "description": "Optional. The token resolution at which input media content is sampled. This is used to control the trade-off between the quality of the response and the number of tokens used to represent the media. A higher resolution allows the model to perceive more detail, which can lead to a more nuanced response, but it will also use more tokens. This does not affect the image dimensions sent to the model.", "type": "string", "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "MEDIA_RESOLUTION_LOW", "MEDIA_RESOLUTION_MEDIUM", "MEDIA_RESOLUTION_HIGH" ], "enumDescriptions": [ "Media resolution has not been set.", "Media resolution set to low (64 tokens).", "Media resolution set to medium (256 tokens).", "Media resolution set to high (zoomed reframing with 256 tokens)." ] }, "responseFormat": { "description": "Optional. New response format field for the model to configure output formatting and delivery.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ResponseFormat" }, "type": "array" }, "seed": { "type": "integer", "format": "int32", "description": "Optional. A seed for the random number generator. By setting a seed, you can make the model's output mostly deterministic. For a given prompt and parameters (like temperature, top_p, etc.), the model will produce the same response every time. However, it's not a guaranteed absolute deterministic behavior. This is different from parameters like `temperature`, which control the *level* of randomness. `seed` ensures that the \"random\" choices the model makes are the same on every run, making it essential for testing and ensuring reproducible results." }, "audioTimestamp": { "description": "Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response.", "type": "boolean" }, "speechConfig": { "description": "Optional. The speech generation config.", "$ref": "GoogleCloudAiplatformV1beta1SpeechConfig" }, "audioTranscriptionConfig": { "description": "Optional. Configuration for audio transcription (speech recognition).", "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfig" }, "responseMimeType": { "description": "Optional. The IANA standard MIME type of the response. The model will generate output that conforms to this MIME type. Supported values include 'text/plain' (default) and 'application/json'. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. Deprecated: Use `response_format` instead.", "deprecated": true, "type": "string" }, "responseJsonSchema": { "description": "Optional. When this field is set, response_schema must be omitted and response_mime_type must be set to `application/json`. Deprecated: Use `response_format` instead.", "type": "any", "deprecated": true }, "candidateCount": { "description": "Optional. The number of candidate responses to generate. A higher `candidate_count` can provide more options to choose from, but it also consumes more resources. This can be useful for generating a variety of responses and selecting the best one.", "format": "int32", "type": "integer" }, "thinkingConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigThinkingConfig", "description": "Optional. Configuration for thinking features. An error will be returned if this field is set for models that don't support thinking." }, "maxOutputTokens": { "description": "Optional. The maximum number of tokens to generate in the response. A token is approximately four characters. The default value varies by model. This parameter can be used to control the length of the generated text and prevent overly long responses.", "type": "integer", "format": "int32" }, "topK": { "format": "float", "type": "number", "description": "Optional. Specifies the top-k sampling threshold. The model considers only the top k most probable tokens for the next token. This can be useful for generating more coherent and less random text. For example, a `top_k` of 40 means the model will choose the next word from the 40 most likely words." }, "imageConfig": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1ImageConfig", "description": "Optional. Config for image generation features. Deprecated: Use `response_format.image` instead." }, "presencePenalty": { "type": "number", "format": "float", "description": "Optional. Penalizes tokens that have already appeared in the generated text. A positive value encourages the model to generate more diverse and less repetitive text. Valid values can range from [-2.0, 2.0]." }, "responseModalities": { "description": "Optional. The modalities of the response. The model will generate a response that includes all the specified modalities. For example, if this is set to `[TEXT, IMAGE]`, the response will include both text and an image.", "items": { "enumDescriptions": [ "Unspecified modality. Will be processed as text.", "Text modality.", "Image modality.", "Audio modality.", "Video modality." ], "enum": [ "MODALITY_UNSPECIFIED", "TEXT", "IMAGE", "AUDIO", "VIDEO" ], "type": "string" }, "type": "array" }, "modelConfig": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigModelConfig", "description": "Optional. Config for model selection." }, "responseSchema": { "description": "Optional. Lets you to specify a schema for the model's response, ensuring that the output conforms to a particular structure. This is useful for generating structured data such as JSON. The schema is a subset of the [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema) object. When this field is set, you must also set the `response_mime_type` to `application/json`. Deprecated: Use `response_format` instead.", "$ref": "GoogleCloudAiplatformV1beta1Schema", "deprecated": true }, "translationConfig": { "$ref": "GoogleCloudAiplatformV1beta1TranslationConfig", "description": "Optional. Config for translation." }, "routingConfig": { "description": "Optional. Routing configuration.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig" }, "stopSequences": { "type": "array", "description": "Optional. A list of character sequences that will stop the model from generating further tokens. If a stop sequence is generated, the output will end at that point. This is useful for controlling the length and structure of the output. For example, you can use [\"\\n\", \"###\"] to stop generation at a new line or a specific marker.", "items": { "type": "string" } }, "enableAffectiveDialog": { "type": "boolean", "description": "Optional. If enabled, the model will detect emotions and adapt its responses accordingly. For example, if the model detects that the user is frustrated, it may provide a more empathetic response." } }, "id": "GoogleCloudAiplatformV1beta1GenerationConfig", "description": "Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output.", "type": "object" }, "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInstance": { "description": "Spec for tool parameter key match instance.", "id": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInstance", "properties": { "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "reference": { "description": "Required. Ground truth used to compare against the prediction.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfig": { "properties": { "distanceMeasureType": { "type": "string", "enumDescriptions": [ "Should not be set.", "Euclidean (L_2) Distance.", "Cosine Distance. Defined as 1 - cosine similarity. We strongly suggest using DOT_PRODUCT_DISTANCE + UNIT_L2_NORM instead of COSINE distance. Our algorithms have been more optimized for DOT_PRODUCT distance which, when combined with UNIT_L2_NORM, is mathematically equivalent to COSINE distance and results in the same ranking.", "Dot Product Distance. Defined as a negative of the dot product." ], "description": "Optional. The distance measure used in nearest neighbor search.", "enum": [ "DISTANCE_MEASURE_TYPE_UNSPECIFIED", "SQUARED_L2_DISTANCE", "COSINE_DISTANCE", "DOT_PRODUCT_DISTANCE" ] }, "crowdingColumn": { "description": "Optional. Column of crowding. This column contains crowding attribute which is a constraint on a neighbor list produced by FeatureOnlineStoreService.SearchNearestEntities to diversify search results. If NearestNeighborQuery.per_crowding_attribute_neighbor_count is set to K in SearchNearestEntitiesRequest, it's guaranteed that no more than K entities of the same crowding attribute are returned in the response.", "type": "string" }, "filterColumns": { "description": "Optional. Columns of features that're used to filter vector search results.", "type": "array", "items": { "type": "string" } }, "treeAhConfig": { "description": "Optional. Configuration options for the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigTreeAHConfig" }, "embeddingDimension": { "description": "Optional. The number of dimensions of the input embedding.", "type": "integer", "format": "int32" }, "bruteForceConfig": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigBruteForceConfig", "description": "Optional. Configuration options for using brute force search, which simply implements the standard linear search in the database for each query. It is primarily meant for benchmarking and to generate the ground truth for approximate search." }, "embeddingColumn": { "type": "string", "description": "Optional. Column of embedding. This column contains the source data to create index for vector search. embedding_column must be set when using vector search." } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfig", "type": "object", "deprecated": true, "description": "Deprecated. Use IndexConfig instead." }, "GoogleCloudAiplatformV1beta1PredefinedMetricSpec": { "type": "object", "description": "The spec for a pre-defined metric.", "id": "GoogleCloudAiplatformV1beta1PredefinedMetricSpec", "properties": { "metricSpecName": { "description": "Required. The name of a pre-defined metric, such as \"instruction_following_v1\" or \"text_quality_v1\".", "type": "string" }, "stepAutoraterConfigs": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig" }, "description": "Optional. Per-step autorater overrides for this predefined metric. Keys are evaluation stage names (snake_case). Valid keys: \"intent_extraction\", \"rubric_generation\", \"rubric_validation\". Unknown keys return INVALID_ARGUMENT.", "type": "object" }, "metricSpecParameters": { "description": "Optional. The parameters needed to run the pre-defined metric.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } } }, "CloudAiLargeModelsVisionHumanPose": { "type": "object", "id": "CloudAiLargeModelsVisionHumanPose", "properties": { "perfMeshGcsUri": { "description": "GCS URI of the performance mesh to condition video generation.", "type": "string" }, "bodyLandmarksGcsUri": { "deprecated": true, "description": "GCS URI of the human pose video to condition video generation.", "type": "string" }, "faceLandmarksGcsUri": { "type": "string", "deprecated": true, "description": "GCS URI of the face landmarks video to condition video generation." } } }, "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfigWeightedRewardConfig": { "description": "Reward function configuration with a weight. The weight is used to combine the reward with other rewards.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfigWeightedRewardConfig", "properties": { "rewardConfig": { "$ref": "GoogleCloudAiplatformV1beta1SingleReinforcementTuningRewardConfig", "description": "Single reward configuration." }, "weight": { "type": "number", "format": "float", "description": "How much this single reward contributes to the total overall reward. Total reward is a linear combination of single rewards with their corresponding weights, i.e., ``` total_reward = ( weight_a * reward_a + weight_b * reward_b + ... ) / (weight_a + weight_b + ...) ```" } } }, "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInstance": { "properties": { "baselinePrediction": { "description": "Required. Output of the baseline model.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the candidate model." }, "context": { "type": "string", "description": "Required. Text to answer the question." }, "instruction": { "description": "Required. Question Answering prompt for LLM.", "type": "string" }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" } }, "description": "Spec for pairwise question answering quality instance.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInstance" }, "GoogleCloudAiplatformV1beta1SuggestTrialsRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SuggestTrialsRequest", "description": "Request message for VizierService.SuggestTrials.", "properties": { "suggestionCount": { "format": "int32", "type": "integer", "description": "Required. The number of suggestions requested. It must be positive." }, "clientId": { "description": "Required. The identifier of the client that is requesting the suggestion. If multiple SuggestTrialsRequests have the same `client_id`, the service will return the identical suggested Trial if the Trial is pending, and provide a new Trial if the last suggested Trial was completed.", "type": "string" }, "contexts": { "description": "Optional. This allows you to specify the \"context\" for a Trial; a context is a slice (a subspace) of the search space. Typical uses for contexts: 1) You are using Vizier to tune a server for best performance, but there's a strong weekly cycle. The context specifies the day-of-week. This allows Tuesday to generalize from Wednesday without assuming that everything is identical. 2) Imagine you're optimizing some medical treatment for people. As they walk in the door, you know certain facts about them (e.g. sex, weight, height, blood-pressure). Put that information in the context, and Vizier will adapt its suggestions to the patient. 3) You want to do a fair A/B test efficiently. Specify the \"A\" and \"B\" conditions as contexts, and Vizier will generalize between \"A\" and \"B\" conditions. If they are similar, this will allow Vizier to converge to the optimum faster than if \"A\" and \"B\" were separate Studies. NOTE: You can also enter contexts as REQUESTED Trials, e.g. via the CreateTrial() RPC; that's the asynchronous option where you don't need a close association between contexts and suggestions. NOTE: All the Parameters you set in a context MUST be defined in the Study. NOTE: You must supply 0 or $suggestion_count contexts. If you don't supply any contexts, Vizier will make suggestions from the full search space specified in the StudySpec; if you supply a full set of context, each suggestion will match the corresponding context. NOTE: A Context with no features set matches anything, and allows suggestions from the full search space. NOTE: Contexts MUST lie within the search space specified in the StudySpec. It's an error if they don't. NOTE: Contexts preferentially match ACTIVE then REQUESTED trials before new suggestions are generated. NOTE: Generation of suggestions involves a match between a Context and (optionally) a REQUESTED trial; if that match is not fully specified, a suggestion will be geneated in the merged subspace.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrialContext" } } } }, "GoogleCloudAiplatformV1beta1OutputFieldSpec": { "properties": { "fieldName": { "description": "Required. The name of this field in the generated synthetic data, such as \"email_subject\" or \"customer_review\".", "type": "string" }, "fieldType": { "description": "Optional. The data type of the field. Defaults to CONTENT if not set.", "enumDescriptions": [ "The field type is not specified. Defaults to CONTENT.", "The field can contain any type of content, including text, images, and audio.", "The field contains only text.", "The field contains image data.", "The field contains audio data." ], "type": "string", "enum": [ "FIELD_TYPE_UNSPECIFIED", "CONTENT", "TEXT", "IMAGE", "AUDIO" ] }, "guidance": { "description": "Optional. Specific instructions for the large language model on how to generate content for this particular field. While the LLM can sometimes infer content from the field name, providing explicit guidance is preferred. For example, for a field named \"review\", the guidance could be \"A positive review about a coffee maker.\"", "type": "string" } }, "description": "Specifies the properties of a single field that are included in each generated synthetic example. This helps the model understand what kind of data to generate for each field.", "id": "GoogleCloudAiplatformV1beta1OutputFieldSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1MetricxResult": { "type": "object", "description": "Spec for MetricX result - calculates the MetricX score for the given instance using the version specified in the spec.", "id": "GoogleCloudAiplatformV1beta1MetricxResult", "properties": { "score": { "format": "float", "type": "number", "readOnly": true, "description": "Output only. MetricX score. Range depends on version." } } }, "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsResponse": { "properties": { "generatedRubrics": { "description": "Output only. A list of generated rubrics.", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Rubric" } } }, "id": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsResponse", "type": "object", "description": "Response message for EvaluationService.GenerateInstanceRubrics." }, "GoogleCloudAiplatformV1beta1BigQuerySource": { "properties": { "inputUri": { "description": "Required. BigQuery URI to a table, up to 2000 characters long. Accepted forms: * BigQuery path. For example: `bq://projectId.bqDatasetId.bqTableId`.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1BigQuerySource", "description": "The BigQuery location for the input content." }, "GoogleCloudAiplatformV1beta1AutoraterConfig": { "description": "The configs for autorater. This is applicable to both EvaluateInstances and EvaluateDataset.", "properties": { "generationConfig": { "description": "Optional. Configuration options for model generation and outputs.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" }, "samplingCount": { "type": "integer", "description": "Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32.", "format": "int32" }, "autoraterModel": { "type": "string", "description": "Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`" }, "flipEnabled": { "description": "Optional. Default is true. Whether to flip the candidate and baseline responses. This is only applicable to the pairwise metric. If enabled, also provide PairwiseMetricSpec.candidate_response_field_name and PairwiseMetricSpec.baseline_response_field_name. When rendering PairwiseMetricSpec.metric_prompt_template, the candidate and baseline fields will be flipped for half of the samples to reduce bias.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1AutoraterConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchCreateFeaturesResponse": { "description": "Response message for FeaturestoreService.BatchCreateFeatures.", "id": "GoogleCloudAiplatformV1beta1BatchCreateFeaturesResponse", "properties": { "features": { "type": "array", "description": "The Features created.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Feature" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob": { "description": "Represents a job that runs periodically to monitor the deployed models in an endpoint. It will analyze the logged training & prediction data to detect any abnormal behaviors.", "id": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob", "properties": { "state": { "description": "Output only. The detailed state of the monitoring job. When the job is still creating, the state will be 'PENDING'. Once the job is successfully created, the state will be 'RUNNING'. Pause the job, the state will be 'PAUSED'. Resume the job, the state will return to 'RUNNING'.", "type": "string", "readOnly": true, "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ] }, "loggingSamplingStrategy": { "description": "Required. Sample Strategy for logging.", "$ref": "GoogleCloudAiplatformV1beta1SamplingStrategy" }, "modelDeploymentMonitoringObjectiveConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringObjectiveConfig" }, "description": "Required. The config for monitoring objectives. This is a per DeployedModel config. Each DeployedModel needs to be configured separately.", "type": "array" }, "error": { "readOnly": true, "description": "Output only. Only populated when the job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "$ref": "GoogleRpcStatus" }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "logTtl": { "description": "The TTL of BigQuery tables in user projects which stores logs. A day is the basic unit of the TTL and we take the ceil of TTL/86400(a day). e.g. { second: 3600} indicates ttl = 1 day.", "format": "google-duration", "type": "string" }, "scheduleState": { "readOnly": true, "enumDescriptions": [ "Unspecified state.", "The pipeline is picked up and wait to run.", "The pipeline is offline and will be scheduled for next run.", "The pipeline is running." ], "description": "Output only. Schedule state when the monitoring job is in Running state.", "type": "string", "enum": [ "MONITORING_SCHEDULE_STATE_UNSPECIFIED", "PENDING", "OFFLINE", "RUNNING" ] }, "endpoint": { "description": "Required. Endpoint resource name. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" }, "samplePredictInstance": { "description": "Sample Predict instance, same format as PredictRequest.instances, this can be set as a replacement of ModelDeploymentMonitoringJob.predict_instance_schema_uri. If not set, we will generate predict schema from collected predict requests.", "type": "any" }, "predictInstanceSchemaUri": { "type": "string", "description": "YAML schema file uri describing the format of a single instance, which are given to format this Endpoint's prediction (and explanation). If not set, we will generate predict schema from collected predict requests." }, "statsAnomaliesBaseDirectory": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "Stats anomalies base folder path." }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when this ModelDeploymentMonitoringJob was created." }, "modelDeploymentMonitoringScheduleConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringScheduleConfig", "description": "Required. Schedule config for running the monitoring job." }, "updateTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this ModelDeploymentMonitoringJob was updated most recently.", "type": "string" }, "labels": { "description": "The labels with user-defined metadata to organize your ModelDeploymentMonitoringJob. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "additionalProperties": { "type": "string" }, "type": "object" }, "analysisInstanceSchemaUri": { "description": "YAML schema file uri describing the format of a single instance that you want Tensorflow Data Validation (TFDV) to analyze. If this field is empty, all the feature data types are inferred from predict_instance_schema_uri, meaning that TFDV will use the data in the exact format(data type) as prediction request/response. If there are any data type differences between predict instance and TFDV instance, this field can be used to override the schema. For models trained with Vertex AI, this field must be set as all the fields in predict instance formatted as string.", "type": "string" }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "nextScheduleTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this monitoring pipeline will be scheduled to run for the next round.", "type": "string" }, "modelMonitoringAlertConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfig", "description": "Alert config for model monitoring." }, "bigqueryTables": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringBigQueryTable" }, "readOnly": true, "type": "array", "description": "Output only. The created bigquery tables for the job under customer project. Customer could do their own query & analysis. There could be 4 log tables in maximum: 1. Training data logging predict request/response 2. Serving data logging predict request/response" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key spec for a ModelDeploymentMonitoringJob. If set, this ModelDeploymentMonitoringJob and all sub-resources of this ModelDeploymentMonitoringJob will be secured by this key." }, "name": { "type": "string", "description": "Output only. Resource name of a ModelDeploymentMonitoringJob.", "readOnly": true }, "displayName": { "description": "Required. The user-defined name of the ModelDeploymentMonitoringJob. The name can be up to 128 characters long and can consist of any UTF-8 characters. Display name of a ModelDeploymentMonitoringJob.", "type": "string" }, "latestMonitoringPipelineMetadata": { "description": "Output only. Latest triggered monitoring pipeline metadata.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJobLatestMonitoringPipelineMetadata" }, "enableMonitoringPipelineLogs": { "description": "If true, the scheduled monitoring pipeline logs are sent to Google Cloud Logging, including pipeline status and anomalies detected. Please note the logs incur cost, which are subject to [Cloud Logging pricing](https://cloud.google.com/logging#pricing).", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExternalApi": { "description": "Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec.", "id": "GoogleCloudAiplatformV1beta1ExternalApi", "properties": { "apiSpec": { "enumDescriptions": [ "Unspecified API spec. This value should not be used.", "Simple search API spec.", "Elastic search API spec." ], "type": "string", "description": "The API spec that the external API implements.", "enum": [ "API_SPEC_UNSPECIFIED", "SIMPLE_SEARCH", "ELASTIC_SEARCH" ] }, "elasticSearchParams": { "$ref": "GoogleCloudAiplatformV1beta1ExternalApiElasticSearchParams", "description": "Parameters for the elastic search API." }, "authConfig": { "description": "The authentication config to access the API.", "$ref": "GoogleCloudAiplatformV1beta1AuthConfig" }, "simpleSearchParams": { "description": "Parameters for the simple search API.", "$ref": "GoogleCloudAiplatformV1beta1ExternalApiSimpleSearchParams" }, "endpoint": { "type": "string", "description": "The endpoint of the external API. The system will call the API at this endpoint to retrieve the data for grounding. Example: https://acme.com:443/search" }, "apiAuth": { "$ref": "GoogleCloudAiplatformV1beta1ApiAuth", "deprecated": true, "description": "The authentication config to access the API. Deprecated. Please use auth_config instead." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AskContextsResponse": { "description": "Response message for VertexRagService.AskContexts.", "properties": { "response": { "type": "string", "description": "The Retrieval Response." }, "contexts": { "$ref": "GoogleCloudAiplatformV1beta1RagContexts", "description": "The contexts of the query." } }, "id": "GoogleCloudAiplatformV1beta1AskContextsResponse", "type": "object" }, "CloudAiLargeModelsVisionRaiInfoDetectedLabelsBoundingBox": { "description": "An integer bounding box of original pixels of the image for the detected labels.", "type": "object", "id": "CloudAiLargeModelsVisionRaiInfoDetectedLabelsBoundingBox", "properties": { "y1": { "type": "integer", "description": "The Y coordinate of the top-left corner, in pixels.", "format": "int32" }, "x1": { "description": "The X coordinate of the top-left corner, in pixels.", "type": "integer", "format": "int32" }, "x2": { "format": "int32", "type": "integer", "description": "The X coordinate of the bottom-right corner, in pixels." }, "y2": { "format": "int32", "description": "The Y coordinate of the bottom-right corner, in pixels.", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1LossAnalysisResult": { "id": "GoogleCloudAiplatformV1beta1LossAnalysisResult", "type": "object", "description": "The top-level result for loss analysis, stored within an EvalSet.", "properties": { "analysisTime": { "description": "The timestamp when this analysis was performed.", "format": "google-datetime", "type": "string" }, "clusters": { "type": "array", "description": "The list of identified loss clusters.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LossCluster" } }, "config": { "description": "The configuration used to generate this analysis.", "$ref": "GoogleCloudAiplatformV1beta1LossAnalysisConfig" } } }, "GenaiVertexV1beta1ThoughtStep": { "properties": { "summary": { "items": { "$ref": "GenaiVertexV1beta1Content" }, "description": "A summary of the thought.", "type": "array" }, "signature": { "type": "string", "format": "byte", "description": "A signature hash for backend validation." } }, "id": "GenaiVertexV1beta1ThoughtStep", "description": "A thought step.", "type": "object" }, "GoogleCloudAiplatformV1beta1DeployIndexOperationMetadata": { "type": "object", "properties": { "deployedIndexId": { "description": "The unique index id specified by user", "type": "string" }, "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "description": "Runtime operation information for IndexEndpointService.DeployIndex.", "id": "GoogleCloudAiplatformV1beta1DeployIndexOperationMetadata" }, "GoogleCloudAiplatformV1beta1ListExampleStoresResponse": { "type": "object", "properties": { "exampleStores": { "description": "List of ExampleStore in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ExampleStore" } }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListExampleStoresRequest.page_token to obtain that page.", "type": "string" } }, "description": "Response message for ExampleStoreService.ListExampleStores.", "id": "GoogleCloudAiplatformV1beta1ListExampleStoresResponse" }, "GoogleCloudAiplatformV1beta1TaskEventData": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TaskEventData", "properties": { "metadataChange": { "$ref": "GoogleCloudAiplatformV1beta1TaskMetadataChange", "description": "Optional. A change to the task's metadata." }, "statusDetailsChange": { "description": "Optional. A change to the framework-specific status details.", "$ref": "GoogleCloudAiplatformV1beta1TaskStatusDetailsChange" }, "outputChange": { "description": "Optional. A change to the task's final outputs.", "$ref": "GoogleCloudAiplatformV1beta1TaskOutputChange" }, "stateChange": { "description": "Optional. A change in the task's state.", "$ref": "GoogleCloudAiplatformV1beta1TaskStateChange" } }, "description": "Data for a TaskEvent." }, "GoogleCloudAiplatformV1beta1ExactMatchInstance": { "description": "Spec for exact match instance.", "properties": { "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" }, "reference": { "type": "string", "description": "Required. Ground truth used to compare against the prediction." } }, "id": "GoogleCloudAiplatformV1beta1ExactMatchInstance", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateTensorboardRunRequest": { "description": "Request message for TensorboardService.CreateTensorboardRun.", "type": "object", "properties": { "tensorboardRun": { "description": "Required. The TensorboardRun to create.", "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "tensorboardRunId": { "description": "Required. The ID to use for the Tensorboard run, which becomes the final component of the Tensorboard run's resource name. This value should be 1-128 characters, and valid characters are `/a-z-/`.", "type": "string" }, "parent": { "description": "Required. The resource name of the TensorboardExperiment to create the TensorboardRun in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1CreateTensorboardRunRequest" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextExtractionInputs": { "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextExtractionInputs" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTabularClassificationPredictionResult": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTabularClassificationPredictionResult", "type": "object", "properties": { "scores": { "items": { "format": "float", "type": "number" }, "description": "The model's confidence in each class being correct, higher value means higher confidence. The N-th score corresponds to the N-th class in classes.", "type": "array" }, "classes": { "description": "The name of the classes being classified, contains all possible values of the target column.", "items": { "type": "string" }, "type": "array" } }, "description": "Prediction output format for Tabular Classification." }, "GoogleCloudAiplatformV1beta1PairwiseMetricSpec": { "description": "Spec for pairwise metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PairwiseMetricSpec", "properties": { "metricPromptTemplate": { "type": "string", "description": "Required. Metric prompt template for pairwise metric." }, "baselineResponseFieldName": { "type": "string", "description": "Optional. The field name of the baseline response." }, "systemInstruction": { "type": "string", "description": "Optional. System instructions for pairwise metric." }, "customOutputFormatConfig": { "description": "Optional. CustomOutputFormatConfig allows customization of metric output. When this config is set, the default output is replaced with the raw output string. If a custom format is chosen, the `pairwise_choice` and `explanation` fields in the corresponding metric result will be empty.", "$ref": "GoogleCloudAiplatformV1beta1CustomOutputFormatConfig" }, "candidateResponseFieldName": { "type": "string", "description": "Optional. The field name of the candidate response." } } }, "GoogleCloudAiplatformV1beta1StoredContentsExampleParameters": { "description": "The metadata filters that will be used to search StoredContentsExamples. If a field is unspecified, then no filtering for that field will be applied", "properties": { "contentSearchKey": { "description": "The chat history to use to generate the search key for retrieval.", "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleParametersContentSearchKey" }, "functionNames": { "$ref": "GoogleCloudAiplatformV1beta1ExamplesArrayFilter", "description": "Optional. The function names for filtering." }, "searchKey": { "type": "string", "description": "The exact search key to use for retrieval." } }, "id": "GoogleCloudAiplatformV1beta1StoredContentsExampleParameters", "type": "object" }, "GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats": { "description": "Statistics computed for datasets used for preference optimization.", "type": "object", "properties": { "tuningStepCount": { "readOnly": true, "description": "Output only. Number of tuning steps for this Tuning Job.", "type": "string", "format": "int64" }, "userInputTokenDistribution": { "readOnly": true, "description": "Output only. Dataset distributions for the user input tokens.", "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution" }, "scoreVariancePerExampleDistribution": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "description": "Output only. Dataset distributions for scores variance per example.", "readOnly": true }, "scoresDistribution": { "readOnly": true, "description": "Output only. Dataset distributions for scores.", "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution" }, "userOutputTokenDistribution": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "readOnly": true, "description": "Output only. Dataset distributions for the user output tokens." }, "userDatasetExamples": { "type": "array", "readOnly": true, "description": "Output only. Sample user examples in the training dataset.", "items": { "$ref": "GoogleCloudAiplatformV1beta1GeminiPreferenceExample" } }, "droppedExampleIndices": { "readOnly": true, "type": "array", "description": "Output only. A partial sample of the indices (starting from 1) of the dropped examples.", "items": { "type": "string", "format": "int64" } }, "tuningDatasetExampleCount": { "readOnly": true, "type": "string", "description": "Output only. Number of examples in the tuning dataset.", "format": "int64" }, "droppedExampleReasons": { "type": "array", "readOnly": true, "items": { "type": "string" }, "description": "Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped." }, "totalBillableTokenCount": { "readOnly": true, "type": "string", "description": "Output only. Number of billable tokens in the tuning dataset.", "format": "int64" } }, "id": "GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats" }, "GoogleCloudAiplatformV1beta1ListStudiesResponse": { "type": "object", "description": "Response message for VizierService.ListStudies.", "id": "GoogleCloudAiplatformV1beta1ListStudiesResponse", "properties": { "nextPageToken": { "type": "string", "description": "Passes this token as the `page_token` field of the request for a subsequent call. If this field is omitted, there are no subsequent pages." }, "studies": { "type": "array", "description": "The studies associated with the project.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Study" } } } }, "GoogleCloudAiplatformV1beta1ToolGoogleSearchSearchTypes": { "properties": { "webSearch": { "$ref": "GoogleCloudAiplatformV1beta1ToolGoogleSearchWebSearch", "description": "Optional. Setting this field enables web search. Only text results are returned." }, "imageSearch": { "description": "Optional. Setting this field enables image search. Image bytes are returned.", "$ref": "GoogleCloudAiplatformV1beta1ToolGoogleSearchImageSearch" } }, "description": "Different types of search that can be enabled on the GoogleSearch tool.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolGoogleSearchSearchTypes" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedVertexVectorSearch": { "properties": { "collectionName": { "description": "Output only. The resource name of the Vector Search 2.0 Collection that RAG Created for the corpus. Only populated after the corpus is successfully created. Format: `projects/{project}/locations/{location}/collections/{collection_id}`", "readOnly": true, "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedVertexVectorSearch", "description": "The config for the RAG-managed Vertex Vector Search 2.0.", "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailCustomJobDetail": { "description": "The detailed info for a custom job executor.", "id": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailCustomJobDetail", "properties": { "job": { "description": "Output only. The name of the CustomJob.", "readOnly": true, "type": "string" }, "failedJobs": { "items": { "type": "string" }, "type": "array", "description": "Output only. The names of the previously failed CustomJob. The list includes the all attempts in chronological order.", "readOnly": true } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextArrayTransformation": { "properties": { "columnName": { "type": "string" } }, "type": "object", "description": "Treats the column as text array and performs following transformation functions. * Concatenate all text values in the array into a single text value using a space (\" \") as a delimiter, and then treat the result as a single text value. Apply the transformations for Text columns. * Empty arrays treated as an empty text.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextArrayTransformation" }, "GoogleLearningVertexApiInteractionsV1beta1CreateVoiceRequest": { "id": "GoogleLearningVertexApiInteractionsV1beta1CreateVoiceRequest", "type": "object", "properties": { "voice": { "$ref": "GenaiVertexV1beta1Voice", "description": "Required. The voice to create. `voice.model` is optional; if omitted, the service selects the default voice creation model. Output-only fields on `Voice` (`id`, `key`, `expire_time`, `usage`) are ignored if set." }, "store": { "type": "boolean", "description": "Optional. Whether the created voice is persisted and managed by Google. * When `true`, Google stores the voice and returns `Voice.id` (for example, `voice_abc123def456`), which can be managed via `GetVoice`, `ListVoices`, and `DeleteVoice` and referenced by ID in synthesis requests. Stored voices expire after 1 year of inactivity; using a stored voice in speech synthesis or as a `base_voice` in `CreateVoice` extends its `expire_time`. Projects are subject to a maximum active stored voice quota; exceeding the quota returns `RESOURCE_EXHAUSTED`. * When `false` (default), the voice is not stored by Google and `Voice.key` (for example, `voicekey_...`) is returned for client-side storage and synthesis. Optional discovery metadata fields on `voice` are not persisted or returned when `store` is `false`. * Required to be `true` when `voice.type` is `\"prompted\"` (otherwise fails with `INVALID_ARGUMENT`)." } }, "description": "Request message for `VoicesService.CreateVoice`." }, "GoogleCloudAiplatformV1beta1PreferenceOptimizationHyperParameters": { "id": "GoogleCloudAiplatformV1beta1PreferenceOptimizationHyperParameters", "description": "Hyperparameters for Preference Optimization.", "type": "object", "properties": { "learningRateMultiplier": { "description": "Optional. Multiplier for adjusting the default learning rate.", "format": "double", "type": "number" }, "beta": { "format": "double", "type": "number", "description": "Optional. Weight for KL Divergence regularization." }, "epochCount": { "description": "Optional. Number of complete passes the model makes over the entire training dataset during training.", "type": "string", "format": "int64" }, "adapterSize": { "description": "Optional. Adapter size for preference optimization.", "type": "string", "enumDescriptions": [ "Adapter size is unspecified.", "Adapter size 1.", "Adapter size 2.", "Adapter size 4.", "Adapter size 8.", "Adapter size 16.", "Adapter size 32." ], "enum": [ "ADAPTER_SIZE_UNSPECIFIED", "ADAPTER_SIZE_ONE", "ADAPTER_SIZE_TWO", "ADAPTER_SIZE_FOUR", "ADAPTER_SIZE_EIGHT", "ADAPTER_SIZE_SIXTEEN", "ADAPTER_SIZE_THIRTY_TWO" ] } } }, "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage": { "description": "Represents a single message in a conversation, compliant with the A2A specification.", "properties": { "metadata": { "type": "object", "description": "Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "parts": { "type": "array", "description": "Required. The content parts that make up the message.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2APart" } }, "role": { "description": "Required. The role of the sender of the message.", "enum": [ "ROLE_UNSPECIFIED", "USER", "AGENT" ], "enumDescriptions": [ "The role is unspecified.", "The message is from the client to the server.", "The message is from the server to the client." ], "type": "string" }, "messageId": { "description": "Required. The unique identifier of the message.", "type": "string" }, "extensions": { "items": { "type": "string" }, "description": "Optional. A2A protocol extensions associated with the message.", "type": "array" }, "referenceTaskIds": { "items": { "type": "string" }, "description": "Optional. The IDs of other tasks referenced by this message.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage", "type": "object" }, "GoogleCloudAiplatformV1beta1XmanagerInstance": { "description": "XmanagerInstance represents a managed Xmanager on Cloud deployment.", "id": "GoogleCloudAiplatformV1beta1XmanagerInstance", "properties": { "subnetwork": { "description": "Required. Immutable. A subnet in `network`. Format: projects/{project}/regions/{region}/subnetworks/{subnetwork}", "type": "string" }, "updateTime": { "type": "string", "description": "Output only. Last update timestamp.", "readOnly": true, "format": "google-datetime" }, "apiEndpoint": { "description": "Output only. gRPC API endpoint for Experiment State Server (ESS).", "type": "string", "readOnly": true }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of the XmanagerInstance. Format: projects/{project}/locations/{location}/xmanagerInstances/{xmanager_instance}" }, "state": { "readOnly": true, "description": "Output only. The current state of the XmanagerInstance.", "enum": [ "STATE_UNSPECIFIED", "STATE_PROVISIONING", "STATE_RUNNING", "STATE_DELETING", "STATE_ERROR" ], "enumDescriptions": [ "State is unspecified.", "Tenant infrastructure being created.", "Available for cluster registration and use.", "Deprovisioning is in progress.", "Provisioning or operation failed." ], "type": "string" }, "registeredClusters": { "type": "array", "description": "Output only. The resource names of the ModelDevelopmentClusters registered with this instance.", "readOnly": true, "items": { "type": "string" } }, "xprofConfig": { "description": "Optional. If set, the XmanagerInstance will be set up for managed XProf.", "$ref": "GoogleCloudAiplatformV1beta1XprofConfig" }, "createTime": { "description": "Output only. Creation timestamp.", "format": "google-datetime", "readOnly": true, "type": "string" }, "uiEndpoint": { "description": "Output only. UI endpoint for Xmanager.", "type": "string", "readOnly": true }, "network": { "type": "string", "description": "Required. Immutable. The VPC network in the consumer project. Format: projects/{project}/global/networks/{network}" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListTensorboardRunsResponse": { "id": "GoogleCloudAiplatformV1beta1ListTensorboardRunsResponse", "description": "Response message for TensorboardService.ListTensorboardRuns.", "type": "object", "properties": { "nextPageToken": { "description": "A token, which can be sent as ListTensorboardRunsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "tensorboardRuns": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "description": "The TensorboardRuns mathching the request." } } }, "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsResponse": { "id": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsResponse", "description": "Response message for TensorboardService.BatchCreateTensorboardRuns.", "properties": { "tensorboardRuns": { "type": "array", "description": "The created TensorboardRuns.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardRun" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsRequest": { "id": "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsRequest", "description": "Request message for A2ATaskRecordService.AppendA2ATaskRecordEvents.", "type": "object", "properties": { "events": { "description": "Required. The events to append to the task.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordEvent" }, "type": "array" }, "generation": { "description": "Required. The current task generation.", "format": "int64", "type": "string" } } }, "GoogleCloudAiplatformV1beta1StreamingPredictRequest": { "description": "Request message for PredictionService.StreamingPredict. The first message must contain endpoint field and optionally input. The subsequent messages must contain input.", "properties": { "inputs": { "description": "The prediction input.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" } }, "parameters": { "$ref": "GoogleCloudAiplatformV1beta1Tensor", "description": "The parameters that govern the prediction." } }, "id": "GoogleCloudAiplatformV1beta1StreamingPredictRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestVertexSessionSource": { "description": "Defines an Agent Engine Session from which to generate the memories. If `scope` is not provided, the scope will be extracted from the Session (i.e. {\"user_id\": sesison.user_id}).", "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestVertexSessionSource", "properties": { "session": { "description": "Required. The resource name of the Session to generate memories for. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`", "type": "string" }, "startTime": { "type": "string", "description": "Optional. Time range to define which session events should be used to generate memories. Start time (inclusive) of the time range. If not set, the start time is unbounded.", "format": "google-datetime" }, "endTime": { "format": "google-datetime", "description": "Optional. End time (exclusive) of the time range. If not set, the end time is unbounded.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairListFeatureNameValuePair": { "id": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairListFeatureNameValuePair", "properties": { "name": { "type": "string", "description": "Feature short name." }, "value": { "description": "Feature value.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValue" } }, "description": "Feature name & value pair.", "type": "object" }, "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDataset": { "type": "object", "id": "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDataset", "description": "Represents one Dataset in datalabeling.googleapis.com.", "properties": { "dataLabelingAnnotatedDatasets": { "description": "The migratable AnnotatedDataset in datalabeling.googleapis.com belongs to the data labeling Dataset.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDatasetDataLabelingAnnotatedDataset" }, "type": "array" }, "datasetDisplayName": { "type": "string", "description": "The Dataset's display name in datalabeling.googleapis.com." }, "dataset": { "type": "string", "description": "Full resource name of data labeling Dataset. Format: `projects/{project}/datasets/{dataset}`." } } }, "GoogleTypeDate": { "id": "GoogleTypeDate", "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "properties": { "month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "format": "int32", "type": "integer" }, "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer", "format": "int32" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32", "type": "integer" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobMetadata", "properties": { "backingHyperparameterTuningJob": { "description": "The resource name of the HyperparameterTuningJob that has been created to carry out this HyperparameterTuning task.", "type": "string" }, "bestTrialBackingCustomJob": { "description": "The resource name of the CustomJob that has been created to run the best Trial of this HyperparameterTuning task.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SingleReinforcementTuningRewardConfig": { "properties": { "cloudRunRewardScorer": { "description": "ReinforcementTuningCloudRunRewardScorer is used to score parsed responses by calling a Cloud Run service.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningCloudRunRewardScorer" }, "stringMatchRewardScorer": { "description": "ReinforcementTuningStringMatchRewardScorer is used to score parsed responses for simple string matching use cases against reference answers.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorer" }, "codeExecutionRewardScorer": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningCodeExecutionRewardScorer", "description": "ReinforcementTuningCodeExecutionRewardScorer is used to score parsed responses for code execution use cases." }, "autoraterScorer": { "description": "ReinforcementTuningAutoraterScorer is used to score parsed responses based on score computed by an autorater.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorer" }, "parseResponseConfig": { "description": "Defines how to parse sample response. For example, given a sample response for evaluating the reward, users might want to extract the text only between `` and `` in the sample response, and keeps only the last one in case there are multiple such tags. To achieve such a purpose, they can define a regex `\".*(.*?)\"` using the ReinforcementTuningParseResponseConfig.ResponseParseType.REGEX_EXTRACT parse type.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningParseResponseConfig" }, "rewardName": { "type": "string", "description": "A unique reward name for identifying each single reinforcement tuning reward." } }, "description": "SingleReinforcementTuningRewardConfig defines a single reward function configuration for RL tuning. Each reward calculation/evaluation consists of two stages: 1. Stage 1: Parses the part of information important from sample response via regex extract, or simply takes the sample response unmodified. 2. Stage 2: Calls the configured reward scorer to compute the reward.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SingleReinforcementTuningRewardConfig" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationOption": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationOption", "description": "Optional settings for translation prompt.", "properties": { "numberOfShots": { "format": "int32", "description": "How many shots to use.", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigBruteForceConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigBruteForceConfig", "properties": {}, "description": "Configuration options for using brute force search." }, "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethod": { "description": "Options for generating the search key from the conversation history.", "id": "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethod", "type": "object", "properties": { "lastEntry": { "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethodLastEntry", "description": "Use only the last entry of the conversation history (`contents_example.contents`) as the search key." } } }, "GoogleCloudAiplatformV1beta1ListDeploymentResourcePoolsResponse": { "description": "Response message for ListDeploymentResourcePools method.", "properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "deploymentResourcePools": { "description": "The DeploymentResourcePools from the specified location.", "items": { "$ref": "GoogleCloudAiplatformV1beta1DeploymentResourcePool" }, "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListDeploymentResourcePoolsResponse" }, "GoogleCloudAiplatformV1beta1CachedContent": { "type": "object", "description": "A resource used in LLM queries for users to explicitly specify what to cache and how to cache.", "id": "GoogleCloudAiplatformV1beta1CachedContent", "properties": { "displayName": { "type": "string", "description": "Optional. Immutable. The user-generated meaningful display name of the cached content." }, "systemInstruction": { "description": "Optional. Input only. Immutable. Developer set system instruction. Currently, text only", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "createTime": { "description": "Output only. Creation time of the cache entry.", "type": "string", "format": "google-datetime", "readOnly": true }, "model": { "description": "Immutable. The name of the `Model` to use for cached content. Currently, only the published Gemini base models are supported, in form of projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL}", "type": "string" }, "expireTime": { "format": "google-datetime", "type": "string", "description": "Timestamp of when this resource is considered expired. This is *always* provided on output, regardless of what was sent on input." }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Input only. Immutable. Customer-managed encryption key spec for a `CachedContent`. If set, this `CachedContent` and all its sub-resources will be secured by this key." }, "toolConfig": { "description": "Optional. Input only. Immutable. Tool config. This config is shared for all tools", "$ref": "GoogleCloudAiplatformV1beta1ToolConfig" }, "tools": { "type": "array", "description": "Optional. Input only. Immutable. A list of `Tools` the model may use to generate the next response", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } }, "ttl": { "type": "string", "description": "Input only. The TTL for this resource. The expiration time is computed: now + TTL.", "format": "google-duration" }, "updateTime": { "description": "Output only. When the cache entry was last updated in UTC time.", "type": "string", "readOnly": true, "format": "google-datetime" }, "name": { "type": "string", "description": "Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content}" }, "contents": { "description": "Optional. Input only. Immutable. The content to cache", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "usageMetadata": { "readOnly": true, "description": "Output only. Metadata on the usage of the cached content.", "$ref": "GoogleCloudAiplatformV1beta1CachedContentUsageMetadata" } } }, "GoogleLongrunningOperation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "id": "GoogleLongrunningOperation", "properties": { "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", "type": "object" }, "response": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object" }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetection": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetection", "description": "A TrainingJob that trains and uploads an AutoML Image Object Detection Model.", "type": "object", "properties": { "metadata": { "description": "The metadata information", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionMetadata" }, "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionInputs", "description": "The input parameters of this TrainingJob." } } }, "GoogleCloudAiplatformV1beta1FeatureViewBigQuerySource": { "type": "object", "properties": { "uri": { "type": "string", "description": "Required. The BigQuery view URI that will be materialized on each sync trigger based on FeatureView.SyncConfig." }, "entityIdColumns": { "type": "array", "description": "Required. Columns to construct entity_id / row keys.", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewBigQuerySource" }, "GoogleCloudAiplatformV1beta1IdMatcher": { "id": "GoogleCloudAiplatformV1beta1IdMatcher", "properties": { "ids": { "description": "Required. The following are accepted as `ids`: * A single-element list containing only `*`, which selects all Features in the target EntityType, or * A list containing only Feature IDs, which selects only Features with those IDs in the target EntityType.", "type": "array", "items": { "type": "string" } } }, "description": "Matcher for Features of an EntityType by Feature ID.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListRagCorporaResponse": { "description": "Response message for VertexRagDataService.ListRagCorpora.", "properties": { "ragCorpora": { "items": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpus" }, "description": "List of RagCorpora in the requested page.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListRagCorporaRequest.page_token to obtain that page." } }, "id": "GoogleCloudAiplatformV1beta1ListRagCorporaResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1FunctionCall": { "type": "object", "properties": { "args": { "type": "object", "description": "Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details.", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "id": { "description": "Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`.", "type": "string" }, "partialArgs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PartialArg" }, "description": "Optional. The partial argument value of the function call. If provided, represents the arguments/fields that are streamed incrementally." }, "willContinue": { "description": "Optional. Whether this is the last part of the FunctionCall. If true, another partial message for the current FunctionCall is expected to follow.", "type": "boolean" }, "name": { "type": "string", "description": "Optional. The name of the function to call. Matches FunctionDeclaration.name." } }, "id": "GoogleCloudAiplatformV1beta1FunctionCall", "description": "A predicted FunctionCall returned from the model that contains a string representing the FunctionDeclaration.name and a structured JSON object containing the parameters and their values." }, "GoogleCloudAiplatformV1beta1RubricContentProperty": { "id": "GoogleCloudAiplatformV1beta1RubricContentProperty", "type": "object", "description": "Defines criteria based on a specific property.", "properties": { "description": { "description": "Description of the property being evaluated. Example: \"The model's response is grammatically correct.\"", "type": "string" } } }, "GoogleCloudAiplatformV1beta1TrialContext": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TrialContext", "properties": { "description": { "type": "string", "description": "A human-readable field which can store a description of this context. This will become part of the resulting Trial's description field." }, "parameters": { "description": "If/when a Trial is generated or selected from this Context, its Parameters will match any parameters specified here. (I.e. if this context specifies parameter name:'a' int_value:3, then a resulting Trial will have int_value:3 for its parameter named 'a'.) Note that we first attempt to match existing REQUESTED Trials with contexts, and if there are no matches, we generate suggestions in the subspace defined by the parameters specified here. NOTE: a Context without any Parameters matches the entire feasible search space.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrialParameter" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1NearestNeighborQuery": { "properties": { "perCrowdingAttributeNeighborCount": { "type": "integer", "format": "int32", "description": "Optional. Crowding is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than sper_crowding_attribute_neighbor_count of the k neighbors returned have the same value of crowding_attribute. It's used for improving result diversity." }, "parameters": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborQueryParameters", "description": "Optional. Parameters that can be set to tune query on the fly." }, "neighborCount": { "type": "integer", "description": "Optional. The number of similar entities to be retrieved from feature view for each query.", "format": "int32" }, "numericFilters": { "type": "array", "description": "Optional. The list of numeric filters.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborQueryNumericFilter" } }, "stringFilters": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborQueryStringFilter" }, "description": "Optional. The list of string filters." }, "entityId": { "type": "string", "description": "Optional. The entity id whose similar entities should be searched for. If embedding is set, search will use embedding instead of entity_id." }, "embedding": { "description": "Optional. The embedding vector that be used for similar search.", "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborQueryEmbedding" } }, "description": "A query to find a number of similar entities.", "id": "GoogleCloudAiplatformV1beta1NearestNeighborQuery", "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryRevision": { "id": "GoogleCloudAiplatformV1beta1MemoryRevision", "description": "A revision of a Memory.", "properties": { "extractedMemories": { "items": { "$ref": "GoogleCloudAiplatformV1beta1IntermediateExtractedMemory" }, "readOnly": true, "type": "array", "description": "Output only. Represents the extracted memories from the source content before consolidation when the memory was updated via GenerateMemories. This information was used to modify an existing Memory via Consolidation." }, "name": { "type": "string", "description": "Identifier. Represents the resource name of the Memory Revision. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}/revisions/{memory_revision}`" }, "labels": { "description": "Output only. Represents the labels of the Memory Revision. These labels are applied to the MemoryRevision when it is created based on `GenerateMemoriesRequest.revision_labels`.", "additionalProperties": { "type": "string" }, "readOnly": true, "type": "object" }, "expireTime": { "description": "Output only. Represents the timestamp of when this resource is considered expired.", "format": "google-datetime", "readOnly": true, "type": "string" }, "structuredData": { "description": "Output only. Represents the structured value of the memory at the time of revision creation.", "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "readOnly": true }, "createTime": { "description": "Output only. Represents the timestamp when this Memory Revision was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "fact": { "description": "Output only. Represents the fact of the Memory Revision. This corresponds to the `fact` field of the parent Memory at the time of revision creation.", "type": "string", "readOnly": true }, "context": { "type": "string", "readOnly": true, "description": "Output only. Represents the context of the Memory Revision. The context may include context from both the historical revisions and the extracted content." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigSessionInput": { "type": "object", "properties": { "sessionState": { "description": "Optional. Session specific memory which stores key conversation points.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "userId": { "description": "Optional. The user id for the agent session. The ID can be up to 128 characters long.", "type": "string" }, "parameters": { "type": "object", "description": "Optional. Additional parameters for the session, like app_name, etc. For example, {\"app_name\": \"my-app\"}.", "additionalProperties": { "type": "string" } } }, "description": "Session input to run an Agent.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigSessionInput" }, "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInstance": { "type": "object", "properties": { "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "reference": { "description": "Required. Ground truth used to compare against the prediction.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInstance", "description": "Spec for tool parameter key value match instance." }, "GoogleCloudAiplatformV1beta1ListEvaluationMetricsResponse": { "id": "GoogleCloudAiplatformV1beta1ListEvaluationMetricsResponse", "type": "object", "description": "Response message for EvaluationMetricService.ListEvaluationMetrics.", "properties": { "evaluationMetrics": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationMetric" }, "description": "List of EvaluationMetrics in the requested page." }, "nextPageToken": { "description": "A token to retrieve the next page of results.", "type": "string" } } }, "GenaiVertexV1beta1DeepResearchAgentConfig": { "id": "GenaiVertexV1beta1DeepResearchAgentConfig", "type": "object", "properties": { "enableBigqueryTool": { "description": "Enables bigquery tool for the Deep Research agent.", "type": "boolean" }, "visualization": { "description": "Whether to include visualizations in the response.", "enum": [ "UNSPECIFIED", "OFF", "AUTO" ], "enumDescriptions": [ "The default visualization mode. Will default to AUTO.", "Do not include visualizations.", "Automatically include visualizations." ], "type": "string" }, "collaborativePlanning": { "description": "Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.", "type": "boolean" }, "thinkingSummaries": { "type": "string", "description": "Whether to include thought summaries in the response.", "enumDescriptions": [ "Default value. This value is unused.", "Auto thinking summaries.", "No thinking summaries." ], "enum": [ "THINKING_SUMMARIES_UNSPECIFIED", "THINKING_SUMMARIES_AUTO", "THINKING_SUMMARIES_NONE" ] } }, "description": "Configuration for the Deep Research agent." }, "GoogleCloudAiplatformV1beta1AuthConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1AuthConfig", "description": "Auth configuration to run the extension.", "properties": { "apiKeyConfig": { "$ref": "GoogleCloudAiplatformV1beta1AuthConfigApiKeyConfig", "description": "Config for API key auth." }, "authType": { "description": "Type of auth scheme.", "enum": [ "AUTH_TYPE_UNSPECIFIED", "NO_AUTH", "API_KEY_AUTH", "HTTP_BASIC_AUTH", "GOOGLE_SERVICE_ACCOUNT_AUTH", "OAUTH", "OIDC_AUTH" ], "enumDescriptions": [ "", "No Auth.", "API Key Auth.", "HTTP Basic Auth.", "Google Service Account Auth.", "OAuth auth.", "OpenID Connect (OIDC) Auth." ], "type": "string" }, "oauthConfig": { "description": "Config for user oauth.", "$ref": "GoogleCloudAiplatformV1beta1AuthConfigOauthConfig" }, "httpBasicAuthConfig": { "description": "Config for HTTP Basic auth.", "$ref": "GoogleCloudAiplatformV1beta1AuthConfigHttpBasicAuthConfig" }, "googleServiceAccountConfig": { "$ref": "GoogleCloudAiplatformV1beta1AuthConfigGoogleServiceAccountConfig", "description": "Config for Google Service Account auth." }, "oidcConfig": { "description": "Config for user OIDC auth.", "$ref": "GoogleCloudAiplatformV1beta1AuthConfigOidcConfig" } } }, "GenaiVertexV1beta1ComputerUse": { "type": "object", "description": "A tool that can be used by the model to interact with the computer.", "properties": { "excludedPredefinedFunctions": { "description": "The list of predefined functions that are excluded from the model call.", "items": { "type": "string" }, "type": "array" }, "disabledSafetyPolicies": { "items": { "enum": [ "SAFETY_POLICY_UNSPECIFIED", "FINANCIAL_TRANSACTIONS", "SENSITIVE_DATA_MODIFICATION", "COMMUNICATION_TOOL", "ACCOUNT_CREATION", "DATA_MODIFICATION", "USER_CONSENT_MANAGEMENT", "LEGAL_TERMS_AND_AGREEMENTS" ], "type": "string", "enumDescriptions": [ "Unspecified safety policy.", "Safety policy for financial transactions.", "Safety policy for sensitive data modification.", "Safety policy for communication tools (e.g. Gmail, Chat, Meet).", "Safety policy for account creation.", "Safety policy for data modification.", "Safety policy for user consent management.", "Safety policy for legal terms and agreements." ] }, "description": "Optional. Disabled safety policies for computer use.", "type": "array" }, "environment": { "type": "string", "description": "The environment being operated.", "enum": [ "ENVIRONMENT_UNSPECIFIED", "BROWSER", "MOBILE", "DESKTOP" ], "enumDescriptions": [ "Defaults to browser.", "Operates in a web browser.", "Operates in a mobile environment.", "Operates in a desktop environment." ] }, "enablePromptInjectionDetection": { "type": "boolean", "description": "Whether enable the prompt injection detection check on computer-use request." } }, "id": "GenaiVertexV1beta1ComputerUse" }, "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesResponse": { "id": "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesResponse", "type": "object", "properties": { "dataKeysWithError": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey" } }, "data": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponse" }, "type": "array" }, "status": { "description": "Response status. If OK, then StreamingFetchFeatureValuesResponse.data will be populated. Otherwise StreamingFetchFeatureValuesResponse.data_keys_with_error will be populated with the appropriate data keys. The error only applies to the listed data keys - the stream will remain open for further FeatureOnlineStoreService.StreamingFetchFeatureValuesRequest requests.", "$ref": "GoogleRpcStatus" } }, "description": "Response message for FeatureOnlineStoreService.StreamingFetchFeatureValues." }, "GoogleCloudAiplatformV1beta1EnterpriseWebSearch": { "id": "GoogleCloudAiplatformV1beta1EnterpriseWebSearch", "description": "Tool to search public web data, powered by Vertex AI Search and Sec4 compliance.", "properties": { "excludeDomains": { "description": "Optional. List of domains to be excluded from the search results. The default limit is 2000 domains.", "type": "array", "items": { "type": "string" } }, "blockingConfidence": { "type": "string", "description": "Optional. Sites with confidence level chosen & above this value will be blocked from the search results.", "enumDescriptions": [ "Defaults to unspecified.", "Blocks Low and above confidence URL that is risky.", "Blocks Medium and above confidence URL that is risky.", "Blocks High and above confidence URL that is risky.", "Blocks Higher and above confidence URL that is risky.", "Blocks Very high and above confidence URL that is risky.", "Blocks Extremely high confidence URL that is risky." ], "enum": [ "PHISH_BLOCK_THRESHOLD_UNSPECIFIED", "BLOCK_LOW_AND_ABOVE", "BLOCK_MEDIUM_AND_ABOVE", "BLOCK_HIGH_AND_ABOVE", "BLOCK_HIGHER_AND_ABOVE", "BLOCK_VERY_HIGH_AND_ABOVE", "BLOCK_ONLY_EXTREMELY_HIGH" ] } }, "type": "object" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordStatus": { "description": "Represents the status of an A2ATaskRecord.", "properties": { "message": { "description": "Optional. The status message associated with the state.", "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage" }, "state": { "enumDescriptions": [ "The task is in an unknown or indeterminate state.", "Indicates that a task has been successfully submitted and acknowledged.", "Indicates that a task is actively being processed by the agent.", "Indicates that a task has finished successfully. This is a terminal state.", "Indicates that a task has finished with an error. This is a terminal state.", "Indicates that a task was canceled before completion. This is a terminal state.", "Indicates that the agent requires additional user input to proceed. This is an interrupted state.", "Indicates that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", "Indicates that authentication is required to proceed. This is an interrupted state." ], "enum": [ "STATE_UNSPECIFIED", "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ], "type": "string", "description": "Optional. The current state of the task." }, "timestamp": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time at which the state was set.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordStatus" }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextExtractionPredictionInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextExtractionPredictionInstance", "properties": { "content": { "description": "The text snippet to make the predictions on.", "type": "string" }, "mimeType": { "description": "The MIME type of the text snippet. The supported MIME types are listed below. - text/plain", "type": "string" }, "key": { "description": "This field is only used for batch prediction. If a key is provided, the batch prediction result will by mapped to this key. If omitted, then the batch prediction result will contain the entire input instance. Vertex AI will not check if keys in the request are duplicates, so it is up to the caller to ensure the keys are unique.", "type": "string" } }, "description": "Prediction input format for Text Extraction." }, "GoogleCloudAiplatformV1beta1ReportRuntimeEventResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReportRuntimeEventResponse", "description": "Response message for NotebookInternalService.ReportRuntimeEvent.", "properties": { "idleShutdownMessage": { "description": "If the idle shutdown is blocked by CP, CP will send the block message. Otherwise, this field is not set.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1RecommendSpecResponse": { "id": "GoogleCloudAiplatformV1beta1RecommendSpecResponse", "description": "Response message for ModelService.RecommendSpec.", "type": "object", "properties": { "baseModel": { "readOnly": true, "type": "string", "description": "Output only. The base model used to finetune the custom model." }, "recommendations": { "items": { "$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation" }, "description": "Output only. Recommendations of deployment options for the given custom weights model.", "readOnly": true, "type": "array" }, "specs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec" }, "readOnly": true, "description": "Output only. The machine and model container specs." } } }, "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetail": { "id": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetail", "type": "object", "description": "The runtime detail of a pipeline executor.", "properties": { "containerDetail": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailContainerDetail", "description": "Output only. The detailed info for a container executor." }, "customJobDetail": { "description": "Output only. The detailed info for a custom job executor.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailCustomJobDetail" } } }, "GoogleCloudAiplatformV1beta1RemoveContextChildrenResponse": { "type": "object", "description": "Response message for MetadataService.RemoveContextChildren.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1RemoveContextChildrenResponse" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningCloudRunRewardScorer": { "properties": { "cloudRunUri": { "description": "URI of the Cloud Run service that will be used to compute the reward. The [Vertex AI Secure Fine Tuning Service Agent](https://docs.cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent) (`service-@gcp-sa-vertex-tune.iam.gserviceaccount.com`) must be granted the permission (e.g. by granting `roles/run.invoker` in IAM) to invoke the Cloud Run service.", "type": "string" } }, "type": "object", "description": "ReinforcementTuningCloudRunRewardScorer allows users to implement a reward function through GCP Cloud Run. Comparing with ReinforcementTuningCodeExecutionRewardScorer that runs in a Sandbox and has no internet access, Cloud Run reward scorer is fully controlled by users. The Cloud Run service should implement the following HTTP API: HTTP method: `POST` HTTP request body: ``` { \"example\": ReinforcementTuningExample, \"response\": Content, \"metadata\": { \"step\": int \"tuning_job_id\": int64 } } ``` * `example` is a ReinforcementTuningExample in ProtoJSON format, (i.e., the format is the same as as one line in the training/validation dataset except that the keys must be in camel case). System instructions (i.e., `example.get(\"systemInstruction\")`) and references (i.e., `example.get(\"references\")`) are also included in the `example` provided that they are set in the training/validation dataset. * `response` is a Content in ProtoJSON format (i.e., keys must be in camel case), which is the same as the Online Prediction response for Gemini models. HTTP response body: { \"reward\": float, \"user_requested_aux_info\": str // Optional } where the field \"user_requested_aux_info\" is any (optional) string provided by users for assisting debugging. It's in snake case. This field is mostly useful when calling the GenAiTuningService.ValidateReinforcementTuningReward API, where the proto field (not Cloud Run HTTP response body) userRequestedAuxInfo will be populated if the Cloud Run reward function sets this field in the HTTP response. The following are examples for the HTTP request and response body. Example HTTP request body: ``` { \"example\": { \"contents\": [ { \"role\": \"user\", \"parts\": [ { \"text\": \"What is the capital of France?\" } ] } ], \"references\": { \"answer\": \"Paris\" } }, \"response\": { \"parts\": [ { \"text\": \"London\" } ] }, \"metadata\": { \"step\": 1, \"tuning_job_id\": 123456789 } } ``` Example HTTP response body: ``` { \"reward\": -1.0 } ``` Note: Reward output by Cloud Run reward function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningCloudRunRewardScorer" }, "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchResults": { "id": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchResults", "description": "Results for TrajectoryAnyOrderMatch metric.", "type": "object", "properties": { "trajectoryAnyOrderMatchMetricValues": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchMetricValue" }, "description": "Output only. TrajectoryAnyOrderMatch metric values.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1UpsertDatapointsRequest": { "description": "Request message for IndexService.UpsertDatapoints", "properties": { "datapoints": { "description": "A list of datapoints to be created/updated.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapoint" } }, "updateMask": { "description": "Optional. Update mask is used to specify the fields to be overwritten in the datapoints by the update. The fields specified in the update_mask are relative to each IndexDatapoint inside datapoints, not the full request. Updatable fields: * Use `all_restricts` to update both restricts and numeric_restricts.", "type": "string", "format": "google-fieldmask" } }, "id": "GoogleCloudAiplatformV1beta1UpsertDatapointsRequest", "type": "object" }, "GoogleTypeLatLng": { "properties": { "latitude": { "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", "type": "number", "format": "double" }, "longitude": { "type": "number", "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", "format": "double" } }, "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.", "id": "GoogleTypeLatLng", "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadata": { "properties": { "indicesTensorName": { "description": "Specifies the index of the values of the input tensor. Required when the input tensor is a sparse representation. Refer to Tensorflow documentation for more details: https://www.tensorflow.org/api_docs/python/tf/sparse/SparseTensor.", "type": "string" }, "encodedBaselines": { "type": "array", "items": { "type": "any" }, "description": "A list of baselines for the encoded tensor. The shape of each baseline should match the shape of the encoded tensor. If a scalar is provided, Vertex AI broadcasts to the same shape as the encoded tensor." }, "featureValueDomain": { "description": "The domain details of the input feature value. Like min/max, original mean or standard deviation if normalized.", "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataFeatureValueDomain" }, "inputTensorName": { "type": "string", "description": "Name of the input tensor for this feature. Required and is only applicable to Vertex AI-provided images for Tensorflow." }, "visualization": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataVisualization", "description": "Visualization configurations for image explanation." }, "inputBaselines": { "type": "array", "description": "Baseline inputs for this feature. If no baseline is specified, Vertex AI chooses the baseline for this feature. If multiple baselines are specified, Vertex AI returns the average attributions across them in Attribution.feature_attributions. For Vertex AI-provided Tensorflow images (both 1.x and 2.x), the shape of each baseline must match the shape of the input tensor. If a scalar is provided, we broadcast to the same shape as the input tensor. For custom images, the element of the baselines must be in the same format as the feature's input in the instance[]. The schema of any single instance may be specified via Endpoint's DeployedModels' Model's PredictSchemata's instance_schema_uri.", "items": { "type": "any" } }, "denseShapeTensorName": { "type": "string", "description": "Specifies the shape of the values of the input if the input is a sparse representation. Refer to Tensorflow documentation for more details: https://www.tensorflow.org/api_docs/python/tf/sparse/SparseTensor." }, "indexFeatureMapping": { "type": "array", "items": { "type": "string" }, "description": "A list of feature names for each index in the input tensor. Required when the input InputMetadata.encoding is BAG_OF_FEATURES, BAG_OF_FEATURES_SPARSE, INDICATOR." }, "groupName": { "description": "Name of the group that the input belongs to. Features with the same group name will be treated as one feature when computing attributions. Features grouped together can have different shapes in value. If provided, there will be one single attribution generated in Attribution.feature_attributions, keyed by the group name.", "type": "string" }, "encodedTensorName": { "description": "Encoded tensor is a transformation of the input tensor. Must be provided if choosing Integrated Gradients attribution or XRAI attribution and the input tensor is not differentiable. An encoded tensor is generated if the input tensor is encoded by a lookup table.", "type": "string" }, "encoding": { "enumDescriptions": [ "Default value. This is the same as IDENTITY.", "The tensor represents one feature.", "The tensor represents a bag of features where each index maps to a feature. InputMetadata.index_feature_mapping must be provided for this encoding. For example: ``` input = [27, 6.0, 150] index_feature_mapping = [\"age\", \"height\", \"weight\"] ```", "The tensor represents a bag of features where each index maps to a feature. Zero values in the tensor indicates feature being non-existent. InputMetadata.index_feature_mapping must be provided for this encoding. For example: ``` input = [2, 0, 5, 0, 1] index_feature_mapping = [\"a\", \"b\", \"c\", \"d\", \"e\"] ```", "The tensor is a list of binaries representing whether a feature exists or not (1 indicates existence). InputMetadata.index_feature_mapping must be provided for this encoding. For example: ``` input = [1, 0, 1, 0, 1] index_feature_mapping = [\"a\", \"b\", \"c\", \"d\", \"e\"] ```", "The tensor is encoded into a 1-dimensional array represented by an encoded tensor. InputMetadata.encoded_tensor_name must be provided for this encoding. For example: ``` input = [\"This\", \"is\", \"a\", \"test\", \".\"] encoded = [0.1, 0.2, 0.3, 0.4, 0.5] ```", "Select this encoding when the input tensor is encoded into a 2-dimensional array represented by an encoded tensor. InputMetadata.encoded_tensor_name must be provided for this encoding. The first dimension of the encoded tensor's shape is the same as the input tensor's shape. For example: ``` input = [\"This\", \"is\", \"a\", \"test\", \".\"] encoded = [[0.1, 0.2, 0.3, 0.4, 0.5], [0.2, 0.1, 0.4, 0.3, 0.5], [0.5, 0.1, 0.3, 0.5, 0.4], [0.5, 0.3, 0.1, 0.2, 0.4], [0.4, 0.3, 0.2, 0.5, 0.1]] ```" ], "enum": [ "ENCODING_UNSPECIFIED", "IDENTITY", "BAG_OF_FEATURES", "BAG_OF_FEATURES_SPARSE", "INDICATOR", "COMBINED_EMBEDDING", "CONCAT_EMBEDDING" ], "description": "Defines how the feature is encoded into the input tensor. Defaults to IDENTITY.", "type": "string" }, "modality": { "description": "Modality of the feature. Valid values are: numeric, image. Defaults to numeric.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadata", "type": "object", "description": "Metadata of the input of a feature. Fields other than InputMetadata.input_baselines are applicable only for Models that are using Vertex AI-provided images for Tensorflow." }, "GenaiVertexV1beta1ModelInteraction": { "id": "GenaiVertexV1beta1ModelInteraction", "properties": { "model": { "type": "string", "description": "The name of the `Model` used for generating the completion." }, "generationConfig": { "$ref": "GenaiVertexV1beta1GenerationConfig", "description": "Input only. Configuration parameters for the model interaction." } }, "description": "Interaction for generating the completion using models.", "type": "object" }, "GoogleCloudAiplatformV1beta1CustomCodeExecutionSpec": { "id": "GoogleCloudAiplatformV1beta1CustomCodeExecutionSpec", "properties": { "codeExecutionRegion": { "description": "Optional. The region to use for code execution. If set, the Code Execution Sandbox will be invoked in the specified region regardless of the request's originating region. Must be a region where the Code Execution Sandbox is available. For the current list of [supported regions](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/locations). If unset, the request's originating region is used; requests from regions where the sandbox is unavailable will fail with UNIMPLEMENTED.", "type": "string" }, "evaluationFunction": { "type": "string", "description": "Required. Python function. Expected user to define the following function, e.g.: def evaluate(instance: dict[str, Any]) -\u003e float: Please include this function signature in the code snippet. Instance is the evaluation instance, any fields populated in the instance are available to the function as instance[field_name]. Example: Example input: ``` instance= EvaluationInstance( response=EvaluationInstance.InstanceData(text=\"The answer is 4.\"), reference=EvaluationInstance.InstanceData(text=\"4\") ) ``` Example converted input: ``` { 'response': {'text': 'The answer is 4.'}, 'reference': {'text': '4'} } ``` Example python function: ``` def evaluate(instance: dict[str, Any]) -\u003e float: if instance'response' == instance'reference': return 1.0 return 0.0 ``` CustomCodeExecutionSpec is also supported in Batch Evaluation (EvalDataset RPC) and Tuning Evaluation. Each line in the input jsonl file will be converted to dict[str, Any] and passed to the evaluation function." } }, "type": "object", "description": "Specificies a metric that is populated by evaluating user-defined Python code." }, "GoogleCloudAiplatformV1beta1TaskStatusDetails": { "id": "GoogleCloudAiplatformV1beta1TaskStatusDetails", "properties": { "taskMessage": { "$ref": "GoogleCloudAiplatformV1beta1TaskMessage", "description": "Optional. The message associated with the single-turn interaction between the user and the agent or agent and agent." } }, "description": "Represents the additional status details of a task.", "type": "object" }, "GoogleCloudAiplatformV1beta1GoogleMapsGroundingTypes": { "description": "Defines the types of Google Maps grounding that can be enabled and their configurations.", "properties": { "routing": { "description": "Optional. Enables grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute).", "$ref": "GoogleCloudAiplatformV1beta1GoogleMapsRouting" }, "places": { "description": "Optional. Enables grounding with Google Maps Places. This is the default grounding type when no `GroundingTypes` are specified.", "$ref": "GoogleCloudAiplatformV1beta1GoogleMapsPlaces" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1GoogleMapsGroundingTypes" }, "GenaiVertexV1beta1TranscriptionConfig": { "id": "GenaiVertexV1beta1TranscriptionConfig", "description": "Configuration for speech recognition (transcription).", "properties": { "adaptationPhrases": { "deprecated": true, "type": "array", "items": { "type": "string" }, "description": "Optional. A list of phrases to bias the ASR model towards." }, "timestampGranularities": { "description": "Optional. The granularity of timestamps to include in the transcription output. Supported values: \"word\". If empty, no timestamps are generated.", "deprecated": true, "type": "array", "items": { "type": "string" } }, "languageCodes": { "items": { "type": "string" }, "description": "Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.", "type": "array" }, "diarizationMode": { "type": "string", "deprecated": true, "description": "Optional. Configures speaker diarization. Supported values: \"speaker\"." }, "customVocabulary": { "type": "array", "items": { "type": "string" }, "description": "Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AddTrialMeasurementRequest": { "id": "GoogleCloudAiplatformV1beta1AddTrialMeasurementRequest", "description": "Request message for VizierService.AddTrialMeasurement.", "properties": { "measurement": { "$ref": "GoogleCloudAiplatformV1beta1Measurement", "description": "Required. The measurement to be added to a Trial." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecasting": { "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputs", "description": "The input parameters of this TrainingJob." }, "metadata": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingMetadata", "description": "The metadata information." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecasting", "description": "A TrainingJob that trains and uploads an AutoML Forecasting Model.", "type": "object" }, "GoogleCloudAiplatformV1beta1Trial": { "description": "A message representing a Trial. A Trial contains a unique set of Parameters that has been or will be evaluated, along with the objective metrics got by running the Trial.", "properties": { "finalMeasurement": { "$ref": "GoogleCloudAiplatformV1beta1Measurement", "description": "Output only. The final measurement containing the objective value.", "readOnly": true }, "startTime": { "type": "string", "description": "Output only. Time when the Trial was started.", "format": "google-datetime", "readOnly": true }, "customJob": { "description": "Output only. The CustomJob name linked to the Trial. It's set for a HyperparameterTuningJob's Trial.", "readOnly": true, "type": "string" }, "id": { "readOnly": true, "type": "string", "description": "Output only. The identifier of the Trial assigned by the service." }, "endTime": { "readOnly": true, "description": "Output only. Time when the Trial's status changed to `SUCCEEDED` or `INFEASIBLE`.", "format": "google-datetime", "type": "string" }, "measurements": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Measurement" }, "type": "array", "description": "Output only. A list of measurements that are strictly lexicographically ordered by their induced tuples (steps, elapsed_duration). These are used for early stopping computations.", "readOnly": true }, "webAccessUris": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Output only. URIs for accessing [interactive shells](https://cloud.google.com/vertex-ai/docs/training/monitor-debug-interactive-shell) (one URI for each training node). Only available if this trial is part of a HyperparameterTuningJob and the job's trial_job_spec.enable_web_access field is `true`. The keys are names of each node used for the trial; for example, `workerpool0-0` for the primary node, `workerpool1-0` for the first node in the second worker pool, and `workerpool1-1` for the second node in the second worker pool. The values are the URIs for each node's interactive shell.", "readOnly": true }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "REQUESTED", "ACTIVE", "STOPPING", "SUCCEEDED", "INFEASIBLE" ], "readOnly": true, "description": "Output only. The detailed state of the Trial.", "enumDescriptions": [ "The Trial state is unspecified.", "Indicates that a specific Trial has been requested, but it has not yet been suggested by the service.", "Indicates that the Trial has been suggested.", "Indicates that the Trial should stop according to the service.", "Indicates that the Trial is completed successfully.", "Indicates that the Trial should not be attempted again. The service will set a Trial to INFEASIBLE when it's done but missing the final_measurement." ] }, "name": { "type": "string", "readOnly": true, "description": "Output only. Resource name of the Trial assigned by the service." }, "infeasibleReason": { "type": "string", "readOnly": true, "description": "Output only. A human readable string describing why the Trial is infeasible. This is set only if Trial state is `INFEASIBLE`." }, "parameters": { "readOnly": true, "type": "array", "description": "Output only. The parameters of the Trial.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrialParameter" } }, "clientId": { "type": "string", "description": "Output only. The identifier of the client that originally requested this Trial. Each client is identified by a unique client_id. When a client asks for a suggestion, Vertex AI Vizier will assign it a Trial. The client should evaluate the Trial, complete it, and report back to Vertex AI Vizier. If suggestion is asked again by same client_id before the Trial is completed, the same Trial will be returned. Multiple clients with different client_ids can ask for suggestions simultaneously, each of them will get their own Trial.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1Trial", "type": "object" }, "GoogleCloudAiplatformV1beta1A2aTaskArtifact": { "properties": { "extensions": { "type": "array", "items": { "type": "string" }, "description": "Optional. A2A protocol extensions associated with the artifact." }, "displayName": { "description": "Optional. The human-readable name of the artifact.", "type": "string" }, "description": { "type": "string", "description": "Optional. A human-readable description of the artifact." }, "artifactId": { "description": "Required. The unique identifier of the artifact within the task.", "type": "string" }, "metadata": { "type": "object", "description": "Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "parts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aPart" }, "type": "array", "description": "Required. The content parts that make up the artifact." } }, "type": "object", "description": "Represents a single artifact produced by a task.", "id": "GoogleCloudAiplatformV1beta1A2aTaskArtifact" }, "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyEngine": { "description": "Define a singleton SemanticGovernancePolicyEngine resource under a project and location.", "id": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyEngine", "type": "object", "properties": { "state": { "enumDescriptions": [ "Default value. This value is unused.", "A provisioning operation is in progress. The engine will transition to ACTIVE on success or FAILED on failure.", "The engine and all of its gateway configurations are provisioned and ready to serve traffic.", "A deprovisioning operation is in progress. The engine will transition to INACTIVE on success or FAILED on failure.", "The engine has no provisioned infrastructure: either never provisioned, or successfully deprovisioned.", "The most recent provisioning or deprovisioning operation failed. The engine may have partial infrastructure that needs explicit deprovision; the engine may be either re-provisioned or deprovisioned to recover." ], "description": "Output only. The state of the SemanticGovernancePolicyEngine.", "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "ACTIVE", "DEPROVISIONING", "INACTIVE", "FAILED" ], "type": "string" }, "ipAddress": { "type": "string", "readOnly": true, "description": "Output only. The private IPv4 address of the PSC endpoint." }, "gatewayConfigs": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1GatewayConfig" }, "type": "object", "description": "Optional. Configurations for gateways. The keys are user-defined names for each gateway. At most 5 gateway configurations are allowed." }, "name": { "description": "Identifier. The resource name of the SemanticGovernancePolicyEngine. Format: projects/{project}/locations/{location}/semanticGovernancePolicyEngine", "type": "string" }, "pscForwardingRule": { "type": "string", "description": "Output only. The URI of the PSC endpoint resource created in customer project. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}", "readOnly": true }, "pscServiceAttachment": { "readOnly": true, "type": "string", "description": "Output only. URI of the PSC attachment resource provided by SGP. Format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment}" }, "updateTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Timestamp when this SemanticGovernancePolicyEngine was last updated." }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Timestamp when this SemanticGovernancePolicyEngine was created.", "format": "google-datetime" } } }, "GoogleCloudAiplatformV1beta1GenerateSyntheticDataResponse": { "properties": { "syntheticExamples": { "description": "A list of generated synthetic examples, each containing a complete synthetic data instance generated based on your request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SyntheticExample" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1GenerateSyntheticDataResponse", "type": "object", "description": "The response message for the `GenerateSyntheticData` method, containing the synthetic examples generated by the Gen AI evaluation service." }, "GoogleCloudAiplatformV1beta1GenerateLossClustersOperationMetadata": { "description": "Operation metadata for EvaluationAnalyticsService.GenerateLossClusters.", "type": "object", "properties": { "genericMetadata": { "description": "Generic operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "id": "GoogleCloudAiplatformV1beta1GenerateLossClustersOperationMetadata" }, "GoogleCloudAiplatformV1beta1UserSpecifiedMetadata": { "id": "GoogleCloudAiplatformV1beta1UserSpecifiedMetadata", "properties": { "key": { "description": "Required. Key of the metadata. The key must be set with type by CreateRagDataSchema.", "type": "string" }, "value": { "$ref": "GoogleCloudAiplatformV1beta1MetadataValue", "description": "Value of the metadata. The value must be able to convert to the type according to the data schema." } }, "type": "object", "description": "Metadata provided by users." }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequest", "description": "Request message for EvaluationManagementService.ImportEvaluationSet.", "properties": { "inlineSource": { "description": "Inline source for small payloads (\u003c 4MB).", "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInlineSource" }, "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestGcsSource", "description": "Google Cloud Storage location." }, "cloudTraceSource": { "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestCloudTraceSource", "description": "Source for loading data directly from Cloud Trace." }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryRequestSet", "description": "BigQuery source with column mappings." }, "agentEngineSource": { "description": "Source for loading Agent Engine sessions.", "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestAgentEngineSource" }, "gcsDestination": { "description": "Required. The Cloud Storage location where the resulting EvaluationItem payloads will be stored.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "interactionsSource": { "description": "Optional. Source for importing Interactions API interactions.", "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInteractionsSource" }, "evaluationSet": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet", "description": "Required. The EvaluationSet to create. Used to specify 'display_name' and 'metadata'. The 'evaluation_items' field is ignored and populated by the import process." } } }, "GoogleCloudAiplatformV1beta1EvaluatedAnnotationExplanation": { "id": "GoogleCloudAiplatformV1beta1EvaluatedAnnotationExplanation", "type": "object", "properties": { "explanationType": { "description": "Explanation type. For AutoML Image Classification models, possible values are: * `image-integrated-gradients` * `image-xrai`", "type": "string" }, "explanation": { "$ref": "GoogleCloudAiplatformV1beta1Explanation", "description": "Explanation attribution response details." } }, "description": "Explanation result of the prediction produced by the Model." }, "GoogleCloudAiplatformV1beta1A2ATaskRecord": { "id": "GoogleCloudAiplatformV1beta1A2ATaskRecord", "description": "An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.", "properties": { "expireTime": { "description": "Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.", "type": "string", "readOnly": true, "format": "google-datetime" }, "contextId": { "type": "string", "description": "Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id)." }, "history": { "type": "array", "readOnly": true, "description": "Output only. The history of the task messages.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage" } }, "ttl": { "format": "google-duration", "description": "Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: [1 second, 1000 days], at second precision. The `nanos` component MUST be zero; sub-second TTLs are not supported because the task's expiration is persisted at second granularity.", "type": "string" }, "artifacts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifact" }, "description": "Output only. The artifacts produced by the task.", "readOnly": true }, "metadata": { "type": "object", "description": "Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "createTime": { "description": "Output only. The creation timestamp of the task.", "readOnly": true, "format": "google-datetime", "type": "string" }, "serviceMetadata": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication." }, "updateTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. The last update timestamp of the task." }, "deleteTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. The deletion timestamp of the task." }, "status": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordStatus", "description": "Optional. The status of the task, including the state, status message, and timestamp." }, "appId": { "description": "Optional. Agent application which created the task.", "type": "string" }, "purgeTime": { "format": "google-datetime", "description": "Output only. The purge timestamp of the task.", "readOnly": true, "type": "string" }, "userId": { "description": "Optional. Task owner user ID.", "type": "string" }, "name": { "description": "Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`", "type": "string" }, "generation": { "type": "string", "readOnly": true, "description": "Output only. The task generation number.", "format": "int64" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureNoiseSigmaNoiseSigmaForFeature": { "description": "Noise sigma for a single feature.", "type": "object", "properties": { "name": { "type": "string", "description": "The name of the input feature for which noise sigma is provided. The features are defined in explanation metadata inputs." }, "sigma": { "description": "This represents the standard deviation of the Gaussian kernel that will be used to add noise to the feature prior to computing gradients. Similar to noise_sigma but represents the noise added to the current feature. Defaults to 0.1.", "format": "float", "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1FeatureNoiseSigmaNoiseSigmaForFeature" }, "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigOutputConfig": { "description": "The output config for the evaluation run.", "type": "object", "properties": { "bigqueryDestination": { "description": "BigQuery destination for evaluation output.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination" }, "gcsDestination": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "Cloud Storage destination for evaluation output." } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigOutputConfig" }, "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse": { "description": "Response message for ReasoningEngineExecutionService.QueryReasoningEngine.", "properties": { "output": { "description": "Response provided by users in JSON object format.", "type": "any" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1QueryReasoningEngineResponse" }, "GoogleCloudAiplatformV1beta1NasTrialDetail": { "properties": { "parameters": { "type": "string", "description": "The parameters for the NasJob NasTrial." }, "trainTrial": { "$ref": "GoogleCloudAiplatformV1beta1NasTrial", "description": "The train NasTrial corresponding to search_trial. Only populated if search_trial is used for training." }, "searchTrial": { "description": "The requested search NasTrial.", "$ref": "GoogleCloudAiplatformV1beta1NasTrial" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Resource name of the NasTrialDetail." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NasTrialDetail", "description": "Represents a NasTrial details along with its parameters. If there is a corresponding train NasTrial, the train NasTrial is also returned." }, "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig": { "id": "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig", "description": "The deploy config to use for the deployment.", "properties": { "dedicatedResources": { "description": "Optional. The dedicated resources to use for the endpoint. If not set, the default resources will be used.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "systemLabels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. System labels for Model Garden deployments. These labels are managed by Google and for tracking purposes only." }, "fastTryoutEnabled": { "description": "Optional. If true, enable the QMT fast tryout feature for this model if possible.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListFeatureViewSyncsResponse": { "description": "Response message for FeatureOnlineStoreAdminService.ListFeatureViewSyncs.", "properties": { "featureViewSyncs": { "description": "The FeatureViewSyncs matching the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewSync" } }, "nextPageToken": { "description": "A token, which can be sent as ListFeatureViewSyncsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListFeatureViewSyncsResponse" }, "GoogleCloudAiplatformV1beta1SamplingStrategy": { "type": "object", "description": "Sampling Strategy for logging, can be for both training and prediction dataset.", "properties": { "randomSampleConfig": { "$ref": "GoogleCloudAiplatformV1beta1SamplingStrategyRandomSampleConfig", "description": "Random sample config. Will support more sampling strategies later." } }, "id": "GoogleCloudAiplatformV1beta1SamplingStrategy" }, "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponseRetrievedMemory": { "type": "object", "properties": { "memory": { "description": "The retrieved Memory.", "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "distance": { "description": "The distance between the query and the retrieved Memory. Smaller values indicate more similar memories. This is only set if similarity search was used for retrieval.", "format": "double", "type": "number" } }, "description": "A retrieved memory.", "id": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponseRetrievedMemory" }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageSegmentationPredictionInstance": { "type": "object", "description": "Prediction input format for Image Segmentation.", "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageSegmentationPredictionInstance", "properties": { "mimeType": { "type": "string", "description": "The MIME type of the content of the image. Only the images in below listed MIME types are supported. - image/jpeg - image/png" }, "content": { "description": "The image bytes to make the predictions on.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponse": { "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponse", "description": "Response message for FeaturestoreOnlineServingService.ReadFeatureValues.", "type": "object", "properties": { "entityView": { "description": "Entity view with Feature values. This may be the entity in the Featurestore if values for all Features were requested, or a projection of the entity in the Featurestore if values for only some Features were requested.", "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityView" }, "header": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseHeader", "description": "Response header." } } }, "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigDocumentCorpus": { "id": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigDocumentCorpus", "properties": {}, "description": "Config for the document corpus.", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchCreateFeaturesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchCreateFeaturesRequest", "properties": { "requests": { "items": { "$ref": "GoogleCloudAiplatformV1beta1CreateFeatureRequest" }, "description": "Required. The request message specifying the Features to create. All Features must be created under the same parent EntityType / FeatureGroup. The `parent` field in each child request message can be omitted. If `parent` is set in a child request, then the value must match the `parent` value in this request message.", "type": "array" } }, "description": "Request message for FeaturestoreService.BatchCreateFeatures. Request message for FeatureRegistryService.BatchCreateFeatures." }, "GenaiVertexV1beta1VoicePromptedVoice": { "id": "GenaiVertexV1beta1VoicePromptedVoice", "type": "object", "properties": { "input": { "type": "string", "description": "Required. The natural-language prompt describing the desired voice, e.g. \"A deep, booming male voice of a massive evil ogre in his middle years.\"" } }, "description": "Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `\"prompted\"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices." }, "GoogleCloudAiplatformV1beta1RougeResults": { "description": "Results for rouge metric.", "id": "GoogleCloudAiplatformV1beta1RougeResults", "properties": { "rougeMetricValues": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1RougeMetricValue" }, "description": "Output only. Rouge metric values.", "type": "array" } }, "type": "object" }, "GenaiVertexV1beta1FileSearchResultStep": { "description": "File Search result step.", "properties": {}, "type": "object", "id": "GenaiVertexV1beta1FileSearchResultStep" }, "GoogleCloudAiplatformV1beta1ImportRagFilesConfig": { "id": "GoogleCloudAiplatformV1beta1ImportRagFilesConfig", "type": "object", "properties": { "ragFileChunkingConfig": { "description": "Specifies the size and overlap of chunks after importing RagFiles.", "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "deprecated": true }, "importResultBigquerySink": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", "description": "The BigQuery destination to write import result to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). The dataset must exist. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table." }, "ragFileTransformationConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileTransformationConfig", "description": "Specifies the transformation config for RagFiles." }, "googleDriveSource": { "description": "Google Drive location. Supports importing individual files as well as Google Drive folders.", "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSource" }, "ragFileParsingConfig": { "description": "Optional. Specifies the parsing config for RagFiles. RAG will use the default parser if this field is not set.", "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfig" }, "gcsSource": { "description": "Google Cloud Storage location. Supports importing individual files as well as entire Google Cloud Storage directories. Sample formats: - `gs://bucket_name/my_directory/object_name/my_file.txt` - `gs://bucket_name/my_directory`", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "importResultGcsSink": { "description": "The Cloud Storage path to write import result to.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "rebuildAnnIndex": { "description": "Rebuilds the ANN index to optimize for recall on the imported data. Only applicable for RagCorpora running on RagManagedDb with `retrieval_strategy` set to `ANN`. The rebuild will be performed using the existing ANN config set on the RagCorpus. To change the ANN config, please use the UpdateRagCorpus API. Default is false, i.e., index is not rebuilt.", "type": "boolean" }, "slackSource": { "description": "Slack channels with their corresponding access tokens.", "$ref": "GoogleCloudAiplatformV1beta1SlackSource" }, "ragFileMetadataConfig": { "description": "Specifies the metadata config for RagFiles. Including paths for metadata schema and metadata. Deprecated: Not in use.", "$ref": "GoogleCloudAiplatformV1beta1RagFileMetadataConfig", "deprecated": true }, "sharePointSources": { "description": "SharePoint sources.", "$ref": "GoogleCloudAiplatformV1beta1SharePointSources" }, "jiraSource": { "$ref": "GoogleCloudAiplatformV1beta1JiraSource", "description": "Jira queries with their corresponding authentication." }, "maxEmbeddingRequestsPerMin": { "format": "int32", "type": "integer", "description": "Optional. The max number of queries per minute that this job is allowed to make to the embedding model specified on the corpus. This value is specific to this job and not shared across other import jobs. Consult the Quotas page on the project to set an appropriate value here. If unspecified, a default value of 1,000 QPM would be used." }, "globalMaxEmbeddingRequestsPerMin": { "description": "Optional. The max number of queries per minute that the indexing pipeline job is allowed to make to the embedding model specified in the project. Please follow the quota usage guideline of the embedding model you use to set the value properly.If this value is not specified, max_embedding_requests_per_min will be used by indexing pipeline job as the global limit.", "type": "integer", "format": "int32" }, "partialFailureBigquerySink": { "description": "The BigQuery destination to write partial failures to. It should be a bigquery table resource name (e.g. \"bq://projectId.bqDatasetId.bqTableId\"). The dataset must exist. If the table does not exist, it will be created with the expected schema. If the table exists, the schema will be validated and data will be added to this existing table. Deprecated. Prefer to use `import_result_bq_sink`.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", "deprecated": true }, "partialFailureGcsSink": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "deprecated": true, "description": "The Cloud Storage path to write partial failures to. Deprecated. Prefer to use `import_result_gcs_sink`." } }, "description": "Config for importing RagFiles." }, "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecDraftModelSpeculation": { "properties": { "draftModel": { "type": "string", "description": "Required. The resource name of the draft model." } }, "id": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecDraftModelSpeculation", "type": "object", "description": "Draft model speculation works by using the smaller model to generate candidate tokens for speculative decoding." }, "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfig": { "id": "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfig", "description": "Used to set up the auth on the DeployedIndex's private endpoint.", "properties": { "authProvider": { "description": "Defines the authentication provider that the DeployedIndex uses.", "$ref": "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfigAuthProvider" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TensorboardBlobSequence": { "properties": { "values": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardBlob" }, "description": "List of blobs contained within the sequence." } }, "type": "object", "description": "One point viewable on a blob metric plot, but mostly just a wrapper message to work around repeated fields can't be used directly within `oneof` fields.", "id": "GoogleCloudAiplatformV1beta1TensorboardBlobSequence" }, "GoogleCloudAiplatformV1beta1BatchDeleteRagMetadataRequest": { "type": "object", "description": "Request message for VertexRagDataService.BatchDeleteRagMetadata.", "id": "GoogleCloudAiplatformV1beta1BatchDeleteRagMetadataRequest", "properties": { "names": { "description": "Required. The RagMetadata to delete. A maximum of 500 rag metadata can be deleted in a batch.", "items": { "type": "string" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1TimeSeriesData": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TimeSeriesData", "description": "All the data stored in a TensorboardTimeSeries.", "properties": { "valueType": { "type": "string", "enumDescriptions": [ "The value type is unspecified.", "Used for TensorboardTimeSeries that is a list of scalars. E.g. accuracy of a model over epochs/time.", "Used for TensorboardTimeSeries that is a list of tensors. E.g. histograms of weights of layer in a model over epoch/time.", "Used for TensorboardTimeSeries that is a list of blob sequences. E.g. set of sample images with labels over epochs/time." ], "enum": [ "VALUE_TYPE_UNSPECIFIED", "SCALAR", "TENSOR", "BLOB_SEQUENCE" ], "description": "Required. Immutable. The value type of this time series. All the values in this time series data must match this value type." }, "tensorboardTimeSeriesId": { "type": "string", "description": "Required. The ID of the TensorboardTimeSeries, which will become the final component of the TensorboardTimeSeries' resource name" }, "values": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TimeSeriesDataPoint" }, "description": "Required. Data points in this time series.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpec": { "properties": { "multiTrialAlgorithm": { "type": "string", "enumDescriptions": [ "Defaults to `REINFORCEMENT_LEARNING`.", "The Reinforcement Learning Algorithm for Multi-trial Neural Architecture Search (NAS).", "The Grid Search Algorithm for Multi-trial Neural Architecture Search (NAS)." ], "description": "The multi-trial Neural Architecture Search (NAS) algorithm type. Defaults to `REINFORCEMENT_LEARNING`.", "enum": [ "MULTI_TRIAL_ALGORITHM_UNSPECIFIED", "REINFORCEMENT_LEARNING", "GRID_SEARCH" ] }, "trainTrialSpec": { "$ref": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecTrainTrialSpec", "description": "Spec for train trials. Top N [TrainTrialSpec.max_parallel_trial_count] search trials will be trained for every M [TrainTrialSpec.frequency] trials searched." }, "metric": { "description": "Metric specs for the NAS job. Validation for this field is done at `multi_trial_algorithm_spec` field.", "$ref": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecMetricSpec" }, "searchTrialSpec": { "description": "Required. Spec for search trials.", "$ref": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecSearchTrialSpec" } }, "type": "object", "description": "The spec of multi-trial Neural Architecture Search (NAS).", "id": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpec" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfigAdapter": { "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfigAdapter", "type": "object", "properties": { "id": { "type": "string", "description": "The registered ID of the LoRA adapter (e.g. \"lora_xxx\")." }, "resolvedPath": { "type": "string", "description": "Internal field populated after validation: resolved TFHub path." }, "weight": { "type": "number", "format": "float", "description": "The blending scale/weight of the LoRA adapter. Must be in the range (0.0, 1.0]. Default is 1.0." } } }, "GoogleCloudAiplatformV1beta1StudySpecConvexStopConfig": { "deprecated": true, "type": "object", "id": "GoogleCloudAiplatformV1beta1StudySpecConvexStopConfig", "properties": { "minNumSteps": { "type": "string", "format": "int64", "description": "Minimum number of steps for a trial to complete. Trials which do not have a measurement with num_steps \u003e min_num_steps won't be considered for early stopping. It's ok to set it to 0, and a trial can be early stopped at any stage. By default, min_num_steps is set to be one-tenth of the max_num_steps. When use_steps is false, this field is set to the minimum elapsed seconds." }, "maxNumSteps": { "type": "string", "description": "Steps used in predicting the final objective for early stopped trials. In general, it's set to be the same as the defined steps in training / tuning. When use_steps is false, this field is set to the maximum elapsed seconds.", "format": "int64" }, "useSeconds": { "type": "boolean", "description": "This bool determines whether or not the rule is applied based on elapsed_secs or steps. If use_seconds==false, the early stopping decision is made according to the predicted objective values according to the target steps. If use_seconds==true, elapsed_secs is used instead of steps. Also, in this case, the parameters max_num_steps and min_num_steps are overloaded to contain max_elapsed_seconds and min_elapsed_seconds." }, "autoregressiveOrder": { "format": "int64", "description": "The number of Trial measurements used in autoregressive model for value prediction. A trial won't be considered early stopping if has fewer measurement points.", "type": "string" }, "learningRateParameterName": { "type": "string", "description": "The hyper-parameter name used in the tuning job that stands for learning rate. Leave it blank if learning rate is not in a parameter in tuning. The learning_rate is used to estimate the objective value of the ongoing trial." } }, "description": "Configuration for ConvexStopPolicy." }, "GoogleCloudAiplatformV1beta1DirectRawPredictResponse": { "type": "object", "properties": { "output": { "type": "string", "format": "byte", "description": "The prediction output." } }, "description": "Response message for PredictionService.DirectRawPredict.", "id": "GoogleCloudAiplatformV1beta1DirectRawPredictResponse" }, "GoogleCloudAiplatformV1beta1AudioTranscriptionWordInfo": { "type": "object", "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionWordInfo", "properties": { "startOffset": { "description": "Optional. Start offset in time of the word relative to the start of the audio.", "type": "string", "format": "google-duration" }, "endOffset": { "description": "Optional. End offset in time of the word relative to the start of the audio.", "type": "string", "format": "google-duration" }, "word": { "description": "Required. Transcript of the word.", "type": "string" } }, "description": "Information about a single recognized word." }, "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRankingRankService": { "id": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRankingRankService", "properties": { "modelName": { "description": "Optional. The model name of the rank service.", "type": "string" } }, "description": "Config for Rank Service.", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookReservationAffinity": { "properties": { "key": { "description": "Optional. Corresponds to the label key of a reservation resource. To target a RESERVATION_SPECIFIC by name, use compute.googleapis.com/reservation-name as the key and specify the name of your reservation as its value.", "type": "string" }, "values": { "type": "array", "description": "Optional. Corresponds to the label values of a reservation resource. This must be the full path name of Reservation.", "items": { "type": "string" } }, "consumeReservationType": { "enum": [ "RESERVATION_AFFINITY_TYPE_UNSPECIFIED", "RESERVATION_NONE", "RESERVATION_ANY", "RESERVATION_SPECIFIC" ], "description": "Required. Specifies the type of reservation from which this instance can consume resources: RESERVATION_ANY (default), RESERVATION_SPECIFIC, or RESERVATION_NONE. See Consuming reserved instances for examples.", "type": "string", "enumDescriptions": [ "Default type.", "Do not consume from any allocated capacity.", "Consume any reservation available.", "Must consume from a specific reservation. Must specify key value fields for specifying the reservations." ] } }, "type": "object", "description": "Notebook Reservation Affinity for consuming Zonal reservation.", "id": "GoogleCloudAiplatformV1beta1NotebookReservationAffinity" }, "GoogleCloudAiplatformV1beta1SafetySpec": { "type": "object", "properties": { "version": { "format": "int32", "type": "integer", "description": "Optional. Which version to use for evaluation." } }, "description": "Spec for safety metric.", "id": "GoogleCloudAiplatformV1beta1SafetySpec" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsOmniRewriterConfig": { "properties": { "rewriterInputFps": { "type": "integer", "description": "Optional. FPS used to generate gemini chunks for video inputs.", "format": "int32" }, "maxChunkDuration": { "format": "float", "type": "number", "description": "Optional. Maximum duration of a chunk in seconds." } }, "description": "Configuration for Omni Rewriter.", "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsOmniRewriterConfig" }, "GoogleCloudAiplatformV1beta1GeminiExample": { "id": "GoogleCloudAiplatformV1beta1GeminiExample", "properties": { "contents": { "type": "array", "description": "Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "modelArmorConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelArmorConfig", "description": "Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied." }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.", "type": "object" }, "systemInstruction": { "description": "Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph.", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "toolConfig": { "description": "Optional. Tool config. This config is shared for all tools provided in the request.", "$ref": "GoogleCloudAiplatformV1beta1ToolConfig" }, "cachedContent": { "description": "Optional. The name of the cached content used as context to serve the prediction. Note: only used in explicit caching, where users can have control over caching (e.g. what content to cache) and enjoy guaranteed cost savings. Format: `projects/{project}/locations/{location}/cachedContents/{cachedContent}`", "type": "string" }, "safetySettings": { "type": "array", "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SafetySetting" } }, "model": { "description": "Optional. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" }, "tools": { "description": "Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } }, "generationConfig": { "description": "Optional. Generation config.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" } }, "description": "Format for Gemini examples used for Vertex Multimodal datasets.", "type": "object" }, "GoogleCloudAiplatformV1beta1AvroSource": { "type": "object", "properties": { "gcsSource": { "description": "Required. Google Cloud Storage location.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" } }, "id": "GoogleCloudAiplatformV1beta1AvroSource", "description": "The storage details for Avro input content." }, "GoogleIamV1GetPolicyOptions": { "description": "Encapsulates settings provided to GetIamPolicy.", "id": "GoogleIamV1GetPolicyOptions", "properties": { "requestedPolicyVersion": { "format": "int32", "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CancelTrainingPipelineRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CancelTrainingPipelineRequest", "description": "Request message for PipelineService.CancelTrainingPipeline.", "properties": {} }, "GoogleCloudAiplatformV1beta1CompactionConfigLlmSummarizationConfig": { "id": "GoogleCloudAiplatformV1beta1CompactionConfigLlmSummarizationConfig", "description": "Configuration for LLM summarization-based compaction. When set, the session context is summarized with an LLM once it exceeds the summarizer target threshold.", "properties": { "mode": { "enumDescriptions": [ "Unspecified. Requests must set an explicit mode.", "Platform-managed summarization with server-side defaults." ], "enum": [ "MODE_UNSPECIFIED", "AUTO" ], "description": "Required. The summarization mode. Only `AUTO` is supported for MVP.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1Feature": { "id": "GoogleCloudAiplatformV1beta1Feature", "description": "Feature Metadata information. For example, color is a feature that describes an apple.", "properties": { "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize your Features. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one Feature (System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "type": "object" }, "valueType": { "description": "Immutable. Only applicable for Vertex AI Feature Store (Legacy). Type of Feature value.", "type": "string", "enumDescriptions": [ "The value type is unspecified.", "Used for Feature that is a boolean.", "Used for Feature that is a list of boolean.", "Used for Feature that is double.", "Used for Feature that is a list of double.", "Used for Feature that is INT64.", "Used for Feature that is a list of INT64.", "Used for Feature that is string.", "Used for Feature that is a list of String.", "Used for Feature that is bytes.", "Used for Feature that is struct." ], "enum": [ "VALUE_TYPE_UNSPECIFIED", "BOOL", "BOOL_ARRAY", "DOUBLE", "DOUBLE_ARRAY", "INT64", "INT64_ARRAY", "STRING", "STRING_ARRAY", "BYTES", "STRUCT" ] }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Only applicable for Vertex AI Feature Store (Legacy). Timestamp when this EntityType was most recently updated." }, "etag": { "type": "string", "description": "Used to perform a consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "monitoringStats": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly" }, "readOnly": true, "description": "Output only. Only applicable for Vertex AI Feature Store (Legacy). A list of historical SnapshotAnalysis stats requested by user, sorted by FeatureStatsAnomaly.start_time descending.", "type": "array" }, "monitoringConfig": { "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfig", "description": "Optional. Only applicable for Vertex AI Feature Store (Legacy). Deprecated: The custom monitoring configuration for this Feature, if not set, use the monitoring_config defined for the EntityType this Feature belongs to. Only Features with type (Feature.ValueType) BOOL, STRING, DOUBLE or INT64 can enable monitoring. If this is populated with FeaturestoreMonitoringConfig.disabled = true, snapshot analysis monitoring is disabled; if FeaturestoreMonitoringConfig.monitoring_interval specified, snapshot analysis monitoring is enabled. Otherwise, snapshot analysis monitoring config is same as the EntityType's this Feature belongs to.", "deprecated": true }, "versionColumnName": { "type": "string", "description": "Only applicable for Vertex AI Feature Store. The name of the BigQuery Table/View column hosting data for this version. If no value is provided, will use feature_id." }, "createTime": { "description": "Output only. Only applicable for Vertex AI Feature Store (Legacy). Timestamp when this EntityType was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "description": { "description": "Description of the Feature.", "type": "string" }, "featureStatsAndAnomaly": { "description": "Output only. Only applicable for Vertex AI Feature Store. The list of historical stats and anomalies.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAndAnomaly" }, "readOnly": true }, "monitoringStatsAnomalies": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitoringStatsAnomaly" }, "description": "Output only. Only applicable for Vertex AI Feature Store (Legacy). The list of historical stats and anomalies with specified objectives.", "readOnly": true }, "name": { "description": "Immutable. Name of the Feature. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}/features/{feature}` `projects/{project}/locations/{location}/featureGroups/{feature_group}/features/{feature}` The last part feature is assigned by the client. The feature can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z, underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given an entity type.", "type": "string" }, "disableMonitoring": { "description": "Optional. Only applicable for Vertex AI Feature Store (Legacy). If not set, use the monitoring_config defined for the EntityType this Feature belongs to. Only Features with type (Feature.ValueType) BOOL, STRING, DOUBLE or INT64 can enable monitoring. If set to true, all types of data monitoring are disabled despite the config on EntityType.", "type": "boolean" }, "pointOfContact": { "type": "string", "description": "Entity responsible for maintaining this feature. Can be comma separated list of email addresses or URIs." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetrics": { "type": "object", "description": "Bounding box matching model metrics for a single intersection-over-union threshold and multiple label match confidence thresholds.", "properties": { "confidenceMetrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetricsConfidenceMetrics" }, "type": "array", "description": "Metrics for each label-match confidence_threshold from 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99. Precision-recall curve is derived from them." }, "meanAveragePrecision": { "type": "number", "description": "The mean average precision, most often close to `auPrc`.", "format": "float" }, "iouThreshold": { "format": "float", "type": "number", "description": "The intersection-over-union threshold value used to compute this metrics entry." } }, "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetrics" }, "GoogleCloudAiplatformV1beta1NotebookEucConfig": { "description": "The euc configuration of NotebookRuntimeTemplate.", "type": "object", "properties": { "bypassActasCheck": { "type": "boolean", "description": "Output only. Whether ActAs check is bypassed for service account attached to the VM. If false, we need ActAs check for the default Compute Engine Service account. When a Runtime is created, a VM is allocated using Default Compute Engine Service Account. Any user requesting to use this Runtime requires Service Account User (ActAs) permission over this SA. If true, Runtime owner is using EUC and does not require the above permission as VM no longer use default Compute Engine SA, but a P4SA.", "readOnly": true }, "eucDisabled": { "description": "Input only. Whether EUC is disabled in this NotebookRuntimeTemplate. In proto3, the default value of a boolean is false. In this way, by default EUC will be enabled for NotebookRuntimeTemplate.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1NotebookEucConfig" }, "GoogleCloudAiplatformV1beta1RagQuery": { "id": "GoogleCloudAiplatformV1beta1RagQuery", "type": "object", "description": "A query to retrieve relevant contexts.", "properties": { "similarityTopK": { "description": "Optional. The number of contexts to retrieve.", "type": "integer", "deprecated": true, "format": "int32" }, "text": { "type": "string", "description": "Optional. The query in text format to get relevant contexts." }, "ranking": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1RagQueryRanking", "description": "Optional. Configurations for hybrid search results ranking." }, "ragRetrievalConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfig", "description": "Optional. The retrieval config for the query." } } }, "GoogleCloudAiplatformV1beta1MetadataValue": { "type": "object", "id": "GoogleCloudAiplatformV1beta1MetadataValue", "description": "Value of Metadata, including all types available in data schema.", "properties": { "listValue": { "description": "Value of list type metadata.", "$ref": "GoogleCloudAiplatformV1beta1MetadataList" }, "intValue": { "type": "string", "format": "int64", "description": "Value of int type metadata." }, "datetimeValue": { "type": "string", "description": "Value of date time type metadata." }, "boolValue": { "description": "Value of boolean type metadata.", "type": "boolean" }, "strValue": { "description": "Value of string type metadata.", "type": "string" }, "floatValue": { "type": "number", "format": "float", "description": "Value of float type metadata." } } }, "GoogleCloudAiplatformV1beta1SampledShapleyAttribution": { "description": "An attribution method that approximates Shapley values for features that contribute to the label being predicted. A sampling strategy is used to approximate the value rather than considering all subsets of features.", "type": "object", "properties": { "pathCount": { "type": "integer", "format": "int32", "description": "Required. The number of feature permutations to consider when approximating the Shapley values. Valid range of its value is [1, 50], inclusively." } }, "id": "GoogleCloudAiplatformV1beta1SampledShapleyAttribution" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformation", "type": "object", "properties": { "numeric": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationNumericTransformation" }, "categorical": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationCategoricalTransformation" }, "timestamp": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTimestampTransformation" }, "auto": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationAutoTransformation" }, "text": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTextTransformation" } } }, "GoogleCloudAiplatformV1beta1AnnotationSpec": { "description": "Identifies a concept with which DataItems may be annotated with.", "type": "object", "properties": { "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this AnnotationSpec was created.", "readOnly": true }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when AnnotationSpec was last updated.", "readOnly": true }, "displayName": { "type": "string", "description": "Required. The user-defined name of the AnnotationSpec. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "name": { "description": "Output only. Resource name of the AnnotationSpec.", "type": "string", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1AnnotationSpec" }, "GoogleCloudAiplatformV1beta1VertexRagStore": { "id": "GoogleCloudAiplatformV1beta1VertexRagStore", "type": "object", "description": "Retrieve from Vertex RAG Store for grounding.", "properties": { "ragResources": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1VertexRagStoreRagResource" }, "description": "Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support." }, "ragCorpora": { "deprecated": true, "description": "Optional. Deprecated. Please use rag_resources instead.", "items": { "type": "string" }, "type": "array" }, "similarityTopK": { "deprecated": true, "type": "integer", "description": "Optional. Number of top k results to return from the selected corpora.", "format": "int32" }, "storeContext": { "type": "boolean", "description": "Optional. Currently only supported for Gemini Multimodal Live API. In Gemini Multimodal Live API, if `store_context` bool is specified, Gemini will leverage it to automatically memorize the interactions between the client and Gemini, and retrieve context when needed to augment the response generation for users' ongoing and future interactions." }, "vectorDistanceThreshold": { "deprecated": true, "type": "number", "description": "Optional. Only return results with vector distance smaller than the threshold.", "format": "double" }, "ragRetrievalConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagRetrievalConfig", "description": "Optional. The retrieval config for the Rag query." } } }, "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotation", "properties": { "maskAnnotation": { "description": "Mask based segmentation annotation. Only one mask annotation can exist for one image.", "$ref": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationMaskAnnotation" }, "polygonAnnotation": { "description": "Polygon annotation.", "$ref": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolygonAnnotation" }, "polylineAnnotation": { "description": "Polyline annotation.", "$ref": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolylineAnnotation" } }, "type": "object", "description": "Annotation details specific to image segmentation." }, "GoogleCloudAiplatformV1beta1MetadataList": { "description": "List representation in metadata.", "properties": { "values": { "description": "The values of `LIST` data type metadata.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MetadataValue" } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MetadataList" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfigDnsPeeringConfig": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfigDnsPeeringConfig", "properties": { "targetProject": { "description": "Required. The project ID hosting the Cloud DNS managed zone that contains the `domain`. The Vertex AI Service Agent requires the dns.peer role on this project.", "type": "string" }, "domain": { "description": "Required. The DNS name suffix of the zone being peered to, e.g., \"my-internal-domain.corp.\". Must end with a dot.", "type": "string" }, "targetNetwork": { "description": "Required. The VPC network name in the target_project where the DNS zone specified by `domain` is visible.", "type": "string" } }, "description": "Configuration for peering a customer's private DNS zone so that sandbox egress can resolve customer-internal domains via the customer VPC.", "type": "object" }, "GoogleCloudAiplatformV1beta1StudySpec": { "id": "GoogleCloudAiplatformV1beta1StudySpec", "properties": { "transferLearningConfig": { "description": "The configuration info/options for transfer learning. Currently supported for Vertex AI Vizier service, not HyperParameterTuningJob", "$ref": "GoogleCloudAiplatformV1beta1StudySpecTransferLearningConfig" }, "parameters": { "items": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpec" }, "type": "array", "description": "Required. The set of parameters to tune." }, "measurementSelectionType": { "description": "Describe which measurement selection type will be used", "enumDescriptions": [ "Will be treated as LAST_MEASUREMENT.", "Use the last measurement reported.", "Use the best measurement reported." ], "enum": [ "MEASUREMENT_SELECTION_TYPE_UNSPECIFIED", "LAST_MEASUREMENT", "BEST_MEASUREMENT" ], "type": "string" }, "algorithm": { "enum": [ "ALGORITHM_UNSPECIFIED", "GRID_SEARCH", "RANDOM_SEARCH" ], "description": "The search algorithm specified for the Study.", "type": "string", "enumDescriptions": [ "The default algorithm used by Vertex AI for [hyperparameter tuning](https://cloud.google.com/vertex-ai/docs/training/hyperparameter-tuning-overview) and [Vertex AI Vizier](https://cloud.google.com/vertex-ai/docs/vizier).", "Simple grid search within the feasible space. To use grid search, all parameters must be `INTEGER`, `CATEGORICAL`, or `DISCRETE`.", "Simple random search within the feasible space." ] }, "convexStopConfig": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecConvexStopConfig", "description": "Deprecated. The automated early stopping using convex stopping rule.", "deprecated": true }, "decayCurveStoppingSpec": { "description": "The automated early stopping spec using decay curve rule.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecDecayCurveAutomatedStoppingSpec" }, "convexAutomatedStoppingSpec": { "description": "The automated early stopping spec using convex stopping rule.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecConvexAutomatedStoppingSpec" }, "observationNoise": { "type": "string", "enumDescriptions": [ "The default noise level chosen by Vertex AI.", "Vertex AI assumes that the objective function is (nearly) perfectly reproducible, and will never repeat the same Trial parameters.", "Vertex AI will estimate the amount of noise in metric evaluations, it may repeat the same Trial parameters more than once." ], "description": "The observation noise level of the study. Currently only supported by the Vertex AI Vizier service. Not supported by HyperparameterTuningJob or TrainingPipeline.", "enum": [ "OBSERVATION_NOISE_UNSPECIFIED", "LOW", "HIGH" ] }, "medianAutomatedStoppingSpec": { "description": "The automated early stopping spec using median rule.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecMedianAutomatedStoppingSpec" }, "studyStoppingConfig": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig", "description": "Conditions for automated stopping of a Study. Enable automated stopping by configuring at least one condition." }, "metrics": { "description": "Required. Metric specs for the Study.", "items": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecMetricSpec" }, "type": "array" } }, "description": "Represents specification of a Study.", "type": "object" }, "GoogleCloudAiplatformV1beta1CancelHyperparameterTuningJobRequest": { "description": "Request message for JobService.CancelHyperparameterTuningJob.", "id": "GoogleCloudAiplatformV1beta1CancelHyperparameterTuningJobRequest", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1LLMBasedMetricSpec": { "type": "object", "description": "Specification for an LLM based metric.", "properties": { "systemInstruction": { "type": "string", "description": "Optional. System instructions for the judge model." }, "resultParserConfig": { "description": "Optional. The parser config for the metric result.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationParserConfig" }, "predefinedRubricGenerationSpec": { "description": "Dynamically generate rubrics using a predefined spec.", "$ref": "GoogleCloudAiplatformV1beta1PredefinedMetricSpec" }, "metricPromptTemplate": { "description": "Required. Template for the prompt sent to the judge model.", "type": "string" }, "judgeAutoraterConfig": { "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig", "description": "Optional. Optional configuration for the judge LLM (Autorater)." }, "rubricGroupKey": { "type": "string", "description": "Use a pre-defined group of rubrics associated with the input. Refers to a key in the rubric_groups map of EvaluationInstance." }, "additionalConfig": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. Optional additional configuration for the metric." }, "rubricGenerationSpec": { "$ref": "GoogleCloudAiplatformV1beta1RubricGenerationSpec", "description": "Dynamically generate rubrics using this specification." } }, "id": "GoogleCloudAiplatformV1beta1LLMBasedMetricSpec" }, "GoogleCloudAiplatformV1beta1OutputInfo": { "type": "object", "id": "GoogleCloudAiplatformV1beta1OutputInfo", "description": "Describes the info for output of EvaluationService.", "properties": { "gcsOutputDirectory": { "readOnly": true, "type": "string", "description": "Output only. The full path of the Cloud Storage directory created, into which the evaluation results and aggregation results are written." } } }, "GoogleCloudAiplatformV1beta1EmbedContentRequestEmbedContentConfig": { "properties": { "taskType": { "enum": [ "UNSPECIFIED", "RETRIEVAL_QUERY", "RETRIEVAL_DOCUMENT", "SEMANTIC_SIMILARITY", "CLASSIFICATION", "CLUSTERING", "QUESTION_ANSWERING", "FACT_VERIFICATION", "CODE_RETRIEVAL_QUERY" ], "enumDescriptions": [ "Unset value, which will default to one of the other enum values.", "Specifies the given text is a query in a search/retrieval setting.", "Specifies the given text is a document from the corpus being searched.", "Specifies the given text will be used for STS.", "Specifies that the given text will be classified.", "Specifies that the embeddings will be used for clustering.", "Specifies that the embeddings will be used for question answering.", "Specifies that the embeddings will be used for fact verification.", "Specifies that the embeddings will be used for code retrieval." ], "description": "Optional. The task type of the embedding. Only applicable to text-only embedding models.", "type": "string" }, "title": { "description": "Optional. The title for the text. Only applicable to text-only embedding models.", "type": "string" }, "outputDimensionality": { "format": "int32", "description": "Optional. Reduced dimension for the output embedding. If set, excessive values in the output embedding are truncated from the end.", "type": "integer" }, "audioTrackExtraction": { "description": "Optional. Whether to extract audio from video content.", "type": "boolean" }, "autoTruncate": { "description": "Optional. Whether to silently truncate the input content if it's longer than the maximum sequence length. Only applicable to text-only embedding models.", "type": "boolean" }, "documentOcr": { "description": "Optional. Whether to enable OCR for document content.", "type": "boolean" } }, "description": "Configurations for the EmbedContent API.", "type": "object", "id": "GoogleCloudAiplatformV1beta1EmbedContentRequestEmbedContentConfig" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoObjectTracking": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoObjectTracking", "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoObjectTrackingInputs", "description": "The input parameters of this TrainingJob." } }, "description": "A TrainingJob that trains and uploads an AutoML Video ObjectTracking Model.", "type": "object" }, "GoogleCloudAiplatformV1beta1FetchFeatureValuesRequest": { "properties": { "format": { "description": "Specify response data format. If not set, KeyValue format will be used. Deprecated. Use FetchFeatureValuesRequest.data_format.", "enumDescriptions": [ "Not set. Will be treated as the KeyValue format.", "Return response data in key-value format.", "Return response data in proto Struct format." ], "enum": [ "FORMAT_UNSPECIFIED", "KEY_VALUE", "PROTO_STRUCT" ], "deprecated": true, "type": "string" }, "dataFormat": { "enum": [ "FEATURE_VIEW_DATA_FORMAT_UNSPECIFIED", "KEY_VALUE", "PROTO_STRUCT" ], "enumDescriptions": [ "Not set. Will be treated as the KeyValue format.", "Return response data in key-value format.", "Return response data in proto Struct format." ], "type": "string", "description": "Optional. Response data format. If not set, FeatureViewDataFormat.KEY_VALUE will be used." }, "id": { "description": "Simple ID. The whole string will be used as is to identify Entity to fetch feature values for.", "deprecated": true, "type": "string" }, "dataKey": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey", "description": "Optional. The request key to fetch feature values for." } }, "id": "GoogleCloudAiplatformV1beta1FetchFeatureValuesRequest", "type": "object", "description": "Request message for FeatureOnlineStoreService.FetchFeatureValues. All the features under the requested feature view will be returned." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassification": { "properties": { "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationMetadata" }, "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationInputs", "description": "The input parameters of this TrainingJob." } }, "description": "A TrainingJob that trains and uploads an AutoML Image Classification Model.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassification", "type": "object" }, "GoogleCloudAiplatformV1beta1LogprobsResult": { "properties": { "topCandidates": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates" }, "description": "A list of the top candidate tokens at each decoding step. The length of this list is equal to the total number of decoding steps." }, "chosenCandidates": { "type": "array", "description": "A list of the chosen candidate tokens at each decoding step. The length of this list is equal to the total number of decoding steps. Note that the chosen candidate might not be in `top_candidates`.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate" } } }, "id": "GoogleCloudAiplatformV1beta1LogprobsResult", "description": "The log probabilities of the tokens generated by the model. This is useful for understanding the model's confidence in its predictions and for debugging. For example, you can use log probabilities to identify when the model is making a less confident prediction or to explore alternative responses that the model considered. A low log probability can also indicate that the model is \"hallucinating\" or generating factually incorrect information.", "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingChunkMapsRoute": { "description": "Route information from Google Maps.", "properties": { "distanceMeters": { "format": "int32", "type": "integer", "description": "The total distance of the route, in meters." }, "duration": { "description": "The total duration of the route.", "format": "google-duration", "type": "string" }, "encodedPolyline": { "description": "An encoded polyline of the route. See https://developers.google.com/maps/documentation/utilities/polylinealgorithm", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsRoute" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplate", "description": "The specification of a SandboxEnvironmentTemplate. A SandboxEnvironmentTemplate defines a template for creating SandboxEnvironments.", "type": "object", "properties": { "displayName": { "type": "string", "description": "Required. The display name of the SandboxEnvironmentTemplate." }, "useGkeTd": { "description": "Optional. Immutable. Whether to provision the SandboxEnvironmentTemplate via the GKE TD pool.", "type": "boolean" }, "ingressControlConfig": { "description": "Optional. The configuration for private ingress (PSC-E) of this template. When set, the sandbox router is exposed privately via a PSC service attachment so VPC-SC customers can connect from their VPC over a private endpoint instead of the public internet. The resulting service attachment is surfaced on `SandboxEnvironment.connection_info.service_attachment`. Only the PSC-E (service-attachment/ingress) portion of `PrivateServiceConnectConfig` applies here: `enable_private_service_connect` and `project_allowlist` (the consumer projects allowed to connect). The nested `psc_interface_config` (PSC-I / egress) is not used for sandbox ingress; sandbox egress is configured via `egress_control_config` instead.", "$ref": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig" }, "createTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. The timestamp when this SandboxEnvironmentTemplate was created.", "type": "string" }, "name": { "description": "Identifier. The resource name of the SandboxEnvironmentTemplate. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentTemplates/{sandbox_environment_template}`", "type": "string" }, "customContainerEnvironment": { "description": "The sandbox environment for custom container workloads.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerEnvironment" }, "defaultContainerEnvironment": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateDefaultContainerEnvironment", "description": "The sandbox environment for default container workloads." }, "state": { "enumDescriptions": [ "The default value. This value is unused.", "Runtime resources are being allocated for the sandbox environment.", "Sandbox runtime is ready for serving.", "Sandbox runtime is halted, performing tear down tasks.", "Sandbox has terminated with underlying runtime failure.", "Sandbox has failed to provision." ], "type": "string", "description": "Output only. The state of the sandbox environment template.", "readOnly": true, "enum": [ "UNSPECIFIED", "PROVISIONING", "ACTIVE", "DEPROVISIONING", "DELETED", "FAILED" ] }, "persistentDiskConfig": { "description": "Optional. Configuration for attaching a persistent disk (PD) to each SandboxEnvironment created from this template. When unset (or when `enabled` is `false`), sandboxes created from this template are not backed by a persistent disk and rely on ephemeral storage only. See PersistentDiskConfig for details.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplatePersistentDiskConfig" }, "egressControlConfig": { "description": "Optional. The configuration for egress control of this template.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateEgressControlConfig" }, "updateTime": { "description": "Output only. The timestamp when this SandboxEnvironmentTemplate was most recently updated.", "format": "google-datetime", "readOnly": true, "type": "string" } } }, "GoogleCloudAiplatformV1beta1StreamingPredictResponse": { "id": "GoogleCloudAiplatformV1beta1StreamingPredictResponse", "type": "object", "properties": { "outputs": { "type": "array", "description": "The prediction output.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" } }, "parameters": { "description": "The parameters that govern the prediction.", "$ref": "GoogleCloudAiplatformV1beta1Tensor" } }, "description": "Response message for PredictionService.StreamingPredict." }, "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfig": { "type": "object", "description": "Config for Outpainting task.", "properties": { "outputSpec": { "enum": [ "OUTPUT_SPEC_UNSPECIFIED", "OUTPUT_SPEC_1920X1072x72", "OUTPUT_SPEC_1280X720x192", "OUTPUT_SPEC_960X544x432", "OUTPUT_SPEC_1280X720x144" ], "type": "string", "description": "The output specification (defines target resolution and frame count). Required.", "enumDescriptions": [ "", "High spec: 1920x1072 resolution, 72 total frames.", "Medium spec: 1280x720 resolution, 192 total frames.", "Low spec: 960x544 resolution, 432 total frames.", "Medium spec at 1280x720, 144 total frames. Shorter than OUTPUT_SPEC_1280X720x192 and higher quality at the same resolution." ] }, "inputFrames": { "items": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfigFrameSource" }, "type": "array", "description": "The input frames for outpainting. Required." } }, "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfig" }, "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition": { "description": "Monitoring alert triggered condition.", "properties": { "threshold": { "type": "number", "description": "A condition that compares a stats value against a threshold. Alert will be triggered if value above the threshold.", "format": "double" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition", "type": "object" }, "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig": { "type": "object", "description": "Configuration for the tuning resource usage assessment.", "id": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningResourceUsageAssessmentConfig", "properties": { "modelName": { "description": "Required. The name of the model used for tuning.", "type": "string" } } }, "GenaiVertexV1beta1FunctionCallStep": { "properties": { "name": { "description": "Required. The name of the tool to call.", "type": "string" }, "arguments": { "$ref": "GenaiVertexV1beta1Struct", "description": "Required. The arguments to pass to the function." } }, "id": "GenaiVertexV1beta1FunctionCallStep", "type": "object", "description": "A function tool call step." }, "GoogleCloudAiplatformV1beta1ModelMonitoringStats": { "description": "Represents the collection of statistics for a metric.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStats", "properties": { "tabularStats": { "description": "Generated tabular statistics.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringTabularStats" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringGcsSource": { "properties": { "gcsUri": { "description": "Google Cloud Storage URI to the input file(s). May contain wildcards. For more information on wildcards, see https://cloud.google.com/storage/docs/wildcards.", "type": "string" }, "format": { "type": "string", "enumDescriptions": [ "Data format unspecified, used when this field is unset.", "CSV files.", "TfRecord files", "JsonL files." ], "description": "Data format of the dataset.", "enum": [ "DATA_FORMAT_UNSPECIFIED", "CSV", "TF_RECORD", "JSONL" ] } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringGcsSource", "type": "object", "description": "Dataset spec for data stored in Google Cloud Storage." }, "GoogleCloudAiplatformV1beta1VertexAISearchDataStoreSpec": { "description": "Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec", "properties": { "filter": { "description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)", "type": "string" }, "dataStore": { "type": "string", "description": "Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1VertexAISearchDataStoreSpec" }, "GoogleCloudAiplatformV1beta1CountTokensRequest": { "id": "GoogleCloudAiplatformV1beta1CountTokensRequest", "type": "object", "properties": { "generationConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig", "description": "Optional. Generation config that the model will use to generate the response." }, "instances": { "items": { "type": "any" }, "type": "array", "description": "Optional. The instances that are the input to token counting call. Schema is identical to the prediction schema of the underlying model." }, "systemInstruction": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph." }, "contents": { "type": "array", "description": "Optional. Input content.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "model": { "description": "Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*`", "type": "string" }, "tools": { "description": "Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "type": "array" } }, "description": "Request message for PredictionService.CountTokens." }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecDiscreteValueCondition": { "properties": { "values": { "description": "Required. Matches values of the parent parameter of 'DISCRETE' type. All values must exist in `discrete_value_spec` of parent parameter. The Epsilon of the value matching is 1e-10.", "items": { "format": "double", "type": "number" }, "type": "array" } }, "description": "Represents the spec to match discrete values from parent parameter.", "type": "object", "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecDiscreteValueCondition" }, "GoogleCloudAiplatformV1beta1ContentsExample": { "id": "GoogleCloudAiplatformV1beta1ContentsExample", "properties": { "expectedContents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ContentsExampleExpectedContent" }, "description": "Required. The expected output for the given `contents`. To represent multi-step reasoning, this is a repeated field that contains the iterative steps of the expected output." }, "contents": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Required. The content of the conversation with the model that resulted in the expected output.", "type": "array" } }, "type": "object", "description": "A single example of a conversation with the model." }, "GoogleCloudAiplatformV1beta1UpdateFeatureGroupOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UpdateFeatureGroupOperationMetadata", "type": "object", "description": "Details of operations that perform update FeatureGroup.", "properties": { "genericMetadata": { "description": "Operation metadata for FeatureGroup.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1SchemaImageClassificationAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaImageClassificationAnnotation", "description": "Annotation details specific to image classification.", "properties": { "displayName": { "type": "string", "description": "The display name of the AnnotationSpec that this Annotation pertains to." }, "annotationSpecId": { "description": "The resource Id of the AnnotationSpec that this Annotation pertains to.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig": { "description": "Config for hybrid search.", "properties": { "sparseEmbeddingConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig", "description": "Optional. The configuration for sparse embedding generation. This field is optional the default behavior depends on the vector database choice on the RagCorpus." }, "denseEmbeddingModelPredictionEndpoint": { "description": "Required. The Vertex AI Prediction Endpoint that hosts the embedding model for dense embedding generations.", "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigVertexPredictionEndpoint" } }, "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigHybridSearchConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1TunedModelRef": { "properties": { "tuningJob": { "description": "Support migration from tuning job list page, from gemini-1.0-pro-002 to 1.5 and above.", "type": "string" }, "pipelineJob": { "description": "Support migration from tuning job list page, from bison model to gemini model.", "type": "string" }, "tunedModel": { "description": "Support migration from model registry.", "type": "string" } }, "description": "TunedModel Reference for legacy model migration.", "id": "GoogleCloudAiplatformV1beta1TunedModelRef", "type": "object" }, "GoogleCloudAiplatformV1beta1MetadataStoreMetadataStoreState": { "id": "GoogleCloudAiplatformV1beta1MetadataStoreMetadataStoreState", "description": "Represents state information for a MetadataStore.", "type": "object", "properties": { "diskUtilizationBytes": { "type": "string", "format": "int64", "description": "The disk utilization of the MetadataStore in bytes." } } }, "GenaiVertexV1beta1InteractionUsageGroundingToolCount": { "type": "object", "properties": { "type": { "enum": [ "TYPE_UNSPECIFIED", "GOOGLE_SEARCH", "GOOGLE_MAPS", "RETRIEVAL" ], "description": "The grounding tool type associated with the count.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.", "Grounding with Google Maps.", "Grounding with customer's data, for example, VertexAISearch." ] }, "count": { "format": "int32", "description": "The number of grounding tool counts.", "type": "integer" } }, "id": "GenaiVertexV1beta1InteractionUsageGroundingToolCount", "description": "The number of grounding tool counts." }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTabularRegressionPredictionResult": { "description": "Prediction output format for Tabular Regression.", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTabularRegressionPredictionResult", "properties": { "lowerBound": { "description": "The lower bound of the prediction interval.", "format": "float", "type": "number" }, "quantilePredictions": { "items": { "format": "float", "type": "number" }, "description": "Quantile predictions, in 1-1 correspondence with quantile_values.", "type": "array" }, "upperBound": { "type": "number", "description": "The upper bound of the prediction interval.", "format": "float" }, "quantileValues": { "description": "Quantile values.", "type": "array", "items": { "format": "float", "type": "number" } }, "value": { "format": "float", "type": "number", "description": "The regression value." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoClassificationPredictionResult": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoClassificationPredictionResult", "type": "object", "properties": { "timeSegmentEnd": { "description": "The end, exclusive, of the video's time segment in which the AnnotationSpec has been identified. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end. Note that for 'segment-classification' prediction type, this equals the original 'timeSegmentEnd' from the input instance, for other types it is the end of a shot or a 1 second interval respectively.", "format": "google-duration", "type": "string" }, "id": { "type": "string", "description": "The resource ID of the AnnotationSpec that had been identified." }, "displayName": { "description": "The display name of the AnnotationSpec that had been identified.", "type": "string" }, "confidence": { "type": "number", "format": "float", "description": "The Model's confidence in correction of this prediction, higher value means higher confidence." }, "type": { "description": "The type of the prediction. The requested types can be configured via parameters. This will be one of - segment-classification - shot-classification - one-sec-interval-classification", "type": "string" }, "timeSegmentStart": { "format": "google-duration", "description": "The beginning, inclusive, of the video's time segment in which the AnnotationSpec has been identified. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end. Note that for 'segment-classification' prediction type, this equals the original 'timeSegmentStart' from the input instance, for other types it is the start of a shot or a 1 second interval respectively.", "type": "string" } }, "description": "Prediction output format for Video Classification." }, "GoogleCloudAiplatformV1beta1RagFileParsingConfigAdvancedParser": { "type": "object", "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfigAdvancedParser", "properties": { "useAdvancedPdfParsing": { "type": "boolean", "description": "Whether to use advanced PDF parsing." } }, "description": "Specifies the advanced parsing for RagFiles." }, "GoogleCloudAiplatformV1beta1NearestNeighborQueryEmbedding": { "id": "GoogleCloudAiplatformV1beta1NearestNeighborQueryEmbedding", "description": "The embedding vector.", "type": "object", "properties": { "value": { "type": "array", "items": { "type": "number", "format": "float" }, "description": "Optional. Individual value in the embedding." } } }, "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInput": { "id": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInput", "type": "object", "properties": { "instances": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInstance" }, "description": "Required. Repeated TrajectoryAnyOrderMatch instance." }, "metricSpec": { "description": "Required. Spec for TrajectoryAnyOrderMatch metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchSpec" } }, "description": "Instances and metric spec for TrajectoryAnyOrderMatch metric." }, "GoogleCloudAiplatformV1beta1FulfillmentInstance": { "id": "GoogleCloudAiplatformV1beta1FulfillmentInstance", "type": "object", "description": "Spec for fulfillment instance.", "properties": { "instruction": { "type": "string", "description": "Required. Inference instruction prompt to compare prediction with." }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } } }, "GoogleCloudAiplatformV1beta1ToolNameMatchResults": { "properties": { "toolNameMatchMetricValues": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolNameMatchMetricValue" }, "readOnly": true, "description": "Output only. Tool name match metric values.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ToolNameMatchResults", "description": "Results for tool name match metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1VideoResponseFormat": { "type": "object", "properties": { "gcsUri": { "type": "string", "description": "Optional. The Google Cloud Storage URI to store the video output. Required for Vertex if delivery is URI." }, "aspectRatio": { "enum": [ "ASPECT_RATIO_UNSPECIFIED", "ASPECT_RATIO_SIXTEEN_BY_NINE", "ASPECT_RATIO_NINE_BY_SIXTEEN" ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "16:9 aspect ratio.", "9:16 aspect ratio." ], "description": "The aspect ratio for the video output." }, "duration": { "format": "google-duration", "description": "Optional. The duration for the video output.", "type": "string" }, "delivery": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Generated bytes are returned inline in the response.", "Generated content is stored and a URI is returned." ], "description": "Optional. Delivery mode for the generated content.", "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ] }, "resolution": { "description": "Optional. The video output resolution. Supported values: \"360p\", \"720p\", \"1080p\", \"4k\".", "type": "string" } }, "description": "Configuration for video-specific output formatting.", "id": "GoogleCloudAiplatformV1beta1VideoResponseFormat" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetricsConfidenceMetrics": { "description": "Metrics for a single confidence threshold.", "properties": { "f1Score": { "format": "float", "type": "number", "description": "Output only. The harmonic mean of recall and precision." }, "recall": { "format": "float", "type": "number", "description": "Output only. Recall for the given confidence threshold." }, "confidenceThreshold": { "format": "float", "description": "Output only. The confidence threshold value used to compute the metrics.", "type": "number" }, "precision": { "type": "number", "description": "Output only. Precision for the given confidence threshold.", "format": "float" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetricsConfidenceMetrics" }, "GenaiVertexV1beta1CodeExecution": { "id": "GenaiVertexV1beta1CodeExecution", "type": "object", "description": "A tool that can be used by the model to execute code.", "properties": {} }, "GoogleCloudAiplatformV1beta1RagFileParsingConfigLayoutParser": { "properties": { "maxParsingRequestsPerMin": { "type": "integer", "description": "The maximum number of requests the job is allowed to make to the Document AI processor per minute. Consult https://cloud.google.com/document-ai/quotas and the Quota page for your project to set an appropriate value here. If unspecified, a default value of 120 QPM would be used.", "format": "int32" }, "globalMaxParsingRequestsPerMin": { "description": "The maximum number of requests the job is allowed to make to the Document AI processor per minute in this project. Consult https://cloud.google.com/document-ai/quotas and the Quota page for your project to set an appropriate value here. If this value is not specified, max_parsing_requests_per_min will be used by indexing pipeline as the global limit.", "type": "integer", "format": "int32" }, "processorName": { "description": "The full resource name of a Document AI processor or processor version. The processor must have type `LAYOUT_PARSER_PROCESSOR`. If specified, the `additional_config.parse_as_scanned_pdf` field must be false. Format: * `projects/{project_id}/locations/{location}/processors/{processor_id}` * `projects/{project_id}/locations/{location}/processors/{processor_id}/processorVersions/{processor_version_id}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfigLayoutParser", "description": "Document AI Layout Parser config.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReportExecutionEventResponse": { "id": "GoogleCloudAiplatformV1beta1ReportExecutionEventResponse", "properties": {}, "type": "object", "description": "Response message for NotebookInternalService.ReportExecutionEvent." }, "GenaiVertexV1beta1CreateInteractionHttpRequest": { "id": "GenaiVertexV1beta1CreateInteractionHttpRequest", "type": "object", "description": "Request message for [InteractionsService.CreateInteractionHttp].", "properties": { "httpBody": { "$ref": "GoogleApiHttpBody", "description": "Required. The interaction to create." } } }, "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig": { "properties": { "bm25": { "description": "Use BM25 scoring algorithm.", "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25" } }, "type": "object", "description": "Configuration for sparse emebdding generation.", "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfig" }, "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputConfig": { "properties": { "gcsDestination": { "description": "The Cloud Storage location of the directory where the output is to be written to. In the given directory a new directory is created. Its name is `prediction--`, where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. Inside of it files `predictions_0001.`, `predictions_0002.`, ..., `predictions_N.` are created where `` depends on chosen predictions_format, and N may equal 0001 and depends on the total number of successfully predicted instances. If the Model has both instance and prediction schemata defined then each such file contains predictions as per the predictions_format. If prediction for any instance failed (partially or completely), then an additional `errors_0001.`, `errors_0002.`,..., `errors_N.` files are created (N depends on total number of failed predictions). These files contain the failed instances, as per their schema, followed by an additional `error` field which as value has google.rpc.Status containing only `code` and `message` fields.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "bigqueryDestination": { "description": "The BigQuery project or dataset location where the output is to be written to. If project is provided, a new dataset is created with name `prediction__` where is made BigQuery-dataset-name compatible (for example, most special characters become underscores), and timestamp is in YYYY_MM_DDThh_mm_ss_sssZ \"based on ISO-8601\" format. In the dataset two tables will be created, `predictions`, and `errors`. If the Model has both instance and prediction schemata defined then the tables have columns as follows: The `predictions` table contains instances for which the prediction succeeded, it has columns as per a concatenation of the Model's instance and prediction schemata. The `errors` table contains rows for which the prediction has failed, it has instance columns, as per the instance schema, followed by a single \"errors\" column, which as values has google.rpc.Status represented as a STRUCT, and containing only `code` and `message`.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination" }, "predictionsFormat": { "description": "Required. The format in which Vertex AI gives the predictions, must be one of the Model's supported_output_storage_formats.", "type": "string" }, "vertexMultimodalDatasetDestination": { "$ref": "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetDestination", "description": "The details for a Vertex Multimodal Dataset that will be created for the output." } }, "type": "object", "description": "Configures the output of BatchPredictionJob. See Model.supported_output_storage_formats for supported output formats, and how predictions are expressed via any of them.", "id": "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputConfig" }, "GoogleCloudAiplatformV1beta1RetrieveSkillsResponse": { "type": "object", "description": "Response message for SkillRegistryService.RetrieveSkills.", "properties": { "retrievedSkills": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveSkillsResponseRetrievedSkill" }, "description": "Skills ranked by similarity if applicable; otherwise, the order is undefined." } }, "id": "GoogleCloudAiplatformV1beta1RetrieveSkillsResponse" }, "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecSliceConfig": { "properties": { "range": { "description": "A range of values for a numerical feature. Example: `{\"range\":{\"low\":10000.0,\"high\":50000.0}}` will capture 12345 and 23334 in the slice.", "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecRange" }, "allValues": { "type": "boolean", "description": "If all_values is set to true, then all possible labels of the keyed feature will have another slice computed. Example: `{\"all_values\":{\"value\":true}}`" }, "value": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecValue", "description": "A unique specific value for a given feature. Example: `{ \"value\": { \"string_value\": \"12345\" } }`" } }, "description": "Specification message containing the config for this SliceSpec. When `kind` is selected as `value` and/or `range`, only a single slice will be computed. When `all_values` is present, a separate slice will be computed for each possible label/value for the corresponding key in `config`. Examples, with feature zip_code with values 12345, 23334, 88888 and feature country with values \"US\", \"Canada\", \"Mexico\" in the dataset: Example 1: { \"zip_code\": { \"value\": { \"float_value\": 12345.0 } } } A single slice for any data with zip_code 12345 in the dataset. Example 2: { \"zip_code\": { \"range\": { \"low\": 12345, \"high\": 20000 } } } A single slice containing data where the zip_codes between 12345 and 20000 For this example, data with the zip_code of 12345 will be in this slice. Example 3: { \"zip_code\": { \"range\": { \"low\": 10000, \"high\": 20000 } }, \"country\": { \"value\": { \"string_value\": \"US\" } } } A single slice containing data where the zip_codes between 10000 and 20000 has the country \"US\". For this example, data with the zip_code of 12345 and country \"US\" will be in this slice. Example 4: { \"country\": {\"all_values\": { \"value\": true } } } Three slices are computed, one for each unique country in the dataset. Example 5: { \"country\": { \"all_values\": { \"value\": true } }, \"zip_code\": { \"value\": { \"float_value\": 12345.0 } } } Three slices are computed, one for each unique country in the dataset where the zip_code is also 12345. For this example, data with zip_code 12345 and country \"US\" will be in one slice, zip_code 12345 and country \"Canada\" in another slice, and zip_code 12345 and country \"Mexico\" in another slice, totaling 3 slices.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecSliceConfig" }, "GoogleCloudAiplatformV1beta1GroundednessInstance": { "description": "Spec for groundedness instance.", "properties": { "context": { "description": "Required. Background information provided in context used to compare against the prediction.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1GroundednessInstance" }, "GenaiVertexV1beta1Voice": { "type": "object", "id": "GenaiVertexV1beta1Voice", "properties": { "expireTime": { "format": "google-datetime", "description": "Output only. The timestamp at which a custom stored voice (`store = true`) or replicated voice key (`store = false`) expires. For custom stored voices (`store = true`), this expiration time is extended when the voice is used for speech synthesis or as a `base_voice` in `CreateVoice`. Unset for prebuilt catalog voices (`\"prebuilt\"`), which do not expire.", "readOnly": true, "type": "string" }, "pitch": { "enum": [ "PITCH_UNSPECIFIED", "PITCH_LOW", "PITCH_MEDIUM", "PITCH_HIGH" ], "type": "string", "description": "Optional. Voice pitch classification.", "enumDescriptions": [ "Pitch is unspecified.", "Lower pitch voice.", "Medium pitch voice.", "Higher pitch voice." ] }, "accent": { "description": "Optional. Regional accent descriptor (e.g. \"American\", \"British\").", "type": "string" }, "displayName": { "description": "Optional. User-provided display name for a stored voice (`store = true`), or the catalog name for a prebuilt voice.", "type": "string" }, "replicated": { "$ref": "GenaiVertexV1beta1VoiceReplicatedVoice", "description": "Input only. Parameters for replicated voice generation. Required on input when `type` is `\"replicated\"`. Not returned in responses." }, "usage": { "$ref": "GenaiVertexV1beta1InteractionUsage", "description": "Output only. Token usage statistics for the voice creation request. Populated only in the response of `CreateVoice` when `type` is `\"prompted\"`; unset for `\"replicated\"` and in `GetVoice` and `ListVoices` responses.", "readOnly": true }, "sampleAudio": { "$ref": "GenaiVertexV1beta1AudioData", "readOnly": true, "description": "Output only. Sample audio (synthesizer prompt audio) generated for a prompted voice. Populated only in `CreateVoice` and `GetVoice` responses when `type` is `\"prompted\"`; unset in `ListVoices` responses and for `\"replicated\"` or `\"prebuilt\"` voices." }, "model": { "type": "string", "description": "Optional. The model used to design or replicate the voice. If omitted in `CreateVoice`, defaults to the latest supported voice design model. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for custom voices (`\"prompted\"` and `\"replicated\"`); unset for `\"prebuilt\"` voices. Created voices can be synthesized across any supported TTS synthesis model." }, "gender": { "description": "Optional. Perceived voice gender presentation (e.g. \"female\", \"male\", \"neutral\").", "type": "string" }, "description": { "description": "Optional. Descriptive summary of vocal timbre, personality, and tone.", "type": "string" }, "persona": { "type": "string", "description": "Optional. Intended persona or character archetype (e.g. \"Warm, Friendly\", \"Narrator\")." }, "languageCode": { "description": "Optional. Primary BCP-47 language tag (e.g. \"en-US\", \"fr-FR\").", "type": "string" }, "prompted": { "description": "Parameters for prompted voice generation. Required in `CreateVoice` when `type` is `\"prompted\"`. Returned in `CreateVoice`, `GetVoice`, and `ListVoices` responses for prompted voices.", "$ref": "GenaiVertexV1beta1VoicePromptedVoice" }, "context": { "description": "Optional. Optimal usage context or domain (e.g. \"Conversational\", \"Audiobook\", \"News\").", "type": "string" }, "id": { "description": "Output only. The unique identifier of the voice. * For Google-managed custom voices (`store = true`), this is a generated ID with prefix `voice_` (for example, `voice_abc123def456`). Pass `voices/{id}` as the `name` in `GetVoice` and `DeleteVoice`, and pass `{id}` directly to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis. * For prebuilt catalog voices (`\"prebuilt\"` returned by `ListVoices`), this is the speaker name (for example, `Puck` or `Charon`). * Unset when `CreateVoice` is called with `store = false`.", "readOnly": true, "type": "string" }, "type": { "enumDescriptions": [ "Default value. This value is unused and must not be specified.", "A custom voice replicated from a reference audio sample and speaker consent recording.", "A custom voice generated from a natural-language text prompt (optionally editing or remixing a `base_voice`).", "A built-in system voice from Google's voice catalog (e.g., `Puck`, `Charon`). Returned in responses; cannot be specified as the type in `CreateVoice`." ], "type": "string", "description": "Required. The type of the voice. In `CreateVoice`, must be `\"replicated\"` or `\"prompted\"`. In `ListVoices` responses, may also be `\"prebuilt\"`.", "enum": [ "VOICE_TYPE_UNSPECIFIED", "VOICE_TYPE_REPLICATED", "VOICE_TYPE_PROMPTED", "VOICE_TYPE_PREBUILT" ] }, "key": { "type": "string", "readOnly": true, "description": "Output only. The client-managed voice replication key (with prefix `voicekey_`). Returned only by `CreateVoice` when `type` is `\"replicated\"` and `store` is `false`. Pass this key to `SpeechConfig.voice_config.voice` (or `SpeechConfig.voice`) during speech synthesis." }, "regionCode": { "description": "Optional. ISO 3166-1 alpha-2 or UN M.49 geographic region code (e.g. \"US\", \"GB\", \"001\").", "type": "string" } }, "description": "A voice resource representing either a custom voice (created via `CreateVoice`) or a prebuilt system voice (returned by `ListVoices`)." }, "GoogleCloudAiplatformV1beta1EventActions": { "description": "Actions are parts of events that are executed by the agent.", "properties": { "artifactDelta": { "type": "object", "description": "Optional. Indicates that the event is updating an artifact. key is the filename, value is the version.", "additionalProperties": { "format": "int32", "type": "integer" } }, "transferAgent": { "description": "Optional. If set, the event transfers to the specified agent.", "type": "string" }, "stateDelta": { "description": "Optional. Indicates that the event is updating the state with the given delta.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "escalate": { "description": "Optional. The agent is escalating to a higher level agent.", "type": "boolean" }, "skipSummarization": { "type": "boolean", "description": "Optional. If true, it won't call model to summarize function response. Only used for function_response event." }, "requestedAuthConfigs": { "description": "Optional. Will only be set by a tool response indicating tool request euc. Struct key is the function call id since one function call response (from model) could correspond to multiple function calls. Struct value is the required auth config, which can be another struct.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1EventActions" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoClassification": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoClassification", "type": "object", "properties": { "inputs": { "description": "The input parameters of this TrainingJob.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoClassificationInputs" } }, "description": "A TrainingJob that trains and uploads an AutoML Video Classification Model." }, "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec": { "id": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec", "description": "A machine and model container spec.", "type": "object", "properties": { "machineSpec": { "description": "Output only. The machine spec.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1MachineSpec" }, "containerSpec": { "readOnly": true, "description": "Output only. The model container spec.", "$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingMetadata": { "properties": { "trainCostMilliNodeHours": { "description": "Output only. The actual training cost of the model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed the train budget.", "format": "int64", "type": "string" }, "evaluatedDataItemsBigqueryUri": { "type": "string", "description": "BigQuery destination uri for exported evaluated examples." } }, "description": "Model metadata specific to Seq2Seq Plus Forecasting.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingMetadata" }, "GoogleCloudAiplatformV1beta1UpsertDatapointsResponse": { "id": "GoogleCloudAiplatformV1beta1UpsertDatapointsResponse", "properties": {}, "type": "object", "description": "Response message for IndexService.UpsertDatapoints" }, "GoogleCloudAiplatformV1beta1WriteFeatureValuesPayload": { "properties": { "entityId": { "description": "Required. The ID of the entity.", "type": "string" }, "featureValues": { "description": "Required. Feature values to be written, mapping from Feature ID to value. Up to 100,000 `feature_values` entries may be written across all payloads. The feature generation time, aligned by days, must be no older than five years (1825 days) and no later than one year (366 days) in the future.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1FeatureValue" } } }, "id": "GoogleCloudAiplatformV1beta1WriteFeatureValuesPayload", "type": "object", "description": "Contains Feature values to be written for a specific entity." }, "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadata": { "description": "Runtime operation metadata with regard to Matching Engine Index.", "type": "object", "id": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadata", "properties": { "dataBytesCount": { "type": "string", "format": "int64", "description": "The ingested data size in bytes." }, "contentValidationStats": { "items": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataContentValidationStats" }, "description": "The validation stats of the content (per file) to be inserted or updated on the Matching Engine Index resource. Populated if contentsDeltaUri is provided as part of Index.metadata. Please note that, currently for those files that are broken or has unsupported file format, we will not have the stats for those files.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1RayMetricSpec": { "description": "Configuration for the Ray metrics.", "properties": { "disabled": { "type": "boolean", "description": "Optional. Flag to disable the Ray metrics collection." }, "enableUsageStatsCollection": { "description": "Optional. Flag to enable the Ray usage stats collection by Anyscale. https://docs.ray.io/en/latest/cluster/usage-stats.html#usage-stats-collection Disable by default.", "type": "boolean" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RayMetricSpec" }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpec": { "type": "object", "description": "Represents a parameter spec with condition from its parent parameter.", "properties": { "parentIntValues": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecIntValueCondition", "description": "The spec for matching values from a parent parameter of `INTEGER` type." }, "parameterSpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpec", "description": "Required. The spec for a conditional parameter." }, "parentDiscreteValues": { "description": "The spec for matching values from a parent parameter of `DISCRETE` type.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecDiscreteValueCondition" }, "parentCategoricalValues": { "description": "The spec for matching values from a parent parameter of `CATEGORICAL` type.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecCategoricalValueCondition" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpec" }, "GoogleCloudAiplatformV1beta1EvaluateInstancesResponse": { "id": "GoogleCloudAiplatformV1beta1EvaluateInstancesResponse", "type": "object", "description": "Response message for EvaluationService.EvaluateInstances.", "properties": { "summarizationHelpfulnessResult": { "$ref": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessResult", "description": "Result for summarization helpfulness metric." }, "trajectoryAnyOrderMatchResults": { "description": "Result for trajectory any order match metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchResults" }, "trajectoryInOrderMatchResults": { "description": "Result for trajectory in order match metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchResults" }, "questionAnsweringHelpfulnessResult": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessResult", "description": "Result for question answering helpfulness metric." }, "trajectoryRecallResults": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryRecallResults", "description": "Results for trajectory recall metric." }, "safetyResult": { "description": "Result for safety metric.", "$ref": "GoogleCloudAiplatformV1beta1SafetyResult" }, "questionAnsweringRelevanceResult": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceResult", "description": "Result for question answering relevance metric." }, "coherenceResult": { "description": "Result for coherence metric.", "$ref": "GoogleCloudAiplatformV1beta1CoherenceResult" }, "fluencyResult": { "description": "LLM-based metric evaluation result. General text generation metrics, applicable to other categories. Result for fluency metric.", "$ref": "GoogleCloudAiplatformV1beta1FluencyResult" }, "metricResults": { "description": "Metric results for each instance. The order of the metric results is guaranteed to be the same as the order of the instances in the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MetricResult" }, "type": "array" }, "toolParameterKeyMatchResults": { "description": "Results for tool parameter key match metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchResults" }, "rubricBasedInstructionFollowingResult": { "$ref": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingResult", "description": "Result for rubric based instruction following metric." }, "cometResult": { "$ref": "GoogleCloudAiplatformV1beta1CometResult", "description": "Translation metrics. Result for Comet metric." }, "exactMatchResults": { "$ref": "GoogleCloudAiplatformV1beta1ExactMatchResults", "description": "Auto metric evaluation results. Results for exact match metric." }, "bleuResults": { "description": "Results for bleu metric.", "$ref": "GoogleCloudAiplatformV1beta1BleuResults" }, "groundednessResult": { "description": "Result for groundedness metric.", "$ref": "GoogleCloudAiplatformV1beta1GroundednessResult" }, "summarizationVerbosityResult": { "description": "Result for summarization verbosity metric.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationVerbosityResult" }, "toolCallValidResults": { "description": "Tool call metrics. Results for tool call valid metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolCallValidResults" }, "pairwiseSummarizationQualityResult": { "description": "Result for pairwise summarization quality metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityResult" }, "pointwiseMetricResult": { "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricResult", "description": "Generic metrics. Result for pointwise metric." }, "summarizationQualityResult": { "description": "Summarization only metrics. Result for summarization quality metric.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationQualityResult" }, "questionAnsweringCorrectnessResult": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessResult", "description": "Result for question answering correctness metric." }, "questionAnsweringQualityResult": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityResult", "description": "Question answering only metrics. Result for question answering quality metric." }, "trajectoryPrecisionResults": { "description": "Result for trajectory precision metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionResults" }, "pairwiseQuestionAnsweringQualityResult": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityResult", "description": "Result for pairwise question answering quality metric." }, "metricxResult": { "$ref": "GoogleCloudAiplatformV1beta1MetricxResult", "description": "Result for Metricx metric." }, "rougeResults": { "$ref": "GoogleCloudAiplatformV1beta1RougeResults", "description": "Results for rouge metric." }, "pairwiseMetricResult": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricResult", "description": "Result for pairwise metric." }, "toolParameterKvMatchResults": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchResults", "description": "Results for tool parameter key value match metric." }, "fulfillmentResult": { "description": "Result for fulfillment metric.", "$ref": "GoogleCloudAiplatformV1beta1FulfillmentResult" }, "toolNameMatchResults": { "description": "Results for tool name match metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolNameMatchResults" }, "trajectoryExactMatchResults": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchResults", "description": "Result for trajectory exact match metric." }, "trajectorySingleToolUseResults": { "description": "Results for trajectory single tool use metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseResults" } } }, "GoogleCloudAiplatformV1beta1ModelOriginalModelInfo": { "id": "GoogleCloudAiplatformV1beta1ModelOriginalModelInfo", "properties": { "model": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the Model this Model is a copy of, including the revision. Format: `projects/{project}/locations/{location}/models/{model_id}@{version_id}`" } }, "type": "object", "description": "Contains information about the original Model if this Model is a copy." }, "GoogleCloudAiplatformV1beta1SummarizationVerbositySpec": { "id": "GoogleCloudAiplatformV1beta1SummarizationVerbositySpec", "type": "object", "description": "Spec for summarization verbosity score metric.", "properties": { "useReference": { "type": "boolean", "description": "Optional. Whether to use instance.reference to compute summarization verbosity." }, "version": { "description": "Optional. Which version to use for evaluation.", "format": "int32", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1MigratableResource": { "id": "GoogleCloudAiplatformV1beta1MigratableResource", "description": "Represents one resource that exists in automl.googleapis.com, datalabeling.googleapis.com or ml.googleapis.com.", "type": "object", "properties": { "mlEngineModelVersion": { "$ref": "GoogleCloudAiplatformV1beta1MigratableResourceMlEngineModelVersion", "readOnly": true, "description": "Output only. Represents one Version in ml.googleapis.com." }, "lastUpdateTime": { "description": "Output only. Timestamp when this MigratableResource was last updated.", "readOnly": true, "format": "google-datetime", "type": "string" }, "automlModel": { "$ref": "GoogleCloudAiplatformV1beta1MigratableResourceAutomlModel", "description": "Output only. Represents one Model in automl.googleapis.com.", "readOnly": true }, "dataLabelingDataset": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDataset", "readOnly": true, "description": "Output only. Deprecated: Data Labeling Dataset migration is no longer supported. Represents one Dataset in datalabeling.googleapis.com." }, "lastMigrateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when the last migration attempt on this MigratableResource started. Will not be set if there's no migration attempt on this MigratableResource." }, "automlDataset": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1MigratableResourceAutomlDataset", "description": "Output only. Represents one Dataset in automl.googleapis.com." } } }, "GoogleCloudAiplatformV1beta1BleuInput": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BleuInput", "description": "Input for bleu metric.", "properties": { "metricSpec": { "description": "Required. Spec for bleu score metric.", "$ref": "GoogleCloudAiplatformV1beta1BleuSpec" }, "instances": { "description": "Required. Repeated bleu instances.", "items": { "$ref": "GoogleCloudAiplatformV1beta1BleuInstance" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1CreateIndexOperationMetadata": { "properties": { "nearestNeighborSearchOperationMetadata": { "description": "The operation metadata with regard to Matching Engine Index operation.", "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadata" }, "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "description": "Runtime operation information for IndexService.CreateIndex.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateIndexOperationMetadata" }, "GenaiVertexV1beta1CreateInteractionRequest": { "id": "GenaiVertexV1beta1CreateInteractionRequest", "properties": { "background": { "type": "boolean", "description": "Input only. Whether to run the model interaction in the background." }, "stream": { "description": "Input only. Whether the interaction will be streamed.", "type": "boolean" }, "interaction": { "description": "The interaction to create.", "$ref": "GenaiVertexV1beta1Interaction" }, "store": { "type": "boolean", "description": "Input only. Whether to store the response and request for later retrieval." } }, "description": "Configuration parameters for creating an interaction.", "type": "object" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfigRandomSampling": { "description": "Configuration for random sampling.", "type": "object", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfigRandomSampling", "properties": { "percentage": { "description": "Required. The percentage of traces to sample for evaluation. Must be an integer between `1` and `100`.", "type": "integer", "format": "int32" } } }, "GoogleCloudAiplatformV1beta1ReportRuntimeEventRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReportRuntimeEventRequest", "properties": { "internalOsServiceStateInstances": { "items": { "$ref": "GoogleCloudAiplatformV1beta1InternalOsServiceStateInstance" }, "type": "array", "description": "Optional. The details of the internal os service states." }, "eventType": { "enum": [ "EVENT_TYPE_UNSPECIFIED", "HEARTBEAT", "IDLE" ], "enumDescriptions": [ "Unspecified.", "Used for readiness reporting.", "Used for idle reporting." ], "type": "string", "description": "Required. The type of the event." }, "eventDetails": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The details of the request for debug." }, "vmToken": { "type": "string", "description": "Required. The VM identity token (a JWT) for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity" }, "internalOsServiceStateInstance": { "description": "The details of the internal os service states.", "items": { "$ref": "GoogleCloudAiplatformV1beta1InternalOsServiceStateInstance" }, "type": "array", "deprecated": true } }, "description": "Request message for NotebookInternalService.ReportRuntimeEvent." }, "GoogleCloudAiplatformV1beta1GenerationConfigThinkingConfig": { "id": "GoogleCloudAiplatformV1beta1GenerationConfigThinkingConfig", "properties": { "includeThoughts": { "description": "Optional. If true, the model will include its thoughts in the response. \"Thoughts\" are the intermediate steps the model takes to arrive at the final response. They can provide insights into the model's reasoning process and help with debugging. If this is true, thoughts are returned only when available.", "type": "boolean" }, "thinkingLevel": { "enum": [ "THINKING_LEVEL_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "MINIMAL" ], "enumDescriptions": [ "Unspecified thinking level.", "Low thinking level.", "Medium thinking level.", "High thinking level.", "MINIMAL thinking level." ], "type": "string", "description": "Optional. The number of thoughts tokens that the model should generate." }, "thinkingBudget": { "type": "integer", "format": "int32", "description": "Optional. The token budget for the model's thinking process. The model will make a best effort to stay within this budget. This can be used to control the trade-off between response quality and latency." } }, "type": "object", "description": "Configuration for the model's thinking features. \"Thinking\" is a process where the model breaks down a complex task into smaller, manageable steps. This allows the model to reason about the task, plan its approach, and execute the plan to generate a high-quality response." }, "GoogleCloudAiplatformV1beta1RagFileChunkingConfigFixedLengthChunking": { "properties": { "chunkOverlap": { "type": "integer", "format": "int32", "description": "The overlap between chunks." }, "chunkSize": { "description": "The size of the chunks.", "type": "integer", "format": "int32" } }, "type": "object", "description": "Specifies the fixed length chunking config.", "id": "GoogleCloudAiplatformV1beta1RagFileChunkingConfigFixedLengthChunking" }, "GoogleCloudAiplatformV1beta1RougeMetricValue": { "properties": { "score": { "type": "number", "format": "float", "description": "Output only. Rouge score.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1RougeMetricValue", "description": "Rouge metric value for an instance.", "type": "object" }, "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInput": { "description": "Input for summarization helpfulness metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInput", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessSpec", "description": "Required. Spec for summarization helpfulness score metric." }, "instance": { "description": "Required. Summarization helpfulness instance.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInstance" } } }, "GoogleCloudAiplatformV1beta1VeoTuningSpec": { "id": "GoogleCloudAiplatformV1beta1VeoTuningSpec", "type": "object", "description": "Tuning Spec for Veo Model Tuning.", "properties": { "trainingDatasetUri": { "description": "Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.", "type": "string" }, "validationDatasetUri": { "description": "Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.", "type": "string" }, "hyperParameters": { "$ref": "GoogleCloudAiplatformV1beta1VeoHyperParameters", "description": "Optional. Hyperparameters for Veo." } } }, "GoogleCloudAiplatformV1beta1ExtensionManifest": { "properties": { "apiSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExtensionManifestApiSpec", "description": "Required. Immutable. The API specification shown to the LLM." }, "description": { "type": "string", "description": "Required. The natural language description shown to the LLM. It should describe the usage of the extension, and is essential for the LLM to perform reasoning. e.g., if the extension is a data store, you can let the LLM know what data it contains." }, "name": { "description": "Required. Extension name shown to the LLM. The name can be up to 128 characters long.", "type": "string" }, "authConfig": { "description": "Required. Immutable. Type of auth supported by this extension.", "$ref": "GoogleCloudAiplatformV1beta1AuthConfig" } }, "id": "GoogleCloudAiplatformV1beta1ExtensionManifest", "description": "Manifest spec of an Extension needed for runtime execution.", "type": "object" }, "GenaiVertexV1beta1AudioResponseFormat": { "properties": { "mimeType": { "description": "The MIME type of the audio output.", "type": "string", "enum": [ "TYPE_UNSPECIFIED", "TYPE_MP3", "TYPE_OGG_OPUS", "TYPE_L16", "TYPE_WAV", "TYPE_ALAW", "TYPE_MULAW" ], "enumDescriptions": [ "Default value. This value is unused.", "MP3 audio format.", "OGG Opus audio format.", "Raw PCM (L16) audio format.", "WAV audio format.", "A-law audio format.", "Mu-law audio format." ] }, "delivery": { "description": "The delivery mode for the audio output.", "enumDescriptions": [ "Default value. This value is unused.", "Audio data is returned inline in the response.", "Audio data is returned as a URI." ], "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ], "type": "string" }, "bitRate": { "type": "integer", "description": "Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).", "format": "int32" }, "sampleRate": { "format": "int32", "description": "Sample rate in Hz.", "type": "integer" } }, "id": "GenaiVertexV1beta1AudioResponseFormat", "description": "Configuration for audio output format.", "type": "object" }, "GoogleCloudAiplatformV1beta1SummarizationVerbosityInput": { "description": "Input for summarization verbosity metric.", "type": "object", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1SummarizationVerbositySpec", "description": "Required. Spec for summarization verbosity score metric." }, "instance": { "description": "Required. Summarization verbosity instance.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationVerbosityInstance" } }, "id": "GoogleCloudAiplatformV1beta1SummarizationVerbosityInput" }, "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequest", "description": "Request message for FeaturestoreService.ImportFeatureValues.", "properties": { "disableIngestionAnalysis": { "description": "If true, API doesn't start ingestion analysis pipeline.", "type": "boolean" }, "entityIdField": { "description": "Source column that holds entity IDs. If not provided, entity IDs are extracted from the column named entity_id.", "type": "string" }, "featureSpecs": { "description": "Required. Specifications defining which Feature values to import from the entity. The request fails if no feature_specs are provided, and having multiple feature_specs for one Feature is not allowed.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequestFeatureSpec" } }, "workerCount": { "format": "int32", "type": "integer", "description": "Specifies the number of workers that are used to write data to the Featurestore. Consider the online serving capacity that you require to achieve the desired import throughput without interfering with online serving. The value must be positive, and less than or equal to 100. If not set, defaults to using 1 worker. The low count ensures minimal impact on online serving performance." }, "disableOnlineServing": { "type": "boolean", "description": "If set, data will not be imported for online serving. This is typically used for backfilling, where Feature generation timestamps are not in the timestamp range needed for online serving." }, "csvSource": { "$ref": "GoogleCloudAiplatformV1beta1CsvSource" }, "featureTimeField": { "description": "Source column that holds the Feature timestamp for all Feature values in each entity.", "type": "string" }, "featureTime": { "format": "google-datetime", "type": "string", "description": "Single Feature timestamp for all entities being imported. The timestamp must not have higher than millisecond precision." }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource" }, "avroSource": { "$ref": "GoogleCloudAiplatformV1beta1AvroSource" } } }, "GoogleCloudAiplatformV1beta1ModelBaseModelSource": { "id": "GoogleCloudAiplatformV1beta1ModelBaseModelSource", "type": "object", "properties": { "modelGardenSource": { "description": "Source information of Model Garden models.", "$ref": "GoogleCloudAiplatformV1beta1ModelGardenSource" }, "genieSource": { "description": "Information about the base model of Genie models.", "$ref": "GoogleCloudAiplatformV1beta1GenieSource" } }, "description": "User input field to specify the base model source. Currently it only supports specifing the Model Garden models and Genie models." }, "GoogleCloudAiplatformV1beta1CreateFeaturestoreOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Featurestore." } }, "id": "GoogleCloudAiplatformV1beta1CreateFeaturestoreOperationMetadata", "type": "object", "description": "Details of operations that perform create Featurestore." }, "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataInputConfig": { "description": "The time series Dataset's data source. The Dataset doesn't store the data directly, but only pointer(s) to its data.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataInputConfig", "properties": { "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataGcsSource" }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataBigQuerySource" } } }, "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategy": { "description": "Configures garbage collection of Runtime Revisions.", "properties": { "keepNLatest": { "description": "Optional. Keeps only the latest N Runtime Revisions active.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategyKeepNLatest" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategy", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreOptimized": { "description": "Optimized storage type", "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreOptimized" }, "GenaiVertexV1beta1Function": { "type": "object", "id": "GenaiVertexV1beta1Function", "properties": { "name": { "type": "string", "description": "The name of the function." }, "parameters": { "description": "The JSON Schema for the function's parameters.", "$ref": "GenaiVertexV1beta1Value" }, "description": { "description": "A description of the function.", "type": "string" } }, "description": "A tool that can be used by the model." }, "GoogleCloudAiplatformV1beta1FeatureViewDataKey": { "properties": { "key": { "type": "string", "description": "String key to use for lookup." }, "compositeKey": { "description": "The actual Entity ID will be composed from this struct. This should match with the way ID is defined in the FeatureView spec.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKeyCompositeKey" } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewDataKey", "type": "object", "description": "Lookup key for a feature view." }, "GoogleCloudAiplatformV1beta1DeployedModel": { "id": "GoogleCloudAiplatformV1beta1DeployedModel", "description": "A deployment of a Model. Endpoints contain one or more DeployedModels.", "type": "object", "properties": { "sharedResources": { "description": "The resource name of the shared DeploymentResourcePool to deploy on. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`", "type": "string" }, "status": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModelStatus", "readOnly": true, "description": "Output only. Runtime status of the deployed model." }, "speculativeDecodingSpec": { "$ref": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpec", "description": "Optional. Spec for configuring speculative decoding." }, "disableContainerLogging": { "description": "For custom-trained Models and AutoML Tabular Models, the container of the DeployedModel instances will send `stderr` and `stdout` streams to Cloud Logging by default. Please note that the logs incur cost, which are subject to [Cloud Logging pricing](https://cloud.google.com/logging/pricing). User can disable container logging by setting this flag to true.", "type": "boolean" }, "privateEndpoints": { "description": "Output only. Provide paths for users to send predict/explain/health requests directly to the deployed model services running on Cloud via private services access. This field is populated if network is configured.", "$ref": "GoogleCloudAiplatformV1beta1PrivateEndpoints", "readOnly": true }, "explanationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec", "description": "Explanation configuration for this DeployedModel. When deploying a Model using EndpointService.DeployModel, this value overrides the value of Model.explanation_spec. All fields of explanation_spec are optional in the request. If a field of explanation_spec is not populated, the value of the same field of Model.explanation_spec is inherited. If the corresponding Model.explanation_spec is not populated, all fields of the explanation_spec will be used for the explanation configuration." }, "displayName": { "description": "The display name of the DeployedModel. If not provided upon creation, the Model's display_name is used.", "type": "string" }, "serviceAccount": { "type": "string", "description": "The service account that the DeployedModel's container runs as. Specify the email address of the service account. If this service account is not specified, the container runs as a service account that doesn't have access to the resource project. Users deploying the Model must have the `iam.serviceAccounts.actAs` permission on this service account." }, "createTime": { "format": "google-datetime", "description": "Output only. Timestamp when the DeployedModel was created.", "readOnly": true, "type": "string" }, "rolloutOptions": { "$ref": "GoogleCloudAiplatformV1beta1RolloutOptions", "description": "Options for configuring rolling deployments." }, "systemLabels": { "additionalProperties": { "type": "string" }, "description": "System labels to apply to Model Garden deployments. System labels are managed by Google for internal use only.", "type": "object" }, "id": { "type": "string", "description": "Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`." }, "modelVersionId": { "description": "Output only. The version ID of the model that is deployed.", "readOnly": true, "type": "string" }, "enableContainerLogging": { "type": "boolean", "description": "If true, the container of the DeployedModel instances will send `stderr` and `stdout` streams to Cloud Logging. Only supported for custom-trained Models and AutoML Tabular Models." }, "model": { "type": "string", "description": "The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed." }, "dedicatedResources": { "description": "A description of resources that are dedicated to the DeployedModel, and that need a higher degree of manual configuration.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "fasterDeploymentConfig": { "description": "Configuration for faster model deployment.", "$ref": "GoogleCloudAiplatformV1beta1FasterDeploymentConfig" }, "enableAccessLogging": { "description": "If true, online prediction access logs are sent to Cloud Logging. These logs are like standard server access logs, containing information like timestamp and latency for each prediction request. Note that logs may incur a cost, especially if your project receives prediction requests at a high queries per second rate (QPS). Estimate your costs before enabling this option.", "type": "boolean" }, "disableExplanations": { "type": "boolean", "description": "If true, deploy the model without explainable feature, regardless the existence of Model.explanation_spec or explanation_spec." }, "automaticResources": { "$ref": "GoogleCloudAiplatformV1beta1AutomaticResources", "description": "A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration." }, "checkpointId": { "description": "The checkpoint id of the model.", "type": "string" }, "fullFineTunedResources": { "description": "Optional. Resources for a full fine tuned model.", "$ref": "GoogleCloudAiplatformV1beta1FullFineTunedResources" }, "gdcConnectedModel": { "description": "GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.", "type": "string" } } }, "GenaiVertexV1beta1StepDelta": { "id": "GenaiVertexV1beta1StepDelta", "type": "object", "properties": { "index": { "format": "int32", "type": "integer" }, "delta": { "$ref": "GenaiVertexV1beta1StepDeltaData" } } }, "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData": { "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData", "type": "object", "description": "Instance data used to populate placeholders in a metric prompt template.", "properties": { "text": { "description": "Text data.", "type": "string" }, "contents": { "description": "List of Gemini content data.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceDataContents" } } }, "GoogleCloudAiplatformV1beta1SpeechMetadata": { "description": "Structured Metadata Sub-Message for Part", "id": "GoogleCloudAiplatformV1beta1SpeechMetadata", "properties": { "style": { "description": "Optional. Natural language description of the vocal style (e.g., \"cheerful\").", "type": "string" }, "speaker": { "description": "Optional. Identifies which speaker is speaking this turn.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySourceFeatureGroup": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySourceFeatureGroup", "properties": { "featureGroupId": { "description": "Required. Identifier of the feature group.", "type": "string" }, "featureIds": { "description": "Required. Identifiers of features under the feature group.", "type": "array", "items": { "type": "string" } } }, "description": "Features belonging to a single feature group that will be synced to Online Store." }, "GoogleCloudAiplatformV1beta1TuningJob": { "id": "GoogleCloudAiplatformV1beta1TuningJob", "properties": { "distillationSpec": { "$ref": "GoogleCloudAiplatformV1beta1DistillationSpec", "description": "Tuning Spec for Distillation." }, "createTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Time when the TuningJob was created." }, "supervisedTuningSpec": { "description": "Tuning Spec for Supervised Fine Tuning.", "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningSpec" }, "evaluateDatasetRuns": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluateDatasetRun" }, "type": "array", "description": "Output only. Evaluation runs for the Tuning Job." }, "startTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Time when the TuningJob for the first time entered the `JOB_STATE_RUNNING` state." }, "veoTuningSpec": { "description": "Tuning Spec for Veo Tuning.", "$ref": "GoogleCloudAiplatformV1beta1VeoTuningSpec" }, "reinforcementTuningSpec": { "description": "Tuning Spec for Reinforcement Tuning.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningSpec" }, "preferenceOptimizationSpec": { "$ref": "GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec", "description": "Tuning Spec for Preference Optimization." }, "partnerModelTuningSpec": { "description": "Tuning Spec for open sourced and third party Partner models.", "$ref": "GoogleCloudAiplatformV1beta1PartnerModelTuningSpec" }, "endTime": { "type": "string", "description": "Output only. Time when the TuningJob entered any of the following JobStates: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`, `JOB_STATE_EXPIRED`.", "format": "google-datetime", "readOnly": true }, "gcsMetricsUri": { "description": "Output only. The Cloud Storage metrics URI associated with this TuningJob.", "type": "string", "readOnly": true }, "experiment": { "description": "Output only. The Experiment associated with this TuningJob.", "type": "string", "readOnly": true }, "tunedModel": { "readOnly": true, "description": "Output only. The tuned model resources associated with this TuningJob.", "$ref": "GoogleCloudAiplatformV1beta1TunedModel" }, "encryptionSpec": { "description": "Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with the provided encryption key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "satisfiesPzs": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "pipelineJob": { "readOnly": true, "deprecated": true, "description": "Output only. The resource name of the PipelineJob associated with the TuningJob. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipeline_job}`.", "type": "string" }, "tuningJobMetadata": { "description": "Output only. Tuning Job metadata.", "$ref": "GoogleCloudAiplatformV1beta1TuningJobMetadata", "readOnly": true }, "tuningDataStats": { "description": "Output only. The tuning data statistics associated with this TuningJob.", "$ref": "GoogleCloudAiplatformV1beta1TuningDataStats", "readOnly": true }, "name": { "description": "Output only. Identifier. Resource name of a TuningJob. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}`", "type": "string", "readOnly": true }, "tuningJobState": { "readOnly": true, "enum": [ "TUNING_JOB_STATE_UNSPECIFIED", "TUNING_JOB_STATE_WAITING_FOR_QUOTA", "TUNING_JOB_STATE_PROCESSING_DATASET", "TUNING_JOB_STATE_WAITING_FOR_CAPACITY", "TUNING_JOB_STATE_TUNING", "TUNING_JOB_STATE_POST_PROCESSING" ], "enumDescriptions": [ "Default tuning job state.", "Tuning job is waiting for job quota.", "Tuning job is validating the dataset.", "Tuning job is waiting for hardware capacity.", "Tuning job is running.", "Tuning job is doing some post processing steps." ], "type": "string", "description": "Output only. The detail state of the tuning job (while the overall `JobState` is running)." }, "state": { "readOnly": true, "type": "string", "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "description": "Output only. The detailed state of the job." }, "error": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. Only populated when job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`." }, "tunedModelDisplayName": { "description": "Optional. The display name of the TunedModel. The name can be up to 128 characters long and can consist of any UTF-8 characters. For continuous tuning, tuned_model_display_name will by default use the same display name as the pre-tuned model. If a new display name is provided, the tuning job will create a new model instead of a new version.", "type": "string" }, "description": { "type": "string", "description": "Optional. The description of the TuningJob." }, "serviceAccount": { "type": "string", "description": "The service account that the tuningJob workload runs as. If not specified, the Vertex AI Secure Fine-Tuned Service Agent in the project will be used. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent Users starting the pipeline must have the `iam.serviceAccounts.actAs` permission on this service account." }, "preTunedModel": { "description": "The pre-tuned model for continuous tuning.", "$ref": "GoogleCloudAiplatformV1beta1PreTunedModel" }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "fullFineTuningSpec": { "$ref": "GoogleCloudAiplatformV1beta1FullFineTuningSpec", "description": "Tuning Spec for Full Fine Tuning." }, "satisfiesPzi": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "baseModel": { "type": "string", "description": "The base model that is being tuned. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models)." }, "outputUri": { "description": "Optional. Cloud Storage path to the directory where tuning job outputs are written to. This field is only available and required for open source models.", "type": "string" }, "customBaseModel": { "description": "Optional. The user-provided path to custom model weights. Set this field to tune a custom model. The path must be a Cloud Storage directory that contains the model weights in .safetensors format along with associated model metadata files. If this field is set, the base_model field must still be set to indicate which base model the custom model is derived from. This feature is only available for open source models.", "type": "string" }, "updateTime": { "readOnly": true, "type": "string", "description": "Output only. Time when the TuningJob was most recently updated.", "format": "google-datetime" }, "veoLoraTuningSpec": { "$ref": "GoogleCloudAiplatformV1beta1VeoLoraTuningSpec", "description": "Tuning Spec for Veo LoRA Tuning." } }, "type": "object", "description": "Represents a TuningJob that runs with Google owned models." }, "GoogleCloudAiplatformV1beta1IngestionDirectContentsSourceEvent": { "type": "object", "id": "GoogleCloudAiplatformV1beta1IngestionDirectContentsSourceEvent", "description": "A single event to ingest.", "properties": { "eventId": { "type": "string", "description": "Optional. A unique identifier for the event. If an event with the same event_id is ingested multiple times, it will be de-duplicated." }, "eventTime": { "format": "google-datetime", "description": "Optional. The time at which the event occurred. If provided, this timestamp will be used for ordering events within a stream. If not provided, the server-side ingestion time will be used.", "type": "string" }, "content": { "description": "Required. The content of the event.", "$ref": "GoogleCloudAiplatformV1beta1Content" } } }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenFineTuningPipelines": { "properties": { "fineTuningPipelines": { "description": "Required. Regional resource references to fine tuning pipelines.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenFineTuningPipelines", "description": "Open fine tuning pipelines." }, "GoogleCloudAiplatformV1beta1ExactMatchInput": { "id": "GoogleCloudAiplatformV1beta1ExactMatchInput", "type": "object", "properties": { "instances": { "description": "Required. Repeated exact match instances.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ExactMatchInstance" }, "type": "array" }, "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExactMatchSpec", "description": "Required. Spec for exact match metric." } }, "description": "Input for exact match metric." }, "GoogleCloudAiplatformV1beta1ListIndexEndpointsResponse": { "id": "GoogleCloudAiplatformV1beta1ListIndexEndpointsResponse", "type": "object", "description": "Response message for IndexEndpointService.ListIndexEndpoints.", "properties": { "indexEndpoints": { "items": { "$ref": "GoogleCloudAiplatformV1beta1IndexEndpoint" }, "description": "List of IndexEndpoints in the requested page.", "type": "array" }, "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListIndexEndpointsRequest.page_token to obtain that page.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1FeatureViewSyncConfig": { "properties": { "cron": { "description": "Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch scheduled runs. To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: \"CRON_TZ=${IANA_TIME_ZONE}\" or \"TZ=${IANA_TIME_ZONE}\". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, \"CRON_TZ=America/New_York 1 * * * *\", or \"TZ=America/New_York 1 * * * *\".", "type": "string" }, "continuous": { "description": "Optional. If true, syncs the FeatureView in a continuous manner to Online Store.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewSyncConfig", "description": "Configuration for Sync. Only one option is set.", "type": "object" }, "GoogleCloudAiplatformV1beta1RemoveDatapointsResponse": { "description": "Response message for IndexService.RemoveDatapoints", "id": "GoogleCloudAiplatformV1beta1RemoveDatapointsResponse", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecBuildSpec": { "description": "Specification for building container image.", "properties": { "serviceAccount": { "description": "Optional. The service account that Cloud Build uses to run the build. This field is only applicable when `worker_pool` is specified (i.e., for custom worker pools). If `worker_pool` is not specified, this field is ignored and the build runs using the Google-managed service agent. Format: `projects/{project}/serviceAccounts/{service_account}` or `{service_account}@{project}.iam.gserviceaccount.com`", "type": "string" }, "workerPool": { "description": "Optional. Identifier. The resource name of the Cloud Build WorkerPool to use for the build. Format: `projects/{project}/locations/{location}/workerPools/{worker_pool}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecBuildSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecTrainTrialSpec": { "description": "Represent spec for train trials.", "type": "object", "properties": { "trainTrialJobSpec": { "description": "Required. The spec of a train trial job. The same spec applies to all train trials.", "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec" }, "frequency": { "type": "integer", "description": "Required. Frequency of search trials to start train stage. Top N [TrainTrialSpec.max_parallel_trial_count] search trials will be trained for every M [TrainTrialSpec.frequency] trials searched.", "format": "int32" }, "maxParallelTrialCount": { "type": "integer", "description": "Required. The maximum number of trials to run in parallel.", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecTrainTrialSpec" }, "GoogleCloudAiplatformV1beta1NasJobOutput": { "id": "GoogleCloudAiplatformV1beta1NasJobOutput", "type": "object", "properties": { "multiTrialJobOutput": { "description": "Output only. The output of this multi-trial Neural Architecture Search (NAS) job.", "$ref": "GoogleCloudAiplatformV1beta1NasJobOutputMultiTrialJobOutput", "readOnly": true } }, "description": "Represents a uCAIP NasJob output." }, "GoogleCloudAiplatformV1beta1AsyncQueryReasoningEngineRequest": { "type": "object", "description": "Request message for ReasoningEngineExecutionService.AsyncQueryReasoningEngine.", "properties": { "inputGcsUri": { "type": "string", "description": "Optional. Input Cloud Storage URI for the Async query. If you are not bringing your own container (BYOC), the content of the file should be a JSON object with an `input` field matching the `input` field of `QueryReasoningEngineRequest` (e.g. `{ \"input\": { \"user_id\": \"hello\", \"message\":\"$QUERY\"} }`). For BYOC, the content of the file depends on the the agent application." }, "outputGcsUri": { "description": "Optional. Output Cloud Storage URI for the Async query. This contains the final response of the query.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AsyncQueryReasoningEngineRequest" }, "GoogleCloudAiplatformV1beta1PipelineJobDetail": { "type": "object", "id": "GoogleCloudAiplatformV1beta1PipelineJobDetail", "description": "The runtime detail of PipelineJob.", "properties": { "taskDetails": { "description": "Output only. The runtime details of the tasks under the pipeline.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskDetail" } }, "pipelineRunContext": { "description": "Output only. The context of the current pipeline run.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1Context" }, "pipelineContext": { "description": "Output only. The context of the pipeline.", "$ref": "GoogleCloudAiplatformV1beta1Context", "readOnly": true } } }, "GenaiVertexV1beta1FileCitation": { "description": "A file citation annotation.", "properties": { "pageNumber": { "type": "integer", "description": "Page number of the cited document, if applicable.", "format": "int32" }, "documentUri": { "description": "The URI of the file.", "type": "string" }, "customMetadata": { "type": "object", "description": "User provided metadata about the retrieved context.", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "source": { "description": "Source attributed for a portion of the text.", "type": "string" }, "mediaId": { "description": "Media ID in-case of image citations, if applicable.", "type": "string" }, "fileName": { "description": "The name of the file.", "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1FileCitation" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputs": { "properties": { "additionalExperiments": { "type": "array", "items": { "type": "string" }, "description": "Additional experiment flags for the Tables training pipeline." }, "exportEvaluatedDataItemsConfig": { "description": "Configuration for exporting test set predictions to a BigQuery table. If this configuration is absent, then the export is not performed.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig" }, "optimizationObjective": { "type": "string", "description": "Objective function the model is optimizing towards. The training process creates a model that maximizes/minimizes the value of the objective function over the validation set. The supported optimization objectives depend on the prediction type. If the field is not set, a default objective function is used. classification (binary): \"maximize-au-roc\" (default) - Maximize the area under the receiver operating characteristic (ROC) curve. \"minimize-log-loss\" - Minimize log loss. \"maximize-au-prc\" - Maximize the area under the precision-recall curve. \"maximize-precision-at-recall\" - Maximize precision for a specified recall value. \"maximize-recall-at-precision\" - Maximize recall for a specified precision value. classification (multi-class): \"minimize-log-loss\" (default) - Minimize log loss. regression: \"minimize-rmse\" (default) - Minimize root-mean-squared error (RMSE). \"minimize-mae\" - Minimize mean-absolute error (MAE). \"minimize-rmsle\" - Minimize root-mean-squared log error (RMSLE)." }, "optimizationObjectivePrecisionValue": { "format": "float", "type": "number", "description": "Required when optimization_objective is \"maximize-recall-at-precision\". Must be between 0 and 1, inclusive." }, "transformations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformation" }, "description": "Each transformation will apply transform function to given input column. And the result will be used for training. When creating transformation for BigQuery Struct column, the column should be flattened using \".\" as the delimiter." }, "optimizationObjectiveRecallValue": { "type": "number", "format": "float", "description": "Required when optimization_objective is \"maximize-precision-at-recall\". Must be between 0 and 1, inclusive." }, "disableEarlyStopping": { "description": "Use the entire training budget. This disables the early stopping feature. By default, the early stopping feature is enabled, which means that AutoML Tables might stop training before the entire training budget has been used.", "type": "boolean" }, "weightColumnName": { "description": "Column name that should be used as the weight column. Higher values in this column give more importance to the row during model training. The column must have numeric values between 0 and 10000 inclusively; 0 means the row is ignored for training. If weight column field is not set, then all rows are assumed to have equal weight of 1.", "type": "string" }, "predictionType": { "description": "The type of prediction the Model is to produce. \"classification\" - Predict one out of multiple target values is picked for each row. \"regression\" - Predict a value based on its relation to other values. This type is available only to columns that contain semantically numeric values, i.e. integers or floating point number, even if stored as e.g. strings.", "type": "string" }, "targetColumn": { "type": "string", "description": "The column name of the target column that the model is to predict." }, "trainBudgetMilliNodeHours": { "format": "int64", "type": "string", "description": "Required. The train budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The training cost of the model will not exceed this budget. The final cost will be attempted to be close to the budget, though may end up being (even) noticeably smaller - at the backend's discretion. This especially may happen when further model training ceases to provide any improvements. If the budget is set to a value known to be insufficient to train a model for the given dataset, the training won't be attempted and will error. The train budget must be between 1,000 and 72,000 milli node hours, inclusive." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputs", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureMonitorJobJobSummary": { "description": "Summary from the FeatureMonitorJob.", "properties": { "featureStatsAndAnomalies": { "description": "Output only. Features and their stats and anomalies", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAndAnomaly" } }, "totalSlotMs": { "format": "int64", "type": "string", "description": "Output only. BigQuery slot milliseconds consumed.", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureMonitorJobJobSummary" }, "GoogleCloudAiplatformV1beta1FeedbackEntry": { "id": "GoogleCloudAiplatformV1beta1FeedbackEntry", "type": "object", "properties": { "feedbackText": { "description": "Optional. Qualitative free-form comments provided by the user.", "type": "string" }, "source": { "description": "Optional. The surface that the feedback originated from.", "type": "string" }, "updateTime": { "readOnly": true, "description": "Output only. The time at which the entry was most recently updated.", "format": "google-datetime", "type": "string" }, "feedbackType": { "type": "string", "description": "Required. The coarse-grained type of feedback provided by the user. Must be set to a value other than `FEEDBACK_TYPE_UNSPECIFIED`.", "enumDescriptions": [ "This is the default value meaning the type has not been set.", "Indicates positive feedback.", "Indicates negative feedback." ], "enum": [ "FEEDBACK_TYPE_UNSPECIFIED", "THUMBS_UP", "THUMBS_DOWN" ] }, "sessionId": { "description": "Required. The ID of the session that the feedback relates to.", "type": "string" }, "eventId": { "description": "Required. The ID of the event within the session that the feedback relates to.", "type": "string" }, "customMetadata": { "additionalProperties": { "type": "string" }, "description": "Optional. Additional key-value metadata associated with the feedback.", "type": "object" }, "name": { "description": "Identifier. The resource name. Assigned by the server on create. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}`", "type": "string" }, "feedbackLabels": { "items": { "type": "string" }, "type": "array" }, "userId": { "description": "Optional. A caller-supplied identifier for the user who provided the feedback. The semantics of this field (for example whether it is an opaque token, a hashed value, or a user-visible identifier) are determined by the calling application.", "type": "string" }, "createTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. The time at which the entry was created.", "type": "string" } }, "description": "FeedbackEntry is a resource that represents a user's feedback on a conversation with an agent." }, "GoogleCloudAiplatformV1beta1FunctionCallingConfig": { "type": "object", "description": "Function calling config.", "id": "GoogleCloudAiplatformV1beta1FunctionCallingConfig", "properties": { "allowedFunctionNames": { "description": "Optional. Function names to call. Only set when the Mode is ANY. Function names should match FunctionDeclaration.name. With mode set to ANY, model will predict a function call from the set of function names provided.", "type": "array", "items": { "type": "string" } }, "streamFunctionCallArguments": { "description": "Optional. When set to true, arguments of a single function call will be streamed out in multiple parts/contents/responses. Partial parameter results will be returned in the `FunctionCall.partial_args` field.", "type": "boolean" }, "mode": { "type": "string", "description": "Optional. Function calling mode.", "enumDescriptions": [ "Unspecified function calling mode. This value should not be used.", "Default model behavior, model decides to predict either function calls or natural language response.", "Model is constrained to always predicting function calls only. If \"allowed_function_names\" are set, the predicted function calls will be limited to any one of \"allowed_function_names\", else the predicted function calls will be any one of the provided \"function_declarations\".", "Model will not predict any function calls. Model behavior is same as when not passing any function declarations.", "Model is constrained to predict either function calls or natural language response. If \"allowed_function_names\" are set, the predicted function calls will be limited to any one of \"allowed_function_names\", else the predicted function calls will be any one of the provided \"function_declarations\"." ], "enum": [ "MODE_UNSPECIFIED", "AUTO", "ANY", "NONE", "VALIDATED" ] } } }, "GoogleCloudAiplatformV1beta1TensorboardBlob": { "id": "GoogleCloudAiplatformV1beta1TensorboardBlob", "properties": { "data": { "type": "string", "format": "byte", "description": "Optional. The bytes of the blob is not present unless it's returned by the ReadTensorboardBlobData endpoint." }, "id": { "type": "string", "readOnly": true, "description": "Output only. A URI safe key uniquely identifying a blob. Can be used to locate the blob stored in the Cloud Storage bucket of the consumer project." } }, "description": "One blob (e.g, image, graph) viewable on a blob metric plot.", "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateVideoResponseVideo": { "type": "object", "description": "A generated video.", "properties": { "bytesBase64Encoded": { "type": "string", "description": "Base64 encoded bytes string representing the video." }, "gcsUri": { "type": "string", "description": "Cloud Storage URI where the generated video is written." }, "mimeType": { "description": "The MIME type of the content of the video. - video/mp4", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1GenerateVideoResponseVideo" }, "GoogleCloudAiplatformV1beta1ListA2ATaskRecordEventsResponse": { "properties": { "events": { "type": "array", "description": "List of A2ATaskRecordEvents in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordEvent" } }, "nextPageToken": { "description": "A token to retrieve the next page of results.", "type": "string" } }, "type": "object", "description": "Response message for A2ATaskRecordService.ListA2ATaskRecordEvents.", "id": "GoogleCloudAiplatformV1beta1ListA2ATaskRecordEventsResponse" }, "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecMetricSpec": { "id": "GoogleCloudAiplatformV1beta1NasJobSpecMultiTrialAlgorithmSpecMetricSpec", "type": "object", "properties": { "metricId": { "type": "string", "description": "Required. The ID of the metric. Must not contain whitespaces." }, "goal": { "type": "string", "enumDescriptions": [ "Goal Type will default to maximize.", "Maximize the goal metric.", "Minimize the goal metric." ], "enum": [ "GOAL_TYPE_UNSPECIFIED", "MAXIMIZE", "MINIMIZE" ], "description": "Required. The optimization goal of the metric." } }, "description": "Represents a metric to optimize." }, "GoogleCloudAiplatformV1beta1AnalyzedSessionSeveritySummary": { "type": "object", "description": "Breaks down anomalies by severity.", "properties": { "sessionsCount": { "type": "integer", "format": "int32", "description": "Output only. The number of distinct sessions whose maximum severity equals `severity_level`. Each session is counted in exactly one bucket (its highest severity). Scope depends on where this appears: a global count on `AggregateAnalyzedSessionsResponse.summary`, per-agent on `agent_aggregates` entries, and page-scoped on `ListAnalyzedSessionsResponse`.", "readOnly": true }, "detectorIds": { "type": "array", "items": { "type": "string" }, "description": "The list of detectors summaries for this severity level." }, "severityLevel": { "type": "string", "description": "The severity level of the detector.", "enum": [ "SEVERITY_UNSPECIFIED", "SEVERITY_LOW", "SEVERITY_MEDIUM", "SEVERITY_HIGH", "SEVERITY_CRITICAL" ], "enumDescriptions": [ "Unspecified severity.", "Low severity.", "Medium severity.", "High severity.", "Critical severity." ] } }, "id": "GoogleCloudAiplatformV1beta1AnalyzedSessionSeveritySummary" }, "GoogleCloudAiplatformV1beta1ListAnnotationsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "annotations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Annotation" }, "description": "A list of Annotations that matches the specified filter in the request." } }, "description": "Response message for DatasetService.ListAnnotations.", "id": "GoogleCloudAiplatformV1beta1ListAnnotationsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1FindNeighborsResponseNearestNeighbors": { "id": "GoogleCloudAiplatformV1beta1FindNeighborsResponseNearestNeighbors", "description": "Nearest neighbors for one query.", "type": "object", "properties": { "id": { "description": "The ID of the query datapoint.", "type": "string" }, "neighbors": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsResponseNeighbor" }, "type": "array", "description": "All its neighbors." } } }, "GoogleCloudAiplatformV1beta1GeminiTemplateConfig": { "description": "Template configuration to create Gemini examples from a multimodal dataset.", "properties": { "geminiExample": { "description": "Required. The template that will be used for assembling the request to use for downstream applications.", "$ref": "GoogleCloudAiplatformV1beta1GeminiExample" }, "fieldMapping": { "type": "object", "description": "Required. Map of template parameters to the columns in the dataset table.", "additionalProperties": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1GeminiTemplateConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicManagedMemoryTopic": { "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicManagedMemoryTopic", "description": "A managed memory topic defined by the system.", "properties": { "managedTopicEnum": { "type": "string", "description": "Required. Represents the managed topic.", "enum": [ "MANAGED_TOPIC_ENUM_UNSPECIFIED", "USER_PERSONAL_INFO", "USER_PREFERENCES", "KEY_CONVERSATION_DETAILS", "EXPLICIT_INSTRUCTIONS" ], "enumDescriptions": [ "Represents an unspecified topic. This value should not be used.", "Represents significant personal information about the User like first names, relationships, hobbies, important dates.", "Represents stated or implied likes, dislikes, preferred styles, or patterns.", "Represents important milestones or conclusions within the dialogue.", "Represents information that the user explicitly requested to remember or forget." ] } } }, "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResult": { "id": "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResult", "description": "The result of the Google Maps.", "type": "object", "properties": { "widgetContextToken": { "type": "string", "description": "Resource name of the Google Maps widget context token." }, "places": { "description": "The places that were found.", "items": { "$ref": "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResultPlaces" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1AgentConfig": { "id": "GoogleCloudAiplatformV1beta1AgentConfig", "type": "object", "properties": { "description": { "type": "string", "description": "Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly." }, "agentId": { "description": "Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map.", "type": "string" }, "tools": { "type": "array", "description": "Optional. The list of tools available to this agent.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } }, "subAgents": { "items": { "type": "string" }, "type": "array", "description": "Optional. The list of valid agent IDs that this agent can delegate to. This defines the directed edges in the multi-agent system graph topology." }, "agentType": { "description": "Optional. The type or class of the agent (e.g., \"LlmAgent\", \"RouterAgent\", \"ToolUseAgent\"). Useful for the autorater to understand the expected behavior of the agent.", "type": "string" }, "instruction": { "description": "Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be resolved at runtime using the `AgentEvent.state_delta` field.", "type": "string" } }, "description": "Represents configuration for an Agent." }, "GoogleCloudAiplatformV1beta1SuggestTrialsMetadata": { "description": "Details of operations that perform Trials suggestion.", "id": "GoogleCloudAiplatformV1beta1SuggestTrialsMetadata", "type": "object", "properties": { "clientId": { "type": "string", "description": "The identifier of the client that is requesting the suggestion. If multiple SuggestTrialsRequests have the same `client_id`, the service will return the identical suggested Trial if the Trial is pending, and provide a new Trial if the last suggested Trial was completed." }, "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for suggesting Trials." } } }, "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigPromptTemplate": { "description": "Prompt template used for inference.", "properties": { "promptTemplate": { "type": "string", "description": "Inline prompt template. Template variables should be in the format \"{var_name}\". Example: \"Translate the following from {source_lang} to {target_lang}: {text}\"" }, "gcsUri": { "description": "Prompt template stored in Cloud Storage. Format: \"gs://my-bucket/file-name.txt\".", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigPromptTemplate" }, "GoogleCloudAiplatformV1beta1RagMetadata": { "description": "Metadata for RagFile provided by users.", "properties": { "userSpecifiedMetadata": { "description": "User provided metadata.", "$ref": "GoogleCloudAiplatformV1beta1UserSpecifiedMetadata" }, "name": { "description": "Identifier. Resource name of the RagMetadata. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragFiles/{rag_file}/ragMetadata/{rag_metadata}`", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RagMetadata" }, "GoogleCloudAiplatformV1beta1CorroborateContentRequest": { "description": "Request message for CorroborateContent.", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Optional. Input content to corroborate, only text format is supported for now." }, "facts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Fact" }, "description": "Optional. Facts used to generate the text can also be used to corroborate the text.", "type": "array" }, "parameters": { "description": "Optional. Parameters that can be set to override default settings per request.", "$ref": "GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters" } }, "id": "GoogleCloudAiplatformV1beta1CorroborateContentRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation": { "properties": { "region": { "type": "string", "description": "The region for the deployment spec (machine)." }, "userQuotaState": { "enum": [ "QUOTA_STATE_UNSPECIFIED", "QUOTA_STATE_USER_HAS_QUOTA", "QUOTA_STATE_NO_USER_QUOTA" ], "enumDescriptions": [ "Unspecified quota state. Quota information not available.", "User has enough accelerator quota for the machine type.", "User does not have enough accelerator quota for the machine type." ], "description": "Output only. The user accelerator quota state.", "readOnly": true, "type": "string" }, "spec": { "description": "Output only. The machine and model container specs.", "$ref": "GoogleCloudAiplatformV1beta1RecommendSpecResponseMachineAndModelContainerSpec", "readOnly": true } }, "description": "Recommendation of one deployment option for the given custom weights model in one region. Contains the machine and container spec, and user accelerator quota state.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RecommendSpecResponseRecommendation" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfig": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfig", "type": "object", "properties": { "explanationConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfig", "description": "The config for integrating with Vertex Explainable AI." }, "trainingPredictionSkewDetectionConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingPredictionSkewDetectionConfig", "description": "The config for skew between training data and prediction data." }, "predictionDriftDetectionConfig": { "description": "The config for drift of prediction data.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigPredictionDriftDetectionConfig" }, "trainingDataset": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingDataset", "description": "Training dataset for models. This field has to be set only if TrainingPredictionSkewDetectionConfig is specified." } }, "description": "The objective configuration for model monitoring, including the information needed to detect anomalies for one particular model." }, "GenaiVertexV1beta1UrlContextCallStepUrlContextCallStepArguments": { "id": "GenaiVertexV1beta1UrlContextCallStepUrlContextCallStepArguments", "description": "The arguments to pass to the URL context.", "type": "object", "properties": { "urls": { "description": "The URLs to fetch.", "items": { "type": "string" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1CreateFeatureGroupOperationMetadata": { "description": "Details of operations that perform create FeatureGroup.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for FeatureGroup." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateFeatureGroupOperationMetadata" }, "GoogleCloudAiplatformV1beta1EncryptionSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EncryptionSpec", "properties": { "kmsKeyName": { "type": "string", "description": "Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`." } }, "description": "Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource." }, "GoogleCloudAiplatformV1beta1CsvDestination": { "type": "object", "description": "The storage details for CSV output content.", "id": "GoogleCloudAiplatformV1beta1CsvDestination", "properties": { "gcsDestination": { "description": "Required. Google Cloud Storage location.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" } } }, "GoogleCloudAiplatformV1beta1FeatureMonitoringStatsAnomaly": { "description": "A list of historical SnapshotAnalysis or ImportFeaturesAnalysis stats requested by user, sorted by FeatureStatsAnomaly.start_time descending.", "type": "object", "properties": { "featureStatsAnomaly": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly", "description": "Output only. The stats and anomalies generated at specific timestamp." }, "objective": { "type": "string", "enum": [ "OBJECTIVE_UNSPECIFIED", "IMPORT_FEATURE_ANALYSIS", "SNAPSHOT_ANALYSIS" ], "description": "Output only. The objective for each stats.", "enumDescriptions": [ "If it's OBJECTIVE_UNSPECIFIED, monitoring_stats will be empty.", "Stats are generated by Import Feature Analysis.", "Stats are generated by Snapshot Analysis." ], "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1FeatureMonitoringStatsAnomaly" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexVectorSearch": { "description": "The config for the Vertex Vector Search.", "properties": { "index": { "description": "The resource name of the Index. Format: `projects/{project}/locations/{location}/indexes/{index}`", "type": "string" }, "indexEndpoint": { "description": "The resource name of the Index Endpoint. Format: `projects/{project}/locations/{location}/indexEndpoints/{index_endpoint}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexVectorSearch", "type": "object" }, "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetSource": { "id": "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetSource", "type": "object", "properties": { "datasetName": { "type": "string", "description": "Required. The resource name of the Vertex Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`" } }, "description": "The Vertex Multimodal Dataset for the input content." }, "GoogleCloudAiplatformV1beta1VideoMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1VideoMetadata", "properties": { "endOffset": { "description": "Optional. The end offset of the video.", "type": "string", "format": "google-duration" }, "fps": { "description": "Optional. The frame rate of the video sent to the model. If not specified, the default value is 1.0. The valid range is (0.0, 24.0].", "format": "double", "type": "number" }, "startOffset": { "format": "google-duration", "description": "Optional. The start offset of the video.", "type": "string" } }, "description": "Provides metadata for a video, including the start and end offsets for clipping and the frame rate." }, "GoogleCloudAiplatformV1beta1SharePointSourcesSharePointSource": { "properties": { "fileId": { "readOnly": true, "description": "Output only. The SharePoint file id. Output only.", "type": "string" }, "tenantId": { "description": "Unique identifier of the Azure Active Directory Instance.", "type": "string" }, "clientId": { "type": "string", "description": "The Application ID for the app registered in Microsoft Azure Portal. The application must also be configured with MS Graph permissions \"Files.ReadAll\", \"Sites.ReadAll\" and BrowserSiteLists.Read.All." }, "sharepointFolderId": { "description": "The ID of the SharePoint folder to download from.", "type": "string" }, "sharepointSiteName": { "type": "string", "description": "The name of the SharePoint site to download from. This can be the site name or the site id." }, "clientSecret": { "$ref": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig", "description": "The application secret for the app registered in Azure." }, "driveName": { "description": "The name of the drive to download from.", "type": "string" }, "driveId": { "description": "The ID of the drive to download from.", "type": "string" }, "sharepointFolderPath": { "type": "string", "description": "The path of the SharePoint folder to download from." } }, "type": "object", "description": "An individual SharePointSource.", "id": "GoogleCloudAiplatformV1beta1SharePointSourcesSharePointSource" }, "GoogleCloudAiplatformV1beta1PointwiseMetricSpec": { "properties": { "metricPromptTemplate": { "type": "string", "description": "Required. Metric prompt template for pointwise metric." }, "customOutputFormatConfig": { "description": "Optional. CustomOutputFormatConfig allows customization of metric output. By default, metrics return a score and explanation. When this config is set, the default output is replaced with either: - The raw output string. - A parsed output based on a user-defined schema. If a custom format is chosen, the `score` and `explanation` fields in the corresponding metric result will be empty.", "$ref": "GoogleCloudAiplatformV1beta1CustomOutputFormatConfig" }, "systemInstruction": { "description": "Optional. System instructions for pointwise metric.", "type": "string" } }, "description": "Spec for pointwise metric.", "id": "GoogleCloudAiplatformV1beta1PointwiseMetricSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1SetPublisherModelConfigRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SetPublisherModelConfigRequest", "properties": { "publisherModelConfig": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfig", "description": "Required. The publisher model config." }, "updateMask": { "format": "google-fieldmask", "description": "Optional. The fields of `publisher_model_config` to overwrite. If empty, the entire config is replaced. If set, only the listed fields are overwritten and the others are left unchanged; this lets you update one setting (for example `inference_event_logging_config`) without clearing its siblings.", "type": "string" } }, "description": "Request message for EndpointService.SetPublisherModelConfig." }, "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchMetricValue": { "description": "Tool parameter key match metric value for an instance.", "id": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchMetricValue", "type": "object", "properties": { "score": { "type": "number", "readOnly": true, "description": "Output only. Tool parameter key match score.", "format": "float" } } }, "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfigRagConfig": { "id": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfigRagConfig", "description": "Configuration for Retrieval Augmented Generation feature.", "properties": { "enableRag": { "description": "If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineTaskDetail": { "id": "GoogleCloudAiplatformV1beta1PipelineTaskDetail", "type": "object", "description": "The runtime detail of a task execution.", "properties": { "startTime": { "description": "Output only. Task start time.", "readOnly": true, "format": "google-datetime", "type": "string" }, "state": { "description": "Output only. State of the task.", "enumDescriptions": [ "Unspecified.", "Specifies pending state for the task.", "Specifies task is being executed.", "Specifies task completed successfully.", "Specifies Task cancel is in pending state.", "Specifies task is being cancelled.", "Specifies task was cancelled.", "Specifies task failed.", "Specifies task was skipped due to cache hit.", "Specifies that the task was not triggered because the task's trigger policy is not satisfied. The trigger policy is specified in the `condition` field of PipelineJob.pipeline_spec." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "PENDING", "RUNNING", "SUCCEEDED", "CANCEL_PENDING", "CANCELLING", "CANCELLED", "FAILED", "SKIPPED", "NOT_TRIGGERED" ] }, "taskId": { "readOnly": true, "description": "Output only. The system generated ID of the task.", "format": "int64", "type": "string" }, "inputs": { "type": "object", "readOnly": true, "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskDetailArtifactList" }, "description": "Output only. The runtime input artifacts of the task." }, "parentTaskId": { "description": "Output only. The id of the parent task if the task is within a component scope. Empty if the task is at the root level.", "format": "int64", "readOnly": true, "type": "string" }, "error": { "$ref": "GoogleRpcStatus", "readOnly": true, "description": "Output only. The error that occurred during task execution. Only populated when the task's state is FAILED or CANCELLED." }, "executorDetail": { "description": "Output only. The detailed execution info.", "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetail", "readOnly": true }, "execution": { "readOnly": true, "description": "Output only. The execution metadata of the task.", "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. Task create time.", "readOnly": true }, "pipelineTaskStatus": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskDetailPipelineTaskStatus" }, "readOnly": true, "description": "Output only. A list of task status. This field keeps a record of task status evolving over time." }, "outputs": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskDetailArtifactList" }, "type": "object", "description": "Output only. The runtime output artifacts of the task.", "readOnly": true }, "taskName": { "readOnly": true, "description": "Output only. The user specified name of the task that is defined in pipeline_spec.", "type": "string" }, "endTime": { "description": "Output only. Task end time.", "readOnly": true, "type": "string", "format": "google-datetime" }, "taskUniqueName": { "type": "string", "readOnly": true, "description": "Output only. The unique name of a task. This field is used by rerun pipeline job. Console UI and Vertex AI SDK will support triggering pipeline job reruns. The name is constructed by concatenating all the parent tasks name with the task name. For example, if a task named \"child_task\" has a parent task named \"parent_task_1\" and parent task 1 has a parent task named \"parent_task_2\", the task unique name will be \"parent_task_2.parent_task_1.child_task\"." } } }, "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchMetricValue": { "description": "TrajectoryAnyOrderMatch metric value for an instance.", "id": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchMetricValue", "properties": { "score": { "description": "Output only. TrajectoryAnyOrderMatch score.", "format": "float", "readOnly": true, "type": "number" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CustomCodeExecutionResult": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CustomCodeExecutionResult", "description": "Result for custom code execution metric.", "properties": { "score": { "readOnly": true, "description": "Output only. Custom code execution score.", "type": "number", "format": "float" } } }, "GoogleCloudAiplatformV1beta1ContainerRegistryDestination": { "type": "object", "description": "The Container Registry location for the container image.", "id": "GoogleCloudAiplatformV1beta1ContainerRegistryDestination", "properties": { "outputUri": { "description": "Required. Container Registry URI of a container image. Only Google Container Registry and Artifact Registry are supported now. Accepted forms: * Google Container Registry path. For example: `gcr.io/projectId/imageName:tag`. * Artifact Registry path. For example: `us-central1-docker.pkg.dev/projectId/repoName/imageName:tag`. If a tag is not specified, \"latest\" will be used as the default tag.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1AuthConfigOauthConfig": { "type": "object", "description": "Config for user oauth.", "properties": { "accessToken": { "type": "string", "description": "Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time." }, "serviceAccount": { "type": "string", "description": "The service account used to generate access tokens for executing the Extension. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the provided service account." } }, "id": "GoogleCloudAiplatformV1beta1AuthConfigOauthConfig" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionClassificationPredictionResult": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionClassificationPredictionResult", "properties": { "displayNames": { "type": "array", "items": { "type": "string" }, "description": "The display names of the AnnotationSpecs that had been identified, order matches the IDs." }, "ids": { "description": "The resource IDs of the AnnotationSpecs that had been identified.", "type": "array", "items": { "format": "int64", "type": "string" } }, "confidences": { "type": "array", "items": { "format": "float", "type": "number" }, "description": "The Model's confidences in correctness of the predicted IDs, higher value means higher confidence. Order matches the Ids." } }, "type": "object", "description": "Prediction output format for Image and Text Classification." }, "GoogleCloudAiplatformV1beta1ExactMatchResults": { "id": "GoogleCloudAiplatformV1beta1ExactMatchResults", "description": "Results for exact match metric.", "type": "object", "properties": { "exactMatchMetricValues": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ExactMatchMetricValue" }, "description": "Output only. Exact match metric values." } } }, "GoogleCloudAiplatformV1beta1ListAnalyzedInvocationsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results." }, "analyzedInvocations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedInvocation" }, "description": "The list of analyzed invocations." } }, "id": "GoogleCloudAiplatformV1beta1ListAnalyzedInvocationsResponse", "description": "Response to list analyzed invocations.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericArrayTransformation": { "description": "Treats the column as numerical array and performs following transformation functions. * All transformations for Numerical types applied to the average of the all elements. * The average of empty arrays is treated as zero.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericArrayTransformation", "type": "object", "properties": { "columnName": { "type": "string" }, "invalidValuesAllowed": { "description": "If invalid values is allowed, the training pipeline will create a boolean feature that indicated whether the value is valid. Otherwise, the training pipeline will discard the input row from trainining data.", "type": "boolean" } } }, "GoogleCloudAiplatformV1beta1FeatureMonitor": { "type": "object", "properties": { "name": { "type": "string", "description": "Identifier. Name of the FeatureMonitor. Format: `projects/{project}/locations/{location}/featureGroups/{featureGroup}/featureMonitors/{featureMonitor}`" }, "description": { "type": "string", "description": "Optional. Description of the FeatureMonitor." }, "scheduleConfig": { "description": "Required. Schedule config for the FeatureMonitor.", "$ref": "GoogleCloudAiplatformV1beta1ScheduleConfig" }, "updateTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this FeatureMonitor was last updated." }, "featureSelectionConfig": { "$ref": "GoogleCloudAiplatformV1beta1FeatureSelectionConfig", "description": "Required. Feature selection config for the FeatureMonitor." }, "createTime": { "readOnly": true, "description": "Output only. Timestamp when this FeatureMonitor was created.", "format": "google-datetime", "type": "string" }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "labels": { "type": "object", "description": "Optional. The labels with user-defined metadata to organize your FeatureMonitor. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one FeatureMonitor(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "additionalProperties": { "type": "string" } } }, "description": "Vertex AI Feature Monitor.", "id": "GoogleCloudAiplatformV1beta1FeatureMonitor" }, "GoogleCloudAiplatformV1beta1CometInstance": { "id": "GoogleCloudAiplatformV1beta1CometInstance", "type": "object", "properties": { "source": { "type": "string", "description": "Optional. Source text in original language." }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } }, "description": "Spec for Comet instance - The fields used for evaluation are dependent on the comet version." }, "GoogleCloudAiplatformV1beta1UpdateFeatureOperationMetadata": { "description": "Details of operations that perform update Feature.", "properties": { "genericMetadata": { "description": "Operation metadata for Feature Update.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateFeatureOperationMetadata" }, "GoogleCloudAiplatformV1beta1FetchExamplesResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FetchExamplesResponse", "description": "Response message for ExampleStoreService.FetchExamples.", "properties": { "examples": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Example" }, "type": "array", "description": "The examples in the Example Store that satisfy the metadata filters." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as FetchExamplesRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages." } } }, "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerUserUsageData": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerUserUsageData", "description": "Per user usage data.", "properties": { "viewCount": { "type": "string", "format": "int64", "description": "Number of times the user has read data within the Tensorboard." }, "username": { "type": "string", "description": "User's username" } } }, "GoogleCloudAiplatformV1beta1Retrieval": { "description": "Defines a retrieval tool that model can call to access external knowledge.", "properties": { "vertexRagStore": { "description": "Set to use data source powered by Vertex RAG store. User data is uploaded via the VertexRagDataService.", "$ref": "GoogleCloudAiplatformV1beta1VertexRagStore" }, "vertexAiSearch": { "description": "Set to use data source powered by Vertex AI Search.", "$ref": "GoogleCloudAiplatformV1beta1VertexAISearch" }, "externalApi": { "description": "Use data source powered by external API for grounding.", "$ref": "GoogleCloudAiplatformV1beta1ExternalApi" }, "disableAttribution": { "description": "Optional. Deprecated. This option is no longer supported.", "type": "boolean", "deprecated": true } }, "id": "GoogleCloudAiplatformV1beta1Retrieval", "type": "object" }, "GoogleCloudAiplatformV1beta1ImportRagFilesRequest": { "id": "GoogleCloudAiplatformV1beta1ImportRagFilesRequest", "properties": { "importRagFilesConfig": { "description": "Required. The config for the RagFiles to be synced and imported into the RagCorpus. VertexRagDataService.ImportRagFiles.", "$ref": "GoogleCloudAiplatformV1beta1ImportRagFilesConfig" } }, "description": "Request message for VertexRagDataService.ImportRagFiles.", "type": "object" }, "GenaiVertexV1beta1UserInputStep": { "id": "GenaiVertexV1beta1UserInputStep", "description": "Input provided by the user.", "properties": { "contentString": { "description": "The content of the step. A single string.", "type": "string" }, "contentList": { "description": "The content of the step. An array of Content objects.", "$ref": "GenaiVertexV1beta1ContentList" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CreateMetadataStoreOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateMetadataStoreOperationMetadata", "properties": { "genericMetadata": { "description": "Operation metadata for creating a MetadataStore.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "description": "Details of operations that perform MetadataService.CreateMetadataStore." }, "GoogleCloudAiplatformV1beta1PartMediaResolution": { "description": "per part media resolution. Media resolution for the input media.", "properties": { "level": { "description": "The tokenization quality used for given media.", "type": "string", "enumDescriptions": [ "Media resolution has not been set.", "Media resolution set to low.", "Media resolution set to medium.", "Media resolution set to high.", "Media resolution set to ultra high. This is for image only." ], "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "MEDIA_RESOLUTION_LOW", "MEDIA_RESOLUTION_MEDIUM", "MEDIA_RESOLUTION_HIGH", "MEDIA_RESOLUTION_ULTRA_HIGH" ] } }, "id": "GoogleCloudAiplatformV1beta1PartMediaResolution", "type": "object" }, "GoogleCloudAiplatformV1beta1FunctionResponseFileData": { "description": "URI based data for function response.", "id": "GoogleCloudAiplatformV1beta1FunctionResponseFileData", "type": "object", "properties": { "fileUri": { "description": "Required. URI.", "type": "string" }, "mimeType": { "description": "Required. The IANA standard MIME type of the source data.", "type": "string" }, "displayName": { "type": "string", "description": "Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled." } } }, "GoogleCloudAiplatformV1beta1BatchDedicatedResources": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchDedicatedResources", "properties": { "flexStart": { "$ref": "GoogleCloudAiplatformV1beta1FlexStart", "description": "Optional. Immutable. If set, use DWS resource to schedule the deployment workload. reference: (https://cloud.google.com/blog/products/compute/introducing-dynamic-workload-scheduler)" }, "maxReplicaCount": { "description": "Immutable. The maximum number of machine replicas the batch operation may be scaled to. The default value is 10.", "type": "integer", "format": "int32" }, "spot": { "description": "Optional. If true, schedule the deployment workload on [spot VMs](https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms).", "type": "boolean" }, "machineSpec": { "$ref": "GoogleCloudAiplatformV1beta1MachineSpec", "description": "Required. Immutable. The specification of a single machine." }, "startingReplicaCount": { "description": "Immutable. The number of machine replicas used at the start of the batch operation. If not set, Agent Platform decides starting number, not greater than max_replica_count", "type": "integer", "format": "int32" } }, "description": "A description of resources that are used for performing batch operations, are dedicated to a Model, and need manual configuration." }, "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTargetVertexModelSource": { "type": "object", "description": "Model in Vertex AI Model Registry.", "properties": { "model": { "type": "string", "description": "Model resource name. Format: projects/{project}/locations/{location}/models/{model}." }, "modelVersionId": { "type": "string", "description": "Model version id." } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitorModelMonitoringTargetVertexModelSource" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsClassificationEvaluationMetricsConfidenceMetrics": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsClassificationEvaluationMetricsConfidenceMetrics", "properties": { "falsePositiveCount": { "format": "int64", "description": "The number of Model created labels that do not match a ground truth label.", "type": "string" }, "confusionMatrix": { "description": "Confusion matrix of the evaluation for this confidence_threshold.", "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix" }, "f1ScoreMicro": { "type": "number", "description": "Micro-averaged F1 Score.", "format": "float" }, "falseNegativeCount": { "description": "The number of ground truth labels that are not matched by a Model created label.", "type": "string", "format": "int64" }, "precisionAt1": { "description": "The precision when only considering the label that has the highest prediction score and not below the confidence threshold for each DataItem.", "type": "number", "format": "float" }, "confidenceThreshold": { "description": "Metrics are computed with an assumption that the Model never returns predictions with score lower than this value.", "format": "float", "type": "number" }, "f1ScoreAt1": { "type": "number", "description": "The harmonic mean of recallAt1 and precisionAt1.", "format": "float" }, "precision": { "format": "float", "type": "number", "description": "Precision for the given confidence threshold." }, "falsePositiveRateAt1": { "type": "number", "format": "float", "description": "The False Positive Rate when only considering the label that has the highest prediction score and not below the confidence threshold for each DataItem." }, "f1Score": { "format": "float", "type": "number", "description": "The harmonic mean of recall and precision. For summary metrics, it computes the micro-averaged F1 score." }, "recall": { "format": "float", "description": "Recall (True Positive Rate) for the given confidence threshold.", "type": "number" }, "trueNegativeCount": { "format": "int64", "description": "The number of labels that were not created by the Model, but if they would, they would not match a ground truth label.", "type": "string" }, "truePositiveCount": { "description": "The number of Model created labels that match a ground truth label.", "format": "int64", "type": "string" }, "maxPredictions": { "description": "Metrics are computed with an assumption that the Model always returns at most this many predictions (ordered by their score, descendingly), but they all still need to meet the `confidenceThreshold`.", "format": "int32", "type": "integer" }, "falsePositiveRate": { "format": "float", "description": "False Positive Rate for the given confidence threshold.", "type": "number" }, "f1ScoreMacro": { "type": "number", "format": "float", "description": "Macro-averaged F1 Score." }, "recallAt1": { "description": "The Recall (True Positive Rate) when only considering the label that has the highest prediction score and not below the confidence threshold for each DataItem.", "format": "float", "type": "number" } } }, "GoogleCloudAiplatformV1beta1DirectRawPredictRequest": { "description": "Request message for PredictionService.DirectRawPredict.", "type": "object", "properties": { "input": { "format": "byte", "description": "The prediction input.", "type": "string" }, "methodName": { "description": "Fully qualified name of the API method being invoked to perform predictions. Format: `/namespace.Service/Method/` Example: `/tensorflow.serving.PredictionService/Predict`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1DirectRawPredictRequest" }, "GoogleCloudAiplatformV1beta1TaskMessage": { "description": "Represents a single message in a conversation, compliant with the A2A specification.", "properties": { "role": { "type": "string", "description": "Required. The role of the sender of the message. e.g. \"user\", \"agent\"" }, "parts": { "description": "Required. The parts of the message.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Part" } }, "messageId": { "description": "Required. The unique identifier of the message.", "type": "string" }, "metadata": { "description": "Optional. A2A message may have extension_uris or reference_task_ids. They will be stored under metadata.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" } }, "id": "GoogleCloudAiplatformV1beta1TaskMessage", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpec": { "type": "object", "properties": { "shieldedInstanceConfig": { "description": "Optional. Shielded VM configuration (for example, Secure Boot) for the execution VM.", "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpecShieldedInstanceConfig" }, "persistentDiskSpec": { "description": "The specification of a persistent disk to attach for the execution job.", "$ref": "GoogleCloudAiplatformV1beta1PersistentDiskSpec" }, "machineSpec": { "description": "The specification of a single machine for the execution job.", "$ref": "GoogleCloudAiplatformV1beta1MachineSpec" }, "networkSpec": { "description": "The network configuration to use for the execution job.", "$ref": "GoogleCloudAiplatformV1beta1NetworkSpec" } }, "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpec", "description": "Compute configuration to use for an execution job." }, "GoogleCloudAiplatformV1beta1ConversationTurn": { "description": "Represents a single turn/invocation in the conversation.", "properties": { "turnId": { "type": "string", "description": "Optional. A unique identifier for the turn. Useful for referencing specific turns across systems." }, "events": { "description": "Optional. The list of events that occurred during this turn.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1AgentEvent" } }, "turnIndex": { "format": "int32", "type": "integer", "description": "Required. The 0-based index of the turn in the conversation sequence." } }, "id": "GoogleCloudAiplatformV1beta1ConversationTurn", "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployVertex": { "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployVertex", "description": "Multiple setups to deploy the PublisherModel.", "properties": { "multiDeployVertex": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeploy" }, "description": "Optional. One click deployment configurations." } } }, "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadata": { "properties": { "inputConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataInputConfig" }, "timeSeriesIdentifierColumn": { "type": "string", "description": "The column name of the time series identifier column that identifies the time series." }, "timeColumn": { "type": "string", "description": "The column name of the time column that identifies time order in the time series." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadata", "description": "The metadata of Datasets that contain time series data." }, "GoogleCloudAiplatformV1beta1ExactMatchSpec": { "properties": {}, "type": "object", "description": "Spec for exact match metric - returns 1 if prediction and reference exactly matches, otherwise 0.", "id": "GoogleCloudAiplatformV1beta1ExactMatchSpec" }, "GoogleCloudAiplatformV1beta1KeepAliveProbeHttpGet": { "properties": { "path": { "description": "Required. Specifies the path of the HTTP GET request (e.g., `\"/is_busy\"`).", "type": "string" }, "port": { "description": "Optional. Specifies the port number on the container to which the request is sent.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1KeepAliveProbeHttpGet", "type": "object", "description": "Specifies the HTTP GET configuration for the probe." }, "GenaiVertexV1beta1CodeExecutionResultStep": { "id": "GenaiVertexV1beta1CodeExecutionResultStep", "properties": { "isError": { "type": "boolean", "description": "Whether the code execution resulted in an error." }, "result": { "description": "Required. The output of the code execution.", "type": "string" } }, "description": "Code execution result step.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoObjectTrackingPredictionInstance": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoObjectTrackingPredictionInstance", "properties": { "timeSegmentStart": { "description": "The beginning, inclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision.", "type": "string" }, "timeSegmentEnd": { "description": "The end, exclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision, and \"inf\" or \"Infinity\" is allowed, which means the end of the video.", "type": "string" }, "mimeType": { "description": "The MIME type of the content of the video. Only the following are supported: video/mp4 video/avi video/quicktime", "type": "string" }, "content": { "description": "The Google Cloud Storage location of the video on which to perform the prediction.", "type": "string" } }, "description": "Prediction input format for Video Object Tracking.", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchDeleteRagDataSchemasRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchDeleteRagDataSchemasRequest", "properties": { "names": { "type": "array", "description": "Required. The RagDataSchemas to delete. A maximum of 500 schemas can be deleted in a batch. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}/ragDataSchemas/{rag_data_schema}`", "items": { "type": "string" } } }, "description": "Request message for VertexRagDataService.BatchDeleteRagDataSchemas." }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled": { "description": "Scaled tier offers production grade performance along with autoscaling functionality. It is suitable for customers with large amounts of data or performance sensitive workloads.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled", "properties": {} }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextClassificationPredictionInstance": { "properties": { "mimeType": { "description": "The MIME type of the text snippet. The supported MIME types are listed below. - text/plain", "type": "string" }, "content": { "description": "The text snippet to make the predictions on.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextClassificationPredictionInstance", "description": "Prediction input format for Text Classification.", "type": "object" }, "GoogleCloudAiplatformV1beta1FunctionResponseBlob": { "description": "Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field.", "type": "object", "id": "GoogleCloudAiplatformV1beta1FunctionResponseBlob", "properties": { "mimeType": { "type": "string", "description": "Required. The IANA standard MIME type of the source data." }, "data": { "type": "string", "description": "Required. Raw bytes.", "format": "byte" }, "displayName": { "type": "string", "description": "Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled." } } }, "GenaiVertexV1beta1CodeExecutionCallContentCodeExecutionCallArguments": { "description": "The arguments to pass to the code execution.", "properties": { "language": { "description": "Programming language of the `code`.", "enumDescriptions": [ "Unspecified language. This value should not be used.", "Python \u003e= 3.10, with numpy and simpy available." ], "enum": [ "LANGUAGE_UNSPECIFIED", "PYTHON" ], "type": "string" }, "code": { "type": "string", "description": "The code to be executed." } }, "id": "GenaiVertexV1beta1CodeExecutionCallContentCodeExecutionCallArguments", "type": "object" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInstance": { "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInstance", "type": "object", "description": "Spec for question answering correctness instance.", "properties": { "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" }, "instruction": { "description": "Required. The question asked and other instruction in the inference prompt.", "type": "string" }, "context": { "description": "Optional. Text provided as context to answer the question.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } } }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfig": { "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfig", "properties": { "randomSampling": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfigRandomSampling", "description": "Random sampling method." }, "maxEvaluatedSamplesPerRun": { "type": "string", "format": "int64", "description": "Optional. The maximum number of evaluations to perform per run. If set to 0, the number is unbounded." } }, "description": "Configuration for sampling behavior of the OnlineEvaluator. The OnlineEvaluator runs at a fixed interval of 10 minutes.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsQuestionAnsweringEvaluationMetrics": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsQuestionAnsweringEvaluationMetrics", "properties": { "exactMatch": { "format": "float", "description": "The rate at which the input predicted strings exactly match their references.", "type": "number" } } }, "GoogleCloudAiplatformV1beta1KeepAliveProbe": { "properties": { "maxSeconds": { "type": "integer", "description": "Optional. Specifies the maximum duration (in seconds) to keep the instance alive via this probe. Can be a maximum of 3600 seconds (1 hour).", "format": "int32" }, "httpGet": { "$ref": "GoogleCloudAiplatformV1beta1KeepAliveProbeHttpGet", "description": "Optional. Specifies the HTTP GET configuration for the probe." } }, "description": "Represents the configuration for keep-alive probe. Contains configuration on a specified endpoint that a deployment host should use to keep the container alive based on the probe settings.", "type": "object", "id": "GoogleCloudAiplatformV1beta1KeepAliveProbe" }, "GoogleCloudAiplatformV1beta1TrajectoryRecallResults": { "type": "object", "properties": { "trajectoryRecallMetricValues": { "readOnly": true, "description": "Output only. TrajectoryRecall metric values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryRecallMetricValue" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1TrajectoryRecallResults", "description": "Results for TrajectoryRecall metric." }, "GoogleCloudAiplatformV1beta1UpdateIndexOperationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateIndexOperationMetadata", "description": "Runtime operation information for IndexService.UpdateIndex.", "properties": { "nearestNeighborSearchOperationMetadata": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadata", "description": "The operation metadata with regard to Matching Engine Index operation." }, "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1SafetyInstance": { "description": "Spec for safety instance.", "id": "GoogleCloudAiplatformV1beta1SafetyInstance", "type": "object", "properties": { "prediction": { "type": "string", "description": "Required. Output of the evaluated model." } } }, "GoogleCloudAiplatformV1beta1ListA2aTasksResponse": { "type": "object", "properties": { "nextPageToken": { "description": "A token, which can be sent as ListA2aTasksRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.", "type": "string" }, "a2aTasks": { "type": "array", "description": "List of A2aTasks in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aTask" } } }, "id": "GoogleCloudAiplatformV1beta1ListA2aTasksResponse", "description": "Response message for ListA2aTasks." }, "GoogleCloudAiplatformV1beta1ResumeScheduleRequest": { "type": "object", "properties": { "catchUp": { "description": "Optional. Whether to backfill missed runs when the schedule is resumed from PAUSED state. If set to true, all missed runs will be scheduled. New runs will be scheduled after the backfill is complete. This will also update Schedule.catch_up field. Default to false.", "type": "boolean" } }, "description": "Request message for ScheduleService.ResumeSchedule.", "id": "GoogleCloudAiplatformV1beta1ResumeScheduleRequest" }, "GoogleCloudAiplatformV1beta1SchemaImageBoundingBoxAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaImageBoundingBoxAnnotation", "type": "object", "description": "Annotation details specific to image object detection.", "properties": { "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." }, "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "yMin": { "format": "double", "type": "number", "description": "The topmost coordinate of the bounding box." }, "xMin": { "type": "number", "description": "The leftmost coordinate of the bounding box.", "format": "double" }, "yMax": { "description": "The bottommost coordinate of the bounding box.", "format": "double", "type": "number" }, "xMax": { "type": "number", "description": "The rightmost coordinate of the bounding box.", "format": "double" } } }, "GoogleCloudAiplatformV1beta1ExtensionPrivateServiceConnectConfig": { "description": "PrivateExtensionConfig configuration for the extension.", "type": "object", "properties": { "serviceDirectory": { "description": "Required. The Service Directory resource name in which the service endpoints associated to the extension are registered. Format: `projects/{project_id}/locations/{location_id}/namespaces/{namespace_id}/services/{service_id}` - The Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) should be granted `servicedirectory.viewer` and `servicedirectory.pscAuthorizedService` roles on the resource.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExtensionPrivateServiceConnectConfig" }, "GoogleCloudAiplatformV1beta1FindNeighborsResponse": { "properties": { "nearestNeighbors": { "description": "The nearest neighbors of the query datapoints.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsResponseNearestNeighbors" } } }, "description": "The response message for MatchService.FindNeighbors.", "id": "GoogleCloudAiplatformV1beta1FindNeighborsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1ListHyperparameterTuningJobsResponse": { "type": "object", "properties": { "hyperparameterTuningJobs": { "description": "List of HyperparameterTuningJobs in the requested page. HyperparameterTuningJob.trials of the jobs will be not be returned.", "items": { "$ref": "GoogleCloudAiplatformV1beta1HyperparameterTuningJob" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListHyperparameterTuningJobsRequest.page_token to obtain that page." } }, "id": "GoogleCloudAiplatformV1beta1ListHyperparameterTuningJobsResponse", "description": "Response message for JobService.ListHyperparameterTuningJobs" }, "GoogleCloudAiplatformV1beta1PersistentDiskSpec": { "type": "object", "properties": { "diskSizeGb": { "format": "int64", "description": "Size in GB of the disk (default is 100GB).", "type": "string" }, "diskType": { "type": "string", "description": "Type of the disk (default is \"pd-standard\"). Valid values: \"pd-ssd\" (Persistent Disk Solid State Drive) \"pd-standard\" (Persistent Disk Hard Disk Drive) \"pd-balanced\" (Balanced Persistent Disk) \"pd-extreme\" (Extreme Persistent Disk) \"hyperdisk-balanced\" (Hyperdisk Balanced) \"hyperdisk-extreme\" (Hyperdisk Extreme) \"hyperdisk-balanced-high-availability\" (Hyperdisk Balanced High Availability) \"hyperdisk-ml\" (Hyperdisk ML) \"hyperdisk-throughput\" (Hyperdisk Throughput)" } }, "description": "Represents the spec of persistent disk and hyperdisk options.", "id": "GoogleCloudAiplatformV1beta1PersistentDiskSpec" }, "GoogleCloudAiplatformV1beta1GeminiAgentConfig": { "description": "Config for scraping a Gemini Agent (a Vertex AI Agent resource scraped via the Vertex Interactions API).", "properties": { "geminiAgent": { "type": "string", "description": "Required. The resource name of the Gemini Agent. Format: `projects/{project}/locations/{location}/agents/{agent}`. For example: `projects/123/locations/us-central1/agents/my-agent`." } }, "id": "GoogleCloudAiplatformV1beta1GeminiAgentConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1TensorboardRun": { "type": "object", "properties": { "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your TensorboardRuns. This field will be used to filter and visualize Runs in the Tensorboard UI. For example, a Vertex AI training job can set a label aiplatform.googleapis.com/training_job_id=xxxxx to all the runs created within that job. An end user can set a label experiment_id=xxxxx for all the runs produced in a Jupyter notebook. These runs can be grouped by a label value and visualized together in the Tensorboard UI. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one TensorboardRun (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable." }, "name": { "readOnly": true, "type": "string", "description": "Output only. Name of the TensorboardRun. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`" }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this TensorboardRun was created.", "readOnly": true }, "updateTime": { "description": "Output only. Timestamp when this TensorboardRun was last updated.", "readOnly": true, "type": "string", "format": "google-datetime" }, "displayName": { "type": "string", "description": "Required. User provided name of this TensorboardRun. This value must be unique among all TensorboardRuns belonging to the same parent TensorboardExperiment." }, "description": { "description": "Description of this TensorboardRun.", "type": "string" }, "etag": { "type": "string", "description": "Used to perform a consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." } }, "description": "TensorboardRun maps to a specific execution of a training job with a given set of hyperparameter values, model definition, dataset, etc", "id": "GoogleCloudAiplatformV1beta1TensorboardRun" }, "GenaiVertexV1beta1ToolChoiceConfig": { "description": "The tool choice configuration containing allowed tools.", "properties": { "allowedTools": { "$ref": "GenaiVertexV1beta1AllowedTools", "description": "The allowed tools." } }, "id": "GenaiVertexV1beta1ToolChoiceConfig", "type": "object" }, "GenaiVertexV1beta1ModelOutputStep": { "type": "object", "id": "GenaiVertexV1beta1ModelOutputStep", "description": "Output generated by the model.", "properties": { "error": { "$ref": "GoogleRpcStatus", "deprecated": true, "description": "The error result of the operation in case of failure or cancellation." }, "content": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1Content" } } } }, "GoogleCloudAiplatformV1beta1SyncFeatureViewResponse": { "type": "object", "properties": { "featureViewSync": { "description": "Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}/featureViewSyncs/{feature_view_sync}`", "type": "string" } }, "description": "Response message for FeatureOnlineStoreAdminService.SyncFeatureView.", "id": "GoogleCloudAiplatformV1beta1SyncFeatureViewResponse" }, "GoogleCloudAiplatformV1beta1TunedModelCheckpoint": { "type": "object", "properties": { "checkpointId": { "description": "The ID of the checkpoint.", "type": "string" }, "step": { "description": "The step of the checkpoint.", "format": "int64", "type": "string" }, "endpoint": { "type": "string", "description": "The Endpoint resource name that the checkpoint is deployed to. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`." }, "epoch": { "type": "string", "format": "int64", "description": "The epoch of the checkpoint." } }, "id": "GoogleCloudAiplatformV1beta1TunedModelCheckpoint", "description": "TunedModelCheckpoint for the Tuned Model of a Tuning Job." }, "GoogleCloudAiplatformV1beta1ExecuteExtensionResponse": { "id": "GoogleCloudAiplatformV1beta1ExecuteExtensionResponse", "description": "Response message for ExtensionExecutionService.ExecuteExtension.", "type": "object", "properties": { "content": { "description": "Response content from the extension. The content should be conformant to the response.content schema in the extension's manifest/OpenAPI spec.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetricsConfidenceMetrics": { "properties": { "f1Score": { "type": "number", "description": "The harmonic mean of recall and precision.", "format": "float" }, "precision": { "format": "float", "type": "number", "description": "Precision under the given confidence threshold." }, "confidenceThreshold": { "type": "number", "format": "float", "description": "The confidence threshold value used to compute the metrics." }, "recall": { "format": "float", "description": "Recall under the given confidence threshold.", "type": "number" } }, "type": "object", "description": "Metrics for a single confidence threshold.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetricsConfidenceMetrics" }, "GoogleCloudAiplatformV1beta1GenerateUserScenariosResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerateUserScenariosResponse", "description": "Response message for DataFoundryService.GenerateUserScenarios.", "properties": { "userScenarios": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1UserScenario" }, "description": "The generated user scenarios used to simulate multi-turn agent running results and agent evaluation." } } }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata": { "type": "object", "properties": { "groundingMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GroundingMetadata", "description": "Optional. Sources used to ground the content." }, "citationMetadata": { "description": "Optional. Citations that apply to the content.", "$ref": "GoogleCloudAiplatformV1beta1CitationMetadata" } }, "description": "Metadata the model returned alongside the content it generated.", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata" }, "GoogleCloudAiplatformV1beta1ExplainRequest": { "id": "GoogleCloudAiplatformV1beta1ExplainRequest", "properties": { "concurrentExplanationSpecOverride": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpecOverride" }, "description": "Optional. This field is the same as the one above, but supports multiple explanations to occur in parallel. The key can be any string. Each override will be run against the model, then its explanations will be grouped together. Note - these explanations are run **In Addition** to the default Explanation in the deployed model.", "type": "object" }, "parameters": { "description": "The parameters that govern the prediction. The schema of the parameters may be specified via Endpoint's DeployedModels' Model's PredictSchemata's parameters_schema_uri.", "type": "any" }, "instances": { "items": { "type": "any" }, "type": "array", "description": "Required. The instances that are the input to the explanation call. A DeployedModel may have an upper limit on the number of instances it supports per request, and when it is exceeded the explanation call errors in case of AutoML Models, or, in case of customer created Models, the behaviour is as documented by that Model. The schema of any single instance may be specified via Endpoint's DeployedModels' Model's PredictSchemata's instance_schema_uri." }, "explanationSpecOverride": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpecOverride", "description": "If specified, overrides the explanation_spec of the DeployedModel. Can be used for explaining prediction results with different configurations, such as: - Explaining top-5 predictions results as opposed to top-1; - Increasing path count or step count of the attribution methods to reduce approximate errors; - Using different baselines for explaining the prediction results." }, "deployedModelId": { "type": "string", "description": "If specified, this ExplainRequest will be served by the chosen DeployedModel, overriding Endpoint.traffic_split." } }, "description": "Request message for PredictionService.Explain.", "type": "object" }, "GoogleCloudAiplatformV1beta1CloudLoggingConfigTracingContext": { "description": "Tracing context for Observability correlation.", "properties": { "spanId": { "type": "string", "description": "Optional. ID of the Cloud Trace span associated with the current operation in which the log is being written. e.g., `7a2190356c3fc94b`. If a span is being evaluated, this field should be populated." }, "conversationId": { "description": "Optional. Unique identifier for a conversation (session thread), used to store and correlate messages within a conversation. The value corresponds to the `gen_ai.conversation.id` field in the the OpenTelemetry GenAI attributes.", "type": "string" }, "traceId": { "type": "string", "description": "Optional. Trace ID being written to Cloud Trace in association with this log entry. e.g., `12345`, the numeric ID from the resource name. If a trace or span is being evaluated, this field should be populated." } }, "id": "GoogleCloudAiplatformV1beta1CloudLoggingConfigTracingContext", "type": "object" }, "GoogleCloudAiplatformV1beta1ListExecutionsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListExecutionsRequest.page_token to retrieve the next page. If this field is not populated, there are no subsequent pages." }, "executions": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "type": "array", "description": "The Executions retrieved from the MetadataStore." } }, "description": "Response message for MetadataService.ListExecutions.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListExecutionsResponse" }, "GoogleCloudAiplatformV1beta1GenericOperationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Time when the operation was updated for the last time. If the operation has finished (successfully or not), this is the finish time.", "type": "string" }, "createTime": { "type": "string", "description": "Output only. Time when the operation was created.", "format": "google-datetime", "readOnly": true }, "partialFailures": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleRpcStatus" }, "description": "Output only. Partial failures encountered. E.g. single files that couldn't be read. This field should never exceed 20 entries. Status details field will contain standard Google Cloud error details." } }, "description": "Generic Metadata shared by all operations." }, "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly": { "properties": { "anomalyDetectionThreshold": { "description": "This is the threshold used when detecting anomalies. The threshold can be changed by user, so this one might be different from ThresholdConfig.value.", "type": "number", "format": "double" }, "endTime": { "format": "google-datetime", "description": "The end timestamp of window where stats were generated. For objectives where time window doesn't make sense (e.g. Featurestore Snapshot Monitoring), end_time indicates the timestamp of the data used to generate stats (e.g. timestamp we take snapshots for feature values).", "type": "string" }, "startTime": { "description": "The start timestamp of window where stats were generated. For objectives where time window doesn't make sense (e.g. Featurestore Snapshot Monitoring), start_time is only used to indicate the monitoring intervals, so it always equals to (end_time - monitoring_interval).", "type": "string", "format": "google-datetime" }, "distributionDeviation": { "type": "number", "description": "Deviation from the current stats to baseline stats. 1. For categorical feature, the distribution distance is calculated by L-inifinity norm. 2. For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence.", "format": "double" }, "statsUri": { "description": "Path of the stats file for current feature values in Cloud Storage bucket. Format: gs:////stats. Example: gs://monitoring_bucket/feature_name/stats. Stats are stored as binary format with Protobuf message [tensorflow.metadata.v0.FeatureNameStatistics](https://github.com/tensorflow/metadata/blob/master/tensorflow_metadata/proto/v0/statistics.proto).", "type": "string" }, "score": { "format": "double", "type": "number", "description": "Feature importance score, only populated when cross-feature monitoring is enabled. For now only used to represent feature attribution score within range [0, 1] for ModelDeploymentMonitoringObjectiveType.FEATURE_ATTRIBUTION_SKEW and ModelDeploymentMonitoringObjectiveType.FEATURE_ATTRIBUTION_DRIFT." }, "anomalyUri": { "description": "Path of the anomaly file for current feature values in Cloud Storage bucket. Format: gs:////anomalies. Example: gs://monitoring_bucket/feature_name/anomalies. Stats are stored as binary format with Protobuf message Anoamlies are stored as binary format with Protobuf message [tensorflow.metadata.v0.AnomalyInfo] (https://github.com/tensorflow/metadata/blob/master/tensorflow_metadata/proto/v0/anomalies.proto).", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly", "description": "Stats and Anomaly generated at specific timestamp for specific Feature. The start_time and end_time are used to define the time range of the dataset that current stats belongs to, e.g. prediction traffic is bucketed into prediction datasets by time window. If the Dataset is not defined by time window, start_time = end_time. Timestamp of the stats and anomalies always refers to end_time. Raw stats and anomalies are stored in stats_uri or anomaly_uri in the tensorflow defined protos. Field data_stats contains almost identical information with the raw stats in Vertex AI defined proto, for UI to display." }, "GenaiVertexV1beta1DynamicAgentConfig": { "description": "Configuration for dynamic agents.", "properties": { "config": { "$ref": "GenaiVertexV1beta1Struct", "description": "For agents that are not supported statically in the API definition." } }, "id": "GenaiVertexV1beta1DynamicAgentConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1UploadRagFileConfig": { "description": "Config for uploading RagFile.", "properties": { "ragFileParsingConfig": { "description": "Optional. Specifies the parsing config for RagFiles. RAG will use the default parser if this field is not set.", "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfig" }, "ragFileChunkingConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "description": "Specifies the size and overlap of chunks after uploading RagFile.", "deprecated": true }, "ragFileMetadataConfig": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1RagFileMetadataConfig", "description": "Optional. Specifies the metadata config for RagFiles. Including paths for metadata schema and metadata. Alteratively, inline metadata schema and metadata can be provided. Deprecated: Not in use." }, "ragFileTransformationConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileTransformationConfig", "description": "Specifies the transformation config for RagFiles." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UploadRagFileConfig" }, "GoogleCloudAiplatformV1beta1CodeExecutionResult": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CodeExecutionResult", "description": "Result of executing the ExecutableCode. Generated only when the `CodeExecution` tool is used.", "properties": { "output": { "type": "string", "description": "Optional. Contains stdout when code execution is successful, stderr or other description otherwise." }, "outcome": { "enum": [ "OUTCOME_UNSPECIFIED", "OUTCOME_OK", "OUTCOME_FAILED", "OUTCOME_DEADLINE_EXCEEDED" ], "enumDescriptions": [ "Unspecified status. This value should not be used.", "Code execution completed successfully. `output` contains the stdout, if any.", "Code execution failed. `output` contains the stderr and stdout, if any.", "Code execution ran for too long, and was cancelled. There may or may not be a partial `output` present." ], "description": "Required. Outcome of the code execution.", "type": "string" }, "id": { "description": "Optional. The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1BatchDeletePipelineJobsResponse": { "properties": { "pipelineJobs": { "description": "PipelineJobs deleted.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" } } }, "type": "object", "description": "Response message for PipelineService.BatchDeletePipelineJobs.", "id": "GoogleCloudAiplatformV1beta1BatchDeletePipelineJobsResponse" }, "GoogleCloudAiplatformV1beta1UploadModelResponse": { "description": "Response message of ModelService.UploadModel operation.", "properties": { "model": { "type": "string", "description": "The name of the uploaded Model resource. Format: `projects/{project}/locations/{location}/models/{model}`" }, "modelVersionId": { "type": "string", "description": "Output only. The version ID of the model that is uploaded.", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UploadModelResponse" }, "GenaiVertexV1beta1UrlContextResultStepUrlContextResultItem": { "id": "GenaiVertexV1beta1UrlContextResultStepUrlContextResultItem", "type": "object", "description": "The result of the URL context.", "properties": { "url": { "type": "string", "description": "The URL that was fetched." }, "status": { "enum": [ "STATUS_UNSPECIFIED", "SUCCESS", "ERROR", "PAYWALL", "UNSAFE" ], "description": "The status of the URL retrieval.", "type": "string", "enumDescriptions": [ "", "", "", "", "" ] } } }, "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataInputConfig": { "properties": { "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataBigQuerySource" }, "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataGcsSource" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataInputConfig", "description": "The tables Dataset's data source. The Dataset doesn't store the data directly, but only pointer(s) to its data.", "type": "object" }, "GoogleCloudAiplatformV1beta1Memory": { "properties": { "disableMemoryRevisions": { "description": "Optional. Input only. Indicates whether no revision will be created for this request.", "type": "boolean" }, "displayName": { "description": "Optional. Represents the display name of the Memory.", "type": "string" }, "memoryType": { "enumDescriptions": [ "Represents an unspecified memory type. This value should not be used.", "Indicates belonging to a collection of natural language memories.", "Indicates belonging to a structured profile." ], "type": "string", "description": "Optional. Represents the type of the memory. If not set, the `NATURAL_LANGUAGE_COLLECTION` type is used. If `STRUCTURED_COLLECTION` or `STRUCTURED_PROFILE` is used, then `structured_data` must be provided.", "enum": [ "MEMORY_TYPE_UNSPECIFIED", "NATURAL_LANGUAGE_COLLECTION", "STRUCTURED_PROFILE" ] }, "expireTime": { "format": "google-datetime", "type": "string", "description": "Optional. Represents the timestamp of when this resource is considered expired. This is *always* provided on output when `expiration` is set on input, regardless of whether `expire_time` or `ttl` was provided." }, "revisionLabels": { "additionalProperties": { "type": "string" }, "description": "Optional. Input only. Represents the labels to apply to the Memory Revision created as a result of this request.", "type": "object" }, "name": { "type": "string", "description": "Identifier. Represents the resource name of the Memory. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/memories/{memory}`" }, "description": { "type": "string", "description": "Optional. Represents the description of the Memory." }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Represents the timestamp when this Memory was created.", "format": "google-datetime" }, "revisionTtl": { "format": "google-duration", "type": "string", "description": "Optional. Input only. Represents the TTL for the revision. The expiration time is computed: now + TTL." }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Represents the timestamp when this Memory was most recently updated." }, "revisionExpireTime": { "type": "string", "format": "google-datetime", "description": "Optional. Input only. Represents the timestamp of when the revision is considered expired. If not set, the memory revision will be kept until manually deleted." }, "fact": { "type": "string", "description": "Optional. Represents semantic knowledge extracted from the source content." }, "context": { "type": "string", "description": "Optional. Represents the context of the memory." }, "scope": { "description": "Required. Immutable. Represents the scope of the Memory. Memories are isolated within their scope. The scope is defined when creating or generating memories. Scope values cannot contain the wildcard character '*'.", "type": "object", "additionalProperties": { "type": "string" } }, "metadata": { "description": "Optional. Represents user-provided metadata for the Memory. This information was provided when creating, updating, or generating the Memory. It was not generated by Memory Bank.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1MemoryMetadataValue" }, "type": "object" }, "topics": { "type": "array", "description": "Optional. Represents the Topics of the Memory.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryTopicId" } }, "structuredContent": { "$ref": "GoogleCloudAiplatformV1beta1MemoryStructuredContent", "description": "Optional. Represents the structured content of the memory." }, "ttl": { "format": "google-duration", "type": "string", "description": "Optional. Input only. Represents the TTL for this resource. The expiration time is computed: now + TTL." } }, "id": "GoogleCloudAiplatformV1beta1Memory", "description": "A memory.", "type": "object" }, "GoogleCloudAiplatformV1beta1GeminiRequestReadConfig": { "type": "object", "description": "Configuration for how to read Gemini requests from a multimodal dataset.", "properties": { "templateConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiTemplateConfig", "description": "Gemini request template with placeholders." }, "assembledRequestColumnName": { "type": "string", "description": "Optional. Column name in the dataset table that contains already fully assembled Gemini requests." } }, "id": "GoogleCloudAiplatformV1beta1GeminiRequestReadConfig" }, "GenaiVertexV1beta1GoogleSearch": { "description": "A tool that can be used by the model to search Google.", "type": "object", "properties": { "searchTypes": { "items": { "enum": [ "SEARCH_TYPE_UNSPECIFIED", "SEARCH_TYPE_WEB_SEARCH", "SEARCH_TYPE_IMAGE_SEARCH", "SEARCH_TYPE_ENTERPRISE_WEB_SEARCH" ], "enumDescriptions": [ "Unspecified search type. This value should not be used.", "Setting this field enables web search. Only text results are returned.", "Setting this field enables image search. Image bytes are returned.", "Setting this field enables enterprise web search." ], "type": "string" }, "type": "array", "description": "The types of search grounding to enable." } }, "id": "GenaiVertexV1beta1GoogleSearch" }, "GoogleCloudAiplatformV1beta1AugmentPromptResponse": { "type": "object", "description": "Response message for AugmentPrompt.", "properties": { "augmentedPrompt": { "description": "Augmented prompt, only text format is supported for now.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array" }, "facts": { "description": "Retrieved facts from RAG data sources.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Fact" } } }, "id": "GoogleCloudAiplatformV1beta1AugmentPromptResponse" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordStatusUpdate": { "description": "An event payload that updates the task's state and optional status message.", "properties": { "message": { "description": "Optional. The status message associated with the state change.", "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage" }, "timestamp": { "description": "Optional. The time at which the status change occurred.", "type": "string", "format": "google-datetime" }, "state": { "description": "Required. The new state of the task.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ], "enumDescriptions": [ "The task is in an unknown or indeterminate state.", "Indicates that a task has been successfully submitted and acknowledged.", "Indicates that a task is actively being processed by the agent.", "Indicates that a task has finished successfully. This is a terminal state.", "Indicates that a task has finished with an error. This is a terminal state.", "Indicates that a task was canceled before completion. This is a terminal state.", "Indicates that the agent requires additional user input to proceed. This is an interrupted state.", "Indicates that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", "Indicates that authentication is required to proceed. This is an interrupted state." ] } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordStatusUpdate" }, "GoogleCloudAiplatformV1beta1AppendEventResponse": { "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1AppendEventResponse", "description": "Response message for SessionService.AppendEvent." }, "GoogleCloudAiplatformV1beta1ModelMonitoringConfig": { "type": "object", "description": "The model monitoring configuration used for Batch Prediction Job.", "properties": { "objectiveConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfig" }, "description": "Model monitoring objective config.", "type": "array" }, "alertConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfig", "description": "Model monitoring alert config." }, "statsAnomaliesBaseDirectory": { "description": "A Google Cloud Storage location for batch prediction model monitoring to dump statistics and anomalies. If not provided, a folder will be created in customer project to hold statistics and anomalies.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "analysisInstanceSchemaUri": { "description": "YAML schema file uri in Cloud Storage describing the format of a single instance that you want Tensorflow Data Validation (TFDV) to analyze. If there are any data type differences between predict instance and TFDV instance, this field can be used to override the schema. For models trained with Vertex AI, this field must be set as all the fields in predict instance formatted as string.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringConfig" }, "GoogleCloudAiplatformV1beta1CreateNotebookRuntimeTemplateOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateNotebookRuntimeTemplateOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Metadata information for NotebookService.CreateNotebookRuntimeTemplate." }, "GoogleCloudAiplatformV1beta1PredefinedSplit": { "properties": { "key": { "description": "Required. The key is a name of one of the Dataset's data columns. The value of the key (either the label's value or value in the column) must be one of {`training`, `validation`, `test`}, and it defines to which set the given piece of data is assigned. If for a piece of data the key is not present or has an invalid value, that piece is ignored by the pipeline.", "type": "string" } }, "description": "Assigns input data to training, validation, and test sets based on the value of a provided key. Supported only for tabular Datasets.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PredefinedSplit" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputs": { "properties": { "contextWindow": { "type": "string", "description": "The amount of time into the past training and prediction data is used for model training and prediction respectively. Expressed in number of units defined by the `data_granularity` field.", "format": "int64" }, "transformations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformation" }, "description": "Each transformation will apply transform function to given input column. And the result will be used for training. When creating transformation for BigQuery Struct column, the column should be flattened using \".\" as the delimiter." }, "exportEvaluatedDataItemsConfig": { "description": "Configuration for exporting test set predictions to a BigQuery table. If this configuration is absent, then the export is not performed.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig" }, "availableAtForecastColumns": { "description": "Names of columns that are available and provided when a forecast is requested. These columns contain information for the given entity (identified by the time_series_identifier_column column) that is known at forecast. For example, predicted weather for a specific day.", "type": "array", "items": { "type": "string" } }, "trainBudgetMilliNodeHours": { "type": "string", "format": "int64", "description": "Required. The train budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The training cost of the model will not exceed this budget. The final cost will be attempted to be close to the budget, though may end up being (even) noticeably smaller - at the backend's discretion. This especially may happen when further model training ceases to provide any improvements. If the budget is set to a value known to be insufficient to train a model for the given dataset, the training won't be attempted and will error. The train budget must be between 1,000 and 72,000 milli node hours, inclusive." }, "hierarchyConfig": { "description": "Configuration that defines the hierarchical relationship of time series and parameters for hierarchical forecasting strategies.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHierarchyConfig" }, "holidayRegions": { "type": "array", "description": "The geographical region based on which the holiday effect is applied in modeling by adding holiday categorical array feature that include all holidays matching the date. This option only allowed when data_granularity is day. By default, holiday effect modeling is disabled. To turn it on, specify the holiday region using this option.", "items": { "type": "string" } }, "windowConfig": { "description": "Config containing strategy for generating sliding windows.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionWindowConfig" }, "targetColumn": { "description": "The name of the column that the Model is to predict values for. This column must be unavailable at forecast.", "type": "string" }, "optimizationObjective": { "type": "string", "description": "Objective function the model is optimizing towards. The training process creates a model that optimizes the value of the objective function over the validation set. The supported optimization objectives: * \"minimize-rmse\" (default) - Minimize root-mean-squared error (RMSE). * \"minimize-mae\" - Minimize mean-absolute error (MAE). * \"minimize-rmsle\" - Minimize root-mean-squared log error (RMSLE). * \"minimize-rmspe\" - Minimize root-mean-squared percentage error (RMSPE). * \"minimize-wape-mae\" - Minimize the combination of weighted absolute percentage error (WAPE) and mean-absolute-error (MAE). * \"minimize-quantile-loss\" - Minimize the quantile loss at the quantiles defined in `quantiles`. * \"minimize-mape\" - Minimize the mean absolute percentage error." }, "unavailableAtForecastColumns": { "items": { "type": "string" }, "type": "array", "description": "Names of columns that are unavailable when a forecast is requested. This column contains information for the given entity (identified by the time_series_identifier_column) that is unknown before the forecast For example, actual weather on a given day." }, "quantiles": { "description": "Quantiles to use for minimize-quantile-loss `optimization_objective`. Up to 5 quantiles are allowed of values between 0 and 1, exclusive. Required if the value of optimization_objective is minimize-quantile-loss. Represents the percent quantiles to use for that objective. Quantiles must be unique.", "type": "array", "items": { "type": "number", "format": "double" } }, "weightColumn": { "description": "Column name that should be used as the weight column. Higher values in this column give more importance to the row during model training. The column must have numeric values between 0 and 10000 inclusively; 0 means the row is ignored for training. If weight column field is not set, then all rows are assumed to have equal weight of 1. This column must be available at forecast.", "type": "string" }, "forecastHorizon": { "description": "The amount of time into the future for which forecasted values for the target are returned. Expressed in number of units defined by the `data_granularity` field.", "format": "int64", "type": "string" }, "additionalExperiments": { "items": { "type": "string" }, "type": "array", "description": "Additional experiment flags for the time series forcasting training." }, "timeSeriesAttributeColumns": { "description": "Column names that should be used as attribute columns. The value of these columns does not vary as a function of time. For example, store ID or item color.", "type": "array", "items": { "type": "string" } }, "dataGranularity": { "description": "Expected difference in time granularity between rows in the data.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsGranularity" }, "timeSeriesIdentifierColumn": { "description": "The name of the column that identifies the time series.", "type": "string" }, "timeColumn": { "description": "The name of the column that identifies time order in the time series. This column must be available at forecast.", "type": "string" }, "validationOptions": { "description": "Validation options for the data validation component. The available options are: * \"fail-pipeline\" - default, will validate against the validation and fail the pipeline if it fails. * \"ignore-validation\" - ignore the results of the validation and continue", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputs", "type": "object" }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityView": { "description": "Entity view with Feature values.", "properties": { "data": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityViewData" }, "description": "Each piece of data holds the k requested values for one requested Feature. If no values for the requested Feature exist, the corresponding cell will be empty. This has the same size and is in the same order as the features from the header ReadFeatureValuesResponse.header." }, "entityId": { "type": "string", "description": "ID of the requested entity." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityView" }, "GenaiVertexV1beta1ServerToolCallDelta": { "type": "object", "properties": { "signature": { "description": "A signature hash for backend validation.", "type": "string", "format": "byte" }, "processingCall": { "$ref": "GenaiVertexV1beta1ProcessingCallDelta" }, "googleSearchCall": { "$ref": "GenaiVertexV1beta1GoogleSearchCallDelta" }, "googleMapsCall": { "$ref": "GenaiVertexV1beta1GoogleMapsCallDelta" }, "urlContextCall": { "$ref": "GenaiVertexV1beta1UrlContextCallDelta" }, "codeExecutionCall": { "$ref": "GenaiVertexV1beta1CodeExecutionCallDelta" }, "retrievalCall": { "$ref": "GenaiVertexV1beta1RetrievalCallDelta" }, "mcpServerToolCall": { "$ref": "GenaiVertexV1beta1McpServerToolCallDelta" }, "fileSearchCall": { "$ref": "GenaiVertexV1beta1FileSearchCallDelta" } }, "id": "GenaiVertexV1beta1ServerToolCallDelta" }, "GoogleCloudAiplatformV1beta1SchemaTextPromptDatasetMetadata": { "type": "object", "properties": { "candidateCount": { "format": "int64", "description": "Number of candidates.", "type": "string" }, "topP": { "description": "Top P value set when the dataset was saved. Given topK tokens for decoding, top candidates will be selected until the sum of their probabilities is topP.", "type": "number", "format": "float" }, "systemInstructionGcsUri": { "description": "The Google Cloud Storage URI that stores the system instruction, starting with gs://.", "type": "string" }, "note": { "description": "User-created prompt note. Note size limit is 2KB.", "type": "string" }, "topK": { "format": "int64", "type": "string", "description": "Top K value set when the dataset was saved. This value determines how many candidates with highest probability from the vocab would be selected for each decoding step." }, "stopSequences": { "items": { "type": "string" }, "description": "Customized stop sequences.", "type": "array" }, "systemInstruction": { "description": "The content of the prompt dataset system instruction.", "type": "string" }, "maxOutputTokens": { "format": "int64", "type": "string", "description": "Value of the maximum number of tokens generated set when the dataset was saved." }, "seedValue": { "description": "The actual value of the seed.", "type": "string", "format": "int64" }, "promptType": { "type": "string", "description": "Type of the prompt dataset." }, "logprobs": { "description": "Whether or not the user has enabled logit probabilities in the model parameters.", "type": "boolean" }, "temperature": { "type": "number", "format": "float", "description": "Temperature value used for sampling set when the dataset was saved. This value is used to tune the degree of randomness." }, "hasPromptVariable": { "description": "Whether the prompt dataset has prompt variable.", "type": "boolean" }, "promptApiSchema": { "description": "The API schema of the prompt to support both UI and SDK usages.", "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptApiSchema" }, "groundingConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfig", "description": "Grounding checking configuration." }, "gcsUri": { "description": "The Google Cloud Storage URI that stores the prompt data.", "type": "string" }, "text": { "description": "The content of the prompt dataset.", "type": "string" }, "seedEnabled": { "description": "Seeding enables model to return a deterministic response on a best effort basis. Determinism isn't guaranteed. This field determines whether or not seeding is enabled.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTextPromptDatasetMetadata", "description": "The metadata of Datasets that contain Text Prompt data." }, "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfig": { "description": "Traffic distribution configuration.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfig", "properties": { "trafficSplitManual": { "description": "Optional. Manual traffic distribution configuration, where the user specifies the Runtime Revision IDs and the percentage of traffic to send to each.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManual" }, "trafficSplitAlwaysLatest": { "description": "Optional. Traffic distribution configuration, where all traffic is sent to the latest Runtime Revision.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitAlwaysLatest" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1QueryReasoningEngineRequest", "properties": { "input": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. Input content provided by users in JSON object format. Examples include text query, function calling parameters, media bytes, etc." }, "classMethod": { "type": "string", "description": "Optional. Class method to be used for the query. It is optional and defaults to \"query\" if unspecified." } }, "description": "Request message for ReasoningEngineExecutionService.QueryReasoningEngine." }, "GoogleCloudAiplatformV1beta1FeatureGroup": { "description": "Vertex AI Feature Group.", "properties": { "name": { "type": "string", "description": "Identifier. Name of the FeatureGroup. Format: `projects/{project}/locations/{location}/featureGroups/{featureGroup}`" }, "serviceAgentType": { "enum": [ "SERVICE_AGENT_TYPE_UNSPECIFIED", "SERVICE_AGENT_TYPE_PROJECT", "SERVICE_AGENT_TYPE_FEATURE_GROUP" ], "enumDescriptions": [ "By default, the project-level Vertex AI Service Agent is enabled.", "Specifies the project-level Vertex AI Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents).", "Enable a FeatureGroup service account to be created by Vertex AI and output in the field `service_account_email`. This service account will be used to read from the source BigQuery table during jobs under a FeatureGroup." ], "description": "Optional. Service agent type used during jobs under a FeatureGroup. By default, the Vertex AI Service Agent is used. When using an IAM Policy to isolate this FeatureGroup within a project, a separate service account should be provisioned by setting this field to `SERVICE_AGENT_TYPE_FEATURE_GROUP`. This will generate a separate service account to access the BigQuery source table.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The labels with user-defined metadata to organize your FeatureGroup. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one FeatureGroup(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable." }, "description": { "type": "string", "description": "Optional. Description of the FeatureGroup." }, "updateTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this FeatureGroup was last updated.", "type": "string" }, "bigQuery": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroupBigQuery", "description": "Indicates that features for this group come from BigQuery Table/View. By default treats the source as a sparse time series source. The BigQuery source table or view must have at least one entity ID column and a column named `feature_timestamp`." }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "serviceAccountEmail": { "description": "Output only. A Service Account unique to this FeatureGroup. The role bigquery.dataViewer should be granted to this service account to allow Vertex AI Feature Store to access source data while running jobs under this FeatureGroup.", "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. Timestamp when this FeatureGroup was created.", "type": "string", "readOnly": true, "format": "google-datetime" } }, "id": "GoogleCloudAiplatformV1beta1FeatureGroup", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextSentimentInputs": { "properties": { "sentimentMax": { "description": "A sentiment is expressed as an integer ordinal, where higher value means a more positive sentiment. The range of sentiments that will be used is between 0 and sentimentMax (inclusive on both ends), and all the values in the range must be represented in the dataset before a model can be created. Only the Annotations with this sentimentMax will be used for training. sentimentMax value must be between 1 and 10 (inclusive).", "format": "int32", "type": "integer" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextSentimentInputs" }, "GoogleCloudAiplatformV1beta1ListSavedQueriesResponse": { "description": "Response message for DatasetService.ListSavedQueries.", "id": "GoogleCloudAiplatformV1beta1ListSavedQueriesResponse", "properties": { "savedQueries": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SavedQuery" }, "description": "A list of SavedQueries that match the specified filter in the request." }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "type": "object" }, "GenaiVertexV1beta1ImageDelta": { "type": "object", "properties": { "resolution": { "description": "The resolution of the media.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Low resolution.", "Medium resolution.", "High resolution.", "Ultra high resolution." ], "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "ULTRA_HIGH" ] }, "uri": { "type": "string" }, "data": { "format": "byte", "type": "string" }, "mimeType": { "type": "string", "enumDescriptions": [ "", "PNG image format", "JPEG image format", "WebP image format", "HEIC image format", "HEIF image format", "GIF image format", "BMP image format", "TIFF image format" ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_PNG", "TYPE_JPEG", "TYPE_WEBP", "TYPE_HEIC", "TYPE_HEIF", "TYPE_GIF", "TYPE_BMP", "TYPE_TIFF" ] } }, "id": "GenaiVertexV1beta1ImageDelta" }, "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRanking": { "description": "Config for ranking and reranking.", "properties": { "rankService": { "description": "Config for Rank Service.", "$ref": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRankingRankService" } }, "id": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRanking", "type": "object" }, "GoogleCloudAiplatformV1beta1RagContextsContext": { "id": "GoogleCloudAiplatformV1beta1RagContextsContext", "description": "A context of the query.", "type": "object", "properties": { "score": { "type": "number", "description": "According to the underlying Vector DB and the selected metric type, the score can be either the distance or the similarity between the query and the context and its range depends on the metric type. For example, if the metric type is COSINE_DISTANCE, it represents the distance between the query and the context. The larger the distance, the less relevant the context is to the query. The range is [0, 2], while 0 means the most relevant and 2 means the least relevant.", "format": "double" }, "text": { "type": "string", "description": "The text chunk." }, "sourceDisplayName": { "description": "The file display name.", "type": "string" }, "sourceUri": { "description": "If the file is imported from Cloud Storage or Google Drive, source_uri will be original file URI in Cloud Storage or Google Drive; if file is uploaded, source_uri will be file display name.", "type": "string" }, "sparseDistance": { "description": "The distance between the query sparse embedding vector and the context text vector.", "type": "number", "deprecated": true, "format": "double" }, "chunk": { "$ref": "GoogleCloudAiplatformV1beta1RagChunk", "description": "Context of the retrieved chunk." }, "distance": { "type": "number", "description": "The distance between the query dense embedding vector and the context text vector.", "deprecated": true, "format": "double" } } }, "GoogleCloudAiplatformV1beta1ListSchedulesResponse": { "id": "GoogleCloudAiplatformV1beta1ListSchedulesResponse", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListSchedulesRequest.page_token to obtain that page." }, "schedules": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Schedule" }, "description": "List of Schedules in the requested page." } }, "description": "Response message for ScheduleService.ListSchedules" }, "GoogleIamV1SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "type": "object", "properties": { "policy": { "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.", "$ref": "GoogleIamV1Policy" } }, "id": "GoogleIamV1SetIamPolicyRequest" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateResourceRequirements": { "type": "object", "properties": { "requests": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. The requested amounts of compute resources. Keys are resource names (e.g., \"cpu\", \"memory\"). Values are quantities (e.g., \"250m\", \"512Mi\")." }, "limits": { "description": "Optional. The maximum amounts of compute resources allowed. Keys are resource names (e.g., \"cpu\", \"memory\"). Values are quantities (e.g., \"500m\", \"1Gi\").", "additionalProperties": { "type": "string" }, "type": "object" } }, "description": "Message to define resource requests and limits (mirroring Kubernetes) for each sandbox instance created from this template.", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateResourceRequirements" }, "GenaiVertexV1beta1CodeExecutionCallStepCodeExecutionCallStepArguments": { "id": "GenaiVertexV1beta1CodeExecutionCallStepCodeExecutionCallStepArguments", "description": "The arguments to pass to the code execution.", "type": "object", "properties": { "language": { "type": "string", "description": "Programming language of the `code`.", "enum": [ "LANGUAGE_UNSPECIFIED", "PYTHON" ], "enumDescriptions": [ "Unspecified language. This value should not be used.", "Python \u003e= 3.10, with numpy and simpy available." ] }, "code": { "type": "string", "description": "The code to be executed." } } }, "GoogleCloudAiplatformV1beta1ReservationAffinity": { "description": "A ReservationAffinity can be used to configure a Vertex AI resource (e.g., a DeployedModel) to draw its Compute Engine resources from a Shared Reservation, or exclusively from on-demand capacity.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReservationAffinity", "properties": { "key": { "description": "Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use `compute.googleapis.com/reservation-name` as the key and specify the name of your reservation as its value.", "type": "string" }, "values": { "items": { "type": "string" }, "type": "array", "description": "Optional. Corresponds to the label values of a reservation resource. This must be the resource name of the reservation, reservation block, or reservation sub- block." }, "reservationAffinityType": { "description": "Required. Specifies the reservation affinity type.", "enum": [ "TYPE_UNSPECIFIED", "NO_RESERVATION", "ANY_RESERVATION", "SPECIFIC_RESERVATION" ], "type": "string", "enumDescriptions": [ "Default value. This should not be used.", "Do not consume from any reserved capacity, only use on-demand.", "Consume any reservation available, falling back to on-demand.", "Consume from a specific reservation. When chosen, the reservation must be identified via the `key` and `values` fields." ] } } }, "GoogleCloudAiplatformV1beta1GenerateLossClustersRequestEvaluationResultList": { "properties": { "evaluationResults": { "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationResult" }, "type": "array", "description": "Required. The list of evaluation results to analyze." } }, "type": "object", "description": "A wrapper to allow providing a list of items inline.", "id": "GoogleCloudAiplatformV1beta1GenerateLossClustersRequestEvaluationResultList" }, "GoogleCloudAiplatformV1beta1CancelEvaluationRunRequest": { "description": "Request message for EvaluationManagementService.CancelEvaluationRun.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1CancelEvaluationRunRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryExactMatchMetricValue": { "type": "object", "description": "TrajectoryExactMatch metric value for an instance.", "properties": { "score": { "readOnly": true, "format": "float", "type": "number", "description": "Output only. TrajectoryExactMatch score." } }, "id": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchMetricValue" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextExtractionEvaluationMetricsConfidenceMetrics": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTextExtractionEvaluationMetricsConfidenceMetrics", "properties": { "confidenceThreshold": { "type": "number", "description": "Metrics are computed with an assumption that the Model never returns predictions with score lower than this value.", "format": "float" }, "recall": { "type": "number", "format": "float", "description": "Recall (True Positive Rate) for the given confidence threshold." }, "precision": { "type": "number", "description": "Precision for the given confidence threshold.", "format": "float" }, "f1Score": { "format": "float", "description": "The harmonic mean of recall and precision.", "type": "number" } } }, "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates": { "id": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates", "type": "object", "properties": { "candidates": { "description": "The list of candidate tokens, sorted by log probability in descending order.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate" }, "type": "array" } }, "description": "A list of the top candidate tokens and their log probabilities at each decoding step. This can be used to see what other tokens the model considered." }, "GoogleCloudAiplatformV1beta1RestoreDatasetVersionOperationMetadata": { "description": "Runtime operation information for DatasetService.RestoreDatasetVersion.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RestoreDatasetVersionOperationMetadata", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1MetricMetadata": { "id": "GoogleCloudAiplatformV1beta1MetricMetadata", "properties": { "scoreRange": { "$ref": "GoogleCloudAiplatformV1beta1MetricMetadataScoreRange", "description": "Optional. The range of possible scores for this metric, used for plotting." }, "otherMetadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. Flexible metadata for user-defined attributes." }, "title": { "description": "Optional. The user-friendly name for the metric. If not set for a registered metric, it will default to the metric's display name.", "type": "string" } }, "description": "Metadata about the metric, used for visualization and organization.", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesResponse": { "properties": {}, "id": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesResponse", "type": "object", "description": "Response message for FeaturestoreService.BatchReadFeatureValues." }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate": { "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Defines a predicate for filtering based on a numeric value.", "properties": { "comparisonOperator": { "enum": [ "COMPARISON_OPERATOR_UNSPECIFIED", "LESS", "LESS_OR_EQUAL", "EQUAL", "NOT_EQUAL", "GREATER_OR_EQUAL", "GREATER" ], "type": "string", "enumDescriptions": [ "Unspecified comparison operator. This value should not be used.", "Less than.", "Less than or equal to.", "Equal to.", "Not equal to.", "Greater than or equal to.", "Greater than." ], "description": "Required. The comparison operator to apply." }, "value": { "format": "float", "description": "Required. The value to compare against.", "type": "number" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationPrompt": { "id": "GoogleCloudAiplatformV1beta1EvaluationPrompt", "description": "Prompt to be evaluated. This can represent a single-turn prompt or a multi-turn conversation for agent evaluations.", "properties": { "agentData": { "description": "Optional. Represents the complete execution trace of a multi-turn conversation, which can involve single or multiple agents. This serves as the input context for agent scraping.", "$ref": "GoogleCloudAiplatformV1beta1AgentData" }, "promptTemplateData": { "description": "Prompt template data.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationPromptPromptTemplateData" }, "value": { "description": "Fields and values that can be used to populate the prompt template.", "type": "any" }, "userScenario": { "description": "Optional. The generated user scenario used to drive multi-turn agent running results.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationPromptUserScenario" }, "text": { "description": "Text prompt.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponseAgentAggregate": { "properties": { "agentType": { "description": "Output only. The runtime the agent is hosted on (for example, `CLOUD_RUN_SERVICE`). `AGENT_TYPE_UNSPECIFIED` means the runtime is unknown to this service, which is distinct from `AGENT_TYPE_OTHER` (known, and not one of the enumerated Google Cloud runtimes).", "enumDescriptions": [ "The default value, used when the runtime type is unspecified.", "The agent runs on the Gemini Enterprise Agent Platform Agent Runtime (Reasoning Engine).", "The agent runs as a Google Cloud Run service.", "The agent runs as a workload on Google Kubernetes Engine.", "The agent runs on a Compute Engine instance.", "The agent runs on another runtime, such as a self-hosted, on-premises, or non-Google Cloud environment, or any runtime not represented by the values above." ], "enum": [ "AGENT_TYPE_UNSPECIFIED", "REASONING_ENGINE", "CLOUD_RUN_SERVICE", "GKE_WORKLOAD", "GCE_INSTANCE", "AGENT_TYPE_OTHER" ], "type": "string", "readOnly": true }, "agentStatus": { "enum": [ "ENABLEMENT_STATE_UNSPECIFIED", "ACTIVE", "ENABLING", "DISABLED" ], "description": "Output only. The enablement state of the MonitoredAgent (for example, ACTIVE, DISABLED, or ENABLING).", "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The agent is successfully enabled and active.", "The agent is in the process of being enabled.", "The agent is disabled." ], "type": "string", "readOnly": true }, "totalSessionsCount": { "type": "integer", "format": "int32", "description": "The number of analyzed sessions for this agent matched by the request." }, "anomalousSessionsCount": { "type": "integer", "format": "int32", "description": "The number of anomalous (SESSION_STATE_FLAGGED) sessions for this agent." }, "location": { "description": "Output only. The Google Cloud location (region) of the agent (for example, `us-central1`). Empty when the agent is not enrolled or its location is unknown.", "readOnly": true, "type": "string" }, "latestSessionTime": { "format": "google-datetime", "type": "string", "description": "The latest session update_time observed for this agent." }, "severities": { "type": "object", "description": "Map of severity level (string representation of Severity) to detector summaries aggregated across all sessions for this agent. The key is the string representation of Severity enum: \"SEVERITY_UNSPECIFIED\", \"SEVERITY_CRITICAL\", \"SEVERITY_HIGH\", \"SEVERITY_MEDIUM\", \"SEVERITY_LOW\".", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedSessionSeveritySummary" } }, "agentResourceName": { "type": "string", "description": "The resource name or identifier of the agent. Matches `AgentResource.agent` on the corresponding `MonitoredAgent`, so the format depends on that agent's `AgentResource.agent_type`: * `REASONING_ENGINE`: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}` * `CLOUD_RUN_SERVICE`, `GKE_WORKLOAD`, `GCE_INSTANCE`: the resource name of the agent's runtime. * `AGENT_TYPE_OTHER`: a stable identifier for the agent." }, "agentDisplayName": { "description": "Output only. The human-readable display name of the MonitoredAgent.", "readOnly": true, "type": "string" }, "monitoredAgent": { "type": "string", "description": "The MonitoredAgent resource name. Format: `projects/{project}/locations/{location}/monitoredAgents/{monitored_agent}`" } }, "description": "Contains aggregated statistics for one MonitoredAgent.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponseAgentAggregate" }, "GoogleCloudAiplatformV1beta1CoherenceSpec": { "properties": { "version": { "format": "int32", "description": "Optional. Which version to use for evaluation.", "type": "integer" } }, "id": "GoogleCloudAiplatformV1beta1CoherenceSpec", "description": "Spec for coherence score metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelVersionCheckpoint": { "type": "object", "properties": { "step": { "format": "int64", "type": "string", "description": "The step of the checkpoint." }, "checkpointId": { "description": "The ID of the checkpoint.", "type": "string" }, "epoch": { "type": "string", "description": "The epoch of the checkpoint.", "format": "int64" } }, "deprecated": true, "id": "GoogleCloudAiplatformV1beta1ModelVersionCheckpoint", "description": "Describes the machine learning model version checkpoint." }, "GoogleCloudAiplatformV1beta1EvaluationInstanceInteractionsDataSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceInteractionsDataSource", "properties": { "interaction": { "description": "Required. The interaction to evaluate. Format: `projects/{project}/locations/{location}/interactions/{interaction}`.", "type": "string" }, "geminiAgentConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiAgentConfig", "description": "Optional. Gemini Agent (Vertex AI Agent resource)." } }, "description": "Source for populating `AgentData` from an Interactions API interaction." }, "GoogleCloudAiplatformV1beta1CreatePersistentResourceOperationMetadata": { "type": "object", "description": "Details of operations that perform create PersistentResource.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for PersistentResource." }, "progressMessage": { "description": "Progress Message for Create LRO", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1CreatePersistentResourceOperationMetadata" }, "GoogleCloudAiplatformV1beta1PipelineTemplateMetadata": { "properties": { "version": { "type": "string", "description": "The version_name in artifact registry. Will always be presented in output if the PipelineJob.template_uri is from supported template registry. Format is \"sha256:abcdef123456...\"." } }, "description": "Pipeline template metadata if PipelineJob.template_uri is from supported template registry. Currently, the only supported registry is Artifact Registry.", "id": "GoogleCloudAiplatformV1beta1PipelineTemplateMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingMetadata": { "description": "Model metadata specific to TFT Forecasting.", "properties": { "trainCostMilliNodeHours": { "type": "string", "description": "Output only. The actual training cost of the model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed the train budget.", "format": "int64" }, "evaluatedDataItemsBigqueryUri": { "description": "BigQuery destination uri for exported evaluated examples.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingMetadata" }, "GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata": { "id": "GoogleCloudAiplatformV1beta1GenerateContentResponseUsageMetadata", "description": "Usage metadata about the content generation request and response. This message provides a detailed breakdown of token usage and other relevant metrics.", "type": "object", "properties": { "toolUsePromptTokenCount": { "type": "integer", "readOnly": true, "description": "Output only. The number of tokens in the results from tool executions, which are provided back to the model as input, if applicable.", "format": "int32" }, "cachedContentTokenCount": { "format": "int32", "description": "Output only. The number of tokens in the cached content that was used for this request.", "readOnly": true, "type": "integer" }, "cacheTokensDetails": { "description": "Output only. A detailed breakdown of the token count for each modality in the cached content.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "type": "array", "readOnly": true }, "totalTokenCount": { "description": "The total number of tokens for the entire request. This is the sum of `prompt_token_count`, `candidates_token_count`, `tool_use_prompt_token_count`, and `thoughts_token_count`.", "type": "integer", "format": "int32" }, "promptTokensDetails": { "description": "Output only. A detailed breakdown of the token count for each modality in the prompt.", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" } }, "trafficType": { "description": "Output only. The traffic type for this request.", "enumDescriptions": [ "Unspecified request traffic type.", "The request was processed using Pay-As-You-Go quota.", "Type for Priority Pay-As-You-Go traffic.", "Type for Flex traffic.", "Type for Off-Peak Pay-As-You-Go traffic.", "Type for Provisioned Throughput traffic." ], "type": "string", "readOnly": true, "enum": [ "TRAFFIC_TYPE_UNSPECIFIED", "ON_DEMAND", "ON_DEMAND_PRIORITY", "ON_DEMAND_FLEX", "ON_DEMAND_OFFPEAK", "PROVISIONED_THROUGHPUT" ] }, "candidatesTokenCount": { "type": "integer", "description": "The total number of tokens in the generated candidates.", "format": "int32" }, "candidatesTokensDetails": { "description": "Output only. A detailed breakdown of the token count for each modality in the generated candidates.", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "type": "array" }, "thoughtsTokenCount": { "type": "integer", "description": "Output only. The number of tokens that were part of the model's generated \"thoughts\" output, if applicable.", "readOnly": true, "format": "int32" }, "toolUsePromptTokensDetails": { "readOnly": true, "type": "array", "description": "Output only. A detailed breakdown by modality of the token counts from the results of tool executions, which are provided back to the model as input.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" } }, "promptTokenCount": { "format": "int32", "type": "integer", "description": "The total number of tokens in the prompt. This includes any text, images, or other media provided in the request. When `cached_content` is set, this also includes the number of tokens in the cached content." } } }, "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItem": { "properties": { "places": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces" } }, "widgetContextToken": { "type": "string" } }, "description": "The result of the Google Maps.", "type": "object", "id": "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItem" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployDeployMetadata": { "properties": { "sampleRequest": { "description": "Optional. Sample request for deployed endpoint.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Labels for the deployment config. For managing deployment config like verifying, source of deployment config, etc." } }, "description": "Metadata information about the deployment for managing deployment config.", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployDeployMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1ExplainResponse": { "properties": { "deployedModelId": { "type": "string", "description": "ID of the Endpoint's DeployedModel that served this explanation." }, "explanations": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Explanation" }, "description": "The explanations of the Model's PredictResponse.predictions. It has the same number of elements as instances to be explained.", "type": "array" }, "predictions": { "type": "array", "description": "The predictions that are the output of the predictions call. Same as PredictResponse.predictions.", "items": { "type": "any" } }, "concurrentExplanations": { "description": "This field stores the results of the explanations run in parallel with The default explanation strategy/method.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ExplainResponseConcurrentExplanation" }, "type": "object" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ExplainResponse", "description": "Response message for PredictionService.Explain." }, "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySource": { "description": "A Feature Registry source for features that need to be synced to Online Store.", "id": "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySource", "type": "object", "properties": { "featureGroups": { "description": "Required. List of features that need to be synced to Online Store.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySourceFeatureGroup" } }, "projectNumber": { "type": "string", "description": "Optional. The project number of the parent project of the Feature Groups.", "format": "int64" } } }, "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorer": { "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorer", "properties": { "stringMatchExpression": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerStringMatchExpression", "description": "Uses string match expression to evaluate parsed response." }, "wrongAnswerReward": { "format": "float", "type": "number", "description": "Wrong answer reward is returned if the parsed response is evaluated as `false`. All wrong answers get the same reward." }, "jsonMatchExpression": { "description": "Uses json match expression to evaluate parsed response.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerJsonMatchExpression" }, "correctAnswerReward": { "description": "Correct answer rewawrd is returned if the parsed response is evaluated as `true`. All correct answers get the same reward.", "type": "number", "format": "float" } }, "type": "object", "description": "ReinforcementTuningStringMatchRewardScorer is used to score parsed responses for string matching use cases. For example, for math problems, users can use string match scorer to check if the correct exact answer is generated. Note: Reward returned by the string match reward function is clipped to be within `[-1, 1]` if wrongAnswerReward or correctAnswerReward are beyond the range, i.e., `reward = max(min(reward, 1.0), -1.0)`." }, "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchResults": { "properties": { "toolParameterKeyMatchMetricValues": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchMetricValue" }, "description": "Output only. Tool parameter key match metric values.", "readOnly": true, "type": "array" } }, "description": "Results for tool parameter key match metric.", "id": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchResults", "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences": { "properties": { "supportsWorkbench": { "type": "boolean", "description": "Optional. For notebook resource, whether the notebook supports Workbench." }, "colabNotebookDisabled": { "description": "Optional. For notebook resource. When set to true, the Colab Enterprise link will be disabled in the \"open notebook\" dialog in UI.", "type": "boolean" }, "resourceDescription": { "type": "string", "description": "Optional. Description of the resource." }, "resourceUseCase": { "type": "string", "description": "Optional. Use case (CUJ) of the resource." }, "references": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelResourceReference" }, "description": "Required.", "type": "object" }, "resourceTitle": { "description": "Optional. Title of the resource.", "type": "string" }, "title": { "type": "string", "description": "Required. " } }, "description": "The regional resource name or the URI. Key is region, e.g., us-central1, europe-west2, global, etc..", "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "GoogleCloudAiplatformV1beta1ListOptimalTrialsRequest": { "type": "object", "description": "Request message for VizierService.ListOptimalTrials.", "id": "GoogleCloudAiplatformV1beta1ListOptimalTrialsRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigEnterprise": { "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigEnterprise", "deprecated": true, "type": "object", "properties": {}, "description": "Enterprise tier offers production grade performance along with autoscaling functionality. It is suitable for customers with large amounts of data or performance sensitive workloads." }, "GoogleCloudAiplatformV1beta1UploadModelOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UploadModelOperationMetadata", "description": "Details of ModelService.UploadModel operation.", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1StudySpecConvexAutomatedStoppingSpec": { "id": "GoogleCloudAiplatformV1beta1StudySpecConvexAutomatedStoppingSpec", "properties": { "minStepCount": { "description": "Minimum number of steps for a trial to complete. Trials which do not have a measurement with step_count \u003e min_step_count won't be considered for early stopping. It's ok to set it to 0, and a trial can be early stopped at any stage. By default, min_step_count is set to be one-tenth of the max_step_count. When use_elapsed_duration is true, this field is set to the minimum elapsed seconds.", "type": "string", "format": "int64" }, "updateAllStoppedTrials": { "description": "ConvexAutomatedStoppingSpec by default only updates the trials that needs to be early stopped using a newly trained auto-regressive model. When this flag is set to True, all stopped trials from the beginning are potentially updated in terms of their `final_measurement`. Also, note that the training logic of autoregressive models is different in this case. Enabling this option has shown better results and this may be the default option in the future.", "type": "boolean" }, "minMeasurementCount": { "type": "string", "description": "The minimal number of measurements in a Trial. Early-stopping checks will not trigger if less than min_measurement_count+1 completed trials or pending trials with less than min_measurement_count measurements. If not defined, the default value is 5.", "format": "int64" }, "learningRateParameterName": { "type": "string", "description": "The hyper-parameter name used in the tuning job that stands for learning rate. Leave it blank if learning rate is not in a parameter in tuning. The learning_rate is used to estimate the objective value of the ongoing trial." }, "maxStepCount": { "format": "int64", "description": "Steps used in predicting the final objective for early stopped trials. In general, it's set to be the same as the defined steps in training / tuning. If not defined, it will learn it from the completed trials. When use_steps is false, this field is set to the maximum elapsed seconds.", "type": "string" }, "useElapsedDuration": { "type": "boolean", "description": "This bool determines whether or not the rule is applied based on elapsed_secs or steps. If use_elapsed_duration==false, the early stopping decision is made according to the predicted objective values according to the target steps. If use_elapsed_duration==true, elapsed_secs is used instead of steps. Also, in this case, the parameters max_num_steps and min_num_steps are overloaded to contain max_elapsed_seconds and min_elapsed_seconds." } }, "type": "object", "description": "Configuration for ConvexAutomatedStoppingSpec. When there are enough completed trials (configured by min_measurement_count), for pending trials with enough measurements and steps, the policy first computes an overestimate of the objective value at max_num_steps according to the slope of the incomplete objective value curve. No prediction can be made if the curve is completely flat. If the overestimation is worse than the best objective value of the completed trials, this pending trial will be early-stopped, but a last measurement will be added to the pending trial with max_num_steps and predicted objective value from the autoregression model." }, "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfig": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfig", "type": "object", "description": "Configuration of how features in Featurestore are monitored.", "properties": { "numericalThresholdConfig": { "description": "Threshold for numerical features of anomaly detection. This is shared by all objectives of Featurestore Monitoring for numerical features (i.e. Features with type (Feature.ValueType) DOUBLE or INT64).", "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigThresholdConfig" }, "snapshotAnalysis": { "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigSnapshotAnalysis", "description": "The config for Snapshot Analysis Based Feature Monitoring." }, "importFeaturesAnalysis": { "description": "The config for ImportFeatures Analysis Based Feature Monitoring.", "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigImportFeaturesAnalysis" }, "categoricalThresholdConfig": { "description": "Threshold for categorical features of anomaly detection. This is shared by all types of Featurestore Monitoring for categorical features (i.e. Features with type (Feature.ValueType) BOOL or STRING).", "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigThresholdConfig" } } }, "GoogleCloudAiplatformV1beta1StoredContentsExample": { "id": "GoogleCloudAiplatformV1beta1StoredContentsExample", "properties": { "searchKey": { "description": "Optional. (Optional) the search key used for retrieval. If not provided at upload-time, the search key will be generated from `contents_example.contents` using the method provided by `search_key_generation_method`. The generated search key will be included in retrieved examples.", "type": "string" }, "contentsExample": { "description": "Required. The example to be used with GenerateContent.", "$ref": "GoogleCloudAiplatformV1beta1ContentsExample" }, "searchKeyGenerationMethod": { "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethod", "description": "Optional. The method used to generate the search key from `contents_example.contents`. This is ignored when uploading an example if `search_key` is provided." } }, "description": "A ContentsExample to be used with GenerateContent alongside information required for storage and retrieval with Example Store.", "type": "object" }, "GoogleCloudAiplatformV1beta1JiraSourceJiraQueries": { "description": "JiraQueries contains the Jira queries and corresponding authentication.", "properties": { "apiKeyConfig": { "description": "Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key. See [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).", "$ref": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig" }, "customQueries": { "items": { "type": "string" }, "description": "A list of custom Jira queries to import. For information about JQL (Jira Query Language), see https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/", "type": "array" }, "email": { "type": "string", "description": "Required. The Jira email address." }, "serverUri": { "type": "string", "description": "Required. The Jira server URI." }, "projects": { "type": "array", "description": "A list of Jira projects to import in their entirety.", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1JiraSourceJiraQueries", "type": "object" }, "GoogleCloudAiplatformV1beta1RagFileMetadataConfig": { "description": "Metadata config for RagFile.", "properties": { "inlineMetadataSchemaSource": { "description": "Inline metadata schema source. Must be a JSON string.", "type": "string" }, "googleDriveMetadataSource": { "description": "Google Drive location. Supports importing individual files as well as Google Drive folders. If the user provides a directory, the metadata will be read from the files that ends with \"metadata.json\" in the directory.", "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSource" }, "gcsMetadataSchemaSource": { "description": "Google Cloud Storage location. Supports importing individual files as well as entire Google Cloud Storage directories. Sample formats: - `gs://bucket_name/my_directory/object_name/metadata_schema.json` - `gs://bucket_name/my_directory` If the user provides a directory, the metadata schema will be read from the files that ends with \"metadata_schema.json\" in the directory.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "googleDriveMetadataSchemaSource": { "description": "Google Drive location. Supports importing individual files as well as Google Drive folders. If the user provides a folder, the metadata schema will be read from the files that ends with \"metadata_schema.json\" in the directory.", "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSource" }, "gcsMetadataSource": { "description": "Google Cloud Storage location. Supports importing individual files as well as entire Google Cloud Storage directories. Sample formats: - `gs://bucket_name/my_directory/object_name/metadata.json` - `gs://bucket_name/my_directory` If the user provides a directory, the metadata will be read from the files that ends with \"metadata.json\" in the directory.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "inlineMetadataSource": { "type": "string", "description": "Inline metadata source. Must be a JSON string." } }, "id": "GoogleCloudAiplatformV1beta1RagFileMetadataConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSourceAdkConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSourceAdkConfig", "properties": { "jsonConfig": { "type": "object", "description": "Required. The value of the ADK config in JSON format.", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "description": "Configuration for the Agent Development Kit (ADK)." }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfigExplanationBaseline": { "type": "object", "properties": { "bigquery": { "description": "BigQuery location for BatchExplain output.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination" }, "gcs": { "description": "Cloud Storage location for BatchExplain output.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "predictionFormat": { "enum": [ "PREDICTION_FORMAT_UNSPECIFIED", "JSONL", "BIGQUERY" ], "description": "The storage format of the predictions generated BatchPrediction job.", "enumDescriptions": [ "Should not be set.", "Predictions are in JSONL files.", "Predictions are in BigQuery." ], "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigExplanationConfigExplanationBaseline", "description": "Output from BatchPredictionJob for Model Monitoring baseline dataset, which can be used to generate baseline attribution scores." }, "GoogleCloudAiplatformV1beta1BigQueryRequestSetSamplingConfig": { "id": "GoogleCloudAiplatformV1beta1BigQueryRequestSetSamplingConfig", "description": "The sampling config.", "properties": { "samplingCount": { "format": "int32", "type": "integer", "description": "Optional. The total number of logged data to import. If available data is less than the sampling count, all data will be imported. Default is 100." }, "samplingDuration": { "type": "string", "format": "google-duration", "description": "Optional. How long to wait before sampling data from the BigQuery table. If not specified, defaults to 0." }, "samplingMethod": { "enumDescriptions": [ "Unspecified sampling method.", "Random sampling." ], "type": "string", "enum": [ "SAMPLING_METHOD_UNSPECIFIED", "RANDOM" ], "description": "Optional. The sampling method to use." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInput": { "type": "object", "description": "Input for question answering quality metric.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInput", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualitySpec", "description": "Required. Spec for question answering quality score metric." }, "instance": { "description": "Required. Question answering quality instance.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInstance" } } }, "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest": { "description": "Request message for MemoryBankService.PurgeMemories.", "properties": { "filter": { "description": "Required. The standard list filter to determine which memories to purge. More detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "filterGroups": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryConjunctionFilter" }, "type": "array", "description": "Optional. Metadata filters that will be applied to the memories to be purged. Filters are defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: [{key: \"author\", value: {string_value: \"agent 123\"}, op: EQUAL}]}, {filters: [{key: \"label\", value: {string_value: \"travel\"}, op: EQUAL}, {key: \"author\", value: {string_value: \"agent 321\"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = \"agent 123\" OR (metadata.label = \"travel\" AND metadata.author = \"agent 321\"))`." }, "force": { "description": "Optional. If true, the memories will actually be purged. If false, the purge request will be validated but not executed.", "type": "boolean" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PurgeMemoriesRequest" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecComputerUseEnvironment": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecComputerUseEnvironment", "type": "object", "description": "The computer use environment with customized settings.", "properties": {} }, "GoogleCloudAiplatformV1beta1BleuInstance": { "properties": { "reference": { "description": "Required. Ground truth used to compare against the prediction.", "type": "string" }, "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1BleuInstance", "description": "Spec for bleu instance.", "type": "object" }, "GenaiVertexV1beta1AudioDelta": { "type": "object", "properties": { "channels": { "description": "The number of audio channels.", "type": "integer", "format": "int32" }, "data": { "type": "string", "format": "byte" }, "rate": { "deprecated": true, "format": "int32", "type": "integer", "description": "Deprecated. Use sample_rate instead. The value is ignored." }, "mimeType": { "enumDescriptions": [ "", "WAV audio format", "MP3 audio format", "AIFF audio format", "AAC audio format", "OGG audio format", "FLAC audio format", "MPEG audio format", "M4A audio format", "L16 audio format", "OPUS audio format", "ALAW audio format", "MULAW audio format", "WEBM audio format" ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "TYPE_WAV", "TYPE_MP3", "TYPE_AIFF", "TYPE_AAC", "TYPE_OGG", "TYPE_FLAC", "TYPE_MPEG", "TYPE_M4A", "TYPE_L16", "TYPE_OPUS", "TYPE_ALAW", "TYPE_MULAW", "TYPE_WEBM" ] }, "sampleRate": { "type": "integer", "description": "The sample rate of the audio.", "format": "int32" }, "uri": { "type": "string" } }, "id": "GenaiVertexV1beta1AudioDelta" }, "GoogleCloudAiplatformV1beta1A2aTaskArtifactChange": { "type": "object", "description": "An event payload describing a change to one of the task's artifacts.", "properties": { "lastChunk": { "description": "Optional. Whether this is the last chunk of a streamed artifact.", "type": "boolean" }, "append": { "description": "Optional. Whether the artifact parts should be appended to an existing artifact rather than replacing it.", "type": "boolean" }, "artifact": { "description": "Required. The artifact that was added or updated.", "$ref": "GoogleCloudAiplatformV1beta1A2aTaskArtifact" } }, "id": "GoogleCloudAiplatformV1beta1A2aTaskArtifactChange" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInstance": { "description": "Spec for question answering helpfulness instance.", "properties": { "context": { "description": "Optional. Text provided as context to answer the question.", "type": "string" }, "instruction": { "description": "Required. The question asked and other instruction in the inference prompt.", "type": "string" }, "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" }, "reference": { "type": "string", "description": "Optional. Ground truth used to compare against the prediction." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInstance" }, "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfig": { "properties": { "weightedRewardConfigs": { "description": "List of reward function configurations with weights.", "items": { "$ref": "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfigWeightedRewardConfig" }, "type": "array" } }, "description": "Composite reward function configuration for reinforcement tuning.", "id": "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateNetworkPort": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateNetworkPort", "type": "object", "properties": { "port": { "type": "integer", "format": "int32", "description": "Optional. Port number to expose. This must be a valid port number, between 1 and 65535." }, "protocol": { "type": "string", "enumDescriptions": [ "Unspecified protocol. Defaults to TCP.", "TCP protocol.", "UDP protocol." ], "description": "Optional. Protocol for port. Defaults to TCP if not specified.", "enum": [ "PROTOCOL_UNSPECIFIED", "TCP", "UDP" ] } }, "description": "Represents a network port in a container." }, "GenaiVertexV1beta1UrlCitation": { "id": "GenaiVertexV1beta1UrlCitation", "type": "object", "properties": { "title": { "type": "string", "description": "The title of the URL." }, "url": { "description": "The URL.", "type": "string" } }, "description": "A URL citation annotation." }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequest", "description": "Request message for FeaturestoreService.DeleteFeatureValues.", "properties": { "selectEntity": { "$ref": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectEntity", "description": "Select feature values to be deleted by specifying entities." }, "selectTimeRangeAndFeature": { "$ref": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesRequestSelectTimeRangeAndFeature", "description": "Select feature values to be deleted by specifying time range and features." } } }, "GenaiVertexV1beta1InteractionStreamingEvent": { "id": "GenaiVertexV1beta1InteractionStreamingEvent", "type": "object", "properties": { "interactionCreatedEvent": { "$ref": "GenaiVertexV1beta1InteractionCreatedSseEvent", "description": "The interaction data, used for interaction.created events. Used when steps are enabled." }, "interactionStatusUpdate": { "description": "The interaction status data, used for interaction.status_update events.", "$ref": "GenaiVertexV1beta1InteractionStatusUpdate" }, "eventId": { "type": "string", "description": "The event_id token to be used to resume the interaction stream, from this event." }, "stepStop": { "$ref": "GenaiVertexV1beta1StepStop", "description": "The step stop data, used for step.stop events. Step-based streaming event, used when steps are enabled." }, "errorEvent": { "$ref": "GenaiVertexV1beta1ErrorEvent", "description": "The error event data, used for error events." }, "interactionCompletedEvent": { "description": "The interaction data, used for interaction.completed events. Used when steps are enabled.", "$ref": "GenaiVertexV1beta1InteractionCompletedSseEvent" }, "stepStart": { "$ref": "GenaiVertexV1beta1StepStart", "description": "The step start data, used for step.start events. Step-based streaming event, used when steps are enabled." }, "stepDelta": { "description": "The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled.", "$ref": "GenaiVertexV1beta1StepDelta" } } }, "GoogleCloudAiplatformV1beta1DataLabelingJob": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DataLabelingJob", "properties": { "updateTime": { "description": "Output only. Timestamp when this DataLabelingJob was updated most recently.", "format": "google-datetime", "readOnly": true, "type": "string" }, "specialistPools": { "description": "The SpecialistPools' resource names associated with this job.", "items": { "type": "string" }, "type": "array" }, "instructionUri": { "description": "Required. The Google Cloud Storage location of the instruction pdf. This pdf is shared with labelers, and provides detailed description on how to label DataItems in Datasets.", "type": "string" }, "inputs": { "description": "Required. Input config parameters for the DataLabelingJob.", "type": "any" }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a DataLabelingJob. If set, this DataLabelingJob will be secured by this key. Note: Annotations created in the DataLabelingJob are associated with the EncryptionSpec of the Dataset they are exported to.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "currentSpend": { "description": "Output only. Estimated cost(in US dollars) that the DataLabelingJob has incurred to date.", "$ref": "GoogleTypeMoney", "readOnly": true }, "annotationLabels": { "type": "object", "description": "Labels to assign to annotations generated by this DataLabelingJob. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "additionalProperties": { "type": "string" } }, "labelerCount": { "type": "integer", "format": "int32", "description": "Required. Number of labelers to work on each DataItem." }, "name": { "readOnly": true, "description": "Output only. Resource name of the DataLabelingJob.", "type": "string" }, "labelingProgress": { "readOnly": true, "description": "Output only. Current labeling job progress percentage scaled in interval [0, 100], indicating the percentage of DataItems that has been finished.", "format": "int32", "type": "integer" }, "error": { "description": "Output only. DataLabelingJob errors. It is only populated when job's state is `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "readOnly": true, "$ref": "GoogleRpcStatus" }, "labels": { "description": "The labels with user-defined metadata to organize your DataLabelingJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable. Following system labels exist for each DataLabelingJob: * \"aiplatform.googleapis.com/schema\": output only, its value is the inputs_schema's title.", "additionalProperties": { "type": "string" }, "type": "object" }, "activeLearningConfig": { "$ref": "GoogleCloudAiplatformV1beta1ActiveLearningConfig", "description": "Parameters that configure the active learning pipeline. Active learning will label the data incrementally via several iterations. For every iteration, it will select a batch of data based on the sampling strategy." }, "displayName": { "description": "Required. The user-defined name of the DataLabelingJob. The name can be up to 128 characters long and can consist of any UTF-8 characters. Display name of a DataLabelingJob.", "type": "string" }, "inputsSchemaUri": { "type": "string", "description": "Required. Points to a YAML file stored on Google Cloud Storage describing the config for a specific type of DataLabelingJob. The schema files that can be used here are found in the https://storage.googleapis.com/google-cloud-aiplatform bucket in the /schema/datalabelingjob/inputs/ folder." }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this DataLabelingJob was created.", "type": "string" }, "state": { "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "description": "Output only. The detailed state of the job.", "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "type": "string", "readOnly": true }, "datasets": { "items": { "type": "string" }, "description": "Required. Dataset resource names. Right now we only support labeling from a single Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "type": "array" } }, "description": "DataLabelingJob is used to trigger a human labeling job on unlabeled data from the following Dataset:" }, "GoogleCloudAiplatformV1beta1UpdateFeaturestoreOperationMetadata": { "properties": { "genericMetadata": { "description": "Operation metadata for Featurestore.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Details of operations that perform update Featurestore.", "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateFeaturestoreOperationMetadata" }, "GoogleCloudAiplatformV1beta1BatchImportModelEvaluationSlicesRequest": { "id": "GoogleCloudAiplatformV1beta1BatchImportModelEvaluationSlicesRequest", "properties": { "modelEvaluationSlices": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSlice" }, "type": "array", "description": "Required. Model evaluation slice resource to be imported." } }, "description": "Request message for ModelService.BatchImportModelEvaluationSlices", "type": "object" }, "GoogleCloudAiplatformV1beta1DeleteReasoningEngineRuntimeRevisionOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1DeleteReasoningEngineRuntimeRevisionOperationMetadata", "description": "Metadata associated with DeleteReasoningEngineRuntimeRevision operation.", "type": "object", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The common part of the operation metadata." } } }, "GoogleCloudAiplatformV1beta1MetricxInstance": { "description": "Spec for MetricX instance - The fields used for evaluation are dependent on the MetricX version.", "properties": { "source": { "description": "Optional. Source text in original language.", "type": "string" }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" }, "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MetricxInstance" }, "GoogleCloudAiplatformV1beta1MigratableResourceAutomlDataset": { "description": "Represents one Dataset in automl.googleapis.com.", "id": "GoogleCloudAiplatformV1beta1MigratableResourceAutomlDataset", "properties": { "datasetDisplayName": { "type": "string", "description": "The Dataset's display name in automl.googleapis.com." }, "dataset": { "description": "Full resource name of automl Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1Examples": { "type": "object", "description": "Example-based explainability that returns the nearest neighbors from the provided dataset.", "id": "GoogleCloudAiplatformV1beta1Examples", "properties": { "nearestNeighborSearchConfig": { "description": "The full configuration for the generated index, the semantics are the same as metadata and should match [NearestNeighborSearchConfig](https://cloud.google.com/vertex-ai/docs/explainable-ai/configuring-explanations-example-based#nearest-neighbor-search-config).", "type": "any" }, "presets": { "$ref": "GoogleCloudAiplatformV1beta1Presets", "description": "Simplified preset configuration, which automatically sets configuration values based on the desired query speed-precision trade-off and modality." }, "gcsSource": { "description": "The Cloud Storage locations that contain the instances to be indexed for approximate nearest neighbor search.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "neighborCount": { "description": "The number of neighbors to return when querying for examples.", "format": "int32", "type": "integer" }, "exampleGcsSource": { "$ref": "GoogleCloudAiplatformV1beta1ExamplesExampleGcsSource", "description": "The Cloud Storage input instances." } } }, "GenaiVertexV1beta1EnvironmentConfigEnvironmentNetworkEgressAllowlist": { "type": "object", "description": "Network egress configuration for the environment.", "properties": { "allowlist": { "items": { "$ref": "GenaiVertexV1beta1EnvironmentConfigEgressRule" }, "type": "array", "description": "List of allowed domains and their configurations. Set to `\"disabled\"` to block all network egress." } }, "id": "GenaiVertexV1beta1EnvironmentConfigEnvironmentNetworkEgressAllowlist" }, "GoogleCloudAiplatformV1beta1CancelCustomJobRequest": { "description": "Request message for JobService.CancelCustomJob.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1CancelCustomJobRequest", "type": "object" }, "GenaiVertexV1beta1CodeExecutionResultDelta": { "id": "GenaiVertexV1beta1CodeExecutionResultDelta", "properties": { "isError": { "type": "boolean" }, "result": { "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionResourceUsageAssessmentConfig": { "description": "Configuration for the batch prediction resource usage assessment.", "properties": { "modelName": { "description": "Required. The name of the model used for batch prediction.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionResourceUsageAssessmentConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1A2aTaskMessage": { "type": "object", "properties": { "role": { "type": "string", "enumDescriptions": [ "The role is unspecified.", "The message is from the client to the server.", "The message is from the server to the client." ], "description": "Required. The role of the sender of the message.", "enum": [ "ROLE_UNSPECIFIED", "ROLE_USER", "ROLE_AGENT" ] }, "referenceTaskIds": { "type": "array", "description": "Optional. The IDs of other tasks referenced by this message.", "items": { "type": "string" } }, "parts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aPart" }, "type": "array", "description": "Required. The content parts that make up the message." }, "metadata": { "description": "Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "messageId": { "type": "string", "description": "Required. The unique identifier of the message." }, "extensions": { "description": "Optional. A2A protocol extensions associated with the message.", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1A2aTaskMessage", "description": "Represents a single message in a conversation, compliant with the A2A specification." }, "GoogleCloudAiplatformV1beta1ListMetadataSchemasResponse": { "type": "object", "properties": { "nextPageToken": { "description": "A token, which can be sent as ListMetadataSchemasRequest.page_token to retrieve the next page. If this field is not populated, there are no subsequent pages.", "type": "string" }, "metadataSchemas": { "type": "array", "description": "The MetadataSchemas found for the MetadataStore.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MetadataSchema" } } }, "id": "GoogleCloudAiplatformV1beta1ListMetadataSchemasResponse", "description": "Response message for MetadataService.ListMetadataSchemas." }, "GoogleCloudAiplatformV1beta1ReinforcementTuningHyperParameters": { "type": "object", "description": "Hyperparameters for Reinforcement Tuning.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningHyperParameters", "properties": { "stepCount": { "format": "int64", "description": "Optional. Number of steps for the tuning job (mutually exclusive with epoch_count).", "type": "string" }, "checkpointInterval": { "description": "Optional. How often at steps to save checkpoints during training. If not set, one checkpoint per epoch will be set. ```total_steps = epoch_count * samples_per_prompt / total_prompts_in_dataset```", "format": "int32", "type": "integer" }, "evaluateInterval": { "description": "Optional. How often at steps to evaluate the tuning job during training. If not set, evel will be run per epoch. `total_steps = epoch_count * samples_per_prompt / total_prompts_in_dataset`", "format": "int32", "type": "integer" }, "thinkingLevel": { "enum": [ "REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED", "MINIMAL", "LOW", "MEDIUM", "HIGH" ], "enumDescriptions": [ "Unspecified thinking level.", "Little to no thinking.", "Low thinking level.", "Medium thinking level.", "High thinking level." ], "description": "Indicates the maximum thinking depth during tuning. Starting from Gemini 3.5 models, the old thinking_budget will no longer be supported and will result in a user error if set. Instead, users should use the thinking_level parameter to control the maximum thinking depth.", "type": "string" }, "learningRateMultiplier": { "type": "number", "format": "double", "description": "Optional. Learning rate multiplier for Reinforcement Tuning." }, "batchSize": { "description": "Optional. Batch size for the tuning job. How many prompts to process at a train step. If not set, the batch size will be determined automatically.", "type": "integer", "format": "int32" }, "maxOutputTokens": { "type": "integer", "description": "Optional. The maximum number of tokens to generate per prompt. Default to 32768.", "format": "int32" }, "samplesPerPrompt": { "description": "Optional. Number of different responses to generate per prompt during tuning.", "type": "integer", "format": "int32" }, "epochCount": { "type": "string", "description": "Optional. Number of training epoches for the tuning job.", "format": "int64" }, "adapterSize": { "enum": [ "ADAPTER_SIZE_UNSPECIFIED", "ADAPTER_SIZE_ONE", "ADAPTER_SIZE_TWO", "ADAPTER_SIZE_FOUR", "ADAPTER_SIZE_EIGHT", "ADAPTER_SIZE_SIXTEEN", "ADAPTER_SIZE_THIRTY_TWO" ], "type": "string", "enumDescriptions": [ "Adapter size is unspecified.", "Adapter size 1.", "Adapter size 2.", "Adapter size 4.", "Adapter size 8.", "Adapter size 16.", "Adapter size 32." ], "description": "Optional. Adapter size for Reinforcement Tuning." }, "thinkingBudget": { "type": "integer", "description": "Optional. The thinking budget for the tuning job to optimize for (Gemini 2.5 only). * -1 means dynamic thinking * 0 means no thinking * \u003e 0 means thinking budget in tokens If not set, default to -1 (dynamic thinking).", "format": "int32" } } }, "GoogleCloudAiplatformV1beta1CompletionStats": { "properties": { "failedCount": { "description": "Output only. The number of entities for which any error was encountered.", "type": "string", "readOnly": true, "format": "int64" }, "successfulCount": { "readOnly": true, "format": "int64", "description": "Output only. The number of entities that had been processed successfully.", "type": "string" }, "incompleteCount": { "readOnly": true, "type": "string", "format": "int64", "description": "Output only. In cases when enough errors are encountered a job, pipeline, or operation may be failed as a whole. Below is the number of entities for which the processing had not been finished (either in successful or failed state). Set to -1 if the number is unknown (for example, the operation failed before the total entity number could be collected)." }, "successfulForecastPointCount": { "readOnly": true, "type": "string", "description": "Output only. The number of the successful forecast points that are generated by the forecasting model. This is ONLY used by the forecasting batch prediction.", "format": "int64" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CompletionStats", "description": "Success and error statistics of processing multiple entities (for example, DataItems or structured data rows) in batch." }, "GenaiVertexV1beta1GoogleMapsCallDelta": { "type": "object", "id": "GenaiVertexV1beta1GoogleMapsCallDelta", "properties": { "arguments": { "$ref": "GenaiVertexV1beta1GoogleMapsCallContentGoogleMapsCallArguments", "description": "The arguments to pass to the Google Maps tool." } } }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilterTabularStatsFilter": { "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilterTabularStatsFilter", "type": "object", "properties": { "modelMonitoringJob": { "type": "string", "description": "From a particular monitoring job." }, "algorithm": { "description": "Specify the algorithm type used for distance calculation, eg: jensen_shannon_divergence, l_infinity.", "type": "string" }, "modelMonitoringSchedule": { "type": "string", "description": "From a particular monitoring schedule." }, "objectiveType": { "description": "One of the supported monitoring objectives: `raw-feature-drift` `prediction-output-drift` `feature-attribution`", "type": "string" }, "statsName": { "description": "If not specified, will return all the stats_names.", "type": "string" } }, "description": "Tabular statistics filter." }, "GenaiVertexV1beta1McpServerToolResultStep": { "description": "MCPServer tool result step.", "type": "object", "id": "GenaiVertexV1beta1McpServerToolResultStep", "properties": { "result": { "$ref": "GenaiVertexV1beta1Value", "description": "Required. The output from the MCP server call. Can be simple text or rich content." }, "serverName": { "description": "The name of the used MCP server.", "type": "string" }, "name": { "type": "string", "description": "Name of the tool which is called for this specific tool call." } } }, "CloudAiLargeModelsVisionGenerateVideoExperimentsConditioningFrame": { "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsConditioningFrame", "properties": { "image": { "description": "The image data for this conditioning frame.", "$ref": "CloudAiLargeModelsVisionGenerateVideoRequestImage" }, "frameNum": { "format": "int32", "description": "The index of the frame, starts with zero and must be a multiple of 8.", "type": "integer" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDb": { "description": "The config for the default RAG-managed Vector DB.", "properties": { "knn": { "description": "Performs a KNN search on RagCorpus. Default choice if not specified.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbKNN" }, "ann": { "description": "Performs an ANN search on RagCorpus. Use this if you have a lot of files (\u003e 10K) in your RagCorpus and want to reduce the search latency.", "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbANN" } }, "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDb", "type": "object" }, "GoogleCloudAiplatformV1beta1FullFineTunedResources": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FullFineTunedResources", "properties": { "deploymentType": { "enumDescriptions": [ "Unspecified deployment type.", "Eval deployment type.", "Prod deployment type." ], "type": "string", "description": "Required. The kind of deployment.", "enum": [ "DEPLOYMENT_TYPE_UNSPECIFIED", "DEPLOYMENT_TYPE_EVAL", "DEPLOYMENT_TYPE_PROD" ] }, "modelInferenceUnitCount": { "description": "Optional. The number of model inference units to use for this deployment. This can only be specified for DEPLOYMENT_TYPE_PROD. The following table lists the number of model inference units for different model types: * Gemini 2.5 Flash * Foundation FMIU: 25 * Expansion FMIU: 4 * Gemini 2.5 Pro * Foundation FMIU: 32 * Expansion FMIU: 16 * Veo 3.0 (undistilled) * Foundation FMIU: 63 * Expansion FMIU: 7 * Veo 3.0 (distilled) * Foundation FMIU: 30 * Expansion FMIU: 10", "type": "integer", "format": "int32" } }, "description": "Resources for an fft model." }, "CloudAiLargeModelsVisionGenerateVideoRequestVideo": { "properties": { "bytesBase64Encoded": { "description": "Base64 encoded bytes string representing the video.", "type": "string" }, "blobId": { "type": "string", "description": "Blob ID of the video. This is used for storing large videos in the request." }, "mimeType": { "description": "The MIME type of the content of the video. Only the video in the below listed MIME types are supported. - video/mp4", "type": "string" }, "gcsUri": { "type": "string" } }, "id": "CloudAiLargeModelsVisionGenerateVideoRequestVideo", "type": "object" }, "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest": { "type": "object", "description": "Request message for TensorboardService.ExportTensorboardTimeSeriesData.", "properties": { "filter": { "description": "Exports the TensorboardTimeSeries' data that match the filter expression.", "type": "string" }, "orderBy": { "type": "string", "description": "Field to use to sort the TensorboardTimeSeries' data. By default, TensorboardTimeSeries' data is returned in a pseudo random order." }, "pageToken": { "type": "string", "description": "A page token, received from a previous ExportTensorboardTimeSeriesData call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ExportTensorboardTimeSeriesData must match the call that provided the page token." }, "pageSize": { "description": "The maximum number of data points to return per page. The default page_size is 1000. Values must be between 1 and 10000. Values above 10000 are coerced to 10000.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1ExportTensorboardTimeSeriesDataRequest" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextExtraction": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextExtraction", "description": "A TrainingJob that trains and uploads an AutoML Text Extraction Model.", "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextExtractionInputs", "description": "The input parameters of this TrainingJob." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CreateModelMonitorOperationMetadata": { "description": "Runtime operation information for ModelMonitoringService.CreateModelMonitor.", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateModelMonitorOperationMetadata" }, "GenaiVertexV1beta1ImageResponseFormat": { "type": "object", "description": "Configuration for image output format.", "id": "GenaiVertexV1beta1ImageResponseFormat", "properties": { "aspectRatio": { "description": "The aspect ratio for the image output.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "1:1 aspect ratio.", "2:3 aspect ratio.", "3:2 aspect ratio.", "3:4 aspect ratio.", "4:3 aspect ratio.", "4:5 aspect ratio.", "5:4 aspect ratio.", "9:16 aspect ratio.", "16:9 aspect ratio.", "21:9 aspect ratio.", "1:8 aspect ratio.", "8:1 aspect ratio.", "1:4 aspect ratio.", "4:1 aspect ratio." ], "enum": [ "ASPECT_RATIO_UNSPECIFIED", "ASPECT_RATIO_ONE_BY_ONE", "ASPECT_RATIO_TWO_BY_THREE", "ASPECT_RATIO_THREE_BY_TWO", "ASPECT_RATIO_THREE_BY_FOUR", "ASPECT_RATIO_FOUR_BY_THREE", "ASPECT_RATIO_FOUR_BY_FIVE", "ASPECT_RATIO_FIVE_BY_FOUR", "ASPECT_RATIO_NINE_BY_SIXTEEN", "ASPECT_RATIO_SIXTEEN_BY_NINE", "ASPECT_RATIO_TWENTY_ONE_BY_NINE", "ASPECT_RATIO_ONE_BY_EIGHT", "ASPECT_RATIO_EIGHT_BY_ONE", "ASPECT_RATIO_ONE_BY_FOUR", "ASPECT_RATIO_FOUR_BY_ONE" ] }, "delivery": { "description": "The delivery mode for the image output.", "type": "string", "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ], "enumDescriptions": [ "Default value. This value is unused.", "Image data is returned inline in the response.", "Image data is returned as a URI." ] }, "mimeType": { "description": "The MIME type of the image output.", "enum": [ "TYPE_UNSPECIFIED", "TYPE_JPEG" ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "JPEG image format." ] }, "imageSize": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "512px image size.", "1K image size.", "2K image size.", "4K image size." ], "description": "The size of the image output.", "enum": [ "IMAGE_SIZE_UNSPECIFIED", "IMAGE_SIZE_FIVE_TWELVE", "IMAGE_SIZE_ONE_K", "IMAGE_SIZE_TWO_K", "IMAGE_SIZE_FOUR_K" ] } } }, "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInput": { "type": "object", "description": "Input for question answering helpfulness metric.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInput", "properties": { "metricSpec": { "description": "Required. Spec for question answering helpfulness score metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessSpec" }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInstance", "description": "Required. Question answering helpfulness instance." } } }, "GoogleCloudAiplatformV1beta1DeployedModelRef": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DeployedModelRef", "description": "Points to a DeployedModel.", "properties": { "endpoint": { "description": "Immutable. A resource name of an Endpoint.", "type": "string" }, "deployedModelId": { "description": "Immutable. An ID of a DeployedModel in the above Endpoint.", "type": "string" }, "checkpointId": { "description": "Immutable. The ID of the Checkpoint deployed in the DeployedModel.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1FeedbackContext": { "properties": { "name": { "type": "string", "description": "Identifier. The resource name. Assigned by the server on create. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/feedbackEntries/{feedback_entry}/feedbackContext`" }, "contextEvents": { "description": "Optional. The session events from the originating session.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SessionEvent" } } }, "id": "GoogleCloudAiplatformV1beta1FeedbackContext", "description": "Feedback context is a resource that represents additional information about the conversation where the feedback was given, such as the conversation history, system instructions, etc. If provided, feedback context allows to correlate the feedback with the conversation, even if the original session is deleted or not available.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformation": { "properties": { "numeric": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationNumericTransformation" }, "categorical": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationCategoricalTransformation" }, "auto": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationAutoTransformation" }, "text": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTextTransformation" }, "timestamp": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTimestampTransformation" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformation" }, "GoogleCloudAiplatformV1beta1PersistentResource": { "type": "object", "properties": { "network": { "type": "string", "description": "Optional. The full name of the Compute Engine [network](/compute/docs/networks-and-firewalls#networks) to peered with Vertex AI to host the persistent resources. For example, `projects/12345/global/networks/myVPC`. [Format](/compute/docs/reference/rest/v1/networks/insert) is of the form `projects/{project}/global/networks/{network}`. Where {project} is a project number, as in `12345`, and {network} is a network name. To specify this field, you must have already [configured VPC Network Peering for Vertex AI](https://cloud.google.com/vertex-ai/docs/general/vpc-peering). If this field is left unspecified, the resources aren't peered with any network." }, "error": { "$ref": "GoogleRpcStatus", "readOnly": true, "description": "Output only. Only populated when persistent resource's state is `STOPPING` or `ERROR`." }, "resourceRuntime": { "description": "Output only. Runtime information of the Persistent Resource.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ResourceRuntime" }, "updateTime": { "format": "google-datetime", "description": "Output only. Time when the PersistentResource was most recently updated.", "type": "string", "readOnly": true }, "pscInterfaceConfig": { "$ref": "GoogleCloudAiplatformV1beta1PscInterfaceConfig", "description": "Optional. Configuration for PSC-I for PersistentResource." }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The labels with user-defined metadata to organize PersistentResource. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "reservedIpRanges": { "items": { "type": "string" }, "description": "Optional. A list of names for the reserved IP ranges under the VPC network that can be used for this persistent resource. If set, we will deploy the persistent resource within the provided IP ranges. Otherwise, the persistent resource is deployed to any IP ranges under the provided VPC network. Example: ['vertex-ai-ip-range'].", "type": "array" }, "displayName": { "type": "string", "description": "Optional. The display name of the PersistentResource. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "RUNNING", "STOPPING", "ERROR", "REBOOTING", "UPDATING" ], "enumDescriptions": [ "Not set.", "The PROVISIONING state indicates the persistent resources is being created.", "The RUNNING state indicates the persistent resource is healthy and fully usable.", "The STOPPING state indicates the persistent resource is being deleted.", "The ERROR state indicates the persistent resource may be unusable. Details can be found in the `error` field.", "The REBOOTING state indicates the persistent resource is being rebooted (PR is not available right now but is expected to be ready again later).", "The UPDATING state indicates the persistent resource is being updated." ], "type": "string", "description": "Output only. The detailed state of a Study." }, "resourcePools": { "description": "Required. The spec of the pools of different resources.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ResourcePool" }, "type": "array" }, "name": { "description": "Immutable. Resource name of a PersistentResource.", "type": "string" }, "resourceRuntimeSpec": { "description": "Optional. Persistent Resource runtime spec. For example, used for Ray cluster configuration.", "$ref": "GoogleCloudAiplatformV1beta1ResourceRuntimeSpec" }, "startTime": { "format": "google-datetime", "description": "Output only. Time when the PersistentResource for the first time entered the `RUNNING` state.", "type": "string", "readOnly": true }, "encryptionSpec": { "description": "Optional. Customer-managed encryption key spec for a PersistentResource. If set, this PersistentResource and all sub-resources of this PersistentResource will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Time when the PersistentResource was created.", "format": "google-datetime" }, "satisfiesPzi": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." } }, "id": "GoogleCloudAiplatformV1beta1PersistentResource", "description": "Represents long-lasting resources that are dedicated to users to runs custom workloads. A PersistentResource can have multiple node pools and each node pool can have its own machine spec." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentation": { "description": "A TrainingJob that trains and uploads an AutoML Image Segmentation Model.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentation", "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationInputs", "description": "The input parameters of this TrainingJob." }, "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationMetadata" } } }, "GoogleCloudAiplatformV1beta1WriteFeatureValuesRequest": { "id": "GoogleCloudAiplatformV1beta1WriteFeatureValuesRequest", "description": "Request message for FeaturestoreOnlineServingService.WriteFeatureValues.", "type": "object", "properties": { "payloads": { "description": "Required. The entities to be written. Up to 100,000 feature values can be written across all `payloads`.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1WriteFeatureValuesPayload" } } } }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservability": { "description": "Data source for the OnlineEvaluator, based on Google Cloud Observability stack (Cloud Trace & Cloud Logging).", "properties": { "traceView": { "type": "string", "description": "Optional. Optional trace view that will be used to query traces. If empty, the `_AllSpans` view from `_Trace` US bucket will be used, i.e. `projects/{project_id}/locations/us/buckets/_Trace/datasets/Spans/views/_AllSpans`." }, "logView": { "description": "Optional. Optional log view that will be used to query logs. If empty, the project's default view (`projects/{project_id}`) will be used.", "type": "string" }, "openTelemetry": { "description": "Data source follows OpenTelemetry convention.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityOpenTelemetry" }, "traceScope": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScope", "description": "Scope online evaluation to single traces." }, "sessionScope": { "description": "Scope online evaluation to OTel sessions (i.e. group of traces with the same conversation ID).", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScope" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservability" }, "GoogleCloudAiplatformV1beta1DatasetDistribution": { "id": "GoogleCloudAiplatformV1beta1DatasetDistribution", "description": "Distribution computed over a tuning dataset.", "properties": { "buckets": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistributionDistributionBucket" }, "readOnly": true, "type": "array", "description": "Output only. Defines the histogram bucket." }, "median": { "type": "number", "readOnly": true, "description": "Output only. The median of the values in the population.", "format": "double" }, "sum": { "type": "number", "description": "Output only. Sum of a given population of values.", "format": "double", "readOnly": true }, "max": { "description": "Output only. The maximum of the population values.", "type": "number", "format": "double", "readOnly": true }, "p5": { "format": "double", "description": "Output only. The 5th percentile of the values in the population.", "readOnly": true, "type": "number" }, "mean": { "type": "number", "readOnly": true, "description": "Output only. The arithmetic mean of the values in the population.", "format": "double" }, "min": { "type": "number", "readOnly": true, "description": "Output only. The minimum of the population values.", "format": "double" }, "p95": { "description": "Output only. The 95th percentile of the values in the population.", "readOnly": true, "format": "double", "type": "number" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfig": { "properties": { "generateMemoriesExamples": { "description": "Optional. Provides examples of how to generate memories for a particular scope.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExample" }, "type": "array" }, "disableNaturalLanguageMemories": { "type": "boolean", "description": "Optional. Indicates whether natural language memory generation should be disabled for all requests. By default, natural language memory generation is enabled. Set this to `true` when you only want to generate structured memories." }, "consolidationConfig": { "description": "Optional. Represents configuration for customizing how memories are consolidated together.", "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigConsolidationConfig" }, "memoryTopics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopic" }, "description": "Optional. Represents topics of information that should be extracted from conversations and stored as memories. If not set, then Memory Bank's default topics will be used.", "type": "array" }, "enableThirdPersonMemories": { "type": "boolean", "description": "Optional. Indicates whether the memories will be generated in the third person (i.e. \"The user generates memories with Memory Bank.\"). By default, the memories will be generated in the first person (i.e. \"I generate memories with Memory Bank.\")" }, "scopeKeys": { "items": { "type": "string" }, "description": "Optional. Represents the scope keys (i.e. 'user_id') for which to use this config. A request's scope must include all of the provided keys for the config to be used (order does not matter). If empty, then the config will be used for all requests that do not have a more specific config. Only one default config is allowed per Memory Bank.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfig", "type": "object", "description": "Represents configuration for organizing natural language memories for a particular scope." }, "CloudAiLargeModelsVisionRaiInfoDetectedLabelsEntity": { "description": "The properties for a detected entity from the rai signal.", "type": "object", "id": "CloudAiLargeModelsVisionRaiInfoDetectedLabelsEntity", "properties": { "description": { "description": "Description of the label", "type": "string" }, "iouScore": { "type": "number", "format": "float", "description": "The intersection ratio between the detection bounding box and the mask." }, "score": { "format": "float", "description": "Confidence score of the label", "type": "number" }, "boundingBox": { "$ref": "CloudAiLargeModelsVisionRaiInfoDetectedLabelsBoundingBox", "description": "Bounding box of the label" }, "mid": { "description": "MID of the label", "type": "string" } } }, "GoogleCloudAiplatformV1beta1PSCAutomationConfig": { "description": "PSC config that is used to automatically create PSC endpoints in the user projects.", "type": "object", "properties": { "forwardingRule": { "type": "string", "description": "Output only. Forwarding rule created by the PSC service automation.", "readOnly": true }, "network": { "description": "Required. The full name of the Google Compute Engine [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks). [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/get): `projects/{project}/global/networks/{network}`.", "type": "string" }, "state": { "description": "Output only. The state of the PSC service automation.", "type": "string", "readOnly": true, "enumDescriptions": [ "Should not be used.", "The PSC service automation is successful.", "The PSC service automation has failed." ], "enum": [ "PSC_AUTOMATION_STATE_UNSPECIFIED", "PSC_AUTOMATION_STATE_SUCCESSFUL", "PSC_AUTOMATION_STATE_FAILED" ] }, "errorMessage": { "type": "string", "readOnly": true, "description": "Output only. Error message if the PSC service automation failed." }, "projectId": { "description": "Required. Project id used to create forwarding rule.", "type": "string" }, "ipAddress": { "description": "Output only. IP address rule created by the PSC service automation.", "readOnly": true, "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1PSCAutomationConfig" }, "GenaiVertexV1beta1DocumentDelta": { "type": "object", "id": "GenaiVertexV1beta1DocumentDelta", "properties": { "uri": { "type": "string" }, "mimeType": { "enum": [ "TYPE_UNSPECIFIED", "TYPE_PDF", "TYPE_CSV" ], "type": "string", "enumDescriptions": [ "", "PDF document format", "CSV document format" ] }, "data": { "type": "string", "format": "byte" } } }, "GoogleCloudAiplatformV1beta1SummarizationVerbosityInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SummarizationVerbosityInstance", "properties": { "instruction": { "description": "Optional. Summarization prompt for LLM.", "type": "string" }, "context": { "description": "Required. Text to be summarized.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" } }, "description": "Spec for summarization verbosity instance." }, "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualitySpec": { "id": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualitySpec", "type": "object", "description": "Spec for pairwise summarization quality score metric.", "properties": { "useReference": { "description": "Optional. Whether to use instance.reference to compute pairwise summarization quality.", "type": "boolean" }, "version": { "format": "int32", "type": "integer", "description": "Optional. Which version to use for evaluation." } } }, "GoogleCloudAiplatformV1beta1TrialParameter": { "id": "GoogleCloudAiplatformV1beta1TrialParameter", "description": "A message representing a parameter to be tuned.", "properties": { "parameterId": { "readOnly": true, "description": "Output only. The ID of the parameter. The parameter should be defined in StudySpec's Parameters.", "type": "string" }, "value": { "description": "Output only. The value of the parameter. `number_value` will be set if a parameter defined in StudySpec is in type 'INTEGER', 'DOUBLE' or 'DISCRETE'. `string_value` will be set if a parameter defined in StudySpec is in type 'CATEGORICAL'.", "readOnly": true, "type": "any" } }, "type": "object" }, "GenaiVertexV1beta1Retrieval": { "type": "object", "description": "A tool that can be used by the model to retrieve files.", "properties": { "exaAiSearchConfig": { "$ref": "GenaiVertexV1beta1ExaAISearchConfig", "description": "Used to specify configuration for ExaAISearch." }, "ragStoreConfig": { "$ref": "GenaiVertexV1beta1RagStoreConfig", "description": "Used to specify configuration for RagStore." }, "vertexAiSearchConfig": { "description": "Used to specify configuration for VertexAISearch.", "$ref": "GenaiVertexV1beta1VertexAISearchConfig" }, "parallelAiSearchConfig": { "$ref": "GenaiVertexV1beta1ParallelAISearchConfig", "description": "Used to specify configuration for ParallelAISearch." }, "retrievalTypes": { "type": "array", "items": { "enumDescriptions": [ "", "", "", "", "" ], "enum": [ "RETRIEVAL_TYPE_UNSPECIFIED", "RETRIEVAL_TYPE_VERTEX_AI_SEARCH", "RETRIEVAL_TYPE_RAG_STORE", "RETRIEVAL_TYPE_EXA_AI_SEARCH", "RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" ], "type": "string" }, "description": "The types of file retrieval to enable." } }, "id": "GenaiVertexV1beta1Retrieval" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScopePredicate": { "type": "object", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScopePredicate", "properties": { "totalTokenUsage": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the total token usage within a trace." }, "duration": { "description": "Filter on the duration of a trace (in seconds).", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "serviceVersion": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", "description": "Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." } }, "description": "Defines a single filter predicate." }, "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadata": { "properties": { "inputConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataInputConfig" } }, "description": "The metadata of Datasets that contain tables data.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadata" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerExactMatchScorer": { "properties": { "correctAnswerReward": { "format": "float", "type": "number", "description": "Assigns this reward score if the parsed response string equals the expression." }, "wrongAnswerReward": { "type": "number", "description": "Assigns this reward score if the parsed reward value does not equal the expression.", "format": "float" }, "expression": { "type": "string", "description": "The string expression to match against for scoring. This field supports placeholders in the format of {{references.key}} that will be replaced before matching. Regex is not supported for this expression. For example, users can define an ExactMatchScorer as follows: { \"correctAnswerReward\": 1.0, \"wrongAnswerReward\": -1.0, \"expression\": \"{{references.concise_answer}}\" } When evaluating the reward for each parsed autorater response, if the prompt references in the training/validation dataset has the following fields: ``` { \"example\": ..., \"references\": { \"concise_ansser\": \"Yes\", \"verbose_answer\": \"The answer is Yes\" } } ``` The above ExactMatchScorer will be replaced as follows for scoring: ``` { \"correctAnswerReward\": 1.0, \"wrongAnswerReward\": -1.0, \"expression\": \"Yes\" } ``` If the *parsed* autorater response is equal to the string `\"Yes\"`, then the reward is `1.0`, otherwise the reward is `-1.0`." } }, "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerExactMatchScorer", "type": "object", "description": "Scores autorater responses by using exact string match reward scorer." }, "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigFilter": { "description": "Config for filters.", "type": "object", "properties": { "vectorDistanceThreshold": { "type": "number", "description": "Optional. Only returns contexts with vector distance smaller than the threshold.", "format": "double" }, "metadataFilter": { "description": "Optional. String for metadata filtering.", "type": "string" }, "vectorSimilarityThreshold": { "type": "number", "description": "Optional. Only returns contexts with vector similarity larger than the threshold.", "format": "double" } }, "id": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigFilter" }, "GoogleCloudAiplatformV1beta1ImageConfig": { "properties": { "personGeneration": { "enum": [ "PERSON_GENERATION_UNSPECIFIED", "ALLOW_ALL", "ALLOW_ADULT", "ALLOW_NONE" ], "enumDescriptions": [ "The default behavior is unspecified. The model will decide whether to generate images of people.", "Allows the model to generate images of people, including adults and children.", "Allows the model to generate images of adults, but not children.", "Prevents the model from generating images of people." ], "type": "string", "description": "Optional. Controls whether the model can generate people." }, "imageSize": { "description": "Optional. Specifies the size of generated images. Supported values are `1K`, `2K`, `4K`. If not specified, the model will use default value `1K`.", "type": "string" }, "prominentPeople": { "enum": [ "PROMINENT_PEOPLE_UNSPECIFIED", "ALLOW_PROMINENT_PEOPLE", "BLOCK_PROMINENT_PEOPLE" ], "description": "Optional. Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people.", "enumDescriptions": [ "Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.", "Allows the model to generate images of prominent people.", "Prevents the model from generating images of prominent people." ], "type": "string" }, "imageOutputOptions": { "description": "Optional. The image output format for generated images.", "$ref": "GoogleCloudAiplatformV1beta1ImageConfigImageOutputOptions" }, "aspectRatio": { "description": "Optional. The desired aspect ratio for the generated images. The following aspect ratios are supported: \"1:1\" \"2:3\", \"3:2\" \"3:4\", \"4:3\" \"4:5\", \"5:4\" \"9:16\", \"16:9\" \"21:9\"", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ImageConfig", "description": "Configuration for image generation. This message allows you to control various aspects of image generation, such as the output format, aspect ratio, and whether the model can generate images of people." }, "GoogleCloudAiplatformV1beta1BatchCreateRagMetadataRequest": { "id": "GoogleCloudAiplatformV1beta1BatchCreateRagMetadataRequest", "properties": { "requests": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1CreateRagMetadataRequest" }, "description": "Required. The request messages for VertexRagDataService.CreateRagMetadata. A maximum of 500 rag file metadata can be created in a batch." } }, "description": "Request message for VertexRagDataService.BatchCreateRagMetadata.", "type": "object" }, "CloudAiLargeModelsVisionGenerateVideoResponse": { "properties": { "raiMediaFilteredReasons": { "description": "Returns rai failure reasons if any.", "items": { "type": "string" }, "type": "array" }, "raiMediaFilteredCount": { "format": "int32", "description": "Returns if any videos were filtered due to RAI policies.", "type": "integer" }, "generatedSamples": { "type": "array", "items": { "$ref": "CloudAiLargeModelsVisionMedia" }, "description": "The generates samples." }, "videos": { "items": { "$ref": "CloudAiLargeModelsVisionGenerateVideoResponseVideo" }, "description": "List of videos, used to align naming with the external response.", "type": "array" } }, "description": "Generate video response.", "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoResponse" }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoActionRecognitionPredictionInstance": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoActionRecognitionPredictionInstance", "description": "Prediction input format for Video Action Recognition.", "type": "object", "properties": { "content": { "description": "The Google Cloud Storage location of the video on which to perform the prediction.", "type": "string" }, "mimeType": { "description": "The MIME type of the content of the video. Only the following are supported: video/mp4 video/avi video/quicktime", "type": "string" }, "timeSegmentStart": { "description": "The beginning, inclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision.", "type": "string" }, "timeSegmentEnd": { "type": "string", "description": "The end, exclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision, and \"inf\" or \"Infinity\" is allowed, which means the end of the video." } } }, "GoogleCloudAiplatformV1beta1RagChunkPageSpan": { "properties": { "lastPage": { "description": "Page where chunk ends in the document. Inclusive. 1-indexed.", "type": "integer", "format": "int32" }, "firstPage": { "description": "Page where chunk starts in the document. Inclusive. 1-indexed.", "format": "int32", "type": "integer" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RagChunkPageSpan", "description": "Represents where the chunk starts and ends in the document." }, "GoogleCloudAiplatformV1beta1Metric": { "id": "GoogleCloudAiplatformV1beta1Metric", "description": "The metric used for running evaluations.", "properties": { "pointwiseMetricSpec": { "description": "Spec for pointwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricSpec" }, "llmBasedMetricSpec": { "description": "Spec for an LLM based metric.", "$ref": "GoogleCloudAiplatformV1beta1LLMBasedMetricSpec" }, "metadata": { "description": "Optional. Metadata about the metric, used for visualization and organization.", "$ref": "GoogleCloudAiplatformV1beta1MetricMetadata" }, "rougeSpec": { "description": "Spec for rouge metric.", "$ref": "GoogleCloudAiplatformV1beta1RougeSpec" }, "computationBasedMetricSpec": { "description": "Spec for a computation based metric.", "$ref": "GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec" }, "predefinedMetricSpec": { "description": "The spec for a pre-defined metric.", "$ref": "GoogleCloudAiplatformV1beta1PredefinedMetricSpec" }, "customCodeExecutionSpec": { "$ref": "GoogleCloudAiplatformV1beta1CustomCodeExecutionSpec", "description": "Spec for Custom Code Execution metric." }, "bleuSpec": { "description": "Spec for bleu metric.", "$ref": "GoogleCloudAiplatformV1beta1BleuSpec" }, "exactMatchSpec": { "description": "Spec for exact match metric.", "$ref": "GoogleCloudAiplatformV1beta1ExactMatchSpec" }, "aggregationMetrics": { "items": { "enum": [ "AGGREGATION_METRIC_UNSPECIFIED", "AVERAGE", "MODE", "STANDARD_DEVIATION", "VARIANCE", "MINIMUM", "MAXIMUM", "MEDIAN", "PERCENTILE_P90", "PERCENTILE_P95", "PERCENTILE_P99" ], "enumDescriptions": [ "Unspecified aggregation metric.", "Average aggregation metric. Not supported for Pairwise metric.", "Mode aggregation metric.", "Standard deviation aggregation metric. Not supported for pairwise metric.", "Variance aggregation metric. Not supported for pairwise metric.", "Minimum aggregation metric. Not supported for pairwise metric.", "Maximum aggregation metric. Not supported for pairwise metric.", "Median aggregation metric. Not supported for pairwise metric.", "90th percentile aggregation metric. Not supported for pairwise metric.", "95th percentile aggregation metric. Not supported for pairwise metric.", "99th percentile aggregation metric. Not supported for pairwise metric." ], "type": "string" }, "type": "array", "description": "Optional. The aggregation metrics to use." }, "pairwiseMetricSpec": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricSpec", "description": "Spec for pairwise metric." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewSyncSyncSummary": { "description": "Summary from the Sync job. For continuous syncs, the summary is updated periodically. For batch syncs, it gets updated on completion of the sync.", "properties": { "rowSynced": { "description": "Output only. Total number of rows synced.", "readOnly": true, "format": "int64", "type": "string" }, "totalSlot": { "description": "Output only. BigQuery slot milliseconds consumed for the sync job.", "format": "int64", "readOnly": true, "type": "string" }, "systemWatermarkTime": { "type": "string", "format": "google-datetime", "description": "Lower bound of the system time watermark for the sync job. This is only set for continuously syncing feature views." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureViewSyncSyncSummary" }, "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpec": { "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpec", "type": "object", "properties": { "configs": { "description": "Mapping configuration for this SliceSpec. The key is the name of the feature. By default, the key will be prefixed by \"instance\" as a dictionary prefix for Vertex Batch Predictions output format.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecSliceConfig" }, "type": "object" } }, "description": "Specification for how the data should be sliced." }, "GoogleCloudAiplatformV1beta1AcceptPublisherModelEulaRequest": { "type": "object", "properties": { "publisherModel": { "type": "string", "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}`" } }, "id": "GoogleCloudAiplatformV1beta1AcceptPublisherModelEulaRequest", "description": "Request message for ModelGardenService.AcceptPublisherModelEula." }, "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchMetricValue": { "properties": { "score": { "description": "Output only. TrajectoryInOrderMatch score.", "format": "float", "readOnly": true, "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchMetricValue", "type": "object", "description": "TrajectoryInOrderMatch metric value for an instance." }, "GoogleCloudAiplatformV1beta1SafetyRating": { "type": "object", "properties": { "category": { "enum": [ "HARM_CATEGORY_UNSPECIFIED", "HARM_CATEGORY_HATE_SPEECH", "HARM_CATEGORY_DANGEROUS_CONTENT", "HARM_CATEGORY_HARASSMENT", "HARM_CATEGORY_SEXUALLY_EXPLICIT", "HARM_CATEGORY_CIVIC_INTEGRITY", "HARM_CATEGORY_IMAGE_HATE", "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", "HARM_CATEGORY_IMAGE_HARASSMENT", "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", "HARM_CATEGORY_JAILBREAK" ], "enumDeprecated": [ false, false, false, false, false, true, false, false, false, false, false ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Content that promotes violence or incites hatred against individuals or groups based on certain attributes.", "Content that promotes, facilitates, or enables dangerous activities.", "Abusive, threatening, or content intended to bully, torment, or ridicule.", "Content that contains sexually explicit material.", "Deprecated: Election filter is not longer supported. The harm category is civic integrity.", "Images that contain hate speech.", "Images that contain dangerous content.", "Images that contain harassment.", "Images that contain sexually explicit content.", "Prompts designed to bypass safety filters." ], "description": "Output only. The harm category of this rating.", "readOnly": true }, "severityScore": { "readOnly": true, "description": "Output only. The severity score of harm for this category.", "format": "float", "type": "number" }, "overwrittenThreshold": { "readOnly": true, "enumDescriptions": [ "The harm block threshold is unspecified.", "Block content with a low harm probability or higher.", "Block content with a medium harm probability or higher.", "Block content with a high harm probability.", "Do not block any content, regardless of its harm probability.", "Turn off the safety filter entirely." ], "enum": [ "HARM_BLOCK_THRESHOLD_UNSPECIFIED", "BLOCK_LOW_AND_ABOVE", "BLOCK_MEDIUM_AND_ABOVE", "BLOCK_ONLY_HIGH", "BLOCK_NONE", "OFF" ], "type": "string", "description": "Output only. The overwritten threshold for the safety category of Gemini 2.0 image out. If minors are detected in the output image, the threshold of each safety category will be overwritten if user sets a lower threshold." }, "probabilityScore": { "description": "Output only. The probability score of harm for this category.", "type": "number", "readOnly": true, "format": "float" }, "severity": { "readOnly": true, "enumDescriptions": [ "The harm severity is unspecified.", "The harm severity is negligible.", "The harm severity is low.", "The harm severity is medium.", "The harm severity is high." ], "type": "string", "enum": [ "HARM_SEVERITY_UNSPECIFIED", "HARM_SEVERITY_NEGLIGIBLE", "HARM_SEVERITY_LOW", "HARM_SEVERITY_MEDIUM", "HARM_SEVERITY_HIGH" ], "description": "Output only. The severity of harm for this category." }, "probability": { "enum": [ "HARM_PROBABILITY_UNSPECIFIED", "NEGLIGIBLE", "LOW", "MEDIUM", "HIGH" ], "type": "string", "readOnly": true, "description": "Output only. The probability of harm for this category.", "enumDescriptions": [ "The harm probability is unspecified.", "The harm probability is negligible.", "The harm probability is low.", "The harm probability is medium.", "The harm probability is high." ] }, "blocked": { "readOnly": true, "type": "boolean", "description": "Output only. Indicates whether the content was blocked because of this rating." } }, "description": "A safety rating for a piece of content. The safety rating contains the harm category and the harm probability level.", "id": "GoogleCloudAiplatformV1beta1SafetyRating" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessSpec": { "description": "Spec for question answering correctness metric.", "type": "object", "properties": { "version": { "type": "integer", "format": "int32", "description": "Optional. Which version to use for evaluation." }, "useReference": { "description": "Optional. Whether to use instance.reference to compute question answering correctness.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessSpec" }, "GoogleCloudAiplatformV1beta1ListPublisherModelsResponse": { "description": "Response message for ModelGardenService.ListPublisherModels.", "id": "GoogleCloudAiplatformV1beta1ListPublisherModelsResponse", "type": "object", "properties": { "publisherModels": { "description": "List of PublisherModels in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModel" } }, "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListPublisherModels.page_token to obtain that page.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ListEntityTypesResponse": { "properties": { "nextPageToken": { "description": "A token, which can be sent as ListEntityTypesRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "entityTypes": { "description": "The EntityTypes matching the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EntityType" } } }, "id": "GoogleCloudAiplatformV1beta1ListEntityTypesResponse", "description": "Response message for FeaturestoreService.ListEntityTypes.", "type": "object" }, "GenaiVertexV1beta1PlaceCitation": { "type": "object", "description": "A place citation annotation.", "id": "GenaiVertexV1beta1PlaceCitation", "properties": { "placeId": { "type": "string", "description": "The ID of the place, in `places/{place_id}` format." }, "url": { "type": "string", "description": "URI reference of the place." }, "reviewSnippets": { "description": "Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.", "items": { "$ref": "GenaiVertexV1beta1ReviewSnippet" }, "type": "array" }, "name": { "description": "Title of the place.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInput": { "properties": { "instances": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInstance" }, "description": "Required. Repeated tool parameter key value match instances." }, "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchSpec", "description": "Required. Spec for tool parameter key value match metric." } }, "description": "Input for tool parameter key value match metric.", "id": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInput", "type": "object" }, "GoogleCloudAiplatformV1beta1ContentsExampleExpectedContent": { "id": "GoogleCloudAiplatformV1beta1ContentsExampleExpectedContent", "properties": { "content": { "description": "Required. A single step's content.", "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "description": "A single step of the expected output.", "type": "object" }, "GoogleCloudAiplatformV1beta1FindNeighborsRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FindNeighborsRequest", "properties": { "queries": { "type": "array", "description": "The list of queries.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsRequestQuery" } }, "deployedIndexId": { "description": "The ID of the DeployedIndex that will serve the request. This request is sent to a specific IndexEndpoint, as per the IndexEndpoint.network. That IndexEndpoint also has IndexEndpoint.deployed_indexes, and each such index has a DeployedIndex.id field. The value of the field below must equal one of the DeployedIndex.id fields of the IndexEndpoint that is being called for this request.", "type": "string" }, "returnFullDatapoint": { "type": "boolean", "description": "If set to true, the full datapoints (including all vector values and restricts) of the nearest neighbors are returned. Note that returning full datapoint will significantly increase the latency and cost of the query." } }, "description": "The request message for MatchService.FindNeighbors." }, "CloudAiLargeModelsVisionSemanticFilterResponse": { "type": "object", "id": "CloudAiLargeModelsVisionSemanticFilterResponse", "properties": { "passedSemanticFilter": { "type": "boolean", "description": "This response is added when semantic filter config is turned on in EditConfig. It reports if this image is passed semantic filter response. If passed_semantic_filter is false, the bounding box information will be populated for user to check what caused the semantic filter to fail." }, "namedBoundingBoxes": { "type": "array", "items": { "$ref": "CloudAiLargeModelsVisionNamedBoundingBox" }, "description": "Class labels of the bounding boxes that failed the semantic filtering. Bounding box coordinates." } } }, "GoogleCloudAiplatformV1beta1UsageMetadata": { "properties": { "totalTokenCount": { "type": "integer", "description": "The total number of tokens for the entire request. This is the sum of `prompt_token_count`, `candidates_token_count`, `tool_use_prompt_token_count`, and `thoughts_token_count`.", "format": "int32" }, "promptTokensDetails": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "description": "Output only. A detailed breakdown of the token count for each modality in the prompt.", "type": "array" }, "toolUsePromptTokenCount": { "readOnly": true, "description": "Output only. The number of tokens in the results from tool executions, which are provided back to the model as input, if applicable.", "format": "int32", "type": "integer" }, "cachedContentTokenCount": { "readOnly": true, "format": "int32", "description": "Output only. The number of tokens in the cached content that was used for this request.", "type": "integer" }, "thoughtsTokenCount": { "readOnly": true, "type": "integer", "description": "Output only. The number of tokens that were part of the model's generated \"thoughts\" output, if applicable.", "format": "int32" }, "candidatesTokenCount": { "format": "int32", "description": "The total number of tokens in the generated candidates.", "type": "integer" }, "trafficType": { "type": "string", "description": "Output only. The traffic type for this request.", "readOnly": true, "enumDescriptions": [ "Unspecified request traffic type.", "Type for Pay-As-You-Go traffic.", "Type for Priority Pay-As-You-Go traffic.", "Type for Flex traffic.", "Type for Off-Peak Pay-As-You-Go traffic.", "Type for Provisioned Throughput traffic." ], "enum": [ "TRAFFIC_TYPE_UNSPECIFIED", "ON_DEMAND", "ON_DEMAND_PRIORITY", "ON_DEMAND_FLEX", "ON_DEMAND_OFFPEAK", "PROVISIONED_THROUGHPUT" ] }, "cacheTokensDetails": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "type": "array", "description": "Output only. A detailed breakdown of the token count for each modality in the cached content." }, "toolUsePromptTokensDetails": { "description": "Output only. A detailed breakdown by modality of the token counts from the results of tool executions, which are provided back to the model as input.", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "type": "array" }, "promptTokenCount": { "type": "integer", "format": "int32", "description": "The total number of tokens in the prompt. This includes any text, images, or other media provided in the request. When `cached_content` is set, this also includes the number of tokens in the cached content." }, "candidatesTokensDetails": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" }, "description": "Output only. A detailed breakdown of the token count for each modality in the generated candidates.", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UsageMetadata", "description": "Usage metadata about the content generation request and response. This message provides a detailed breakdown of token usage and other relevant metrics." }, "GoogleCloudAiplatformV1beta1VertexAiSearchConfig": { "id": "GoogleCloudAiplatformV1beta1VertexAiSearchConfig", "description": "Config for the Vertex AI Search.", "type": "object", "properties": { "servingConfig": { "description": "Vertex AI Search Serving Config resource full name. For example, `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}` or `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1TensorboardTimeSeriesMetadata": { "id": "GoogleCloudAiplatformV1beta1TensorboardTimeSeriesMetadata", "type": "object", "properties": { "maxStep": { "format": "int64", "description": "Output only. Max step index of all data points within a TensorboardTimeSeries.", "type": "string", "readOnly": true }, "maxWallTime": { "type": "string", "description": "Output only. Max wall clock timestamp of all data points within a TensorboardTimeSeries.", "format": "google-datetime", "readOnly": true }, "maxBlobSequenceLength": { "readOnly": true, "type": "string", "format": "int64", "description": "Output only. The largest blob sequence length (number of blobs) of all data points in this time series, if its ValueType is BLOB_SEQUENCE." } }, "description": "Describes metadata for a TensorboardTimeSeries." }, "GenaiVertexV1beta1SpeechConfig": { "id": "GenaiVertexV1beta1SpeechConfig", "type": "object", "description": "The configuration for speech interaction.", "properties": { "speaker": { "type": "string", "description": "The speaker's name, it should match the speaker name given in the prompt." }, "language": { "description": "The language of the speech.", "type": "string" }, "voice": { "type": "string", "description": "The voice of the speaker." } } }, "GoogleCloudAiplatformV1beta1Context": { "properties": { "parentContexts": { "description": "Output only. A list of resource names of Contexts that are parents of this Context. A Context may have at most 10 parent_contexts.", "type": "array", "items": { "type": "string" }, "readOnly": true }, "displayName": { "type": "string", "description": "User provided display name of the Context. May be up to 128 Unicode characters." }, "createTime": { "type": "string", "description": "Output only. Timestamp when this Context was created.", "format": "google-datetime", "readOnly": true }, "schemaTitle": { "description": "The title of the schema describing the metadata. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store.", "type": "string" }, "etag": { "description": "An eTag used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "description": { "description": "Description of the Context", "type": "string" }, "name": { "type": "string", "description": "Immutable. The resource name of the Context." }, "schemaVersion": { "type": "string", "description": "The version of the schema in schema_name to use. Schema title and version is expected to be registered in earlier Create Schema calls. And both are used together as unique identifiers to identify schemas within the local metadata store." }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this Context was last updated.", "readOnly": true }, "labels": { "type": "object", "description": "The labels with user-defined metadata to organize your Contexts. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Context (System labels are excluded).", "additionalProperties": { "type": "string" } }, "metadata": { "type": "object", "description": "Properties of the Context. Top level metadata keys' heading and trailing spaces will be trimmed. The size of this field should not exceed 200KB.", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "type": "object", "description": "Instance of a general context.", "id": "GoogleCloudAiplatformV1beta1Context" }, "GoogleCloudAiplatformV1beta1MonitoredAgent": { "id": "GoogleCloudAiplatformV1beta1MonitoredAgent", "type": "object", "properties": { "displayName": { "type": "string", "description": "Optional. The display name of the MonitoredAgent." }, "createTime": { "type": "string", "description": "Output only. The time the MonitoredAgent was created.", "readOnly": true, "format": "google-datetime" }, "agentResource": { "description": "Required. The configuration for the agent being monitored.", "$ref": "GoogleCloudAiplatformV1beta1AgentResource" }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. The time the MonitoredAgent was last updated.", "readOnly": true }, "statusMessage": { "type": "string", "description": "Output only. A brief message explaining the current state.", "readOnly": true }, "state": { "readOnly": true, "enumDescriptions": [ "The default value. This value is used if the state is omitted.", "The agent is successfully enabled and active.", "The agent is in the process of being enabled.", "The agent is disabled." ], "type": "string", "description": "Output only. The current state of the agent's enablement.", "enum": [ "ENABLEMENT_STATE_UNSPECIFIED", "ACTIVE", "ENABLING", "DISABLED" ] }, "name": { "description": "Identifier. The resource name of the MonitoredAgent.", "type": "string" } }, "description": "Represents a monitored agent in a specific Location." }, "GenaiVertexV1beta1McpServerToolCallDelta": { "type": "object", "properties": { "serverName": { "type": "string" }, "name": { "type": "string" }, "arguments": { "$ref": "GenaiVertexV1beta1Struct" } }, "id": "GenaiVertexV1beta1McpServerToolCallDelta" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifact": { "type": "object", "description": "Represents a single artifact produced by a task.", "properties": { "metadata": { "description": "Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "displayName": { "type": "string", "description": "Optional. The human-readable name of the artifact." }, "description": { "type": "string", "description": "Optional. A human-readable description of the artifact." }, "parts": { "description": "Required. The content parts that make up the artifact.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2APart" } }, "extensions": { "type": "array", "items": { "type": "string" }, "description": "Optional. A2A protocol extensions associated with the artifact." }, "artifactId": { "type": "string", "description": "Required. The unique identifier of the artifact within the task." } }, "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifact" }, "GoogleCloudAiplatformV1beta1UpdatePersistentResourceOperationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdatePersistentResourceOperationMetadata", "description": "Details of operations that perform update PersistentResource.", "properties": { "genericMetadata": { "description": "Operation metadata for PersistentResource.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progressMessage": { "type": "string", "description": "Progress Message for Update LRO" } } }, "GenaiVertexV1beta1UrlContextResultContentUrlContextResult": { "description": "The result of the URL context.", "properties": { "status": { "enum": [ "STATUS_UNSPECIFIED", "SUCCESS", "ERROR", "PAYWALL", "UNSAFE" ], "type": "string", "description": "The status of the URL retrieval.", "enumDescriptions": [ "Unspecified status. This value should not be used.", "Url retrieval is successful.", "Url retrieval is failed due to error.", "Url retrieval is failed because the content is behind paywall.", "Url retrieval is failed because the content is unsafe." ] }, "url": { "description": "The URL that was fetched.", "type": "string" } }, "id": "GenaiVertexV1beta1UrlContextResultContentUrlContextResult", "type": "object" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate": { "description": "Defines a predicate for filtering based on a string value.", "type": "object", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", "properties": { "values": { "type": "array", "description": "Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long.", "items": { "type": "string" } } } }, "GoogleCloudAiplatformV1beta1DestinationFeatureSetting": { "type": "object", "properties": { "featureId": { "type": "string", "description": "Required. The ID of the Feature to apply the setting to." }, "destinationField": { "description": "Specify the field name in the export destination. If not specified, Feature ID is used.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1DestinationFeatureSetting" }, "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfigMigrateDataLabelingAnnotatedDatasetConfig": { "description": "Config for migrating AnnotatedDataset in datalabeling.googleapis.com to Vertex AI's SavedQuery.", "properties": { "annotatedDataset": { "type": "string", "description": "Required. Full resource name of data labeling AnnotatedDataset. Format: `projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}`." } }, "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateDataLabelingDatasetConfigMigrateDataLabelingAnnotatedDatasetConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJob": { "description": "NotebookExecutionJob represents an instance of a notebook execution.", "properties": { "labels": { "type": "object", "description": "The labels with user-defined metadata to organize NotebookExecutionJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "additionalProperties": { "type": "string" } }, "workbenchRuntime": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntime", "description": "The Workbench runtime configuration to use for the notebook execution." }, "jobState": { "description": "Output only. The state of the NotebookExecutionJob.", "readOnly": true, "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "type": "string" }, "encryptionSpec": { "description": "Customer-managed encryption key spec for the notebook execution job. This field is auto-populated if the NotebookRuntimeTemplate has an encryption spec.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "createTime": { "type": "string", "readOnly": true, "description": "Output only. Timestamp when this NotebookExecutionJob was created.", "format": "google-datetime" }, "executionUser": { "description": "The user email to run the execution as. Only supported by Colab runtimes.", "type": "string" }, "gcsNotebookSource": { "description": "The Cloud Storage url pointing to the ipynb file. Format: `gs://bucket/notebook_file.ipynb`", "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobGcsNotebookSource" }, "gcsOutputUri": { "type": "string", "description": "The Cloud Storage location to upload the result to. Format: `gs://bucket-name`" }, "dataformRepositorySource": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobDataformRepositorySource", "description": "The Dataform Repository pointing to a single file notebook repository." }, "name": { "description": "Output only. The resource name of this NotebookExecutionJob. Format: `projects/{project_id}/locations/{location}/notebookExecutionJobs/{job_id}`", "type": "string", "readOnly": true }, "displayName": { "description": "The display name of the NotebookExecutionJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "executionTimeout": { "format": "google-duration", "type": "string", "description": "Max running time of the execution job in seconds (default 86400s / 24 hrs)." }, "updateTime": { "readOnly": true, "type": "string", "description": "Output only. Timestamp when this NotebookExecutionJob was most recently updated.", "format": "google-datetime" }, "status": { "$ref": "GoogleRpcStatus", "readOnly": true, "description": "Output only. Populated when the NotebookExecutionJob is completed. When there is an error during notebook execution, the error details are populated." }, "directNotebookSource": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobDirectNotebookSource", "description": "The contents of an input notebook file." }, "scheduleResourceName": { "type": "string", "description": "The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}`" }, "serviceAccount": { "description": "The service account to run the execution as.", "type": "string" }, "customEnvironmentSpec": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpec", "description": "The custom compute configuration for an execution job." }, "kernelName": { "type": "string", "description": "The name of the kernel to use during notebook execution. If unset, the default kernel is used." }, "notebookRuntimeTemplateResourceName": { "description": "The NotebookRuntimeTemplate to source compute configuration from.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJob", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetail": { "type": "object", "description": "Represent the execution details of the job.", "properties": { "objectiveStatus": { "description": "Status of data processing for each monitoring objective. Key is the objective.", "type": "object", "additionalProperties": { "$ref": "GoogleRpcStatus" } }, "error": { "$ref": "GoogleRpcStatus", "description": "Additional job error status." }, "baselineDatasets": { "type": "array", "description": "Processed baseline datasets.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetailProcessedDataset" } }, "targetDatasets": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetailProcessedDataset" }, "description": "Processed target datasets.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetail" }, "GoogleTypeMoney": { "properties": { "currencyCode": { "type": "string", "description": "The three-letter currency code defined in ISO 4217." }, "nanos": { "format": "int32", "description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", "type": "integer" }, "units": { "format": "int64", "description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", "type": "string" } }, "description": "Represents an amount of money with its currency type.", "type": "object", "id": "GoogleTypeMoney" }, "GoogleCloudAiplatformV1beta1AsyncRetrieveContextsRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1AsyncRetrieveContextsRequest", "description": "Request message for VertexRagService.AsyncRetrieveContexts.", "properties": { "query": { "description": "Required. Single RAG retrieve query.", "$ref": "GoogleCloudAiplatformV1beta1RagQuery" }, "tools": { "type": "array", "description": "Optional. The tools to use for AskContexts.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } } } }, "GoogleCloudAiplatformV1beta1ToolGoogleSearch": { "id": "GoogleCloudAiplatformV1beta1ToolGoogleSearch", "properties": { "searchTypes": { "description": "Optional. The set of search types to enable. If not set, web search is enabled by default.", "$ref": "GoogleCloudAiplatformV1beta1ToolGoogleSearchSearchTypes" }, "blockingConfidence": { "enum": [ "PHISH_BLOCK_THRESHOLD_UNSPECIFIED", "BLOCK_LOW_AND_ABOVE", "BLOCK_MEDIUM_AND_ABOVE", "BLOCK_HIGH_AND_ABOVE", "BLOCK_HIGHER_AND_ABOVE", "BLOCK_VERY_HIGH_AND_ABOVE", "BLOCK_ONLY_EXTREMELY_HIGH" ], "type": "string", "enumDescriptions": [ "Defaults to unspecified.", "Blocks Low and above confidence URL that is risky.", "Blocks Medium and above confidence URL that is risky.", "Blocks High and above confidence URL that is risky.", "Blocks Higher and above confidence URL that is risky.", "Blocks Very high and above confidence URL that is risky.", "Blocks Extremely high confidence URL that is risky." ], "description": "Optional. Sites with confidence level chosen & above this value will be blocked from the search results." }, "excludeDomains": { "items": { "type": "string" }, "type": "array", "description": "Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: [\"amazon.com\", \"facebook.com\"]." } }, "description": "GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponseViewSummary": { "properties": { "anomalousSessionsCount": { "type": "integer", "description": "Number of anomalous sessions.", "format": "int32" }, "totalSessionsCount": { "type": "integer", "description": "Total number of sessions.", "format": "int32" }, "llmScannedSessionsCount": { "readOnly": true, "type": "integer", "format": "int32", "description": "Output only. The number of distinct sessions in the time window that were scanned by the LLM judge." }, "severities": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedSessionSeveritySummary" }, "description": "The list of severity summaries for the analyzed sessions. The key is the string representation of Severity enum: \"SEVERITY_UNSPECIFIED\", \"SEVERITY_CRITICAL\", \"SEVERITY_HIGH\", \"SEVERITY_MEDIUM\", \"SEVERITY_LOW\".", "type": "object" }, "anomalousAgentsCount": { "format": "int32", "readOnly": true, "description": "Output only. The number of distinct agents in the request scope with at least one anomalous session in the time window. On `AggregateAnalyzedSessionsResponse.summary` this is a global count; it is not populated on `ListAnalyzedSessionsResponse.summary`.", "type": "integer" } }, "type": "object", "description": "The view summary.", "id": "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponseViewSummary" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix", "properties": { "annotationSpecs": { "description": "AnnotationSpecs used in the confusion matrix. For AutoML Text Extraction, a special negative AnnotationSpec with empty `id` and `displayName` of \"NULL\" will be added as the last element.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrixAnnotationSpecRef" } }, "rows": { "type": "array", "items": { "items": { "type": "any" }, "type": "array" }, "description": "Rows in the confusion matrix. The number of rows is equal to the size of `annotationSpecs`. `rowsi` is the number of DataItems that have ground truth of the `annotationSpecs[i]` and are predicted as `annotationSpecs[j]` by the Model being evaluated. For Text Extraction, when `annotationSpecs[i]` is the last element in `annotationSpecs`, i.e. the special negative AnnotationSpec, `rowsi` is the number of predicted entities of `annoatationSpec[j]` that are not labeled as any of the ground truth AnnotationSpec. When annotationSpecs[j] is the special negative AnnotationSpec, `rowsi` is the number of entities have ground truth of `annotationSpec[i]` that are not predicted as an entity by the Model. The value of the last cell, i.e. `rowi` where i == j and `annotationSpec[i]` is the special negative AnnotationSpec, is always 0." } } }, "GoogleCloudAiplatformV1beta1PredictLongRunningResponse": { "type": "object", "description": "Response message for [PredictionService.PredictLongRunning]", "id": "GoogleCloudAiplatformV1beta1PredictLongRunningResponse", "properties": { "generateVideoResponse": { "description": "The response of the video generation prediction.", "$ref": "GoogleCloudAiplatformV1beta1GenerateVideoResponse" } } }, "CloudAiLargeModelsVisionGenerateVideoExperimentsProEditConfig": { "type": "object", "description": "Configuration for Pro Edit.", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsProEditConfig", "properties": { "editInstructionPrompt": { "description": "A text string containing the user's edit instruction. Will be applied to the original URF.", "type": "string" }, "structuredPrompt": { "description": "A JSON string containing the user's modified URF. The URF Editing Preamble will diff this against the original URF to determine what changed.", "type": "string" }, "fromOperationId": { "description": "Required. The operation_id from a previous omni-cine generation whose OF and URF should be retrieved for editing.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ActiveLearningConfig": { "properties": { "maxDataItemPercentage": { "description": "Max percent of total DataItems for human labeling.", "type": "integer", "format": "int32" }, "trainingConfig": { "description": "CMLE training config. For every active learning labeling iteration, system will train a machine learning model on CMLE. The trained model will be used by data sampling algorithm to select DataItems.", "$ref": "GoogleCloudAiplatformV1beta1TrainingConfig" }, "maxDataItemCount": { "description": "Max number of human labeled DataItems.", "format": "int64", "type": "string" }, "sampleConfig": { "$ref": "GoogleCloudAiplatformV1beta1SampleConfig", "description": "Active learning data sampling config. For every active learning labeling iteration, it will select a batch of data based on the sampling strategy." } }, "id": "GoogleCloudAiplatformV1beta1ActiveLearningConfig", "description": "Parameters that configure the active learning pipeline. Active learning will label the data incrementally by several iterations. For every iteration, it will select a batch of data based on the sampling strategy.", "type": "object" }, "GoogleCloudAiplatformV1beta1DeployedIndexRef": { "properties": { "indexEndpoint": { "type": "string", "description": "Immutable. A resource name of the IndexEndpoint." }, "deployedIndexId": { "type": "string", "description": "Immutable. The ID of the DeployedIndex in the above IndexEndpoint." }, "displayName": { "description": "Output only. The display name of the DeployedIndex.", "type": "string", "readOnly": true } }, "description": "Points to a DeployedIndex.", "id": "GoogleCloudAiplatformV1beta1DeployedIndexRef", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationNumericTransformation": { "description": "Training pipeline will perform following transformation functions. * The value converted to float32. * The z_score of the value. * log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * z_score of log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value.", "properties": { "columnName": { "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationNumericTransformation" }, "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput": { "id": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput", "description": "Input for pairwise question answering quality metric.", "properties": { "metricSpec": { "description": "Required. Spec for pairwise question answering quality score metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualitySpec" }, "instance": { "description": "Required. Pairwise question answering quality instance.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInstance" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfigUserSimulatorConfig": { "properties": { "maxTurn": { "type": "integer", "format": "int32", "description": "Maximum number of invocations allowed by the multi-turn agent scraping. This property allows us to stop a run-off conversation, where the agent and the user simulator get into a never ending loop. The initial fixed prompt is also counted as an invocation." }, "modelName": { "type": "string", "description": "The model name to use for multi-turn agent scraping to get next user message, e.g. \"gemini-3-flash-preview\"." }, "modelConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig", "description": "The configuration for the model." } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentRunConfigUserSimulatorConfig", "description": "Used for multi-turn agent scraping. Contains configuration for a user simulator that uses an LLM to generate messages on behalf of the user.", "type": "object" }, "GoogleCloudAiplatformV1beta1MigratableResourceMlEngineModelVersion": { "description": "Represents one model Version in ml.googleapis.com.", "properties": { "endpoint": { "type": "string", "description": "The ml.googleapis.com endpoint that this model Version currently lives in. Example values: * ml.googleapis.com * us-centrall-ml.googleapis.com * europe-west4-ml.googleapis.com * asia-east1-ml.googleapis.com" }, "version": { "description": "Full resource name of ml engine model Version. Format: `projects/{project}/models/{model}/versions/{version}`.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MigratableResourceMlEngineModelVersion" }, "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardResponse", "properties": { "rewardInfoDetails": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningRewardInfo" }, "description": "A map from reward name to reward info.", "type": "object" }, "errorStatus": { "readOnly": true, "description": "Output only. In case of an error, this field will be populated with a detailed error message for overall rewards to help with debugging.", "$ref": "GoogleRpcStatus" }, "error": { "readOnly": true, "deprecated": true, "description": "Output only. Deprecated: Use error_status instead. In case of an error, this field will be populated with a detailed error message to help with debugging.", "type": "string" }, "overallReward": { "readOnly": true, "type": "number", "format": "float", "description": "Output only. The overall weighted reward. For a CompositeReinforcementTuningRewardConfig, this is the weighted average of all rewards. For a SingleReinforcementTuningRewardConfig, this will be the value of the single reward." }, "rewardDetails": { "deprecated": true, "additionalProperties": { "type": "number", "format": "float" }, "readOnly": true, "type": "object", "description": "Output only. Deprecated: Use reward_info_details instead. A map from reward name to the calculated reward for the reward function. This field will only be populated when a CompositeReinforcementTuningRewardConfig is provided in the request. It will not be set for a SingleReinforcementTuningRewardConfig." } }, "description": "Response message for GenAiTuningService.ValidateReinforcementTuningReward." }, "GoogleCloudAiplatformV1beta1FunctionResponse": { "properties": { "response": { "description": "Required. The function response in JSON object format. Use \"output\" key to specify function output and \"error\" key to specify error details (if any). If \"output\" and \"error\" keys are not specified, then whole \"response\" is treated as function output.", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" }, "parts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FunctionResponsePart" }, "description": "Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types." }, "scheduling": { "enum": [ "SCHEDULING_UNSPECIFIED", "SILENT", "WHEN_IDLE", "INTERRUPT" ], "description": "Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE.", "type": "string", "enumDescriptions": [ "This value is unused.", "Only add the result to the conversation context, do not interrupt or trigger generation.", "Add the result to the conversation context, and prompt to generate output without interrupting ongoing generation.", "Add the result to the conversation context, interrupt ongoing generation and prompt to generate output." ] }, "id": { "description": "Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`.", "type": "string" }, "name": { "description": "Required. The name of the function to call. Matches FunctionDeclaration.name and FunctionCall.name.", "type": "string" } }, "type": "object", "description": "The result output from a FunctionCall that contains a string representing the FunctionDeclaration.name and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a `FunctionCall` made based on model prediction.", "id": "GoogleCloudAiplatformV1beta1FunctionResponse" }, "GoogleCloudAiplatformV1beta1UndeployModelOperationMetadata": { "description": "Runtime operation information for EndpointService.UndeployModel.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UndeployModelOperationMetadata" }, "GoogleCloudAiplatformV1beta1RagFileTransformationConfig": { "type": "object", "description": "Specifies the transformation config for RagFiles.", "id": "GoogleCloudAiplatformV1beta1RagFileTransformationConfig", "properties": { "ragFileChunkingConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "description": "Specifies the chunking config for RagFiles." } } }, "GoogleIamV1GetIamPolicyRequest": { "id": "GoogleIamV1GetIamPolicyRequest", "description": "Request message for `GetIamPolicy` method.", "properties": { "options": { "description": "OPTIONAL: A `GetPolicyOptions` object for specifying options to `GetIamPolicy`.", "$ref": "GoogleIamV1GetPolicyOptions" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AuthConfigApiKeyConfig": { "properties": { "apiKeyString": { "description": "Optional. The API key to be used in the request directly.", "type": "string" }, "apiKeySecret": { "type": "string", "description": "Optional. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If both `api_key_secret` and `api_key_string` are specified, this field takes precedence over `api_key_string`. - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource." }, "name": { "description": "Optional. The parameter name of the API key. E.g. If the API request is \"https://example.com/act?api_key=\", \"api_key\" would be the parameter name.", "type": "string" }, "httpElementLocation": { "enumDescriptions": [ "", "Element is in the HTTP request query.", "Element is in the HTTP request header.", "Element is in the HTTP request path.", "Element is in the HTTP request body.", "Element is in the HTTP request cookie." ], "enum": [ "HTTP_IN_UNSPECIFIED", "HTTP_IN_QUERY", "HTTP_IN_HEADER", "HTTP_IN_PATH", "HTTP_IN_BODY", "HTTP_IN_COOKIE" ], "type": "string", "description": "Optional. The location of the API key." } }, "id": "GoogleCloudAiplatformV1beta1AuthConfigApiKeyConfig", "type": "object", "description": "Config for authentication with API key." }, "GoogleCloudAiplatformV1beta1BatchCreateRagDataSchemasRequest": { "properties": { "requests": { "description": "Required. The request messages for VertexRagDataService.CreateRagDataSchema. A maximum of 500 schemas can be created in a batch.", "items": { "$ref": "GoogleCloudAiplatformV1beta1CreateRagDataSchemaRequest" }, "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchCreateRagDataSchemasRequest", "description": "Request message for VertexRagDataService.BatchCreateRagDataSchemas." }, "GoogleCloudAiplatformV1beta1RuntimeConfigCodeInterpreterRuntimeConfig": { "type": "object", "properties": { "fileInputGcsBucket": { "type": "string", "description": "Optional. The Cloud Storage bucket for file input of this Extension. If specified, support input from the Cloud Storage bucket. Vertex Extension Custom Code Service Agent should be granted file reader to this bucket. If not specified, the extension will only accept file contents from request body and reject Cloud Storage file inputs." }, "fileOutputGcsBucket": { "description": "Optional. The Cloud Storage bucket for file output of this Extension. If specified, write all output files to the Cloud Storage bucket. Vertex Extension Custom Code Service Agent should be granted file writer to this bucket. If not specified, the file content will be output in response body.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RuntimeConfigCodeInterpreterRuntimeConfig" }, "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDatasetDataLabelingAnnotatedDataset": { "properties": { "annotatedDatasetDisplayName": { "type": "string", "description": "The AnnotatedDataset's display name in datalabeling.googleapis.com." }, "annotatedDataset": { "type": "string", "description": "Full resource name of data labeling AnnotatedDataset. Format: `projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}`." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MigratableResourceDataLabelingDatasetDataLabelingAnnotatedDataset", "description": "Represents one AnnotatedDataset in datalabeling.googleapis.com." }, "GoogleCloudAiplatformV1beta1GeminiPreferenceExampleCompletion": { "description": "Completion and its preference score.", "type": "object", "id": "GoogleCloudAiplatformV1beta1GeminiPreferenceExampleCompletion", "properties": { "score": { "type": "number", "format": "float", "description": "The score for the given completion." }, "completion": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Single turn completion for the given prompt." } } }, "GoogleCloudAiplatformV1beta1ExternalApiElasticSearchParams": { "description": "The search parameters to use for the ELASTIC_SEARCH spec.", "properties": { "searchTemplate": { "description": "The ElasticSearch search template to use.", "type": "string" }, "numHits": { "format": "int32", "description": "Optional. Number of hits (chunks) to request. When specified, it is passed to Elasticsearch as the `num_hits` param.", "type": "integer" }, "index": { "type": "string", "description": "The ElasticSearch index to use." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ExternalApiElasticSearchParams" }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSourceEvent": { "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSourceEvent", "type": "object", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. A single piece of content from which to generate memories." } }, "description": "A single piece of conversation from which to generate memories." }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecContainerSpec": { "description": "Specification for deploying from a container image.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecContainerSpec", "properties": { "port": { "description": "Optional. The port the container listens on. Defaults to 8080 if unset.", "type": "integer", "format": "int32" }, "imageUri": { "description": "Required. The Artifact Registry Docker image URI (e.g., us-central1-docker.pkg.dev/my-project/my-repo/my-image:tag) of the container image that is to be run on each worker replica.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigArtifactList": { "id": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigArtifactList", "properties": { "artifacts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1RuntimeArtifact" }, "description": "Optional. A list of artifact metadata.", "type": "array" } }, "type": "object", "description": "A list of artifact metadata." }, "GoogleCloudAiplatformV1beta1CreateEndpointOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateEndpointOperationMetadata", "description": "Runtime operation information for EndpointService.CreateEndpoint.", "properties": { "deploymentStage": { "readOnly": true, "enum": [ "DEPLOYMENT_STAGE_UNSPECIFIED", "STARTING_DEPLOYMENT", "PREPARING_MODEL", "CREATING_SERVING_CLUSTER", "ADDING_NODES_TO_CLUSTER", "GETTING_CONTAINER_IMAGE", "STARTING_MODEL_SERVER", "FINISHING_UP", "DEPLOYMENT_TERMINATED", "SUCCESSFULLY_DEPLOYED", "FAILED_TO_DEPLOY" ], "description": "Output only. The deployment stage of the model. Only populated if this CreateEndpoint request deploys a model at the same time.", "enumDescriptions": [ "Default value. This value is unused.", "The deployment is initializing and setting up the environment.", "The deployment is preparing the model assets.", "The deployment is creating the underlying serving cluster.", "The deployment is adding nodes to the serving cluster.", "The deployment is getting the container image for the model server.", "The deployment is starting the model server.", "The deployment is performing finalization steps.", "The deployment has terminated.", "The deployment has succeeded.", "The deployment has failed." ], "type": "string" }, "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesRequest": { "id": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesRequest", "type": "object", "properties": { "requests": { "type": "array", "description": "Required. The request message specifying the TensorboardTimeSeries to create. A maximum of 1000 TensorboardTimeSeries can be created in a batch.", "items": { "$ref": "GoogleCloudAiplatformV1beta1CreateTensorboardTimeSeriesRequest" } } }, "description": "Request message for TensorboardService.BatchCreateTensorboardTimeSeries." }, "GoogleCloudAiplatformV1beta1AuthConfigHttpBasicAuthConfig": { "properties": { "credentialSecret": { "type": "string", "description": "Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource." } }, "description": "Config for HTTP Basic Authentication.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AuthConfigHttpBasicAuthConfig" }, "GoogleCloudAiplatformV1beta1ImportDataOperationMetadata": { "description": "Runtime operation information for DatasetService.ImportData.", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportDataOperationMetadata" }, "GoogleCloudAiplatformV1beta1DirectPredictRequest": { "id": "GoogleCloudAiplatformV1beta1DirectPredictRequest", "type": "object", "description": "Request message for PredictionService.DirectPredict.", "properties": { "parameters": { "description": "The parameters that govern the prediction.", "$ref": "GoogleCloudAiplatformV1beta1Tensor" }, "inputs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" }, "type": "array", "description": "The prediction input." } } }, "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfig": { "description": "The Evalution configuration used for the evaluation run.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfig", "properties": { "rubricConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRubricConfig" }, "description": "Optional. The rubric configs for the evaluation run. They are used to generate rubrics which can be used by rubric-based metrics. Multiple rubric configs can be specified for rubric generation but only one rubric config can be used for a rubric-based metric. If more than one rubric config is provided, the evaluation metric must specify a rubric group key. Note that if a generation spec is specified on both a rubric config and an evaluation metric, the rubrics generated for the metric will be used for evaluation.", "type": "array" }, "autoraterConfig": { "description": "Optional. The autorater config for the evaluation run.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig" }, "outputConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigOutputConfig", "description": "Optional. The output config for the evaluation run." }, "promptTemplate": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigPromptTemplate", "description": "The prompt template used for inference. The values for variables in the prompt template are defined in EvaluationItem.EvaluationPrompt.PromptTemplateData.values." }, "cloudLoggingConfig": { "$ref": "GoogleCloudAiplatformV1beta1CloudLoggingConfig", "description": "Optional. Configuration for exporting evaluation results to Cloud Logging." }, "lossAnalysisConfig": { "type": "array", "description": "Optional. Specifications for loss analysis. Each config can be specified for one metric.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LossAnalysisConfig" } }, "datasetCustomMetrics": { "description": "Optional. Specifications for custom dataset-level aggregations.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DatasetCustomMetric" } }, "metrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetric" }, "description": "Optional. The metrics to be calculated in the evaluation run. Required when analysis_configs is not set.", "type": "array" }, "allowCrossRegionModel": { "description": "Optional. Allows the evaluation run to use cross region models. When this flag is set, the service may route traffic to other regions if a model is unavailable in the current region (e.g., to a `global` endpoint). If a fully-qualified model endpoint resource name with a different region than the run location is provided elsewhere in the run config, this flag must be set to true or the request will fail.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EventMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EventMetadata", "properties": { "branch": { "type": "string", "description": "Optional. The branch of the event. The format is like agent_1.agent_2.agent_3, where agent_1 is the parent of agent_2, and agent_2 is the parent of agent_3. Branch is used when multiple child agents shouldn't see their siblings' conversation history." }, "partial": { "type": "boolean", "description": "Optional. Indicates whether the text content is part of a unfinished text stream. Only used for streaming mode and when the content is plain text." }, "customMetadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "The custom metadata of the LlmResponse." }, "longRunningToolIds": { "description": "Optional. Set of ids of the long running function calls. Agent client will know from this field about which function call is long running. Only valid for function call event.", "items": { "type": "string" }, "type": "array" }, "interrupted": { "description": "Optional. Flag indicating that LLM was interrupted when generating the content. Usually it's due to user interruption during a bidi streaming.", "type": "boolean" }, "outputTranscription": { "$ref": "GoogleCloudAiplatformV1beta1Transcription", "description": "Optional. Audio transcription of model output." }, "groundingMetadata": { "description": "Optional. Metadata returned to client when grounding is enabled.", "$ref": "GoogleCloudAiplatformV1beta1GroundingMetadata" }, "turnComplete": { "type": "boolean", "description": "Optional. Indicates whether the response from the model is complete. Only used for streaming mode." }, "inputTranscription": { "description": "Optional. Audio transcription of user input.", "$ref": "GoogleCloudAiplatformV1beta1Transcription" } }, "description": "Metadata relating to a LLM response event." }, "GenaiVertexV1beta1TextAnnotationDelta": { "type": "object", "id": "GenaiVertexV1beta1TextAnnotationDelta", "properties": { "annotations": { "items": { "$ref": "GenaiVertexV1beta1TextContentAnnotation" }, "type": "array", "description": "Citation information for model-generated content." } } }, "GenaiVertexV1beta1RagStoreConfig": { "type": "object", "properties": { "ragRetrievalConfig": { "$ref": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfig", "description": "Optional. The retrieval config for the Rag query." }, "ragResources": { "description": "Optional. The representation of the rag source.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1RagStoreConfigRagResource" } }, "similarityTopK": { "format": "int32", "description": "Optional. Number of top k results to return from the selected corpora.", "type": "integer", "deprecated": true }, "vectorDistanceThreshold": { "deprecated": true, "description": "Optional. Only return results with vector distance smaller than the threshold.", "format": "double", "type": "number" } }, "description": "Use to specify configuration for RAG Store.", "id": "GenaiVertexV1beta1RagStoreConfig" }, "GoogleCloudAiplatformV1beta1ModelMonitoringSpec": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringSpec", "type": "object", "properties": { "objectiveSpec": { "description": "The monitoring objective spec.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpec" }, "notificationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpec", "description": "The model monitoring notification spec." }, "outputSpec": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringOutputSpec", "description": "The Output destination spec for metrics, error logs, etc." } }, "description": "Monitoring monitoring job spec. It outlines the specifications for monitoring objectives, notifications, and result exports." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsForecastingEvaluationMetricsQuantileMetricsEntry": { "type": "object", "properties": { "scaledPinballLoss": { "description": "The scaled pinball loss of this quantile.", "format": "float", "type": "number" }, "observedQuantile": { "description": "This is a custom metric that calculates the percentage of true values that were less than the predicted value for that quantile. Only populated when optimization_objective is minimize-quantile-loss and each entry corresponds to an entry in quantiles The percent value can be used to compare with the quantile value, which is the target value.", "type": "number", "format": "double" }, "quantile": { "type": "number", "description": "The quantile for this entry.", "format": "double" } }, "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsForecastingEvaluationMetricsQuantileMetricsEntry", "description": "Entry for the Quantiles loss type optimization objective." }, "GoogleCloudAiplatformV1beta1EmbedContentRequest": { "id": "GoogleCloudAiplatformV1beta1EmbedContentRequest", "properties": { "autoTruncate": { "deprecated": true, "type": "boolean", "description": "Optional. Deprecated: Please use EmbedContentConfig.auto_truncate instead. Whether to silently truncate the input content if it's longer than the maximum sequence length." }, "title": { "description": "Optional. Deprecated: Please use EmbedContentConfig.title instead. The title for the text.", "deprecated": true, "type": "string" }, "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. The content to be embedded." }, "outputDimensionality": { "format": "int32", "type": "integer", "description": "Optional. Deprecated: Please use EmbedContentConfig.output_dimensionality instead. Reduced dimension for the output embedding. If set, excessive values in the output embedding are truncated from the end.", "deprecated": true }, "embedContentConfig": { "description": "Optional. Configuration for the EmbedContent request.", "$ref": "GoogleCloudAiplatformV1beta1EmbedContentRequestEmbedContentConfig" }, "taskType": { "type": "string", "enumDescriptions": [ "Unset value, which will default to one of the other enum values.", "Specifies the given text is a query in a search/retrieval setting.", "Specifies the given text is a document from the corpus being searched.", "Specifies the given text will be used for STS.", "Specifies that the given text will be classified.", "Specifies that the embeddings will be used for clustering.", "Specifies that the embeddings will be used for question answering.", "Specifies that the embeddings will be used for fact verification.", "Specifies that the embeddings will be used for code retrieval." ], "deprecated": true, "enum": [ "UNSPECIFIED", "RETRIEVAL_QUERY", "RETRIEVAL_DOCUMENT", "SEMANTIC_SIMILARITY", "CLASSIFICATION", "CLUSTERING", "QUESTION_ANSWERING", "FACT_VERIFICATION", "CODE_RETRIEVAL_QUERY" ], "description": "Optional. Deprecated: Please use EmbedContentConfig.task_type instead. The task type of the embedding." } }, "type": "object", "description": "Request message for PredictionService.EmbedContent." }, "GoogleCloudAiplatformV1beta1ScheduleRunResponse": { "properties": { "scheduledRunTime": { "format": "google-datetime", "description": "The scheduled run time based on the user-specified schedule.", "type": "string" }, "runResponse": { "type": "string", "description": "The response of the scheduled run." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ScheduleRunResponse", "description": "Status of a scheduled run." }, "GoogleCloudAiplatformV1beta1PointwiseMetricInput": { "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricSpec", "description": "Required. Spec for pointwise metric." }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricInstance", "description": "Required. Pointwise metric instance." } }, "type": "object", "description": "Input for pointwise metric.", "id": "GoogleCloudAiplatformV1beta1PointwiseMetricInput" }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableBigtableMetadata": { "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableBigtableMetadata", "properties": { "instanceId": { "type": "string", "description": "The Cloud Bigtable instance id." }, "tableId": { "description": "The Cloud Bigtable table id.", "type": "string" }, "tenantProjectId": { "type": "string", "description": "Tenant project ID." } }, "description": "Metadata of the Bigtable instance. This is used by direct read access to the Bigtable in tenant project.", "type": "object" }, "GoogleCloudAiplatformV1beta1SlackSourceSlackChannels": { "description": "SlackChannels contains the Slack channels and corresponding access token.", "properties": { "apiKeyConfig": { "description": "Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Slack channel access token that has access to the slack channel IDs. See: https://api.slack.com/tutorials/tracks/getting-a-token.", "$ref": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig" }, "channels": { "type": "array", "description": "Required. The Slack channel IDs.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SlackSourceSlackChannelsSlackChannel" } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SlackSourceSlackChannels" }, "GenaiVertexV1beta1ThoughtSignatureDelta": { "properties": { "signature": { "description": "Signature to match the backend source to be part of the generation.", "format": "byte", "type": "string" } }, "id": "GenaiVertexV1beta1ThoughtSignatureDelta", "type": "object" }, "GoogleCloudAiplatformV1beta1BigQueryRequestSet": { "properties": { "candidateResponseColumns": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. Map of candidate name to candidate response column name. The column will be in evaluation_item.CandidateResponse format." }, "uri": { "type": "string", "description": "Required. The URI of a BigQuery table. e.g. bq://projectId.bqDatasetId.bqTableId" }, "samplingConfig": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryRequestSetSamplingConfig", "description": "Optional. The sampling config for the bigquery resource." }, "rubricsColumn": { "description": "Optional. The name of the column that contains the rubrics. This is in evaluation_rubric.RubricGroup format.", "type": "string" }, "promptColumn": { "type": "string", "description": "Optional. The name of the column that contains the requests to evaluate. This will be in evaluation_item.EvalPrompt format." } }, "description": "The request set for the evaluation run.", "type": "object", "id": "GoogleCloudAiplatformV1beta1BigQueryRequestSet" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationExample": { "type": "object", "description": "The translation example that contains reference sentences from various sources.", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationExample", "properties": { "referenceSentencePairLists": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePairList" }, "description": "The reference sentences from inline text.", "type": "array" }, "referenceSentencesFileInputs": { "description": "The reference sentences from file.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationSentenceFileInput" } } } }, "GoogleCloudAiplatformV1beta1DatasetVersion": { "id": "GoogleCloudAiplatformV1beta1DatasetVersion", "description": "Describes the dataset version.", "properties": { "updateTime": { "description": "Output only. Timestamp when this DatasetVersion was last updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "bigQueryDatasetName": { "description": "Output only. Name of the associated BigQuery dataset.", "type": "string", "readOnly": true }, "etag": { "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Timestamp when this DatasetVersion was created.", "format": "google-datetime" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Identifier. The resource name of the DatasetVersion. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`" }, "modelReference": { "description": "Output only. Reference to the public base model last used by the dataset version. Only set for prompt dataset versions.", "type": "string", "readOnly": true }, "satisfiesPzs": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "metadata": { "readOnly": true, "description": "Required. Output only. Additional information about the DatasetVersion.", "type": "any" }, "displayName": { "type": "string", "description": "The user-defined name of the DatasetVersion. The name can be up to 128 characters long and can consist of any UTF-8 characters." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig": { "type": "object", "properties": { "generationConfig": { "description": "Optional. Configuration options for model generation and outputs.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" }, "sampleCount": { "format": "int32", "type": "integer", "description": "Optional. Number of samples for each instance in the dataset. If not specified, the default is 4. Minimum value is 1, maximum value is 32." }, "autoraterModel": { "description": "Optional. The fully qualified name of the publisher model or tuned autorater endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig", "description": "The autorater config used for the evaluation run." }, "GoogleCloudAiplatformV1beta1RetrieveSkillsResponseRetrievedSkill": { "properties": { "description": { "description": "The skill description.", "type": "string" }, "skillName": { "description": "The skill resource name. Format: projects/{project}/locations/{location}/skills/{skill}", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RetrieveSkillsResponseRetrievedSkill", "type": "object", "description": "A retrieved skill." }, "GoogleCloudAiplatformV1beta1EvaluationParserConfig": { "id": "GoogleCloudAiplatformV1beta1EvaluationParserConfig", "description": "Config for parsing LLM responses. It can be used to parse the LLM response to be evaluated, or the LLM response from LLM-based metrics/Autoraters.", "properties": { "customCodeParserConfig": { "description": "Optional. Use custom code to parse the LLM response.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationParserConfigCustomCodeParserConfig" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSource", "description": "Defines a direct source of memories that should be uploaded to Memory Bank with consolidation.", "properties": { "directMemories": { "type": "array", "description": "Required. The direct memories to upload to Memory Bank. At most 5 direct memories are allowed per request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectMemoriesSourceDirectMemory" } } } }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpec": { "properties": { "memoryBankConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfig", "description": "Optional. Specification for a Memory Bank, which manages memories for the Agent Engine." } }, "description": "Configuration for how Agent Engine sub-resources should manage context.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpec" }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityViewData": { "properties": { "value": { "description": "Feature value if a single value is requested.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValue" }, "values": { "description": "Feature values list if values, successive in time, are requested. If the requested number of values is greater than the number of existing Feature values, nonexistent values are omitted instead of being returned as empty.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValueList" } }, "description": "Container to hold value(s), successive in time, for one Feature from the request.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseEntityViewData" }, "GoogleCloudAiplatformV1beta1Scheduling": { "type": "object", "description": "All parameters related to queuing and scheduling of custom jobs.", "id": "GoogleCloudAiplatformV1beta1Scheduling", "properties": { "timeout": { "format": "google-duration", "description": "Optional. The maximum job running time. The default is 7 days.", "type": "string" }, "strategy": { "enumDescriptions": [ "Strategy will default to STANDARD.", "Deprecated. Regular on-demand provisioning strategy.", "Deprecated. Low cost by making potential use of spot resources.", "Standard provisioning strategy uses regular on-demand resources.", "Spot provisioning strategy uses spot resources.", "Flex Start strategy uses DWS to queue for resources." ], "type": "string", "description": "Optional. This determines which type of scheduling strategy to use.", "enumDeprecated": [ false, true, true, false, false, false ], "enum": [ "STRATEGY_UNSPECIFIED", "ON_DEMAND", "LOW_COST", "STANDARD", "SPOT", "FLEX_START" ] }, "restartJobOnWorkerRestart": { "type": "boolean", "description": "Optional. Restarts the entire CustomJob if a worker gets restarted. This feature can be used by distributed training jobs that are not resilient to workers leaving and joining a job." }, "disableRetries": { "type": "boolean", "description": "Optional. Indicates if the job should retry for internal errors after the job starts running. If true, overrides `Scheduling.restart_job_on_worker_restart` to false." }, "maxWaitDuration": { "type": "string", "format": "google-duration", "description": "Optional. This is the maximum duration that a job will wait for the requested resources to be provisioned if the scheduling strategy is set to [Strategy.DWS_FLEX_START]. If set to 0, the job will wait indefinitely. The default is 24 hours." } } }, "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate": { "properties": { "displayName": { "description": "Required. The display name of the NotebookRuntimeTemplate. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "isDefault": { "description": "Output only. Deprecated: This field has no behavior. Use notebook_runtime_type = 'ONE_CLICK' instead. The default template to use if not specified.", "readOnly": true, "deprecated": true, "type": "boolean" }, "reservationAffinity": { "description": "Optional. Reservation Affinity of the notebook runtime template.", "$ref": "GoogleCloudAiplatformV1beta1NotebookReservationAffinity" }, "serviceAccount": { "description": "Deprecated: This field is ignored and the \"Vertex AI Notebook Service Account\" (service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com) is used for the runtime workload identity. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-notebook-service-account for more details. For NotebookExecutionJob, use NotebookExecutionJob.service_account instead. The service account that the runtime workload runs as. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the [Compute Engine default service account](https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) is used.", "type": "string", "deprecated": true }, "dataPersistentDiskSpec": { "description": "Optional. The specification of persistent disk attached to the runtime as data disk storage.", "$ref": "GoogleCloudAiplatformV1beta1PersistentDiskSpec" }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when this NotebookRuntimeTemplate was most recently updated." }, "description": { "type": "string", "description": "The description of the NotebookRuntimeTemplate." }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key spec for the notebook runtime." }, "createTime": { "readOnly": true, "description": "Output only. Timestamp when this NotebookRuntimeTemplate was created.", "format": "google-datetime", "type": "string" }, "networkTags": { "items": { "type": "string" }, "type": "array", "description": "Optional. The Compute Engine tags to add to runtime (see [Tagging instances](https://cloud.google.com/vpc/docs/add-remove-network-tags))." }, "networkSpec": { "$ref": "GoogleCloudAiplatformV1beta1NetworkSpec", "description": "Optional. Network spec." }, "notebookRuntimeType": { "description": "Optional. Immutable. The type of the notebook runtime template.", "type": "string", "enumDescriptions": [ "Unspecified notebook runtime type, NotebookRuntimeType will default to USER_DEFINED.", "runtime or template with coustomized configurations from user.", "runtime or template with system defined configurations." ], "enum": [ "NOTEBOOK_RUNTIME_TYPE_UNSPECIFIED", "USER_DEFINED", "ONE_CLICK" ] }, "name": { "description": "The resource name of the NotebookRuntimeTemplate.", "type": "string" }, "idleShutdownConfig": { "$ref": "GoogleCloudAiplatformV1beta1NotebookIdleShutdownConfig", "description": "The idle shutdown configuration of NotebookRuntimeTemplate. This config will only be set when idle shutdown is enabled." }, "etag": { "type": "string", "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "softwareConfig": { "$ref": "GoogleCloudAiplatformV1beta1NotebookSoftwareConfig", "description": "Optional. The notebook software configuration of the notebook runtime." }, "shieldedVmConfig": { "$ref": "GoogleCloudAiplatformV1beta1ShieldedVmConfig", "description": "Optional. Immutable. Runtime Shielded VM spec." }, "machineSpec": { "description": "Optional. Immutable. The specification of a single machine for the template.", "$ref": "GoogleCloudAiplatformV1beta1MachineSpec" }, "labels": { "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize the NotebookRuntimeTemplates. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "type": "object" }, "eucConfig": { "$ref": "GoogleCloudAiplatformV1beta1NotebookEucConfig", "description": "EUC configuration of the NotebookRuntimeTemplate." } }, "id": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplate", "type": "object", "description": "A template that specifies runtime configurations such as machine type, runtime version, network configurations, etc. Multiple runtimes can be created from a runtime template." }, "GoogleCloudAiplatformV1beta1ComputeTokensRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ComputeTokensRequest", "properties": { "contents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Optional. Input content." }, "model": { "description": "Optional. The name of the publisher model requested to serve the prediction. Format: projects/{project}/locations/{location}/publishers/*/models/*", "type": "string" }, "instances": { "items": { "type": "any" }, "type": "array", "description": "Optional. The instances that are the input to token computing API call. Schema is identical to the prediction schema of the text model, even for the non-text models, like chat models, or Codey models." } }, "description": "Request message for ComputeTokens RPC call." }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource": { "type": "object", "properties": { "sourceArchive": { "description": "Required. Input only. The application source code archive. It must be a compressed tarball (.tar.gz) file.", "format": "byte", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource", "description": "Specifies source code provided as a byte stream." }, "GoogleCloudAiplatformV1beta1BatchMigrateResourcesResponse": { "description": "Response message for MigrationService.BatchMigrateResources.", "id": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesResponse", "properties": { "migrateResourceResponses": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceResponse" }, "type": "array", "description": "Successfully migrated resources." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ToolParameterKVMatchSpec": { "id": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchSpec", "properties": { "useStrictStringMatch": { "description": "Optional. Whether to use STRICT string match on parameter values.", "type": "boolean" } }, "type": "object", "description": "Spec for tool parameter key value match metric." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionMetadata": { "type": "object", "properties": { "costMilliNodeHours": { "type": "string", "format": "int64", "description": "The actual training cost of creating this model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed inputs.budgetMilliNodeHours." }, "successfulStopReason": { "type": "string", "enumDescriptions": [ "Should not be set.", "The inputs.budgetMilliNodeHours had been reached.", "Further training of the Model ceased to increase its quality, since it already has converged." ], "description": "For successful job completions, this is the reason why the job has finished.", "enum": [ "SUCCESSFUL_STOP_REASON_UNSPECIFIED", "BUDGET_REACHED", "MODEL_CONVERGED" ] } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageObjectDetectionMetadata" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationCategoricalTransformation": { "properties": { "columnName": { "type": "string" } }, "description": "Training pipeline will perform following transformation functions. * The categorical string as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index. * Categories that appear less than 5 times in the training dataset are treated as the \"unknown\" category. The \"unknown\" category gets its own special lookup index and resulting embedding.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationCategoricalTransformation" }, "GoogleCloudAiplatformV1beta1ResourceRuntime": { "type": "object", "description": "Persistent Cluster runtime information as output", "properties": { "accessUris": { "additionalProperties": { "type": "string" }, "description": "Output only. URIs for user to connect to the Cluster. Example: { \"RAY_HEAD_NODE_INTERNAL_IP\": \"head-node-IP:10001\" \"RAY_DASHBOARD_URI\": \"ray-dashboard-address:8888\" }", "type": "object", "readOnly": true }, "notebookRuntimeTemplate": { "type": "string", "description": "Output only. The resource name of NotebookRuntimeTemplate for the RoV Persistent Cluster The NotebokRuntimeTemplate is created in the same VPC (if set), and with the same Ray and Python version as the Persistent Cluster. Example: \"projects/1000/locations/us-central1/notebookRuntimeTemplates/abc123\"", "deprecated": true, "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1ResourceRuntime" }, "GoogleCloudAiplatformV1beta1StratifiedSplit": { "properties": { "trainingFraction": { "format": "double", "type": "number", "description": "The fraction of the input data that is to be used to train the Model." }, "testFraction": { "description": "The fraction of the input data that is to be used to evaluate the Model.", "type": "number", "format": "double" }, "validationFraction": { "format": "double", "description": "The fraction of the input data that is to be used to validate the Model.", "type": "number" }, "key": { "type": "string", "description": "Required. The key is a name of one of the Dataset's data columns. The key provided must be for a categorical column." } }, "description": "Assigns input data to the training, validation, and test sets so that the distribution of values found in the categorical column (as specified by the `key` field) is mirrored within each split. The fraction values determine the relative sizes of the splits. For example, if the specified column has three values, with 50% of the rows having value \"A\", 25% value \"B\", and 25% value \"C\", and the split fractions are specified as 80/10/10, then the training set will constitute 80% of the training data, with about 50% of the training set rows having the value \"A\" for the specified column, about 25% having the value \"B\", and about 25% having the value \"C\". Only the top 500 occurring values are used; any values not in the top 500 values are randomly assigned to a split. If less than three rows contain a specific value, those rows are randomly assigned. Supported only for tabular Datasets.", "type": "object", "id": "GoogleCloudAiplatformV1beta1StratifiedSplit" }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoObjectTrackingPredictionParams": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoObjectTrackingPredictionParams", "properties": { "confidenceThreshold": { "description": "The Model only returns predictions with at least this confidence score. Default value is 0.0", "format": "float", "type": "number" }, "minBoundingBoxSize": { "description": "Only bounding boxes with shortest edge at least that long as a relative value of video frame size are returned. Default value is 0.0.", "type": "number", "format": "float" }, "maxPredictions": { "description": "The model only returns up to that many top, by confidence score, predictions per frame of the video. If this number is very high, the Model may return fewer predictions per frame. Default value is 50.", "format": "int32", "type": "integer" } }, "description": "Prediction model parameters for Video Object Tracking." }, "GoogleCloudAiplatformV1beta1BatchPredictionJobInstanceConfig": { "type": "object", "properties": { "instanceType": { "type": "string", "description": "The format of the instance that the Model accepts. Vertex AI will convert compatible batch prediction input instance formats to the specified format. Supported values are: * `object`: Each input is converted to JSON object format. * For `bigquery`, each row is converted to an object. * For `jsonl`, each line of the JSONL input must be an object. * Does not apply to `csv`, `file-list`, `tf-record`, or `tf-record-gzip`. * `array`: Each input is converted to JSON array format. * For `bigquery`, each row is converted to an array. The order of columns is determined by the BigQuery column order, unless included_fields is populated. included_fields must be populated for specifying field orders. * For `jsonl`, if each line of the JSONL input is an object, included_fields must be populated for specifying field orders. * Does not apply to `csv`, `file-list`, `tf-record`, or `tf-record-gzip`. If not specified, Vertex AI converts the batch prediction input as follows: * For `bigquery` and `csv`, the behavior is the same as `array`. The order of columns is the same as defined in the file or table, unless included_fields is populated. * For `jsonl`, the prediction instance format is determined by each line of the input. * For `tf-record`/`tf-record-gzip`, each record will be converted to an object in the format of `{\"b64\": }`, where `` is the Base64-encoded string of the content of the record. * For `file-list`, each file in the list will be converted to an object in the format of `{\"b64\": }`, where `` is the Base64-encoded string of the content of the file." }, "keyField": { "type": "string", "description": "The name of the field that is considered as a key. The values identified by the key field is not included in the transformed instances that is sent to the Model. This is similar to specifying this name of the field in excluded_fields. In addition, the batch prediction output will not include the instances. Instead the output will only include the value of the key field, in a field named `key` in the output: * For `jsonl` output format, the output will have a `key` field instead of the `instance` field. * For `csv`/`bigquery` output format, the output will have have a `key` column instead of the instance feature columns. The input must be JSONL with objects at each line, CSV, BigQuery or TfRecord." }, "excludedFields": { "type": "array", "description": "Fields that will be excluded in the prediction instance that is sent to the Model. Excluded will be attached to the batch prediction output if key_field is not specified. When excluded_fields is populated, included_fields must be empty. The input must be JSONL with objects at each line, BigQuery or TfRecord.", "items": { "type": "string" } }, "includedFields": { "items": { "type": "string" }, "description": "Fields that will be included in the prediction instance that is sent to the Model. If instance_type is `array`, the order of field names in included_fields also determines the order of the values in the array. When included_fields is populated, excluded_fields must be empty. The input must be JSONL with objects at each line, BigQuery or TfRecord.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1BatchPredictionJobInstanceConfig", "description": "Configuration defining how to transform batch prediction input instances to the instances that the Model accepts." }, "GoogleCloudAiplatformV1beta1FindNeighborsRequestQueryRRF": { "type": "object", "properties": { "alpha": { "type": "number", "format": "float", "description": "Required. Users can provide an alpha value to give more weight to dense vs sparse results. For example, if the alpha is 0, we only return sparse and if the alpha is 1, we only return dense." } }, "id": "GoogleCloudAiplatformV1beta1FindNeighborsRequestQueryRRF", "description": "Parameters for RRF algorithm that combines search results." }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputTimeOffset": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputTimeOffset", "description": "Time offset setting.", "type": "object", "properties": { "window": { "description": "[window] refers to the scope of data selected for analysis. It allows you to specify the quantity of data you wish to examine. Currently we support the following format: 'w|W': Week, 'd|D': Day, 'h|H': Hour E.g. '1h' stands for 1 hour, '2d' stands for 2 days.", "type": "string" }, "offset": { "description": "[offset] is the time difference from the cut-off time. For scheduled jobs, the cut-off time is the scheduled time. For non-scheduled jobs, it's the time when the job was created. Currently we support the following format: 'w|W': Week, 'd|D': Day, 'h|H': Hour E.g. '1h' stands for 1 hour, '2d' stands for 2 days.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecEmailConfig": { "description": "The config for email alerts.", "properties": { "userEmails": { "type": "array", "description": "The email addresses to send the alerts.", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecEmailConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingLlmRanker": { "type": "object", "description": "Config for LlmRanker.", "properties": { "modelName": { "type": "string", "description": "Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models)." } }, "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingLlmRanker" }, "GoogleCloudAiplatformV1beta1EnableXmanagerOperationMetadata": { "description": "Metadata message for EnableXmanager RPC.", "id": "GoogleCloudAiplatformV1beta1EnableXmanagerOperationMetadata", "properties": { "genericMetadata": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Output only. Operation metadata for EnableXmanager." }, "progress": { "readOnly": true, "description": "Output only. Progress Message for EnableXmanager LRO", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1NearestNeighbors": { "description": "Nearest neighbors for one query.", "properties": { "neighbors": { "description": "All its neighbors.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborsNeighbor" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1NearestNeighbors", "type": "object" }, "GoogleCloudAiplatformV1beta1ListModelEvaluationsResponse": { "properties": { "modelEvaluations": { "description": "List of ModelEvaluations in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluation" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "A token to retrieve next page of results. Pass to ListModelEvaluationsRequest.page_token to obtain that page." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListModelEvaluationsResponse", "description": "Response message for ModelService.ListModelEvaluations." }, "GoogleCloudAiplatformV1beta1XraiAttribution": { "description": "An explanation method that redistributes Integrated Gradients attributions to segmented regions, taking advantage of the model's fully differentiable structure. Refer to this paper for more details: https://arxiv.org/abs/1906.02825 Supported only by image Models.", "id": "GoogleCloudAiplatformV1beta1XraiAttribution", "properties": { "blurBaselineConfig": { "description": "Config for XRAI with blur baseline. When enabled, a linear path from the maximally blurred image to the input image is created. Using a blurred baseline instead of zero (black image) is motivated by the BlurIG approach explained here: https://arxiv.org/abs/2004.03383", "$ref": "GoogleCloudAiplatformV1beta1BlurBaselineConfig" }, "stepCount": { "format": "int32", "type": "integer", "description": "Required. The number of steps for approximating the path integral. A good value to start is 50 and gradually increase until the sum to diff property is met within the desired error range. Valid range of its value is [1, 100], inclusively." }, "smoothGradConfig": { "description": "Config for SmoothGrad approximation of gradients. When enabled, the gradients are approximated by averaging the gradients from noisy samples in the vicinity of the inputs. Adding noise can help improve the computed gradients. Refer to this paper for more details: https://arxiv.org/pdf/1706.03825.pdf", "$ref": "GoogleCloudAiplatformV1beta1SmoothGradConfig" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenResponse": { "type": "object", "properties": { "accessToken": { "description": "The OAuth 2.0 access token.", "type": "string" }, "expireTime": { "format": "google-datetime", "description": "Token expiration time. This is always set", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenResponse", "description": "Response message for FeatureOnlineStoreService.GenerateFetchAccessToken." }, "GoogleCloudAiplatformV1beta1StreamRawPredictRequest": { "description": "Request message for PredictionService.StreamRawPredict.", "properties": { "httpBody": { "description": "The prediction input. Supports HTTP headers and arbitrary data payload.", "$ref": "GoogleApiHttpBody" } }, "id": "GoogleCloudAiplatformV1beta1StreamRawPredictRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1Transcription": { "id": "GoogleCloudAiplatformV1beta1Transcription", "properties": { "text": { "description": "Optional. Transcription text.", "type": "string" }, "finished": { "description": "Optional. The bool indicates the end of the transcription.", "type": "boolean" } }, "description": "Audio transcription in Server Content.", "type": "object" }, "GenaiVertexV1beta1UrlContextCallDelta": { "type": "object", "id": "GenaiVertexV1beta1UrlContextCallDelta", "properties": { "arguments": { "$ref": "GenaiVertexV1beta1UrlContextCallContentUrlContextCallArguments" } } }, "GoogleCloudAiplatformV1beta1AggregationOutput": { "description": "The aggregation result for the entire dataset and all metrics.", "id": "GoogleCloudAiplatformV1beta1AggregationOutput", "type": "object", "properties": { "aggregationResults": { "type": "array", "description": "One AggregationResult per metric.", "items": { "$ref": "GoogleCloudAiplatformV1beta1AggregationResult" } }, "dataset": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationDataset", "description": "The dataset used for evaluation & aggregation." } } }, "GoogleCloudAiplatformV1beta1RougeInput": { "type": "object", "properties": { "metricSpec": { "description": "Required. Spec for rouge score metric.", "$ref": "GoogleCloudAiplatformV1beta1RougeSpec" }, "instances": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RougeInstance" }, "description": "Required. Repeated rouge instances." } }, "description": "Input for rouge metric.", "id": "GoogleCloudAiplatformV1beta1RougeInput" }, "GoogleCloudAiplatformV1beta1FeatureView": { "description": "FeatureView is representation of values that the FeatureOnlineStore will serve based on its syncConfig.", "properties": { "syncConfig": { "description": "Configures when data is to be synced/updated for this FeatureView. At the end of the sync the latest featureValues for each entityId of this FeatureView are made ready for online serving.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewSyncConfig" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "bigQuerySource": { "description": "Optional. Configures how data is supposed to be extracted from a BigQuery source to be loaded onto the FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewBigQuerySource" }, "serviceAccountEmail": { "type": "string", "readOnly": true, "description": "Output only. A Service Account unique to this FeatureView. The role bigquery.dataViewer should be granted to this service account to allow Vertex AI Feature Store to sync data to the online store." }, "createTime": { "description": "Output only. Timestamp when this FeatureView was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "vectorSearchConfig": { "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfig", "description": "Optional. Deprecated: please use FeatureView.index_config instead." }, "bigtableMetadata": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewBigtableMetadata", "readOnly": true, "description": "Output only. Metadata containing information about the Cloud Bigtable." }, "vertexRagSource": { "description": "Optional. The Vertex RAG Source that the FeatureView is linked to.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewVertexRagSource" }, "labels": { "description": "Optional. The labels with user-defined metadata to organize your FeatureViews. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one FeatureOnlineStore(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "type": "object", "additionalProperties": { "type": "string" } }, "indexConfig": { "description": "Optional. Configuration for index preparation for vector search. It contains the required configurations to create an index from source data, so that approximate nearest neighbor (a.k.a ANN) algorithms search can be performed during online serving.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfig" }, "serviceAgentType": { "enum": [ "SERVICE_AGENT_TYPE_UNSPECIFIED", "SERVICE_AGENT_TYPE_PROJECT", "SERVICE_AGENT_TYPE_FEATURE_VIEW" ], "description": "Optional. Service agent type used during data sync. By default, the Vertex AI Service Agent is used. When using an IAM Policy to isolate this FeatureView within a project, a separate service account should be provisioned by setting this field to `SERVICE_AGENT_TYPE_FEATURE_VIEW`. This will generate a separate service account to access the BigQuery source table.", "type": "string", "enumDescriptions": [ "By default, the project-level Vertex AI Service Agent is enabled.", "Indicates the project-level Vertex AI Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) will be used during sync jobs.", "Enable a FeatureView service account to be created by Vertex AI and output in the field `service_account_email`. This service account will be used to read from the source BigQuery table during sync." ] }, "name": { "description": "Identifier. Name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "type": "string" }, "etag": { "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "updateTime": { "format": "google-datetime", "description": "Output only. Timestamp when this FeatureView was last updated.", "readOnly": true, "type": "string" }, "featureRegistrySource": { "description": "Optional. Configures the features from a Feature Registry source that need to be loaded onto the FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewFeatureRegistrySource" }, "optimizedConfig": { "description": "Optional. Configuration for FeatureView created under Optimized FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewOptimizedConfig" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureView" }, "GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope": { "type": "object", "description": "Represents an Agent Anomaly Detection Scope.", "properties": { "state": { "readOnly": true, "description": "Output only. The lifecycle state of the scope.", "enumDescriptions": [ "The default value. This value is unused.", "The scope is being created and is not yet usable.", "The scope is active and usable.", "The scope is being deleted.", "Creation or deletion failed. The scope is not usable and must be deleted before a new scope can be created in the same region.", "The scope is being updated." ], "enum": [ "STATE_UNSPECIFIED", "CREATING", "ACTIVE", "DELETING", "FAILED", "UPDATING" ], "type": "string" }, "autoEnroll": { "type": "boolean", "description": "Optional. When true, agents created in Agent Engine that share log and observability buckets with this scope are automatically enrolled as MonitoredAgents. When false, agents must be enrolled explicitly via MonitoredAgent operations." }, "encryptionSpec": { "description": "Optional. Immutable. Specifies the customer-managed encryption key spec for a Scope. If set, this Scope and all sub-resources will be secured by this key. The key is immutable after the Scope is created and must be a multi-region (`us` or `eu`) key in the same region as the Scope.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "name": { "description": "Identifier. The resource name of the AgentAnomalyDetectionScope. Format: `projects/{project}/locations/{location}/agentAnomalyDetectionScopes/{agent_anomaly_detection_scope}`", "type": "string" }, "observabilityBuckets": { "type": "array", "items": { "type": "string" }, "description": "Required. Customer-owned Cloud Observability bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/observationBuckets/{observation_bucket}`." }, "logBuckets": { "description": "Required. Customer-owned Cloud Logging bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/buckets/{bucket}`.", "items": { "type": "string" }, "type": "array" }, "displayName": { "description": "Optional. User-provided display name of the AgentAnomalyDetectionScope.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope" }, "GoogleCloudAiplatformV1beta1UndeployModelResponse": { "properties": {}, "id": "GoogleCloudAiplatformV1beta1UndeployModelResponse", "description": "Response message for EndpointService.UndeployModel.", "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfigGenerationTriggerRule": { "properties": { "eventCount": { "format": "int32", "type": "integer", "description": "Optional. Specifies to trigger generation when the event count reaches this limit." }, "fixedInterval": { "description": "Optional. Specifies to trigger generation at a fixed interval. The duration must have a minute-level granularity.", "format": "google-duration", "type": "string" }, "overlapEventCount": { "format": "int32", "type": "integer", "description": "Optional. Re-include the last N already-processed events in the next window." }, "idleDuration": { "description": "Optional. Specifies to trigger generation if the stream is inactive for the specified duration after the most recent event. The duration must have a minute-level granularity.", "format": "google-duration", "type": "string" } }, "type": "object", "description": "Represents the active rule that determines when to flush the buffer.", "id": "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfigGenerationTriggerRule" }, "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInput": { "description": "Instance and metric spec for RubricBasedInstructionFollowing metric.", "type": "object", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingSpec", "description": "Required. Spec for RubricBasedInstructionFollowing metric." }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInstance", "description": "Required. Instance for RubricBasedInstructionFollowing metric." } }, "id": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInput" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecCodeExecutionEnvironment": { "properties": { "machineConfig": { "enumDescriptions": [ "The default value: milligcu 2000, memory 1.5Gib", "The default value: milligcu 4000, memory 4 Gib" ], "type": "string", "description": "The machine config of the code execution environment.", "enum": [ "MACHINE_CONFIG_UNSPECIFIED", "MACHINE_CONFIG_VCPU4_RAM4GIB" ] }, "codeLanguage": { "enum": [ "LANGUAGE_UNSPECIFIED", "LANGUAGE_PYTHON", "LANGUAGE_JAVASCRIPT" ], "description": "The coding language supported in this environment.", "enumDescriptions": [ "The default value. This value is unused.", "The coding language is Python.", "The coding language is JavaScript." ], "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecCodeExecutionEnvironment", "description": "The code execution environment with customized settings." }, "GoogleCloudAiplatformV1beta1DoubleArray": { "id": "GoogleCloudAiplatformV1beta1DoubleArray", "type": "object", "description": "A list of double values.", "properties": { "values": { "type": "array", "items": { "type": "number", "format": "double" }, "description": "A list of double values." } } }, "GenaiVertexV1beta1ImageContent": { "id": "GenaiVertexV1beta1ImageContent", "type": "object", "properties": { "data": { "type": "string", "description": "The image content.", "format": "byte" }, "uri": { "type": "string", "description": "The URI of the image." }, "resolution": { "enumDescriptions": [ "Default value. This value is unused.", "Low resolution.", "Medium resolution.", "High resolution.", "Ultra high resolution." ], "type": "string", "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "ULTRA_HIGH" ], "description": "The resolution of the media." }, "mimeTypeString": { "description": "Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key.", "type": "string" } }, "description": "An image content block. " }, "GoogleCloudAiplatformV1beta1ListTrainingPipelinesResponse": { "id": "GoogleCloudAiplatformV1beta1ListTrainingPipelinesResponse", "properties": { "trainingPipelines": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TrainingPipeline" }, "description": "List of TrainingPipelines in the requested page.", "type": "array" }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListTrainingPipelinesRequest.page_token to obtain that page.", "type": "string" } }, "description": "Response message for PipelineService.ListTrainingPipelines", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureValueList": { "properties": { "values": { "description": "A list of feature values. All of them should be the same data type.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureValue" }, "type": "array" } }, "description": "Container for list of values.", "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureValueList" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeVmImage": { "description": "The definition of a Compute Engine VM image to run the notebook execution on. Mirrors `google.cloud.notebooks.v2.VmImage`.", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeVmImage", "type": "object", "properties": { "project": { "description": "Required. The name of the Google Cloud project that this VM image belongs to. Format: `{project_id}`.", "type": "string" }, "family": { "description": "Use this VM image family to find the image; the newest image in this family is used.", "type": "string" }, "name": { "type": "string", "description": "Use this VM image name to find the image." } } }, "GoogleCloudAiplatformV1beta1UpdateFeatureOnlineStoreOperationMetadata": { "type": "object", "description": "Details of operations that perform update FeatureOnlineStore.", "id": "GoogleCloudAiplatformV1beta1UpdateFeatureOnlineStoreOperationMetadata", "properties": { "genericMetadata": { "description": "Operation metadata for FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityResult": { "type": "object", "description": "Spec for pairwise question answering quality result.", "id": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityResult", "properties": { "pairwiseChoice": { "enum": [ "PAIRWISE_CHOICE_UNSPECIFIED", "BASELINE", "CANDIDATE", "TIE" ], "type": "string", "enumDescriptions": [ "Unspecified prediction choice.", "Baseline prediction wins", "Candidate prediction wins", "Winner cannot be determined" ], "readOnly": true, "description": "Output only. Pairwise question answering prediction choice." }, "explanation": { "type": "string", "description": "Output only. Explanation for question answering quality score.", "readOnly": true }, "confidence": { "description": "Output only. Confidence for question answering quality score.", "type": "number", "readOnly": true, "format": "float" } } }, "GoogleCloudAiplatformV1beta1ListTuningJobsResponse": { "properties": { "tuningJobs": { "description": "The tuning jobs that match the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TuningJob" } }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass this token in a subsequent [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results.", "type": "string" } }, "description": "Response message for GenAiTuningService.ListTuningJobs", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListTuningJobsResponse" }, "GoogleCloudAiplatformV1beta1PairwiseMetricResult": { "description": "Spec for pairwise metric result.", "properties": { "customOutput": { "readOnly": true, "description": "Output only. Spec for custom output.", "$ref": "GoogleCloudAiplatformV1beta1CustomOutput" }, "explanation": { "type": "string", "description": "Output only. Explanation for pairwise metric score.", "readOnly": true }, "pairwiseChoice": { "readOnly": true, "enumDescriptions": [ "Unspecified prediction choice.", "Baseline prediction wins", "Candidate prediction wins", "Winner cannot be determined" ], "enum": [ "PAIRWISE_CHOICE_UNSPECIFIED", "BASELINE", "CANDIDATE", "TIE" ], "description": "Output only. Pairwise metric choice.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PairwiseMetricResult" }, "GoogleCloudAiplatformV1beta1CreateOnlineEvaluatorOperationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateOnlineEvaluatorOperationMetadata", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Common part of operation metadata." } }, "description": "Metadata for the CreateOnlineEvaluator operation." }, "GoogleCloudAiplatformV1beta1CreateDeploymentResourcePoolRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateDeploymentResourcePoolRequest", "description": "Request message for CreateDeploymentResourcePool method.", "properties": { "deploymentResourcePool": { "description": "Required. The DeploymentResourcePool to create.", "$ref": "GoogleCloudAiplatformV1beta1DeploymentResourcePool" }, "deploymentResourcePoolId": { "description": "Required. The ID to use for the DeploymentResourcePool, which will become the final component of the DeploymentResourcePool's resource name. The maximum length is 63 characters, and valid characters are `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ActivateOnlineEvaluatorRequest": { "description": "Request message for ActivateOnlineEvaluator.", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1ActivateOnlineEvaluatorRequest" }, "GenaiVertexV1beta1Value": { "type": "object", "id": "GenaiVertexV1beta1Value", "description": "`Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.", "properties": { "boolValue": { "type": "boolean", "description": "Represents a boolean value." }, "nullValue": { "enum": [ "NULL_VALUE" ], "description": "Represents a null value.", "enumDescriptions": [ "Null value." ], "type": "string" }, "numberValue": { "description": "Represents a double value.", "format": "double", "type": "number" }, "listValue": { "description": "Represents a repeated `Value`.", "$ref": "GenaiVertexV1beta1ListValue" }, "contentValue": { "description": "Represents rich content (text, image, etc.).", "$ref": "GenaiVertexV1beta1Content" }, "structValue": { "description": "Represents a structured value.", "$ref": "GenaiVertexV1beta1Struct" }, "stringValue": { "description": "Represents a string value.", "type": "string" } } }, "GenaiVertexV1beta1ReviewSnippet": { "properties": { "url": { "description": "A link that corresponds to the user review on Google Maps.", "type": "string" }, "title": { "description": "Title of the review.", "type": "string" }, "reviewId": { "description": "The ID of the review snippet.", "type": "string" } }, "id": "GenaiVertexV1beta1ReviewSnippet", "description": "Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.", "type": "object" }, "GoogleCloudAiplatformV1beta1AutoscalingMetricSpec": { "properties": { "target": { "type": "integer", "description": "The target resource utilization in percentage (1% - 100%) for the given metric; once the real usage deviates from the target by a certain percentage, the machine replicas change. The default value is 60 (representing 60%) if not provided.", "format": "int32" }, "metricName": { "description": "Required. The resource metric name. Supported metrics: * For Online Prediction: * `aiplatform.googleapis.com/prediction/online/accelerator/duty_cycle` * `aiplatform.googleapis.com/prediction/online/cpu/utilization` * `aiplatform.googleapis.com/prediction/online/request_count` * `pubsub.googleapis.com/subscription/num_undelivered_messages` * `prometheus.googleapis.com/vertex_dcgm_fi_dev_gpu_util` * `prometheus.googleapis.com/vertex_vllm_gpu_cache_usage_perc` * `prometheus.googleapis.com/vertex_vllm_num_requests_waiting`", "type": "string" }, "monitoredResourceLabels": { "description": "Optional. The Cloud Monitoring monitored resource labels as key value pairs used for metrics filtering. See Cloud Monitoring Labels https://cloud.google.com/monitoring/api/v3/metric-model#generic-label-info", "additionalProperties": { "type": "string" }, "type": "object" } }, "description": "The metric specification that defines the target resource utilization (CPU utilization, accelerator's duty cycle, and so on) for calculating the desired replica count.", "id": "GoogleCloudAiplatformV1beta1AutoscalingMetricSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataOverride": { "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataOverride", "description": "The ExplanationMetadata entries that can be overridden at online explanation time.", "properties": { "inputs": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataOverrideInputMetadataOverride" }, "type": "object", "description": "Required. Overrides the input metadata of the features. The key is the name of the feature to be overridden. The keys specified here must exist in the input metadata to be overridden. If a feature is not specified here, the corresponding feature's input metadata is not overridden." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExportPublisherModelResponse": { "type": "object", "properties": { "publisherModel": { "description": "The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`", "type": "string" }, "destinationUri": { "description": "The destination uri of the model weights.", "type": "string" } }, "description": "Response message for ModelGardenService.ExportPublisherModel.", "id": "GoogleCloudAiplatformV1beta1ExportPublisherModelResponse" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfigFrameSource": { "type": "object", "description": "The input frame(s). It can be a full path or a glob pattern to images. The proto can be extended in the future for alternative ways to specify source of frames.", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsOutpaintConfigFrameSource", "properties": { "horizontalOffset": { "description": "Horizontal offset in pixels of the frame's left edge from the canvas's left edge. Values outside the canvas crop the frame. Optional. Default is 0 (frame flush with the canvas's left edge).", "format": "int32", "type": "integer" }, "verticalOffset": { "format": "int32", "description": "Vertical offset in pixels of the frame's top edge from the canvas's top edge. Values outside the canvas crop the frame. Optional. Default is 0 (frame flush with the canvas's top edge).", "type": "integer" }, "globPattern": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseMetricValue": { "id": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseMetricValue", "description": "TrajectorySingleToolUse metric value for an instance.", "properties": { "score": { "description": "Output only. TrajectorySingleToolUse score.", "readOnly": true, "format": "float", "type": "number" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobDirectNotebookSource": { "description": "The content of the input notebook in ipynb format.", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobDirectNotebookSource", "properties": { "content": { "format": "byte", "type": "string", "description": "The base64-encoded contents of the input notebook file." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TuningDataStats": { "type": "object", "properties": { "supervisedTuningDataStats": { "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningDataStats", "description": "The SFT Tuning data stats." }, "preferenceOptimizationDataStats": { "$ref": "GoogleCloudAiplatformV1beta1PreferenceOptimizationDataStats", "description": "Output only. Statistics for preference optimization.", "readOnly": true }, "distillationDataStats": { "description": "Output only. Statistics for distillation prompt dataset. These statistics do not include the responses sampled from the teacher model.", "$ref": "GoogleCloudAiplatformV1beta1DistillationDataStats", "readOnly": true }, "reinforcementTuningDataStats": { "description": "Output only. Statistics for reinforcement tuning.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1DatasetStats" } }, "description": "The tuning data statistic values for TuningJob.", "id": "GoogleCloudAiplatformV1beta1TuningDataStats" }, "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateMetatdata": { "type": "object", "properties": { "study": { "description": "The name of the Study that the Trial belongs to.", "type": "string" }, "trial": { "description": "The Trial name.", "type": "string" }, "genericMetadata": { "description": "Operation metadata for suggesting Trials.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "id": "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateMetatdata", "description": "This message will be placed in the metadata field of a google.longrunning.Operation associated with a CheckTrialEarlyStoppingState request." }, "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentResponse": { "id": "GoogleCloudAiplatformV1beta1BidiExecuteSandboxEnvironmentResponse", "description": "Response message for SandboxEnvironmentExecutionService.BidiExecuteSandboxEnvironment.", "properties": { "outputs": { "type": "array", "description": "The outputs from the sandbox environment.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1Assessment": { "description": "Contains the detailed assessment for an analyzed session.", "properties": { "detectorFindings": { "description": "The list of detector findings.", "items": { "$ref": "GoogleCloudAiplatformV1beta1AssessmentDetectorFinding" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1Assessment", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateSpecialistPoolOperationMetadata": { "description": "Runtime operation information for SpecialistPoolService.CreateSpecialistPool.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateSpecialistPoolOperationMetadata", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1DynamicRetrievalConfig": { "id": "GoogleCloudAiplatformV1beta1DynamicRetrievalConfig", "properties": { "mode": { "enumDescriptions": [ "Always trigger retrieval.", "Run retrieval only when system decides it is necessary." ], "enum": [ "MODE_UNSPECIFIED", "MODE_DYNAMIC" ], "type": "string", "description": "The mode of the predictor to be used in dynamic retrieval." }, "dynamicThreshold": { "type": "number", "format": "float", "description": "Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used." } }, "type": "object", "description": "Describes the options to customize dynamic retrieval." }, "GenaiVertexV1beta1ProcessingResultStep": { "properties": {}, "description": "The result of a server-initiated media processing step.", "id": "GenaiVertexV1beta1ProcessingResultStep", "type": "object" }, "GoogleCloudAiplatformV1beta1NasTrial": { "description": "Represents a uCAIP NasJob trial.", "id": "GoogleCloudAiplatformV1beta1NasTrial", "type": "object", "properties": { "startTime": { "readOnly": true, "description": "Output only. Time when the NasTrial was started.", "type": "string", "format": "google-datetime" }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "REQUESTED", "ACTIVE", "STOPPING", "SUCCEEDED", "INFEASIBLE" ], "readOnly": true, "enumDescriptions": [ "The NasTrial state is unspecified.", "Indicates that a specific NasTrial has been requested, but it has not yet been suggested by the service.", "Indicates that the NasTrial has been suggested.", "Indicates that the NasTrial should stop according to the service.", "Indicates that the NasTrial is completed successfully.", "Indicates that the NasTrial should not be attempted again. The service will set a NasTrial to INFEASIBLE when it's done but missing the final_measurement." ], "description": "Output only. The detailed state of the NasTrial." }, "id": { "readOnly": true, "type": "string", "description": "Output only. The identifier of the NasTrial assigned by the service." }, "endTime": { "readOnly": true, "type": "string", "description": "Output only. Time when the NasTrial's status changed to `SUCCEEDED` or `INFEASIBLE`.", "format": "google-datetime" }, "finalMeasurement": { "description": "Output only. The final measurement containing the objective value.", "$ref": "GoogleCloudAiplatformV1beta1Measurement", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTextTransformation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTextTransformation", "properties": { "columnName": { "type": "string" } }, "description": "Training pipeline will perform following transformation functions. * The text as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index." }, "GenaiVertexV1beta1InteractionUsageModalityTokens": { "type": "object", "properties": { "tokens": { "type": "integer", "description": "Number of tokens for the modality.", "format": "int32" }, "modality": { "description": "The modality associated with the token count.", "enumDescriptions": [ "Default value. This value is unused.", "Indicates the model should return text.", "Indicates the model should return images.", "Indicates the model should return audio.", "Indicates the model should return video.", "Indicates the model should return documents." ], "type": "string", "enum": [ "RESPONSE_MODALITY_UNSPECIFIED", "TEXT", "IMAGE", "AUDIO", "VIDEO", "DOCUMENT" ] } }, "description": "The token count for a single response modality.", "id": "GenaiVertexV1beta1InteractionUsageModalityTokens" }, "GoogleCloudAiplatformV1beta1HyperparameterTuningJob": { "description": "Represents a HyperparameterTuningJob. A HyperparameterTuningJob has a Study specification and multiple CustomJobs with identical CustomJob specification.", "id": "GoogleCloudAiplatformV1beta1HyperparameterTuningJob", "type": "object", "properties": { "trialJobSpec": { "description": "Required. The spec of a trial job. The same spec applies to the CustomJobs created in all the trials.", "$ref": "GoogleCloudAiplatformV1beta1CustomJobSpec" }, "error": { "description": "Output only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED.", "readOnly": true, "$ref": "GoogleRpcStatus" }, "trials": { "readOnly": true, "description": "Output only. Trials of the HyperparameterTuningJob.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Trial" } }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key options for a HyperparameterTuningJob. If this is set, then all resources created by the HyperparameterTuningJob will be encrypted with the provided encryption key." }, "startTime": { "description": "Output only. Time when the HyperparameterTuningJob for the first time entered the `JOB_STATE_RUNNING` state.", "readOnly": true, "format": "google-datetime", "type": "string" }, "endTime": { "type": "string", "description": "Output only. Time when the HyperparameterTuningJob entered any of the following states: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`.", "readOnly": true, "format": "google-datetime" }, "updateTime": { "description": "Output only. Time when the HyperparameterTuningJob was most recently updated.", "format": "google-datetime", "readOnly": true, "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the HyperparameterTuningJob. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "studySpec": { "$ref": "GoogleCloudAiplatformV1beta1StudySpec", "description": "Required. Study configuration of the HyperparameterTuningJob." }, "parallelTrialCount": { "type": "integer", "description": "Required. The desired number of Trials to run in parallel.", "format": "int32" }, "state": { "readOnly": true, "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "description": "Output only. The detailed state of the job.", "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Time when the HyperparameterTuningJob was created.", "type": "string", "readOnly": true }, "satisfiesPzs": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "maxTrialCount": { "format": "int32", "type": "integer", "description": "Required. The desired total number of Trials." }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize HyperparameterTuningJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "name": { "type": "string", "description": "Output only. Resource name of the HyperparameterTuningJob.", "readOnly": true }, "maxFailedTrialCount": { "format": "int32", "description": "The number of failed Trials that need to be seen before failing the HyperparameterTuningJob. If set to 0, Vertex AI decides how many Trials must fail before the whole job fails.", "type": "integer" }, "satisfiesPzi": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." } } }, "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInput": { "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualitySpec", "description": "Required. Spec for pairwise summarization quality score metric." }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInstance", "description": "Required. Pairwise summarization quality instance." } }, "description": "Input for pairwise summarization quality metric.", "id": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInput", "type": "object" }, "GoogleCloudAiplatformV1beta1PurgeExecutionsMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1PurgeExecutionsMetadata", "description": "Details of operations that perform MetadataService.PurgeExecutions.", "properties": { "genericMetadata": { "description": "Operation metadata for purging Executions.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1WorkerPoolSpec": { "type": "object", "properties": { "replicaCount": { "description": "Optional. The number of worker replicas to use for this worker pool.", "format": "int64", "type": "string" }, "nfsMounts": { "description": "Optional. List of NFS mount spec.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NfsMount" } }, "pythonPackageSpec": { "$ref": "GoogleCloudAiplatformV1beta1PythonPackageSpec", "description": "The Python packaged task." }, "machineSpec": { "description": "Optional. Immutable. The specification of a single machine.", "$ref": "GoogleCloudAiplatformV1beta1MachineSpec" }, "diskSpec": { "$ref": "GoogleCloudAiplatformV1beta1DiskSpec", "description": "Disk spec." }, "containerSpec": { "description": "The custom container task.", "$ref": "GoogleCloudAiplatformV1beta1ContainerSpec" }, "lustreMounts": { "description": "Optional. List of Lustre mounts.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LustreMount" }, "type": "array" } }, "description": "Represents the spec of a worker pool in a job.", "id": "GoogleCloudAiplatformV1beta1WorkerPoolSpec" }, "GoogleCloudAiplatformV1beta1BatchPredictionJobInputConfig": { "id": "GoogleCloudAiplatformV1beta1BatchPredictionJobInputConfig", "description": "Configures the input to BatchPredictionJob. See Model.supported_input_storage_formats for Model's supported input formats, and how instances should be expressed via any of them.", "properties": { "vertexMultimodalDatasetSource": { "$ref": "GoogleCloudAiplatformV1beta1VertexMultimodalDatasetSource", "description": "A Vertex Managed Dataset. Currently, only datasets of type Multimodal are supported." }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource", "description": "The BigQuery location of the input table. The schema of the table should be in the format described by the given context OpenAPI Schema, if one is provided. The table may contain additional columns that are not described by the schema, and they will be ignored." }, "instancesFormat": { "type": "string", "description": "Required. The format in which instances are given, must be one of the Model's supported_input_storage_formats." }, "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1GcsSource", "description": "The Cloud Storage location for the input instances." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitAlwaysLatest": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitAlwaysLatest", "type": "object", "properties": {}, "description": "Traffic distribution configuration, where all traffic is sent to the latest Runtime Revision." }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePairList": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePairList", "properties": { "referenceSentencePairs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecReferenceSentencePair" }, "description": "Reference sentence pairs.", "type": "array" } }, "description": "A list of reference sentence pairs." }, "GoogleCloudAiplatformV1beta1StructuredMemoryConfigSchemaConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1StructuredMemoryConfigSchemaConfig", "properties": { "id": { "description": "Required. Represents the ID of the schema. Must be 1-63 characters, start with a lowercase letter, and consist of lowercase letters, numbers, and hyphens.", "type": "string" }, "schema": { "description": "Required. Represents the OpenAPI schema of the structured memories. The schema `type` cannot be `ARRAY` when `memory_type` is `STRUCTURED_PROFILE`.", "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "memoryType": { "description": "Optional. Represents the type of the structured memories associated with the schema. If not set, then `STRUCTURED_PROFILE` will be used.", "type": "string", "enum": [ "MEMORY_TYPE_UNSPECIFIED", "NATURAL_LANGUAGE_COLLECTION", "STRUCTURED_PROFILE" ], "enumDescriptions": [ "Represents an unspecified memory type. This value should not be used.", "Indicates belonging to a collection of natural language memories.", "Indicates belonging to a structured profile." ] }, "jsonSchema": { "type": "any", "description": "Optional. Represents the JSON Schema of the structured memories." } }, "description": "Schema configuration for structured memories." }, "GoogleCloudAiplatformV1beta1GcsDestination": { "properties": { "outputUriPrefix": { "type": "string", "description": "Required. Google Cloud Storage URI to output directory. If the uri doesn't end with '/', a '/' will be automatically appended. The directory is created if it doesn't exist." } }, "description": "The Google Cloud Storage location where the output is to be written to.", "id": "GoogleCloudAiplatformV1beta1GcsDestination", "type": "object" }, "GoogleCloudAiplatformV1beta1MutateDeployedModelRequest": { "id": "GoogleCloudAiplatformV1beta1MutateDeployedModelRequest", "description": "Request message for EndpointService.MutateDeployedModel.", "properties": { "updateMask": { "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", "type": "string" }, "deployedModel": { "description": "Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * `required_replica_count` in DedicatedResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only) * `scale_to_zero_spec` in DedicatedResources (v1beta1 only) * `initial_replica_count` in DedicatedResources (v1beta1 only)", "$ref": "GoogleCloudAiplatformV1beta1DeployedModel" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListFeedbackEntriesResponse": { "id": "GoogleCloudAiplatformV1beta1ListFeedbackEntriesResponse", "type": "object", "description": "Response message for ListFeedbackEntries.", "properties": { "feedbackEntries": { "description": "The page of FeedbackEntries matching the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeedbackEntry" } }, "nextPageToken": { "description": "A token to retrieve the next page. Absence of this field indicates there are no subsequent pages.", "type": "string" } } }, "GenaiVertexV1beta1McpServer": { "description": "A MCPServer is a server that can be called by the model to perform actions.", "properties": { "name": { "description": "The name of the MCPServer.", "type": "string" }, "headers": { "description": "Optional: Fields for authentication headers, timeouts, etc., if needed.", "additionalProperties": { "type": "string" }, "type": "object" }, "allowedTools": { "description": "The allowed tools.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1AllowedTools" } }, "url": { "description": "The full URL for the MCPServer endpoint. Example: \"https://api.example.com/mcp\"", "type": "string" } }, "id": "GenaiVertexV1beta1McpServer", "type": "object" }, "GoogleCloudAiplatformV1beta1FluencyInstance": { "type": "object", "properties": { "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" } }, "description": "Spec for fluency instance.", "id": "GoogleCloudAiplatformV1beta1FluencyInstance" }, "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries": { "type": "object", "properties": { "timestampColumn": { "description": "Optional. Column hosting timestamp values for a time-series source. Will be used to determine the latest `feature_values` for each entity. Optional. If not provided, column named `feature_timestamp` of type `TIMESTAMP` will be used.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1FeatureGroupBigQueryTimeSeries" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageSegmentationEvaluationMetrics": { "properties": { "confidenceMetricsEntries": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageSegmentationEvaluationMetricsConfidenceMetricsEntry" }, "description": "Metrics for each confidenceThreshold in 0.00,0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 Precision-recall curve can be derived from it." } }, "type": "object", "description": "Metrics for image segmentation evaluation results.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageSegmentationEvaluationMetrics" }, "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1StopNotebookRuntimeRequest", "description": "Request message for NotebookService.StopNotebookRuntime.", "properties": {} }, "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsResponse": { "id": "GoogleCloudAiplatformV1beta1AddContextArtifactsAndExecutionsResponse", "type": "object", "properties": {}, "description": "Response message for MetadataService.AddContextArtifactsAndExecutions." }, "GenaiVertexV1beta1VideoDelta": { "type": "object", "id": "GenaiVertexV1beta1VideoDelta", "properties": { "uri": { "type": "string" }, "resolution": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Low resolution.", "Medium resolution.", "High resolution.", "Ultra high resolution." ], "description": "The resolution of the media.", "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "ULTRA_HIGH" ] }, "data": { "format": "byte", "type": "string" }, "mimeType": { "enum": [ "TYPE_UNSPECIFIED", "TYPE_MP4", "TYPE_MPEG", "TYPE_MPG", "TYPE_MOV", "TYPE_AVI", "TYPE_X_FLV", "TYPE_WEBM", "TYPE_WMV", "TYPE_3GPP", "TYPE_JPEG2000" ], "type": "string", "enumDescriptions": [ "", "MP4 video format", "MPEG video format", "MPG video format", "MOV video format", "AVI video format", "FLV video format", "WebM video format", "WMV video format", "3GPP video format", "JPEG 2000 video format" ] } } }, "GoogleCloudAiplatformV1beta1SchemaAnnotationSpecColor": { "description": "An entry of mapping between color and AnnotationSpec. The mapping is used in segmentation mask.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaAnnotationSpecColor", "properties": { "displayName": { "description": "The display name of the AnnotationSpec represented by the color in the segmentation mask.", "type": "string" }, "color": { "description": "The color of the AnnotationSpec in a segmentation mask.", "$ref": "GoogleTypeColor" }, "id": { "type": "string", "description": "The ID of the AnnotationSpec represented by the color in the segmentation mask." } } }, "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestSnapshotExport": { "properties": { "snapshotTime": { "type": "string", "format": "google-datetime", "description": "Exports Feature values as of this timestamp. If not set, retrieve values as of now. Timestamp, if present, must not have higher than millisecond precision." }, "startTime": { "format": "google-datetime", "type": "string", "description": "Excludes Feature values with feature generation timestamp before this timestamp. If not set, retrieve oldest values kept in Feature Store. Timestamp, if present, must not have higher than millisecond precision." } }, "id": "GoogleCloudAiplatformV1beta1ExportFeatureValuesRequestSnapshotExport", "type": "object", "description": "Describes exporting the latest Feature values of all entities of the EntityType between [start_time, snapshot_time]." }, "GenaiVertexV1beta1ProcessingResultDelta": { "properties": {}, "id": "GenaiVertexV1beta1ProcessingResultDelta", "description": "Streaming delta for the result of a server-initiated media processing step.", "type": "object" }, "GoogleCloudAiplatformV1beta1EntityIdSelector": { "properties": { "csvSource": { "description": "Source of Csv", "$ref": "GoogleCloudAiplatformV1beta1CsvSource" }, "entityIdField": { "type": "string", "description": "Source column that holds entity IDs. If not provided, entity IDs are extracted from the column named entity_id." } }, "type": "object", "description": "Selector for entityId. Getting ids from the given source.", "id": "GoogleCloudAiplatformV1beta1EntityIdSelector" }, "GoogleCloudAiplatformV1beta1ListEndpointsResponse": { "id": "GoogleCloudAiplatformV1beta1ListEndpointsResponse", "description": "Response message for EndpointService.ListEndpoints.", "properties": { "endpoints": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Endpoint" }, "type": "array", "description": "List of Endpoints in the requested page." }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListEndpointsRequest.page_token to obtain that page.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestImportSchemaConfig": { "properties": { "dataFormatVersion": { "type": "string", "description": "Optional. Version of the data format." }, "dataFormat": { "type": "string", "description": "Required. The format of the input data.", "enum": [ "DATA_FORMAT_UNSPECIFIED", "OTEL_PROTO", "OTEL_JSON", "JSONL" ], "enumDescriptions": [ "Unspecified data format.", "OpenTelemetry Protobuf format (e.g. TracesData).", "OpenTelemetry JSON format.", "JSONL format mapping directly to EvaluationItem schema." ] } }, "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestImportSchemaConfig", "description": "Configuration for the input data format.", "type": "object" }, "GoogleCloudAiplatformV1beta1ScheduleConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ScheduleConfig", "properties": { "cron": { "description": "Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch scheduled runs. To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: \"CRON_TZ=${IANA_TIME_ZONE}\" or \"TZ=${IANA_TIME_ZONE}\". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, \"CRON_TZ=America/New_York 1 * * * *\", or \"TZ=America/New_York 1 * * * *\".", "type": "string" } }, "description": "Schedule configuration for the FeatureMonitor." }, "GoogleCloudAiplatformV1beta1AddExecutionEventsRequest": { "description": "Request message for MetadataService.AddExecutionEvents.", "id": "GoogleCloudAiplatformV1beta1AddExecutionEventsRequest", "type": "object", "properties": { "events": { "description": "The Events to create and add.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Event" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataResponse": { "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataResponse", "description": "Response message for TensorboardService.WriteTensorboardExperimentData." }, "GoogleCloudAiplatformV1beta1UpdateModelMonitorOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UpdateModelMonitorOperationMetadata", "type": "object", "description": "Runtime operation information for ModelMonitoringService.UpdateModelMonitor.", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1ImportFeatureValuesResponse": { "type": "object", "properties": { "invalidRowCount": { "description": "The number of rows in input source that weren't imported due to either * Not having any featureValues. * Having a null entityId. * Having a null timestamp. * Not being parsable (applicable for CSV sources).", "format": "int64", "type": "string" }, "importedEntityCount": { "type": "string", "description": "Number of entities that have been imported by the operation.", "format": "int64" }, "importedFeatureValueCount": { "format": "int64", "type": "string", "description": "Number of Feature values that have been imported by the operation." }, "timestampOutsideRetentionRowsCount": { "type": "string", "format": "int64", "description": "The number rows that weren't ingested due to having feature timestamps outside the retention boundary." } }, "description": "Response message for FeaturestoreService.ImportFeatureValues.", "id": "GoogleCloudAiplatformV1beta1ImportFeatureValuesResponse" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsSuperResConfig": { "description": "Config for the Pro Super Res upsampling task.", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsSuperResConfig", "properties": { "mode": { "enum": [ "MODE_UNSPECIFIED", "MODE_4K", "MODE_8K", "MODE_4K_PRO" ], "description": "Super Res mode. Required.", "type": "string", "enumDescriptions": [ "", "Single-pass 4K UDiT.", "Single-pass 8K UDiT.", "\"8K UDiT, downsampled 2x in the decoder." ] }, "tileSmoothing": { "description": "Smooths the seams between the tiles the model upscales separately.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner": { "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner", "properties": { "basic": { "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic", "description": "Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not explicitly chosen." }, "scaled": { "description": "Sets the RagManagedDb to the Scaled tier.", "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled" }, "unprovisioned": { "description": "Sets the RagManagedDb to the Unprovisioned tier.", "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned" } }, "type": "object", "description": "Message to configure the Spanner database used by RagManagedDb." }, "CloudAiLargeModelsVisionExperimentsResponse": { "id": "CloudAiLargeModelsVisionExperimentsResponse", "type": "object", "description": "Experimental response metadata for video generation.", "properties": { "proEditResult": { "description": "Result metadata from a Pro Edit operation, populated for edit requests.", "$ref": "CloudAiLargeModelsVisionExperimentsResponseProEditResult" } } }, "GoogleCloudAiplatformV1beta1RetrievalMetadata": { "id": "GoogleCloudAiplatformV1beta1RetrievalMetadata", "type": "object", "properties": { "googleSearchDynamicRetrievalScore": { "description": "Optional. A score indicating how likely it is that a Google Search query could help answer the prompt. The score is in the range of `[0, 1]`. A score of 1 means the model is confident that a search will be helpful, and 0 means it is not. This score is populated only when Google Search grounding and dynamic retrieval are enabled. The score is used to determine whether to trigger a search.", "type": "number", "format": "float" } }, "description": "Metadata related to the retrieval grounding source. This is part of the `GroundingMetadata` returned when grounding is enabled." }, "GoogleCloudAiplatformV1beta1SearchNearestEntitiesRequest": { "type": "object", "properties": { "returnFullEntity": { "type": "boolean", "description": "Optional. If set to true, the full entities (including all vector values and metadata) of the nearest neighbors are returned; otherwise only entity id of the nearest neighbors will be returned. Note that returning full entities will significantly increase the latency and cost of the query." }, "query": { "description": "Required. The query.", "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborQuery" } }, "id": "GoogleCloudAiplatformV1beta1SearchNearestEntitiesRequest", "description": "The request message for FeatureOnlineStoreService.SearchNearestEntities." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsPairwiseTextGenerationEvaluationMetrics": { "properties": { "humanPreferenceModelWinRate": { "type": "number", "description": "Percentage of time humans decided the model had the better response.", "format": "float" }, "trueNegativeCount": { "description": "Number of examples where both the autorater and humans decided that the model had the worse response.", "type": "string", "format": "int64" }, "truePositiveCount": { "description": "Number of examples where both the autorater and humans decided that the model had the better response.", "type": "string", "format": "int64" }, "falseNegativeCount": { "type": "string", "format": "int64", "description": "Number of examples where the autorater chose the baseline model, but humans preferred the model." }, "baselineModelWinRate": { "type": "number", "format": "float", "description": "Percentage of time the autorater decided the baseline model had the better response." }, "precision": { "description": "Fraction of cases where the autorater and humans thought the model had a better response out of all cases where the autorater thought the model had a better response. True positive divided by all positive.", "type": "number", "format": "float" }, "f1Score": { "type": "number", "format": "float", "description": "Harmonic mean of precision and recall." }, "modelWinRate": { "description": "Percentage of time the autorater decided the model had the better response.", "type": "number", "format": "float" }, "recall": { "type": "number", "description": "Fraction of cases where the autorater and humans thought the model had a better response out of all cases where the humans thought the model had a better response.", "format": "float" }, "cohensKappa": { "type": "number", "format": "float", "description": "A measurement of agreement between the autorater and human raters that takes the likelihood of random agreement into account." }, "falsePositiveCount": { "type": "string", "description": "Number of examples where the autorater chose the model, but humans preferred the baseline model.", "format": "int64" }, "accuracy": { "description": "Fraction of cases where the autorater agreed with the human raters.", "format": "float", "type": "number" }, "humanPreferenceBaselineModelWinRate": { "format": "float", "description": "Percentage of time humans decided the baseline model had the better response.", "type": "number" } }, "type": "object", "description": "Metrics for general pairwise text generation evaluation results.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsPairwiseTextGenerationEvaluationMetrics" }, "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataGcsSource": { "type": "object", "properties": { "uri": { "items": { "type": "string" }, "description": "Cloud Storage URI of one or more files. Only CSV files are supported. The first line of the CSV file is used as the header. If there are multiple files, the header is the first line of the lexicographically first file, the other files must either contain the exact same header or omit the header.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataGcsSource" }, "GoogleCloudAiplatformV1beta1ListArtifactsResponse": { "properties": { "artifacts": { "description": "The Artifacts retrieved from the MetadataStore.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as ListArtifactsRequest.page_token to retrieve the next page. If this field is not populated, there are no subsequent pages.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ListArtifactsResponse", "type": "object", "description": "Response message for MetadataService.ListArtifacts." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsSummarizationEvaluationMetrics": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsSummarizationEvaluationMetrics", "type": "object", "properties": { "rougeLSum": { "description": "ROUGE-L (Longest Common Subsequence) scoring at summary level.", "type": "number", "format": "float" } } }, "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigBruteForceConfig": { "id": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigBruteForceConfig", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestPassThroughField": { "description": "Describe pass-through fields in read_instance source.", "properties": { "fieldName": { "description": "Required. The name of the field in the CSV header or the name of the column in BigQuery table. The naming restriction is the same as Feature.name.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestPassThroughField", "type": "object" }, "GoogleCloudAiplatformV1beta1Segment": { "id": "GoogleCloudAiplatformV1beta1Segment", "type": "object", "description": "A segment of the content.", "properties": { "startIndex": { "readOnly": true, "format": "int32", "description": "Output only. The start index of the segment in the `Part`, measured in bytes. This marks the beginning of the segment and is inclusive, meaning the byte at this index is the first byte of the segment.", "type": "integer" }, "text": { "type": "string", "readOnly": true, "description": "Output only. The text of the segment." }, "endIndex": { "type": "integer", "format": "int32", "readOnly": true, "description": "Output only. The end index of the segment in the `Part`, measured in bytes. This marks the end of the segment and is exclusive, meaning the segment includes content up to, but not including, the byte at this index." }, "partIndex": { "description": "Output only. The index of the `Part` object that this segment belongs to. This is useful for associating the segment with a specific part of the content.", "readOnly": true, "format": "int32", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1ProcessDataRequestVeoSpec": { "id": "GoogleCloudAiplatformV1beta1ProcessDataRequestVeoSpec", "properties": { "processType": { "enumDescriptions": [ "Process type for Veo 1 and 2.", "Process type for Veo 3.", "Process type for Veo Outpainting: prepares data for extending video content beyond its original boundaries or changing its aspect ratio." ], "description": "Optional. The type of data processing to perform.", "enum": [ "VEO_V1_AND_V2_DEFAULT", "VEO_V3", "VEO_OUTPAINTING" ], "type": "string" }, "outpaintingMode": { "enumDescriptions": [ "Unspecified outpainting mode. Must not be used when `process_type` is `VEO_OUTPAINTING` (rejected with `INVALID_ARGUMENT`).", "Stage 1 data preparation mode for Veo Outpainting.", "Stage 2 outpainting video processing mode for Veo Outpainting." ], "description": "Optional. The mode of Veo Outpainting data processing to perform. Required (`DATA_PREPARATION` or `OUTPAINTING`) when `process_type` is `VEO_OUTPAINTING` (`OUTPAINTING_MODE_UNSPECIFIED` is rejected with `INVALID_ARGUMENT`). Must not be set when `process_type` is not `VEO_OUTPAINTING` (rejected with `INVALID_ARGUMENT`).", "enum": [ "OUTPAINTING_MODE_UNSPECIFIED", "DATA_PREPARATION", "OUTPAINTING" ], "type": "string" } }, "type": "object", "description": "Spec for Veo data processing." }, "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigThresholdConfig": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigThresholdConfig", "properties": { "value": { "type": "number", "description": "Specify a threshold value that can trigger the alert. 1. For categorical feature, the distribution distance is calculated by L-inifinity norm. 2. For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence. Each feature must have a non-zero threshold if they need to be monitored. Otherwise no alert will be triggered for that feature.", "format": "double" } }, "description": "The config for Featurestore Monitoring threshold.", "type": "object" }, "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateResponse": { "description": "Response message for VizierService.CheckTrialEarlyStoppingState.", "properties": { "shouldStop": { "description": "True if the Trial should stop.", "type": "boolean" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateResponse" }, "GoogleCloudAiplatformV1beta1DatasetDistributionDistributionBucket": { "description": "Dataset bucket used to create a histogram for the distribution given a population of values.", "properties": { "left": { "type": "number", "readOnly": true, "format": "double", "description": "Output only. Left bound of the bucket." }, "count": { "type": "string", "description": "Output only. Number of values in the bucket.", "format": "int64", "readOnly": true }, "right": { "format": "double", "readOnly": true, "description": "Output only. Right bound of the bucket.", "type": "number" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1DatasetDistributionDistributionBucket" }, "GenaiVertexV1beta1GoogleSearchCallStep": { "properties": { "arguments": { "$ref": "GenaiVertexV1beta1GoogleSearchCallStepGoogleSearchCallStepArguments", "description": "Required. The arguments to pass to Google Search." }, "searchType": { "type": "string", "enumDescriptions": [ "Unspecified search type. This value should not be used.", "Setting this field enables web search. Only text results are returned.", "Setting this field enables image search. Image bytes are returned.", "Setting this field enables enterprise web search." ], "enum": [ "SEARCH_TYPE_UNSPECIFIED", "SEARCH_TYPE_WEB_SEARCH", "SEARCH_TYPE_IMAGE_SEARCH", "SEARCH_TYPE_ENTERPRISE_WEB_SEARCH" ], "description": "The type of search grounding enabled." } }, "id": "GenaiVertexV1beta1GoogleSearchCallStep", "type": "object", "description": "Google Search call step." }, "GoogleCloudAiplatformV1beta1EvaluationMetric": { "description": "EvaluationMetric is a resource that represents a reusable metric configuration.", "type": "object", "properties": { "encryptionSpec": { "description": "Optional. Customer-managed encryption key spec for this EvaluationMetric. If set, this EvaluationMetric will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "gcsUri": { "type": "string", "description": "Optional. The Google Cloud Storage URI that stores the metric specification.." }, "description": { "description": "Optional. A description of the EvaluationMetric.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Labels for the evaluation metric." }, "metric": { "description": "Optional. The metric configuration. Only LLMMetric and CustomCodeExecutionMetric are supported.", "$ref": "GoogleCloudAiplatformV1beta1Metric" }, "updateTime": { "description": "Output only. The time when the EvaluationMetric was last updated.", "readOnly": true, "format": "google-datetime", "type": "string" }, "name": { "type": "string", "description": "Identifier. The resource name of the EvaluationMetric. Format: `projects/{project}/locations/{location}/evaluationMetrics/{evaluation_metric}`" }, "displayName": { "description": "Required. The user-friendly display name for the EvaluationMetric.", "type": "string" }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time when the EvaluationMetric was created.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationMetric" }, "GenaiVertexV1beta1GoogleSearchResultDelta": { "id": "GenaiVertexV1beta1GoogleSearchResultDelta", "type": "object", "properties": { "result": { "items": { "$ref": "GenaiVertexV1beta1GoogleSearchResultContentGoogleSearchResult" }, "type": "array" }, "isError": { "type": "boolean" } } }, "GoogleCloudAiplatformV1beta1FeatureStatsAndAnomaly": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureStatsAndAnomaly", "properties": { "featureStats": { "type": "any", "description": "Feature stats. e.g. histogram buckets. In the format of tensorflow.metadata.v0.DatasetFeatureStatistics." }, "featureId": { "type": "string", "description": "Feature Id." }, "distributionDeviation": { "format": "double", "description": "Deviation from the current stats to baseline stats. 1. For categorical feature, the distribution distance is calculated by L-inifinity norm. 2. For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence.", "type": "number" }, "featureMonitorJobId": { "description": "The ID of the FeatureMonitorJob that generated this FeatureStatsAndAnomaly.", "type": "string", "format": "int64" }, "statsTime": { "format": "google-datetime", "description": "The timestamp we take snapshot for feature values to generate stats.", "type": "string" }, "featureMonitorId": { "type": "string", "description": "The ID of the FeatureMonitor that this FeatureStatsAndAnomaly generated according to." }, "driftDetectionThreshold": { "format": "double", "type": "number", "description": "This is the threshold used when detecting drifts, which is set in FeatureMonitor.FeatureSelectionConfig.FeatureConfig.drift_threshold" }, "driftDetected": { "type": "boolean", "description": "If set to true, indicates current stats is detected as and comparing with baseline stats." } }, "description": "Stats and Anomaly generated by FeatureMonitorJobs. Anomaly only includes Drift." }, "GoogleCloudAiplatformV1beta1SummarizationQualityResult": { "description": "Spec for summarization quality result.", "id": "GoogleCloudAiplatformV1beta1SummarizationQualityResult", "type": "object", "properties": { "explanation": { "readOnly": true, "description": "Output only. Explanation for summarization quality score.", "type": "string" }, "score": { "format": "float", "readOnly": true, "type": "number", "description": "Output only. Summarization Quality score." }, "confidence": { "format": "float", "type": "number", "readOnly": true, "description": "Output only. Confidence for summarization quality score." } } }, "GoogleCloudAiplatformV1beta1PurgeArtifactsResponse": { "description": "Response message for MetadataService.PurgeArtifacts.", "id": "GoogleCloudAiplatformV1beta1PurgeArtifactsResponse", "properties": { "purgeCount": { "type": "string", "description": "The number of Artifacts that this request deleted (or, if `force` is false, the number of Artifacts that will be deleted). This can be an estimate.", "format": "int64" }, "purgeSample": { "items": { "type": "string" }, "type": "array", "description": "A sample of the Artifact names that will be deleted. Only populated if `force` is set to false. The maximum number of samples is 100 (it is possible to return fewer)." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataVisualization": { "description": "Visualization configurations for image explanation.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataVisualization", "properties": { "clipPercentUpperbound": { "description": "Excludes attributions above the specified percentile from the highlighted areas. Using the clip_percent_upperbound and clip_percent_lowerbound together can be useful for filtering out noise and making it easier to see areas of strong attribution. Defaults to 99.9.", "format": "float", "type": "number" }, "clipPercentLowerbound": { "format": "float", "description": "Excludes attributions below the specified percentile, from the highlighted areas. Defaults to 62.", "type": "number" }, "colorMap": { "enum": [ "COLOR_MAP_UNSPECIFIED", "PINK_GREEN", "VIRIDIS", "RED", "GREEN", "RED_GREEN", "PINK_WHITE_GREEN" ], "description": "The color scheme used for the highlighted areas. Defaults to PINK_GREEN for Integrated Gradients attribution, which shows positive attributions in green and negative in pink. Defaults to VIRIDIS for XRAI attribution, which highlights the most influential regions in yellow and the least influential in blue.", "enumDescriptions": [ "Should not be used.", "Positive: green. Negative: pink.", "Viridis color map: A perceptually uniform color mapping which is easier to see by those with colorblindness and progresses from yellow to green to blue. Positive: yellow. Negative: blue.", "Positive: red. Negative: red.", "Positive: green. Negative: green.", "Positive: green. Negative: red.", "PiYG palette." ], "type": "string" }, "type": { "type": "string", "enumDescriptions": [ "Should not be used.", "Shows which pixel contributed to the image prediction.", "Shows which region contributed to the image prediction by outlining the region." ], "description": "Type of the image visualization. Only applicable to Integrated Gradients attribution. OUTLINES shows regions of attribution, while PIXELS shows per-pixel attribution. Defaults to OUTLINES.", "enum": [ "TYPE_UNSPECIFIED", "PIXELS", "OUTLINES" ] }, "polarity": { "type": "string", "description": "Whether to only highlight pixels with positive contributions, negative or both. Defaults to POSITIVE.", "enum": [ "POLARITY_UNSPECIFIED", "POSITIVE", "NEGATIVE", "BOTH" ], "enumDescriptions": [ "Default value. This is the same as POSITIVE.", "Highlights the pixels/outlines that were most influential to the model's prediction.", "Setting polarity to negative highlights areas that does not lead to the models's current prediction.", "Shows both positive and negative attributions." ] }, "overlayType": { "enumDescriptions": [ "Default value. This is the same as NONE.", "No overlay.", "The attributions are shown on top of the original image.", "The attributions are shown on top of grayscaled version of the original image.", "The attributions are used as a mask to reveal predictive parts of the image and hide the un-predictive parts." ], "type": "string", "enum": [ "OVERLAY_TYPE_UNSPECIFIED", "NONE", "ORIGINAL", "GRAYSCALE", "MASK_BLACK" ], "description": "How the original image is displayed in the visualization. Adjusting the overlay can help increase visual clarity if the original image makes it difficult to view the visualization. Defaults to NONE." } } }, "GoogleCloudAiplatformV1beta1Schema": { "type": "object", "id": "GoogleCloudAiplatformV1beta1Schema", "properties": { "minLength": { "format": "int64", "type": "string", "description": "Optional. If type is `STRING`, `min_length` specifies the minimum length of the string." }, "maxItems": { "format": "int64", "type": "string", "description": "Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array." }, "title": { "description": "Optional. Title for the schema.", "type": "string" }, "additionalProperties": { "description": "Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema.", "type": "any" }, "defs": { "type": "object", "description": "Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Schema" } }, "enum": { "description": "Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:[\"EAST\", \"NORTH\", \"SOUTH\", \"WEST\"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:[\"101\", \"201\", \"301\"]}`", "type": "array", "items": { "type": "string" } }, "nullable": { "description": "Optional. Indicates if the value of this field can be null.", "type": "boolean" }, "pattern": { "description": "Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match.", "type": "string" }, "default": { "type": "any", "description": "Optional. Default value to use if the field is not specified." }, "maxProperties": { "type": "string", "format": "int64", "description": "Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided." }, "propertyOrdering": { "items": { "type": "string" }, "type": "array", "description": "Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties." }, "type": { "enumDescriptions": [ "Not specified, should not be used.", "OpenAPI string type", "OpenAPI number type", "OpenAPI integer type", "OpenAPI boolean type", "OpenAPI array type", "OpenAPI object type", "Null type" ], "enum": [ "TYPE_UNSPECIFIED", "STRING", "NUMBER", "INTEGER", "BOOLEAN", "ARRAY", "OBJECT", "NULL" ], "description": "Optional. Data type of the schema field.", "type": "string" }, "minProperties": { "description": "Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided.", "type": "string", "format": "int64" }, "minimum": { "format": "double", "type": "number", "description": "Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value." }, "ref": { "description": "Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named \"Pet\": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the \"pet\" property is a reference to the schema node named \"Pet\". See details in https://json-schema.org/understanding-json-schema/structuring", "type": "string" }, "required": { "type": "array", "description": "Optional. If type is `OBJECT`, `required` lists the names of properties that must be present.", "items": { "type": "string" } }, "properties": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "description": "Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object.", "type": "object" }, "description": { "type": "string", "description": "Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt." }, "minItems": { "format": "int64", "type": "string", "description": "Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array." }, "maximum": { "description": "Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value.", "type": "number", "format": "double" }, "example": { "description": "Optional. Example of an instance of this schema.", "type": "any" }, "anyOf": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "description": "Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`.", "type": "array" }, "format": { "description": "Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type.", "type": "string" }, "items": { "description": "Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array.", "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "maxLength": { "type": "string", "description": "Optional. If type is `STRING`, `max_length` specifies the maximum length of the string.", "format": "int64" } }, "description": "Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object)." }, "GoogleCloudAiplatformV1beta1GenieSource": { "id": "GoogleCloudAiplatformV1beta1GenieSource", "properties": { "baseModelUri": { "type": "string", "description": "Required. The public base model URI." } }, "type": "object", "description": "Contains information about the source of the models generated from Generative AI Studio." }, "GoogleCloudAiplatformV1beta1ToolCodeExecution": { "type": "object", "properties": {}, "description": "Tool that executes code generated by the model, and automatically returns the result to the model. See also ExecutableCode and CodeExecutionResult, which are input and output to this tool.", "id": "GoogleCloudAiplatformV1beta1ToolCodeExecution" }, "GoogleCloudAiplatformV1beta1ModelMonitoringAlert": { "properties": { "statsName": { "description": "The stats name.", "type": "string" }, "anomaly": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAnomaly", "description": "Anomaly details." }, "alertTime": { "description": "Alert creation time.", "format": "google-datetime", "type": "string" }, "objectiveType": { "description": "One of the supported monitoring objectives: `raw-feature-drift` `prediction-output-drift` `feature-attribution`", "type": "string" } }, "description": "Represents a single monitoring alert. This is currently used in the SearchModelMonitoringAlerts api, thus the alert wrapped in this message belongs to the resource asked in the request.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAlert" }, "GoogleCloudAiplatformV1beta1ListAgentsResponse": { "description": "Response message for AgentService.ListAgents.", "properties": { "agents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Agent" }, "description": "The agents matching the request." }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass this value as ListAgentsRequest.page_token in a subsequent call." } }, "id": "GoogleCloudAiplatformV1beta1ListAgentsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact": { "properties": { "artifactId": { "description": "Artifact resource id from MLMD. Which is the last portion of an artifact resource name: `projects/{project}/locations/{location}/metadataStores/default/artifacts/{artifact_id}`. The artifact must stay within the same project, location and default metadatastore as the pipeline.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact", "type": "object", "description": "The type of an input artifact." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputs": { "type": "object", "properties": { "hierarchyConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHierarchyConfig", "description": "Configuration that defines the hierarchical relationship of time series and parameters for hierarchical forecasting strategies." }, "timeSeriesIdentifierColumn": { "description": "The name of the column that identifies the time series.", "type": "string" }, "contextWindow": { "type": "string", "format": "int64", "description": "The amount of time into the past training and prediction data is used for model training and prediction respectively. Expressed in number of units defined by the `data_granularity` field." }, "quantiles": { "description": "Quantiles to use for minimize-quantile-loss `optimization_objective`. Up to 5 quantiles are allowed of values between 0 and 1, exclusive. Required if the value of optimization_objective is minimize-quantile-loss. Represents the percent quantiles to use for that objective. Quantiles must be unique.", "type": "array", "items": { "format": "double", "type": "number" } }, "transformations": { "description": "Each transformation will apply transform function to given input column. And the result will be used for training. When creating transformation for BigQuery Struct column, the column should be flattened using \".\" as the delimiter.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformation" }, "type": "array" }, "exportEvaluatedDataItemsConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionExportEvaluatedDataItemsConfig", "description": "Configuration for exporting test set predictions to a BigQuery table. If this configuration is absent, then the export is not performed." }, "windowConfig": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionWindowConfig", "description": "Config containing strategy for generating sliding windows." }, "validationOptions": { "description": "Validation options for the data validation component. The available options are: * \"fail-pipeline\" - default, will validate against the validation and fail the pipeline if it fails. * \"ignore-validation\" - ignore the results of the validation and continue", "type": "string" }, "timeSeriesAttributeColumns": { "description": "Column names that should be used as attribute columns. The value of these columns does not vary as a function of time. For example, store ID or item color.", "type": "array", "items": { "type": "string" } }, "targetColumn": { "type": "string", "description": "The name of the column that the Model is to predict values for. This column must be unavailable at forecast." }, "unavailableAtForecastColumns": { "items": { "type": "string" }, "description": "Names of columns that are unavailable when a forecast is requested. This column contains information for the given entity (identified by the time_series_identifier_column) that is unknown before the forecast For example, actual weather on a given day.", "type": "array" }, "optimizationObjective": { "type": "string", "description": "Objective function the model is optimizing towards. The training process creates a model that optimizes the value of the objective function over the validation set. The supported optimization objectives: * \"minimize-rmse\" (default) - Minimize root-mean-squared error (RMSE). * \"minimize-mae\" - Minimize mean-absolute error (MAE). * \"minimize-rmsle\" - Minimize root-mean-squared log error (RMSLE). * \"minimize-rmspe\" - Minimize root-mean-squared percentage error (RMSPE). * \"minimize-wape-mae\" - Minimize the combination of weighted absolute percentage error (WAPE) and mean-absolute-error (MAE). * \"minimize-quantile-loss\" - Minimize the quantile loss at the quantiles defined in `quantiles`. * \"minimize-mape\" - Minimize the mean absolute percentage error." }, "weightColumn": { "description": "Column name that should be used as the weight column. Higher values in this column give more importance to the row during model training. The column must have numeric values between 0 and 10000 inclusively; 0 means the row is ignored for training. If weight column field is not set, then all rows are assumed to have equal weight of 1. This column must be available at forecast.", "type": "string" }, "additionalExperiments": { "description": "Additional experiment flags for the time series forcasting training.", "type": "array", "items": { "type": "string" } }, "trainBudgetMilliNodeHours": { "description": "Required. The train budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The training cost of the model will not exceed this budget. The final cost will be attempted to be close to the budget, though may end up being (even) noticeably smaller - at the backend's discretion. This especially may happen when further model training ceases to provide any improvements. If the budget is set to a value known to be insufficient to train a model for the given dataset, the training won't be attempted and will error. The train budget must be between 1,000 and 72,000 milli node hours, inclusive.", "type": "string", "format": "int64" }, "holidayRegions": { "items": { "type": "string" }, "description": "The geographical region based on which the holiday effect is applied in modeling by adding holiday categorical array feature that include all holidays matching the date. This option only allowed when data_granularity is day. By default, holiday effect modeling is disabled. To turn it on, specify the holiday region using this option.", "type": "array" }, "forecastHorizon": { "type": "string", "description": "The amount of time into the future for which forecasted values for the target are returned. Expressed in number of units defined by the `data_granularity` field.", "format": "int64" }, "timeColumn": { "description": "The name of the column that identifies time order in the time series. This column must be available at forecast.", "type": "string" }, "availableAtForecastColumns": { "type": "array", "items": { "type": "string" }, "description": "Names of columns that are available and provided when a forecast is requested. These columns contain information for the given entity (identified by the time_series_identifier_column column) that is known at forecast. For example, predicted weather for a specific day." }, "dataGranularity": { "description": "Expected difference in time granularity between rows in the data.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsGranularity" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputs" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationAutoTransformation": { "type": "object", "description": "Training pipeline will infer the proper transformation based on the statistic of dataset.", "properties": { "columnName": { "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationAutoTransformation" }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSourceEvent": { "description": "A single conversation event.", "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSourceEvent", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. Represents the content of the event." } } }, "GoogleCloudAiplatformV1beta1GroundingChunkImage": { "id": "GoogleCloudAiplatformV1beta1GroundingChunkImage", "description": "An `Image` chunk is a piece of evidence that comes from an image search result. It contains the URI of the image search result and the URI of the image. This is used to provide the user with a link to the source of the information.", "properties": { "sourceUri": { "description": "The URI of the image search result page.", "type": "string" }, "imageUri": { "type": "string", "description": "The URI of the image." }, "domain": { "description": "The domain of the image search result page.", "type": "string" }, "title": { "type": "string", "description": "The title of the image search result page." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListModelsResponse": { "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve next page of results. Pass to ListModelsRequest.page_token to obtain that page." }, "models": { "description": "List of Models in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Model" } } }, "id": "GoogleCloudAiplatformV1beta1ListModelsResponse", "description": "Response message for ModelService.ListModels" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectConfig", "properties": { "dir": { "type": "string", "description": "Required. Directory, relative to the source root, in which to run the build." }, "revision": { "description": "Required. The revision to fetch from the Git repository such as a branch, a tag, a commit SHA, or any Git ref.", "type": "string" }, "gitRepositoryLink": { "type": "string", "description": "Required. The Developer Connect Git repository link, formatted as `projects/*/locations/*/connections/*/gitRepositoryLink/*`." } }, "description": "Specifies the configuration for fetching source code from a Git repository that is managed by Developer Connect. This includes the repository, revision, and directory to use." }, "GoogleCloudAiplatformV1beta1RagQueryRanking": { "description": "Configurations for hybrid search results ranking.", "type": "object", "properties": { "alpha": { "type": "number", "format": "float", "description": "Optional. Alpha value controls the weight between dense and sparse vector search results. The range is [0, 1], while 0 means sparse vector search only and 1 means dense vector search only. The default value is 0.5 which balances sparse and dense vector search equally." } }, "id": "GoogleCloudAiplatformV1beta1RagQueryRanking" }, "GenaiVertexV1beta1FunctionResultDelta": { "properties": { "result": { "$ref": "GenaiVertexV1beta1Value" }, "isError": { "type": "boolean" }, "name": { "type": "string" } }, "id": "GenaiVertexV1beta1FunctionResultDelta", "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfig": { "description": "User provided rerun config to submit a rerun pipelinejob. This includes 1. Which task to rerun 2. User override input parameters and artifacts.", "id": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfig", "properties": { "skipDownstreamTasks": { "type": "boolean", "description": "Optional. Whether to skip downstream tasks. Default value is False." }, "inputs": { "description": "Optional. The runtime input of the task overridden by the user.", "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigInputs" }, "taskId": { "format": "int64", "description": "Optional. The system generated ID of the task. Retrieved from original run.", "type": "string" }, "taskName": { "type": "string", "description": "Optional. The name of the task." }, "skipTask": { "type": "boolean", "description": "Optional. Whether to skip this task. Default value is False." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotationAttributedItem": { "properties": { "distance": { "format": "double", "description": "The distance of this item to the annotation.", "type": "number" }, "annotationResourceName": { "description": "The unique ID for each annotation. Used by FE to allocate the annotation in DB.", "type": "string" } }, "description": "Attributed items for a given annotation, typically representing neighbors from the training sets constrained by the query type.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotationAttributedItem" }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoActionRecognitionPredictionParams": { "description": "Prediction model parameters for Video Action Recognition.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsVideoActionRecognitionPredictionParams", "properties": { "confidenceThreshold": { "description": "The Model only returns predictions with at least this confidence score. Default value is 0.0", "type": "number", "format": "float" }, "maxPredictions": { "type": "integer", "description": "The model only returns up to that many top, by confidence score, predictions per frame of the video. If this number is very high, the Model may return fewer predictions per frame. Default value is 50.", "format": "int32" } } }, "GoogleCloudAiplatformV1beta1RagFileParsingConfigLlmParser": { "type": "object", "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfigLlmParser", "properties": { "maxParsingRequestsPerMin": { "type": "integer", "format": "int32", "description": "The maximum number of requests the job is allowed to make to the LLM model per minute. Consult https://cloud.google.com/vertex-ai/generative-ai/docs/quotas and your document size to set an appropriate value here. If unspecified, a default value of 5000 QPM would be used." }, "customParsingPrompt": { "description": "The prompt to use for parsing. If not specified, a default prompt will be used.", "type": "string" }, "globalMaxParsingRequestsPerMin": { "type": "integer", "description": "The maximum number of requests the job is allowed to make to the LLM model per minute in this project. Consult https://cloud.google.com/vertex-ai/generative-ai/docs/quotas and your document size to set an appropriate value here. If this value is not specified, max_parsing_requests_per_min will be used by indexing pipeline job as the global limit.", "format": "int32" }, "modelName": { "type": "string", "description": "The name of a LLM model used for parsing. Format: * `projects/{project_id}/locations/{location}/publishers/{publisher}/models/{model}`" } }, "description": "Specifies the LLM parsing for RagFiles." }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigConsolidationConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigConsolidationConfig", "description": "Represents configuration for customizing how memories are consolidated.", "properties": { "revisionsPerCandidateCount": { "format": "int32", "description": "Optional. Represents the maximum number of revisions to consider for each candidate memory. If not set, then the default value (1) will be used, which means that only the latest revision will be considered.", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1DistillationDataStats": { "id": "GoogleCloudAiplatformV1beta1DistillationDataStats", "description": "Statistics for distillation prompt dataset. These statistics do not include the responses sampled from the teacher model.", "properties": { "trainingDatasetStats": { "$ref": "GoogleCloudAiplatformV1beta1DatasetStats", "description": "Output only. Statistics computed for the training dataset.", "readOnly": true } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchSpec": { "id": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchSpec", "description": "Spec for TrajectoryInOrderMatch metric - returns 1 if tool calls in the reference trajectory appear in the predicted trajectory in the same order, else 0.", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringSchemaFieldSchema": { "description": "Schema field definition.", "properties": { "name": { "description": "Field name.", "type": "string" }, "repeated": { "description": "Describes if the schema field is an array of given data type.", "type": "boolean" }, "dataType": { "type": "string", "description": "Supported data types are: `float` `integer` `boolean` `string` `categorical`" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringSchemaFieldSchema", "type": "object" }, "GoogleCloudAiplatformV1beta1StoredContentsExampleParametersContentSearchKey": { "properties": { "searchKeyGenerationMethod": { "description": "Required. The method of generating a search key.", "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethod" }, "contents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Required. The conversation for generating a search key." } }, "type": "object", "description": "The chat history to use to generate the search key for retrieval.", "id": "GoogleCloudAiplatformV1beta1StoredContentsExampleParametersContentSearchKey" }, "GenaiVertexV1beta1GoogleMapsCallContentGoogleMapsCallArguments": { "type": "object", "id": "GenaiVertexV1beta1GoogleMapsCallContentGoogleMapsCallArguments", "properties": { "queries": { "items": { "type": "string" }, "type": "array", "description": "The queries to be executed." } }, "description": "The arguments to pass to the Google Maps tool." }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateDefaultContainerEnvironment": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateDefaultContainerEnvironment", "properties": { "resources": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateResourceRequirements", "description": "Optional. Resource requests and limits for the default container." }, "defaultContainerCategory": { "enumDescriptions": [ "The default value. This value is unused.", "The default container image for Computer Use.", "The default container image for Shell Sandbox." ], "type": "string", "enum": [ "DEFAULT_CONTAINER_CATEGORY_UNSPECIFIED", "DEFAULT_CONTAINER_CATEGORY_COMPUTER_USE", "DEFAULT_CONTAINER_CATEGORY_SHELL_SANDBOX" ], "description": "Required. The category of the default container image." } }, "description": "The default sandbox runtime environment for default container workloads.", "type": "object" }, "GoogleCloudAiplatformV1beta1CompactSessionRequest": { "description": "Request message for SessionService.CompactSession.", "properties": { "compaction": { "description": "Required. The compaction configuration to apply. At least one compaction category (summarization or event editing) must be enabled within it.", "$ref": "GoogleCloudAiplatformV1beta1CompactionConfig" } }, "id": "GoogleCloudAiplatformV1beta1CompactSessionRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryRecallInstance": { "properties": { "referenceTrajectory": { "description": "Required. Spec for reference tool call trajectory.", "$ref": "GoogleCloudAiplatformV1beta1Trajectory" }, "predictedTrajectory": { "description": "Required. Spec for predicted tool call trajectory.", "$ref": "GoogleCloudAiplatformV1beta1Trajectory" } }, "description": "Spec for TrajectoryRecall instance.", "id": "GoogleCloudAiplatformV1beta1TrajectoryRecallInstance", "type": "object" }, "GoogleCloudAiplatformV1beta1ExpressProject": { "properties": { "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. The time the project was created." }, "projectNumber": { "type": "string", "readOnly": true, "format": "int64", "description": "Output only. The number of the project." }, "defaultApiKey": { "readOnly": true, "description": "Output only. The default API key string of the project.", "type": "string" }, "tier": { "enumDescriptions": [ "Not specified.", "Free tier - initial tier for managed project.", "Paid tier is assigned to managed project after the upgrade." ], "readOnly": true, "enum": [ "TIER_UNSPECIFIED", "TIER_FREE", "TIER_PAID" ], "description": "Output only. The tier of the project.", "type": "string" }, "projectId": { "description": "Output only. The ID of the project.", "readOnly": true, "type": "string" }, "region": { "type": "string", "description": "Output only. The region of the project.", "readOnly": true } }, "type": "object", "description": "The project for Vertex AI Express Mode.", "id": "GoogleCloudAiplatformV1beta1ExpressProject" }, "GoogleCloudAiplatformV1beta1MutateDeployedIndexResponse": { "properties": { "deployedIndex": { "$ref": "GoogleCloudAiplatformV1beta1DeployedIndex", "description": "The DeployedIndex that had been updated in the IndexEndpoint." } }, "id": "GoogleCloudAiplatformV1beta1MutateDeployedIndexResponse", "type": "object", "description": "Response message for IndexEndpointService.MutateDeployedIndex." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsGranularity": { "description": "A duration of time expressed in time granularity units.", "properties": { "unit": { "description": "The time granularity unit of this time period. The supported units are: * \"minute\" * \"hour\" * \"day\" * \"week\" * \"month\" * \"year\"", "type": "string" }, "quantity": { "description": "The number of granularity_units between data points in the training data. If `granularity_unit` is `minute`, can be 1, 5, 10, 15, or 30. For all other values of `granularity_unit`, must be 1.", "type": "string", "format": "int64" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsGranularity" }, "GoogleCloudAiplatformV1beta1A2aTaskEventData": { "id": "GoogleCloudAiplatformV1beta1A2aTaskEventData", "type": "object", "description": "The data describing the change carried by an A2aTaskEvent. Exactly one of the following changes is set per event.", "properties": { "historyAppend": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskHistoryAppend", "description": "Optional. A new message appended to the task history." }, "artifactChange": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskArtifactChange", "description": "Optional. A change to one of the task's artifacts." }, "metadataChange": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskMetadataChange", "description": "Optional. A change to the task-level metadata." }, "statusUpdate": { "description": "Optional. An update to the task's state and status message.", "$ref": "GoogleCloudAiplatformV1beta1A2aTaskStatusUpdate" } } }, "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlDatasetConfig": { "description": "Config for migrating Dataset in automl.googleapis.com to Vertex AI's Dataset.", "properties": { "dataset": { "type": "string", "description": "Required. Full resource name of automl Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`." }, "datasetDisplayName": { "description": "Required. Display name of the Dataset in Vertex AI. System will pick a display name if unspecified.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1MigrateResourceRequestMigrateAutomlDatasetConfig" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrixAnnotationSpecRef": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrixAnnotationSpecRef", "properties": { "id": { "description": "ID of the AnnotationSpec.", "type": "string" }, "displayName": { "description": "Display name of the AnnotationSpec.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ToolUseExample": { "id": "GoogleCloudAiplatformV1beta1ToolUseExample", "type": "object", "properties": { "responseSummary": { "description": "Summary of the tool response to the user query.", "type": "string" }, "extensionOperation": { "$ref": "GoogleCloudAiplatformV1beta1ToolUseExampleExtensionOperation", "description": "Extension operation to call." }, "functionName": { "type": "string", "description": "Function name to call." }, "responseParams": { "description": "Response parameters generated by this tool.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "displayName": { "description": "Required. The display name for example.", "type": "string" }, "requestParams": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Request parameters used for executing this tool.", "type": "object" }, "query": { "type": "string", "description": "Required. Query that should be routed to this tool." } }, "description": "A single example of the tool usage." }, "GenaiVertexV1beta1UrlContextResultStep": { "id": "GenaiVertexV1beta1UrlContextResultStep", "properties": { "isError": { "type": "boolean", "description": "Whether the URL context resulted in an error." }, "result": { "description": "Required. The results of the URL context.", "items": { "$ref": "GenaiVertexV1beta1UrlContextResultStepUrlContextResultItem" }, "type": "array" } }, "description": "URL context result step.", "type": "object" }, "GoogleCloudAiplatformV1beta1ExportDataResponse": { "properties": { "exportedFiles": { "description": "All of the files that are exported in this export operation. For custom code training export, only three (training, validation and test) Cloud Storage paths in wildcard format are populated (for example, gs://.../training-*).", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1ExportDataResponse", "description": "Response message for DatasetService.ExportData.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigClientToAgentConfig": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigClientToAgentConfig", "description": "Configuration for traffic targeting a Reasoning Engine.", "type": "object", "properties": { "agentGateway": { "description": "Required. The resource name of the Agent Gateway to use for inbound traffic. It must be set to a Google-managed gateway whose `governed_access_path` is `CLIENT_TO_AGENT`. Format: `projects/{project}/locations/{location}/agentGateways/{agent_gateway}`", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManualTarget": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManualTarget", "description": "A single target for the traffic split, specifying a Runtime Revision and the percentage of traffic to send to it.", "properties": { "percent": { "format": "int32", "description": "Required. Specifies percent of the traffic to this Runtime Revision.", "type": "integer" }, "runtimeRevisionName": { "type": "string", "description": "Required. The Runtime Revision name to which to send this portion of traffic, if traffic allocation is by Runtime Revision." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1LustreMount": { "id": "GoogleCloudAiplatformV1beta1LustreMount", "description": "Represents a mount configuration for Lustre file system.", "type": "object", "properties": { "instanceIp": { "description": "Required. IP address of the Lustre instance.", "type": "string" }, "volumeHandle": { "type": "string", "description": "Required. The unique identifier of the Lustre volume." }, "filesystem": { "type": "string", "description": "Required. The name of the Lustre filesystem." }, "mountPoint": { "description": "Required. Destination mount path. The Lustre file system will be mounted for the user under /mnt/lustre/", "type": "string" } } }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec": { "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec", "properties": { "stepAutoraterConfigs": { "description": "Optional. Per-step autorater overrides for this predefined metric. Keys are evaluation stage names: \"intent_extraction\", \"rubric_generation\", \"rubric_validation\".", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig" } }, "metricSpecName": { "type": "string", "description": "Required. The name of a pre-defined metric, such as \"instruction_following_v1\" or \"text_quality_v1\"." }, "parameters": { "description": "Optional. The parameters needed to run the pre-defined metric.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "type": "object", "description": "Specification for a pre-defined metric." }, "GoogleCloudAiplatformV1beta1ListIndexesResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListIndexesResponse", "properties": { "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListIndexesRequest.page_token to obtain that page.", "type": "string" }, "indexes": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Index" }, "description": "List of indexes in the requested page." } }, "description": "Response message for IndexService.ListIndexes." }, "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet": { "type": "object", "description": "A review snippet that is used to generate the answer.", "properties": { "reviewId": { "description": "The ID of the review that is being referenced.", "type": "string" }, "title": { "description": "The title of the review.", "type": "string" }, "googleMapsUri": { "description": "A link to show the review on Google Maps.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet" }, "GoogleCloudAiplatformV1beta1TensorboardExperiment": { "description": "A TensorboardExperiment is a group of TensorboardRuns, that are typically the results of a training job run, in a Tensorboard.", "properties": { "displayName": { "type": "string", "description": "User provided name of this TensorboardExperiment." }, "description": { "description": "Description of this TensorboardExperiment.", "type": "string" }, "etag": { "type": "string", "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "updateTime": { "description": "Output only. Timestamp when this TensorboardExperiment was last updated.", "type": "string", "readOnly": true, "format": "google-datetime" }, "createTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this TensorboardExperiment was created.", "type": "string" }, "labels": { "type": "object", "description": "The labels with user-defined metadata to organize your TensorboardExperiment. Label keys and values cannot be longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Dataset (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with `aiplatform.googleapis.com/` and are immutable. The following system labels exist for each Dataset: * `aiplatform.googleapis.com/dataset_metadata_schema`: output only. Its value is the metadata_schema's title.", "additionalProperties": { "type": "string" } }, "source": { "description": "Immutable. Source of the TensorboardExperiment. Example: a custom training job.", "type": "string" }, "name": { "type": "string", "readOnly": true, "description": "Output only. Name of the TensorboardExperiment. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}`" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "GoogleCloudAiplatformV1beta1SummaryMetrics": { "type": "object", "properties": { "totalItems": { "format": "int32", "description": "Optional. The total number of items that were evaluated.", "type": "integer" }, "failedItems": { "description": "Optional. The number of items that failed to be evaluated.", "type": "integer", "format": "int32" }, "metrics": { "description": "Optional. Map of metric name to metric value.", "type": "object", "additionalProperties": { "type": "any" } } }, "description": "The summary metrics for the evaluation run.", "id": "GoogleCloudAiplatformV1beta1SummaryMetrics" }, "GoogleCloudAiplatformV1beta1SchemaImageDatasetMetadata": { "type": "object", "properties": { "gcsBucket": { "type": "string", "description": "Google Cloud Storage Bucket name that contains the blob data of this Dataset." }, "dataItemSchemaUri": { "type": "string", "description": "Points to a YAML file stored on Google Cloud Storage describing payload of the Image DataItems that belong to this Dataset." } }, "id": "GoogleCloudAiplatformV1beta1SchemaImageDatasetMetadata", "description": "The metadata of Datasets that contain Image DataItems." }, "GoogleCloudAiplatformV1beta1StudySpecMetricSpec": { "type": "object", "properties": { "metricId": { "description": "Required. The ID of the metric. Must not contain whitespaces and must be unique amongst all MetricSpecs.", "type": "string" }, "safetyConfig": { "description": "Used for safe search. In the case, the metric will be a safety metric. You must provide a separate metric for objective metric.", "$ref": "GoogleCloudAiplatformV1beta1StudySpecMetricSpecSafetyMetricConfig" }, "goal": { "enum": [ "GOAL_TYPE_UNSPECIFIED", "MAXIMIZE", "MINIMIZE" ], "enumDescriptions": [ "Goal Type will default to maximize.", "Maximize the goal metric.", "Minimize the goal metric." ], "description": "Required. The optimization goal of the metric.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecMetricSpec", "description": "Represents a metric to optimize." }, "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequestStatsAnomaliesObjective": { "id": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequestStatsAnomaliesObjective", "properties": { "topFeatureCount": { "format": "int32", "description": "If set, all attribution scores between SearchModelDeploymentMonitoringStatsAnomaliesRequest.start_time and SearchModelDeploymentMonitoringStatsAnomaliesRequest.end_time are fetched, and page token doesn't take effect in this case. Only used to retrieve attribution score for the top Features which has the highest attribution score in the latest monitoring run.", "type": "integer" }, "type": { "type": "string", "enumDescriptions": [ "Default value, should not be set.", "Raw feature values' stats to detect skew between Training-Prediction datasets.", "Raw feature values' stats to detect drift between Serving-Prediction datasets.", "Feature attribution scores to detect skew between Training-Prediction datasets.", "Feature attribution scores to detect skew between Prediction datasets collected within different time windows." ], "enum": [ "MODEL_DEPLOYMENT_MONITORING_OBJECTIVE_TYPE_UNSPECIFIED", "RAW_FEATURE_SKEW", "RAW_FEATURE_DRIFT", "FEATURE_ATTRIBUTION_SKEW", "FEATURE_ATTRIBUTION_DRIFT" ] } }, "type": "object", "description": "Stats requested for specific objective." }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecShellEnvironment": { "type": "object", "properties": {}, "description": "The shell environment.", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpecShellEnvironment" }, "GoogleCloudAiplatformV1beta1NearestNeighborsNeighbor": { "id": "GoogleCloudAiplatformV1beta1NearestNeighborsNeighbor", "properties": { "distance": { "type": "number", "format": "double", "description": "The distance between the neighbor and the query vector." }, "entityKeyValues": { "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponse", "description": "The attributes of the neighbor, e.g. filters, crowding and metadata Note that full entities are returned only when \"return_full_entity\" is set to true. Otherwise, only the \"entity_id\" and \"distance\" fields are populated." }, "entityId": { "description": "The id of the similar entity.", "type": "string" } }, "description": "A neighbor of the query vector.", "type": "object" }, "GoogleCloudAiplatformV1beta1SafetySetting": { "properties": { "category": { "enumDescriptions": [ "Default value. This value is unused.", "Content that promotes violence or incites hatred against individuals or groups based on certain attributes.", "Content that promotes, facilitates, or enables dangerous activities.", "Abusive, threatening, or content intended to bully, torment, or ridicule.", "Content that contains sexually explicit material.", "Deprecated: Election filter is not longer supported. The harm category is civic integrity.", "Images that contain hate speech.", "Images that contain dangerous content.", "Images that contain harassment.", "Images that contain sexually explicit content.", "Prompts designed to bypass safety filters." ], "description": "Required. The harm category to be blocked.", "enumDeprecated": [ false, false, false, false, false, true, false, false, false, false, false ], "type": "string", "enum": [ "HARM_CATEGORY_UNSPECIFIED", "HARM_CATEGORY_HATE_SPEECH", "HARM_CATEGORY_DANGEROUS_CONTENT", "HARM_CATEGORY_HARASSMENT", "HARM_CATEGORY_SEXUALLY_EXPLICIT", "HARM_CATEGORY_CIVIC_INTEGRITY", "HARM_CATEGORY_IMAGE_HATE", "HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", "HARM_CATEGORY_IMAGE_HARASSMENT", "HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", "HARM_CATEGORY_JAILBREAK" ] }, "threshold": { "type": "string", "description": "Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.", "enumDescriptions": [ "The harm block threshold is unspecified.", "Block content with a low harm probability or higher.", "Block content with a medium harm probability or higher.", "Block content with a high harm probability.", "Do not block any content, regardless of its harm probability.", "Turn off the safety filter entirely." ], "enum": [ "HARM_BLOCK_THRESHOLD_UNSPECIFIED", "BLOCK_LOW_AND_ABOVE", "BLOCK_MEDIUM_AND_ABOVE", "BLOCK_ONLY_HIGH", "BLOCK_NONE", "OFF" ] }, "method": { "description": "Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.", "enum": [ "HARM_BLOCK_METHOD_UNSPECIFIED", "SEVERITY", "PROBABILITY" ], "enumDescriptions": [ "The harm block method is unspecified.", "The harm block method uses both probability and severity scores.", "The harm block method uses the probability score." ], "type": "string" } }, "type": "object", "description": "A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.", "id": "GoogleCloudAiplatformV1beta1SafetySetting" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionImageSegmentationPredictionResult": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionImageSegmentationPredictionResult", "properties": { "categoryMask": { "description": "A PNG image where each pixel in the mask represents the category in which the pixel in the original image was predicted to belong to. The size of this image will be the same as the original image. The mapping between the AnntoationSpec and the color can be found in model's metadata. The model will choose the most likely category and if none of the categories reach the confidence threshold, the pixel will be marked as background.", "type": "string" }, "confidenceMask": { "description": "A one channel image which is encoded as an 8bit lossless PNG. The size of the image will be the same as the original image. For a specific pixel, darker color means less confidence in correctness of the cateogry in the categoryMask for the corresponding pixel. Black means no confidence and white means complete confidence.", "type": "string" } }, "description": "Prediction output format for Image Segmentation." }, "GenaiVertexV1beta1AllowedTools": { "id": "GenaiVertexV1beta1AllowedTools", "type": "object", "description": "The configuration for allowed tools.", "properties": { "mode": { "enumDescriptions": [ "Default value. This value is unused.", "Auto tool choice.", "Any tool choice.", "No tool choice.", "Validated tool choice." ], "description": "The mode of the tool choice.", "type": "string", "enum": [ "TOOL_CHOICE_TYPE_UNSPECIFIED", "AUTO", "ANY", "NONE", "VALIDATED" ] }, "tools": { "description": "The names of the allowed tools.", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudAiplatformV1beta1Skill": { "description": "A skill.", "properties": { "compatibility": { "description": "Optional. Specifies the compatibility of the Skill. Indicates environment requirements (intended product, system packages, network access, etc.). This should align with `compatibility` in the `SKILL.md` file.", "type": "string" }, "displayName": { "type": "string", "description": "Required. Provides the display name of the Skill. This should align with `name` in the `SKILL.md` file." }, "state": { "enumDescriptions": [ "The state of the Skill is unspecified.", "The Skill is active.", "The Skill is being created.", "The Skill was created, but failed to process.", "The Skill is being deleted." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "FAILED", "DELETING" ], "description": "Output only. The state of the Skill.", "readOnly": true, "type": "string" }, "skillSource": { "type": "string", "enumDescriptions": [ "The skill source is unspecified.", "The skill is created by a user.", "The skill is a system skill." ], "enum": [ "SKILL_SOURCE_UNSPECIFIED", "USER", "SYSTEM" ], "readOnly": true, "description": "Output only. The source of the Skill." }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this Skill was most recently updated.", "readOnly": true, "format": "google-datetime" }, "license": { "type": "string", "description": "Optional. Specifies the license of the Skill. This should be an SPDX license identifier (e.g., \"MIT\", \"Apache-2.0\"). See https://spdx.org/licenses/. This should align with `license` in the `SKILL.md` file." }, "name": { "description": "Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`", "type": "string" }, "description": { "description": "Required. Describes the Skill. Should describe both what the skill does and when to use it. Should include specific keywords that help agents identify relevant tasks. This should align with `description` in the `SKILL.md` file.", "type": "string" }, "labels": { "description": "The labels with user-defined metadata to organize Skills.", "additionalProperties": { "type": "string" }, "type": "object" }, "sha256": { "type": "string", "description": "Output only. The SHA256 checksum of the zipped filesystem.", "readOnly": true }, "zippedFilesystem": { "type": "string", "format": "byte", "description": "Required. Provides the zipped filesystem of the Skill. This should contain the `SKILL.md` file at the root of the zip and optional directories for scripts, references, and assets. Directory should align with the directory structure specified at https://agentskills.io/specification#directory-structure." }, "createTime": { "type": "string", "description": "Output only. Timestamp when this Skill was created.", "format": "google-datetime", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1Skill", "type": "object" }, "GoogleCloudAiplatformV1beta1VertexRagStoreRagResource": { "id": "GoogleCloudAiplatformV1beta1VertexRagStoreRagResource", "properties": { "ragCorpus": { "type": "string", "description": "Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`" }, "ragFileIds": { "items": { "type": "string" }, "type": "array", "description": "Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field." } }, "description": "The definition of the Rag resource.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListDatasetsResponse": { "id": "GoogleCloudAiplatformV1beta1ListDatasetsResponse", "description": "Response message for DatasetService.ListDatasets.", "type": "object", "properties": { "datasets": { "description": "A list of Datasets that matches the specified filter in the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Dataset" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } } }, "GoogleCloudAiplatformV1beta1MetadataStoreDataplexConfig": { "description": "Represents Dataplex integration settings.", "type": "object", "properties": { "enabledPipelinesLineage": { "description": "Optional. Whether or not Data Lineage synchronization is enabled for Vertex Pipelines.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1MetadataStoreDataplexConfig" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordHistoryAppend": { "description": "An event payload that appends a new message to the task history.", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordHistoryAppend", "properties": { "message": { "description": "Required. The message to append to the task history.", "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordMessage" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ShieldedVmConfig": { "type": "object", "properties": { "enableSecureBoot": { "type": "boolean", "description": "Defines whether the instance has [Secure Boot](https://cloud.google.com/compute/shielded-vm/docs/shielded-vm#secure-boot) enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails." } }, "description": "A set of Shielded Instance options. See [Images using supported Shielded VM features](https://cloud.google.com/compute/docs/instances/modifying-shielded-vm).", "id": "GoogleCloudAiplatformV1beta1ShieldedVmConfig" }, "GoogleCloudAiplatformV1beta1ListNotebookRuntimesResponse": { "id": "GoogleCloudAiplatformV1beta1ListNotebookRuntimesResponse", "description": "Response message for NotebookService.ListNotebookRuntimes.", "type": "object", "properties": { "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListNotebookRuntimesRequest.page_token to obtain that page.", "type": "string" }, "notebookRuntimes": { "type": "array", "description": "List of NotebookRuntimes in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntime" } } } }, "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorer": { "description": "ReinforcementTuningAutoraterScorer is used to score parsed responses for classification based autorater use cases. For example, for math problems, users can use classification based autorater to calculate rewards based on the autorater parsed response against a reference answer.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorer", "properties": { "autoraterResponseParseConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningParseResponseConfig", "description": "Parses autorater returned response for scoring. For example, if the autorater response has reward stored in the `2.0` block, defining a parsing response config using regex `\".*(.*?)\"` will return a score `\"2.0\"`." }, "parsedResponseConversionScorer": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerParsedResponseConversionScorer", "description": "Scores autorater responses by directly converting parsed autorater response to a float reward. Note: Reward is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`." }, "autoraterConfig": { "description": "Autorater config for classification based autorater", "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig" }, "exactMatchScorer": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerExactMatchScorer", "description": "Scores autorater responses by using string match reward scorer." }, "autoraterPrompt": { "description": "The prompt for an autorater to scorer the parsed sample response. This field supports the following placeholders that will be replaced before scoring: - {{prompt}} - {{response}} - {{system_instruction}} - {{references.key}} ", "type": "string" } } }, "GoogleCloudAiplatformV1beta1GenerateLossClustersRequest": { "properties": { "inlineResults": { "description": "Inline evaluation results. Useful for ephemeral analysis in notebooks/SDKs where data isn't persisted.", "$ref": "GoogleCloudAiplatformV1beta1GenerateLossClustersRequestEvaluationResultList" }, "configs": { "description": "Required. Configuration for the analysis algorithm. Analysis for multiple metrics and multiple candidates could be specified.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1LossAnalysisConfig" } }, "evaluationSet": { "type": "string", "description": "Reference to a persisted EvaluationSet. The service will read items from this set." } }, "id": "GoogleCloudAiplatformV1beta1GenerateLossClustersRequest", "type": "object", "description": "Request message for EvaluationAnalyticsService.GenerateLossClusters." }, "GoogleCloudAiplatformV1beta1Agent": { "type": "object", "properties": { "base_agent": { "description": "Required. Immutable. The base agent for the agent. Supported values: * `antigravity-preview-05-2026` Immutable: `UpdateAgent` rejects a change, including clearing it. The kind of agent this is gets derived from this field when the agent is created and is recorded then; nothing recomputes it afterwards, so a later change would leave the agent described as one kind and behaving as another. Create a new agent instead.", "type": "string" }, "tools": { "items": { "$ref": "GoogleCloudAiplatformV1beta1AgentTool" }, "description": "Optional. The tools available to the agent.", "type": "array" }, "id": { "description": "Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "type": "string" }, "effectiveIdentity": { "readOnly": true, "description": "Output only. The resolved Agent Identity (SPIFFE principal) of the agent.", "type": "string" }, "description": { "type": "string", "description": "Optional. The description of the agent." }, "created": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. The time the agent was created." }, "modelConfig": { "description": "Optional. Model configuration for the agent. When set, tasks running under this agent default to this model configuration if they do not specify their own.", "$ref": "GoogleCloudAiplatformV1beta1AgentModelConfig" }, "object": { "description": "Output only. The object type of the resource. For agents, the value is `agent`.", "readOnly": true, "type": "string" }, "updated": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time the agent was last updated." }, "system_instruction": { "description": "Optional. The instructions for the agent to follow. These instructions are passed to the LLM as a system instruction.", "type": "string" }, "base_environment": { "description": "Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`.", "type": "any" }, "name": { "type": "string", "description": "Identifier. The resource name of the agent. Format: `projects/{project}/locations/{location}/agents/{agent}`." }, "observabilityConfig": { "$ref": "GoogleCloudAiplatformV1beta1ObservabilityConfig", "description": "Optional. Observability settings for this agent's sessions." }, "metadata": { "description": "Optional. The metadata for the agent.", "type": "object", "additionalProperties": { "type": "string" } } }, "description": "A Vertex agent contains instructions and configurations for the LLM to execute a certain task.", "id": "GoogleCloudAiplatformV1beta1Agent" }, "GoogleCloudAiplatformV1beta1A2aTask": { "id": "GoogleCloudAiplatformV1beta1A2aTask", "type": "object", "description": "An A2aTask represents a unit of work.", "properties": { "statusDetails": { "$ref": "GoogleCloudAiplatformV1beta1TaskStatusDetails", "description": "Optional. The status details of the task." }, "status": { "description": "Output only. The status of the task, including the state, status message, and timestamp.", "$ref": "GoogleCloudAiplatformV1beta1A2aTaskStatus", "readOnly": true }, "ttl": { "type": "string", "description": "Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]", "format": "google-duration" }, "generation": { "format": "int64", "readOnly": true, "description": "Output only. The task generation number.", "type": "string" }, "contextId": { "type": "string", "description": "Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id)." }, "nextEventSequenceNumber": { "description": "Output only. The next event sequence number to be appended to the task. This value starts at 1 and is guaranteed to be monotonically increasing.", "type": "string", "readOnly": true, "format": "int64" }, "userId": { "type": "string", "description": "Optional. Task owner user ID." }, "history": { "type": "array", "readOnly": true, "description": "Output only. The history of the task messages.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskMessage" } }, "artifacts": { "description": "Output only. The artifacts produced by the task.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskArtifact" }, "type": "array", "readOnly": true }, "updateTime": { "description": "Output only. The last update timestamp of the task.", "readOnly": true, "type": "string", "format": "google-datetime" }, "appId": { "type": "string", "description": "Optional. Agent application which created the task." }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. The creation timestamp of the task." }, "name": { "type": "string", "description": "Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/a2aTasks/{a2a_task}` or `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTasks/{a2a_task}`" }, "output": { "description": "Optional. The final output of the task.", "$ref": "GoogleCloudAiplatformV1beta1TaskOutput" }, "state": { "description": "Output only. The state of the task. The state of a new task is SUBMITTED by default. The state of a task can only be updated via AppendA2aTaskEvents API.", "type": "string", "enumDescriptions": [ "Task state unspecified. Default value if not set.", "Task is submitted and waiting to be processed.", "Task is actively being processed.", "Task is finished.", "Task is cancelled.", "Task has failed.", "Task is rejected by the system.", "Task requires input from the user.", "Task requires auth (e.g. OAuth) from the user.", "Task is paused." ], "enum": [ "STATE_UNSPECIFIED", "SUBMITTED", "WORKING", "COMPLETED", "CANCELLED", "FAILED", "REJECTED", "INPUT_REQUIRED", "AUTH_REQUIRED", "PAUSED" ], "readOnly": true }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. Arbitrary, user-defined metadata." }, "expireTime": { "format": "google-datetime", "type": "string", "description": "Optional. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `ttl` if set on the request" } } }, "GoogleCloudAiplatformV1beta1ModelExplanation": { "id": "GoogleCloudAiplatformV1beta1ModelExplanation", "description": "Aggregated explanation metrics for a Model over a set of instances.", "type": "object", "properties": { "meanAttributions": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Attribution" }, "description": "Output only. Aggregated attributions explaining the Model's prediction outputs over the set of instances. The attributions are grouped by outputs. For Models that predict only one output, such as regression Models that predict only one score, there is only one attibution that explains the predicted output. For Models that predict multiple outputs, such as multiclass Models that predict multiple classes, each element explains one specific item. Attribution.output_index can be used to identify which output this attribution is explaining. The baselineOutputValue, instanceOutputValue and featureAttributions fields are averaged over the test data. NOTE: Currently AutoML tabular classification Models produce only one attribution, which averages attributions over all the classes it predicts. Attribution.approximation_error is not populated.", "type": "array", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1CheckSignUpEligibilityResponse": { "properties": { "eligibility": { "enum": [ "ELIGIBILITY_STATUS_UNSPECIFIED", "ELIGIBLE", "IN_SCOPE", "INELIGIBLE" ], "description": "The eligibility status of the user.", "enumDescriptions": [ "The default value. This value is unused.", "The user is eligible to sign up for Vertex AI Express Mode.", "The user is in scope for Vertex AI Express Mode.", "The user is ineligible to sign up for Vertex AI Express Mode." ], "type": "string" } }, "type": "object", "description": "Response message for ExpressModeService.CheckSignUpEligibility.", "id": "GoogleCloudAiplatformV1beta1CheckSignUpEligibilityResponse" }, "GoogleCloudAiplatformV1beta1ActivateOnlineEvaluatorOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1ActivateOnlineEvaluatorOperationMetadata", "description": "Metadata for the ActivateOnlineEvaluator operation.", "type": "object", "properties": { "genericMetadata": { "description": "Common part of operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1UnmanagedContainerModel": { "id": "GoogleCloudAiplatformV1beta1UnmanagedContainerModel", "type": "object", "description": "Contains model information necessary to perform batch prediction without requiring a full model import.", "properties": { "artifactUri": { "description": "The path to the directory containing the Model artifact and any of its supporting files.", "type": "string" }, "containerSpec": { "description": "Input only. The specification of the container that is to be used when deploying this Model.", "$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec" }, "predictSchemata": { "$ref": "GoogleCloudAiplatformV1beta1PredictSchemata", "description": "Contains the schemata used in Model's predictions and explanations" } } }, "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfig": { "id": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfig", "type": "object", "properties": { "ranking": { "description": "Optional. Config for ranking and reranking.", "$ref": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigRanking" }, "topK": { "description": "Optional. The number of contexts to retrieve.", "format": "int32", "type": "integer" }, "filter": { "description": "Optional. Config for filters.", "$ref": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigFilter" }, "hybridSearch": { "description": "Optional. Config for Hybrid Search.", "$ref": "GenaiVertexV1beta1RagStoreConfigRagRetrievalConfigHybridSearch" } }, "description": "Specifies the context retrieval config." }, "CloudAiLargeModelsVisionGenerateVideoExperimentsVESchedulingConfig": { "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsVESchedulingConfig", "description": "Scheduling configuration for Veo Experimental.", "type": "object", "properties": { "enableRetry": { "type": "boolean", "description": "Optional. If true, enable retries on transient errors with default backoff." } } }, "GoogleCloudAiplatformV1beta1ListTensorboardsResponse": { "id": "GoogleCloudAiplatformV1beta1ListTensorboardsResponse", "type": "object", "properties": { "nextPageToken": { "description": "A token, which can be sent as ListTensorboardsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "tensorboards": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensorboard" }, "description": "The Tensorboards mathching the request." } }, "description": "Response message for TensorboardService.ListTensorboards." }, "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringBigQueryTable": { "properties": { "logSource": { "description": "The source of log.", "enum": [ "LOG_SOURCE_UNSPECIFIED", "TRAINING", "SERVING" ], "type": "string", "enumDescriptions": [ "Unspecified source.", "Logs coming from Training dataset.", "Logs coming from Serving traffic." ] }, "requestResponseLoggingSchemaVersion": { "type": "string", "readOnly": true, "description": "Output only. The schema version of the request/response logging BigQuery table. Default to v1 if unset." }, "logType": { "enum": [ "LOG_TYPE_UNSPECIFIED", "PREDICT", "EXPLAIN" ], "description": "The type of log.", "type": "string", "enumDescriptions": [ "Unspecified type.", "Predict logs.", "Explain logs." ] }, "bigqueryTablePath": { "description": "The created BigQuery table to store logs. Customer could do their own query & analysis. Format: `bq://.model_deployment_monitoring_._`", "type": "string" } }, "description": "ModelDeploymentMonitoringBigQueryTable specifies the BigQuery table name as well as some information of the logs stored in this table.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringBigQueryTable" }, "GoogleCloudAiplatformV1beta1SchemaVisualInspectionClassificationLabelSavedQueryMetadata": { "properties": { "multiLabel": { "description": "Whether or not the classification label is multi_label.", "type": "boolean" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaVisualInspectionClassificationLabelSavedQueryMetadata" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage", "description": "The prompt message that aligns with the prompt message in google.cloud.aiplatform.master.GenerateContentRequest.", "properties": { "model": { "description": "The model name.", "type": "string" }, "tools": { "description": "A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } }, "systemInstruction": { "description": "The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph.", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "generationConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig", "description": "Generation config." }, "safetySettings": { "type": "array", "description": "Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SafetySetting" } }, "contents": { "description": "The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "toolConfig": { "description": "Tool config. This config is shared for all tools provided in the request.", "$ref": "GoogleCloudAiplatformV1beta1ToolConfig" } } }, "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestEntityTypeSpec": { "description": "Selects Features of an EntityType to read values of and specifies read settings.", "id": "GoogleCloudAiplatformV1beta1BatchReadFeatureValuesRequestEntityTypeSpec", "type": "object", "properties": { "entityTypeId": { "description": "Required. ID of the EntityType to select Features. The EntityType id is the entity_type_id specified during EntityType creation.", "type": "string" }, "settings": { "description": "Per-Feature settings for the batch read.", "items": { "$ref": "GoogleCloudAiplatformV1beta1DestinationFeatureSetting" }, "type": "array" }, "featureSelector": { "description": "Required. Selectors choosing which Feature values to read from the EntityType.", "$ref": "GoogleCloudAiplatformV1beta1FeatureSelector" } } }, "GoogleCloudAiplatformV1beta1EvaluationResults": { "id": "GoogleCloudAiplatformV1beta1EvaluationResults", "type": "object", "properties": { "summaryMetrics": { "$ref": "GoogleCloudAiplatformV1beta1SummaryMetrics", "description": "Optional. The summary metrics for the evaluation run." }, "evaluationSet": { "type": "string", "description": "The evaluation set where item level results are stored." }, "lossAnalysisResults": { "description": "Output only. The results of the auto-loss analysis performed on the eval set associated with the run.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LossAnalysisResult" }, "readOnly": true, "type": "array" } }, "description": "The results of the evaluation run." }, "GoogleCloudAiplatformV1beta1ToolComputerUse": { "id": "GoogleCloudAiplatformV1beta1ToolComputerUse", "type": "object", "properties": { "disabledSafetyPolicies": { "type": "array", "items": { "type": "string", "enumDescriptions": [ "The safety policy is unspecified.", "Policy that restricts financial transactions.", "Policy that restricts modification of sensitive data.", "Policy that restricts the use of communication tools.", "Policy that restricts the creation of accounts.", "Policy that restricts general data modification.", "Policy that restricts user consent management.", "Policy that restricts interaction with legal terms and agreements." ], "enum": [ "SAFETY_POLICY_UNSPECIFIED", "FINANCIAL_TRANSACTIONS", "SENSITIVE_DATA_MODIFICATION", "COMMUNICATION_TOOL", "ACCOUNT_CREATION", "DATA_MODIFICATION", "USER_CONSENT_MANAGEMENT", "LEGAL_TERMS_AND_AGREEMENTS" ] }, "description": "Optional. A list of safety policies to disable for the computer use tool." }, "environment": { "enumDescriptions": [ "The environment is unspecified.", "The tool operates in a web browser.", "The tool operates in a mobile environment.", "The tool operates in a desktop environment." ], "enum": [ "ENVIRONMENT_UNSPECIFIED", "ENVIRONMENT_BROWSER", "ENVIRONMENT_MOBILE", "ENVIRONMENT_DESKTOP" ], "type": "string", "description": "Required. The target environment where the computer use tool operates." }, "excludedPredefinedFunctions": { "description": "Optional. A list of predefined functions to explicitly exclude from the model call. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included. Excluding functions allows for a more restricted action space or custom definitions for predefined functions.", "type": "array", "items": { "type": "string" } }, "enablePromptInjectionDetection": { "type": "boolean", "description": "Optional. Whether to enable the prompt injection detection check on the computer use request." } }, "description": "A tool that enables the model to interact directly with a computer environment." }, "GoogleCloudAiplatformV1beta1LossCluster": { "properties": { "taxonomyEntry": { "description": "The structured definition of the loss taxonomy for this cluster.", "$ref": "GoogleCloudAiplatformV1beta1LossTaxonomyEntry" }, "clusterId": { "description": "Unique identifier for the loss cluster within the scope of the analysis result.", "type": "string" }, "itemCount": { "type": "integer", "format": "int32", "description": "The total number of EvaluationItems falling into this cluster." }, "examples": { "description": "A list of examples that belong to this cluster. This links the cluster back to the specific EvaluationItems and Rubrics.", "items": { "$ref": "GoogleCloudAiplatformV1beta1LossExample" }, "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1LossCluster", "description": "Represents a semantic grouping of failures (e.g., \"Hallucination of Action\")." }, "GoogleCloudAiplatformV1beta1TunedModel": { "id": "GoogleCloudAiplatformV1beta1TunedModel", "description": "The Model Registry Model and Online Prediction Endpoint associated with this TuningJob.", "properties": { "endpoint": { "readOnly": true, "type": "string", "description": "Output only. A resource name of an Endpoint. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`." }, "checkpoints": { "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1TunedModelCheckpoint" }, "type": "array", "description": "Output only. The checkpoints associated with this TunedModel. This field is only populated for tuning jobs that enable intermediate checkpoints." }, "model": { "type": "string", "description": "Output only. The resource name of the TunedModel. Format: `projects/{project}/locations/{location}/models/{model}@{version_id}` When tuning from a base model, the version ID will be 1. For continuous tuning, if the provided tuned_model_display_name is set and different from parent model's display name, the tuned model will have a new parent model with version 1. Otherwise the version id will be incremented by 1 from the last version ID in the parent model. E.g., `projects/{project}/locations/{location}/models/{model}@{last_version_id + 1}`", "readOnly": true } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringOutputSpec": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringOutputSpec", "description": "Specification for the export destination of monitoring results, including metrics, logs, etc.", "properties": { "gcsBaseDirectory": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "Google Cloud Storage base folder path for metrics, error logs, etc." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricGenerationSpec": { "description": "Specification for how rubrics should be generated.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricGenerationSpec", "type": "object", "properties": { "promptTemplate": { "type": "string", "description": "Optional. Template for the prompt used to generate rubrics. The details should be updated based on the most-recent recipe requirements." }, "rubricTypeOntology": { "items": { "type": "string" }, "type": "array", "description": "Optional. An optional, pre-defined list of allowed types for generated rubrics. If this field is provided, it implies `include_rubric_type` should be true, and the generated rubric types should be chosen from this ontology." }, "modelConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig", "description": "Optional. Configuration for the model used in rubric generation. Configs including sampling count and base model can be specified here. Flipping is not supported for rubric generation." }, "rubricContentType": { "enumDescriptions": [ "The content type to generate is not specified.", "Generate rubrics based on properties.", "Generate rubrics in an NL question answer format.", "Generate rubrics in a unit test format." ], "enum": [ "RUBRIC_CONTENT_TYPE_UNSPECIFIED", "PROPERTY", "NL_QUESTION_ANSWER", "PYTHON_CODE_ASSERTION" ], "type": "string", "description": "Optional. The type of rubric content to be generated." }, "metricResourceName": { "type": "string", "description": "Optional. Resource name of the metric definition." } } }, "GoogleCloudAiplatformV1beta1ListOnlineEvaluatorsResponse": { "properties": { "onlineEvaluators": { "items": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluator" }, "type": "array", "description": "A list of OnlineEvaluators matching the request." }, "nextPageToken": { "description": "A token to retrieve the next page. Absence of this field indicates there are no subsequent pages.", "type": "string" } }, "type": "object", "description": "Response message for ListOnlineEvaluators.", "id": "GoogleCloudAiplatformV1beta1ListOnlineEvaluatorsResponse" }, "CloudAiLargeModelsVisionSeamless": { "properties": { "tessellateHorizontal": { "description": "If true, the generated video will be tessellatable as a horizontal tessellation.", "type": "boolean" }, "loop": { "type": "boolean", "description": "If true, the generated video will be loopable (seamless time looping)." }, "tessellateVertical": { "type": "boolean", "description": "If true, the generated video will be tessellatable as a vertical tessellation." } }, "type": "object", "id": "CloudAiLargeModelsVisionSeamless" }, "GoogleCloudAiplatformV1beta1CorroborateContentResponse": { "description": "Response message for CorroborateContent.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CorroborateContentResponse", "properties": { "corroborationScore": { "format": "float", "description": "Confidence score of corroborating content. Value is [0,1] with 1 is the most confidence.", "type": "number" }, "claims": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Claim" }, "description": "Claims that are extracted from the input content and facts that support the claims." } } }, "GoogleCloudAiplatformV1beta1EnableMonitoredAgentRequest": { "id": "GoogleCloudAiplatformV1beta1EnableMonitoredAgentRequest", "properties": {}, "description": "Request message for AgentAnomalyDetectionService.EnableMonitoredAgent.", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchNearestEntitiesResponse": { "description": "Response message for FeatureOnlineStoreService.SearchNearestEntities", "properties": { "nearestNeighbors": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighbors", "description": "The nearest neighbors of the query entity." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SearchNearestEntitiesResponse" }, "GenaiVertexV1beta1McpServerToolCallStep": { "description": "MCPServer tool call step.", "properties": { "name": { "description": "Required. The name of the tool which was called.", "type": "string" }, "arguments": { "$ref": "GenaiVertexV1beta1Struct", "description": "Required. The JSON object of arguments for the function." }, "serverName": { "description": "Required. The name of the used MCP server.", "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1McpServerToolCallStep" }, "GoogleCloudAiplatformV1beta1LossTaxonomyEntry": { "type": "object", "description": "Defines a specific entry in the loss pattern taxonomy.", "properties": { "description": { "description": "A detailed description of this loss pattern. Example: \"The agent verbally confirms an action without executing the tool.\"", "type": "string" }, "l1Category": { "type": "string", "description": "The primary category of the loss (e.g., \"Hallucination\", \"Tool Calling\"). This field is typically required." }, "l2Category": { "description": "The secondary category of the loss (e.g., \"Hallucination of Action\", \"Incorrect Tool Selection\").", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1LossTaxonomyEntry" }, "GoogleCloudAiplatformV1beta1SchemaTimeSegment": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTimeSegment", "properties": { "endTimeOffset": { "type": "string", "format": "google-duration", "description": "End of the time segment (exclusive), represented as the duration since the start of the DataItem." }, "startTimeOffset": { "type": "string", "format": "google-duration", "description": "Start of the time segment (inclusive), represented as the duration since the start of the DataItem." } }, "description": "A time period inside of a DataItem that has a time dimension (e.g. video)." }, "GenaiVertexV1beta1ArgumentsDelta": { "id": "GenaiVertexV1beta1ArgumentsDelta", "type": "object", "properties": { "arguments": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfigScaling": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfigScaling", "type": "object", "description": "Online serving scaling configuration. If min_node_count and max_node_count are set to the same value, the cluster will be configured with the fixed number of node (no auto-scaling).", "properties": { "maxNodeCount": { "format": "int32", "description": "The maximum number of nodes to scale up to. Must be greater than min_node_count, and less than or equal to 10 times of 'min_node_count'.", "type": "integer" }, "cpuUtilizationTarget": { "format": "int32", "description": "Optional. The cpu utilization that the Autoscaler should be trying to achieve. This number is on a scale from 0 (no utilization) to 100 (total utilization), and is limited between 10 and 80. When a cluster's CPU utilization exceeds the target that you have set, Bigtable immediately adds nodes to the cluster. When CPU utilization is substantially lower than the target, Bigtable removes nodes. If not set or set to 0, default to 50.", "type": "integer" }, "minNodeCount": { "description": "Required. The minimum number of nodes to scale down to. Must be greater than or equal to 1.", "format": "int32", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInteractionsSource": { "type": "object", "properties": { "interactions": { "type": "array", "description": "Required. The interactions to import. Format: `projects/{project}/locations/{location}/interactions/{interaction}`.", "items": { "type": "string" } }, "geminiAgentConfig": { "$ref": "GoogleCloudAiplatformV1beta1GeminiAgentConfig", "description": "Optional. Gemini Agent (Vertex AI Agent resource)." } }, "description": "Source for importing interactions from the Interactions API into an EvaluationSet. The agent identity is specified once, with a list of interaction IDs to import.", "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInteractionsSource" }, "GenaiVertexV1beta1VideoResponseFormat": { "properties": { "gcsUri": { "description": "The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.", "type": "string" }, "aspectRatio": { "description": "The aspect ratio for the video output.", "enum": [ "ASPECT_RATIO_UNSPECIFIED", "ASPECT_RATIO_SIXTEEN_BY_NINE", "ASPECT_RATIO_NINE_BY_SIXTEEN" ], "enumDescriptions": [ "Default value. This value is unused.", "16:9 aspect ratio.", "9:16 aspect ratio." ], "type": "string" }, "duration": { "type": "string", "description": "The duration for the video output.", "format": "google-duration" }, "delivery": { "type": "string", "description": "The delivery mode for the video output.", "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ], "enumDescriptions": [ "Default value. This value is unused.", "Video data is returned inline in the response.", "Video data is returned as a URI." ] }, "resolution": { "enumDescriptions": [ "Default value. This value is unused.", "360p resolution.", "720p resolution.", "1080p resolution.", "4K resolution." ], "type": "string", "description": "The video output resolution. Defaults to 720p.", "enum": [ "RESOLUTION_UNSPECIFIED", "RESOLUTION_THREE_SIXTY_P", "RESOLUTION_SEVEN_TWENTY_P", "RESOLUTION_TEN_EIGHTY_P", "RESOLUTION_FOUR_K" ] } }, "type": "object", "description": "Configuration for video output format.", "id": "GenaiVertexV1beta1VideoResponseFormat" }, "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponse": { "id": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponse", "type": "object", "properties": { "monthlyUsageData": { "type": "object", "description": "Maps year-month (YYYYMM) string to per month usage data.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerMonthUsageData" } } }, "description": "Response message for TensorboardService.ReadTensorboardUsage." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformation", "type": "object", "properties": { "repeatedCategorical": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalArrayTransformation" }, "repeatedNumeric": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericArrayTransformation" }, "categorical": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationCategoricalTransformation" }, "auto": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationAutoTransformation" }, "timestamp": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTimestampTransformation" }, "repeatedText": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextArrayTransformation" }, "numeric": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericTransformation" }, "text": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextTransformation" } } }, "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsSearchStrategy": { "type": "object", "description": "The search strategy for the metadata value of the `key`.", "id": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsSearchStrategy", "properties": { "searchStrategyType": { "enum": [ "SEARCH_STRATEGY_TYPE_UNSPECIFIED", "NO_SEARCH", "EXACT_SEARCH" ], "enumDescriptions": [ "Unspecified search strategy type.", "metadata values of the `key` above will not be searchable.", "When searching with `key`, the value must be exactly as the metadata value that has been ingested." ], "type": "string", "description": "The search strategy type to be applied on the metadata key." } } }, "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata": { "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progressMessage": { "type": "string", "description": "A human-readable message that shows the intermediate progress details of NotebookRuntime." } }, "id": "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeOperationMetadata", "type": "object", "description": "Metadata information for NotebookService.AssignNotebookRuntime." }, "GoogleCloudAiplatformV1beta1NasJobOutputMultiTrialJobOutput": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NasJobOutputMultiTrialJobOutput", "properties": { "trainTrials": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NasTrial" }, "readOnly": true, "description": "Output only. List of NasTrials that were started as part of train stage." }, "searchTrials": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1NasTrial" }, "description": "Output only. List of NasTrials that were started as part of search stage.", "readOnly": true } }, "description": "The output of a multi-trial Neural Architecture Search (NAS) jobs." }, "GoogleCloudAiplatformV1beta1FeatureValueDestination": { "description": "A destination location for Feature values and format.", "type": "object", "properties": { "bigqueryDestination": { "description": "Output in BigQuery format. BigQueryDestination.output_uri in FeatureValueDestination.bigquery_destination must refer to a table.", "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination" }, "tfrecordDestination": { "$ref": "GoogleCloudAiplatformV1beta1TFRecordDestination", "description": "Output in TFRecord format. Below are the mapping from Feature value type in Featurestore to Feature value type in TFRecord: Value type in Featurestore | Value type in TFRecord DOUBLE, DOUBLE_ARRAY | FLOAT_LIST INT64, INT64_ARRAY | INT64_LIST STRING, STRING_ARRAY, BYTES | BYTES_LIST true -\u003e byte_string(\"true\"), false -\u003e byte_string(\"false\") BOOL, BOOL_ARRAY (true, false) | BYTES_LIST" }, "csvDestination": { "description": "Output in CSV format. Array Feature value types are not allowed in CSV format.", "$ref": "GoogleCloudAiplatformV1beta1CsvDestination" } }, "id": "GoogleCloudAiplatformV1beta1FeatureValueDestination" }, "GoogleCloudAiplatformV1beta1CacheConfigRetentionConfig": { "id": "GoogleCloudAiplatformV1beta1CacheConfigRetentionConfig", "description": "Configures the retention behavior of GenAI implicit (automatic) context caching for this project.", "type": "object", "properties": { "retentionType": { "enumDescriptions": [ "Unspecified. Treated the same as `DURABLE`.", "Restricts implicit caching to ephemeral, volatile-memory-backed retention only.", "Allows implicit caching to use long-lived, durable-storage-backed retention." ], "enum": [ "RETENTION_TYPE_UNSPECIFIED", "EPHEMERAL", "DURABLE" ], "description": "Optional. Retention type applied to implicit cache traffic for this project.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1DeployIndexResponse": { "properties": { "deployedIndex": { "description": "The DeployedIndex that had been deployed in the IndexEndpoint.", "$ref": "GoogleCloudAiplatformV1beta1DeployedIndex" } }, "type": "object", "description": "Response message for IndexEndpointService.DeployIndex.", "id": "GoogleCloudAiplatformV1beta1DeployIndexResponse" }, "GoogleCloudAiplatformV1beta1ListSpecialistPoolsResponse": { "type": "object", "properties": { "specialistPools": { "type": "array", "description": "A list of SpecialistPools that matches the specified filter in the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SpecialistPool" } }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } }, "description": "Response message for SpecialistPoolService.ListSpecialistPools.", "id": "GoogleCloudAiplatformV1beta1ListSpecialistPoolsResponse" }, "GoogleCloudAiplatformV1beta1StudyTimeConstraint": { "type": "object", "description": "Time-based Constraint for Study", "properties": { "endTime": { "type": "string", "format": "google-datetime", "description": "Compares the wallclock time to this time. Must use UTC timezone." }, "maxDuration": { "format": "google-duration", "type": "string", "description": "Counts the wallclock time passed since the creation of this Study." } }, "id": "GoogleCloudAiplatformV1beta1StudyTimeConstraint" }, "GoogleCloudAiplatformV1beta1PublisherModelResourceReference": { "properties": { "uri": { "description": "The URI of the resource.", "type": "string" }, "useCase": { "deprecated": true, "type": "string", "description": "Use case (CUJ) of the resource." }, "resourceName": { "description": "The resource name of the Google Cloud resource.", "type": "string" }, "description": { "type": "string", "description": "Description of the resource.", "deprecated": true } }, "description": "Reference to a resource.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelResourceReference" }, "GoogleCloudAiplatformV1beta1SecretEnvVar": { "description": "Represents an environment variable where the value is a secret in Cloud Secret Manager.", "properties": { "secretRef": { "$ref": "GoogleCloudAiplatformV1beta1SecretRef", "description": "Required. Reference to a secret stored in the Cloud Secret Manager that will provide the value for this environment variable." }, "name": { "description": "Required. Name of the secret environment variable.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SecretEnvVar" }, "GoogleCloudAiplatformV1beta1AudioTranscriptionConfig": { "properties": { "languageAuto": { "description": "Optional. Deprecated: Use top-level `language_codes` instead. The model will detect the language automatically.", "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto" }, "diarization": { "description": "Optional. Configures speaker diarization.", "type": "boolean" }, "languageHints": { "deprecated": true, "description": "Optional. Deprecated: Use top-level `language_codes` instead. Specifies one or more languages in the audio.", "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints" }, "languageCodes": { "description": "Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.", "type": "array", "items": { "type": "string" } }, "wordTimestamp": { "description": "Optional. Configures word-level timestamp generation.", "type": "boolean" }, "mode": { "enum": [ "MODE_UNSPECIFIED", "VERBATIM", "SMART" ], "type": "string", "enumDescriptions": [ "Unspecified transcription mode.", "Verbatim transcription mode.", "Smart transcription mode." ], "description": "Optional. Configures transcription mode. Supported values: `VERBATIM`, `SMART`. If unspecified, defaults to `VERBATIM` transcription. In `SMART` mode, the model performs disfluency removal (eliminating filler words, repetitions, and false starts), light grammatical cleanup, automatic formatting (paragraphs, bullet points, numbered lists), and minor user edits (inline self-corrections). Timestamps and diarization are incompatible with mode `SMART`." }, "adaptationPhrases": { "description": "Optional. Deprecated: Use `custom_vocabulary` instead. A list of phrases to bias the speech recognition model towards.", "type": "array", "deprecated": true, "items": { "type": "string" } }, "customVocabulary": { "description": "Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.", "items": { "type": "string" }, "type": "array" } }, "description": "Configuration for speech recognition (transcription).", "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployGke": { "properties": { "gkeYamlConfigs": { "type": "array", "items": { "type": "string" }, "description": "Optional. GKE deployment configuration in yaml format." } }, "type": "object", "description": "Configurations for PublisherModel GKE deployment", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionDeployGke" }, "GoogleCloudAiplatformV1beta1ListMonitoredAgentsResponse": { "description": "Response message for AgentAnomalyDetectionService.ListMonitoredAgents.", "id": "GoogleCloudAiplatformV1beta1ListMonitoredAgentsResponse", "properties": { "totalSize": { "type": "integer", "description": "The total number of MonitoredAgents matching the request, after any `filter` is applied.", "format": "int32" }, "monitoredAgents": { "type": "array", "description": "A list of MonitoredAgents that matches the specified filter in the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MonitoredAgent" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationGcsInputSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationGcsInputSource", "properties": { "inputUri": { "type": "string", "description": "Source data URI. For example, `gs://my_bucket/my_object`." } } }, "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest": { "description": "Request message for EvaluationService.EvaluateInstances.", "id": "GoogleCloudAiplatformV1beta1EvaluateInstancesRequest", "type": "object", "properties": { "exactMatchInput": { "$ref": "GoogleCloudAiplatformV1beta1ExactMatchInput", "description": "Auto metric instances. Instances and metric spec for exact match metric." }, "fluencyInput": { "$ref": "GoogleCloudAiplatformV1beta1FluencyInput", "description": "LLM-based metric instance. General text generation metrics, applicable to other categories. Input for fluency metric." }, "allowCrossRegionModel": { "type": "boolean", "description": "Optional. Allows the evaluation run to use cross region models. When this flag is set, the service may route traffic to other regions if a model is unavailable in the current region (e.g., to a `global` endpoint). If a fully-qualified model endpoint resource name with a different region than the request location is provided elsewhere in the request, this flag must be set to true or the request will fail." }, "trajectoryPrecisionInput": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInput", "description": "Input for trajectory precision metric." }, "cometInput": { "$ref": "GoogleCloudAiplatformV1beta1CometInput", "description": "Translation metrics. Input for Comet metric." }, "toolCallValidInput": { "description": "Tool call metric instances. Input for tool call valid metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolCallValidInput" }, "trajectoryExactMatchInput": { "description": "Input for trajectory exact match metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInput" }, "autoraterConfig": { "description": "Optional. Autorater config used for evaluation. Not applicable for predefined metrics (PredefinedMetricSpec); the server uses its own model configuration for predefined metrics and this field is ignored.", "$ref": "GoogleCloudAiplatformV1beta1AutoraterConfig" }, "questionAnsweringCorrectnessInput": { "description": "Input for question answering correctness metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringCorrectnessInput" }, "rougeInput": { "description": "Instances and metric spec for rouge metric.", "$ref": "GoogleCloudAiplatformV1beta1RougeInput" }, "location": { "description": "Required. The resource name of the Location to evaluate the instances. Format: `projects/{project}/locations/{location}`", "type": "string" }, "summarizationQualityInput": { "description": "Input for summarization quality metric.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationQualityInput" }, "fulfillmentInput": { "$ref": "GoogleCloudAiplatformV1beta1FulfillmentInput", "description": "Input for fulfillment metric." }, "pairwiseQuestionAnsweringQualityInput": { "description": "Input for pairwise question answering quality metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualityInput" }, "bleuInput": { "$ref": "GoogleCloudAiplatformV1beta1BleuInput", "description": "Instances and metric spec for bleu metric." }, "trajectoryAnyOrderMatchInput": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchInput", "description": "Input for trajectory match any order metric." }, "pointwiseMetricInput": { "description": "Input for pointwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PointwiseMetricInput" }, "metrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Metric" }, "description": "The metrics used for evaluation. Currently, we only support evaluating a single metric. If multiple metrics are provided, only the first one will be evaluated.", "type": "array" }, "toolParameterKvMatchInput": { "description": "Input for tool parameter key value match metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchInput" }, "pairwiseSummarizationQualityInput": { "$ref": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityInput", "description": "Input for pairwise summarization quality metric." }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstance", "description": "The instance to be evaluated." }, "trajectoryInOrderMatchInput": { "description": "Input for trajectory in order match metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchInput" }, "questionAnsweringHelpfulnessInput": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessInput", "description": "Input for question answering helpfulness metric." }, "summarizationHelpfulnessInput": { "$ref": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInput", "description": "Input for summarization helpfulness metric." }, "rubricBasedInstructionFollowingInput": { "$ref": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInput", "description": "Rubric Based Instruction Following metric." }, "toolParameterKeyMatchInput": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInput", "description": "Input for tool parameter key match metric." }, "groundednessInput": { "$ref": "GoogleCloudAiplatformV1beta1GroundednessInput", "description": "Input for groundedness metric." }, "safetyInput": { "description": "Input for safety metric.", "$ref": "GoogleCloudAiplatformV1beta1SafetyInput" }, "questionAnsweringQualityInput": { "description": "Input for question answering quality metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInput" }, "metricxInput": { "description": "Input for Metricx metric.", "$ref": "GoogleCloudAiplatformV1beta1MetricxInput" }, "trajectoryRecallInput": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryRecallInput", "description": "Input for trajectory recall metric." }, "toolNameMatchInput": { "description": "Input for tool name match metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolNameMatchInput" }, "questionAnsweringRelevanceInput": { "description": "Input for question answering relevance metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInput" }, "summarizationVerbosityInput": { "description": "Input for summarization verbosity metric.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationVerbosityInput" }, "pairwiseMetricInput": { "description": "Input for pairwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricInput" }, "metricSources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MetricSource" }, "type": "array", "description": "Optional. The metrics (either inline or registered) used for evaluation. Currently, we only support evaluating a single metric. If multiple metrics are provided, only the first one will be evaluated." }, "trajectorySingleToolUseInput": { "description": "Input for trajectory single tool use metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectorySingleToolUseInput" }, "coherenceInput": { "description": "Input for coherence metric.", "$ref": "GoogleCloudAiplatformV1beta1CoherenceInput" } } }, "GenaiVertexV1beta1StepStop": { "properties": { "stepUsage": { "description": "Model usage stats for this specific step.", "$ref": "GenaiVertexV1beta1InteractionUsage" }, "index": { "type": "integer", "format": "int32" }, "usage": { "$ref": "GenaiVertexV1beta1InteractionUsage", "description": "Cumulative model usage stats from the start of the session." } }, "id": "GenaiVertexV1beta1StepStop", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateFeatureOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateFeatureOperationMetadata", "type": "object", "description": "Details of operations that perform create Feature.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Feature." } } }, "GoogleCloudAiplatformV1beta1Schedule": { "properties": { "cron": { "type": "string", "description": "Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch scheduled runs. To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: \"CRON_TZ=${IANA_TIME_ZONE}\" or \"TZ=${IANA_TIME_ZONE}\". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, \"CRON_TZ=America/New_York 1 * * * *\", or \"TZ=America/New_York 1 * * * *\"." }, "allowQueueing": { "description": "Optional. Whether new scheduled runs can be queued when max_concurrent_runs limit is reached. If set to true, new runs will be queued instead of skipped. Default to false.", "type": "boolean" }, "lastResumeTime": { "format": "google-datetime", "description": "Output only. Timestamp when this Schedule was last resumed. Unset if never resumed from pause.", "type": "string", "readOnly": true }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this Schedule was updated.", "type": "string" }, "lastPauseTime": { "description": "Output only. Timestamp when this Schedule was last paused. Unset if never paused.", "format": "google-datetime", "type": "string", "readOnly": true }, "maxConcurrentRunCount": { "type": "string", "description": "Required. Maximum number of runs that can be started concurrently for this Schedule. This is the limit for starting the scheduled requests and not the execution of the operations/jobs created by the requests (if applicable).", "format": "int64" }, "maxRunCount": { "description": "Optional. Maximum run count of the schedule. If specified, The schedule will be completed when either started_run_count \u003e= max_run_count or when end_time is reached. If not specified, new runs will keep getting scheduled until this Schedule is paused or deleted. Already scheduled runs will be allowed to complete. Unset if not specified.", "format": "int64", "type": "string" }, "createNotebookExecutionJobRequest": { "$ref": "GoogleCloudAiplatformV1beta1CreateNotebookExecutionJobRequest", "description": "Request for NotebookService.CreateNotebookExecutionJob." }, "lastScheduledRunResponse": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ScheduleRunResponse", "description": "Output only. Response of the last scheduled run. This is the response for starting the scheduled requests and not the execution of the operations/jobs created by the requests (if applicable). Unset if no run has been scheduled yet." }, "maxConcurrentActiveRunCount": { "description": "Optional. Specifies the maximum number of active runs that can be executed concurrently for this Schedule. This limits the number of runs that can be in a non-terminal state at the same time. Currently, this field is only supported for requests of type CreatePipelineJobRequest.", "format": "int64", "type": "string" }, "startTime": { "description": "Optional. Timestamp after which the first run can be scheduled. Default to Schedule create time if not specified.", "type": "string", "format": "google-datetime" }, "displayName": { "type": "string", "description": "Required. User provided name of the Schedule. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "endTime": { "description": "Optional. Timestamp after which no new runs can be scheduled. If specified, The schedule will be completed when either end_time is reached or when scheduled_run_count \u003e= max_run_count. If not specified, new runs will keep getting scheduled until this Schedule is paused or deleted. Already scheduled runs will be allowed to complete. Unset if not specified.", "format": "google-datetime", "type": "string" }, "state": { "type": "string", "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "PAUSED", "COMPLETED" ], "description": "Output only. The state of this Schedule.", "enumDescriptions": [ "Unspecified.", "The Schedule is active. Runs are being scheduled on the user-specified timespec.", "The schedule is paused. No new runs will be created until the schedule is resumed. Already started runs will be allowed to complete.", "The Schedule is completed. No new runs will be scheduled. Already started runs will be allowed to complete. Schedules in completed state cannot be paused or resumed." ] }, "startedRunCount": { "readOnly": true, "description": "Output only. The number of runs started by this schedule.", "format": "int64", "type": "string" }, "createModelMonitoringJobRequest": { "$ref": "GoogleCloudAiplatformV1beta1CreateModelMonitoringJobRequest", "description": "Request for ModelMonitoringService.CreateModelMonitoringJob." }, "catchUp": { "readOnly": true, "type": "boolean", "description": "Output only. Whether to backfill missed runs when the schedule is resumed from PAUSED state. If set to true, all missed runs will be scheduled. New runs will be scheduled after the backfill is complete. Default to false." }, "name": { "description": "Immutable. The resource name of the Schedule.", "type": "string" }, "createPipelineJobRequest": { "$ref": "GoogleCloudAiplatformV1beta1CreatePipelineJobRequest", "description": "Request for PipelineService.CreatePipelineJob. CreatePipelineJobRequest.parent field is required (format: projects/{project}/locations/{location})." }, "nextRunTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this Schedule should schedule the next run. Having a next_run_time in the past means the runs are being started behind schedule." }, "createTime": { "description": "Output only. Timestamp when this Schedule was created.", "readOnly": true, "type": "string", "format": "google-datetime" } }, "id": "GoogleCloudAiplatformV1beta1Schedule", "type": "object", "description": "An instance of a Schedule periodically schedules runs to make API calls based on user specified time specification and API request type." }, "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail": { "properties": { "taskResourceUnavailableTimeoutBehavior": { "enum": [ "TASK_RESOURCE_UNAVAILABLE_TIMEOUT_BEHAVIOR_UNSPECIFIED", "FAIL", "FALL_BACK_TO_ON_DEMAND" ], "enumDescriptions": [ "Unspecified. Behavior is same as `FAIL`.", "Fail the task if the timeout is reached.", "Fall back to on-demand execution if the timeout is reached." ], "description": "Specifies the behavior to take if the timeout is reached.", "type": "string" }, "taskResourceUnavailableWaitTimeMs": { "description": "The max time a pipeline task waits for the required CPU, memory, or accelerator resource to become available from the specified persistent resource. Default wait time is 0.", "type": "string", "format": "int64" }, "persistentResourceName": { "type": "string", "description": "Persistent resource name. Format: `projects/{project}/locations/{location}/persistentResources/{persistent_resource}`" } }, "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail", "type": "object", "description": "Persistent resource based runtime detail. For more information about persistent resource, refer to https://cloud.google.com/vertex-ai/docs/training/persistent-resource-overview" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsColorAlignmentConfig": { "properties": { "enable": { "description": "Optional. If true, enable alignment.", "type": "boolean" } }, "description": "Configuration for color alignment.", "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsColorAlignmentConfig" }, "GoogleCloudAiplatformV1beta1BatchCancelPipelineJobsResponse": { "properties": { "pipelineJobs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" }, "description": "PipelineJobs cancelled." } }, "description": "Response message for PipelineService.BatchCancelPipelineJobs.", "id": "GoogleCloudAiplatformV1beta1BatchCancelPipelineJobsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomaliesFeatureHistoricStatsAnomalies": { "type": "object", "description": "Historical Stats (and Anomalies) for a specific Feature.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomaliesFeatureHistoricStatsAnomalies", "properties": { "threshold": { "description": "Threshold for anomaly detection.", "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig" }, "featureDisplayName": { "description": "Display Name of the Feature.", "type": "string" }, "trainingStats": { "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly", "description": "Stats calculated for the Training Dataset." }, "predictionStats": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureStatsAnomaly" }, "description": "A list of historical stats generated by different time window's Prediction Dataset.", "type": "array" } } }, "GoogleApiHttpBody": { "type": "object", "id": "GoogleApiHttpBody", "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "properties": { "contentType": { "description": "The HTTP Content-Type header value specifying the content type of the body.", "type": "string" }, "extensions": { "type": "array", "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "items": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } } }, "data": { "description": "The HTTP request/response body as raw binary.", "format": "byte", "type": "string" } } }, "GoogleCloudAiplatformV1beta1A2APart": { "id": "GoogleCloudAiplatformV1beta1A2APart", "description": "A single part of a message or artifact. A part carries exactly one kind of content.", "type": "object", "properties": { "data": { "type": "any", "description": "Optional. Arbitrary data content." }, "raw": { "format": "byte", "type": "string", "description": "Optional. Raw binary content." }, "metadata": { "type": "object", "description": "Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "mediaType": { "type": "string", "description": "Optional. The IANA media type of the content, e.g. \"text/plain\" or \"image/png\"." }, "text": { "description": "Optional. Textual content.", "type": "string" }, "url": { "type": "string", "description": "Optional. A URL pointing to the content." }, "filename": { "type": "string", "description": "Optional. The name of the file, when the part represents a file." } } }, "GoogleCloudAiplatformV1beta1CustomOutput": { "properties": { "rawOutputs": { "description": "Output only. List of raw output strings.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1RawOutput" } }, "description": "Spec for custom output.", "id": "GoogleCloudAiplatformV1beta1CustomOutput", "type": "object" }, "GoogleCloudAiplatformV1beta1LookupStudyRequest": { "description": "Request message for VizierService.LookupStudy.", "type": "object", "id": "GoogleCloudAiplatformV1beta1LookupStudyRequest", "properties": { "displayName": { "description": "Required. The user-defined display name of the Study", "type": "string" } } }, "GoogleCloudAiplatformV1beta1MetricSource": { "properties": { "metric": { "$ref": "GoogleCloudAiplatformV1beta1Metric", "description": "Inline metric config." }, "metricResourceName": { "description": "Optional. Resource name for registered metric.", "type": "string" } }, "type": "object", "description": "The metric source used for evaluation.", "id": "GoogleCloudAiplatformV1beta1MetricSource" }, "GoogleCloudAiplatformV1beta1BatchMigrateResourcesOperationMetadataPartialResult": { "properties": { "request": { "description": "It's the same as the value in BatchMigrateResourcesRequest.migrate_resource_requests.", "$ref": "GoogleCloudAiplatformV1beta1MigrateResourceRequest" }, "model": { "type": "string", "description": "Migrated model resource name." }, "error": { "$ref": "GoogleRpcStatus", "description": "The error result of the migration request in case of failure." }, "dataset": { "type": "string", "description": "Migrated dataset resource name." } }, "description": "Represents a partial result in batch migration operation for one MigrateResourceRequest.", "id": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesOperationMetadataPartialResult", "type": "object" }, "GoogleCloudAiplatformV1beta1DeleteOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1DeleteOperationMetadata", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The common part of the operation metadata." } }, "description": "Details of operations that perform deletes of any entities.", "type": "object" }, "GoogleCloudAiplatformV1beta1AugmentPromptRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1AugmentPromptRequest", "description": "Request message for AugmentPrompt.", "properties": { "contents": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Optional. Input content to augment, only text format is supported for now.", "type": "array" }, "vertexRagStore": { "description": "Optional. Retrieves contexts from the Vertex RagStore.", "$ref": "GoogleCloudAiplatformV1beta1VertexRagStore" }, "model": { "$ref": "GoogleCloudAiplatformV1beta1AugmentPromptRequestModel", "description": "Optional. Metadata of the backend deployed model." } } }, "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerMonthUsageData": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerMonthUsageData", "properties": { "userUsageData": { "description": "Usage data for each user in the given month.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ReadTensorboardUsageResponsePerUserUsageData" }, "type": "array" } }, "description": "Per month usage data" }, "GoogleRpcStatus": { "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "type": "string", "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client." }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } } }, "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "GoogleRpcStatus", "type": "object" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerEnvironment": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerEnvironment", "description": "The customized sandbox runtime environment for BYOC.", "properties": { "ports": { "description": "Ports to expose from the container.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateNetworkPort" } }, "customContainerSpec": { "description": "The specification of the custom container environment.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerSpec" }, "resources": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateResourceRequirements", "description": "Resource requests and limits for the container." } } }, "GoogleCloudAiplatformV1beta1FunctionDeclaration": { "properties": { "description": { "type": "string", "description": "Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function." }, "response": { "description": "Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function.", "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "parametersJsonSchema": { "type": "any", "description": "Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { \"type\": \"object\", \"properties\": { \"name\": { \"type\": \"string\" }, \"age\": { \"type\": \"integer\" } }, \"additionalProperties\": false, \"required\": [\"name\", \"age\"], \"propertyOrdering\": [\"name\", \"age\"] } ``` This field is mutually exclusive with `parameters`." }, "responseJsonSchema": { "description": "Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`.", "type": "any" }, "parameters": { "description": "Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1", "$ref": "GoogleCloudAiplatformV1beta1Schema" }, "behavior": { "enum": [ "UNSPECIFIED", "BLOCKING", "NON_BLOCKING" ], "enumDescriptions": [ "This value is unspecified.", "If set, the system will wait to receive the function response before continuing the conversation.", "If set, the system will not wait to receive the function response. Instead, it will attempt to handle function responses as they become available while maintaining the conversation between the user and the model." ], "type": "string", "description": "Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method." }, "name": { "type": "string", "description": "Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 128." } }, "id": "GoogleCloudAiplatformV1beta1FunctionDeclaration", "description": "Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.", "type": "object" }, "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotation": { "description": "Model error analysis for each annotation.", "id": "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotation", "type": "object", "properties": { "outlierScore": { "type": "number", "description": "The outlier score of this annotated item. Usually defined as the min of all distances from attributed items.", "format": "double" }, "queryType": { "enumDescriptions": [ "Unspecified query type for model error analysis.", "Query similar samples across all classes in the dataset.", "Query similar samples from the same class of the input sample.", "Query dissimilar samples from the same class of the input sample." ], "enum": [ "QUERY_TYPE_UNSPECIFIED", "ALL_SIMILAR", "SAME_CLASS_SIMILAR", "SAME_CLASS_DISSIMILAR" ], "description": "The query type used for finding the attributed items.", "type": "string" }, "outlierThreshold": { "type": "number", "description": "The threshold used to determine if this annotation is an outlier or not.", "format": "double" }, "attributedItems": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotationAttributedItem" }, "description": "Attributed items for a given annotation, typically representing neighbors from the training sets constrained by the query type." } } }, "GoogleCloudAiplatformV1beta1DeprovisionSemanticGovernancePolicyEngineRequest": { "description": "Request message for SemanticGovernancePolicyEngineService.DeprovisionSemanticGovernancePolicyEngine.", "type": "object", "properties": { "force": { "type": "boolean", "description": "Optional. If true, the operation bypass checks on current state and force the deprovisioning operation." } }, "id": "GoogleCloudAiplatformV1beta1DeprovisionSemanticGovernancePolicyEngineRequest" }, "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsResponse": { "id": "GoogleCloudAiplatformV1beta1AppendA2aTaskEventsResponse", "description": "Response message for AppendA2aTaskEvents.", "type": "object", "properties": { "generation": { "type": "string", "format": "int64", "description": "Task generation matching the last event" } } }, "GoogleCloudAiplatformV1beta1Content": { "id": "GoogleCloudAiplatformV1beta1Content", "description": "The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message.", "type": "object", "properties": { "parts": { "description": "Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Part" } }, "role": { "description": "Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'.", "type": "string" } } }, "GenaiVertexV1beta1ErrorEvent": { "id": "GenaiVertexV1beta1ErrorEvent", "properties": { "error": { "$ref": "GenaiVertexV1beta1Error" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesRequest": { "properties": { "dataKeys": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey" }, "type": "array" }, "dataFormat": { "enum": [ "FEATURE_VIEW_DATA_FORMAT_UNSPECIFIED", "KEY_VALUE", "PROTO_STRUCT" ], "description": "Specify response data format. If not set, KeyValue format will be used.", "enumDescriptions": [ "Not set. Will be treated as the KeyValue format.", "Return response data in key-value format.", "Return response data in proto Struct format." ], "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1StreamingFetchFeatureValuesRequest", "type": "object", "description": "Request message for FeatureOnlineStoreService.StreamingFetchFeatureValues. For the entities requested, all features under the requested feature view will be returned." }, "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest": { "description": "Request message for ReasoningEngineExecutionService.StreamQueryReasoningEngine.", "type": "object", "properties": { "input": { "description": "Optional. Input content provided by users in JSON object format. Examples include text query, function calling parameters, media bytes, etc.", "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "classMethod": { "description": "Optional. Class method to be used for the stream query. It is optional and defaults to \"stream_query\" if unspecified.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1StreamQueryReasoningEngineRequest" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationInputs": { "type": "object", "properties": { "modelType": { "enumDescriptions": [ "Should not be set.", "A Model best tailored to be used within Google Cloud, and which cannot be exported. Default.", "A model type best tailored to be used within Google Cloud, which cannot be exported externally. Compared to the CLOUD model above, it is expected to have higher prediction accuracy.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as TensorFlow or Core ML model and used on a mobile or edge device afterwards. Expected to have low latency, but may have lower prediction quality than other mobile models.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as TensorFlow or Core ML model and used on a mobile or edge device with afterwards.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as TensorFlow or Core ML model and used on a mobile or edge device afterwards. Expected to have a higher latency, but should also have a higher prediction quality than other mobile models.", "EfficientNet model for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally.", "MaxViT model for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally.", "ViT model for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally.", "CoCa model for Model Garden training with customizable hyperparameters. Best tailored to be used within Google Cloud, and cannot be exported externally." ], "type": "string", "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD", "CLOUD_1", "MOBILE_TF_LOW_LATENCY_1", "MOBILE_TF_VERSATILE_1", "MOBILE_TF_HIGH_ACCURACY_1", "EFFICIENTNET", "MAXVIT", "VIT", "COCA" ] }, "uptrainBaseModelId": { "description": "The ID of `base` model for upTraining. If it is specified, the new model will be upTrained based on the `base` model for upTraining. Otherwise, the new model will be trained from scratch. The `base` model for upTraining must be in the same Project and Location as the new Model to train, and have the same modelType.", "type": "string" }, "budgetMilliNodeHours": { "format": "int64", "description": "The training budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The actual metadata.costMilliNodeHours will be equal or less than this value. If further model training ceases to provide any improvements, it will stop without using the full budget and the metadata.successfulStopReason will be `model-converged`. Note, node_hour = actual_hour * number_of_nodes_involved. For modelType `cloud`(default), the budget must be between 8,000 and 800,000 milli node hours, inclusive. The default value is 192,000 which represents one day in wall time, considering 8 nodes are used. For model types `mobile-tf-low-latency-1`, `mobile-tf-versatile-1`, `mobile-tf-high-accuracy-1`, the training budget must be between 1,000 and 100,000 milli node hours, inclusive. The default value is 24,000 which represents one day in wall time on a single node that is used.", "type": "string" }, "baseModelId": { "description": "The ID of the `base` model. If it is specified, the new model will be trained based on the `base` model. Otherwise, the new model will be trained from scratch. The `base` model must be in the same Project and Location as the new Model to train, and have the same modelType.", "type": "string" }, "tunableParameter": { "description": "Trainer type for Vision TrainRequest.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutomlImageTrainingTunableParameter" }, "multiLabel": { "description": "If false, a single-label (multi-class) Model will be trained (i.e. assuming that for each image just up to one annotation may be applicable). If true, a multi-label Model will be trained (i.e. assuming that for each image multiple annotations may be applicable).", "type": "boolean" }, "disableEarlyStopping": { "description": "Use the entire training budget. This disables the early stopping feature. When false the early stopping feature is enabled, which means that AutoML Image Classification might stop training before the entire training budget has been used.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationInputs" }, "GoogleCloudAiplatformV1beta1OptimizePromptResponse": { "type": "object", "description": "Response message for GenAiTuningService.OptimizePrompt", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "readOnly": true, "description": "Output only. The optimized prompt." } }, "id": "GoogleCloudAiplatformV1beta1OptimizePromptResponse" }, "GoogleCloudAiplatformV1beta1CreatePipelineJobRequest": { "id": "GoogleCloudAiplatformV1beta1CreatePipelineJobRequest", "type": "object", "properties": { "pipelineJob": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob", "description": "Required. The PipelineJob to create." }, "pipelineJobId": { "description": "The ID to use for the PipelineJob, which will become the final component of the PipelineJob name. If not provided, an ID will be automatically generated. This value should be less than 128 characters, and valid characters are `/a-z-/`.", "type": "string" }, "parent": { "description": "Required. The resource name of the Location to create the PipelineJob in. Format: `projects/{project}/locations/{location}`", "type": "string" } }, "description": "Request message for PipelineService.CreatePipelineJob." }, "GoogleCloudAiplatformV1beta1SyntheticField": { "description": "Represents a single named field within a synthetic example, consisting of a name and the actual content.", "id": "GoogleCloudAiplatformV1beta1SyntheticField", "properties": { "content": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. The actual content or value for this field. This can be text, images, or other types of data." }, "fieldName": { "type": "string", "description": "Optional. The name of the specific field, such as \"product_name\" or \"review_text\"." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingRankService": { "type": "object", "properties": { "modelName": { "type": "string", "description": "Optional. The model name of the rank service. Format: `semantic-ranker-512@latest`" } }, "description": "Config for Rank Service.", "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfigRankingRankService" }, "GoogleCloudAiplatformV1beta1EvaluateDatasetResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluateDatasetResponse", "description": "The results from an evaluation run performed by the EvaluationService.", "properties": { "outputInfo": { "$ref": "GoogleCloudAiplatformV1beta1OutputInfo", "readOnly": true, "description": "Output only. Output info for EvaluationService." }, "aggregationOutput": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1AggregationOutput", "description": "Output only. Aggregation statistics derived from results of EvaluationService." } } }, "GoogleCloudAiplatformV1beta1BigQueryDestination": { "id": "GoogleCloudAiplatformV1beta1BigQueryDestination", "properties": { "outputUri": { "description": "Required. BigQuery URI to a project or table, up to 2000 characters long. When only the project is specified, the Dataset and Table is created. When the full table reference is specified, the Dataset must exist and table must not exist. Accepted forms: * BigQuery path. For example: `bq://projectId` or `bq://projectId.bqDatasetId` or `bq://projectId.bqDatasetId.bqTableId`.", "type": "string" } }, "type": "object", "description": "The BigQuery location for the output content." }, "GoogleCloudAiplatformV1beta1Chunk": { "type": "object", "id": "GoogleCloudAiplatformV1beta1Chunk", "properties": { "metadata": { "description": "Optional. Metadata that is associated with the data in the payload.", "$ref": "GoogleCloudAiplatformV1beta1Metadata" }, "mimeType": { "description": "Required. Mime type of the chunk data. See https://www.iana.org/assignments/media-types/media-types.xhtml for the full list.", "type": "string" }, "data": { "format": "byte", "type": "string", "description": "Required. The data in the chunk." } }, "description": "Container for bytes-encoded data such as video frame, audio sample, or a complete binary/text data." }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoClassificationPredictionInstance": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceVideoClassificationPredictionInstance", "description": "Prediction input format for Video Classification.", "type": "object", "properties": { "mimeType": { "type": "string", "description": "The MIME type of the content of the video. Only the following are supported: video/mp4 video/avi video/quicktime" }, "content": { "type": "string", "description": "The Google Cloud Storage location of the video on which to perform the prediction." }, "timeSegmentStart": { "description": "The beginning, inclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision.", "type": "string" }, "timeSegmentEnd": { "description": "The end, exclusive, of the video's time segment on which to perform the prediction. Expressed as a number of seconds as measured from the start of the video, with \"s\" appended at the end. Fractions are allowed, up to a microsecond precision, and \"inf\" or \"Infinity\" is allowed, which means the end of the video.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringJob": { "description": "Represents a model monitoring job that analyze dataset using different monitoring algorithm.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringJob", "properties": { "displayName": { "description": "The display name of the ModelMonitoringJob. The name can be up to 128 characters long and can consist of any UTF-8.", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Timestamp when this ModelMonitoringJob was created.", "format": "google-datetime" }, "modelMonitoringSpec": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringSpec", "description": "Monitoring monitoring job spec. It outlines the specifications for monitoring objectives, notifications, and result exports. If left blank, the default monitoring specifications from the top-level resource 'ModelMonitor' will be applied. If provided, we will use the specification defined here rather than the default one." }, "jobExecutionDetail": { "readOnly": true, "description": "Output only. Execution results for all the monitoring objectives.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetail" }, "updateTime": { "description": "Output only. Timestamp when this ModelMonitoringJob was updated most recently.", "readOnly": true, "format": "google-datetime", "type": "string" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Resource name of a ModelMonitoringJob. Format: `projects/{project_id}/locations/{location_id}/modelMonitors/{model_monitor_id}/modelMonitoringJobs/{model_monitoring_job_id}`" }, "state": { "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "type": "string", "readOnly": true, "description": "Output only. The state of the monitoring job. * When the job is still creating, the state will be 'JOB_STATE_PENDING'. * Once the job is successfully created, the state will be 'JOB_STATE_RUNNING'. * Once the job is finished, the state will be one of 'JOB_STATE_FAILED', 'JOB_STATE_SUCCEEDED', 'JOB_STATE_PARTIALLY_SUCCEEDED'." }, "scheduleTime": { "description": "Output only. Timestamp when this ModelMonitoringJob was scheduled. It will only appear when this job is triggered by a schedule.", "readOnly": true, "type": "string", "format": "google-datetime" }, "schedule": { "readOnly": true, "description": "Output only. Schedule resource name. It will only appear when this job is triggered by a schedule.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1NetworkSpec": { "description": "Network spec.", "properties": { "enableInternetAccess": { "description": "Whether to enable public internet access. Default false.", "type": "boolean" }, "subnetwork": { "description": "The name of the subnet that this instance is in. Format: `projects/{project_id_or_number}/regions/{region}/subnetworks/{subnetwork_id}`", "type": "string" }, "network": { "description": "The full name of the Google Compute Engine [network](https://cloud.google.com//compute/docs/networks-and-firewalls#networks)", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NetworkSpec" }, "GoogleCloudAiplatformV1beta1Claim": { "id": "GoogleCloudAiplatformV1beta1Claim", "type": "object", "properties": { "startIndex": { "description": "Index in the input text where the claim starts (inclusive).", "type": "integer", "format": "int32" }, "endIndex": { "description": "Index in the input text where the claim ends (exclusive).", "format": "int32", "type": "integer" }, "score": { "description": "Confidence score of this corroboration.", "format": "float", "type": "number" }, "factIndexes": { "type": "array", "description": "Indexes of the facts supporting this claim.", "items": { "format": "int32", "type": "integer" } } }, "description": "Claim that is extracted from the input text and facts that support it." }, "GoogleCloudAiplatformV1beta1FeatureViewBigtableMetadata": { "type": "object", "properties": { "readAppProfile": { "type": "string", "description": "Output only. The Bigtable App Profile to use for reading from Bigtable.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewBigtableMetadata", "description": "Metadata for the Cloud Bigtable that supports directly interacting Bigtable instances." }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationFileInputSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecTranslationFileInputSource", "properties": { "displayName": { "type": "string", "description": "The file's display name." }, "mimeType": { "type": "string", "description": "The file's mime type." }, "content": { "type": "string", "description": "The file's contents." } } }, "GoogleCloudAiplatformV1beta1IntermediateExtractedMemory": { "id": "GoogleCloudAiplatformV1beta1IntermediateExtractedMemory", "properties": { "context": { "type": "string", "description": "Output only. Represents the explanation of why the information was extracted from the source content.", "readOnly": true }, "structuredData": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object", "description": "Output only. Represents the structured value of the extracted memory.", "readOnly": true }, "fact": { "readOnly": true, "type": "string", "description": "Output only. Represents the fact of the extracted memory." } }, "type": "object", "description": "An extracted memory that is the intermediate result before consolidation." }, "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesResponse": { "properties": { "monitoringStats": { "description": "Stats retrieved for requested objectives. There are at most 1000 ModelMonitoringStatsAnomalies.FeatureHistoricStatsAnomalies.prediction_stats in the response.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomalies" }, "type": "array" }, "nextPageToken": { "description": "The page token that can be used by the next JobService.SearchModelDeploymentMonitoringStatsAnomalies call.", "type": "string" } }, "description": "Response message for JobService.SearchModelDeploymentMonitoringStatsAnomalies.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesResponse" }, "GoogleCloudAiplatformV1beta1UpsertExamplesRequest": { "type": "object", "description": "Request message for ExampleStoreService.UpsertExamples.", "id": "GoogleCloudAiplatformV1beta1UpsertExamplesRequest", "properties": { "overwrite": { "description": "Optional. A flag indicating whether an example can be overwritten if it already exists. If False (default) and the example already exists, the example will not be updated. This does not affect behavior if the example does not exist already.", "type": "boolean" }, "examples": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Example" }, "type": "array", "description": "Required. A list of examples to be created/updated." } } }, "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenRequest": { "description": "Request message for FeatureOnlineStoreService.GenerateFetchAccessToken.", "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerateFetchAccessTokenRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1Tensorboard": { "id": "GoogleCloudAiplatformV1beta1Tensorboard", "description": "Tensorboard is a physical database that stores users' training metrics. A default Tensorboard is provided in each region of a Google Cloud project. If needed users can also create extra Tensorboards in their projects.", "properties": { "runCount": { "readOnly": true, "format": "int32", "description": "Output only. The number of Runs stored in this Tensorboard.", "type": "integer" }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this Tensorboard was last updated.", "readOnly": true, "format": "google-datetime" }, "blobStoragePathPrefix": { "description": "Output only. Consumer project Cloud Storage path prefix used to store blob data, which can either be a bucket or directory. Does not end with a '/'.", "type": "string", "readOnly": true }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your Tensorboards. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Tensorboard (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable." }, "description": { "type": "string", "description": "Description of this Tensorboard." }, "name": { "readOnly": true, "type": "string", "description": "Output only. Name of the Tensorboard. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`" }, "isDefault": { "type": "boolean", "description": "Used to indicate if the TensorBoard instance is the default one. Each project & region can have at most one default TensorBoard instance. Creation of a default TensorBoard instance and updating an existing TensorBoard instance to be default will mark all other TensorBoard instances (if any) as non default." }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a Tensorboard. If set, this Tensorboard and all sub-resources of this Tensorboard will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "displayName": { "description": "Required. User provided name of this Tensorboard.", "type": "string" }, "createTime": { "type": "string", "description": "Output only. Timestamp when this Tensorboard was created.", "format": "google-datetime", "readOnly": true }, "satisfiesPzi": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "etag": { "description": "Used to perform a consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GoogleDriveSource": { "description": "The Google Drive location for the input content.", "id": "GoogleCloudAiplatformV1beta1GoogleDriveSource", "properties": { "resourceIds": { "description": "Required. Google Drive resource IDs.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSourceResourceId" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataOverrideInputMetadataOverride": { "type": "object", "description": "The input metadata entries to be overridden.", "properties": { "inputBaselines": { "type": "array", "items": { "type": "any" }, "description": "Baseline inputs for this feature. This overrides the `input_baseline` field of the ExplanationMetadata.InputMetadata object of the corresponding feature's input metadata. If it's not specified, the original baselines are not overridden." } }, "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataOverrideInputMetadataOverride" }, "GoogleCloudAiplatformV1beta1GenerateSyntheticDataRequest": { "properties": { "examples": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SyntheticExample" }, "description": "Optional. A list of few-shot examples that help the model understand the desired style, tone, and format of the generated synthetic data. Providing these few-shot examples can significantly improve the quality and relevance of the output.", "type": "array" }, "count": { "type": "integer", "description": "Required. The number of synthetic examples to generate. For this stateless API, you can generate up to 50 examples in a single request.", "format": "int32" }, "outputFieldSpecs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1OutputFieldSpec" }, "type": "array", "description": "Required. Defines the schema of each synthetic example to be generated, defined by a list of fields." }, "taskDescription": { "$ref": "GoogleCloudAiplatformV1beta1TaskDescriptionStrategy", "description": "Generates synthetic data based on a high-level description of the task or data you want." } }, "id": "GoogleCloudAiplatformV1beta1GenerateSyntheticDataRequest", "type": "object", "description": "Request message for DataFoundryService.GenerateSyntheticData. It contains the settings and information needed to generate synthetic data." }, "GoogleCloudAiplatformV1beta1ProbeExecAction": { "description": "ExecAction specifies a command to execute.", "properties": { "command": { "items": { "type": "string" }, "description": "Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside a shell, so traditional shell instructions ('|', etc) won't work. To use a shell, you need to explicitly call out to that shell. Exit status of 0 is treated as live/healthy and non-zero is unhealthy.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ProbeExecAction", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationMetadata", "type": "object", "properties": { "successfulStopReason": { "type": "string", "enumDescriptions": [ "Should not be set.", "The inputs.budgetMilliNodeHours had been reached.", "Further training of the Model ceased to increase its quality, since it already has converged." ], "enum": [ "SUCCESSFUL_STOP_REASON_UNSPECIFIED", "BUDGET_REACHED", "MODEL_CONVERGED" ], "description": "For successful job completions, this is the reason why the job has finished." }, "costMilliNodeHours": { "type": "string", "description": "The actual training cost of creating this model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed inputs.budgetMilliNodeHours.", "format": "int64" } } }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentData": { "deprecated": true, "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentData", "type": "object", "properties": { "events": { "description": "A list of events.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataEvents" }, "agentConfig": { "description": "Optional. Deprecated: Use `agent_eval_data` instead. Agent configuration.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfig" }, "turns": { "description": "Optional. The chronological list of conversation turns. Each turn represents a logical execution cycle (e.g., User Input -\u003e Agent Response).", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataConversationTurn" }, "type": "array" }, "agents": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfig" }, "type": "object", "description": "Optional. The static Agent Configuration. This map defines the graph structure of the agent system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent (tools, instructions, sub-agents)." }, "tools": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataTools", "description": "List of tools.", "deprecated": true }, "developerInstruction": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData", "description": "Optional. Deprecated: Use `agents.developer_instruction` or `turns.events.active_instruction` instead. A field containing instructions from the developer for the agent.", "deprecated": true }, "toolsText": { "description": "A JSON string containing a list of tools available to an agent with info such as name, description, parameters and required parameters.", "type": "string", "deprecated": true } }, "description": "Deprecated: Use `agent_eval_data` instead. Contains data specific to agent evaluations." }, "GoogleCloudAiplatformV1beta1TensorboardTensor": { "id": "GoogleCloudAiplatformV1beta1TensorboardTensor", "properties": { "versionNumber": { "description": "Optional. Version number of TensorProto used to serialize value.", "type": "integer", "format": "int32" }, "value": { "type": "string", "format": "byte", "description": "Required. Serialized form of https://github.com/tensorflow/tensorflow/blob/master/tensorflow/core/framework/tensor.proto" } }, "type": "object", "description": "One point viewable on a tensor metric plot." }, "CloudAiLargeModelsVisionGenerateVideoRequestAudio": { "id": "CloudAiLargeModelsVisionGenerateVideoRequestAudio", "type": "object", "properties": { "mimeType": { "type": "string", "description": "The MIME type of the content of the audio. Only audio in below listed MIME types are supported. - audio/wav - audio/mp3 - audio/mpeg" }, "gcsUri": { "type": "string" }, "blobId": { "type": "string", "description": "Blob ID of the audio. This is used for storing the large audio in the request." }, "bytesBase64Encoded": { "type": "string", "description": "Base64 encoded bytes string representing the audio." } }, "description": "The raw bytes or Cloud Storage URI for an audio input." }, "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessRequest": { "properties": {}, "description": "Request message for SandboxEnvironmentExecutionService.AuthorizeSandboxEnvironmentAccess.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AuthorizeSandboxEnvironmentAccessRequest" }, "GoogleCloudAiplatformV1beta1EvaluationDataset": { "description": "The dataset used for evaluation.", "properties": { "gcsSource": { "description": "Cloud storage source holds the dataset. Currently only one Cloud Storage file path is supported.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource", "description": "BigQuery source holds the dataset." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationDataset" }, "GoogleCloudAiplatformV1beta1PrivateEndpoints": { "id": "GoogleCloudAiplatformV1beta1PrivateEndpoints", "type": "object", "description": "PrivateEndpoints proto is used to provide paths for users to send requests privately. To send request via private service access, use predict_http_uri, explain_http_uri or health_http_uri. To send request via private service connect, use service_attachment.", "properties": { "explainHttpUri": { "description": "Output only. Http(s) path to send explain requests.", "readOnly": true, "type": "string" }, "healthHttpUri": { "description": "Output only. Http(s) path to send health check requests.", "readOnly": true, "type": "string" }, "serviceAttachment": { "type": "string", "description": "Output only. The name of the service attachment resource. Populated if private service connect is enabled.", "readOnly": true }, "predictHttpUri": { "readOnly": true, "description": "Output only. Http(s) path to send prediction requests.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequest": { "id": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequest", "properties": { "startTime": { "type": "string", "description": "The earliest timestamp of stats being generated. If not set, indicates fetching stats till the earliest possible one.", "format": "google-datetime" }, "objectives": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelDeploymentMonitoringStatsAnomaliesRequestStatsAnomaliesObjective" }, "description": "Required. Objectives of the stats to retrieve.", "type": "array" }, "endTime": { "description": "The latest timestamp of stats being generated. If not set, indicates feching stats till the latest possible one.", "type": "string", "format": "google-datetime" }, "deployedModelId": { "type": "string", "description": "Required. The DeployedModel ID of the [ModelDeploymentMonitoringObjectiveConfig.deployed_model_id]." }, "featureDisplayName": { "description": "The feature display name. If specified, only return the stats belonging to this feature. Format: ModelMonitoringStatsAnomalies.FeatureHistoricStatsAnomalies.feature_display_name, example: \"user_destination\".", "type": "string" }, "pageSize": { "description": "The standard list page size.", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "description": "A page token received from a previous JobService.SearchModelDeploymentMonitoringStatsAnomalies call." } }, "description": "Request message for JobService.SearchModelDeploymentMonitoringStatsAnomalies.", "type": "object" }, "GoogleCloudAiplatformV1beta1AgentTool": { "type": "object", "properties": { "url": { "type": "string", "description": "Optional. Fallback for the tool's runtime reference, consumed by `CreateAgent` to create the downstream AI App. Applicable when `type` is `mcp_server` or `endpoint`, and optional: the Agent service derives the runtime reference from `name` via Agent Registry (`GetMcpServer` / `GetEndpoint`), and reads this only when that lookup yields none." }, "type": { "type": "string", "description": "Required. The type of the tool. Supported types: * `code_execution` * `endpoint` * `filesystem` * `google_search` * `mcp_server` * `url_context`" }, "name": { "description": "Optional. The tool's Google Cloud resource name, used to resolve the tool. Applicable when `type` is `mcp_server` or `endpoint` (a tool registered in Agent Registry), for example `projects/{project}/locations/{location}/.../mcpServers/{id}` or `projects/{project}/locations/{location}/.../endpoints/{id}`.", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The headers for the MCP server, such as for authentication. Only applicable when `type` is `mcp_server`." } }, "id": "GoogleCloudAiplatformV1beta1AgentTool", "description": "A tool provides a list of actions available to the Agent during the process of executing a task. Example JSON for an MCP server tool: { \"type\": \"mcp_server\", \"name\": \"my-mcp-server\", \"url\": \"https://api.example.com/mcp\", \"headers\": { \"Authorization\": \"Bearer token123\" } }" }, "GoogleCloudAiplatformV1beta1ListFeatureMonitorsResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListFeatureMonitorsResponse", "properties": { "featureMonitors": { "type": "array", "description": "The FeatureMonitors matching the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitor" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListFeatureMonitorsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response message for FeatureRegistryService.ListFeatureMonitors." }, "GenaiVertexV1beta1ParallelAISearchConfig": { "description": "Used to specify configuration for ParallelAISearch.", "properties": { "apiKey": { "description": "Optional. The API key for ParallelAiSearch.", "type": "string" }, "customConfig": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object", "description": "Optional. Custom configs for ParallelAiSearch." } }, "type": "object", "id": "GenaiVertexV1beta1ParallelAISearchConfig" }, "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetailProcessedDataset": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringJobExecutionDetailProcessedDataset", "description": "Processed dataset information.", "type": "object", "properties": { "location": { "description": "Actual data location of the processed dataset.", "type": "string" }, "timeRange": { "$ref": "GoogleTypeInterval", "description": "Dataset time range information if any." } } }, "GoogleCloudAiplatformV1beta1InputDataConfig": { "id": "GoogleCloudAiplatformV1beta1InputDataConfig", "properties": { "timestampSplit": { "$ref": "GoogleCloudAiplatformV1beta1TimestampSplit", "description": "Supported only for tabular Datasets. Split based on the timestamp of the input data pieces." }, "bigqueryDestination": { "$ref": "GoogleCloudAiplatformV1beta1BigQueryDestination", "description": "Only applicable to custom training with tabular Dataset with BigQuery source. The BigQuery project location where the training data is to be written to. In the given project a new dataset is created with name `dataset___` where timestamp is in YYYY_MM_DDThh_mm_ss_sssZ format. All training input data is written into that dataset. In the dataset three tables are created, `training`, `validation` and `test`. * AIP_DATA_FORMAT = \"bigquery\". * AIP_TRAINING_DATA_URI = \"bigquery_destination.dataset___.training\" * AIP_VALIDATION_DATA_URI = \"bigquery_destination.dataset___.validation\" * AIP_TEST_DATA_URI = \"bigquery_destination.dataset___.test\"" }, "annotationSchemaUri": { "type": "string", "description": "Applicable only to custom training with Datasets that have DataItems and Annotations. Cloud Storage URI that points to a YAML file describing the annotation schema. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/annotation/ , note that the chosen schema must be consistent with metadata of the Dataset specified by dataset_id. Only Annotations that both match this schema and belong to DataItems not ignored by the split method are used in respectively training, validation or test role, depending on the role of the DataItem they are on. When used in conjunction with annotations_filter, the Annotations used for training are filtered by both annotations_filter and annotation_schema_uri." }, "filterSplit": { "description": "Split based on the provided filters for each set.", "$ref": "GoogleCloudAiplatformV1beta1FilterSplit" }, "savedQueryId": { "type": "string", "description": "Only applicable to Datasets that have SavedQueries. The ID of a SavedQuery (annotation set) under the Dataset specified by dataset_id used for filtering Annotations for training. Only Annotations that are associated with this SavedQuery are used in respectively training. When used in conjunction with annotations_filter, the Annotations used for training are filtered by both saved_query_id and annotations_filter. Only one of saved_query_id and annotation_schema_uri should be specified as both of them represent the same thing: problem type." }, "predefinedSplit": { "description": "Supported only for tabular Datasets. Split based on a predefined key.", "$ref": "GoogleCloudAiplatformV1beta1PredefinedSplit" }, "datasetId": { "type": "string", "description": "Required. The ID of the Dataset in the same Project and Location which data will be used to train the Model. The Dataset must use schema compatible with Model being trained, and what is compatible should be described in the used TrainingPipeline's training_task_definition. For tabular Datasets, all their data is exported to training, to pick and choose from." }, "stratifiedSplit": { "$ref": "GoogleCloudAiplatformV1beta1StratifiedSplit", "description": "Supported only for tabular Datasets. Split based on the distribution of the specified column." }, "annotationsFilter": { "description": "Applicable only to Datasets that have DataItems and Annotations. A filter on Annotations of the Dataset. Only Annotations that both match this filter and belong to DataItems not ignored by the split method are used in respectively training, validation or test role, depending on the role of the DataItem they are on (for the auto-assigned that role is decided by Vertex AI). A filter with same syntax as the one used in ListAnnotations may be used, but note here it filters across all Annotations of the Dataset, and not just within a single DataItem.", "type": "string" }, "persistMlUseAssignment": { "description": "Whether to persist the ML use assignment to data item system labels.", "type": "boolean" }, "gcsDestination": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "The Cloud Storage location where the training data is to be written to. In the given directory a new directory is created with name: `dataset---` where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. All training input data is written into that directory. The Vertex AI environment variables representing Cloud Storage data URIs are represented in the Cloud Storage wildcard format to support sharded data. e.g.: \"gs://.../training-*.jsonl\" * AIP_DATA_FORMAT = \"jsonl\" for non-tabular data, \"csv\" for tabular data * AIP_TRAINING_DATA_URI = \"gcs_destination/dataset---/training-*.${AIP_DATA_FORMAT}\" * AIP_VALIDATION_DATA_URI = \"gcs_destination/dataset---/validation-*.${AIP_DATA_FORMAT}\" * AIP_TEST_DATA_URI = \"gcs_destination/dataset---/test-*.${AIP_DATA_FORMAT}\"" }, "fractionSplit": { "description": "Split based on fractions defining the size of each set.", "$ref": "GoogleCloudAiplatformV1beta1FractionSplit" } }, "description": "Specifies Vertex AI owned input data to be used for training, and possibly evaluating, the Model.", "type": "object" }, "GoogleCloudAiplatformV1beta1SuggestTrialsResponse": { "description": "Response message for VizierService.SuggestTrials.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SuggestTrialsResponse", "properties": { "studyState": { "description": "The state of the Study.", "enumDescriptions": [ "The study state is unspecified.", "The study is active.", "The study is stopped due to an internal error.", "The study is done when the service exhausts the parameter search space or max_trial_count is reached." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "INACTIVE", "COMPLETED" ], "type": "string" }, "endTime": { "format": "google-datetime", "type": "string", "description": "The time at which operation processing completed." }, "trials": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Trial" }, "description": "A list of Trials.", "type": "array" }, "startTime": { "format": "google-datetime", "type": "string", "description": "The time at which the operation was started." } } }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageClassificationPredictionInstance": { "type": "object", "description": "Prediction input format for Image Classification.", "properties": { "content": { "type": "string", "description": "The image bytes or Cloud Storage URI to make the prediction on." }, "mimeType": { "type": "string", "description": "The MIME type of the content of the image. Only the images in below listed MIME types are supported. - image/jpeg - image/gif - image/png - image/webp - image/bmp - image/tiff - image/vnd.microsoft.icon" } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceImageClassificationPredictionInstance" }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecCategoricalValueSpec": { "properties": { "values": { "description": "Required. The list of possible categories.", "type": "array", "items": { "type": "string" } }, "defaultValue": { "description": "A default value for a `CATEGORICAL` parameter that is assumed to be a relatively good starting point. Unset value signals that there is no offered starting point. Currently only supported by the Vertex AI Vizier service. Not supported by HyperparameterTuningJob or TrainingPipeline.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecCategoricalValueSpec", "description": "Value specification for a parameter in `CATEGORICAL` type.", "type": "object" }, "GenaiVertexV1beta1Content": { "description": "The content of the response.", "properties": { "text": { "$ref": "GenaiVertexV1beta1TextContent" }, "image": { "$ref": "GenaiVertexV1beta1ImageContent" }, "video": { "$ref": "GenaiVertexV1beta1VideoContent" }, "document": { "$ref": "GenaiVertexV1beta1DocumentContent" }, "audio": { "$ref": "GenaiVertexV1beta1AudioContent" } }, "id": "GenaiVertexV1beta1Content", "type": "object" }, "GoogleCloudAiplatformV1beta1CacheConfig": { "description": "Config of GenAI caching features. This is a singleton resource.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CacheConfig", "properties": { "retentionConfig": { "description": "Optional. Project-level retention type for implicit caching. On `GetCacheConfig` this is populated with the retention the project gets: a project that has stated no preference reports `DURABLE`. On `UpdateCacheConfig`, leaving it unset means the project states no preference. Whether that clears an existing preference depends on `update_mask`; see that field.", "$ref": "GoogleCloudAiplatformV1beta1CacheConfigRetentionConfig" }, "disableCache": { "description": "If set to true, disables GenAI caching. Otherwise caching is enabled.", "type": "boolean" }, "name": { "description": "Identifier. Name of the cache config. Format: - `projects/{project}/cacheConfig`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1EvaluateDatasetRun": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluateDatasetRun", "properties": { "operationName": { "type": "string", "readOnly": true, "description": "Output only. Deprecated: The updated architecture uses evaluation_run instead.", "deprecated": true }, "checkpointId": { "description": "Output only. The checkpoint id used in the evaluation run. Only populated when evaluating checkpoints.", "readOnly": true, "type": "string" }, "evaluationRun": { "description": "Output only. The resource name of the evaluation run. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run_id}`.", "readOnly": true, "type": "string" }, "evaluateDatasetResponse": { "description": "Output only. Results for EvaluationService.", "$ref": "GoogleCloudAiplatformV1beta1EvaluateDatasetResponse", "readOnly": true }, "error": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. The error of the evaluation run if any." } }, "description": "Evaluate Dataset Run Result for Tuning Job." }, "GoogleIamV1Policy": { "id": "GoogleIamV1Policy", "type": "object", "properties": { "bindings": { "items": { "$ref": "GoogleIamV1Binding" }, "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", "type": "array" }, "etag": { "format": "byte", "type": "string", "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost." }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" } }, "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/)." }, "GoogleCloudAiplatformV1beta1BleuResults": { "properties": { "bleuMetricValues": { "description": "Output only. Bleu metric values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1BleuMetricValue" }, "readOnly": true, "type": "array" } }, "type": "object", "description": "Results for bleu metric.", "id": "GoogleCloudAiplatformV1beta1BleuResults" }, "GoogleCloudAiplatformV1beta1Rubric": { "description": "Message representing a single testable criterion for evaluation. One input prompt could have multiple rubrics.", "properties": { "type": { "type": "string", "description": "Optional. A type designator for the rubric, which can inform how it's evaluated or interpreted by systems or users. It's recommended to use consistent, well-defined, upper snake_case strings. Examples: \"SUMMARIZATION_QUALITY\", \"SAFETY_HARMFUL_CONTENT\", \"INSTRUCTION_ADHERENCE\"." }, "importance": { "type": "string", "enumDescriptions": [ "Importance is not specified.", "High importance.", "Medium importance.", "Low importance." ], "enum": [ "IMPORTANCE_UNSPECIFIED", "HIGH", "MEDIUM", "LOW" ], "description": "Optional. The relative importance of this rubric." }, "content": { "$ref": "GoogleCloudAiplatformV1beta1RubricContent", "description": "Required. The actual testable criteria for the rubric." }, "rubricId": { "description": "Unique identifier for the rubric. This ID is used to refer to this rubric, e.g., in RubricVerdict.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Rubric" }, "GoogleCloudAiplatformV1beta1TrajectoryPrecisionMetricValue": { "description": "TrajectoryPrecision metric value for an instance.", "properties": { "score": { "description": "Output only. TrajectoryPrecision score.", "format": "float", "readOnly": true, "type": "number" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionMetricValue" }, "GoogleCloudAiplatformV1beta1LossExample": { "description": "Represents a specific example of a loss pattern.", "type": "object", "id": "GoogleCloudAiplatformV1beta1LossExample", "properties": { "evaluationResult": { "description": "The full evaluation result object provided inline. Used when the analysis is performed on ephemeral data (without an EvaluationSet).", "$ref": "GoogleCloudAiplatformV1beta1EvaluationResult" }, "evaluationItem": { "description": "Reference to the persisted EvalItem resource name. Format: projects/.../locations/.../evaluationItems/{item_id} Used when analysis is run on an EvalSet.", "type": "string" }, "failedRubrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FailedRubric" }, "description": "The specific rubric(s) that failed and caused this example to be classified here. An example might fail multiple rubrics, but only specific ones trigger this loss pattern.", "type": "array" } } }, "CloudAiLargeModelsVisionImageImageSize": { "description": "Image size.", "id": "CloudAiLargeModelsVisionImageImageSize", "properties": { "width": { "type": "integer", "format": "int32" }, "channels": { "type": "integer", "format": "int32" }, "height": { "type": "integer", "format": "int32" } }, "type": "object" }, "GenaiVertexV1beta1VideoContentStaticMediaProcessing": { "type": "object", "id": "GenaiVertexV1beta1VideoContentStaticMediaProcessing", "properties": { "fps": { "format": "double", "description": "Optional. Video frame-rate sampling density.", "type": "number" }, "startOffset": { "description": "Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., \"10.5s\". Must be non-negative.", "format": "google-duration", "type": "string" }, "endOffset": { "description": "Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., \"30s\". Must be non-negative and greater than `start_offset` if `start_offset` is set.", "type": "string", "format": "google-duration" } } }, "GoogleCloudAiplatformV1beta1ExplanationMetadata": { "id": "GoogleCloudAiplatformV1beta1ExplanationMetadata", "type": "object", "properties": { "inputs": { "description": "Required. Map from feature names to feature input metadata. Keys are the name of the features. Values are the specification of the feature. An empty InputMetadata is valid. It describes a text feature which has the name specified as the key in ExplanationMetadata.inputs. The baseline of the empty feature is chosen by Vertex AI. For Vertex AI-provided Tensorflow images, the key can be any friendly name of the feature. Once specified, featureAttributions are keyed by this key (if not grouped with another feature). For custom images, the key must match with the key in instance.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadata" }, "type": "object" }, "latentSpaceSource": { "type": "string", "description": "Name of the source to generate embeddings for example based explanations." }, "outputs": { "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationMetadataOutputMetadata" }, "description": "Required. Map from output names to output metadata. For Vertex AI-provided Tensorflow images, keys can be any user defined string that consists of any UTF-8 characters. For custom images, keys are the name of the output field in the prediction to be explained. Currently only one key is allowed." }, "featureAttributionsSchemaUri": { "description": "Points to a YAML file stored on Google Cloud Storage describing the format of the feature attributions. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). AutoML tabular Models always have this field populated by Vertex AI. Note: The URI given on output may be different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access.", "type": "string" } }, "description": "Metadata describing the Model's input and output for explanation." }, "GoogleCloudAiplatformV1beta1DiscoveryEngineAssistantConfig": { "description": "Config for scraping a Discovery Engine Assistant.", "type": "object", "properties": { "assistant": { "description": "Required. The resource name of the Discovery Engine Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`. For example: `projects/123/locations/global/collections/default_collection/engines/my-engine/assistants/default_assistant`.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1DiscoveryEngineAssistantConfig" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionRecognitionMetrics": { "type": "object", "properties": { "videoActionMetrics": { "description": "The metric entries for precision window lengths: 1s,2s,3s.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetrics" } }, "evaluatedActionCount": { "description": "The number of ground truth actions used to create this evaluation.", "type": "integer", "format": "int32" } }, "description": "Model evaluation metrics for video action recognition.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionRecognitionMetrics" }, "GoogleCloudAiplatformV1beta1CreateFeatureRequest": { "description": "Request message for FeaturestoreService.CreateFeature. Request message for FeatureRegistryService.CreateFeature.", "type": "object", "properties": { "featureId": { "type": "string", "description": "Required. The ID to use for the Feature, which will become the final component of the Feature's resource name. This value may be up to 128 characters, and valid characters are `[a-z0-9_]`. The first character cannot be a number. The value must be unique within an EntityType/FeatureGroup." }, "feature": { "$ref": "GoogleCloudAiplatformV1beta1Feature", "description": "Required. The Feature to create." }, "parent": { "description": "Required. The resource name of the EntityType or FeatureGroup to create a Feature. Format for entity_type as parent: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` Format for feature_group as parent: `projects/{project}/locations/{location}/featureGroups/{feature_group}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1CreateFeatureRequest" }, "GenaiVertexV1beta1FileSearchResultDelta": { "properties": { "result": { "items": { "$ref": "GenaiVertexV1beta1FileSearchResultContentFileSearchResult" }, "type": "array" } }, "id": "GenaiVertexV1beta1FileSearchResultDelta", "type": "object" }, "GoogleCloudAiplatformV1beta1BleuSpec": { "description": "Spec for bleu score metric - calculates the precision of n-grams in the prediction as compared to reference - returns a score ranging between 0 to 1.", "id": "GoogleCloudAiplatformV1beta1BleuSpec", "properties": { "useEffectiveOrder": { "description": "Optional. Whether to use_effective_order to compute bleu score.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceDataContents": { "properties": { "contents": { "description": "Optional. Repeated contents.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array" } }, "description": "List of standard Content messages from Gemini API.", "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceDataContents" }, "GoogleIamV1TestIamPermissionsRequest": { "type": "object", "description": "Request message for `TestIamPermissions` method.", "properties": { "permissions": { "items": { "type": "string" }, "type": "array", "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions)." } }, "id": "GoogleIamV1TestIamPermissionsRequest" }, "GoogleCloudAiplatformV1beta1RagRetrievalConfigFilter": { "properties": { "metadataFilter": { "type": "string", "description": "Optional. String for metadata filtering." }, "vectorSimilarityThreshold": { "description": "Optional. Only returns contexts with vector similarity larger than the threshold.", "type": "number", "format": "double" }, "vectorDistanceThreshold": { "format": "double", "description": "Optional. Only returns contexts with vector distance smaller than the threshold.", "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfigFilter", "description": "Config for filters.", "type": "object" }, "GenaiVertexV1beta1Struct": { "description": "`Struct` represents a structured data value, consisting of fields which map to dynamically typed values.", "id": "GenaiVertexV1beta1Struct", "properties": { "fields": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1Field" }, "description": "Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopePredicate": { "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopePredicate", "type": "object", "properties": { "duration": { "description": "Filter on the duration of a session (in seconds).", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "userTurns": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the number of user turns within a session." }, "toolCallErrors": { "description": "Filter on the number of tool call errors within a session.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "modelCallErrors": { "description": "Filter on the number of LLM call errors within a session.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "toolCalls": { "description": "Filter on the number of underlying tool calls within a session.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "modelCalls": { "description": "Filter on the number of underlying LLM calls within a session.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "totalTokenUsage": { "description": "Filter on the total token usage within a session.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate" }, "serviceVersion": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", "description": "Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." } }, "description": "Defines a single filter predicate." }, "GoogleCloudAiplatformV1beta1ImageResponseFormat": { "description": "Configuration for image-specific output formatting.", "id": "GoogleCloudAiplatformV1beta1ImageResponseFormat", "properties": { "delivery": { "description": "Optional. Delivery mode for the generated content.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Generated bytes are returned inline in the response.", "Generated content is stored and a URI is returned." ], "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ] }, "aspectRatio": { "description": "Optional. The aspect ratio for the image output.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "1:1 aspect ratio.", "2:3 aspect ratio.", "3:2 aspect ratio.", "3:4 aspect ratio.", "4:3 aspect ratio.", "4:5 aspect ratio.", "5:4 aspect ratio.", "9:16 aspect ratio.", "16:9 aspect ratio.", "21:9 aspect ratio.", "1:8 aspect ratio.", "8:1 aspect ratio.", "1:4 aspect ratio.", "4:1 aspect ratio." ], "enum": [ "ASPECT_RATIO_UNSPECIFIED", "ASPECT_RATIO_ONE_BY_ONE", "ASPECT_RATIO_TWO_BY_THREE", "ASPECT_RATIO_THREE_BY_TWO", "ASPECT_RATIO_THREE_BY_FOUR", "ASPECT_RATIO_FOUR_BY_THREE", "ASPECT_RATIO_FOUR_BY_FIVE", "ASPECT_RATIO_FIVE_BY_FOUR", "ASPECT_RATIO_NINE_BY_SIXTEEN", "ASPECT_RATIO_SIXTEEN_BY_NINE", "ASPECT_RATIO_TWENTY_ONE_BY_NINE", "ASPECT_RATIO_ONE_BY_EIGHT", "ASPECT_RATIO_EIGHT_BY_ONE", "ASPECT_RATIO_ONE_BY_FOUR", "ASPECT_RATIO_FOUR_BY_ONE" ] }, "imageSize": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "512px image size.", "1K image size.", "2K image size.", "4K image size." ], "enum": [ "IMAGE_SIZE_UNSPECIFIED", "IMAGE_SIZE_FIVE_TWELVE", "IMAGE_SIZE_ONE_K", "IMAGE_SIZE_TWO_K", "IMAGE_SIZE_FOUR_K" ], "description": "Optional. The size of the image output." }, "mimeType": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "JPEG image format." ], "enum": [ "MIME_TYPE_UNSPECIFIED", "IMAGE_JPEG" ], "description": "Optional. The MIME type of the image output." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExamplesArrayFilter": { "id": "GoogleCloudAiplatformV1beta1ExamplesArrayFilter", "properties": { "values": { "description": "Required. The values by which to filter examples.", "items": { "type": "string" }, "type": "array" }, "arrayOperator": { "type": "string", "description": "Required. The operator logic to use for filtering.", "enumDescriptions": [ "Not specified. This value should not be used.", "The metadata array field in the example must contain at least one of the values.", "The metadata array field in the example must contain all of the values." ], "enum": [ "ARRAY_OPERATOR_UNSPECIFIED", "CONTAINS_ANY", "CONTAINS_ALL" ] } }, "type": "object", "description": "Filters for examples' array metadata fields. An array field is example metadata where multiple values are attributed to a single example." }, "GoogleCloudAiplatformV1beta1ModelMonitoringSchema": { "description": "The Model Monitoring Schema definition.", "properties": { "groundTruthFields": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringSchemaFieldSchema" }, "description": "Target /ground truth names of the model.", "type": "array" }, "predictionFields": { "description": "Prediction output names of the model. The requirements are the same as the feature_fields. For AutoML Tables, the prediction output name presented in schema will be: `predicted_{target_column}`, the `target_column` is the one you specified when you train the model. For Prediction output drift analysis: * AutoML Classification, the distribution of the argmax label will be analyzed. * AutoML Regression, the distribution of the value will be analyzed.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringSchemaFieldSchema" } }, "featureFields": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringSchemaFieldSchema" }, "description": "Feature names of the model. Vertex AI will try to match the features from your dataset as follows: * For 'csv' files, the header names are required, and we will extract the corresponding feature values when the header names align with the feature names. * For 'jsonl' files, we will extract the corresponding feature values if the key names match the feature names. Note: Nested features are not supported, so please ensure your features are flattened. Ensure the feature values are scalar or an array of scalars. * For 'bigquery' dataset, we will extract the corresponding feature values if the column names match the feature names. Note: The column type can be a scalar or an array of scalars. STRUCT or JSON types are not supported. You may use SQL queries to select or aggregate the relevant features from your original table. However, ensure that the 'schema' of the query results meets our requirements. * For the Vertex AI Endpoint Request Response Logging table or Vertex AI Batch Prediction Job results. If the instance_type is an array, ensure that the sequence in feature_fields matches the order of features in the prediction instance. We will match the feature with the array in the order specified in [feature_fields].", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringSchema" }, "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataResponse": { "id": "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataResponse", "description": "Response message for TensorboardService.WriteTensorboardRunData.", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results." }, "summary": { "$ref": "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponseViewSummary", "description": "Summary statistics computed across the sessions on the current page only. For statistics across the entire result set, use AggregateAnalyzedSessions." }, "analyzedSessions": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1AnalyzedSession" }, "description": "The list of analyzed sessions." } }, "type": "object", "description": "Response to list analyzed sessions.", "id": "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponse" }, "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig": { "description": "The configuration (stopping conditions) for automated stopping of a Study. Conditions include trial budgets, time budgets, and convergence detection.", "properties": { "maxNumTrials": { "format": "int32", "description": "If there are more than this many trials, stop the study.", "type": "integer" }, "shouldStopAsap": { "type": "boolean", "description": "If true, a Study enters STOPPING_ASAP whenever it would normally enters STOPPING state. The bottom line is: set to true if you want to interrupt on-going evaluations of Trials as soon as the study stopping condition is met. (Please see Study.State documentation for the source of truth)." }, "maximumRuntimeConstraint": { "$ref": "GoogleCloudAiplatformV1beta1StudyTimeConstraint", "description": "If the specified time or duration has passed, stop the study." }, "maxNumTrialsNoProgress": { "type": "integer", "format": "int32", "description": "If the objective value has not improved for this many consecutive trials, stop the study. WARNING: Effective only for single-objective studies." }, "minNumTrials": { "type": "integer", "description": "If there are fewer than this many COMPLETED trials, do not stop the study.", "format": "int32" }, "minimumRuntimeConstraint": { "$ref": "GoogleCloudAiplatformV1beta1StudyTimeConstraint", "description": "Each \"stopping rule\" in this proto specifies an \"if\" condition. Before Vizier would generate a new suggestion, it first checks each specified stopping rule, from top to bottom in this list. Note that the first few rules (e.g. minimum_runtime_constraint, min_num_trials) will prevent other stopping rules from being evaluated until they are met. For example, setting `min_num_trials=5` and `always_stop_after= 1 hour` means that the Study will ONLY stop after it has 5 COMPLETED trials, even if more than an hour has passed since its creation. It follows the first applicable rule (whose \"if\" condition is satisfied) to make a stopping decision. If none of the specified rules are applicable, then Vizier decides that the study should not stop. If Vizier decides that the study should stop, the study enters STOPPING state (or STOPPING_ASAP if should_stop_asap = true). IMPORTANT: The automatic study state transition happens precisely as described above; that is, deleting trials or updating StudyConfig NEVER automatically moves the study state back to ACTIVE. If you want to _resume_ a Study that was stopped, 1) change the stopping conditions if necessary, 2) activate the study, and then 3) ask for suggestions. If the specified time or duration has not passed, do not stop the study." }, "maxDurationNoProgress": { "description": "If the objective value has not improved for this much time, stop the study. WARNING: Effective only for single-objective studies.", "type": "string", "format": "google-duration" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1StudySpecStudyStoppingConfig" }, "GoogleCloudAiplatformV1beta1DeleteMetadataStoreOperationMetadata": { "description": "Details of operations that perform MetadataService.DeleteMetadataStore.", "type": "object", "properties": { "genericMetadata": { "description": "Operation metadata for deleting a MetadataStore.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "id": "GoogleCloudAiplatformV1beta1DeleteMetadataStoreOperationMetadata" }, "GoogleCloudAiplatformV1beta1MetricMetadataScoreRange": { "properties": { "max": { "format": "double", "type": "number", "description": "Required. The maximum value of the score range (inclusive)." }, "step": { "type": "number", "description": "Optional. The distance between discrete steps in the range. If unset, the range is assumed to be continuous.", "format": "double" }, "min": { "type": "number", "description": "Required. The minimum value of the score range (inclusive).", "format": "double" }, "description": { "type": "string", "description": "Optional. The description of the score explaining the directionality etc." } }, "id": "GoogleCloudAiplatformV1beta1MetricMetadataScoreRange", "description": "The range of possible scores for this metric, used for plotting.", "type": "object" }, "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponse": { "description": "Contains aggregated AnalyzedSession statistics, grouped by MonitoredAgent.", "type": "object", "properties": { "summary": { "description": "Overall summary across every MonitoredAgent included in the response.", "$ref": "GoogleCloudAiplatformV1beta1ListAnalyzedSessionsResponseViewSummary" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "agentAggregates": { "description": "Aggregated statistics — exactly one entry per unique MonitoredAgent matched by the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponseAgentAggregate" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1AggregateAnalyzedSessionsResponse" }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableAutoScaling": { "properties": { "cpuUtilizationTarget": { "type": "integer", "format": "int32", "description": "Optional. A percentage of the cluster's CPU capacity. Can be from 10% to 80%. When a cluster's CPU utilization exceeds the target that you have set, Bigtable immediately adds nodes to the cluster. When CPU utilization is substantially lower than the target, Bigtable removes nodes. If not set will default to 50%." }, "maxNodeCount": { "type": "integer", "description": "Required. The maximum number of nodes to scale up to. Must be greater than or equal to min_node_count, and less than or equal to 10 times of 'min_node_count'.", "format": "int32" }, "minNodeCount": { "type": "integer", "format": "int32", "description": "Required. The minimum number of nodes to scale down to. Must be greater than or equal to 1." } }, "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableAutoScaling", "type": "object" }, "GoogleCloudAiplatformV1beta1PredictRequest": { "type": "object", "properties": { "labels": { "description": "Optional. The user labels for Imagen billing usage only. Only Imagen supports labels. For other use cases, it will be ignored.", "type": "object", "additionalProperties": { "type": "string" } }, "parameters": { "description": "The parameters that govern the prediction. The schema of the parameters may be specified via Endpoint's DeployedModels' Model's PredictSchemata's parameters_schema_uri.", "type": "any" }, "instances": { "items": { "type": "any" }, "type": "array", "description": "Required. The instances that are the input to the prediction call. A DeployedModel may have an upper limit on the number of instances it supports per request, and when it is exceeded the prediction call errors in case of AutoML Models, or, in case of customer created Models, the behaviour is as documented by that Model. The schema of any single instance may be specified via Endpoint's DeployedModels' Model's PredictSchemata's instance_schema_uri." } }, "id": "GoogleCloudAiplatformV1beta1PredictRequest", "description": "Request message for PredictionService.Predict." }, "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInstance": { "description": "Spec for summarization helpfulness instance.", "type": "object", "properties": { "context": { "description": "Required. Text to be summarized.", "type": "string" }, "instruction": { "description": "Optional. Summarization prompt for LLM.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessInstance" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoObjectTrackingMetrics": { "properties": { "trackMeanAveragePrecision": { "format": "float", "type": "number", "description": "UNIMPLEMENTED. The single metric for tracks accuracy evaluation: the `meanAveragePrecision` averaged over all `trackMetrics`." }, "evaluatedTrackCount": { "type": "integer", "description": "UNIMPLEMENTED. The total number of tracks (i.e. as seen across all frames) the ground truth used to create this evaluation had.", "format": "int32" }, "boundingBoxMetrics": { "type": "array", "description": "The bounding boxes match metrics for each intersection-over-union threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 and each label confidence threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 pair.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetrics" } }, "trackMeanBoundingBoxIou": { "type": "number", "format": "float", "description": "UNIMPLEMENTED. The single metric for tracks bounding box iou evaluation: the `meanBoundingBoxIou` averaged over all `trackMetrics`." }, "trackMetrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetrics" }, "description": "UNIMPLEMENTED. The tracks match metrics for each intersection-over-union threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 and each label confidence threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 pair.", "type": "array" }, "trackMeanMismatchRate": { "description": "UNIMPLEMENTED. The single metric for tracking consistency evaluation: the `meanMismatchRate` averaged over all `trackMetrics`.", "format": "float", "type": "number" }, "evaluatedFrameCount": { "description": "UNIMPLEMENTED. The number of video frames used to create this evaluation.", "format": "int32", "type": "integer" }, "boundingBoxMeanAveragePrecision": { "format": "float", "description": "The single metric for bounding boxes evaluation: the `meanAveragePrecision` averaged over all `boundingBoxMetrics`.", "type": "number" }, "evaluatedBoundingBoxCount": { "description": "UNIMPLEMENTED. The total number of bounding boxes (i.e. summed over all frames) the ground truth used to create this evaluation had.", "format": "int32", "type": "integer" } }, "description": "Model evaluation metrics for video object tracking problems. Evaluates prediction quality of both labeled bounding boxes and labeled tracks (i.e. series of bounding boxes sharing same label and instance ID).", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoObjectTrackingMetrics", "type": "object" }, "GoogleCloudAiplatformV1beta1QueryExtensionRequest": { "properties": { "contents": { "type": "array", "description": "Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } } }, "type": "object", "description": "Request message for ExtensionExecutionService.QueryExtension.", "id": "GoogleCloudAiplatformV1beta1QueryExtensionRequest" }, "GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec", "description": "Specification for a computation based metric.", "properties": { "parameters": { "description": "Optional. A map of parameters for the metric, e.g. {\"rouge_type\": \"rougeL\"}.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "type": { "enum": [ "COMPUTATION_BASED_METRIC_TYPE_UNSPECIFIED", "EXACT_MATCH", "BLEU", "ROUGE" ], "description": "Required. The type of the computation based metric.", "enumDescriptions": [ "Unspecified computation based metric type.", "Exact match metric.", "BLEU metric.", "ROUGE metric." ], "type": "string" } } }, "GoogleCloudAiplatformV1beta1Port": { "description": "Represents a network port in a container.", "properties": { "containerPort": { "type": "integer", "format": "int32", "description": "The number of the port to expose on the pod's IP address. Must be a valid port number, between 1 and 65535 inclusive." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Port" }, "GoogleCloudAiplatformV1beta1EnableModelRequest": { "properties": { "service": { "deprecated": true, "description": "Optional. The ID links the Marketplace listing to the underlying Vertex AI model endpoint. Format: `services/{service_id}` Format: `services/{service_id}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1EnableModelRequest", "description": "Request message for ModelGardenService.EnableModel.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReplicatedVoiceConfig": { "id": "GoogleCloudAiplatformV1beta1ReplicatedVoiceConfig", "properties": { "mimeType": { "description": "Optional. The mimetype of the voice sample. The only currently supported value is `audio/wav`. This represents 16-bit signed little-endian wav data, with a 24kHz sampling rate. `mime_type` will default to `audio/wav` if not set.", "type": "string" }, "voiceSampleAudio": { "description": "Optional. The sample of the custom voice.", "format": "byte", "type": "string" } }, "type": "object", "description": "The configuration for the replicated voice to use." }, "GenaiVertexV1beta1CodeMenderAgentConfigFindRequest": { "description": "Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase.", "type": "object", "id": "GenaiVertexV1beta1CodeMenderAgentConfigFindRequest", "properties": { "findingId": { "type": "string", "description": "The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability." }, "mode": { "enumDescriptions": [ "Default value. This value is unused.", "Fast scan using only the initial classifier.", "Performs classification followed by detailed investigation." ], "type": "string", "description": "The mode of the find session.", "enum": [ "MODE_UNSPECIFIED", "MODE_SCAN", "MODE_VERIFY" ] }, "sourceFiles": { "items": { "$ref": "GenaiVertexV1beta1CodeMenderAgentConfigFileContent" }, "description": "A list of source files to provide as context for the scan.", "type": "array" }, "description": { "type": "string", "description": "Additional context or custom instructions provided by the user to guide the vulnerability analysis." } } }, "GoogleCloudAiplatformV1beta1RaySpec": { "properties": { "rayClusterAutoscalingSpec": { "description": "Optional. Optional Ray autoscaling configurations.", "$ref": "GoogleCloudAiplatformV1beta1RayClusterAutoscalingSpec" }, "headNodeResourcePoolId": { "type": "string", "description": "Optional. This will be used to indicate which resource pool will serve as the Ray head node(the first node within that pool). Will use the machine from the first workerpool as the head node by default if this field isn't set." }, "resourcePoolImages": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. Required if image_uri isn't set. A map of resource_pool_id to prebuild Ray image if user need to use different images for different head/worker pools. This map needs to cover all the resource pool ids. Example: { \"ray_head_node_pool\": \"head image\" \"ray_worker_node_pool1\": \"worker image\" \"ray_worker_node_pool2\": \"another worker image\" }" }, "rayLogsSpec": { "$ref": "GoogleCloudAiplatformV1beta1RayLogsSpec", "description": "Optional. OSS Ray logging configurations." }, "nfsMounts": { "items": { "$ref": "GoogleCloudAiplatformV1beta1NfsMount" }, "type": "array", "description": "Optional. Use if you want to mount to any NFS storages." }, "imageUri": { "description": "Optional. Default image for user to choose a preferred ML framework (for example, TensorFlow or Pytorch) by choosing from [Vertex prebuilt images](https://cloud.google.com/vertex-ai/docs/training/pre-built-containers). Either this or the resource_pool_images is required. Use this field if you need all the resource pools to have the same Ray image. Otherwise, use the {@code resource_pool_images} field.", "type": "string" }, "rayMetricSpec": { "description": "Optional. Ray metrics configurations.", "$ref": "GoogleCloudAiplatformV1beta1RayMetricSpec" } }, "id": "GoogleCloudAiplatformV1beta1RaySpec", "type": "object", "description": "Configuration information for the Ray cluster. For experimental launch, Ray cluster creation and Persistent cluster creation are 1:1 mapping: We will provision all the nodes within the Persistent cluster as Ray nodes." }, "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecNgramSpeculation": { "id": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecNgramSpeculation", "description": "N-Gram speculation works by trying to find matching tokens in the previous prompt sequence and use those as speculation for generating new tokens.", "type": "object", "properties": { "ngramSize": { "format": "int32", "type": "integer", "description": "The number of last N input tokens used as ngram to search/match against the previous prompt sequence. This is equal to the N in N-Gram. The default value is 3 if not specified." } } }, "GoogleCloudAiplatformV1beta1DeployedIndex": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DeployedIndex", "description": "A deployment of an Index. IndexEndpoints contain one or more DeployedIndexes.", "properties": { "reservedIpRanges": { "items": { "type": "string" }, "description": "Optional. A list of reserved ip ranges under the VPC network that can be used for this DeployedIndex. If set, we will deploy the index within the provided ip ranges. Otherwise, the index might be deployed to any ip ranges under the provided VPC network. The value should be the name of the address (https://cloud.google.com/compute/docs/reference/rest/v1/addresses) Example: ['vertex-ai-ip-range']. For more information about subnets and network IP ranges, please see https://cloud.google.com/vpc/docs/subnets#manually_created_subnet_ip_ranges.", "type": "array" }, "deployedIndexAuthConfig": { "description": "Optional. If set, the authentication is enabled for the private endpoint.", "$ref": "GoogleCloudAiplatformV1beta1DeployedIndexAuthConfig" }, "deploymentTier": { "description": "Optional. The deployment tier that the index is deployed to. DEPLOYMENT_TIER_UNSPECIFIED will use a system-chosen default tier.", "enum": [ "DEPLOYMENT_TIER_UNSPECIFIED", "STORAGE" ], "enumDescriptions": [ "Default deployment tier.", "Optimized for costs." ], "type": "string" }, "indexSyncTime": { "format": "google-datetime", "description": "Output only. The DeployedIndex may depend on various data on its original Index. Additionally when certain changes to the original Index are being done (e.g. when what the Index contains is being changed) the DeployedIndex may be asynchronously updated in the background to reflect these changes. If this timestamp's value is at least the Index.update_time of the original Index, it means that this DeployedIndex and the original Index are in sync. If this timestamp is older, then to see which updates this DeployedIndex already contains (and which it does not), one must list the operations that are running on the original Index. Only the successfully completed Operations with update_time equal or before this sync time are contained in this DeployedIndex.", "readOnly": true, "type": "string" }, "id": { "description": "Required. The user specified ID of the DeployedIndex. The ID can be up to 128 characters long and must start with a letter and only contain letters, numbers, and underscores. The ID must be unique within the project it is created in.", "type": "string" }, "automaticResources": { "description": "Optional. A description of resources that the DeployedIndex uses, which to large degree are decided by Vertex AI, and optionally allows only a modest additional configuration. If min_replica_count is not set, the default value is 2 (we don't provide SLA when min_replica_count=1). If max_replica_count is not set, the default value is min_replica_count. The max allowed replica count is 1000.", "$ref": "GoogleCloudAiplatformV1beta1AutomaticResources" }, "pscAutomationConfigs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1PSCAutomationConfig" }, "description": "Optional. If set for PSC deployed index, PSC connection will be automatically created after deployment is done and the endpoint information is populated in private_endpoints.psc_automated_endpoints." }, "index": { "description": "Required. The name of the Index this is the deployment of. We may refer to this Index as the DeployedIndex's \"original\" Index.", "type": "string" }, "enableAccessLogging": { "description": "Optional. If true, private endpoint's access logs are sent to Cloud Logging. These logs are like standard server access logs, containing information like timestamp and latency for each MatchRequest. Note that logs may incur a cost, especially if the deployed index receives a high queries per second rate (QPS). Estimate your costs before enabling this option.", "type": "boolean" }, "privateEndpoints": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1IndexPrivateEndpoints", "description": "Output only. Provides paths for users to send requests directly to the deployed index services running on Cloud via private services access. This field is populated if network is configured." }, "enableDatapointUpsertLogging": { "type": "boolean", "description": "Optional. If true, logs to Cloud Logging errors relating to datapoint upserts. Under normal operation conditions, these log entries should be very rare. However, if incompatible datapoint updates are being uploaded to an index, a high volume of log entries may be generated in a short period of time. Note that logs may incur a cost, especially if the deployed index receives a high volume of datapoint upserts. Estimate your costs before enabling this option." }, "dedicatedResources": { "description": "Optional. A description of resources that are dedicated to the DeployedIndex, and that need a higher degree of manual configuration. The field min_replica_count must be set to a value strictly greater than 0, or else validation will fail. We don't provide SLA when min_replica_count=1. If max_replica_count is not set, the default value is min_replica_count. The max allowed replica count is 1000. Available machine types for SMALL shard: e2-standard-2 and all machine types available for MEDIUM and LARGE shard. Available machine types for MEDIUM shard: e2-standard-16 and all machine types available for LARGE shard. Available machine types for LARGE shard: e2-highmem-16, n2d-standard-32. n1-standard-16 and n1-standard-32 are still available, but we recommend e2-standard-16 and e2-highmem-16 for cost efficiency.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "displayName": { "description": "The display name of the DeployedIndex. If not provided upon creation, the Index's display_name is used.", "type": "string" }, "deploymentGroup": { "type": "string", "description": "Optional. The deployment group can be no longer than 64 characters (eg: 'test', 'prod'). If not set, we will use the 'default' deployment group. Creating `deployment_groups` with `reserved_ip_ranges` is a recommended practice when the peered network has multiple peering ranges. This creates your deployments from predictable IP spaces for easier traffic administration. Also, one deployment_group (except 'default') can only be used with the same reserved_ip_ranges which means if the deployment_group has been used with reserved_ip_ranges: [a, b, c], using it with [a, b] or [d, e] is disallowed. Note: we only support up to 5 deployment groups(not including 'default')." }, "createTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when the DeployedIndex was created.", "type": "string" } } }, "GenaiVertexV1beta1CodeMenderAgentConfigSessionConfig": { "id": "GenaiVertexV1beta1CodeMenderAgentConfigSessionConfig", "description": "The configuration of CodeMender sessions.", "type": "object", "properties": { "maxRounds": { "type": "integer", "description": "The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.", "format": "int32" } } }, "GoogleCloudAiplatformV1beta1DatasetStats": { "type": "object", "properties": { "tuningStepCount": { "format": "int64", "description": "Output only. Number of tuning steps for this Tuning Job.", "type": "string", "readOnly": true }, "tuningDatasetExampleCount": { "format": "int64", "type": "string", "readOnly": true, "description": "Output only. Number of examples in the tuning dataset." }, "droppedExampleReasons": { "readOnly": true, "description": "Output only. For each index in `dropped_example_indices`, the user-facing reason why the example was dropped.", "items": { "type": "string" }, "type": "array" }, "reinforcementTuningUserDatasetExamples": { "description": "Output only. Sample user dataset examples in the training dataset uri for Reinforcement Tuning.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningUserDatasetExamples" }, "totalBillableCharacterCount": { "readOnly": true, "description": "Output only. Number of billable characters in the tuning dataset.", "format": "int64", "type": "string" }, "userMessagePerExampleDistribution": { "readOnly": true, "description": "Output only. Dataset distributions for the messages per example.", "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution" }, "totalBillableTokenCount": { "description": "Output only. Number of billable tokens in the tuning dataset.", "type": "string", "format": "int64", "readOnly": true }, "totalTuningCharacterCount": { "format": "int64", "description": "Output only. Number of tuning characters in the tuning dataset.", "type": "string", "readOnly": true }, "userInputTokenDistribution": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "readOnly": true, "description": "Output only. Dataset distributions for the user input tokens." }, "userDatasetExamples": { "readOnly": true, "description": "Output only. Sample user messages in the training dataset uri.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array" }, "contentsPerExampleDistribution": { "description": "Output only. Dataset distributions for the number of contents per example.", "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "readOnly": true }, "userOutputTokenDistribution": { "$ref": "GoogleCloudAiplatformV1beta1DatasetDistribution", "description": "Output only. Dataset distributions for the user output tokens.", "readOnly": true }, "droppedExampleIndices": { "readOnly": true, "description": "Output only. A partial sample of the indices (starting from 1) of the dropped examples.", "items": { "format": "int64", "type": "string" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1DatasetStats", "description": "Statistics computed over a tuning dataset." }, "CloudAiLargeModelsVisionVideo": { "description": "Video", "properties": { "video": { "description": "Raw bytes.", "type": "string", "format": "byte" }, "encodedVideo": { "description": "Base 64 encoded video bytes.", "type": "string" }, "encoding": { "type": "string", "description": "Video encoding, for example \"video/mp4\"." }, "uri": { "description": "Path to another storage (typically Google Cloud Storage).", "type": "string" }, "text": { "type": "string", "description": "Text/Expanded text input for Help Me Write." } }, "type": "object", "id": "CloudAiLargeModelsVisionVideo" }, "GenaiVertexV1beta1TextResponseFormat": { "type": "object", "description": "Configuration for text output format.", "properties": { "mimeType": { "type": "string", "description": "The MIME type of the text output.", "enumDescriptions": [ "Default value. This value is unused.", "JSON output format.", "Plain text output format." ], "enum": [ "TYPE_UNSPECIFIED", "TYPE_APPLICATION_JSON", "TYPE_TEXT_PLAIN" ] }, "schema": { "description": "The JSON schema that the output should conform to. Only applicable when mime_type is application/json.", "$ref": "GenaiVertexV1beta1Struct" } }, "id": "GenaiVertexV1beta1TextResponseFormat" }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeatureFeatureValueAndTimestamp": { "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValuesFeatureFeatureValueAndTimestamp", "properties": { "timestamp": { "description": "The feature timestamp to store with this value. If not set, then the Feature Store server will generate a timestamp when it receives the write request.", "type": "string", "format": "google-datetime" }, "value": { "description": "The feature value.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValue" } }, "description": "Feature value and timestamp.", "type": "object" }, "GoogleCloudAiplatformV1beta1ExportDataOperationMetadata": { "type": "object", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The common part of the operation metadata." }, "gcsOutputDirectory": { "type": "string", "description": "A Google Cloud Storage directory which path ends with '/'. The exported data is stored in the directory." } }, "description": "Runtime operation information for DatasetService.ExportData.", "id": "GoogleCloudAiplatformV1beta1ExportDataOperationMetadata" }, "GoogleCloudAiplatformV1beta1ListFeatureGroupsResponse": { "description": "Response message for FeatureRegistryService.ListFeatureGroups.", "properties": { "featureGroups": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureGroup" }, "description": "The FeatureGroups matching the request.", "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as ListFeatureGroupsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ListFeatureGroupsResponse" }, "GoogleCloudAiplatformV1beta1SyntheticExample": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SyntheticExample", "properties": { "fields": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SyntheticField" }, "description": "Required. A list of fields that constitute an example.", "type": "array" } }, "description": "A single instance of generated synthetic data. Each example is made up of one or more named fields, as defined in `OutputFieldSpec`. These examples are used as few-shot examples to show the model what you want (in `GenerateSyntheticDataRequest.examples`) and to return generated examples in the response (in `GenerateSyntheticDataResponse.synthetic_examples`)." }, "GoogleCloudAiplatformV1beta1ExportDataRequest": { "description": "Request message for DatasetService.ExportData.", "id": "GoogleCloudAiplatformV1beta1ExportDataRequest", "properties": { "exportConfig": { "$ref": "GoogleCloudAiplatformV1beta1ExportDataConfig", "description": "Required. The desired output location." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningParseResponseConfig": { "description": "Defines how to parse sample response config for reinforcement tuning. The parsed response (i.e., substring) will be passed to the reward functions. For example, the input prompt might be: \u003e \"Perform step-by-step thoughts first to problem A, finally output answer in the \u003cans\u003e \u003c/ans\u003e block.\" The sample response from the model under tuning might look like: \u003e \"\u003cans\u003eYes\u003c/ans\u003e\" Here, users can define the following parse config: ``` { \"parseType\": \"REGEX_EXTRACT\", \"regexExtractExpression\": \".*(.*?)\" } ``` The resulting parsed response would be `\"Yes\"` and will be passed to the reward functions for evaluating rewards.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningParseResponseConfig", "properties": { "parseType": { "type": "string", "enumDescriptions": [ "Default value. Fallback to IDENTITY", "Returns the sample response as is.", "Uses regex to extract the important part of sample response. Similar to [GoogleSQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/string_functions#regexp_extract) `REGEX_EXTRACT(response, regex_extract_expression)`, but different in that if there are multiple matches, the last match will be returned." ], "description": "Defines the type for parsing sample response.", "enum": [ "RESPONSE_PARSE_TYPE_UNSPECIFIED", "IDENTITY", "REGEX_EXTRACT" ] }, "regexExtractExpression": { "description": "Defines the regex for extracting the important part of sample response. This field is only used when parse_type is ResponseParseType.REGEX_EXTRACT.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataRequest": { "description": "Request message for TensorboardService.WriteTensorboardRunData.", "type": "object", "id": "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataRequest", "properties": { "timeSeriesData": { "type": "array", "description": "Required. The TensorboardTimeSeries data to write. Values with in a time series are indexed by their step value. Repeated writes to the same step will overwrite the existing value for that step. The upper limit of data points per write request is 5000.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TimeSeriesData" } }, "tensorboardRun": { "type": "string", "description": "Required. The resource name of the TensorboardRun to write data to. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`" } } }, "GoogleCloudAiplatformV1beta1PointwiseMetricResult": { "description": "Spec for pointwise metric result.", "id": "GoogleCloudAiplatformV1beta1PointwiseMetricResult", "properties": { "customOutput": { "description": "Output only. Spec for custom output.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1CustomOutput" }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for pointwise metric score." }, "score": { "readOnly": true, "description": "Output only. Pointwise metric score.", "type": "number", "format": "float" } }, "type": "object" }, "CloudAiLargeModelsVisionImage": { "id": "CloudAiLargeModelsVisionImage", "type": "object", "properties": { "raiInfo": { "$ref": "CloudAiLargeModelsVisionRaiInfo", "description": "RAI info for image." }, "semanticFilterResponse": { "description": "Semantic filter info for image.", "$ref": "CloudAiLargeModelsVisionSemanticFilterResponse" }, "generationSeed": { "description": "Generation seed for the sampled image. This parameter is exposed to the user only if one of the following is true: 1. The user specified per-example seeds in the request. 2. The user doesn't specify the generation seed in the request.", "type": "integer", "format": "int32" }, "encoding": { "description": "Image encoding, encoded as \"image/png\" or \"image/jpg\".", "type": "string" }, "imageSize": { "description": "Image size. The size of the image. Can be self reported, or computed from the image bytes.", "$ref": "CloudAiLargeModelsVisionImageImageSize" }, "uri": { "type": "string", "description": "Path to another storage (typically Google Cloud Storage)." }, "text": { "type": "string", "description": "Text/Expanded text input for imagen." }, "image": { "format": "byte", "type": "string", "description": "Raw bytes." }, "imageRaiScores": { "$ref": "CloudAiLargeModelsVisionImageRAIScores", "description": "RAI scores for generated image." } }, "description": "Image." }, "GoogleCloudAiplatformV1beta1EvaluationRun": { "description": "EvaluationRun is a resource that represents a single evaluation run, which includes a set of prompts, model responses, evaluation configuration and the resulting metrics.", "type": "object", "properties": { "evaluationConfig": { "description": "Optional. The configuration used for the evaluation. Optional when analysis_configs is provided.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfig" }, "evaluationResults": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationResults", "description": "Output only. The results of the evaluation run. Only populated when the evaluation run's state is SUCCEEDED.", "readOnly": true }, "inferenceConfigs": { "type": "object", "description": "Optional. The candidate to inference config map for the evaluation run. The candidate can be up to 128 characters long and can consist of any UTF-8 characters.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfig" } }, "evaluationExperiment": { "description": "Optional. The resource name of the evaluation experiment for the evaluation run. Setting the evaluation experiment will add the run to the experiment. Multiple runs can be added to the same experiment. Format: `projects/{project}/locations/{location}/evaluationExperiments/{evaluation_experiment}`", "type": "string" }, "completionTime": { "format": "google-datetime", "description": "Output only. Time when the evaluation run was completed.", "type": "string", "readOnly": true }, "error": { "$ref": "GoogleRpcStatus", "readOnly": true, "description": "Output only. Only populated when the evaluation run's state is FAILED or CANCELLED." }, "displayName": { "description": "Required. The display name of the Evaluation Run.", "type": "string" }, "metadata": { "type": "any", "description": "Optional. Metadata about the evaluation run, can be used by the caller to store additional tracking information about the evaluation run." }, "createTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Time when the evaluation run was created." }, "dataSource": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunDataSource", "description": "Required. The data source for the evaluation run." }, "state": { "readOnly": true, "type": "string", "enumDescriptions": [ "Unspecified state.", "The evaluation run is pending.", "The evaluation run is running.", "The evaluation run has succeeded.", "The evaluation run has failed.", "The evaluation run has been cancelled.", "The evaluation run is performing inference.", "The evaluation run is performing rubric generation.", "The evaluation run is performing loss analysis." ], "enum": [ "STATE_UNSPECIFIED", "PENDING", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED", "INFERENCE", "GENERATING_RUBRICS", "GENERATING_LOSS_CLUSTERS" ], "description": "Output only. The state of the evaluation run." }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Labels for the evaluation run." }, "name": { "type": "string", "description": "Identifier. The resource name of the EvaluationRun. This is a unique identifier. Format: `projects/{project}/locations/{location}/evaluationRuns/{evaluation_run}`" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Optional. Customer-managed encryption key spec for this EvaluationRun. If set, this EvaluationRun will be secured by this key." }, "evaluationSetSnapshot": { "type": "string", "readOnly": true, "description": "Output only. The specific evaluation set of the evaluation run. For runs with an evaluation set input, this will be that same set. For runs with BigQuery input, it's the sampled BigQuery dataset." } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRun" }, "GoogleCloudAiplatformV1beta1AgentEvent": { "type": "object", "description": "Represents a single event in the execution trace.", "properties": { "content": { "description": "Required. The content of the event (e.g., text response, tool call, tool response).", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "stateDelta": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. The change in the session state caused by this event. This is a key-value map of fields that were modified or added by the event." }, "eventTime": { "format": "google-datetime", "type": "string", "description": "Optional. The timestamp when the event occurred." }, "author": { "description": "Required. The ID of the agent or entity that generated this event. Use \"user\" to denote events generated by the end-user.", "type": "string" }, "activeTools": { "description": "Optional. The list of tools that were active/available to the agent at the time of this event. This overrides the `AgentConfig.tools` if set.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } } }, "id": "GoogleCloudAiplatformV1beta1AgentEvent" }, "GoogleCloudAiplatformV1beta1CandidateResult": { "description": "Result for a single candidate.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CandidateResult", "properties": { "candidate": { "description": "Required. The candidate that is being evaluated. The value is the same as the candidate name in the EvaluationRequest.", "type": "string" }, "explanation": { "description": "Optional. The explanation for the metric.", "type": "string" }, "metric": { "type": "string", "description": "Required. The metric that was evaluated." }, "score": { "type": "number", "format": "float", "description": "Optional. The score for the metric." }, "error": { "readOnly": true, "description": "Output only. Error while evaluating the candidate for the metric.", "$ref": "GoogleRpcStatus" }, "additionalResults": { "description": "Optional. Additional results for the metric.", "type": "any" }, "rubricVerdicts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RubricVerdict" }, "description": "Optional. The rubric verdicts for the metric." } } }, "GoogleCloudAiplatformV1beta1GoogleMapsPlaces": { "type": "object", "description": "Grounding with Google Maps Places data (e.g. QueryPlaces). This is the default Google Maps grounding type when no other type is specified.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1GoogleMapsPlaces" }, "GoogleCloudAiplatformV1beta1CancelTuningJobRequest": { "id": "GoogleCloudAiplatformV1beta1CancelTuningJobRequest", "properties": {}, "description": "Request message for GenAiTuningService.CancelTuningJob.", "type": "object" }, "GoogleCloudAiplatformV1beta1AssessmentDetectorFinding": { "id": "GoogleCloudAiplatformV1beta1AssessmentDetectorFinding", "properties": { "recommendations": { "description": "The list of recommendations for this detector finding.", "items": { "type": "string" }, "type": "array" }, "displayName": { "description": "The detector display name.", "type": "string" }, "severity": { "type": "string", "description": "The severity of the finding.", "enum": [ "SEVERITY_UNSPECIFIED", "SEVERITY_LOW", "SEVERITY_MEDIUM", "SEVERITY_HIGH", "SEVERITY_CRITICAL" ], "enumDescriptions": [ "Unspecified severity.", "Low severity.", "Medium severity.", "High severity.", "Critical severity." ] }, "detectorId": { "type": "string", "description": "The detector ID." }, "explanation": { "description": "The explanation of the finding.", "type": "string" }, "probability": { "type": "number", "format": "double", "description": "The probability that this finding is an anomaly, in the range [0.0, 1.0]." } }, "description": "The details of a detector's assessment within an analyzed session.", "type": "object" }, "GenaiVertexV1beta1UrlContext": { "id": "GenaiVertexV1beta1UrlContext", "type": "object", "properties": {}, "description": "A tool that can be used by the model to fetch URL context." }, "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25": { "description": "Message for BM25 parameters.", "id": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfigSparseEmbeddingConfigBm25", "properties": { "k1": { "description": "Optional. The parameter to control term frequency saturation. It determines the scaling between the matching term frequency and final score. k1 is in the range of [1.2, 3]. The default value is 1.2.", "type": "number", "format": "float" }, "b": { "format": "float", "description": "Optional. The parameter to control document length normalization. It determines how much the document length affects the final score. b is in the range of [0, 1]. The default value is 0.75.", "type": "number" }, "multilingual": { "description": "Optional. Use multilingual tokenizer if set to true.", "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned": { "description": "Disables the RAG Engine service and deletes all your data held within this service. This will halt the billing of the service. NOTE: Once deleted the data cannot be recovered. To start using RAG Engine again, you will need to update the tier by calling the UpdateRagEngineConfig API.", "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1FractionSplit": { "properties": { "testFraction": { "type": "number", "description": "The fraction of the input data that is to be used to evaluate the Model.", "format": "double" }, "trainingFraction": { "format": "double", "description": "The fraction of the input data that is to be used to train the Model.", "type": "number" }, "validationFraction": { "type": "number", "description": "The fraction of the input data that is to be used to validate the Model.", "format": "double" } }, "id": "GoogleCloudAiplatformV1beta1FractionSplit", "description": "Assigns the input data to training, validation, and test sets as per the given fractions. Any of `training_fraction`, `validation_fraction` and `test_fraction` may optionally be provided, they must sum to up to 1. If the provided ones sum to less than 1, the remainder is assigned to sets as decided by Vertex AI. If none of the fractions are set, by default roughly 80% of data is used for training, 10% for validation, and 10% for test.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecPythonSpec": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecPythonSpec", "type": "object", "description": "Specification for running a Python application from source.", "properties": { "version": { "type": "string", "description": "Optional. The version of Python to use. Supported versions include 3.10, 3.11, 3.12, 3.13, 3.14. If not specified, default value is 3.10." }, "requirementsFile": { "description": "Optional. The path to the requirements file, relative to the source root. If not specified, defaults to \"requirements.txt\".", "type": "string" }, "entrypointObject": { "description": "Optional. The name of the callable object within the `entrypoint_module` to use as the application If not specified, defaults to \"root_agent\". This field should not be set if the source is `agent_config_source`.", "type": "string" }, "entrypointModule": { "description": "Optional. The Python module to load as the entrypoint, specified as a fully qualified module name. For example: path.to.agent. If not specified, defaults to \"agent\". The project root will be added to Python sys.path, allowing imports to be specified relative to the root. This field should not be set if the source is `agent_config_source`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1PostStartupScriptConfig": { "id": "GoogleCloudAiplatformV1beta1PostStartupScriptConfig", "description": "Post startup script config.", "properties": { "postStartupScript": { "description": "Optional. Post startup script to run after runtime is started.", "type": "string" }, "postStartupScriptUrl": { "description": "Optional. Post startup script url to download. Example: `gs://bucket/script.sh`", "type": "string" }, "postStartupScriptBehavior": { "description": "Optional. Post startup script behavior that defines download and execution behavior.", "type": "string", "enumDescriptions": [ "Unspecified post startup script behavior.", "Run post startup script after runtime is started.", "Run post startup script after runtime is stopped.", "Download and run post startup script every time runtime is started." ], "enum": [ "POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED", "RUN_ONCE", "RUN_EVERY_START", "DOWNLOAD_AND_RUN_EVERY_START" ] } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateAccessTokenResponse": { "type": "object", "description": "Response message for NotebookInternalService.GenerateToken.", "properties": { "scope": { "description": "Space-separated list of scopes contained in the returned token. https://cloud.google.com/docs/authentication/token-types#access-contents", "type": "string" }, "accessToken": { "description": "Short-lived access token string which may be used to access Google APIs.", "type": "string" }, "expiresIn": { "description": "The time in seconds when the access token expires. Typically that's 3600.", "format": "int32", "type": "integer" }, "tokenType": { "description": "Type of the returned access token (e.g. \"Bearer\"). It specifies how the token must be used. Bearer tokens may be used by any entity without proof of identity.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1GenerateAccessTokenResponse" }, "GoogleCloudAiplatformV1beta1ExportModelOperationMetadata": { "type": "object", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "outputInfo": { "description": "Output only. Information further describing the output of this Model export.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ExportModelOperationMetadataOutputInfo" } }, "description": "Details of ModelService.ExportModel operation.", "id": "GoogleCloudAiplatformV1beta1ExportModelOperationMetadata" }, "GoogleCloudAiplatformV1beta1PscInterfaceConfig": { "properties": { "networkAttachment": { "type": "string", "description": "Optional. The name of the Compute Engine [network attachment](https://cloud.google.com/vpc/docs/about-network-attachments) to attach to the resource within the region and user project. To specify this field, you must have already [created a network attachment] (https://cloud.google.com/vpc/docs/create-manage-network-attachments#create-network-attachments). This field is only used for resources using PSC-I." }, "dnsPeeringConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DnsPeeringConfig" }, "description": "Optional. DNS peering configurations. When specified, Vertex AI will attempt to configure DNS peering zones in the tenant project VPC to resolve the specified domains using the target network's Cloud DNS. The user must grant the dns.peer role to the Vertex AI Service Agent on the target project.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1PscInterfaceConfig", "type": "object", "description": "Configuration for PSC-I." }, "GoogleCloudAiplatformV1beta1CreateDatasetVersionOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateDatasetVersionOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Runtime operation information for DatasetService.CreateDatasetVersion." }, "GoogleCloudAiplatformV1beta1MemoryProfile": { "description": "A memory profile.", "id": "GoogleCloudAiplatformV1beta1MemoryProfile", "type": "object", "properties": { "schemaId": { "type": "string", "description": "Represents the ID of the schema. This ID corresponds to the `schema_id` defined inside the SchemaConfig, under StructuredMemoryCustomizationConfig." }, "profile": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Represents the profile data.", "type": "object" } } }, "GoogleCloudAiplatformV1beta1NotebookRuntime": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookRuntime", "properties": { "name": { "type": "string", "description": "Output only. The resource name of the NotebookRuntime.", "readOnly": true }, "version": { "description": "Output only. The VM os image version of NotebookRuntime.", "readOnly": true, "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata to organize your NotebookRuntime. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one NotebookRuntime (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable. Following system labels exist for NotebookRuntime: * \"aiplatform.googleapis.com/notebook_runtime_gce_instance_id\": output only, its value is the Compute Engine instance id. * \"aiplatform.googleapis.com/colab_enterprise_entry_service\": its value is either \"bigquery\" or \"vertex\"; if absent, it should be \"vertex\". This is to describe the entry service, either BigQuery or Vertex.", "type": "object" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this NotebookRuntime was most recently updated." }, "proxyUri": { "type": "string", "readOnly": true, "description": "Output only. The proxy endpoint used to access the NotebookRuntime." }, "notebookRuntimeType": { "enum": [ "NOTEBOOK_RUNTIME_TYPE_UNSPECIFIED", "USER_DEFINED", "ONE_CLICK" ], "type": "string", "description": "Output only. The type of the notebook runtime.", "readOnly": true, "enumDescriptions": [ "Unspecified notebook runtime type, NotebookRuntimeType will default to USER_DEFINED.", "runtime or template with coustomized configurations from user.", "runtime or template with system defined configurations." ] }, "satisfiesPzs": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "runtimeUser": { "description": "Required. The user email of the NotebookRuntime.", "type": "string" }, "description": { "type": "string", "description": "The description of the NotebookRuntime." }, "encryptionSpec": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Output only. Customer-managed encryption key spec for the notebook runtime." }, "networkSpec": { "description": "Output only. Network spec of the notebook runtime.", "$ref": "GoogleCloudAiplatformV1beta1NetworkSpec", "readOnly": true }, "networkTags": { "type": "array", "description": "Optional. The Compute Engine tags to add to runtime (see [Tagging instances](https://cloud.google.com/vpc/docs/add-remove-network-tags)).", "items": { "type": "string" } }, "idleShutdownConfig": { "$ref": "GoogleCloudAiplatformV1beta1NotebookIdleShutdownConfig", "readOnly": true, "description": "Output only. The idle shutdown configuration of the notebook runtime." }, "healthState": { "enum": [ "HEALTH_STATE_UNSPECIFIED", "HEALTHY", "UNHEALTHY" ], "readOnly": true, "type": "string", "enumDescriptions": [ "Unspecified health state.", "NotebookRuntime is in healthy state. Applies to ACTIVE state.", "NotebookRuntime is in unhealthy state. Applies to ACTIVE state." ], "description": "Output only. The health state of the NotebookRuntime." }, "runtimeState": { "description": "Output only. The runtime (instance) state of the NotebookRuntime.", "enumDescriptions": [ "Unspecified runtime state.", "NotebookRuntime is in running state.", "NotebookRuntime is in starting state. This is when the runtime is being started from a stopped state.", "NotebookRuntime is in stopping state.", "NotebookRuntime is in stopped state.", "NotebookRuntime is in upgrading state. It is in the middle of upgrading process.", "NotebookRuntime was unable to start/stop properly.", "NotebookRuntime is in invalid state. Cannot be recovered." ], "enum": [ "RUNTIME_STATE_UNSPECIFIED", "RUNNING", "BEING_STARTED", "BEING_STOPPED", "STOPPED", "BEING_UPGRADED", "ERROR", "INVALID" ], "type": "string", "readOnly": true }, "serviceAccount": { "description": "Output only. Deprecated: This field is no longer used and the \"Vertex AI Notebook Service Account\" (service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com) is used for the runtime workload identity. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-notebook-service-account for more details. The service account that the NotebookRuntime workload runs as.", "readOnly": true, "type": "string" }, "satisfiesPzi": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "displayName": { "description": "Required. The display name of the NotebookRuntime. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "dataPersistentDiskSpec": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1PersistentDiskSpec", "description": "Output only. The specification of persistent disk attached to the notebook runtime as data disk storage." }, "notebookRuntimeTemplateRef": { "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplateRef", "description": "Output only. The pointer to NotebookRuntimeTemplate this NotebookRuntime is created from.", "readOnly": true }, "shieldedVmConfig": { "$ref": "GoogleCloudAiplatformV1beta1ShieldedVmConfig", "description": "Output only. Runtime Shielded VM spec.", "readOnly": true }, "isUpgradable": { "type": "boolean", "description": "Output only. Whether NotebookRuntime is upgradable.", "readOnly": true }, "machineSpec": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1MachineSpec", "description": "Output only. The specification of a single machine used by the notebook runtime." }, "reservationAffinity": { "readOnly": true, "description": "Output only. Reservation Affinity of the notebook runtime.", "$ref": "GoogleCloudAiplatformV1beta1NotebookReservationAffinity" }, "softwareConfig": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1NotebookSoftwareConfig", "description": "Output only. Software config of the notebook runtime." }, "eucConfig": { "description": "Output only. EUC configuration of the notebook runtime.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1NotebookEucConfig" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. Timestamp when this NotebookRuntime was created.", "format": "google-datetime" }, "expirationTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this NotebookRuntime will be expired: 1. System Predefined NotebookRuntime: 24 hours after creation. After expiration, system predifined runtime will be deleted. 2. User created NotebookRuntime: 6 months after last upgrade. After expiration, user created runtime will be stopped and allowed for upgrade." } }, "description": "A runtime is a virtual machine allocated to a particular user for a particular Notebook file on temporary basis with lifetime. Default runtimes have a lifetime of 18 hours, while custom runtimes last for 6 months from their creation or last upgrade." }, "GoogleCloudAiplatformV1beta1CompactionConfig": { "properties": { "summarization": { "description": "Optional. LLM summarization compaction configuration. Set to enable summarization-based compaction. Can be combined with `event_editing`.", "$ref": "GoogleCloudAiplatformV1beta1CompactionConfigLlmSummarizationConfig" }, "eventEditing": { "$ref": "GoogleCloudAiplatformV1beta1CompactionConfigEventEditingConfig", "description": "Optional. Event-history editing compaction configuration. Set to enable deterministic event editing (e.g. masking oversized tool responses). Can be combined with `summarization`." } }, "description": "Configuration for session compaction. Compaction has two independent categories that may be enabled individually or together. When both are enabled they run as a stackable pipeline (deterministic event editing first, then summarization if the session is still above the target). At least one category must be enabled; a config with neither is rejected (enforced server-side). This message is standalone so it can be reused across surfaces (e.g. on the compact request today, and on session creation for a future reactive trigger).", "type": "object", "id": "GoogleCloudAiplatformV1beta1CompactionConfig" }, "GoogleCloudAiplatformV1beta1AddContextChildrenRequest": { "properties": { "childContexts": { "items": { "type": "string" }, "type": "array", "description": "The resource names of the child Contexts." } }, "id": "GoogleCloudAiplatformV1beta1AddContextChildrenRequest", "description": "Request message for MetadataService.AddContextChildren.", "type": "object" }, "GenaiVertexV1beta1ResponseFormatList": { "id": "GenaiVertexV1beta1ResponseFormatList", "properties": { "responseFormats": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1ResponseFormat" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PurgeArtifactsRequest": { "id": "GoogleCloudAiplatformV1beta1PurgeArtifactsRequest", "type": "object", "properties": { "filter": { "type": "string", "description": "Required. A required filter matching the Artifacts to be purged. E.g., `update_time \u003c= 2020-11-19T11:30:00-04:00`." }, "force": { "description": "Optional. Flag to indicate to actually perform the purge. If `force` is set to false, the method will return a sample of Artifact names that would be deleted.", "type": "boolean" } }, "description": "Request message for MetadataService.PurgeArtifacts." }, "GoogleCloudAiplatformV1beta1CustomJobSpec": { "description": "Represents the spec of a CustomJob.", "id": "GoogleCloudAiplatformV1beta1CustomJobSpec", "properties": { "pscInterfaceConfig": { "$ref": "GoogleCloudAiplatformV1beta1PscInterfaceConfig", "description": "Optional. Configuration for PSC-I for CustomJob." }, "protectedArtifactLocationId": { "type": "string", "description": "The ID of the location to store protected artifacts. e.g. us-central1. Populate only when the location is different than CustomJob location. List of supported locations: https://cloud.google.com/vertex-ai/docs/general/locations" }, "experimentRun": { "description": "Optional. The Experiment Run associated with this job. Format: `projects/{project}/locations/{location}/metadataStores/{metadataStores}/contexts/{experiment-name}-{experiment-run-name}`", "type": "string" }, "network": { "description": "Optional. The full name of the Compute Engine [network](/compute/docs/networks-and-firewalls#networks) to which the Job should be peered. For example, `projects/12345/global/networks/myVPC`. [Format](/compute/docs/reference/rest/v1/networks/insert) is of the form `projects/{project}/global/networks/{network}`. Where {project} is a project number, as in `12345`, and {network} is a network name. To specify this field, you must have already [configured VPC Network Peering for Vertex AI](https://cloud.google.com/vertex-ai/docs/general/vpc-peering). If this field is left unspecified, the job is not peered with any network.", "type": "string" }, "reservedIpRanges": { "type": "array", "description": "Optional. A list of names for the reserved ip ranges under the VPC network that can be used for this job. If set, we will deploy the job within the provided ip ranges. Otherwise, the job will be deployed to any ip ranges under the provided VPC network. Example: ['vertex-ai-ip-range'].", "items": { "type": "string" } }, "baseOutputDirectory": { "description": "The Cloud Storage location to store the output of this CustomJob or HyperparameterTuningJob. For HyperparameterTuningJob, the baseOutputDirectory of each child CustomJob backing a Trial is set to a subdirectory of name id under its parent HyperparameterTuningJob's baseOutputDirectory. The following Vertex AI environment variables will be passed to containers or python modules when this field is set: For CustomJob: * AIP_MODEL_DIR = `/model/` * AIP_CHECKPOINT_DIR = `/checkpoints/` * AIP_TENSORBOARD_LOG_DIR = `/logs/` For CustomJob backing a Trial of HyperparameterTuningJob: * AIP_MODEL_DIR = `//model/` * AIP_CHECKPOINT_DIR = `//checkpoints/` * AIP_TENSORBOARD_LOG_DIR = `//logs/`", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "models": { "type": "array", "items": { "type": "string" }, "description": "Optional. The name of the Model resources for which to generate a mapping to artifact URIs. Applicable only to some of the Google-provided custom jobs. Format: `projects/{project}/locations/{location}/models/{model}` In order to retrieve a specific version of the model, also provide the version ID or version alias. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` If no version ID or alias is specified, the \"default\" version will be returned. The \"default\" version alias is created for the first version of the model, and can be moved to other versions later on. There will be exactly one default version." }, "workerPoolSpecs": { "description": "Required. The spec of the worker pools including machine type and Docker image. All worker pools except the first one are optional and can be skipped by providing an empty value.", "items": { "$ref": "GoogleCloudAiplatformV1beta1WorkerPoolSpec" }, "type": "array" }, "enableWebAccess": { "type": "boolean", "description": "Optional. Whether you want Vertex AI to enable [interactive shell access](https://cloud.google.com/vertex-ai/docs/training/monitor-debug-interactive-shell) to training containers. If set to `true`, you can access interactive shells at the URIs given by CustomJob.web_access_uris or Trial.web_access_uris (within HyperparameterTuningJob.trials)." }, "serviceAccount": { "description": "Specifies the service account for workload run-as account. Users submitting jobs must have act-as permission on this run-as account. If unspecified, the [Vertex AI Custom Code Service Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) for the CustomJob's project is used.", "type": "string" }, "tensorboard": { "description": "Optional. The name of a Vertex AI Tensorboard resource to which this CustomJob will upload Tensorboard logs. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}`", "type": "string" }, "scheduling": { "description": "Scheduling options for a CustomJob.", "$ref": "GoogleCloudAiplatformV1beta1Scheduling" }, "persistentResourceId": { "description": "Optional. The ID of the PersistentResource in the same Project and Location which to run If this is specified, the job will be run on existing machines held by the PersistentResource instead of on-demand short-live machines. The network and CMEK configs on the job should be consistent with those on the PersistentResource, otherwise, the job will be rejected.", "type": "string" }, "enableDashboardAccess": { "description": "Optional. Whether you want Vertex AI to enable access to the customized dashboard in training chief container. If set to `true`, you can access the dashboard at the URIs given by CustomJob.web_access_uris or Trial.web_access_uris (within HyperparameterTuningJob.trials).", "type": "boolean" }, "experiment": { "description": "Optional. The Experiment associated with this job. Format: `projects/{project}/locations/{location}/metadataStores/{metadataStores}/contexts/{experiment-name}`", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsResponse": { "description": "Response message for A2ATaskRecordService.AppendA2ATaskRecordEvents.", "properties": { "generation": { "type": "string", "format": "int64", "description": "Task generation matching the last event" } }, "id": "GoogleCloudAiplatformV1beta1AppendA2ATaskRecordEventsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1CopyModelResponse": { "id": "GoogleCloudAiplatformV1beta1CopyModelResponse", "properties": { "modelVersionId": { "description": "Output only. The version ID of the model that is copied.", "type": "string", "readOnly": true }, "model": { "description": "The name of the copied Model resource. Format: `projects/{project}/locations/{location}/models/{model}`", "type": "string" } }, "type": "object", "description": "Response message of ModelService.CopyModel operation." }, "GoogleCloudAiplatformV1beta1MigrateResourceResponse": { "properties": { "model": { "type": "string", "description": "Migrated Model's resource name." }, "migratableResource": { "$ref": "GoogleCloudAiplatformV1beta1MigratableResource", "description": "Before migration, the identifier in ml.googleapis.com, automl.googleapis.com or datalabeling.googleapis.com." }, "dataset": { "type": "string", "description": "Migrated Dataset's resource name." } }, "description": "Describes a successfully migrated resource.", "type": "object", "id": "GoogleCloudAiplatformV1beta1MigrateResourceResponse" }, "GoogleCloudAiplatformV1beta1SkillRevision": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SkillRevision", "properties": { "createTime": { "description": "Output only. Timestamp when this Skill Revision was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "name": { "description": "Identifier. The resource name of the Skill Revision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`", "type": "string" }, "skill": { "$ref": "GoogleCloudAiplatformV1beta1Skill", "description": "Output only. The state of the Skill at this revision.", "readOnly": true }, "state": { "readOnly": true, "enumDescriptions": [ "The state of the Skill Revision is unspecified.", "The Skill Revision is active.", "The Skill Revision is being created.", "The Skill Revision was created, but failed to process.", "The Skill Revision is being deleted." ], "description": "Output only. The state of the Skill Revision.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "FAILED", "DELETING" ], "type": "string" } }, "description": "A revision of a Skill." }, "GoogleCloudAiplatformV1beta1ClearTrainingDataRequest": { "type": "object", "description": "Request message for AgentAnomalyDetectionService.ClearTrainingData.", "id": "GoogleCloudAiplatformV1beta1ClearTrainingDataRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1A2aTaskMetadataChange": { "type": "object", "description": "An event payload describing a change to the task-level metadata.", "properties": { "metadata": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object", "description": "Required. The complete task metadata after the change." }, "updateMask": { "format": "google-fieldmask", "description": "Optional. A field mask indicating which metadata paths changed. If unset, all fields are updated.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1A2aTaskMetadataChange" }, "GoogleCloudAiplatformV1beta1ListEvaluationItemsResponse": { "id": "GoogleCloudAiplatformV1beta1ListEvaluationItemsResponse", "type": "object", "properties": { "evaluationItems": { "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationItem" }, "type": "array", "description": "List of EvaluationItems in the requested page." }, "nextPageToken": { "description": "A token to retrieve the next page of results.", "type": "string" } }, "description": "Response message for EvaluationManagementService.ListEvaluationItems." }, "GoogleCloudAiplatformV1beta1RagContexts": { "properties": { "contexts": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RagContextsContext" }, "description": "All its contexts." } }, "description": "Relevant contexts for one query.", "id": "GoogleCloudAiplatformV1beta1RagContexts", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluatedAnnotation": { "description": "True positive, false positive, or false negative. EvaluatedAnnotation is only available under ModelEvaluationSlice with slice of `annotationSpec` dimension.", "type": "object", "properties": { "explanations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluatedAnnotationExplanation" }, "description": "Explanations of predictions. Each element of the explanations indicates the explanation for one explanation Method. The attributions list in the EvaluatedAnnotationExplanation.explanation object corresponds to the predictions list. For example, the second element in the attributions list explains the second element in the predictions list." }, "dataItemPayload": { "readOnly": true, "description": "Output only. The data item payload that the Model predicted this EvaluatedAnnotation on.", "type": "any" }, "errorAnalysisAnnotations": { "type": "array", "description": "Annotations of model error analysis results.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ErrorAnalysisAnnotation" } }, "evaluatedDataItemViewId": { "description": "Output only. ID of the EvaluatedDataItemView under the same ancestor ModelEvaluation. The EvaluatedDataItemView consists of all ground truths and predictions on data_item_payload.", "readOnly": true, "type": "string" }, "type": { "description": "Output only. Type of the EvaluatedAnnotation.", "readOnly": true, "type": "string", "enumDescriptions": [ "Invalid value.", "The EvaluatedAnnotation is a true positive. It has a prediction created by the Model and a ground truth Annotation which the prediction matches.", "The EvaluatedAnnotation is false positive. It has a prediction created by the Model which does not match any ground truth annotation.", "The EvaluatedAnnotation is false negative. It has a ground truth annotation which is not matched by any of the model created predictions." ], "enum": [ "EVALUATED_ANNOTATION_TYPE_UNSPECIFIED", "TRUE_POSITIVE", "FALSE_POSITIVE", "FALSE_NEGATIVE" ] }, "groundTruths": { "type": "array", "items": { "type": "any" }, "readOnly": true, "description": "Output only. The ground truth Annotations, i.e. the Annotations that exist in the test data the Model is evaluated on. For true positive, there is one and only one ground truth annotation, which matches the only prediction in predictions. For false positive, there are zero or more ground truth annotations that are similar to the only prediction in predictions, but not enough for a match. For false negative, there is one and only one ground truth annotation, which doesn't match any predictions created by the model. The schema of the ground truth is stored in ModelEvaluation.annotation_schema_uri" }, "predictions": { "items": { "type": "any" }, "readOnly": true, "type": "array", "description": "Output only. The model predicted annotations. For true positive, there is one and only one prediction, which matches the only one ground truth annotation in ground_truths. For false positive, there is one and only one prediction, which doesn't match any ground truth annotation of the corresponding data_item_view_id. For false negative, there are zero or more predictions which are similar to the only ground truth annotation in ground_truths but not enough for a match. The schema of the prediction is stored in ModelEvaluation.annotation_schema_uri" } }, "id": "GoogleCloudAiplatformV1beta1EvaluatedAnnotation" }, "GoogleCloudAiplatformV1beta1ExamplesRestrictionsNamespace": { "id": "GoogleCloudAiplatformV1beta1ExamplesRestrictionsNamespace", "type": "object", "properties": { "allow": { "type": "array", "items": { "type": "string" }, "description": "The list of allowed tags." }, "deny": { "items": { "type": "string" }, "type": "array", "description": "The list of deny tags." }, "namespaceName": { "description": "The namespace name.", "type": "string" } }, "description": "Restrictions namespace for example-based explanations overrides." }, "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityResult": { "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityResult", "properties": { "confidence": { "description": "Output only. Confidence for question answering quality score.", "readOnly": true, "type": "number", "format": "float" }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for question answering quality score." }, "score": { "type": "number", "description": "Output only. Question Answering Quality score.", "format": "float", "readOnly": true } }, "type": "object", "description": "Spec for question answering quality result." }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplatePersistentDiskConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplatePersistentDiskConfig", "properties": { "sizeGb": { "description": "Optional. The size of the persistent disk in GB. Must be non-negative. When `enabled` is `true`, a positive value is required; when unset or zero while enabled, the service applies a default size. Ignored when `enabled` is `false`.", "format": "int64", "type": "string" }, "enabled": { "description": "Optional. Whether a persistent disk is attached to sandboxes created from this template. Defaults to `false`. This flag lets a template carry (and preserve) disk configuration while keeping the disk detached, so it can be toggled on later without re-specifying the rest of the config. When `false`, the remaining fields in this message are ignored.", "type": "boolean" }, "mountPath": { "type": "string", "description": "Optional. The absolute path inside the sandbox container at which the persistent disk is mounted. Defaults to `/workspace` when unset. Ignored when `enabled` is `false`. Only writes beneath this path land on the disk. Writes elsewhere go to the container's writable layer, which counts against the container's ephemeral storage and is lost when the sandbox's runtime is torn down, so this should be the directory the workload actually writes to. Paths that would shadow the container's system directories (for example `/etc`, `/proc`, or `/usr` itself) are rejected." } }, "description": "Configuration for attaching a persistent disk (PD) to each SandboxEnvironment created from this template. A persistent disk provides durable, per-sandbox block storage whose contents survive across the sandbox lifecycle events that this service supports (e.g. pause/resume), unlike ephemeral local storage which is lost when the underlying runtime is torn down." }, "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceResult": { "description": "Spec for question answering relevance result.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceResult", "properties": { "score": { "description": "Output only. Question Answering Relevance score.", "format": "float", "type": "number", "readOnly": true }, "explanation": { "description": "Output only. Explanation for question answering relevance score.", "type": "string", "readOnly": true }, "confidence": { "description": "Output only. Confidence for question answering relevance score.", "format": "float", "type": "number", "readOnly": true } }, "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleGeneratedMemory": { "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleGeneratedMemory", "type": "object", "description": "A memory generated by the operation.", "properties": { "topics": { "description": "Optional. Represents the list of topics that the memory should be associated with. For example, use `custom_memory_topic_label = \"jargon\"` if the extracted memory is an example of memory extraction for the custom topic `jargon`.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryTopicId" } }, "fact": { "type": "string", "description": "Required. Represents the fact to generate a memory from." } } }, "GenaiVertexV1beta1AudioContent": { "properties": { "uri": { "description": "The URI of the audio.", "type": "string" }, "data": { "format": "byte", "type": "string", "description": "The audio content." }, "channels": { "format": "int32", "type": "integer", "description": "The number of audio channels." }, "sampleRate": { "type": "integer", "description": "The sample rate of the audio.", "format": "int32" }, "mimeTypeString": { "type": "string", "description": "Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key." } }, "type": "object", "description": "An audio content block. ", "id": "GenaiVertexV1beta1AudioContent" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningCodeExecutionRewardScorer": { "description": "ReinforcementTuningCodeExecutionRewardScorer allows users to implement a function to evaluate rewards for the sample response. The function signature is as follows: ``` def evaluate(example: dict[str, Any], response: dict[str, Any]) -\u003e float: ... ``` `example` is a ReinforcementTuningExample in ProtoJSON format, (i.e., the format is the same as as one line in the training/validation dataset except that the keys must be in camel case). System instructions (i.e., `example.get(\"systemInstruction\")`) and references (i.e., `example.get(\"references\")`) are also included in the `example` provided that they are set in the training/validation dataset. `response` is a Content in ProtoJSON format (i.e., keys must be in camel case), which is the same as the Online Prediction response for Gemini models. Note: Reward output by the `evaluate` function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningCodeExecutionRewardScorer", "properties": { "pythonCodeSnippet": { "description": "The python code snippet as a string for evaluating rewards. The following is an example python code snippet that returns a reward `1.0` for a parsed response matching the user-provided reference answer in per prompt references map. ``` def evaluate(example, response) -\u003e float: response_str = response.get(\"parts\", [])0 references = example.get(\"references\", {}) if response_str == references.get(\"concise_answer\"): return 1.0 return -1.0 ``` Note: Reward output by the evaluate function is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputBatchPredictionOutput": { "description": "Data from Vertex AI Batch prediction job output.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputBatchPredictionOutput", "type": "object", "properties": { "batchPredictionJob": { "description": "Vertex AI Batch prediction job resource name. The job must match the model version specified in [ModelMonitor].[model_monitoring_target].", "type": "string" } } }, "GoogleCloudAiplatformV1beta1DeployModelOperationMetadata": { "description": "Runtime operation information for EndpointService.DeployModel.", "type": "object", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "deploymentStage": { "description": "Output only. The deployment stage of the model.", "enum": [ "DEPLOYMENT_STAGE_UNSPECIFIED", "STARTING_DEPLOYMENT", "PREPARING_MODEL", "CREATING_SERVING_CLUSTER", "ADDING_NODES_TO_CLUSTER", "GETTING_CONTAINER_IMAGE", "STARTING_MODEL_SERVER", "FINISHING_UP", "DEPLOYMENT_TERMINATED", "SUCCESSFULLY_DEPLOYED", "FAILED_TO_DEPLOY" ], "enumDescriptions": [ "Default value. This value is unused.", "The deployment is initializing and setting up the environment.", "The deployment is preparing the model assets.", "The deployment is creating the underlying serving cluster.", "The deployment is adding nodes to the serving cluster.", "The deployment is getting the container image for the model server.", "The deployment is starting the model server.", "The deployment is performing finalization steps.", "The deployment has terminated.", "The deployment has succeeded.", "The deployment has failed." ], "readOnly": true, "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1DeployModelOperationMetadata" }, "GoogleCloudAiplatformV1beta1Explanation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1Explanation", "description": "Explanation of a prediction (provided in PredictResponse.predictions) produced by the Model on a given instance.", "properties": { "neighbors": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Neighbor" }, "type": "array", "description": "Output only. List of the nearest neighbors for example-based explanations. For models deployed with the examples explanations feature enabled, the attributions field is empty and instead the neighbors field is populated.", "readOnly": true }, "attributions": { "readOnly": true, "description": "Output only. Feature attributions grouped by predicted outputs. For Models that predict only one output, such as regression Models that predict only one score, there is only one attibution that explains the predicted output. For Models that predict multiple outputs, such as multiclass Models that predict multiple classes, each element explains one specific item. Attribution.output_index can be used to identify which output this attribution is explaining. By default, we provide Shapley values for the predicted class. However, you can configure the explanation request to generate Shapley values for any other classes too. For example, if a model predicts a probability of `0.4` for approving a loan application, the model's decision is to reject the application since `p(reject) = 0.6 \u003e p(approve) = 0.4`, and the default Shapley values would be computed for rejection decision and not approval, even though the latter might be the positive class. If users set ExplanationParameters.top_k, the attributions are sorted by instance_output_value in descending order. If ExplanationParameters.output_indices is specified, the attributions are stored by Attribution.output_index in the same order as they appear in the output_indices.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Attribution" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse": { "type": "object", "description": "Response message for MemoryBankService.RetrieveMemories.", "properties": { "nextPageToken": { "type": "string", "description": "A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. This token is not set if similarity search was used for retrieval." }, "retrievedMemories": { "items": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponseRetrievedMemory" }, "description": "The retrieved memories.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1RetrieveMemoriesResponse" }, "GoogleCloudAiplatformV1beta1NasJob": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NasJob", "properties": { "endTime": { "description": "Output only. Time when the NasJob entered any of the following states: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`.", "type": "string", "readOnly": true, "format": "google-datetime" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "name": { "description": "Output only. Resource name of the NasJob.", "readOnly": true, "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the NasJob. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "nasJobOutput": { "readOnly": true, "description": "Output only. Output of the NasJob.", "$ref": "GoogleCloudAiplatformV1beta1NasJobOutput" }, "labels": { "description": "The labels with user-defined metadata to organize NasJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "additionalProperties": { "type": "string" }, "type": "object" }, "enableRestrictedImageTraining": { "deprecated": true, "description": "Optional. Enable a separation of Custom model training and restricted image training for tenant project.", "type": "boolean" }, "createTime": { "description": "Output only. Time when the NasJob was created.", "type": "string", "readOnly": true, "format": "google-datetime" }, "satisfiesPzi": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "error": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. Only populated when job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED." }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Time when the NasJob was most recently updated." }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key options for a NasJob. If this is set, then all resources created by the NasJob will be encrypted with the provided encryption key." }, "nasJobSpec": { "description": "Required. The specification of a NasJob.", "$ref": "GoogleCloudAiplatformV1beta1NasJobSpec" }, "startTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Time when the NasJob for the first time entered the `JOB_STATE_RUNNING` state." }, "state": { "type": "string", "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ], "readOnly": true, "description": "Output only. The detailed state of the job." } }, "description": "Represents a Neural Architecture Search (NAS) job." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetrics": { "description": "The Evaluation metrics given a specific precision_window_length.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetrics", "properties": { "meanAveragePrecision": { "type": "number", "format": "float", "description": "The mean average precision." }, "precisionWindowLength": { "format": "google-duration", "type": "string", "description": "This VideoActionMetrics is calculated based on this prediction window length. If the predicted action's timestamp is inside the time window whose center is the ground truth action's timestamp with this specific length, the prediction result is treated as a true positive." }, "confidenceMetrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsVideoActionMetricsConfidenceMetrics" }, "type": "array", "description": "Metrics for each label-match confidence_threshold from 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryRecallMetricValue": { "description": "TrajectoryRecall metric value for an instance.", "properties": { "score": { "format": "float", "readOnly": true, "type": "number", "description": "Output only. TrajectoryRecall score." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryRecallMetricValue" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationInputs": { "properties": { "baseModelId": { "description": "The ID of the `base` model. If it is specified, the new model will be trained based on the `base` model. Otherwise, the new model will be trained from scratch. The `base` model must be in the same Project and Location as the new Model to train, and have the same modelType.", "type": "string" }, "modelType": { "type": "string", "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD_HIGH_ACCURACY_1", "CLOUD_LOW_ACCURACY_1", "MOBILE_TF_LOW_LATENCY_1" ], "enumDescriptions": [ "Should not be set.", "A model to be used via prediction calls to uCAIP API. Expected to have a higher latency, but should also have a higher prediction quality than other models.", "A model to be used via prediction calls to uCAIP API. Expected to have a lower latency but relatively lower prediction quality.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as TensorFlow model and used on a mobile or edge device afterwards. Expected to have low latency, but may have lower prediction quality than other mobile models." ] }, "budgetMilliNodeHours": { "format": "int64", "type": "string", "description": "The training budget of creating this model, expressed in milli node hours i.e. 1,000 value in this field means 1 node hour. The actual metadata.costMilliNodeHours will be equal or less than this value. If further model training ceases to provide any improvements, it will stop without using the full budget and the metadata.successfulStopReason will be `model-converged`. Note, node_hour = actual_hour * number_of_nodes_involved. Or actual_wall_clock_hours = train_budget_milli_node_hours / (number_of_nodes_involved * 1000) For modelType `cloud-high-accuracy-1`(default), the budget must be between 20,000 and 2,000,000 milli node hours, inclusive. The default value is 192,000 which represents one day in wall time (1000 milli * 24 hours * 8 nodes)." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageSegmentationInputs", "type": "object" }, "GoogleCloudAiplatformV1beta1ToolParameterKVMatchResults": { "id": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchResults", "type": "object", "properties": { "toolParameterKvMatchMetricValues": { "readOnly": true, "description": "Output only. Tool parameter key value match metric values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchMetricValue" }, "type": "array" } }, "description": "Results for tool parameter key value match metric." }, "GoogleCloudAiplatformV1beta1PauseModelDeploymentMonitoringJobRequest": { "description": "Request message for JobService.PauseModelDeploymentMonitoringJob.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PauseModelDeploymentMonitoringJobRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1ThresholdConfig": { "description": "The config for feature monitoring threshold.", "properties": { "value": { "format": "double", "description": "Specify a threshold value that can trigger the alert. If this threshold config is for feature distribution distance: 1. For categorical feature, the distribution distance is calculated by L-inifinity norm. 2. For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence. Each feature must have a non-zero threshold if they need to be monitored. Otherwise no alert will be triggered for that feature.", "type": "number" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ThresholdConfig" }, "GoogleCloudAiplatformV1beta1BoolArray": { "description": "A list of boolean values.", "id": "GoogleCloudAiplatformV1beta1BoolArray", "properties": { "values": { "description": "A list of bool values.", "type": "array", "items": { "type": "boolean" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AuthConfigOidcConfig": { "id": "GoogleCloudAiplatformV1beta1AuthConfigOidcConfig", "type": "object", "properties": { "idToken": { "type": "string", "description": "OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time." }, "serviceAccount": { "type": "string", "description": "The service account used to generate an OpenID Connect (OIDC)-compatible JWT token signed by the Google OIDC Provider (accounts.google.com) for extension endpoint (https://cloud.google.com/iam/docs/create-short-lived-credentials-direct#sa-credentials-oidc). - The audience for the token will be set to the URL in the server url defined in the OpenApi spec. - If the service account is provided, the service account should grant `iam.serviceAccounts.getOpenIdToken` permission to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents)." } }, "description": "Config for user OIDC auth." }, "GoogleCloudAiplatformV1beta1FasterDeploymentConfig": { "type": "object", "properties": { "fastTryoutEnabled": { "description": "If true, enable fast tryout feature for this deployed model.", "type": "boolean" } }, "description": "Configuration for faster model deployment.", "id": "GoogleCloudAiplatformV1beta1FasterDeploymentConfig" }, "GenaiVertexV1beta1Field": { "type": "object", "description": "Represents a single field in a struct.", "id": "GenaiVertexV1beta1Field", "properties": { "name": { "type": "string" }, "value": { "$ref": "GenaiVertexV1beta1Value" } } }, "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpec": { "type": "object", "description": "Configuration for Speculative Decoding.", "properties": { "ngramSpeculation": { "description": "N-Gram speculation.", "$ref": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecNgramSpeculation" }, "draftModelSpeculation": { "description": "draft model speculation.", "$ref": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpecDraftModelSpeculation" }, "speculativeTokenCount": { "description": "The number of speculative tokens to generate at each step.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1SpeculativeDecodingSpec" }, "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInput": { "type": "object", "description": "Instances and metric spec for TrajectoryPrecision metric.", "id": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInput", "properties": { "instances": { "type": "array", "description": "Required. Repeated TrajectoryPrecision instance.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionInstance" } }, "metricSpec": { "description": "Required. Spec for TrajectoryPrecision metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionSpec" } } }, "GoogleCloudAiplatformV1beta1FileStatus": { "properties": { "state": { "enumDescriptions": [ "RagFile state is unspecified.", "RagFile resource has been created and indexed successfully.", "RagFile resource is in a problematic state. See `error_message` field for details." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "ERROR" ], "description": "Output only. RagFile state." }, "errorStatus": { "readOnly": true, "description": "Output only. Only when the `state` field is ERROR.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1FileStatus", "type": "object", "description": "RagFile status." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageObjectDetectionEvaluationMetrics": { "description": "Metrics for image object detection evaluation results.", "type": "object", "properties": { "boundingBoxMeanAveragePrecision": { "type": "number", "description": "The single metric for bounding boxes evaluation: the `meanAveragePrecision` averaged over all `boundingBoxMetricsEntries`.", "format": "float" }, "boundingBoxMetrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsBoundingBoxMetrics" }, "description": "The bounding boxes match metrics for each intersection-over-union threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 and each label confidence threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 pair.", "type": "array" }, "evaluatedBoundingBoxCount": { "description": "The total number of bounding boxes (i.e. summed over all images) the ground truth used to create this evaluation had.", "type": "integer", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageObjectDetectionEvaluationMetrics" }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringBigQuerySource": { "description": "Dataset spec for data sotred in BigQuery.", "properties": { "query": { "description": "Standard SQL to be used instead of the `table_uri`.", "type": "string" }, "tableUri": { "description": "BigQuery URI to a table, up to 2000 characters long. All the columns in the table will be selected. Accepted forms: * BigQuery path. For example: `bq://projectId.bqDatasetId.bqTableId`.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringBigQuerySource" }, "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataRequest": { "description": "Request message for TensorboardService.WriteTensorboardExperimentData.", "properties": { "writeRunDataRequests": { "type": "array", "description": "Required. Requests containing per-run TensorboardTimeSeries data to write.", "items": { "$ref": "GoogleCloudAiplatformV1beta1WriteTensorboardRunDataRequest" } } }, "id": "GoogleCloudAiplatformV1beta1WriteTensorboardExperimentDataRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1CoherenceInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CoherenceInstance", "description": "Spec for coherence instance.", "properties": { "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1CloudLoggingConfig": { "id": "GoogleCloudAiplatformV1beta1CloudLoggingConfig", "properties": { "tracingContext": { "description": "Optional. Tracing context for the evaluation run.", "$ref": "GoogleCloudAiplatformV1beta1CloudLoggingConfigTracingContext" }, "project": { "description": "Optional. Google Cloud project to write logs to. Defaults to the request project.", "type": "string" }, "resourceType": { "description": "Optional. MonitoredResource type. Defaults to \"global\" if unspecified.", "type": "string" }, "resourceLabels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. MonitoredResource labels to associate the log with. The backend will automatically inject project and location." } }, "description": "Specifies configuration for exporting evaluation results to Cloud Logging.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataConversationTurn": { "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataConversationTurn", "properties": { "events": { "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataAgentEvent" }, "type": "array", "description": "Optional. The list of events that occurred during this turn." }, "turnIndex": { "description": "Required. The 0-based index of the turn in the conversation sequence.", "type": "integer", "format": "int32" }, "turnId": { "description": "Optional. A unique identifier for the turn. Useful for referencing specific turns across systems.", "type": "string" } }, "type": "object", "description": "Represents a single turn/invocation in the conversation." }, "GoogleCloudAiplatformV1beta1ToolConfig": { "id": "GoogleCloudAiplatformV1beta1ToolConfig", "type": "object", "description": "Tool config. This config is shared for all tools provided in the request.", "properties": { "functionCallingConfig": { "description": "Optional. Function calling config.", "$ref": "GoogleCloudAiplatformV1beta1FunctionCallingConfig" }, "retrievalConfig": { "description": "Optional. Retrieval config.", "$ref": "GoogleCloudAiplatformV1beta1RetrievalConfig" } } }, "GoogleCloudAiplatformV1beta1ExplanationParameters": { "properties": { "integratedGradientsAttribution": { "description": "An attribution method that computes Aumann-Shapley values taking advantage of the model's fully differentiable structure. Refer to this paper for more details: https://arxiv.org/abs/1703.01365", "$ref": "GoogleCloudAiplatformV1beta1IntegratedGradientsAttribution" }, "examples": { "description": "Example-based explanations that returns the nearest neighbors from the provided dataset.", "$ref": "GoogleCloudAiplatformV1beta1Examples" }, "xraiAttribution": { "$ref": "GoogleCloudAiplatformV1beta1XraiAttribution", "description": "An attribution method that redistributes Integrated Gradients attribution to segmented regions, taking advantage of the model's fully differentiable structure. Refer to this paper for more details: https://arxiv.org/abs/1906.02825 XRAI currently performs better on natural images, like a picture of a house or an animal. If the images are taken in artificial environments, like a lab or manufacturing line, or from diagnostic equipment, like x-rays or quality-control cameras, use Integrated Gradients instead." }, "outputIndices": { "type": "array", "description": "If populated, only returns attributions that have output_index contained in output_indices. It must be an ndarray of integers, with the same shape of the output it's explaining. If not populated, returns attributions for top_k indices of outputs. If neither top_k nor output_indices is populated, returns the argmax index of the outputs. Only applicable to Models that predict multiple outputs (e,g, multi-class Models that predict multiple classes).", "items": { "type": "any" } }, "topK": { "description": "If populated, returns attributions for top K indices of outputs (defaults to 1). Only applies to Models that predicts more than one outputs (e,g, multi-class Models). When set to -1, returns explanations for all outputs.", "type": "integer", "format": "int32" }, "sampledShapleyAttribution": { "description": "An attribution method that approximates Shapley values for features that contribute to the label being predicted. A sampling strategy is used to approximate the value rather than considering all subsets of features. Refer to this paper for model details: https://arxiv.org/abs/1306.4265.", "$ref": "GoogleCloudAiplatformV1beta1SampledShapleyAttribution" } }, "type": "object", "description": "Parameters to configure explaining for Model's predictions.", "id": "GoogleCloudAiplatformV1beta1ExplanationParameters" }, "GoogleCloudAiplatformV1beta1A2aTaskStatusUpdate": { "description": "An event payload that updates the task's state and optional status message.", "id": "GoogleCloudAiplatformV1beta1A2aTaskStatusUpdate", "properties": { "state": { "enumDescriptions": [ "The task is in an unknown or indeterminate state.", "Indicates that a task has been successfully submitted and acknowledged.", "Indicates that a task is actively being processed by the agent.", "Indicates that a task has finished successfully. This is a terminal state.", "Indicates that a task has finished with an error. This is a terminal state.", "Indicates that a task was canceled before completion. This is a terminal state.", "Indicates that the agent requires additional user input to proceed. This is an interrupted state.", "Indicates that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", "Indicates that authentication is required to proceed. This is an interrupted state." ], "enum": [ "STATE_UNSPECIFIED", "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ], "description": "Required. The new state of the task.", "type": "string" }, "timestamp": { "type": "string", "description": "Optional. The time at which the status change occurred.", "format": "google-datetime" }, "message": { "description": "Optional. The status message associated with the state change.", "$ref": "GoogleCloudAiplatformV1beta1A2aTaskMessage" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityOpenTelemetry": { "description": "Configuration for data source following OpenTelemetry.", "type": "object", "properties": { "semconvVersion": { "description": "Required. Defines which version OTel Semantic Convention the data follows. Can be \"1.39.0\" or newer.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityOpenTelemetry" }, "GoogleCloudAiplatformV1beta1Trajectory": { "properties": { "toolCalls": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolCall" }, "description": "Required. Tool calls in the trajectory." } }, "id": "GoogleCloudAiplatformV1beta1Trajectory", "type": "object", "description": "Spec for trajectory." }, "GoogleCloudAiplatformV1beta1CreateDatasetOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateDatasetOperationMetadata", "description": "Runtime operation information for DatasetService.CreateDataset.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime": { "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime", "description": "The default runtime for the PipelineJob.", "properties": { "persistentResourceRuntimeDetail": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigPersistentResourceRuntimeDetail", "description": "Persistent resource based runtime detail." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GoogleDriveSourceResourceId": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GoogleDriveSourceResourceId", "description": "The type and ID of the Google Drive resource.", "properties": { "resourceType": { "description": "Required. The type of the Google Drive resource.", "enumDescriptions": [ "Unspecified resource type.", "File resource type.", "Folder resource type." ], "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "RESOURCE_TYPE_FILE", "RESOURCE_TYPE_FOLDER" ], "type": "string" }, "resourceId": { "type": "string", "description": "Required. The ID of the Google Drive resource." } } }, "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequestFeatureSpec": { "properties": { "sourceField": { "description": "Source column to get the Feature values from. If not set, uses the column with the same name as the Feature ID.", "type": "string" }, "id": { "type": "string", "description": "Required. ID of the Feature to import values of. This Feature must exist in the target EntityType, or the request will fail." } }, "description": "Defines the Feature value(s) to import.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportFeatureValuesRequestFeatureSpec" }, "GoogleCloudAiplatformV1beta1PythonPackageSpec": { "type": "object", "description": "The spec of a Python packaged code.", "properties": { "pythonModule": { "type": "string", "description": "Required. The Python module name to run after installing the packages." }, "env": { "description": "Environment variables to be passed to the python module. Maximum limit is 100.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" } }, "args": { "description": "Command line arguments to be passed to the Python task.", "type": "array", "items": { "type": "string" } }, "executorImageUri": { "type": "string", "description": "Required. The URI of a container image in Artifact Registry that will run the provided Python package. Vertex AI provides a wide range of executor images with pre-installed packages to meet users' various use cases. See the list of [pre-built containers for training](https://cloud.google.com/vertex-ai/docs/training/pre-built-containers). You must use an image from this list." }, "packageUris": { "description": "Required. The Google Cloud Storage location of the Python package files which are the training program and its dependent packages. The maximum number of package URIs is 100.", "items": { "type": "string" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1PythonPackageSpec" }, "GoogleCloudAiplatformV1beta1GcsSource": { "type": "object", "properties": { "uris": { "type": "array", "description": "Required. Google Cloud Storage URI(-s) to the input file(s). May contain wildcards. For more information on wildcards, see https://cloud.google.com/storage/docs/wildcards.", "items": { "type": "string" } } }, "description": "The Google Cloud Storage location for the input content.", "id": "GoogleCloudAiplatformV1beta1GcsSource" }, "GoogleCloudAiplatformV1beta1UpsertExamplesResponseUpsertResult": { "type": "object", "id": "GoogleCloudAiplatformV1beta1UpsertExamplesResponseUpsertResult", "properties": { "example": { "description": "The example created/updated successfully.", "$ref": "GoogleCloudAiplatformV1beta1Example" }, "status": { "description": "The error message of the example that was not created/updated successfully.", "$ref": "GoogleRpcStatus" } }, "description": "The result for creating/updating a single example." }, "GoogleCloudAiplatformV1beta1ToolCall": { "description": "Spec for tool call.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolCall", "properties": { "toolInput": { "description": "Optional. Spec for tool input", "type": "string" }, "toolName": { "description": "Required. Spec for tool name", "type": "string" } } }, "GoogleCloudAiplatformV1beta1UndeployModelRequest": { "id": "GoogleCloudAiplatformV1beta1UndeployModelRequest", "type": "object", "properties": { "deployedModelId": { "description": "Required. The ID of the DeployedModel to be undeployed from the Endpoint.", "type": "string" }, "trafficSplit": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" }, "description": "If this field is provided, then the Endpoint's traffic_split will be overwritten with it. If last DeployedModel is being undeployed from the Endpoint, the [Endpoint.traffic_split] will always end up empty when this call returns. A DeployedModel will be successfully undeployed only if it doesn't have any traffic assigned to it when this method executes, or if this field unassigns any traffic to it." } }, "description": "Request message for EndpointService.UndeployModel." }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreDedicatedServingEndpoint": { "properties": { "serviceAttachment": { "description": "Output only. The name of the service attachment resource. Populated if private service connect is enabled and after FeatureViewSync is created.", "type": "string", "readOnly": true }, "privateServiceConnectConfig": { "description": "Optional. Private service connect config. The private service connection is available only for Optimized storage type, not for embedding management now. If PrivateServiceConnectConfig.enable_private_service_connect set to true, customers will use private service connection to send request. Otherwise, the connection will set to public endpoint.", "$ref": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig" }, "publicEndpointDomainName": { "description": "Output only. This field will be populated with the domain name to use for this FeatureOnlineStore", "readOnly": true, "type": "string" } }, "type": "object", "description": "The dedicated serving endpoint for this FeatureOnlineStore. Only need to set when you choose Optimized storage type. Public endpoint is provisioned by default.", "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreDedicatedServingEndpoint" }, "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringScheduleConfig": { "id": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringScheduleConfig", "description": "The config for scheduling monitoring job.", "type": "object", "properties": { "monitorWindow": { "type": "string", "format": "google-duration", "description": "The time window of the prediction data being included in each prediction dataset. This window specifies how long the data should be collected from historical model results for each run. If not set, ModelDeploymentMonitoringScheduleConfig.monitor_interval will be used. e.g. If currently the cutoff time is 2022-01-08 14:30:00 and the monitor_window is set to be 3600, then data from 2022-01-08 13:30:00 to 2022-01-08 14:30:00 will be retrieved and aggregated to calculate the monitoring statistics." }, "monitorInterval": { "description": "Required. The model monitoring job scheduling interval. It will be rounded up to next full hour. This defines how often the monitoring jobs are triggered.", "type": "string", "format": "google-duration" } } }, "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInput": { "description": "Instances and metric spec for TrajectoryExactMatch metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInput", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchSpec", "description": "Required. Spec for TrajectoryExactMatch metric." }, "instances": { "description": "Required. Repeated TrajectoryExactMatch instance.", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInstance" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1MigratableResourceAutomlModel": { "id": "GoogleCloudAiplatformV1beta1MigratableResourceAutomlModel", "properties": { "modelDisplayName": { "description": "The Model's display name in automl.googleapis.com.", "type": "string" }, "model": { "type": "string", "description": "Full resource name of automl Model. Format: `projects/{project}/locations/{location}/models/{model}`." } }, "type": "object", "description": "Represents one Model in automl.googleapis.com." }, "GoogleCloudAiplatformV1beta1DeploymentResourcePool": { "description": "A description of resources that can be shared by multiple DeployedModels, whose underlying specification consists of a DedicatedResources.", "type": "object", "properties": { "dedicatedResources": { "description": "Required. The underlying DedicatedResources that the DeploymentResourcePool uses.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this DeploymentResourcePool was created.", "type": "string" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key spec for a DeploymentResourcePool. If set, this DeploymentResourcePool will be secured by this key. Endpoints and the DeploymentResourcePool they deploy in need to have the same EncryptionSpec." }, "disableContainerLogging": { "description": "If the DeploymentResourcePool is deployed with custom-trained Models or AutoML Tabular Models, the container(s) of the DeploymentResourcePool will send `stderr` and `stdout` streams to Cloud Logging by default. Please note that the logs incur cost, which are subject to [Cloud Logging pricing](https://cloud.google.com/logging/pricing). User can disable container logging by setting this flag to true.", "type": "boolean" }, "name": { "type": "string", "description": "Immutable. The resource name of the DeploymentResourcePool. Format: `projects/{project}/locations/{location}/deploymentResourcePools/{deployment_resource_pool}`" }, "serviceAccount": { "type": "string", "description": "The service account that the DeploymentResourcePool's container(s) run as. Specify the email address of the service account. If this service account is not specified, the container(s) run as a service account that doesn't have access to the resource project. Users deploying the Models to this DeploymentResourcePool must have the `iam.serviceAccounts.actAs` permission on this service account." } }, "id": "GoogleCloudAiplatformV1beta1DeploymentResourcePool" }, "GenaiVertexV1beta1CodeExecutionCallDelta": { "type": "object", "properties": { "arguments": { "$ref": "GenaiVertexV1beta1CodeExecutionCallContentCodeExecutionCallArguments" } }, "id": "GenaiVertexV1beta1CodeExecutionCallDelta" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationAutoTransformation": { "properties": { "columnName": { "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationAutoTransformation", "type": "object", "description": "Training pipeline will infer the proper transformation based on the statistic of dataset." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTimestampTransformation": { "properties": { "columnName": { "type": "string" }, "timeFormat": { "type": "string", "description": "The format in which that time field is expressed. The time_format must either be one of: * `unix-seconds` * `unix-milliseconds` * `unix-microseconds` * `unix-nanoseconds` (for respectively number of seconds, milliseconds, microseconds and nanoseconds since start of the Unix epoch); or be written in `strftime` syntax. If time_format is not set, then the default format is RFC 3339 `date-time` format, where `time-offset` = `\"Z\"` (e.g. 1985-04-12T23:20:50.52Z)" } }, "type": "object", "description": "Training pipeline will perform following transformation functions. * Apply the transformation functions for Numerical columns. * Determine the year, month, day,and weekday. Treat each value from the timestamp as a Categorical column. * Invalid numerical values (for example, values that fall outside of a typical timestamp range, or are extreme values) receive no special treatment and are not removed.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationTimestampTransformation" }, "GoogleCloudAiplatformV1beta1EntityType": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EntityType", "description": "An entity type is a type of object in a system that needs to be modeled and have stored information about. For example, driver is an entity type, and driver0 is an instance of an entity type driver.", "properties": { "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize your EntityTypes. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one EntityType (System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "type": "object" }, "satisfiesPzi": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "etag": { "description": "Optional. Used to perform a consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "offlineStorageTtlDays": { "format": "int32", "description": "Optional. Config for data retention policy in offline storage. TTL in days for feature values that will be stored in offline storage. The Feature Store offline storage periodically removes obsolete feature values older than `offline_storage_ttl_days` since the feature generation time. If unset (or explicitly set to 0), default to 4000 days TTL.", "type": "integer" }, "createTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when this EntityType was created." }, "satisfiesPzs": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." }, "name": { "type": "string", "description": "Immutable. Name of the EntityType. Format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entity_type}` The last part entity_type is assigned by the client. The entity_type can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z and underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given a featurestore." }, "monitoringConfig": { "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfig", "description": "Optional. The default monitoring configuration for all Features with value type (Feature.ValueType) BOOL, STRING, DOUBLE or INT64 under this EntityType. If this is populated with [FeaturestoreMonitoringConfig.monitoring_interval] specified, snapshot analysis monitoring is enabled. Otherwise, snapshot analysis monitoring is disabled." }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this EntityType was most recently updated.", "readOnly": true, "format": "google-datetime" }, "description": { "type": "string", "description": "Optional. Description of the EntityType." } } }, "GoogleCloudAiplatformV1beta1ExamplesOverride": { "id": "GoogleCloudAiplatformV1beta1ExamplesOverride", "type": "object", "properties": { "dataFormat": { "type": "string", "description": "The format of the data being provided with each call.", "enum": [ "DATA_FORMAT_UNSPECIFIED", "INSTANCES", "EMBEDDINGS" ], "enumDescriptions": [ "Unspecified format. Must not be used.", "Provided data is a set of model inputs.", "Provided data is a set of embeddings." ] }, "restrictions": { "type": "array", "description": "Restrict the resulting nearest neighbors to respect these constraints.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ExamplesRestrictionsNamespace" } }, "neighborCount": { "type": "integer", "format": "int32", "description": "The number of neighbors to return." }, "returnEmbeddings": { "type": "boolean", "description": "If true, return the embeddings instead of neighbors." }, "crowdingCount": { "description": "The number of neighbors to return that have the same crowding tag.", "type": "integer", "format": "int32" } }, "description": "Overrides for example-based explanations." }, "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig": { "properties": { "modelName": { "type": "string", "description": "Required. The name of the model used for tuning." }, "datasetUsage": { "enumDescriptions": [ "Default value. Should not be used.", "Supervised fine-tuning training dataset.", "Supervised fine-tuning validation dataset." ], "enum": [ "DATASET_USAGE_UNSPECIFIED", "SFT_TRAINING", "SFT_VALIDATION" ], "description": "Required. The dataset usage (e.g. training/validation).", "type": "string" } }, "type": "object", "description": "Configuration for the tuning validation assessment.", "id": "GoogleCloudAiplatformV1beta1AssessDataRequestTuningValidationAssessmentConfig" }, "GoogleCloudAiplatformV1beta1PscAutomatedEndpoints": { "id": "GoogleCloudAiplatformV1beta1PscAutomatedEndpoints", "type": "object", "properties": { "projectId": { "type": "string", "description": "Corresponding project_id in pscAutomationConfigs" }, "matchAddress": { "type": "string", "description": "Ip Address created by the automated forwarding rule." }, "network": { "type": "string", "description": "Corresponding network in pscAutomationConfigs." } }, "description": "PscAutomatedEndpoints defines the output of the forwarding rule automatically created by each PscAutomationConfig." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextClassification": { "description": "A TrainingJob that trains and uploads an AutoML Text Classification Model.", "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextClassificationInputs", "description": "The input parameters of this TrainingJob." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextClassification" }, "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfig": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfig", "type": "object", "properties": { "scaling": { "$ref": "GoogleCloudAiplatformV1beta1FeaturestoreOnlineServingConfigScaling", "description": "Online serving scaling configuration. Only one of `fixed_node_count` and `scaling` can be set. Setting one will reset the other." }, "fixedNodeCount": { "format": "int32", "type": "integer", "description": "The number of nodes for the online store. The number of nodes doesn't scale automatically, but you can manually update the number of nodes. If set to 0, the featurestore will not have an online store and cannot be used for online serving." } }, "description": "OnlineServingConfig specifies the details for provisioning online serving resources." }, "GoogleCloudAiplatformV1beta1SpecialistPool": { "id": "GoogleCloudAiplatformV1beta1SpecialistPool", "type": "object", "description": "SpecialistPool represents customers' own workforce to work on their data labeling jobs. It includes a group of specialist managers and workers. Managers are responsible for managing the workers in this pool as well as customers' data labeling jobs associated with this pool. Customers create specialist pool as well as start data labeling jobs on Cloud, managers and workers handle the jobs using CrowdCompute console.", "properties": { "pendingDataLabelingJobs": { "description": "Output only. The resource name of the pending data labeling jobs.", "type": "array", "readOnly": true, "items": { "type": "string" } }, "specialistWorkerEmails": { "items": { "type": "string" }, "description": "The email addresses of workers in the SpecialistPool.", "type": "array" }, "displayName": { "type": "string", "description": "Required. The user-defined name of the SpecialistPool. The name can be up to 128 characters long and can consist of any UTF-8 characters. This field should be unique on project-level." }, "name": { "description": "Required. The resource name of the SpecialistPool.", "type": "string" }, "specialistManagersCount": { "readOnly": true, "description": "Output only. The number of managers in this SpecialistPool.", "format": "int32", "type": "integer" }, "specialistManagerEmails": { "description": "The email addresses of the managers in the SpecialistPool.", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudAiplatformV1beta1RagFile": { "id": "GoogleCloudAiplatformV1beta1RagFile", "description": "A RagFile contains user data for chunking, embedding and indexing.", "properties": { "userMetadata": { "type": "string", "description": "Output only. The metadata for metadata search. The user_metadata Needs to be in JSON format.", "readOnly": true }, "description": { "type": "string", "description": "Optional. The description of the RagFile." }, "createTime": { "format": "google-datetime", "description": "Output only. Timestamp when this RagFile was created.", "type": "string", "readOnly": true }, "ragFileType": { "enum": [ "RAG_FILE_TYPE_UNSPECIFIED", "RAG_FILE_TYPE_TXT", "RAG_FILE_TYPE_PDF" ], "readOnly": true, "type": "string", "enumDescriptions": [ "RagFile type is unspecified.", "RagFile type is TXT.", "RagFile type is PDF." ], "description": "Output only. The type of the RagFile." }, "name": { "readOnly": true, "description": "Output only. The resource name of the RagFile.", "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the RagFile. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "slackSource": { "description": "The RagFile is imported from a Slack channel.", "$ref": "GoogleCloudAiplatformV1beta1SlackSource" }, "sizeBytes": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. The size of the RagFile in bytes." }, "directUploadSource": { "$ref": "GoogleCloudAiplatformV1beta1DirectUploadSource", "readOnly": true, "description": "Output only. The RagFile is encapsulated and uploaded in the UploadRagFile request." }, "gcsSource": { "description": "Output only. Google Cloud Storage location of the RagFile. It does not support wildcards in the Cloud Storage uri for now.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource", "readOnly": true }, "jiraSource": { "description": "The RagFile is imported from a Jira query.", "$ref": "GoogleCloudAiplatformV1beta1JiraSource" }, "updateTime": { "format": "google-datetime", "description": "Output only. Timestamp when this RagFile was last updated.", "type": "string", "readOnly": true }, "googleDriveSource": { "description": "Output only. Google Drive location. Supports importing individual files as well as Google Drive folders.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1GoogleDriveSource" }, "sharePointSources": { "description": "The RagFile is imported from a SharePoint source.", "$ref": "GoogleCloudAiplatformV1beta1SharePointSources" }, "fileStatus": { "description": "Output only. State of the RagFile.", "$ref": "GoogleCloudAiplatformV1beta1FileStatus", "readOnly": true } }, "type": "object" }, "CloudAiLargeModelsVisionExperimentsResponseProEditResult": { "description": "Result metadata from a Pro Edit operation.", "type": "object", "properties": { "structuredPrompt": { "description": "The output structured prompt (JSON string) produced by this edit.", "type": "string" } }, "id": "CloudAiLargeModelsVisionExperimentsResponseProEditResult" }, "GoogleCloudAiplatformV1beta1IndexEndpoint": { "id": "GoogleCloudAiplatformV1beta1IndexEndpoint", "description": "Indexes are deployed into it. An IndexEndpoint can have multiple DeployedIndexes.", "properties": { "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "publicEndpointEnabled": { "type": "boolean", "description": "Optional. If true, the deployed index will be accessible through public endpoint." }, "displayName": { "type": "string", "description": "Required. The display name of the IndexEndpoint. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "labels": { "description": "The labels with user-defined metadata to organize your IndexEndpoints. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "type": "object", "additionalProperties": { "type": "string" } }, "deployedIndexes": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedIndex" }, "description": "Output only. The indexes deployed in this endpoint.", "readOnly": true, "type": "array" }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "description": { "description": "The description of the IndexEndpoint.", "type": "string" }, "encryptionSpec": { "description": "Immutable. Customer-managed encryption key spec for an IndexEndpoint. If set, this IndexEndpoint and all sub-resources of this IndexEndpoint will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "updateTime": { "readOnly": true, "description": "Output only. Timestamp when this IndexEndpoint was last updated. This timestamp is not updated when the endpoint's DeployedIndexes are updated, e.g. due to updates of the original Indexes they are the deployments of.", "format": "google-datetime", "type": "string" }, "privateServiceConnectConfig": { "description": "Optional. Configuration for private service connect. network and private_service_connect_config are mutually exclusive.", "$ref": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig" }, "publicEndpointDomainName": { "type": "string", "description": "Output only. If public_endpoint_enabled is true, this field will be populated with the domain name to use for this index endpoint.", "readOnly": true }, "name": { "type": "string", "description": "Output only. The resource name of the IndexEndpoint.", "readOnly": true }, "enablePrivateServiceConnect": { "type": "boolean", "deprecated": true, "description": "Optional. Deprecated: If true, expose the IndexEndpoint via private service connect. Only one of the fields, network or enable_private_service_connect, can be set." }, "createTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Timestamp when this IndexEndpoint was created." }, "etag": { "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "network": { "type": "string", "description": "Optional. The full name of the Google Compute Engine [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which the IndexEndpoint should be peered. Private services access must already be configured for the network. If left unspecified, the Endpoint is not peered with any network. network and private_service_connect_config are mutually exclusive. [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert): `projects/{project}/global/networks/{network}`. Where {project} is a project number, as in '12345', and {network} is network name." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig": { "properties": { "ragConfig": { "description": "Configuration for Retrieval Augmented Generation feature.", "$ref": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfigRagConfig" } }, "type": "object", "description": "Configuration for GenAiAdvancedFeatures.", "id": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig" }, "GoogleLearningVertexApiInteractionsV1beta1DeleteVoiceResponse": { "id": "GoogleLearningVertexApiInteractionsV1beta1DeleteVoiceResponse", "type": "object", "properties": {}, "description": "Response message for `VoicesService.DeleteVoice`." }, "GoogleCloudAiplatformV1beta1PairwiseMetricInstance": { "id": "GoogleCloudAiplatformV1beta1PairwiseMetricInstance", "properties": { "jsonInstance": { "description": "Instance specified as a json string. String key-value pairs are expected in the json_instance to render PairwiseMetricSpec.instance_prompt_template.", "type": "string" }, "contentMapInstance": { "description": "Key-value contents for the mutlimodality input, including text, image, video, audio, and pdf, etc. The key is placeholder in metric prompt template, and the value is the multimodal content.", "$ref": "GoogleCloudAiplatformV1beta1ContentMap" } }, "description": "Pairwise metric instance. Usually one instance corresponds to one row in an evaluation dataset.", "type": "object" }, "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig": { "description": "The configuration for routing the request to a specific model. This can be used to control which model is used for the generation, either automatically or by specifying a model name.", "type": "object", "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig", "properties": { "manualMode": { "description": "In this mode, the model is specified manually.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode" }, "autoMode": { "description": "In this mode, the model is selected automatically based on the content of the request.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode" } } }, "GoogleCloudAiplatformV1beta1CountTokensResponse": { "description": "Response message for PredictionService.CountTokens.", "properties": { "totalTokens": { "format": "int32", "description": "The total number of tokens counted across all instances from the request.", "type": "integer" }, "totalBillableCharacters": { "description": "The total number of billable characters counted across all instances from the request.", "format": "int32", "type": "integer" }, "promptTokensDetails": { "description": "Output only. List of modalities that were processed in the request input.", "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModalityTokenCount" } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CountTokensResponse" }, "GoogleCloudAiplatformV1beta1CreateNotebookExecutionJobOperationMetadata": { "description": "Metadata information for NotebookService.CreateNotebookExecutionJob.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." }, "progressMessage": { "type": "string", "description": "A human-readable message that shows the intermediate progress details of NotebookRuntime." } }, "id": "GoogleCloudAiplatformV1beta1CreateNotebookExecutionJobOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1ListPipelineJobsResponse": { "id": "GoogleCloudAiplatformV1beta1ListPipelineJobsResponse", "properties": { "pipelineJobs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJob" }, "type": "array", "description": "List of PipelineJobs in the requested page." }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListPipelineJobsRequest.page_token to obtain that page.", "type": "string" } }, "description": "Response message for PipelineService.ListPipelineJobs", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplateRef": { "properties": { "notebookRuntimeTemplate": { "description": "Immutable. A resource name of the NotebookRuntimeTemplate.", "type": "string" } }, "description": "Points to a NotebookRuntimeTemplateRef.", "id": "GoogleCloudAiplatformV1beta1NotebookRuntimeTemplateRef", "type": "object" }, "GoogleCloudAiplatformV1beta1ListTensorboardTimeSeriesResponse": { "properties": { "tensorboardTimeSeries": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "description": "The TensorboardTimeSeries mathching the request." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListTensorboardTimeSeriesRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response message for TensorboardService.ListTensorboardTimeSeries.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListTensorboardTimeSeriesResponse" }, "GenaiVertexV1beta1GoogleSearchCallStepGoogleSearchCallStepArguments": { "type": "object", "description": "The arguments to pass to Google Search.", "id": "GenaiVertexV1beta1GoogleSearchCallStepGoogleSearchCallStepArguments", "properties": { "queries": { "description": "Web search queries for the following-up web search.", "type": "array", "items": { "type": "string" } } } }, "GenaiVertexV1beta1ListValue": { "properties": { "values": { "description": "Repeated field of dynamically typed values.", "items": { "$ref": "GenaiVertexV1beta1Value" }, "type": "array" } }, "description": "`ListValue` is a wrapper around a repeated field of values.", "type": "object", "id": "GenaiVertexV1beta1ListValue" }, "CloudAiLargeModelsVisionImageRAIScores": { "properties": { "agileWatermarkDetectionScore": { "description": "Agile watermark score for image.", "type": "number", "format": "double" } }, "description": "RAI scores for generated image returned.", "type": "object", "id": "CloudAiLargeModelsVisionImageRAIScores" }, "GoogleCloudAiplatformV1beta1UpgradeNotebookRuntimeOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UpgradeNotebookRuntimeOperationMetadata", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progressMessage": { "description": "A human-readable message that shows the intermediate progress details of NotebookRuntime.", "type": "string" } }, "description": "Metadata information for NotebookService.UpgradeNotebookRuntime.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec": { "description": "Specification for a computation based metric.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec", "properties": { "type": { "type": "string", "enumDescriptions": [ "Unspecified computation based metric type.", "Exact match metric.", "BLEU metric.", "ROUGE metric." ], "description": "Required. The type of the computation based metric.", "enum": [ "COMPUTATION_BASED_METRIC_TYPE_UNSPECIFIED", "EXACT_MATCH", "BLEU", "ROUGE" ] }, "parameters": { "description": "Optional. A map of parameters for the metric, e.g. {\"rouge_type\": \"rougeL\"}.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } } }, "type": "object" }, "GenaiVertexV1beta1SpeakerConfig": { "id": "GenaiVertexV1beta1SpeakerConfig", "type": "object", "description": "Configuration for multi-speaker and speech generation.", "properties": { "speakers": { "description": "Individual speaker configurations.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1SpeechConfig" } } } }, "GoogleCloudAiplatformV1beta1IndexDatapointNumericRestriction": { "type": "object", "id": "GoogleCloudAiplatformV1beta1IndexDatapointNumericRestriction", "properties": { "namespace": { "description": "The namespace of this restriction. e.g.: cost.", "type": "string" }, "valueFloat": { "format": "float", "type": "number", "description": "Represents 32 bit float." }, "op": { "description": "This MUST be specified for queries and must NOT be specified for datapoints.", "enum": [ "OPERATOR_UNSPECIFIED", "LESS", "LESS_EQUAL", "EQUAL", "GREATER_EQUAL", "GREATER", "NOT_EQUAL" ], "enumDescriptions": [ "Default value of the enum.", "Datapoints are eligible iff their value is \u003c the query's.", "Datapoints are eligible iff their value is \u003c= the query's.", "Datapoints are eligible iff their value is == the query's.", "Datapoints are eligible iff their value is \u003e= the query's.", "Datapoints are eligible iff their value is \u003e the query's.", "Datapoints are eligible iff their value is != the query's." ], "type": "string" }, "valueDouble": { "type": "number", "format": "double", "description": "Represents 64 bit float." }, "valueInt": { "format": "int64", "type": "string", "description": "Represents 64 bit integer." } }, "description": "This field allows restricts to be based on numeric comparisons rather than categorical tokens." }, "GoogleCloudAiplatformV1beta1ToolParameterKVMatchMetricValue": { "description": "Tool parameter key value match metric value for an instance.", "properties": { "score": { "type": "number", "format": "float", "description": "Output only. Tool parameter key value match score.", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolParameterKVMatchMetricValue" }, "GoogleCloudAiplatformV1beta1GenerateContentRequest": { "properties": { "toolConfig": { "description": "Optional. Tool config. This config is shared for all tools provided in the request.", "$ref": "GoogleCloudAiplatformV1beta1ToolConfig" }, "continuationToken": { "type": "string", "description": "Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`.", "format": "byte" }, "modelArmorConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelArmorConfig", "description": "Optional. Settings for prompt and response sanitization using the Model Armor service. If supplied, safety_settings must not be supplied." }, "generationConfig": { "description": "Optional. Generation config.", "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig" }, "safetySettings": { "type": "array", "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SafetySetting" } }, "cachedContent": { "description": "Optional. The name of the cached content used as context to serve the prediction. Note: only used in explicit caching, where users can have control over caching (e.g. what content to cache) and enjoy guaranteed cost savings. Format: `projects/{project}/locations/{location}/cachedContents/{cachedContent}`", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter." }, "tools": { "type": "array", "description": "Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } }, "contents": { "description": "Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array" }, "systemInstruction": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph." } }, "id": "GoogleCloudAiplatformV1beta1GenerateContentRequest", "description": "Request message for [PredictionService.GenerateContent].", "type": "object" }, "GoogleCloudAiplatformV1beta1ExecuteCodeResponse": { "description": "Response message for SandboxEnvironmentExecutionService.ExecuteCode.", "properties": { "outputs": { "description": "The outputs from the sandbox environment.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" } } }, "id": "GoogleCloudAiplatformV1beta1ExecuteCodeResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1ToolNameMatchInput": { "id": "GoogleCloudAiplatformV1beta1ToolNameMatchInput", "type": "object", "description": "Input for tool name match metric.", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1ToolNameMatchSpec", "description": "Required. Spec for tool name match metric." }, "instances": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolNameMatchInstance" }, "type": "array", "description": "Required. Repeated tool name match instances." } } }, "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardRequest": { "type": "object", "description": "Request message for GenAiTuningService.ValidateReinforcementTuningReward.", "properties": { "sampleResponse": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Required. The sample response for validating the reward configuration." }, "example": { "description": "Required. The example to validate the reward configuration.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningExample" }, "singleRewardConfig": { "$ref": "GoogleCloudAiplatformV1beta1SingleReinforcementTuningRewardConfig", "description": "Optional. Single Reward function configuration for reinforcement tuning." }, "compositeRewardConfig": { "$ref": "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfig", "description": "Optional. Composite reward function configuration for reinforcement tuning." } }, "id": "GoogleCloudAiplatformV1beta1ValidateReinforcementTuningRewardRequest" }, "GoogleCloudAiplatformV1beta1FulfillmentSpec": { "id": "GoogleCloudAiplatformV1beta1FulfillmentSpec", "properties": { "version": { "format": "int32", "description": "Optional. Which version to use for evaluation.", "type": "integer" } }, "type": "object", "description": "Spec for fulfillment metric." }, "GoogleCloudAiplatformV1beta1FeatureMonitorJob": { "id": "GoogleCloudAiplatformV1beta1FeatureMonitorJob", "properties": { "triggerType": { "type": "string", "enum": [ "FEATURE_MONITOR_JOB_TRIGGER_UNSPECIFIED", "FEATURE_MONITOR_JOB_TRIGGER_PERIODIC", "FEATURE_MONITOR_JOB_TRIGGER_ON_DEMAND" ], "readOnly": true, "enumDescriptions": [ "Trigger type unspecified.", "Triggered by periodic schedule.", "Triggered on demand by CreateFeatureMonitorJob request." ], "description": "Output only. Trigger type of the Feature Monitor Job." }, "name": { "description": "Identifier. Name of the FeatureMonitorJob. Format: `projects/{project}/locations/{location}/featureGroups/{feature_group}/featureMonitors/{feature_monitor}/featureMonitorJobs/{feature_monitor_job}`.", "type": "string" }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize your FeatureMonitorJob. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one FeatureMonitor(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable." }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when this FeatureMonitorJob was created. Creation of a FeatureMonitorJob means that the job is pending / waiting for sufficient resources but may not have started running yet.", "readOnly": true }, "jobSummary": { "description": "Output only. Summary from the FeatureMonitorJob.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitorJobJobSummary" }, "driftBaseSnapshotTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Data snapshot time comparing to which the drift is calculated." }, "finalStatus": { "description": "Output only. Final status of the FeatureMonitorJob.", "readOnly": true, "$ref": "GoogleRpcStatus" }, "featureSelectionConfig": { "description": "Output only. Feature selection config used when creating FeatureMonitorJob.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1FeatureSelectionConfig" }, "description": { "type": "string", "description": "Optional. Description of the FeatureMonitor." }, "driftBaseFeatureMonitorJobId": { "description": "Output only. FeatureMonitorJob ID comparing to which the drift is calculated.", "type": "string", "format": "int64", "readOnly": true } }, "description": "Vertex AI Feature Monitor Job.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListSkillsResponse": { "id": "GoogleCloudAiplatformV1beta1ListSkillsResponse", "type": "object", "properties": { "skills": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Skill" }, "description": "The Skills.", "type": "array" }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListSkillsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "description": "Response message for SkillRegistryService.ListSkills." }, "GoogleCloudAiplatformV1beta1FetchExamplesRequest": { "type": "object", "properties": { "pageSize": { "type": "integer", "description": "Optional. The maximum number of examples to return. The service may return fewer than this value. If unspecified, at most 100 examples will be returned.", "format": "int32" }, "exampleIds": { "items": { "type": "string" }, "description": "Optional. Example IDs to fetch. If both metadata filters and Example IDs are specified, then both ID and metadata filtering will be applied.", "type": "array" }, "pageToken": { "description": "Optional. The next_page_token value returned from a previous list ExampleStoreService.FetchExamplesResponse call.", "type": "string" }, "storedContentsExampleFilter": { "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleFilter", "description": "The metadata filters for StoredContentsExamples." } }, "description": "Request message for ExampleStoreService.FetchExamples.", "id": "GoogleCloudAiplatformV1beta1FetchExamplesRequest" }, "GoogleCloudAiplatformV1beta1ListMetadataStoresResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListMetadataStoresResponse", "properties": { "metadataStores": { "type": "array", "description": "The MetadataStores found for the Location.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MetadataStore" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListMetadataStoresRequest.page_token to retrieve the next page. If this field is not populated, there are no subsequent pages." } }, "description": "Response message for MetadataService.ListMetadataStores." }, "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardTimeSeriesResponse", "description": "Response message for TensorboardService.BatchCreateTensorboardTimeSeries.", "properties": { "tensorboardTimeSeries": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "description": "The created TensorboardTimeSeries." } } }, "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataBigQuerySource": { "id": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataBigQuerySource", "properties": { "uri": { "description": "The URI of a BigQuery table.", "type": "string" } }, "type": "object" }, "GenaiVertexV1beta1FileSearchCallDelta": { "properties": {}, "type": "object", "id": "GenaiVertexV1beta1FileSearchCallDelta" }, "GoogleCloudAiplatformV1beta1SchemaVideoDatasetMetadata": { "properties": { "gcsBucket": { "description": "Google Cloud Storage Bucket name that contains the blob data of this Dataset.", "type": "string" }, "dataItemSchemaUri": { "type": "string", "description": "Points to a YAML file stored on Google Cloud Storage describing payload of the Video DataItems that belong to this Dataset." } }, "id": "GoogleCloudAiplatformV1beta1SchemaVideoDatasetMetadata", "type": "object", "description": "The metadata of Datasets that contain Video DataItems." }, "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfig": { "description": "Configuration for Multi-LoRA adaptation.", "type": "object", "properties": { "adapters": { "type": "array", "description": "List of LoRA adapters to apply.", "items": { "$ref": "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfigAdapter" } } }, "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsLoraConfig" }, "GoogleCloudAiplatformV1beta1DedicatedResourcesScaleToZeroSpec": { "id": "GoogleCloudAiplatformV1beta1DedicatedResourcesScaleToZeroSpec", "type": "object", "properties": { "idleScaledownPeriod": { "type": "string", "format": "google-duration", "description": "Optional. Duration of no traffic before scaling to zero. [MinValue=300] (5 minutes) [MaxValue=28800] (8 hours)" }, "minScaleupPeriod": { "description": "Optional. Minimum duration that a deployment will be scaled up before traffic is evaluated for potential scale-down. [MinValue=300] (5 minutes) [MaxValue=28800] (8 hours)", "format": "google-duration", "type": "string" } }, "description": "Specification for scale-to-zero feature." }, "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInput": { "properties": { "metricSpec": { "description": "Required. Spec for question answering relevance score metric.", "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceSpec" }, "instance": { "$ref": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInstance", "description": "Required. Question answering relevance instance." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInput", "description": "Input for question answering relevance metric." }, "GoogleCloudAiplatformV1beta1TranslationConfig": { "type": "object", "description": "Config for translation features.", "id": "GoogleCloudAiplatformV1beta1TranslationConfig", "properties": { "echoTargetLanguage": { "type": "boolean", "description": "Optional. If `true`, the model will generate audio when the target language is spoken, essentially it will parrot the input. If `false`, we will not produce audio for the target language." }, "targetLanguageCode": { "description": "Required. The target language for translation. Supported values are BCP-47 language codes (e.g. \"en\", \"es\", \"fr\").", "type": "string" } } }, "GoogleCloudAiplatformV1beta1VeoLoraTuningSpec": { "description": "Tuning Spec for Veo LoRA Model Tuning.", "id": "GoogleCloudAiplatformV1beta1VeoLoraTuningSpec", "properties": { "videoOrientation": { "enum": [ "VIDEO_ORIENTATION_UNSPECIFIED", "LANDSCAPE", "PORTRAIT" ], "enumDescriptions": [ "Unspecified video orientation. Defaults to landscape.", "Landscape orientation (e.g. 16:9, 1280x720).", "Portrait orientation (e.g. 9:16, 720x1280)." ], "description": "Optional. The orientation of the video. Defaults to LANDSCAPE.", "type": "string" }, "trainingDatasetUri": { "type": "string", "description": "Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset." }, "hyperParameters": { "$ref": "GoogleCloudAiplatformV1beta1VeoHyperParameters", "description": "Optional. Hyperparameters for Veo LoRA." }, "validationDatasetUri": { "type": "string", "description": "Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecCategoricalValueCondition": { "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecCategoricalValueCondition", "description": "Represents the spec to match categorical values from parent parameter.", "properties": { "values": { "description": "Required. Matches values of the parent parameter of 'CATEGORICAL' type. All values must exist in `categorical_value_spec` of parent parameter.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputVertexEndpointLogs": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputVertexEndpointLogs", "description": "Data from Vertex AI Endpoint request response logging.", "properties": { "endpoints": { "type": "array", "items": { "type": "string" }, "description": "List of endpoint resource names. The endpoints must enable the logging with the [Endpoint].[request_response_logging_config], and must contain the deployed model corresponding to the model version specified in [ModelMonitor].[model_monitoring_target]." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModelDocumentation": { "id": "GoogleCloudAiplatformV1beta1PublisherModelDocumentation", "description": "A named piece of documentation.", "type": "object", "properties": { "title": { "type": "string", "description": "Required. E.g., OVERVIEW, USE CASES, DOCUMENTATION, SDK & SAMPLES, JAVA, NODE.JS, etc.." }, "content": { "description": "Required. Content of this piece of document (in Markdown format).", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SuspendOnlineEvaluatorRequest": { "id": "GoogleCloudAiplatformV1beta1SuspendOnlineEvaluatorRequest", "type": "object", "properties": {}, "description": "Request message for SuspendOnlineEvaluator." }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSource": { "type": "object", "description": "A conversation source for the example. This is similar to `DirectContentsSource`.", "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSource", "properties": { "events": { "description": "Optional. Represents the input conversation events for the example.", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSourceEvent" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1FeatureSelectionConfig": { "description": "Feature selection configuration for the FeatureMonitor.", "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureSelectionConfig", "properties": { "featureConfigs": { "description": "Optional. A list of features to be monitored and each feature's drift threshold.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureSelectionConfigFeatureConfig" } } } }, "GoogleCloudAiplatformV1beta1SupervisedTuningDataStats": { "id": "GoogleCloudAiplatformV1beta1SupervisedTuningDataStats", "description": "Tuning data statistics for Supervised Tuning.", "properties": { "userInputTokenDistribution": { "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistribution", "description": "Output only. Dataset distributions for the user input tokens.", "readOnly": true }, "totalBillableCharacterCount": { "format": "int64", "type": "string", "readOnly": true, "deprecated": true, "description": "Output only. Number of billable characters in the tuning dataset." }, "truncatedExampleIndices": { "readOnly": true, "type": "array", "items": { "format": "int64", "type": "string" }, "description": "Output only. A partial sample of the indices (starting from 1) of the dropped examples." }, "userDatasetExamples": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "readOnly": true, "description": "Output only. Sample user messages in the training dataset uri.", "type": "array" }, "tuningStepCount": { "readOnly": true, "type": "string", "description": "Output only. Number of tuning steps for this Tuning Job.", "format": "int64" }, "userMessagePerExampleDistribution": { "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistribution", "readOnly": true, "description": "Output only. Dataset distributions for the messages per example." }, "tuningDatasetExampleCount": { "type": "string", "description": "Output only. Number of examples in the tuning dataset.", "format": "int64", "readOnly": true }, "totalTruncatedExampleCount": { "description": "Output only. The number of examples in the dataset that have been dropped. An example can be dropped for reasons including: too many tokens, contains an invalid image, contains too many images, etc.", "readOnly": true, "type": "string", "format": "int64" }, "totalBillableTokenCount": { "type": "string", "readOnly": true, "format": "int64", "description": "Output only. Number of billable tokens in the tuning dataset." }, "userOutputTokenDistribution": { "description": "Output only. Dataset distributions for the user output tokens.", "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistribution", "readOnly": true }, "totalTuningCharacterCount": { "description": "Output only. Number of tuning characters in the tuning dataset.", "readOnly": true, "format": "int64", "type": "string" }, "droppedExampleReasons": { "readOnly": true, "description": "Output only. For each index in `truncated_example_indices`, the user-facing reason why the example was dropped.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1CreateRegistryFeatureOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateRegistryFeatureOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "Operation metadata for Feature.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Details of operations that perform create FeatureGroup." }, "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig": { "description": "The runtime config of a PipelineJob.", "type": "object", "properties": { "defaultRuntime": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigDefaultRuntime", "description": "Optional. The default runtime for the PipelineJob. If not set, Standard Vertex Custom Job(https://cloud.google.com/vertex-ai/docs/training/overview) is used as the runtime. If set, all pipeline tasks will run on the default runtime unless a task is a GCPC custom job component (https://cloud.google.com/vertex-ai/docs/pipelines/customjob-component) based task. If the task is based on a GCPC custom job component, it runs solely according to the component's configuration." }, "parameters": { "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Value" }, "description": "Deprecated. Use RuntimeConfig.parameter_values instead. The runtime parameters of the PipelineJob. The parameters will be passed into PipelineJob.pipeline_spec to replace the placeholders at runtime. This field is used by pipelines built using `PipelineJob.pipeline_spec.schema_version` 2.0.0 or lower, such as pipelines built using Kubeflow Pipelines SDK 1.8 or lower.", "deprecated": true }, "parameterValues": { "description": "The runtime parameters of the PipelineJob. The parameters will be passed into PipelineJob.pipeline_spec to replace the placeholders at runtime. This field is used by pipelines built using `PipelineJob.pipeline_spec.schema_version` 2.1.0, such as pipelines built using Kubeflow Pipelines SDK 1.9 or higher and the v2 DSL.", "additionalProperties": { "type": "any" }, "type": "object" }, "failurePolicy": { "enum": [ "PIPELINE_FAILURE_POLICY_UNSPECIFIED", "PIPELINE_FAILURE_POLICY_FAIL_SLOW", "PIPELINE_FAILURE_POLICY_FAIL_FAST" ], "description": "Represents the failure policy of a pipeline. Currently, the default of a pipeline is that the pipeline will continue to run until no more tasks can be executed, also known as PIPELINE_FAILURE_POLICY_FAIL_SLOW. However, if a pipeline is set to PIPELINE_FAILURE_POLICY_FAIL_FAST, it will stop scheduling any new tasks when a task has failed. Any scheduled tasks will continue to completion.", "enumDescriptions": [ "Default value, and follows fail slow behavior.", "Indicates that the pipeline should continue to run until all possible tasks have been scheduled and completed.", "Indicates that the pipeline should stop scheduling new tasks after a task has failed." ], "type": "string" }, "gcsOutputDirectory": { "description": "Required. A path in a Cloud Storage bucket, which will be treated as the root output directory of the pipeline. It is used by the system to generate the paths of output artifacts. The artifact paths are generated with a sub-path pattern `{job_id}/{task_id}/{output_key}` under the specified output directory. The service account specified in this pipeline must have the `storage.objects.get` and `storage.objects.create` permissions for this bucket.", "type": "string" }, "inputArtifacts": { "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfigInputArtifact" }, "description": "The runtime artifacts of the PipelineJob. The key will be the input artifact name and the value would be one of the InputArtifact." } }, "id": "GoogleCloudAiplatformV1beta1PipelineJobRuntimeConfig" }, "GoogleCloudAiplatformV1beta1ReadIndexDatapointsResponse": { "properties": { "datapoints": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapoint" }, "description": "The result list of datapoints." } }, "description": "The response message for MatchService.ReadIndexDatapoints.", "id": "GoogleCloudAiplatformV1beta1ReadIndexDatapointsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScope": { "type": "object", "description": "If chosen, the online evaluator will evaluate sessions matching specified `filter`. A session is a group of traces with a common `gen_ai.conversation.id`.", "properties": { "filter": { "type": "array", "description": "Optional. A list of predicates to filter sessions. Multiple predicates are combined using AND. The maximum number of predicates is 10.", "items": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopePredicate" } }, "inactivityTrigger": { "description": "Session is considered ready for evaluation when there are no new traces for a specified period of inactivity.", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopeInactivityTrigger" } }, "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScope" }, "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest": { "description": "Request message for ModelGardenService.DeployPublisherModel.", "properties": { "huggingFaceAccessToken": { "description": "Optional. The Hugging Face read access token used to access the model artifacts of gated models.", "type": "string" }, "endpointDisplayName": { "type": "string", "description": "Optional. The user-specified display name of the endpoint. If not set, a default name will be used." }, "modelDisplayName": { "type": "string", "description": "Optional. The user-specified display name of the uploaded model. If not set, a default name will be used." }, "dedicatedResources": { "description": "Optional. The dedicated resources to use for the endpoint. If not set, the default resources will be used.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResources" }, "model": { "type": "string", "description": "Required. The model to deploy. Format: 1. `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`. 2. Hugging Face model ID like `google/gemma-2-2b-it`. 3. Custom model Google Cloud Storage URI like `gs://bucket`. 4. Custom model zip file like `https://example.com/a.zip`." }, "acceptEula": { "type": "boolean", "description": "Optional. Whether the user accepts the End User License Agreement (EULA) for the model." } }, "id": "GoogleCloudAiplatformV1beta1DeployPublisherModelRequest", "deprecated": true, "type": "object" }, "GoogleCloudAiplatformV1beta1GoogleMapsRouting": { "description": "Grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute).", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1GoogleMapsRouting" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTextSentimentPredictionResult": { "description": "Prediction output format for Text Sentiment", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTextSentimentPredictionResult", "properties": { "sentiment": { "format": "int32", "type": "integer", "description": "The integer sentiment labels between 0 (inclusive) and sentimentMax label (inclusive), while 0 maps to the least positive sentiment and sentimentMax maps to the most positive one. The higher the score is, the more positive the sentiment in the text snippet is. Note: sentimentMax is an integer value between 1 (inclusive) and 10 (inclusive)." } } }, "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto": { "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageAuto", "deprecated": true, "type": "object", "properties": {}, "description": "Deprecated: Use top-level `language_codes` instead. Indicates the language of the audio should be automatically detected." }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsRequest": { "properties": { "timeInterval": { "description": "The time interval for which results should be returned.", "$ref": "GoogleTypeInterval" }, "pageToken": { "description": "A page token received from a previous ModelMonitoringService.SearchModelMonitoringStats call.", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size." }, "statsFilter": { "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilter", "description": "Filter for search different stats." } }, "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsRequest", "description": "Request message for ModelMonitoringService.SearchModelMonitoringStats.", "type": "object" }, "GoogleCloudAiplatformV1beta1ImportModelEvaluationRequest": { "type": "object", "properties": { "modelEvaluation": { "description": "Required. Model evaluation resource to be imported.", "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluation" } }, "id": "GoogleCloudAiplatformV1beta1ImportModelEvaluationRequest", "description": "Request message for ModelService.ImportModelEvaluation" }, "GoogleCloudAiplatformV1beta1CreateIndexEndpointOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." } }, "description": "Runtime operation information for IndexEndpointService.CreateIndexEndpoint.", "id": "GoogleCloudAiplatformV1beta1CreateIndexEndpointOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1Citation": { "properties": { "license": { "description": "Output only. The license of the source of the citation.", "type": "string", "readOnly": true }, "uri": { "type": "string", "readOnly": true, "description": "Output only. The URI of the source of the citation." }, "startIndex": { "format": "int32", "type": "integer", "description": "Output only. The start index of the citation in the content.", "readOnly": true }, "title": { "readOnly": true, "type": "string", "description": "Output only. The title of the source of the citation." }, "publicationDate": { "readOnly": true, "$ref": "GoogleTypeDate", "description": "Output only. The publication date of the source of the citation." }, "endIndex": { "type": "integer", "description": "Output only. The end index of the citation in the content.", "readOnly": true, "format": "int32" } }, "description": "A citation for a piece of generatedcontent.", "id": "GoogleCloudAiplatformV1beta1Citation", "type": "object" }, "GoogleCloudAiplatformV1beta1CsvSource": { "id": "GoogleCloudAiplatformV1beta1CsvSource", "properties": { "gcsSource": { "description": "Required. Google Cloud Storage location.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" } }, "description": "The storage details for CSV input content.", "type": "object" }, "GoogleCloudAiplatformV1beta1CreateFeatureOnlineStoreOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateFeatureOnlineStoreOperationMetadata", "properties": { "genericMetadata": { "description": "Operation metadata for FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "description": "Details of operations that perform create FeatureOnlineStore." }, "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategyKeepNLatest": { "properties": { "maxRevisions": { "type": "integer", "description": "Required. Specifies the maximum number of Runtime Revisions to keep active. If an update to Reasoning Engine would result in exceeding this number of active Runtime Revisions, a new Runtime Revision will be created, while the oldest Runtime Revision will be automatically deleted, providing it's not configured to serve traffic via `traffic_config`. If the oldest Runtime Revision is configured to serve traffic, the update will fail validation. No changes will be made to the Reasoning Engine, existing Runtime Revisions, and no new Runtime Revision will be created.", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategyKeepNLatest", "description": "Keeps only the latest N Runtime Revisions active.", "type": "object" }, "GoogleCloudAiplatformV1beta1OutputConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1OutputConfig", "properties": { "gcsDestination": { "description": "Cloud storage destination for evaluation output.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" } }, "description": "Config for evaluation output." }, "GoogleCloudAiplatformV1beta1AgentData": { "description": "Represents data specific to multi-turn agent evaluations.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AgentData", "properties": { "turns": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ConversationTurn" }, "type": "array", "description": "Optional. A chronological list of conversation turns. Each turn represents a logical execution cycle (e.g., User Input -\u003e Agent Response)." }, "agents": { "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AgentConfig" }, "description": "Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent." } } }, "GoogleCloudAiplatformV1beta1ReportExecutionEventRequest": { "id": "GoogleCloudAiplatformV1beta1ReportExecutionEventRequest", "type": "object", "description": "Request message for NotebookInternalService.ReportExecutionEvent.", "properties": { "status": { "$ref": "GoogleRpcStatus", "description": "Optional. The error details of the event." }, "vmToken": { "type": "string", "description": "Required. The VM identity token (a JWT) for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity" }, "eventType": { "type": "string", "enumDescriptions": [ "Unspecified.", "Notebook execution process has started. Expect this message within expected time to provision compute.", "Notebook execution process is completed. Expect this message within timeout.", "Notebook execution process has failed. Expect this message within timeout." ], "description": "Required. The type of the event.", "enum": [ "EVENT_TYPE_UNSPECIFIED", "ACTIVE", "DONE", "FAILED" ] } } }, "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest": { "type": "object", "properties": { "operationName": { "description": "Required. The server-assigned name for the operation.", "type": "string" } }, "description": "Request message for PredictionService.FetchPredictOperation.", "id": "GoogleCloudAiplatformV1beta1FetchPredictOperationRequest" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTimestampTransformation": { "description": "Training pipeline will perform following transformation functions. * Apply the transformation functions for Numerical columns. * Determine the year, month, day,and weekday. Treat each value from the timestamp as a Categorical column. * Invalid numerical values (for example, values that fall outside of a typical timestamp range, or are extreme values) receive no special treatment and are not removed.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputsTransformationTimestampTransformation", "properties": { "columnName": { "type": "string" }, "timeFormat": { "description": "The format in which that time field is expressed. The time_format must either be one of: * `unix-seconds` * `unix-milliseconds` * `unix-microseconds` * `unix-nanoseconds` (for respectively number of seconds, milliseconds, microseconds and nanoseconds since start of the Unix epoch); or be written in `strftime` syntax. If time_format is not set, then the default format is RFC 3339 `date-time` format, where `time-offset` = `\"Z\"` (e.g. 1985-04-12T23:20:50.52Z)", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngine": { "properties": { "labels": { "type": "object", "description": "Labels for the ReasoningEngine.", "additionalProperties": { "type": "string" } }, "name": { "description": "Identifier. The resource name of the ReasoningEngine. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`", "type": "string" }, "createTime": { "type": "string", "description": "Output only. Timestamp when this ReasoningEngine was created.", "format": "google-datetime", "readOnly": true }, "displayName": { "description": "Required. The display name of the ReasoningEngine.", "type": "string" }, "trafficConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfig", "description": "Optional. Traffic distribution configuration for the Reasoning Engine." }, "updateTime": { "description": "Output only. Timestamp when this ReasoningEngine was most recently updated.", "type": "string", "readOnly": true, "format": "google-datetime" }, "contextSpec": { "description": "Optional. Configuration for how Agent Engine sub-resources should manage context.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpec" }, "spec": { "description": "Optional. Configurations of the ReasoningEngine", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpec" }, "description": { "type": "string", "description": "Optional. The description of the ReasoningEngine." }, "etag": { "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "revisionGarbageCollectionStrategy": { "description": "Optional. Configures garbage collection of Runtime Revisions.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineRevisionGarbageCollectionStrategy" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key spec for a ReasoningEngine. If set, this ReasoningEngine and all sub-resources of this ReasoningEngine will be secured by this key." } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngine", "type": "object", "description": "ReasoningEngine provides a customizable runtime for models to determine which actions to take and in which order." }, "GoogleCloudAiplatformV1beta1SupervisedHyperParameters": { "description": "Hyperparameters for SFT.", "id": "GoogleCloudAiplatformV1beta1SupervisedHyperParameters", "properties": { "adapterSize": { "enumDescriptions": [ "Adapter size is unspecified.", "Adapter size 1.", "Adapter size 2.", "Adapter size 4.", "Adapter size 8.", "Adapter size 16.", "Adapter size 32." ], "enum": [ "ADAPTER_SIZE_UNSPECIFIED", "ADAPTER_SIZE_ONE", "ADAPTER_SIZE_TWO", "ADAPTER_SIZE_FOUR", "ADAPTER_SIZE_EIGHT", "ADAPTER_SIZE_SIXTEEN", "ADAPTER_SIZE_THIRTY_TWO" ], "description": "Optional. Adapter size for tuning.", "type": "string" }, "batchSize": { "description": "Optional. Batch size for tuning. This feature is only available for open source models.", "format": "int64", "type": "string" }, "learningRateMultiplier": { "description": "Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.", "type": "number", "format": "double" }, "learningRate": { "description": "Optional. Learning rate for tuning. Mutually exclusive with `learning_rate_multiplier`. This feature is only available for open source models.", "format": "double", "type": "number" }, "epochCount": { "description": "Optional. Number of complete passes the model makes over the entire training dataset during training.", "type": "string", "format": "int64" } }, "type": "object" }, "GenaiVertexV1beta1InteractionCreatedSseEvent": { "type": "object", "properties": { "interaction": { "description": "Required. Partial interaction resource emitted when the stream is created.", "$ref": "GenaiVertexV1beta1Interaction" } }, "description": "Server response confirming that a new interaction was created.", "id": "GenaiVertexV1beta1InteractionCreatedSseEvent" }, "GenaiVertexV1beta1DocumentContent": { "type": "object", "id": "GenaiVertexV1beta1DocumentContent", "properties": { "data": { "description": "The document content.", "type": "string", "format": "byte" }, "uri": { "description": "The URI of the document.", "type": "string" }, "mimeTypeString": { "type": "string", "description": "Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key." } }, "description": "A document content block. " }, "GoogleCloudAiplatformV1beta1ExportFeatureValuesResponse": { "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1ExportFeatureValuesResponse", "description": "Response message for FeaturestoreService.ExportFeatureValues." }, "GoogleCloudAiplatformV1beta1AuthConfigGoogleServiceAccountConfig": { "properties": { "serviceAccount": { "description": "Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension.", "type": "string" } }, "description": "Config for Google Service Account Authentication.", "type": "object", "id": "GoogleCloudAiplatformV1beta1AuthConfigGoogleServiceAccountConfig" }, "GoogleCloudAiplatformV1beta1UrlMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1UrlMetadata", "description": "The metadata for a single URL retrieval.", "properties": { "retrievedUrl": { "description": "The URL retrieved by the tool.", "type": "string" }, "urlRetrievalStatus": { "description": "The status of the URL retrieval.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The URL was retrieved successfully.", "The URL retrieval failed." ], "enum": [ "URL_RETRIEVAL_STATUS_UNSPECIFIED", "URL_RETRIEVAL_STATUS_SUCCESS", "URL_RETRIEVAL_STATUS_ERROR" ] } } }, "GoogleCloudAiplatformV1beta1IndexDatapointSparseEmbedding": { "type": "object", "id": "GoogleCloudAiplatformV1beta1IndexDatapointSparseEmbedding", "description": "Feature embedding vector for sparse index. An array of numbers whose values are located in the specified dimensions.", "properties": { "dimensions": { "description": "Required. The list of indexes for the embedding values of the sparse vector.", "type": "array", "items": { "type": "string", "format": "int64" } }, "values": { "type": "array", "description": "Required. The list of embedding values of the sparse vector.", "items": { "type": "number", "format": "float" } } } }, "GoogleCloudAiplatformV1beta1ListMemoriesResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListMemoriesResponse", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListMemoriesRequest.page_token to obtain that page.", "type": "string" }, "memories": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Memory" }, "type": "array", "description": "List of Memories in the requested page." } }, "description": "Response message for MemoryBankService.ListMemories." }, "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfigEmailAlertConfig": { "properties": { "userEmails": { "description": "The email addresses to send the alert.", "items": { "type": "string" }, "type": "array" } }, "description": "The config for email alert.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfigEmailAlertConfig" }, "GoogleCloudAiplatformV1beta1IndexDatapointCrowdingTag": { "properties": { "crowdingAttribute": { "description": "The attribute value used for crowding. The maximum number of neighbors to return per crowding attribute value (per_crowding_attribute_num_neighbors) is configured per-query. This field is ignored if per_crowding_attribute_num_neighbors is larger than the total number of neighbors to return for a given query.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1IndexDatapointCrowdingTag", "description": "Crowding tag is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than some value k' of the k neighbors returned have the same value of crowding_attribute." }, "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingRestrict": { "id": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMappingRestrict", "description": "Restrictions on string values.", "type": "object", "properties": { "namespace": { "description": "Required. The namespace of the restrict in the index.", "type": "string" }, "allowColumn": { "items": { "type": "string" }, "description": "Optional. The columns containing the allow values.", "type": "array" }, "denyColumn": { "description": "Optional. The columns containing the deny values.", "items": { "type": "string" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1CopyModelRequest": { "description": "Request message for ModelService.CopyModel.", "properties": { "customServiceAccount": { "description": "Optional. The user-provided custom service account to use to do the copy model. If empty, [Vertex AI Service Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) will be used to access resources needed to upload the model. This account must belong to the destination project where the model is copied to, i.e., the project specified in the `parent` field of this request and have the Vertex AI Service Agent role in the source project. Requires the user copying the Model to have the `iam.serviceAccounts.actAs` permission on this service account.", "type": "string" }, "parentModel": { "type": "string", "description": "Optional. Specify this field to copy source_model into this existing Model as a new version. Format: `projects/{project}/locations/{location}/models/{model}`" }, "modelId": { "description": "Optional. Copy source_model into a new Model with this ID. The ID will become the final component of the model resource name. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", "type": "string" }, "sourceModel": { "type": "string", "description": "Required. The resource name of the Model to copy. That Model must be in the same Project. Format: `projects/{project}/locations/{location}/models/{model}`" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Customer-managed encryption key options. If this is set, then the Model copy will be encrypted with the provided encryption key." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1CopyModelRequest" }, "GoogleCloudAiplatformV1beta1ListFeaturesResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListFeaturesResponse", "description": "Response message for FeaturestoreService.ListFeatures. Response message for FeatureRegistryService.ListFeatures.", "properties": { "nextPageToken": { "description": "A token, which can be sent as ListFeaturesRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "features": { "type": "array", "description": "The Features matching the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Feature" } } } }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInlineSource": { "description": "Wrapper for inline data.", "type": "object", "properties": { "content": { "type": "string", "description": "Required. The content of the inline data.", "format": "byte" }, "importSchemaConfig": { "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestImportSchemaConfig", "description": "Required. Schema configuration for the inline data." } }, "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestInlineSource" }, "GoogleCloudAiplatformV1beta1RemoveExamplesResponse": { "id": "GoogleCloudAiplatformV1beta1RemoveExamplesResponse", "type": "object", "description": "Response message for ExampleStoreService.RemoveExamples.", "properties": { "exampleIds": { "description": "The IDs for the removed examples.", "items": { "type": "string" }, "type": "array" } } }, "GoogleCloudAiplatformV1beta1NearestNeighborQueryParameters": { "description": "Parameters that can be overrided in each query to tune query latency and recall.", "properties": { "approximateNeighborCandidates": { "format": "int32", "type": "integer", "description": "Optional. The number of neighbors to find via approximate search before exact reordering is performed; if set, this value must be \u003e neighbor_count." }, "leafNodesSearchFraction": { "type": "number", "format": "double", "description": "Optional. The fraction of the number of leaves to search, set at query time allows user to tune search performance. This value increase result in both search accuracy and latency increase. The value should be between 0.0 and 1.0." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NearestNeighborQueryParameters" }, "GoogleCloudAiplatformV1beta1SchemaVideoClassificationAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaVideoClassificationAnnotation", "properties": { "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "annotationSpecId": { "description": "The resource Id of the AnnotationSpec that this Annotation pertains to.", "type": "string" }, "timeSegment": { "description": "This Annotation applies to the time period represented by the TimeSegment. If it's not set, the Annotation applies to the whole video.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTimeSegment" } }, "description": "Annotation details specific to video classification.", "type": "object" }, "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionValidationAssessmentConfig": { "type": "object", "description": "Configuration for the batch prediction validation assessment.", "properties": { "modelName": { "description": "Required. The name of the model used for batch prediction.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AssessDataRequestBatchPredictionValidationAssessmentConfig" }, "GoogleCloudAiplatformV1beta1PublisherModelConfig": { "description": "This message contains configs of a publisher model.", "properties": { "claudeFeatureConfig": { "description": "Optional. Config for Claude-specific features.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfigClaudeFeatureConfig" }, "loggingConfig": { "$ref": "GoogleCloudAiplatformV1beta1PredictRequestResponseLoggingConfig", "description": "Optional. The prediction request/response logging config." }, "dataSharingEnabledProvider": { "description": "Optional. The model provider (publisher) for which the customer has enabled data sharing. For publisher models that are configured to require data sharing, a prediction request is only allowed when the model's publisher matches this provider. Otherwise, the request is rejected.", "type": "string", "enumDescriptions": [ "Unspecified model provider.", "Anthropic." ], "enum": [ "MODEL_PROVIDER_UNSPECIFIED", "ANTHROPIC" ] }, "inferenceEventLoggingConfig": { "$ref": "GoogleCloudAiplatformV1beta1InferenceEventLoggingConfig", "description": "Optional. Turns the per-request `aiplatform.googleapis.com/inference_request` Cloud Logging log on or off. The log records structured per-request metadata (such as principal, traffic type, and token usage). When enabled, logs are emitted for all publisher-model traffic on the model -- Provisioned Throughput and on-demand alike. This is distinct from `logging_config` above: that one logs raw request/response payloads to a BigQuery table, while this one controls structured per-request metadata in Cloud Logging." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelConfig" }, "GoogleCloudAiplatformV1beta1FeatureViewIndexConfig": { "properties": { "embeddingColumn": { "description": "Optional. Column of embedding. This column contains the source data to create index for vector search. embedding_column must be set when using vector search.", "type": "string" }, "crowdingColumn": { "description": "Optional. Column of crowding. This column contains crowding attribute which is a constraint on a neighbor list produced by FeatureOnlineStoreService.SearchNearestEntities to diversify search results. If NearestNeighborQuery.per_crowding_attribute_neighbor_count is set to K in SearchNearestEntitiesRequest, it's guaranteed that no more than K entities of the same crowding attribute are returned in the response.", "type": "string" }, "bruteForceConfig": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigBruteForceConfig", "description": "Optional. Configuration options for using brute force search, which simply implements the standard linear search in the database for each query. It is primarily meant for benchmarking and to generate the ground truth for approximate search." }, "treeAhConfig": { "description": "Optional. Configuration options for the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396", "$ref": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigTreeAHConfig" }, "filterColumns": { "description": "Optional. Columns of features that're used to filter vector search results.", "items": { "type": "string" }, "type": "array" }, "distanceMeasureType": { "description": "Optional. The distance measure used in nearest neighbor search.", "enumDescriptions": [ "Should not be set.", "Euclidean (L_2) Distance.", "Cosine Distance. Defined as 1 - cosine similarity. We strongly suggest using DOT_PRODUCT_DISTANCE + UNIT_L2_NORM instead of COSINE distance. Our algorithms have been more optimized for DOT_PRODUCT distance which, when combined with UNIT_L2_NORM, is mathematically equivalent to COSINE distance and results in the same ranking.", "Dot Product Distance. Defined as a negative of the dot product." ], "type": "string", "enum": [ "DISTANCE_MEASURE_TYPE_UNSPECIFIED", "SQUARED_L2_DISTANCE", "COSINE_DISTANCE", "DOT_PRODUCT_DISTANCE" ] }, "embeddingDimension": { "format": "int32", "type": "integer", "description": "Optional. The number of dimensions of the input embedding." } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfig", "description": "Configuration for vector indexing.", "type": "object" }, "GoogleCloudAiplatformV1beta1RebootPersistentResourceRequest": { "description": "Request message for PersistentResourceService.RebootPersistentResource.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RebootPersistentResourceRequest", "properties": {} }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecIntValueCondition": { "type": "object", "properties": { "values": { "type": "array", "items": { "type": "string", "format": "int64" }, "description": "Required. Matches values of the parent parameter of 'INTEGER' type. All values must lie in `integer_value_spec` of parent parameter." } }, "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecConditionalParameterSpecIntValueCondition", "description": "Represents the spec to match integer values from parent parameter." }, "GenaiVertexV1beta1EnvironmentConfigSource": { "type": "object", "id": "GenaiVertexV1beta1EnvironmentConfigSource", "description": "A source to be mounted into the environment.", "properties": { "target": { "type": "string", "description": "Where the source should appear in the environment." }, "source": { "type": "string", "description": "The source of the environment. For Cloud Storage, this is the Cloud Storage path. For GitHub, this is the GitHub path." }, "encoding": { "description": "Optional encoding for inline content (e.g. `base64`).", "type": "string" }, "content": { "description": "The inline content if `type` is `INLINE`.", "type": "string" }, "type": { "type": "string", "enumDescriptions": [ "", "A Cloud Storage bucket.", "Inline content.", "A generic repository. The protocol prefix in the source URL identifies the provider (e.g., github://, gcs://).", "A skill resource from the Skill Registry Service. Skill: projects/{project}/locations/{location}/skills/{skill} SkillRevision: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Support mounting all skills under a project: projects/{project}/locations/{location}/skills." ], "enum": [ "TYPE_UNSPECIFIED", "GCS", "INLINE", "REPOSITORY", "SKILL_REGISTRY" ] } } }, "GoogleCloudAiplatformV1beta1BatchCancelPipelineJobsRequest": { "id": "GoogleCloudAiplatformV1beta1BatchCancelPipelineJobsRequest", "properties": { "names": { "items": { "type": "string" }, "type": "array", "description": "Required. The names of the PipelineJobs to cancel. A maximum of 32 PipelineJobs can be cancelled in a batch. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipelineJob}`" } }, "type": "object", "description": "Request message for PipelineService.BatchCancelPipelineJobs." }, "GenaiVertexV1beta1GoogleSearchResultStepGoogleSearchResultItem": { "description": "The result of the Google Search.", "properties": { "searchSuggestions": { "description": "Web content snippet that can be embedded in a web page or an app webview.", "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1GoogleSearchResultStepGoogleSearchResultItem" }, "GoogleCloudAiplatformV1beta1ExportDataConfig": { "description": "Describes what part of the Dataset is to be exported, the destination of the export and how to export.", "properties": { "gcsDestination": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "The Google Cloud Storage location where the output is to be written to. In the given directory a new directory will be created with name: `export-data--` where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. All export output will be written into that directory. Inside that directory, annotations with the same schema will be grouped into sub directories which are named with the corresponding annotations' schema title. Inside these sub directories, a schema.yaml will be created to describe the output format." }, "fractionSplit": { "description": "Split based on fractions defining the size of each set.", "$ref": "GoogleCloudAiplatformV1beta1ExportFractionSplit" }, "annotationsFilter": { "description": "An expression for filtering what part of the Dataset is to be exported. Only Annotations that match this filter will be exported. The filter syntax is the same as in ListAnnotations.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExportDataConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionViewRestApi": { "properties": { "documentations": { "description": "Required.", "items": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelDocumentation" }, "type": "array" }, "title": { "type": "string", "description": "Required. The title of the view rest API." } }, "type": "object", "description": "Rest API docs.", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionViewRestApi" }, "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailContainerDetail": { "id": "GoogleCloudAiplatformV1beta1PipelineTaskExecutorDetailContainerDetail", "properties": { "mainJob": { "type": "string", "description": "Output only. The name of the CustomJob for the main container execution.", "readOnly": true }, "failedPreCachingCheckJobs": { "type": "array", "description": "Output only. The names of the previously failed CustomJob for the pre-caching-check container executions. This job will be available if the PipelineJob.pipeline_spec specifies the `pre_caching_check` hook in the lifecycle events. The list includes the all attempts in chronological order.", "items": { "type": "string" }, "readOnly": true }, "preCachingCheckJob": { "type": "string", "readOnly": true, "description": "Output only. The name of the CustomJob for the pre-caching-check container execution. This job will be available if the PipelineJob.pipeline_spec specifies the `pre_caching_check` hook in the lifecycle events." }, "failedMainJobs": { "readOnly": true, "type": "array", "items": { "type": "string" }, "description": "Output only. The names of the previously failed CustomJob for the main container executions. The list includes the all attempts in chronological order." } }, "description": "The detail of a container execution. It contains the job names of the lifecycle of a container execution.", "type": "object" }, "GoogleCloudAiplatformV1beta1UpdateDeploymentResourcePoolOperationMetadata": { "description": "Runtime operation information for UpdateDeploymentResourcePool method.", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "id": "GoogleCloudAiplatformV1beta1UpdateDeploymentResourcePoolOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1RawPredictRequest": { "properties": { "httpBody": { "description": "The prediction input. Supports HTTP headers and arbitrary data payload. A DeployedModel may have an upper limit on the number of instances it supports per request. When this limit it is exceeded for an AutoML model, the RawPredict method returns an error. When this limit is exceeded for a custom-trained model, the behavior varies depending on the model. You can specify the schema for each instance in the predict_schemata.instance_schema_uri field when you create a Model. This schema applies when you deploy the `Model` as a `DeployedModel` to an Endpoint and use the `RawPredict` method.", "$ref": "GoogleApiHttpBody" } }, "description": "Request message for PredictionService.RawPredict.", "id": "GoogleCloudAiplatformV1beta1RawPredictRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationNumericTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationNumericTransformation", "description": "Training pipeline will perform following transformation functions. * The value converted to float32. * The z_score of the value. * log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * z_score of log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * A boolean value that indicates whether the value is valid.", "properties": { "columnName": { "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FunctionResponsePart": { "description": "A datatype containing media that is part of a `FunctionResponse` message. A `FunctionResponsePart` consists of data which has an associated datatype. A `FunctionResponsePart` can only contain one of the accepted types in `FunctionResponsePart.data`. A `FunctionResponsePart` must have a fixed IANA MIME type identifying the type and subtype of the media if the `inline_data` field is filled with raw bytes.", "properties": { "inlineData": { "description": "Inline media bytes.", "$ref": "GoogleCloudAiplatformV1beta1FunctionResponseBlob" }, "fileData": { "description": "URI based data.", "$ref": "GoogleCloudAiplatformV1beta1FunctionResponseFileData" } }, "id": "GoogleCloudAiplatformV1beta1FunctionResponsePart", "type": "object" }, "GoogleCloudAiplatformV1beta1TimestampSplit": { "description": "Assigns input data to training, validation, and test sets based on a provided timestamps. The youngest data pieces are assigned to training set, next to validation set, and the oldest to the test set. Supported only for tabular Datasets.", "properties": { "testFraction": { "description": "The fraction of the input data that is to be used to evaluate the Model.", "format": "double", "type": "number" }, "validationFraction": { "type": "number", "description": "The fraction of the input data that is to be used to validate the Model.", "format": "double" }, "key": { "type": "string", "description": "Required. The key is a name of one of the Dataset's data columns. The values of the key (the values in the column) must be in RFC 3339 `date-time` format, where `time-offset` = `\"Z\"` (e.g. 1985-04-12T23:20:50.52Z). If for a piece of data the key is not present or has an invalid value, that piece is ignored by the pipeline." }, "trainingFraction": { "type": "number", "description": "The fraction of the input data that is to be used to train the Model.", "format": "double" } }, "id": "GoogleCloudAiplatformV1beta1TimestampSplit", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoObjectTrackingInputs": { "properties": { "modelType": { "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD", "MOBILE_VERSATILE_1", "MOBILE_CORAL_VERSATILE_1", "MOBILE_CORAL_LOW_LATENCY_1", "MOBILE_JETSON_VERSATILE_1", "MOBILE_JETSON_LOW_LATENCY_1" ], "type": "string", "enumDescriptions": [ "Should not be set.", "A model best tailored to be used within Google Cloud, and which c annot be exported. Default.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as a TensorFlow or TensorFlow Lite model and used on a mobile or edge device afterwards.", "A versatile model that is meant to be exported (see ModelService.ExportModel) and used on a Google Coral device.", "A model that trades off quality for low latency, to be exported (see ModelService.ExportModel) and used on a Google Coral device.", "A versatile model that is meant to be exported (see ModelService.ExportModel) and used on an NVIDIA Jetson device.", "A model that trades off quality for low latency, to be exported (see ModelService.ExportModel) and used on an NVIDIA Jetson device." ] } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoObjectTrackingInputs" }, "GenaiVertexV1beta1FileSearch": { "properties": { "fileSearchStoreNames": { "description": "The file search store names to search.", "type": "array", "items": { "type": "string" } }, "metadataFilter": { "type": "string", "description": "Metadata filter to apply to the semantic retrieval documents and chunks." }, "topK": { "format": "int32", "description": "The number of semantic retrieval chunks to retrieve.", "type": "integer" } }, "id": "GenaiVertexV1beta1FileSearch", "type": "object", "description": "A tool that can be used by the model to search files." }, "GoogleCloudAiplatformV1beta1GroundednessResult": { "properties": { "score": { "format": "float", "readOnly": true, "description": "Output only. Groundedness score.", "type": "number" }, "confidence": { "format": "float", "type": "number", "readOnly": true, "description": "Output only. Confidence for groundedness score." }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for groundedness score." } }, "description": "Spec for groundedness result.", "type": "object", "id": "GoogleCloudAiplatformV1beta1GroundednessResult" }, "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManual": { "properties": { "targets": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManualTarget" }, "type": "array", "description": "A list of traffic targets for the Runtimes Revisions. The sum of percentages must equal to 100." } }, "type": "object", "description": "Manual traffic distribution configuration, where the user specifies the Runtime Revision IDs and the percentage of traffic to send to each.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineTrafficConfigTrafficSplitManual" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTimeSeriesForecastingPredictionResult": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTimeSeriesForecastingPredictionResult", "properties": { "value": { "type": "number", "format": "float", "description": "The regression value." }, "quantilePredictions": { "type": "array", "items": { "type": "number", "format": "float" }, "description": "Quantile predictions, in 1-1 correspondence with quantile_values." }, "tftFeatureImportance": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTftFeatureImportance", "description": "Only use these if TFt is enabled." }, "quantileValues": { "items": { "type": "number", "format": "float" }, "description": "Quantile values.", "type": "array" } }, "description": "Prediction output format for Time Series Forecasting." }, "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataBigQuerySource": { "properties": { "uri": { "type": "string", "description": "The URI of a BigQuery table. e.g. bq://projectId.bqDatasetId.bqTableId" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTablesDatasetMetadataBigQuerySource", "type": "object" }, "GoogleCloudAiplatformV1beta1BatchMigrateResourcesOperationMetadata": { "properties": { "partialResults": { "description": "Partial results that reflect the latest migration operation progress.", "items": { "$ref": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesOperationMetadataPartialResult" }, "type": "array" }, "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "description": "Runtime operation information for MigrationService.BatchMigrateResources.", "id": "GoogleCloudAiplatformV1beta1BatchMigrateResourcesOperationMetadata" }, "GenaiVertexV1beta1GoogleSearchCallContentGoogleSearchCallArguments": { "id": "GenaiVertexV1beta1GoogleSearchCallContentGoogleSearchCallArguments", "description": "The arguments to pass to Google Search.", "type": "object", "properties": { "queries": { "description": "Web search queries for the following-up web search.", "type": "array", "items": { "type": "string" } } } }, "GoogleCloudAiplatformV1beta1ListFeatureOnlineStoresResponse": { "description": "Response message for FeatureOnlineStoreAdminService.ListFeatureOnlineStores.", "id": "GoogleCloudAiplatformV1beta1ListFeatureOnlineStoresResponse", "properties": { "featureOnlineStores": { "type": "array", "description": "The FeatureOnlineStores matching the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStore" } }, "nextPageToken": { "description": "A token, which can be sent as ListFeatureOnlineStoresRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListDataItemsResponse": { "description": "Response message for DatasetService.ListDataItems.", "id": "GoogleCloudAiplatformV1beta1ListDataItemsResponse", "type": "object", "properties": { "dataItems": { "items": { "$ref": "GoogleCloudAiplatformV1beta1DataItem" }, "description": "A list of DataItems that matches the specified filter in the request.", "type": "array" }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInstance": { "type": "object", "properties": { "reference": { "description": "Optional. Ground truth used to compare against the prediction.", "type": "string" }, "prediction": { "description": "Required. Output of the evaluated model.", "type": "string" }, "context": { "type": "string", "description": "Optional. Text provided as context to answer the question." }, "instruction": { "type": "string", "description": "Required. The question asked and other instruction in the inference prompt." } }, "description": "Spec for question answering relevance instance.", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceInstance" }, "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentsResponse": { "description": "Response message for SandboxEnvironmentService.ListSandboxEnvironments.", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListSandboxEnvironmentsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages." }, "sandboxEnvironments": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "description": "The SandboxEnvironments matching the request." } }, "id": "GoogleCloudAiplatformV1beta1ListSandboxEnvironmentsResponse", "type": "object" }, "GenaiVertexV1beta1CodeMenderAgentConfigFixRequest": { "type": "object", "properties": { "sourceFiles": { "items": { "$ref": "GenaiVertexV1beta1CodeMenderAgentConfigFileContent" }, "description": "A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.", "type": "array" }, "findingId": { "description": "The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.", "type": "string" }, "description": { "description": "Additional context or custom instructions provided by the user to guide the patch generation process.", "type": "string" } }, "description": "Request parameters specific to FIX sessions, used for generating and validating security patches.", "id": "GenaiVertexV1beta1CodeMenderAgentConfigFixRequest" }, "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsRequest": { "type": "object", "description": "Request message for EvaluationService.GenerateInstanceRubrics.", "properties": { "rubricGenerationSpec": { "description": "Optional. Specification for how the rubrics should be generated.", "$ref": "GoogleCloudAiplatformV1beta1RubricGenerationSpec" }, "contents": { "description": "Required. The prompt to generate rubrics from. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" } }, "predefinedRubricGenerationSpec": { "$ref": "GoogleCloudAiplatformV1beta1PredefinedMetricSpec", "description": "Optional. Specification for using the rubric generation configs of a pre-defined metric, e.g. \"generic_quality_v1\" and \"instruction_following_v1\". Some of the configs may be only used in rubric generation and not supporting evaluation, e.g. \"fully_customized_generic_quality_v1\". If this field is set, the `rubric_generation_spec` field will be ignored." }, "agentConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentConfig", "description": "Optional. Agent configuration, required for agent-based rubric generation." }, "location": { "description": "Required. The resource name of the Location to generate rubrics from. Format: `projects/{project}/locations/{location}`", "type": "string" }, "metricResourceName": { "type": "string", "description": "Optional. The resource name of a registered metric. Rubric generation using predefined metric spec or LLMBasedMetricSpec is supported. If this field is set, the configuration provided in this field is used for rubric generation. The `predefined_rubric_generation_spec` and `rubric_generation_spec` fields will be ignored." } }, "id": "GoogleCloudAiplatformV1beta1GenerateInstanceRubricsRequest" }, "GoogleCloudAiplatformV1beta1StartNotebookRuntimeRequest": { "id": "GoogleCloudAiplatformV1beta1StartNotebookRuntimeRequest", "description": "Request message for NotebookService.StartNotebookRuntime.", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1ListModelMonitorsResponse": { "description": "Response message for ModelMonitoringService.ListModelMonitors", "type": "object", "properties": { "modelMonitors": { "type": "array", "description": "List of ModelMonitor in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitor" } }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListModelMonitorsRequest.page_token to obtain that page." } }, "id": "GoogleCloudAiplatformV1beta1ListModelMonitorsResponse" }, "GoogleCloudAiplatformV1beta1PredictLongRunningMetadata": { "id": "GoogleCloudAiplatformV1beta1PredictLongRunningMetadata", "properties": {}, "type": "object", "description": "Metadata for PredictLongRunning long running operations." }, "GoogleCloudAiplatformV1beta1NotebookIdleShutdownConfig": { "properties": { "idleTimeout": { "type": "string", "format": "google-duration", "description": "Required. Duration is accurate to the second. In Notebook, Idle Timeout is accurate to minute so the range of idle_timeout (second) is: 10 * 60 ~ 1440 * 60." }, "idleShutdownDisabled": { "description": "Whether Idle Shutdown is disabled in this NotebookRuntimeTemplate.", "type": "boolean" } }, "description": "The idle shutdown configuration of NotebookRuntimeTemplate, which contains the idle_timeout as required field.", "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookIdleShutdownConfig" }, "GoogleCloudAiplatformV1beta1RubricContent": { "description": "Content of the rubric, defining the testable criteria.", "properties": { "property": { "description": "Evaluation criteria based on a specific property.", "$ref": "GoogleCloudAiplatformV1beta1RubricContentProperty" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RubricContent" }, "GoogleCloudAiplatformV1beta1PurgeContextsRequest": { "id": "GoogleCloudAiplatformV1beta1PurgeContextsRequest", "properties": { "filter": { "description": "Required. A required filter matching the Contexts to be purged. E.g., `update_time \u003c= 2020-11-19T11:30:00-04:00`.", "type": "string" }, "force": { "description": "Optional. Flag to indicate to actually perform the purge. If `force` is set to false, the method will return a sample of Context names that would be deleted.", "type": "boolean" } }, "description": "Request message for MetadataService.PurgeContexts.", "type": "object" }, "GoogleCloudAiplatformV1beta1RecommendSpecRequest": { "properties": { "checkUserQuota": { "description": "Optional. If true, check user quota for the recommended regions. Returns all the machine spec in regions they are available, and also the user quota state for each machine type in each region.", "type": "boolean" }, "gcsUri": { "description": "Required. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).", "type": "string" }, "checkMachineAvailability": { "description": "Optional. If true, check machine availability for the recommended regions. Only return the machine spec in regions where the machine is available.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1RecommendSpecRequest", "description": "Request message for ModelService.RecommendSpec.", "type": "object" }, "GoogleCloudAiplatformV1beta1RagCorpus": { "type": "object", "properties": { "displayName": { "type": "string", "description": "Required. The display name of the RagCorpus. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "ragVectorDbConfig": { "description": "Optional. Immutable. The Vector DB config of the RagCorpus.", "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfig" }, "ragFilesCount": { "type": "integer", "format": "int32", "readOnly": true, "description": "Output only. Number of RagFiles in the RagCorpus. NOTE: This field is not populated in the response of VertexRagDataService.ListRagCorpora." }, "corpusStatus": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1CorpusStatus", "description": "Output only. RagCorpus state." }, "name": { "readOnly": true, "description": "Output only. The resource name of the RagCorpus.", "type": "string" }, "description": { "type": "string", "description": "Optional. The description of the RagCorpus." }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this RagCorpus was created." }, "vectorDbConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagVectorDbConfig", "description": "Optional. Immutable. The config for the Vector DBs." }, "vertexAiSearchConfig": { "description": "Optional. Immutable. The config for the Vertex AI Search.", "$ref": "GoogleCloudAiplatformV1beta1VertexAiSearchConfig" }, "satisfiesPzs": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "updateTime": { "description": "Output only. Timestamp when this RagCorpus was last updated.", "type": "string", "format": "google-datetime", "readOnly": true }, "corpusTypeConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfig", "description": "Optional. The corpus type config of the RagCorpus." }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "type": "boolean", "readOnly": true }, "ragEmbeddingModelConfig": { "description": "Optional. Immutable. The embedding model config of the RagCorpus.", "deprecated": true, "$ref": "GoogleCloudAiplatformV1beta1RagEmbeddingModelConfig" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Optional. Immutable. The CMEK key name used to encrypt at-rest data related to this Corpus. Only applicable to RagManagedDb option for Vector DB. This field can only be set at corpus creation time, and cannot be updated or deleted." } }, "id": "GoogleCloudAiplatformV1beta1RagCorpus", "description": "A RagCorpus is a RagFile container and a project can have multiple RagCorpora." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesMetadata": { "description": "Model metadata specific to AutoML Tables.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesMetadata", "type": "object", "properties": { "trainCostMilliNodeHours": { "description": "Output only. The actual training cost of the model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed the train budget.", "format": "int64", "type": "string" }, "evaluatedDataItemsBigqueryUri": { "description": "BigQuery destination uri for exported evaluated examples.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModalityTokenCount": { "id": "GoogleCloudAiplatformV1beta1ModalityTokenCount", "type": "object", "properties": { "tokenCount": { "format": "int32", "type": "integer", "description": "The number of tokens counted for this modality." }, "modality": { "enum": [ "MODALITY_UNSPECIFIED", "TEXT", "IMAGE", "VIDEO", "AUDIO", "DOCUMENT" ], "type": "string", "description": "The modality that this token count applies to.", "enumDescriptions": [ "When a modality is not specified, it is treated as `TEXT`.", "The `Part` contains plain text.", "The `Part` contains an image.", "The `Part` contains a video.", "The `Part` contains audio.", "The `Part` contains a document, such as a PDF." ] } }, "description": "Represents a breakdown of token usage by modality. This message is used in CountTokensResponse and GenerateContentResponse.UsageMetadata to provide a detailed view of how many tokens are used by each modality (e.g., text, image, video) in a request. This is particularly useful for multimodal models, allowing you to track and manage token consumption for billing and quota purposes." }, "GoogleCloudAiplatformV1beta1Event": { "id": "GoogleCloudAiplatformV1beta1Event", "properties": { "artifact": { "description": "Required. The relative resource name of the Artifact in the Event.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "The labels with user-defined metadata to annotate Events. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Event (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable." }, "type": { "type": "string", "enum": [ "TYPE_UNSPECIFIED", "INPUT", "OUTPUT" ], "enumDescriptions": [ "Unspecified whether input or output of the Execution.", "An input of the Execution.", "An output of the Execution." ], "description": "Required. The type of the Event." }, "execution": { "type": "string", "description": "Output only. The relative resource name of the Execution in the Event.", "readOnly": true }, "eventTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Time the Event occurred." } }, "description": "An edge describing the relationship between an Artifact and an Execution in a lineage graph.", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchFeaturesResponse": { "description": "Response message for FeaturestoreService.SearchFeatures.", "id": "GoogleCloudAiplatformV1beta1SearchFeaturesResponse", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as SearchFeaturesRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "features": { "type": "array", "description": "The Features matching the request. Fields returned: * `name` * `description` * `labels` * `create_time` * `update_time`", "items": { "$ref": "GoogleCloudAiplatformV1beta1Feature" } } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewDataKeyCompositeKey": { "description": "ID that is comprised from several parts (columns).", "type": "object", "properties": { "parts": { "items": { "type": "string" }, "description": "Parts to construct Entity ID. Should match with the same ID columns as defined in FeatureView in the same order.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewDataKeyCompositeKey" }, "GoogleCloudAiplatformV1beta1ExportModelOperationMetadataOutputInfo": { "type": "object", "description": "Further describes the output of the ExportModel. Supplements ExportModelRequest.OutputConfig.", "id": "GoogleCloudAiplatformV1beta1ExportModelOperationMetadataOutputInfo", "properties": { "artifactOutputUri": { "description": "Output only. If the Model artifact is being exported to Google Cloud Storage this is the full path of the directory created, into which the Model files are being written to.", "readOnly": true, "type": "string" }, "imageOutputUri": { "description": "Output only. If the Model image is being exported to Google Container Registry or Artifact Registry this is the full path of the image created.", "readOnly": true, "type": "string" } } }, "CloudAiLargeModelsVisionPromptInputs": { "properties": { "negativePrompt": { "type": "string", "description": "Single negative prompt for what not to generate." }, "promptChunks": { "description": "2s, 256 tokens per chunk, 4 total chunks. Required.", "items": { "type": "string" }, "type": "array" }, "transcript": { "type": "string", "description": "Spoken transcript of the video for characters." }, "audioPrompt": { "type": "string", "description": "Description of audio content in the video, without speech." }, "negativeAudioPrompt": { "description": "Negative description of audio content in the video.", "type": "string" } }, "type": "object", "id": "CloudAiLargeModelsVisionPromptInputs", "description": "\"Direct\" prompting for Experimental Video Generation. These will be sent directly to the LDM without being rewritten." }, "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeRequest": { "description": "Request message for NotebookService.AssignNotebookRuntime.", "properties": { "notebookRuntimeId": { "description": "Optional. User specified ID for the notebook runtime.", "type": "string" }, "notebookRuntime": { "description": "Required. Provide runtime specific information (e.g. runtime owner, notebook id) used for NotebookRuntime assignment.", "$ref": "GoogleCloudAiplatformV1beta1NotebookRuntime" }, "notebookRuntimeTemplate": { "description": "Required. The resource name of the NotebookRuntimeTemplate based on which a NotebookRuntime will be assigned (reuse or create a new one).", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AssignNotebookRuntimeRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1FilterSplit": { "type": "object", "id": "GoogleCloudAiplatformV1beta1FilterSplit", "description": "Assigns input data to training, validation, and test sets based on the given filters, data pieces not matched by any filter are ignored. Currently only supported for Datasets containing DataItems. If any of the filters in this message are to match nothing, then they can be set as '-' (the minus sign). Supported only for unstructured Datasets. ", "properties": { "trainingFilter": { "type": "string", "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to train the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order." }, "validationFilter": { "type": "string", "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to validate the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order." }, "testFilter": { "description": "Required. A filter on DataItems of the Dataset. DataItems that match this filter are used to test the Model. A filter with same syntax as the one used in DatasetService.ListDataItems may be used. If a single DataItem is matched by more than one of the FilterSplit filters, then it is assigned to the first set that applies to it in the training, validation, test order.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelArmorConfig": { "description": "Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks.", "properties": { "responseTemplateName": { "description": "Optional. The resource name of the Model Armor template to use for response screening. A Model Armor template is a set of customized filters and thresholds that define how Model Armor screens content. If specified, Model Armor will use this template to check the model's response for safety and security risks before it is returned to the user. The name must be in the format `projects/{project}/locations/{location}/templates/{template}`.", "type": "string" }, "promptTemplateName": { "type": "string", "description": "Optional. The resource name of the Model Armor template to use for prompt screening. A Model Armor template is a set of customized filters and thresholds that define how Model Armor screens content. If specified, Model Armor will use this template to check the user's prompt for safety and security risks before it is sent to the model. The name must be in the format `projects/{project}/locations/{location}/templates/{template}`." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelArmorConfig" }, "GoogleCloudAiplatformV1beta1AudioTranscription": { "id": "GoogleCloudAiplatformV1beta1AudioTranscription", "properties": { "speakerLabel": { "description": "Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.", "type": "string" }, "words": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1AudioTranscriptionWordInfo" }, "description": "Optional. Detailed word-level transcriptions and timing details. Present when `word_timestamp` is set." }, "text": { "type": "string", "description": "Required. The transcription text of this audio segment." } }, "type": "object", "description": "The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`." }, "GoogleCloudAiplatformV1beta1StudySpecMetricSpecSafetyMetricConfig": { "id": "GoogleCloudAiplatformV1beta1StudySpecMetricSpecSafetyMetricConfig", "type": "object", "properties": { "safetyThreshold": { "type": "number", "description": "Safety threshold (boundary value between safe and unsafe). NOTE that if you leave SafetyMetricConfig unset, a default value of 0 will be used.", "format": "double" }, "desiredMinSafeTrialsFraction": { "type": "number", "format": "double", "description": "Desired minimum fraction of safe trials (over total number of trials) that should be targeted by the algorithm at any time during the study (best effort). This should be between 0.0 and 1.0 and a value of 0.0 means that there is no minimum and an algorithm proceeds without targeting any specific fraction. A value of 1.0 means that the algorithm attempts to only Suggest safe Trials." } }, "description": "Used in safe optimization to specify threshold levels and risk tolerance." }, "GoogleCloudAiplatformV1beta1TrainingConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TrainingConfig", "properties": { "timeoutTrainingMilliHours": { "description": "The timeout hours for the CMLE training job, expressed in milli hours i.e. 1,000 value in this field means 1 hour.", "type": "string", "format": "int64" } }, "description": "CMLE training config. For every active learning labeling iteration, system will train a machine learning model on CMLE. The trained model will be used by data sampling algorithm to select DataItems." }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetrics": { "description": "UNIMPLEMENTED. Track matching model metrics for a single track match threshold and multiple label match confidence thresholds.", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetrics", "properties": { "meanBoundingBoxIou": { "type": "number", "description": "The mean bounding box iou over all confidence thresholds.", "format": "float" }, "meanMismatchRate": { "type": "number", "description": "The mean mismatch rate over all confidence thresholds.", "format": "float" }, "iouThreshold": { "description": "The intersection-over-union threshold value between bounding boxes across frames used to compute this metric entry.", "type": "number", "format": "float" }, "confidenceMetrics": { "type": "array", "description": "Metrics for each label-match `confidenceThreshold` from 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99. Precision-recall curve is derived from them.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsTrackMetricsConfidenceMetrics" } }, "meanTrackingAveragePrecision": { "type": "number", "description": "The mean average precision over all confidence thresholds.", "format": "float" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1IntegratedGradientsAttribution": { "description": "An attribution method that computes the Aumann-Shapley value taking advantage of the model's fully differentiable structure. Refer to this paper for more details: https://arxiv.org/abs/1703.01365", "properties": { "stepCount": { "type": "integer", "description": "Required. The number of steps for approximating the path integral. A good value to start is 50 and gradually increase until the sum to diff property is within the desired error range. Valid range of its value is [1, 100], inclusively.", "format": "int32" }, "smoothGradConfig": { "$ref": "GoogleCloudAiplatformV1beta1SmoothGradConfig", "description": "Config for SmoothGrad approximation of gradients. When enabled, the gradients are approximated by averaging the gradients from noisy samples in the vicinity of the inputs. Adding noise can help improve the computed gradients. Refer to this paper for more details: https://arxiv.org/pdf/1706.03825.pdf" }, "blurBaselineConfig": { "description": "Config for IG with blur baseline. When enabled, a linear path from the maximally blurred image to the input image is created. Using a blurred baseline instead of zero (black image) is motivated by the BlurIG approach explained here: https://arxiv.org/abs/2004.03383", "$ref": "GoogleCloudAiplatformV1beta1BlurBaselineConfig" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1IntegratedGradientsAttribution" }, "GoogleCloudAiplatformV1beta1SafetyInput": { "type": "object", "description": "Input for safety metric.", "properties": { "instance": { "description": "Required. Safety instance.", "$ref": "GoogleCloudAiplatformV1beta1SafetyInstance" }, "metricSpec": { "description": "Required. Spec for safety metric.", "$ref": "GoogleCloudAiplatformV1beta1SafetySpec" } }, "id": "GoogleCloudAiplatformV1beta1SafetyInput" }, "GoogleCloudAiplatformV1beta1Probe": { "id": "GoogleCloudAiplatformV1beta1Probe", "description": "Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.", "properties": { "timeoutSeconds": { "type": "integer", "format": "int32", "description": "Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. Must be greater or equal to period_seconds. Maps to Kubernetes probe argument 'timeoutSeconds'." }, "grpc": { "description": "GrpcAction probes the health of a container by sending a gRPC request.", "$ref": "GoogleCloudAiplatformV1beta1ProbeGrpcAction" }, "tcpSocket": { "$ref": "GoogleCloudAiplatformV1beta1ProbeTcpSocketAction", "description": "TcpSocketAction probes the health of a container by opening a TCP socket connection." }, "initialDelaySeconds": { "description": "Number of seconds to wait before starting the probe. Defaults to 0. Minimum value is 0. Maps to Kubernetes probe argument 'initialDelaySeconds'.", "format": "int32", "type": "integer" }, "successThreshold": { "format": "int32", "description": "Number of consecutive successes before the probe is considered successful. Defaults to 1. Minimum value is 1. Maps to Kubernetes probe argument 'successThreshold'.", "type": "integer" }, "failureThreshold": { "description": "Number of consecutive failures before the probe is considered failed. Defaults to 3. Minimum value is 1. Maps to Kubernetes probe argument 'failureThreshold'.", "format": "int32", "type": "integer" }, "exec": { "description": "ExecAction probes the health of a container by executing a command.", "$ref": "GoogleCloudAiplatformV1beta1ProbeExecAction" }, "periodSeconds": { "type": "integer", "format": "int32", "description": "How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1. Must be less than timeout_seconds. Maps to Kubernetes probe argument 'periodSeconds'." }, "httpGet": { "$ref": "GoogleCloudAiplatformV1beta1ProbeHttpGetAction", "description": "HttpGetAction probes the health of a container by sending an HTTP GET request." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDiscreteValueSpec": { "description": "Value specification for a parameter in `DISCRETE` type.", "type": "object", "properties": { "values": { "description": "Required. A list of possible values. The list should be in increasing order and at least 1e-10 apart. For instance, this parameter might have possible settings of 1.5, 2.5, and 4.0. This list should not contain more than 1,000 values.", "type": "array", "items": { "type": "number", "format": "double" } }, "defaultValue": { "format": "double", "description": "A default value for a `DISCRETE` parameter that is assumed to be a relatively good starting point. Unset value signals that there is no offered starting point. It automatically rounds to the nearest feasible discrete point. Currently only supported by the Vertex AI Vizier service. Not supported by HyperparameterTuningJob or TrainingPipeline.", "type": "number" } }, "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecDiscreteValueSpec" }, "GoogleCloudAiplatformV1beta1BleuMetricValue": { "id": "GoogleCloudAiplatformV1beta1BleuMetricValue", "properties": { "score": { "format": "float", "readOnly": true, "type": "number", "description": "Output only. Bleu score." } }, "description": "Bleu metric value for an instance.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolylineAnnotation": { "type": "object", "description": "Represents a polyline in image.", "properties": { "displayName": { "type": "string", "description": "The display name of the AnnotationSpec that this Annotation pertains to." }, "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." }, "vertexes": { "description": "The vertexes are connected one by one and the last vertex in not connected to the first one.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaVertex" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationPolylineAnnotation" }, "GoogleCloudAiplatformV1beta1TFRecordDestination": { "id": "GoogleCloudAiplatformV1beta1TFRecordDestination", "type": "object", "properties": { "gcsDestination": { "description": "Required. Google Cloud Storage location.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" } }, "description": "The storage details for TFRecord output content." }, "GoogleCloudAiplatformV1beta1InternalOsServiceStateInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1InternalOsServiceStateInstance", "properties": { "serviceState": { "type": "string", "enumDescriptions": [ "Health status is unknown: not initialized or failed to retrieve.", "The resource is healthy.", "The resource is unhealthy." ], "description": "Required. internal service state.", "enum": [ "UNKNOWN", "HEALTHY", "UNHEALTHY" ] }, "serviceName": { "enum": [ "INTERNAL_OS_SERVICE_ENUM_UNSPECIFIED", "DOCKER_SERVICE_STATE", "CONTROL_PLANE_API_DNS_STATE", "PROXY_REGISTRATION_DNS_STATE", "JUPYTER_STATE", "JUPYTER_API_STATE", "EUC_METADATA_API_STATE", "EUC_AGENT_API_STATE", "IDLE_SHUTDOWN_AGENT_STATE", "PROXY_AGENT_STATE", "GCR_DNS_STATE", "GUEST_ATTRIBUTE_STATE" ], "description": "Required. internal service name.", "enumDescriptions": [ "Service name unknown.", "Represents the internal os docker client.", "Represents resolving DNS for the control plane api endpoint.", "Represents resolving DNS for the proxy registration endpoint.", "Represents the jupyter endpoint.", "Represents the jupyter/api endpoint.", "Represents the EUC metadata server API endpoint.", "Represents the EUC agent server API endpoint.", "Represents the idle shutdown agent sidecar container.", "Represents the proxy agent sidecar container.", "Represents resolving DNS for the gcr.io endpoint.", "Represents if the guest attribute service is enabled." ], "type": "string" } }, "description": "Request message for [InternalOsServiceStateInstance]." }, "GoogleCloudAiplatformV1beta1ReinforcementTuningUserDatasetExamples": { "properties": { "userDatasetExamples": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningExample" }, "type": "array", "description": "List of user datasset examples showing to user." } }, "type": "object", "description": "Sample reinforcement tuning user data in the training dataset. The contents are truncated for better UI showing.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningUserDatasetExamples" }, "GenaiVertexV1beta1InteractionCompletedSseEvent": { "properties": { "interaction": { "description": "Required. Partial completed interaction resource emitted at the end of the stream.", "$ref": "GenaiVertexV1beta1Interaction" } }, "id": "GenaiVertexV1beta1InteractionCompletedSseEvent", "description": "Signals that the Interaction completed. Sent when the Interaction receives Complete/Cancel or naturally terminates. No more input can be sent to the Interaction after this.", "type": "object" }, "GoogleCloudAiplatformV1beta1FulfillmentResult": { "type": "object", "description": "Spec for fulfillment result.", "properties": { "confidence": { "type": "number", "readOnly": true, "description": "Output only. Confidence for fulfillment score.", "format": "float" }, "score": { "format": "float", "description": "Output only. Fulfillment score.", "type": "number", "readOnly": true }, "explanation": { "readOnly": true, "description": "Output only. Explanation for fulfillment score.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1FulfillmentResult" }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequest": { "properties": { "dataKeyAndFeatureValues": { "type": "array", "description": "Required. The data keys and associated feature values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequestDataKeyAndFeatureValues" } } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteRequest", "type": "object", "description": "Request message for FeatureOnlineStoreService.FeatureViewDirectWrite." }, "GoogleCloudAiplatformV1beta1ClientConnectionConfig": { "id": "GoogleCloudAiplatformV1beta1ClientConnectionConfig", "description": "Configurations (e.g. inference timeout) that are applied on your endpoints.", "type": "object", "properties": { "inferenceTimeout": { "format": "google-duration", "type": "string", "description": "Customizable online prediction request timeout." } } }, "GenaiVertexV1beta1ServerToolResultDelta": { "type": "object", "id": "GenaiVertexV1beta1ServerToolResultDelta", "properties": { "googleMapsResult": { "$ref": "GenaiVertexV1beta1GoogleMapsResultDelta" }, "mcpServerToolResult": { "$ref": "GenaiVertexV1beta1McpServerToolResultDelta" }, "fileSearchResult": { "$ref": "GenaiVertexV1beta1FileSearchResultDelta" }, "processingResult": { "$ref": "GenaiVertexV1beta1ProcessingResultDelta" }, "retrievalResult": { "$ref": "GenaiVertexV1beta1RetrievalResultDelta" }, "urlContextResult": { "$ref": "GenaiVertexV1beta1UrlContextResultDelta" }, "codeExecutionResult": { "$ref": "GenaiVertexV1beta1CodeExecutionResultDelta" }, "googleSearchResult": { "$ref": "GenaiVertexV1beta1GoogleSearchResultDelta" }, "signature": { "type": "string", "format": "byte", "description": "A signature hash for backend validation." } } }, "GoogleCloudAiplatformV1beta1A2ATaskRecordEventData": { "description": "The data describing the change carried by an A2ATaskRecordEvent. Multiple changes can be set in a single event.", "properties": { "historyAppend": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordHistoryAppend", "description": "Optional. A new message appended to the task history." }, "artifactChange": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifactChange", "description": "Optional. A change to one of the task's artifacts." }, "statusUpdate": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordStatusUpdate", "description": "Optional. An update to the task's state and status message." }, "metadataChange": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordMetadataChange", "description": "Optional. A change to the task-level metadata." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordEventData" }, "CloudAiLargeModelsVisionNamedBoundingBox": { "id": "CloudAiLargeModelsVisionNamedBoundingBox", "type": "object", "properties": { "y2": { "format": "float", "type": "number" }, "classes": { "items": { "type": "string" }, "type": "array" }, "x1": { "format": "float", "type": "number" }, "x2": { "type": "number", "format": "float" }, "y1": { "format": "float", "type": "number" }, "entities": { "items": { "type": "string" }, "type": "array" }, "scores": { "type": "array", "items": { "type": "number", "format": "float" } } } }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsClassificationEvaluationMetrics": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsClassificationEvaluationMetrics", "properties": { "auPrc": { "format": "float", "description": "The Area Under Precision-Recall Curve metric. Micro-averaged for the overall evaluation.", "type": "number" }, "auRoc": { "description": "The Area Under Receiver Operating Characteristic curve metric. Micro-averaged for the overall evaluation.", "type": "number", "format": "float" }, "logLoss": { "type": "number", "format": "float", "description": "The Log Loss metric." }, "confidenceMetrics": { "type": "array", "description": "Metrics for each `confidenceThreshold` in 0.00,0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 and `positionThreshold` = INT32_MAX_VALUE. ROC and precision-recall curves, and other aggregated metrics are derived from them. The confidence metrics entries may also be supplied for additional values of `positionThreshold`, but from these no aggregated metrics are computed.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsClassificationEvaluationMetricsConfidenceMetrics" } }, "confusionMatrix": { "description": "Confusion matrix of the evaluation.", "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix" } }, "description": "Metrics for classification evaluation results." }, "CloudAiLargeModelsVisionGenerateVideoRequestImage": { "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoRequestImage", "description": "The image bytes or Cloud Storage URI to make the prediction on.", "properties": { "blobId": { "description": "Blob ID of the image. This is used for storing the large images in the request.", "type": "string" }, "gcsUri": { "type": "string" }, "mimeType": { "type": "string", "description": "The MIME type of the content of the image. Only the images in below listed MIME types are supported. - image/jpeg - image/png" }, "bytesBase64Encoded": { "type": "string", "description": "Base64 encoded bytes string representing the image." } } }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionImageObjectDetectionPredictionResult": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionImageObjectDetectionPredictionResult", "description": "Prediction output format for Image Object Detection.", "properties": { "confidences": { "type": "array", "description": "The Model's confidences in correctness of the predicted IDs, higher value means higher confidence. Order matches the Ids.", "items": { "type": "number", "format": "float" } }, "ids": { "items": { "format": "int64", "type": "string" }, "type": "array", "description": "The resource IDs of the AnnotationSpecs that had been identified, ordered by the confidence score descendingly." }, "bboxes": { "items": { "items": { "type": "any" }, "type": "array" }, "type": "array", "description": "Bounding boxes, i.e. the rectangles over the image, that pinpoint the found AnnotationSpecs. Given in order that matches the IDs. Each bounding box is an array of 4 numbers `xMin`, `xMax`, `yMin`, and `yMax`, which represent the extremal coordinates of the box. They are relative to the image size, and the point 0,0 is in the top left of the image." }, "displayNames": { "type": "array", "items": { "type": "string" }, "description": "The display names of the AnnotationSpecs that had been identified, order matches the IDs." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetails": { "type": "object", "properties": { "type": { "enum": [ "DATA_TYPE_UNSPECIFIED", "INTEGER", "FLOAT", "STRING", "DATETIME", "BOOLEAN", "LIST" ], "enumDescriptions": [ "Unspecified type.", "Integer type.", "Float type.", "String type.", "Supported formats: %Y-%m-%dT%H:%M:%E*S%E*z (absl::RFC3339_full) %Y-%m-%dT%H:%M:%E*S %Y-%m-%dT%H:%M%E*z %Y-%m-%dT%H:%M %Y-%m-%dT%H%E*z %Y-%m-%dT%H %Y-%m-%d%E*z %Y-%m-%d %Y-%m %Y", "Boolean type.", "List type. - Each element in the list must be of the exact same data schema; otherwise, they are invalid arguments. - Elements cannot be another list (no list of list)." ], "type": "string", "description": "Type of the metadata." }, "granularity": { "type": "string", "description": "The granularity associated with this RagMetadataSchema.", "enumDescriptions": [ "Unspecified granularity.", "RagFile-level granularity." ], "enum": [ "GRANULARITY_UNSPECIFIED", "GRANULARITY_FILE_LEVEL" ] }, "listConfig": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsListConfig", "description": "Config for List data type." }, "searchStrategy": { "description": "The search strategy for the metadata value of the `key`.", "$ref": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetailsSearchStrategy" } }, "id": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetails", "description": "Data schema details indicates the data type and the data struct corresponding to the key of user specified metadata." }, "GoogleCloudAiplatformV1beta1IngestionDirectContentsSource": { "properties": { "events": { "description": "Required. The events to ingest.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1IngestionDirectContentsSourceEvent" } } }, "description": "Ingest events directly from the request.", "id": "GoogleCloudAiplatformV1beta1IngestionDirectContentsSource", "type": "object" }, "GoogleCloudAiplatformV1beta1PurgeArtifactsMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1PurgeArtifactsMetadata", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for purging Artifacts." } }, "description": "Details of operations that perform MetadataService.PurgeArtifacts." }, "GoogleCloudAiplatformV1beta1CancelBatchPredictionJobRequest": { "description": "Request message for JobService.CancelBatchPredictionJob.", "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1CancelBatchPredictionJobRequest" }, "GenaiVertexV1beta1TextDelta": { "properties": { "text": { "type": "string" } }, "type": "object", "id": "GenaiVertexV1beta1TextDelta" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSnapshot", "properties": { "owner": { "type": "string", "description": "Optional. Owner information for this sandbox snapshot. Different owners will have isolations on snapshot storage and identity. If not set, snapshot will be created as the default owner." }, "useGkeTd": { "readOnly": true, "type": "boolean", "description": "Output only. Whether the source SandboxEnvironment uses the GKE TD pool." }, "name": { "description": "Identifier. The resource name of the SandboxEnvironmentSnapshot. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`", "type": "string" }, "createTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. The timestamp when this SandboxEnvironmentSnapshot was created." }, "expireTime": { "type": "string", "format": "google-datetime", "description": "Optional. Timestamp in UTC of when this SandboxEnvironmentSnapshot is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input." }, "updateTime": { "type": "string", "readOnly": true, "description": "Output only. The timestamp when this SandboxEnvironment was most recently updated.", "format": "google-datetime" }, "sizeBytes": { "readOnly": true, "type": "string", "description": "Optional. Output only. Size of the snapshot data in bytes.", "format": "int64" }, "ttl": { "type": "string", "format": "google-duration", "description": "Optional. Input only. The TTL for the sandbox environment snapshot. The expiration time is computed: now + TTL." }, "displayName": { "type": "string", "description": "Required. The display name of the SandboxEnvironmentSnapshot." }, "postSnapshotAction": { "enumDescriptions": [ "The default value. This value is unused.", "Sandbox environment will continue to run after snapshot is taken.", "Sandbox environment will be paused after snapshot is taken." ], "description": "Optional. Input only. Action to take on the source SandboxEnvironment after the snapshot is taken. This field is only used in CreateSandboxEnvironmentSnapshotRequest and it is not stored in the resource.", "type": "string", "enum": [ "POST_SNAPSHOT_ACTION_UNSPECIFIED", "RUNNING", "PAUSE" ] }, "sourceSandboxEnvironment": { "type": "string", "description": "Required. The resource name of the source SandboxEnvironment this snapshot was taken from." }, "parentSnapshot": { "description": "Output only. The resource name of the parent SandboxEnvironmentSnapshot. Empty if this is a root Snapshot (the first snapshot from a newly created sandbox). Can be used to reconstruct the whole ancestry tree of snapshots.", "readOnly": true, "type": "string" } }, "description": "SandboxEnvironmentSnapshot is a snapshot of the SandboxEnvironment.", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingDataset": { "properties": { "dataFormat": { "type": "string", "description": "Data format of the dataset, only applicable if the input is from Google Cloud Storage. The possible formats are: \"tf-record\" The source file is a TFRecord file. \"csv\" The source file is a CSV file. \"jsonl\" The source file is a JSONL file." }, "targetField": { "description": "The target field name the model is to predict. This field will be excluded when doing Predict and (or) Explain for the training data.", "type": "string" }, "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1GcsSource", "description": "The Google Cloud Storage uri of the unmanaged Dataset used to train this Model." }, "dataset": { "description": "The resource name of the Dataset used to train this Model.", "type": "string" }, "bigquerySource": { "description": "The BigQuery table of the unmanaged Dataset used to train this Model.", "$ref": "GoogleCloudAiplatformV1beta1BigQuerySource" }, "loggingSamplingStrategy": { "description": "Strategy to sample data from Training Dataset. If not set, we process the whole dataset.", "$ref": "GoogleCloudAiplatformV1beta1SamplingStrategy" } }, "type": "object", "description": "Training Dataset information.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigTrainingDataset" }, "CloudAiLargeModelsVisionGenerateVideoExperimentsVideoTransform": { "type": "object", "id": "CloudAiLargeModelsVisionGenerateVideoExperimentsVideoTransform", "properties": { "initializationVideo": { "description": "Optional. Input for video transform (sdedit, diffdiff). Note the input video from the main GenerateVideoRequest will be used as the conditioning.", "$ref": "CloudAiLargeModelsVisionGenerateVideoRequestVideo" }, "noiseStrength": { "format": "float", "type": "number", "description": "Optional. Noise strength for video transform." }, "mask": { "description": "Optional. Mask for video transform (diffdiff).", "$ref": "CloudAiLargeModelsVisionGenerateVideoRequestVideo" } } }, "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigBigQuerySourceConfig": { "properties": { "tablePath": { "type": "string", "description": "Required. The path to the BigQuery table containing the index data, in the format of `bq://..`." }, "datapointFieldMapping": { "description": "Required. Mapping of datapoint fields to BigQuery column names.", "$ref": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigDatapointFieldMapping" } }, "description": "Configuration for importing data from a BigQuery table.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportIndexRequestConnectorConfigBigQuerySourceConfig" }, "GoogleCloudAiplatformV1beta1CreateSolverOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateSolverOperationMetadata", "type": "object", "description": "Runtime operation information for SolverService.CreateSolver.", "properties": { "genericMetadata": { "description": "The generic operation information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecMultimodalPrompt": { "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecMultimodalPrompt", "type": "object", "properties": { "promptMessage": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPromptMessage", "description": "The prompt message." } }, "description": "Prompt variation that embeds preambles to prompt string." }, "GoogleCloudAiplatformV1beta1StoredContentsExampleFilter": { "description": "The metadata filters that will be used to remove or fetch StoredContentsExamples. If a field is unspecified, then no filtering for that field will be applied.", "properties": { "functionNames": { "$ref": "GoogleCloudAiplatformV1beta1ExamplesArrayFilter", "description": "Optional. The function names for filtering." }, "searchKeys": { "type": "array", "items": { "type": "string" }, "description": "Optional. The search keys for filtering. Only examples with one of the specified search keys (StoredContentsExample.search_key) are eligible to be returned." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1StoredContentsExampleFilter" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecFeatureAttributionSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecFeatureAttributionSpec", "properties": { "featureAlertConditions": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition" }, "type": "object", "description": "Per feature alert condition will override default alert condition." }, "features": { "description": "Feature names interested in monitoring. These should be a subset of the input feature names specified in the monitoring schema. If the field is not specified all features outlied in the monitoring schema will be used.", "items": { "type": "string" }, "type": "array" }, "defaultAlertCondition": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition", "description": "Default alert condition for all the features." }, "batchExplanationDedicatedResources": { "description": "The config of resources used by the Model Monitoring during the batch explanation for non-AutoML models. If not set, `n1-standard-2` machine type will be used by default.", "$ref": "GoogleCloudAiplatformV1beta1BatchDedicatedResources" } }, "description": "Feature attribution monitoring spec." }, "GoogleCloudAiplatformV1beta1GroundingChunk": { "id": "GoogleCloudAiplatformV1beta1GroundingChunk", "type": "object", "properties": { "maps": { "description": "A grounding chunk from Google Maps. See the `Maps` message for details.", "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMaps" }, "image": { "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkImage", "description": "A grounding chunk from an image search result. See the `Image` message for details." }, "web": { "description": "A grounding chunk from a web page, typically from Google Search. See the `Web` message for details.", "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkWeb" }, "retrievedContext": { "$ref": "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext", "description": "A grounding chunk from a data source retrieved by a retrieval tool, such as Vertex AI Search. See the `RetrievedContext` message for details" } }, "description": "A piece of evidence that supports a claim made by the model. This is used to show a citation for a claim made by the model. When grounding is enabled, the model returns a `GroundingChunk` that contains a reference to the source of the information." }, "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchSpec": { "description": "Spec for tool parameter key match metric.", "id": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchSpec", "type": "object", "properties": {} }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationCategoricalTransformation": { "properties": { "columnName": { "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsTransformationCategoricalTransformation", "description": "Training pipeline will perform following transformation functions. * The categorical string as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index. * Categories that appear less than 5 times in the training dataset are treated as the \"unknown\" category. The \"unknown\" category gets its own special lookup index and resulting embedding." }, "GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata": { "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "description": "Runtime operation information for ModelGardenService.ExportPublisherModel.", "id": "GoogleCloudAiplatformV1beta1ExportPublisherModelOperationMetadata" }, "GoogleCloudAiplatformV1beta1SharePointSources": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SharePointSources", "description": "The SharePointSources to pass to ImportRagFiles.", "properties": { "sharePointSources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SharePointSourcesSharePointSource" }, "description": "The SharePoint sources.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringAnomalyTabularAnomaly": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAnomalyTabularAnomaly", "description": "Tabular anomaly details.", "properties": { "summary": { "description": "Overview of this anomaly.", "type": "string" }, "anomaly": { "type": "any", "description": "Anomaly body." }, "anomalyUri": { "description": "Additional anomaly information. e.g. Google Cloud Storage uri.", "type": "string" }, "triggerTime": { "description": "The time the anomaly was triggered.", "format": "google-datetime", "type": "string" }, "condition": { "description": "The alert condition associated with this anomaly.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertCondition" } } }, "GoogleCloudAiplatformV1beta1FindNeighborsRequestQuery": { "description": "A query to find a number of the nearest neighbors (most similar vectors) of a vector.", "type": "object", "properties": { "datapoint": { "$ref": "GoogleCloudAiplatformV1beta1IndexDatapoint", "description": "Required. The datapoint/vector whose nearest neighbors should be searched for." }, "neighborCount": { "format": "int32", "description": "The number of nearest neighbors to be retrieved from database for each query. If not set, will use the default from the service configuration (https://cloud.google.com/vertex-ai/docs/matching-engine/configuring-indexes#nearest-neighbor-search-config).", "type": "integer" }, "rrf": { "$ref": "GoogleCloudAiplatformV1beta1FindNeighborsRequestQueryRRF", "description": "Optional. Represents RRF algorithm that combines search results." }, "perCrowdingAttributeNeighborCount": { "description": "Crowding is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than some value k' of the k neighbors returned have the same value of crowding_attribute. It's used for improving result diversity. This field is the maximum number of matches with the same crowding tag.", "type": "integer", "format": "int32" }, "fractionLeafNodesToSearchOverride": { "format": "double", "description": "The fraction of the number of leaves to search, set at query time allows user to tune search performance. This value increase result in both search accuracy and latency increase. The value should be between 0.0 and 1.0. If not set or set to 0.0, query uses the default value specified in NearestNeighborSearchConfig.TreeAHConfig.fraction_leaf_nodes_to_search.", "type": "number" }, "approximateNeighborCount": { "type": "integer", "description": "The number of neighbors to find via approximate search before exact reordering is performed. If not set, the default value from scam config is used; if set, this value must be \u003e 0.", "format": "int32" } }, "id": "GoogleCloudAiplatformV1beta1FindNeighborsRequestQuery" }, "GoogleCloudAiplatformV1beta1SchemaPredictionResultError": { "properties": { "message": { "description": "Error message with additional details.", "type": "string" }, "status": { "type": "string", "enum": [ "OK", "CANCELLED", "UNKNOWN", "INVALID_ARGUMENT", "DEADLINE_EXCEEDED", "NOT_FOUND", "ALREADY_EXISTS", "PERMISSION_DENIED", "UNAUTHENTICATED", "RESOURCE_EXHAUSTED", "FAILED_PRECONDITION", "ABORTED", "OUT_OF_RANGE", "UNIMPLEMENTED", "INTERNAL", "UNAVAILABLE", "DATA_LOSS" ], "enumDescriptions": [ "Not an error; returned on success. HTTP Mapping: 200 OK", "The operation was cancelled, typically by the caller. HTTP Mapping: 499 Client Closed Request", "Unknown error. For example, this error may be returned when a `Status` value received from another address space belongs to an error space that is not known in this address space. Also errors raised by APIs that do not return enough error information may be converted to this error. HTTP Mapping: 500 Internal Server Error", "The client specified an invalid argument. Note that this differs from `FAILED_PRECONDITION`. `INVALID_ARGUMENT` indicates arguments that are problematic regardless of the state of the system (e.g., a malformed file name). HTTP Mapping: 400 Bad Request", "The deadline expired before the operation could complete. For operations that change the state of the system, this error may be returned even if the operation has completed successfully. For example, a successful response from a server could have been delayed long enough for the deadline to expire. HTTP Mapping: 504 Gateway Timeout", "Some requested entity (e.g., file or directory) was not found. Note to server developers: if a request is denied for an entire class of users, such as gradual feature rollout or undocumented allowlist, `NOT_FOUND` may be used. If a request is denied for some users within a class of users, such as user-based access control, `PERMISSION_DENIED` must be used. HTTP Mapping: 404 Not Found", "The entity that a client attempted to create (e.g., file or directory) already exists. HTTP Mapping: 409 Conflict", "The caller does not have permission to execute the specified operation. `PERMISSION_DENIED` must not be used for rejections caused by exhausting some resource (use `RESOURCE_EXHAUSTED` instead for those errors). `PERMISSION_DENIED` must not be used if the caller can not be identified (use `UNAUTHENTICATED` instead for those errors). This error code does not imply the request is valid or the requested entity exists or satisfies other pre-conditions. HTTP Mapping: 403 Forbidden", "The request does not have valid authentication credentials for the operation. HTTP Mapping: 401 Unauthorized", "Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space. HTTP Mapping: 429 Too Many Requests", "The operation was rejected because the system is not in a state required for the operation's execution. For example, the directory to be deleted is non-empty, an rmdir operation is applied to a non-directory, etc. Service implementors can use the following guidelines to decide between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`: (a) Use `UNAVAILABLE` if the client can retry just the failing call. (b) Use `ABORTED` if the client should retry at a higher level. For example, when a client-specified test-and-set fails, indicating the client should restart a read-modify-write sequence. (c) Use `FAILED_PRECONDITION` if the client should not retry until the system state has been explicitly fixed. For example, if an \"rmdir\" fails because the directory is non-empty, `FAILED_PRECONDITION` should be returned since the client should not retry unless the files are deleted from the directory. HTTP Mapping: 400 Bad Request", "The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort. See the guidelines above for deciding between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`. HTTP Mapping: 409 Conflict", "The operation was attempted past the valid range. E.g., seeking or reading past end-of-file. Unlike `INVALID_ARGUMENT`, this error indicates a problem that may be fixed if the system state changes. For example, a 32-bit file system will generate `INVALID_ARGUMENT` if asked to read at an offset that is not in the range [0,2^32-1], but it will generate `OUT_OF_RANGE` if asked to read from an offset past the current file size. There is a fair bit of overlap between `FAILED_PRECONDITION` and `OUT_OF_RANGE`. We recommend using `OUT_OF_RANGE` (the more specific error) when it applies so that callers who are iterating through a space can easily look for an `OUT_OF_RANGE` error to detect when they are done. HTTP Mapping: 400 Bad Request", "The operation is not implemented or is not supported/enabled in this service. HTTP Mapping: 501 Not Implemented", "Internal errors. This means that some invariants expected by the underlying system have been broken. This error code is reserved for serious errors. HTTP Mapping: 500 Internal Server Error", "The service is currently unavailable. This is most likely a transient condition, which can be corrected by retrying with a backoff. Note that it is not always safe to retry non-idempotent operations. See the guidelines above for deciding between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`. HTTP Mapping: 503 Service Unavailable", "Unrecoverable data loss or corruption. HTTP Mapping: 500 Internal Server Error" ], "description": "Error status. This will be serialized into the enum name e.g. \"NOT_FOUND\"." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictionResultError" }, "GoogleCloudAiplatformV1beta1StudySpecParameterSpecIntegerValueSpec": { "type": "object", "properties": { "defaultValue": { "format": "int64", "type": "string", "description": "A default value for an `INTEGER` parameter that is assumed to be a relatively good starting point. Unset value signals that there is no offered starting point. Currently only supported by the Vertex AI Vizier service. Not supported by HyperparameterTuningJob or TrainingPipeline." }, "minValue": { "format": "int64", "type": "string", "description": "Required. Inclusive minimum value of the parameter." }, "maxValue": { "description": "Required. Inclusive maximum value of the parameter.", "format": "int64", "type": "string" } }, "description": "Value specification for a parameter in `INTEGER` type.", "id": "GoogleCloudAiplatformV1beta1StudySpecParameterSpecIntegerValueSpec" }, "GoogleCloudAiplatformV1beta1ReasoningEngineRuntimeRevision": { "properties": { "createTime": { "description": "Output only. Timestamp when this ReasoningEngineRuntimeRevision was created.", "type": "string", "format": "google-datetime", "readOnly": true }, "name": { "description": "Identifier. The resource name of the ReasoningEngineRuntimeRevision. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/runtimeRevisions/{runtime_revision}`", "type": "string" }, "spec": { "description": "Immutable. Configurations of the ReasoningEngineRuntimeRevision. Contains only revision specific fields.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpec" }, "state": { "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "ARCHIVED" ], "description": "Output only. The state of the revision.", "readOnly": true, "type": "string", "enumDescriptions": [ "The unspecified state.", "Is deployed and ready to be used.", "Is archived and can no longer receive traffic, only preserved for historical purposes." ] } }, "description": "ReasoningEngineRuntimeRevision is a specific version of the runtime related part of ReasoningEngine. Contains only the fields that are revision specific.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineRuntimeRevision" }, "GenaiVertexV1beta1DeleteInteractionResponse": { "type": "object", "properties": {}, "id": "GenaiVertexV1beta1DeleteInteractionResponse", "description": "Response for InteractionService.DeleteInteraction." }, "GoogleCloudAiplatformV1beta1RagDataSchema": { "properties": { "name": { "type": "string", "description": "Identifier. Resource name of the data schema in the form of: `projects/{project_number}/locations/{location}/ragCorpora/{rag_corpus}/ragDataSchemas/{rag_data_schema}` where the {rag_data_schema} part should be the same as the `key` field below." }, "schemaDetails": { "description": "The schema details mapping to the key.", "$ref": "GoogleCloudAiplatformV1beta1RagMetadataSchemaDetails" }, "key": { "type": "string", "description": "Required. The key of this data schema. This key should be matching the key of user specified metadata and unique inside corpus. This value can be up to 63 characters, and valid characters are /a-z-/. The first character must be a letter, the last could be a letter or a number." } }, "description": "The schema of the user specified metadata.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RagDataSchema" }, "GoogleCloudAiplatformV1beta1FeatureValue": { "description": "Value for a feature.", "type": "object", "properties": { "int64ArrayValue": { "description": "A list of int64 type feature value.", "$ref": "GoogleCloudAiplatformV1beta1Int64Array" }, "bytesValue": { "format": "byte", "type": "string", "description": "Bytes feature value." }, "stringArrayValue": { "description": "A list of string type feature value.", "$ref": "GoogleCloudAiplatformV1beta1StringArray" }, "boolArrayValue": { "description": "A list of bool type feature value.", "$ref": "GoogleCloudAiplatformV1beta1BoolArray" }, "int64Value": { "description": "Int64 feature value.", "type": "string", "format": "int64" }, "doubleArrayValue": { "$ref": "GoogleCloudAiplatformV1beta1DoubleArray", "description": "A list of double type feature value." }, "structValue": { "$ref": "GoogleCloudAiplatformV1beta1StructValue", "description": "A struct type feature value." }, "doubleValue": { "type": "number", "description": "Double type feature value.", "format": "double" }, "stringValue": { "description": "String feature value.", "type": "string" }, "metadata": { "description": "Metadata of feature value.", "$ref": "GoogleCloudAiplatformV1beta1FeatureValueMetadata" }, "boolValue": { "description": "Bool type feature value.", "type": "boolean" } }, "id": "GoogleCloudAiplatformV1beta1FeatureValue" }, "GoogleCloudAiplatformV1beta1SearchExamplesRequest": { "properties": { "storedContentsExampleParameters": { "description": "The parameters of StoredContentsExamples to be searched.", "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExampleParameters" }, "topK": { "format": "int64", "type": "string", "description": "Optional. The number of similar examples to return." } }, "id": "GoogleCloudAiplatformV1beta1SearchExamplesRequest", "type": "object", "description": "Request message for ExampleStoreService.SearchExamples." }, "GoogleCloudAiplatformV1beta1SyncFeatureViewRequest": { "description": "Request message for FeatureOnlineStoreAdminService.SyncFeatureView.", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1SyncFeatureViewRequest" }, "GoogleCloudAiplatformV1beta1CreateEntityTypeOperationMetadata": { "type": "object", "properties": { "genericMetadata": { "description": "Operation metadata for EntityType.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "id": "GoogleCloudAiplatformV1beta1CreateEntityTypeOperationMetadata", "description": "Details of operations that perform create EntityType." }, "GoogleCloudAiplatformV1beta1CandidateResponse": { "description": "Responses from model or agent.", "type": "object", "properties": { "events": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Optional. Intermediate events (such as tool calls and responses) that led to the final response.", "type": "array" }, "agentData": { "$ref": "GoogleCloudAiplatformV1beta1AgentData", "description": "Optional. Represents the complete execution trace of a multi-turn conversation, which can involve single or multiple agents. This field is used to provide the full output of an agent's run, including all turns and events, for direct evaluation." }, "value": { "type": "any", "description": "Fields and values that can be used to populate the response template." }, "text": { "type": "string", "description": "Text response." }, "error": { "description": "Output only. Error while scraping model or agent.", "$ref": "GoogleRpcStatus", "readOnly": true }, "candidate": { "description": "Required. The name of the candidate that produced the response.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1CandidateResponse" }, "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyMcpTool": { "properties": { "tools": { "items": { "type": "string" }, "description": "Required. The resource names of the tools used by the Agent that is affected by this policy. Currently, exactly one tool must be specified.", "type": "array" }, "mcpServer": { "type": "string", "description": "Required. The resource name of the McpServer in Agent Registry that is affected by this policy. Format: `projects/{project}/locations/{location}/mcpServers/{mcp_server}`" } }, "description": "Represents a governance policy applied to MCP tools used by an Agent.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicyMcpTool" }, "GoogleCloudAiplatformV1beta1UploadRagFileRequest": { "description": "Request message for VertexRagDataService.UploadRagFile.", "properties": { "uploadRagFileConfig": { "description": "Required. The config for the RagFiles to be uploaded into the RagCorpus. VertexRagDataService.UploadRagFile.", "$ref": "GoogleCloudAiplatformV1beta1UploadRagFileConfig" }, "ragFile": { "description": "Required. The RagFile to upload.", "$ref": "GoogleCloudAiplatformV1beta1RagFile" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UploadRagFileRequest" }, "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode": { "properties": { "modelRoutingPreference": { "type": "string", "enumDescriptions": [ "Unspecified model routing preference.", "The model will be selected to prioritize the quality of the response.", "The model will be selected to balance quality and cost.", "The model will be selected to prioritize the cost of the request." ], "description": "The model routing preference.", "enum": [ "UNKNOWN", "PRIORITIZE_QUALITY", "BALANCED", "PRIORITIZE_COST" ] } }, "description": "The configuration for automated routing. When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference.", "id": "GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode", "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataOutputMetadata": { "type": "object", "properties": { "outputTensorName": { "type": "string", "description": "Name of the output tensor. Required and is only applicable to Vertex AI provided images for Tensorflow." }, "indexDisplayNameMapping": { "description": "Static mapping between the index and display name. Use this if the outputs are a deterministic n-dimensional array, e.g. a list of scores of all the classes in a pre-defined order for a multi-classification Model. It's not feasible if the outputs are non-deterministic, e.g. the Model produces top-k classes or sort the outputs by their values. The shape of the value must be an n-dimensional array of strings. The number of dimensions must match that of the outputs to be explained. The Attribution.output_display_name is populated by locating in the mapping with Attribution.output_index.", "type": "any" }, "displayNameMappingKey": { "description": "Specify a field name in the prediction to look for the display name. Use this if the prediction contains the display names for the outputs. The display names in the prediction must have the same shape of the outputs, so that it can be located by Attribution.output_index for a specific output.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataOutputMetadata", "description": "Metadata of the prediction output to be explained." }, "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessResult": { "id": "GoogleCloudAiplatformV1beta1SummarizationHelpfulnessResult", "type": "object", "properties": { "confidence": { "description": "Output only. Confidence for summarization helpfulness score.", "format": "float", "readOnly": true, "type": "number" }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for summarization helpfulness score." }, "score": { "description": "Output only. Summarization Helpfulness score.", "readOnly": true, "type": "number", "format": "float" } }, "description": "Spec for summarization helpfulness result." }, "GoogleProtobufEmpty": { "properties": {}, "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "GoogleProtobufEmpty", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsGranularity": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsGranularity", "properties": { "unit": { "type": "string", "description": "The time granularity unit of this time period. The supported units are: * \"minute\" * \"hour\" * \"day\" * \"week\" * \"month\" * \"year\"" }, "quantity": { "format": "int64", "description": "The number of granularity_units between data points in the training data. If `granularity_unit` is `minute`, can be 1, 5, 10, 15, or 30. For all other values of `granularity_unit`, must be 1.", "type": "string" } }, "type": "object", "description": "A duration of time expressed in time granularity units." }, "GoogleCloudAiplatformV1beta1SchemaPromptSpecInteractionData": { "description": "Defines data for an interaction prompt.", "type": "object", "properties": { "interactionIds": { "type": "array", "items": { "type": "string" }, "description": "Optional. Lists interaction IDs associated with the prompt. This maps 1:1 to PromptMessage.contents. If InteractionData is present, every prompt message has an interaction ID." } }, "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecInteractionData" }, "GoogleCloudAiplatformV1beta1DatasetCustomMetric": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DatasetCustomMetric", "description": "Defines a custom dataset-level aggregation.", "properties": { "displayName": { "type": "string", "description": "Optional. A display name for this custom summary metric. Used to prefix keys in the output summaryMetrics map. If not provided, a default name like \"dataset_custom_metric_1\", \"dataset_custom_metric_2\", etc., will be generated based on the order in the repeated field." }, "aggregationFunction": { "type": "string", "description": "Required. The Python code string containing the aggregation function. Expected function signature: `def aggregate(instances: list[dict[str, Any]]) -\u003e dict[str, float]:` The `instances` argument is a list of dictionaries, where each dictionary represents a single evaluation result item. The structure of each dictionary corresponds to the fields in the `EvaluationResult` message. This includes: - `\"request\"`: Contains the original input data and model inputs (from `EvaluationResult.EvaluationRequest`). - `\"candidate_results\"`: Contains the results of any instance-level metrics (from `EvaluationResult.CandidateResults`). Example of a single item in the `instances` list: { \"request\": { \"prompt\": {\"text\": \"What is the capital of France?\"}, \"golden_response\": {\"text\": \"Paris\"}, \"candidate_responses\": [{\"candidate\": \"model-v1\", \"text\": \"Paris\"}] }, \"candidate_results\": [ {\"metric\": \"exact_match\", \"score\": 1.0}, {\"metric\": \"bleu\", \"score\": 0.9} ] }" } } }, "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextSentimentPredictionInstance": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictInstanceTextSentimentPredictionInstance", "properties": { "content": { "type": "string", "description": "The text snippet to make the predictions on." }, "mimeType": { "type": "string", "description": "The MIME type of the text snippet. The supported MIME types are listed below. - text/plain" } }, "type": "object", "description": "Prediction input format for Text Sentiment." }, "GoogleCloudAiplatformV1beta1ObservabilityConfig": { "id": "GoogleCloudAiplatformV1beta1ObservabilityConfig", "properties": { "sensitiveLoggingEnabled": { "description": "Optional. Enables sensitive logging. Sensitive logging includes customer core content (prompts, model completions, tool argument payloads and tool responses). If `false`, those are sanitized and only structural attributes are recorded. No effect unless `observability_enabled` is true. Settable and returned, but NOT YET ENFORCED. Nothing reads it at runtime, so `true` does not currently cause content to be captured, and `false` is not what keeps content from being captured. Treat it as a recorded intention that takes effect when enforcement lands.", "type": "boolean" }, "observabilityEnabled": { "description": "Optional. Enables observability for this agent's sessions: OpenTelemetry span emission covering tool names, model names, token counts, latencies and status. If `false`, the other fields here are ignored.", "type": "boolean" } }, "type": "object", "description": "Observability settings for one agent's sessions." }, "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfig", "properties": { "generationRule": { "description": "Optional. Represents the active rule that determines when to flush the buffer. If not set, then the stream will be force flushed immediately.", "$ref": "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfigGenerationTriggerRule" } }, "description": "Represents configuration for triggering generation." }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicCustomMemoryTopic": { "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicCustomMemoryTopic", "type": "object", "description": "A custom memory topic defined by the developer.", "properties": { "description": { "description": "Required. Represents the description of the memory topic. This should explain what information should be extracted for this topic.", "type": "string" }, "label": { "description": "Required. Represents the label of the topic.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1PrebuiltVoiceConfig": { "description": "Configuration for a prebuilt voice.", "properties": { "voiceName": { "description": "The name of the prebuilt voice to use.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1PrebuiltVoiceConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTimestampTransformation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTimestampTransformation", "properties": { "columnName": { "type": "string" }, "timeFormat": { "type": "string", "description": "The format in which that time field is expressed. The time_format must either be one of: * `unix-seconds` * `unix-milliseconds` * `unix-microseconds` * `unix-nanoseconds` (for respectively number of seconds, milliseconds, microseconds and nanoseconds since start of the Unix epoch); or be written in `strftime` syntax. If time_format is not set, then the default format is RFC 3339 `date-time` format, where `time-offset` = `\"Z\"` (e.g. 1985-04-12T23:20:50.52Z)" } }, "description": "Training pipeline will perform following transformation functions. * Apply the transformation functions for Numerical columns. * Determine the year, month, day,and weekday. Treat each value from the timestamp as a Categorical column. * Invalid numerical values (for example, values that fall outside of a typical timestamp range, or are extreme values) receive no special treatment and are not removed." }, "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponse": { "id": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponse", "type": "object", "description": "Response message for FeatureOnlineStoreService.FetchFeatureValues", "properties": { "protoStruct": { "description": "Feature values in proto Struct format.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "dataKey": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey", "description": "The data key associated with this response. Will only be populated for FeatureOnlineStoreService.StreamingFetchFeatureValues RPCs." }, "keyValues": { "description": "Feature values in KeyValue format.", "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairList" } } }, "GoogleCloudAiplatformV1beta1EmbedContentResponse": { "properties": { "embedding": { "description": "The embedding generated from the input content.", "$ref": "GoogleCloudAiplatformV1beta1EmbedContentResponseEmbedding" }, "truncated": { "description": "Whether the input content was truncated before generating the embedding.", "type": "boolean" }, "usageMetadata": { "description": "Usage metadata about the response(s).", "$ref": "GoogleCloudAiplatformV1beta1UsageMetadata" } }, "id": "GoogleCloudAiplatformV1beta1EmbedContentResponse", "description": "Response message for PredictionService.EmbedContent.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataTools": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataTools", "properties": { "tool": { "type": "array", "deprecated": true, "description": "Optional. List of tools: each tool can have multiple function declarations.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" } } }, "description": "Deprecated: Use `agent_eval_data` instead. Represents a list of tools for an agent." }, "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenNotebooks": { "type": "object", "description": "Open notebooks.", "id": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionOpenNotebooks", "properties": { "notebooks": { "items": { "$ref": "GoogleCloudAiplatformV1beta1PublisherModelCallToActionRegionalResourceReferences" }, "description": "Required. Regional resource references to notebooks.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1DeployIndexRequest": { "id": "GoogleCloudAiplatformV1beta1DeployIndexRequest", "description": "Request message for IndexEndpointService.DeployIndex.", "properties": { "deployedIndex": { "$ref": "GoogleCloudAiplatformV1beta1DeployedIndex", "description": "Required. The DeployedIndex to be created within the IndexEndpoint." } }, "type": "object" }, "GenaiVertexV1beta1ThoughtSummaryDelta": { "type": "object", "properties": { "content": { "description": "A new summary item to be added to the thought.", "$ref": "GenaiVertexV1beta1Content" } }, "id": "GenaiVertexV1beta1ThoughtSummaryDelta" }, "GoogleCloudAiplatformV1beta1ListNotebookExecutionJobsResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListNotebookExecutionJobsResponse", "description": "Response message for [NotebookService.CreateNotebookExecutionJob]", "properties": { "notebookExecutionJobs": { "type": "array", "description": "List of NotebookExecutionJobs in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJob" } }, "nextPageToken": { "description": "A token to retrieve next page of results. Pass to ListNotebookExecutionJobsRequest.page_token to obtain that page.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig", "description": "The API secret.", "properties": { "apiKeySecretVersion": { "description": "Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version}", "type": "string" }, "apiKeyString": { "description": "The API key string. Either this or `api_key_secret_version` must be set.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ImportDataConfig": { "description": "Describes the location from where we import data into a Dataset, together with the labels that will be applied to the DataItems and the Annotations.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportDataConfig", "properties": { "importSchemaUri": { "description": "Required. Points to a YAML file stored on Google Cloud Storage describing the import format. Validation will be done against the schema. The schema is defined as an [OpenAPI 3.0.2 Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject).", "type": "string" }, "dataItemLabels": { "description": "Labels that will be applied to newly imported DataItems. If an identical DataItem as one being imported already exists in the Dataset, then these labels will be appended to these of the already existing one, and if labels with identical key is imported before, the old label value will be overwritten. If two DataItems are identical in the same import data operation, the labels will be combined and if key collision happens in this case, one of the values will be picked randomly. Two DataItems are considered identical if their content bytes are identical (e.g. image bytes or pdf bytes). These labels will be overridden by Annotation labels specified inside index file referenced by import_schema_uri, e.g. jsonl file.", "type": "object", "additionalProperties": { "type": "string" } }, "annotationLabels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Labels that will be applied to newly imported Annotations. If two Annotations are identical, one of them will be deduped. Two Annotations are considered identical if their payload, payload_schema_uri and all of their labels are the same. These labels will be overridden by Annotation labels specified inside index file referenced by import_schema_uri, e.g. jsonl file." }, "gcsSource": { "$ref": "GoogleCloudAiplatformV1beta1GcsSource", "description": "The Google Cloud Storage location for the input content." } } }, "GoogleCloudAiplatformV1beta1RayClusterAutoscalingSpec": { "id": "GoogleCloudAiplatformV1beta1RayClusterAutoscalingSpec", "description": "Ray cluster level autoscaling configuration.", "properties": { "upscalingSpeed": { "format": "int64", "type": "string", "description": "Optional. The number of nodes allowed to be pending as a multiple of the current number of nodes. [OSS Ray reference](https://docs.ray.io/en/latest/cluster/vms/user-guides/configuring-autoscaling.html#upscaling-and-downscaling-speed)" }, "idleTimeoutMinutes": { "type": "string", "format": "int64", "description": "Optional. The number of minutes that need to pass before an idle worker node is removed by the autoscaler. Default is 5 mins." } }, "type": "object" }, "GenaiVertexV1beta1CodeExecutionCallStep": { "properties": { "arguments": { "$ref": "GenaiVertexV1beta1CodeExecutionCallStepCodeExecutionCallStepArguments", "description": "Required. The arguments to pass to the code execution." } }, "description": "Code execution call step.", "id": "GenaiVertexV1beta1CodeExecutionCallStep", "type": "object" }, "GoogleCloudAiplatformV1beta1RemoveDatapointsRequest": { "description": "Request message for IndexService.RemoveDatapoints", "properties": { "datapointIds": { "type": "array", "description": "A list of datapoint ids to be deleted.", "items": { "type": "string" } } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RemoveDatapointsRequest" }, "GoogleCloudAiplatformV1beta1ListModelVersionsResponse": { "description": "Response message for ModelService.ListModelVersions", "id": "GoogleCloudAiplatformV1beta1ListModelVersionsResponse", "type": "object", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListModelVersionsRequest.page_token to obtain that page.", "type": "string" }, "models": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Model" }, "type": "array", "description": "List of Model versions in the requested page. In the returned Model name field, version ID instead of regvision tag will be included." } } }, "GoogleCloudAiplatformV1beta1FullFineTuningSpec": { "description": "Tuning Spec for Full Fine Tuning.", "id": "GoogleCloudAiplatformV1beta1FullFineTuningSpec", "properties": { "trainingDatasetUri": { "description": "Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.", "type": "string" }, "hyperParameters": { "description": "Optional. Hyperparameters for Full Fine Tuning.", "$ref": "GoogleCloudAiplatformV1beta1SupervisedHyperParameters" }, "validationDatasetUri": { "description": "Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1Fact": { "description": "The fact used in grounding.", "properties": { "vectorDistance": { "format": "double", "description": "If present, the distance between the query vector and this fact vector.", "type": "number", "deprecated": true }, "chunk": { "description": "If present, chunk properties.", "$ref": "GoogleCloudAiplatformV1beta1RagChunk" }, "uri": { "type": "string", "description": "If present, this uri links to the source of the fact." }, "title": { "type": "string", "description": "If present, it refers to the title of this fact." }, "query": { "description": "Query that is used to retrieve this fact.", "type": "string" }, "score": { "format": "double", "type": "number", "description": "If present, according to the underlying Vector DB and the selected metric type, the score can be either the distance or the similarity between the query and the fact and its range depends on the metric type. For example, if the metric type is COSINE_DISTANCE, it represents the distance between the query and the fact. The larger the distance, the less relevant the fact is to the query. The range is [0, 2], while 0 means the most relevant and 2 means the least relevant." }, "summary": { "type": "string", "description": "If present, the summary/snippet of the fact." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Fact" }, "GoogleCloudAiplatformV1beta1DeployedModelStatus": { "id": "GoogleCloudAiplatformV1beta1DeployedModelStatus", "type": "object", "properties": { "availableReplicaCount": { "type": "integer", "description": "Output only. The number of available replicas of the deployed model.", "format": "int32", "readOnly": true }, "lastUpdateTime": { "description": "Output only. The time at which the status was last updated.", "type": "string", "readOnly": true, "format": "google-datetime" }, "message": { "description": "Output only. The latest deployed model's status message (if any).", "type": "string", "readOnly": true } }, "description": "Runtime status of the deployed model." }, "GoogleCloudAiplatformV1beta1CreateModelMonitoringJobRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateModelMonitoringJobRequest", "description": "Request message for ModelMonitoringService.CreateModelMonitoringJob.", "properties": { "modelMonitoringJobId": { "description": "Optional. The ID to use for the Model Monitoring Job, which will become the final component of the model monitoring job resource name. The maximum length is 63 characters, and valid characters are `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`.", "type": "string" }, "parent": { "description": "Required. The parent of the ModelMonitoringJob. Format: `projects/{project}/locations/{location}/modelMoniitors/{model_monitor}`", "type": "string" }, "modelMonitoringJob": { "description": "Required. The ModelMonitoringJob to create", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJob" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecNotificationChannelConfig": { "properties": { "notificationChannel": { "type": "string", "description": "Resource names of the NotificationChannels. Must be of the format `projects//notificationChannels/`" } }, "description": "Google Cloud Notification Channel config.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringNotificationSpecNotificationChannelConfig" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentConnectionInfo": { "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentConnectionInfo", "properties": { "loadBalancerIp": { "type": "string", "description": "Output only. The IP address of the load balancer.", "readOnly": true }, "routingToken": { "description": "Output only. The routing token for the SandboxEnvironment.", "type": "string", "readOnly": true }, "loadBalancerHostname": { "description": "Output only. The hostname of the load balancer.", "type": "string", "readOnly": true }, "serviceAttachment": { "readOnly": true, "type": "string", "description": "Output only. The name of the PSC-E service attachment created for private ingress to this SandboxEnvironment. Only populated when the template enables private ingress (see SandboxEnvironmentTemplate.ingress_control_config). VPC-SC customers use this to create a PSC endpoint in their VPC." }, "sandboxInternalIp": { "description": "Output only. The internal IP address of the SandboxEnvironment.", "type": "string", "readOnly": true } }, "type": "object", "description": "The connection information of the SandboxEnvironment." }, "GenaiVertexV1beta1GoogleMapsCallStepGoogleMapsCallStepArguments": { "properties": { "queries": { "description": "The queries to be executed.", "type": "array", "items": { "type": "string" } } }, "id": "GenaiVertexV1beta1GoogleMapsCallStepGoogleMapsCallStepArguments", "type": "object", "description": "The arguments to pass to the Google Maps tool." }, "GoogleCloudAiplatformV1beta1SlackSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SlackSource", "description": "The Slack source for the ImportRagFilesRequest.", "properties": { "channels": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SlackSourceSlackChannels" }, "description": "Required. The Slack channels.", "type": "array" } } }, "GoogleCloudAiplatformV1beta1ModelEvaluationSlice": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSlice", "properties": { "createTime": { "description": "Output only. Timestamp when this ModelEvaluationSlice was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "name": { "description": "Output only. The resource name of the ModelEvaluationSlice.", "type": "string", "readOnly": true }, "slice": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSlice", "description": "Output only. The slice of the test data that is used to evaluate the Model." }, "metricsSchemaUri": { "readOnly": true, "type": "string", "description": "Output only. Points to a YAML file stored on Google Cloud Storage describing the metrics of this ModelEvaluationSlice. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject)." }, "metrics": { "readOnly": true, "type": "any", "description": "Output only. Sliced evaluation metrics of the Model. The schema of the metrics is stored in metrics_schema_uri" }, "modelExplanation": { "readOnly": true, "description": "Output only. Aggregated explanation metrics for the Model's prediction output over the data this ModelEvaluation uses. This field is populated only if the Model is evaluated with explanations, and only for tabular Models.", "$ref": "GoogleCloudAiplatformV1beta1ModelExplanation" } }, "description": "A collection of metrics calculated by comparing Model's predictions on a slice of the test data against ground truth annotations." }, "GoogleCloudAiplatformV1beta1FeatureOnlineStore": { "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStore", "description": "Vertex AI Feature Online Store provides a centralized repository for serving ML features and embedding indexes at low latency. The Feature Online Store is a top-level container.", "properties": { "satisfiesPzi": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "embeddingManagement": { "description": "Optional. Deprecated: This field is no longer needed anymore and embedding management is automatically enabled when specifying Optimized storage type.", "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreEmbeddingManagement", "deprecated": true }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "name": { "type": "string", "description": "Identifier. Name of the FeatureOnlineStore. Format: `projects/{project}/locations/{location}/featureOnlineStores/{featureOnlineStore}`" }, "satisfiesPzs": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "createTime": { "type": "string", "readOnly": true, "description": "Output only. Timestamp when this FeatureOnlineStore was created.", "format": "google-datetime" }, "state": { "readOnly": true, "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "State when the featureOnlineStore configuration is not being updated and the fields reflect the current configuration of the featureOnlineStore. The featureOnlineStore is usable in this state.", "The state of the featureOnlineStore configuration when it is being updated. During an update, the fields reflect either the original configuration or the updated configuration of the featureOnlineStore. The featureOnlineStore is still usable in this state." ], "description": "Output only. State of the featureOnlineStore.", "enum": [ "STATE_UNSPECIFIED", "STABLE", "UPDATING" ] }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize your FeatureOnlineStore. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one FeatureOnlineStore(System labels are excluded).\" System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable.", "type": "object" }, "optimized": { "description": "Contains settings for the Optimized store that will be created to serve featureValues for all FeatureViews under this FeatureOnlineStore. When choose Optimized storage type, need to set PrivateServiceConnectConfig.enable_private_service_connect to use private endpoint. Otherwise will use public endpoint by default.", "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreOptimized" }, "bigtable": { "description": "Contains settings for the Cloud Bigtable instance that will be created to serve featureValues for all FeatureViews under this FeatureOnlineStore.", "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtable" }, "updateTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when this FeatureOnlineStore was last updated." }, "dedicatedServingEndpoint": { "description": "Optional. The dedicated serving endpoint for this FeatureOnlineStore, which is different from common Vertex service endpoint.", "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreDedicatedServingEndpoint" }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Optional. Customer-managed encryption key spec for data storage. If set, online store will be secured by this key." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfig": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfig", "properties": { "emailAlertConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAlertConfigEmailAlertConfig", "description": "Email alert config." }, "enableLogging": { "type": "boolean", "description": "Dump the anomalies to Cloud Logging. The anomalies will be put to json payload encoded from proto ModelMonitoringStatsAnomalies. This can be further synced to Pub/Sub or any other services supported by Cloud Logging." }, "notificationChannels": { "type": "array", "items": { "type": "string" }, "description": "Resource names of the NotificationChannels to send alert. Must be of the format `projects//notificationChannels/`" } }, "type": "object", "description": "The alert config for model monitoring." }, "GoogleCloudAiplatformV1beta1Index": { "properties": { "name": { "description": "Output only. The resource name of the Index.", "type": "string", "readOnly": true }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this Index was most recently updated. This also includes any update to the contents of the Index. Note that Operations working on this Index may have their Operations.metadata.generic_metadata.update_time a little after the value of this timestamp, yet that does not mean their results are not already reflected in the Index. Result of any successfully completed Operation on the Index is reflected in it." }, "indexStats": { "$ref": "GoogleCloudAiplatformV1beta1IndexStats", "readOnly": true, "description": "Output only. Stats of the index resource." }, "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Immutable. Customer-managed encryption key spec for an Index. If set, this Index and all sub-resources of this Index will be secured by this key." }, "satisfiesPzs": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "indexUpdateMethod": { "enum": [ "INDEX_UPDATE_METHOD_UNSPECIFIED", "BATCH_UPDATE", "STREAM_UPDATE" ], "enumDescriptions": [ "Should not be used.", "BatchUpdate: user can call UpdateIndex with files on Cloud Storage of Datapoints to update.", "StreamUpdate: user can call UpsertDatapoints/DeleteDatapoints to update the Index and the updates will be applied in corresponding DeployedIndexes in nearly real-time." ], "type": "string", "description": "Immutable. The update method to use with this Index. If not set, BATCH_UPDATE will be used by default." }, "metadata": { "description": "An additional information about the Index; the schema of the metadata can be found in metadata_schema.", "type": "any" }, "etag": { "type": "string", "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "metadataSchemaUri": { "description": "Immutable. Points to a YAML file stored on Google Cloud Storage describing additional information about the Index, that is specific to it. Unset if the Index does not have any additional information. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access.", "type": "string" }, "displayName": { "type": "string", "description": "Required. The display name of the Index. The name can be up to 128 characters long and can consist of any UTF-8 characters." }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this Index was created.", "type": "string" }, "description": { "type": "string", "description": "The description of the Index." }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "The labels with user-defined metadata to organize your Indexes. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "deployedIndexes": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedIndexRef" }, "description": "Output only. The pointers to DeployedIndexes created from this Index. An Index can be only deleted if all its DeployedIndexes had been undeployed first." } }, "id": "GoogleCloudAiplatformV1beta1Index", "type": "object", "description": "A representation of a collection of database items organized in a way that allows for approximate nearest neighbor (a.k.a ANN) algorithms search." }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesRequest": { "description": "Request message for FeaturestoreOnlineServingService.ReadFeatureValues.", "properties": { "entityId": { "type": "string", "description": "Required. ID for a specific entity. For example, for a machine learning model predicting user clicks on a website, an entity ID could be `user_123`." }, "featureSelector": { "$ref": "GoogleCloudAiplatformV1beta1FeatureSelector", "description": "Required. Selector choosing Features of the target EntityType." } }, "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesRequest", "type": "object" }, "GenaiVertexV1beta1ProcessingCallStep": { "id": "GenaiVertexV1beta1ProcessingCallStep", "type": "object", "properties": {}, "description": "A server-initiated processing step for media analysis (e.g. video understanding)." }, "GoogleCloudAiplatformV1beta1UploadModelRequest": { "id": "GoogleCloudAiplatformV1beta1UploadModelRequest", "type": "object", "description": "Request message for ModelService.UploadModel.", "properties": { "model": { "$ref": "GoogleCloudAiplatformV1beta1Model", "description": "Required. The Model to create." }, "parentModel": { "type": "string", "description": "Optional. The resource name of the model into which to upload the version. Only specify this field when uploading a new version." }, "serviceAccount": { "type": "string", "description": "Optional. The user-provided custom service account to use to do the model upload. If empty, [Vertex AI Service Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) will be used to access resources needed to upload the model. This account must belong to the target project where the model is uploaded to, i.e., the project specified in the `parent` field of this request and have necessary read permissions (to Google Cloud Storage, Artifact Registry, etc.)." }, "modelId": { "description": "Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseHeader": { "description": "Response header with metadata for the requested ReadFeatureValuesRequest.entity_type and Features.", "properties": { "featureDescriptors": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseFeatureDescriptor" }, "description": "List of Feature metadata corresponding to each piece of ReadFeatureValuesResponse.EntityView.data." }, "entityType": { "type": "string", "description": "The resource name of the EntityType from the ReadFeatureValuesRequest. Value format: `projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}`." } }, "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseHeader", "type": "object" }, "GoogleCloudAiplatformV1beta1ImageConfigImageOutputOptions": { "id": "GoogleCloudAiplatformV1beta1ImageConfigImageOutputOptions", "properties": { "mimeType": { "description": "Optional. The image format that the output should be saved as.", "type": "string" }, "compressionQuality": { "description": "Optional. The compression quality of the output image.", "type": "integer", "format": "int32" } }, "description": "The image output format for generated images.", "type": "object" }, "GenaiVertexV1beta1GoogleSearchResultContentGoogleSearchResult": { "description": "The result of the Google Search.", "properties": { "searchSuggestions": { "description": "Web content snippet that can be embedded in a web page or an app webview.", "type": "string" } }, "id": "GenaiVertexV1beta1GoogleSearchResultContentGoogleSearchResult", "type": "object" }, "GoogleCloudAiplatformV1beta1ExampleStore": { "description": "Represents an executable service to manage and retrieve examples.", "properties": { "displayName": { "type": "string", "description": "Required. Display name of the ExampleStore." }, "description": { "description": "Optional. Description of the ExampleStore.", "type": "string" }, "updateTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this ExampleStore was most recently updated." }, "exampleStoreConfig": { "$ref": "GoogleCloudAiplatformV1beta1ExampleStoreConfig", "description": "Required. Example Store config." }, "createTime": { "description": "Output only. Timestamp when this ExampleStore was created.", "type": "string", "readOnly": true, "format": "google-datetime" }, "name": { "type": "string", "description": "Identifier. The resource name of the ExampleStore. This is a unique identifier. Format: projects/{project}/locations/{location}/exampleStores/{example_store}" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1ExampleStore" }, "GoogleCloudAiplatformV1beta1CheckPublisherModelEulaAcceptanceRequest": { "description": "Request message for ModelGardenService.CheckPublisherModelEula.", "id": "GoogleCloudAiplatformV1beta1CheckPublisherModelEulaAcceptanceRequest", "properties": { "publisherModel": { "description": "Required. The name of the PublisherModel resource. Format: `publishers/{publisher}/models/{publisher_model}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}`", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1StructuredMemoryConfig": { "properties": { "schemaConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1StructuredMemoryConfigSchemaConfig" }, "type": "array", "description": "Optional. Represents configuration of the structured memories' schemas." }, "scopeKeys": { "items": { "type": "string" }, "description": "Optional. Represents the scope keys (i.e. 'user_id') for which to use this config. A request's scope must include all of the provided keys for the config to be used (order does not matter). If empty, then the config will be used for all requests that do not have a more specific config. Only one default config is allowed per Memory Bank.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1StructuredMemoryConfig", "type": "object", "description": "Represents configuration for organizing structured memories for a particular scope." }, "GoogleCloudAiplatformV1beta1Model": { "description": "A trained machine learning Model.", "properties": { "containerSpec": { "description": "The specification of the container that is to be used when deploying this Model. The specification is ingested upon ModelService.UploadModel, and all binaries it contains are copied and stored internally by Vertex AI. Not required for AutoML Models.", "$ref": "GoogleCloudAiplatformV1beta1ModelContainerSpec" }, "createTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Timestamp when this Model was uploaded into Vertex AI." }, "versionCreateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this version was created." }, "defaultCheckpointId": { "description": "The default checkpoint id of a model version.", "type": "string" }, "checkpoints": { "type": "array", "readOnly": true, "description": "Optional. Output only. The checkpoints of the model.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Checkpoint" } }, "supportedDeploymentResourcesTypes": { "readOnly": true, "items": { "enum": [ "DEPLOYMENT_RESOURCES_TYPE_UNSPECIFIED", "DEDICATED_RESOURCES", "AUTOMATIC_RESOURCES", "SHARED_RESOURCES" ], "enumDescriptions": [ "Should not be used.", "Resources that are dedicated to the DeployedModel, and that need a higher degree of manual configuration.", "Resources that to large degree are decided by Vertex AI, and require only a modest additional configuration.", "Resources that can be shared by multiple DeployedModels. A pre-configured DeploymentResourcePool is required." ], "type": "string" }, "type": "array", "description": "Output only. When this Model is deployed, its prediction resources are described by the `prediction_resources` field of the Endpoint.deployed_models object. Because not all Models support all resource configuration types, the configuration types this Model supports are listed here. If no configuration types are listed, the Model cannot be deployed to an Endpoint and does not support online predictions (PredictionService.Predict or PredictionService.Explain). Such a Model can serve predictions by using a BatchPredictionJob, if it has at least one entry each in supported_input_storage_formats and supported_output_storage_formats." }, "supportedInputStorageFormats": { "description": "Output only. The formats this Model supports in BatchPredictionJob.input_config. If PredictSchemata.instance_schema_uri exists, the instances should be given as per that schema. The possible formats are: * `jsonl` The JSON Lines format, where each instance is a single line. Uses GcsSource. * `csv` The CSV format, where each instance is a single comma-separated line. The first line in the file is the header, containing comma-separated field names. Uses GcsSource. * `tf-record` The TFRecord format, where each instance is a single record in tfrecord syntax. Uses GcsSource. * `tf-record-gzip` Similar to `tf-record`, but the file is gzipped. Uses GcsSource. * `bigquery` Each instance is a single row in BigQuery. Uses BigQuerySource. * `file-list` Each line of the file is the location of an instance to process, uses `gcs_source` field of the InputConfig object. If this Model doesn't support any of these formats it means it cannot be used with a BatchPredictionJob. However, if it has supported_deployment_resources_types, it could serve online predictions by using PredictionService.Predict or PredictionService.Explain.", "readOnly": true, "type": "array", "items": { "type": "string" } }, "metadata": { "description": "Immutable. An additional information about the Model; the schema of the metadata can be found in metadata_schema. Unset if the Model does not have any additional information.", "type": "any" }, "explanationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec", "description": "The default explanation specification for this Model. The Model can be used for requesting explanation after being deployed if it is populated. The Model can be used for batch explanation if it is populated. All fields of the explanation_spec can be overridden by explanation_spec of DeployModelRequest.deployed_model, or explanation_spec of BatchPredictionJob. If the default explanation specification is not set for this Model, this Model can still be used for requesting explanation by setting explanation_spec of DeployModelRequest.deployed_model and for batch explanation by setting explanation_spec of BatchPredictionJob." }, "baseModelSource": { "$ref": "GoogleCloudAiplatformV1beta1ModelBaseModelSource", "description": "Optional. User input field to specify the base model source. Currently it only supports specifing the Model Garden models and Genie models." }, "predictSchemata": { "description": "The schemata that describe formats of the Model's predictions and explanations as given and returned via PredictionService.Predict and PredictionService.Explain.", "$ref": "GoogleCloudAiplatformV1beta1PredictSchemata" }, "artifactUri": { "type": "string", "description": "Immutable. The path to the directory containing the Model artifact and any of its supporting files. Not required for AutoML Models." }, "satisfiesPzi": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "deployedModels": { "type": "array", "description": "Output only. The pointers to DeployedModels created from this Model. Note that Model could have been deployed to Endpoints in different Locations.", "items": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModelRef" }, "readOnly": true }, "displayName": { "description": "Required. The display name of the Model. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "versionAliases": { "items": { "type": "string" }, "description": "User provided version aliases so that a model version can be referenced via alias (i.e. `projects/{project}/locations/{location}/models/{model_id}@{version_alias}` instead of auto-generated version id (i.e. `projects/{project}/locations/{location}/models/{model_id}@{version_id})`. The format is a-z{0,126}[a-z0-9] to distinguish from version_id. A default version alias will be created for the first version of the model, and there must be exactly one default version alias for a model.", "type": "array" }, "versionUpdateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. Timestamp when this version was most recently updated." }, "modelSourceInfo": { "description": "Output only. Source of a model. It can either be automl training pipeline, custom training pipeline, BigQuery ML, or saved and tuned from Genie or Model Garden.", "$ref": "GoogleCloudAiplatformV1beta1ModelSourceInfo", "readOnly": true }, "supportedOutputStorageFormats": { "description": "Output only. The formats this Model supports in BatchPredictionJob.output_config. If both PredictSchemata.instance_schema_uri and PredictSchemata.prediction_schema_uri exist, the predictions are returned together with their instances. In other words, the prediction has the original instance data first, followed by the actual prediction content (as per the schema). The possible formats are: * `jsonl` The JSON Lines format, where each prediction is a single line. Uses GcsDestination. * `csv` The CSV format, where each prediction is a single comma-separated line. The first line in the file is the header, containing comma-separated field names. Uses GcsDestination. * `bigquery` Each prediction is a single row in a BigQuery table, uses BigQueryDestination . If this Model doesn't support any of these formats it means it cannot be used with a BatchPredictionJob. However, if it has supported_deployment_resources_types, it could serve online predictions by using PredictionService.Predict or PredictionService.Explain.", "type": "array", "readOnly": true, "items": { "type": "string" } }, "supportedExportFormats": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelExportFormat" }, "readOnly": true, "description": "Output only. The formats in which this Model may be exported. If empty, this Model is not available for export.", "type": "array" }, "originalModelInfo": { "$ref": "GoogleCloudAiplatformV1beta1ModelOriginalModelInfo", "description": "Output only. If this Model is a copy of another Model, this contains info about the original.", "readOnly": true }, "versionId": { "description": "Output only. Immutable. The version ID of the model. A new version is committed when a new model version is uploaded or trained under an existing model id. It is an auto-incrementing decimal number in string representation.", "type": "string", "readOnly": true }, "description": { "type": "string", "description": "The description of the Model." }, "metadataSchemaUri": { "description": "Immutable. Points to a YAML file stored on Google Cloud Storage describing additional information about the Model, that is specific to it. Unset if the Model does not have any additional information. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject). AutoML Models always have this field populated by Vertex AI, if no additional metadata is needed, this field is set to an empty string. Note: The URI given on output will be immutable and probably different, including the URI scheme, than the one given on input. The output URI will point to a location where the user only has a read access.", "type": "string" }, "labels": { "type": "object", "description": "The labels with user-defined metadata to organize your Models. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.", "additionalProperties": { "type": "string" } }, "trainingPipeline": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the TrainingPipeline that uploaded this Model, if any." }, "metadataArtifact": { "type": "string", "description": "Output only. The resource name of the Artifact that was created in MetadataStore when creating the Model. The Artifact resource name pattern is `projects/{project}/locations/{location}/metadataStores/{metadata_store}/artifacts/{artifact}`.", "readOnly": true }, "etag": { "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "versionDescription": { "type": "string", "description": "The description of this version." }, "name": { "type": "string", "description": "Identifier. The resource name of the Model." }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this Model was most recently updated.", "format": "google-datetime", "readOnly": true }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a Model. If set, this Model and all sub-resources of this Model will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1Model", "type": "object" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerJsonMatchExpression": { "description": "JsonMatchExpression supports converting the parsed responses to JSON format, finding the value in the JSON response that matches the key_name in the first level, and performing StringMatchExpression operation on the matched JSON value.", "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerJsonMatchExpression", "properties": { "valueStringMatchExpression": { "description": "String match expression to match against the extracted value from the JSON representation of the parsed response.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningStringMatchRewardScorerStringMatchExpression" }, "keyName": { "description": "The key name to find the value in the parsed response that's in JSON format. Only first-level key matching is supported.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestAgentEngineSource": { "description": "Source for loading Agent Engine sessions.", "type": "object", "properties": { "projectId": { "description": "Required. Project ID for the Agent Engine sessions.", "type": "string" }, "sessionIds": { "items": { "type": "string" }, "description": "Required. Session IDs for the Agent Engine sessions to retrieve.", "type": "array" }, "reasoningEngineId": { "description": "Required. Reasoning Engine ID for the Agent Engine sessions.", "type": "string" }, "location": { "description": "Required. Location for the Agent Engine sessions.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestAgentEngineSource" }, "GoogleCloudAiplatformV1beta1MutateDeployedIndexOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1MutateDeployedIndexOperationMetadata", "type": "object", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The operation generic information." }, "deployedIndexId": { "description": "The unique index id specified by user", "type": "string" } }, "description": "Runtime operation information for IndexEndpointService.MutateDeployedIndex." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextTransformation": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTextTransformation", "type": "object", "description": "Training pipeline will perform following transformation functions. * The text as is--no change to case, punctuation, spelling, tense, and so on. * Tokenize text to words. Convert each words to a dictionary lookup index and generate an embedding for each index. Combine the embedding of all elements into a single embedding using the mean. * Tokenization is based on unicode script boundaries. * Missing values get their own lookup index and resulting embedding. * Stop-words receive no special treatment and are not removed.", "properties": { "columnName": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1DeployModelResponse": { "description": "Response message for EndpointService.DeployModel.", "type": "object", "properties": { "deployedModel": { "description": "The DeployedModel that had been deployed in the Endpoint.", "$ref": "GoogleCloudAiplatformV1beta1DeployedModel" } }, "id": "GoogleCloudAiplatformV1beta1DeployModelResponse" }, "GenaiVertexV1beta1ContentList": { "id": "GenaiVertexV1beta1ContentList", "type": "object", "properties": { "contents": { "description": "The contents of the list.", "items": { "$ref": "GenaiVertexV1beta1Content" }, "type": "array" } }, "description": "A list of Content." }, "GoogleCloudAiplatformV1beta1OnlineEvaluator": { "description": "An OnlineEvaluator contains the configuration for an Online Evaluation.", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluator", "type": "object", "properties": { "displayName": { "type": "string", "description": "Optional. Human-readable name for the OnlineEvaluator. The name doesn't have to be unique. The name can consist of any UTF-8 characters. The maximum length is `63` characters. If the display name exceeds max characters, an `INVALID_ARGUMENT` error is returned." }, "stateDetails": { "description": "Output only. Contains additional information about the state of the OnlineEvaluator. This is used to provide more details in the event of a failure.", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorStateDetails" }, "type": "array" }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when the OnlineEvaluator was created.", "readOnly": true }, "metricSources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MetricSource" }, "description": "Required. A list of metric sources to be used for evaluating samples. At least one MetricSource must be provided. Right now, only predefined metrics and registered metrics are supported. Every registered metric must have `display_name` (or `title`) and `score_range` defined. Otherwise, the evaluations will fail. The maximum number of `metric_sources` is 25.", "type": "array" }, "state": { "enumDescriptions": [ "Default value.", "Indicates that the OnlineEvaluator is active.", "Indicates that the OnlineEvaluator is suspended. In this state, the OnlineEvaluator will not evaluate any samples.", "Indicates that the OnlineEvaluator is in a failed state. This can happen if, for example, the `log_view` or `trace_view` set on the `CloudObservability` does not exist.", "Indicates that the OnlineEvaluator is in a warning state. This can happen if, for example, some of the metrics in the `metric_sources` are invalid. Evaluation will still run with the remaining valid metrics." ], "readOnly": true, "description": "Output only. The state of the OnlineEvaluator.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "SUSPENDED", "FAILED", "WARNING" ], "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when the OnlineEvaluator was last updated.", "type": "string" }, "config": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorConfig", "description": "Required. Configuration for the OnlineEvaluator." }, "agentResource": { "description": "Required. Immutable. The name of the agent that the OnlineEvaluator evaluates periodically. This value is used to filter the traces with a matching cloud.resource_id and link the evaluation results with relevant dashboards/UIs. This field is immutable. Once set, it cannot be changed.", "type": "string" }, "name": { "description": "Identifier. The resource name of the OnlineEvaluator. Format: projects/{project}/locations/{location}/onlineEvaluators/{id}.", "type": "string" }, "cloudObservability": { "description": "Data source for the OnlineEvaluator, based on Google Cloud Observability stack (Cloud Trace & Cloud Logging).", "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservability" } } }, "GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DeployRequestEndpointConfig", "description": "The endpoint config to use for the deployment.", "properties": { "privateServiceConnectConfig": { "$ref": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig", "description": "Optional. Configuration for private service connect. If set, the endpoint will be exposed through private service connect." }, "endpointUserId": { "description": "Optional. Immutable. The ID to use for endpoint, which will become the final component of the endpoint resource name. If not provided, Vertex AI will generate a value for this ID. If the first character is a letter, this value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The last character must be a letter or number. If the first character is a number, this value may be up to 9 characters, and valid characters are `[0-9]` with no leading zeros. When using HTTP/JSON, this field is populated based on a query string argument, such as `?endpoint_id=12345`. This is the fallback for fields that are not included in either the URI or the body.", "type": "string" }, "dedicatedEndpointDisabled": { "type": "boolean", "description": "Optional. By default, if dedicated endpoint is enabled and private service connect config is not set, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. If private service connect config is set, the endpoint will be exposed through private service connect. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon. If this field is set to true, the dedicated endpoint will be disabled and the deployed model will be exposed through the shared DNS {region}-aiplatform.googleapis.com." }, "endpointDisplayName": { "type": "string", "description": "Optional. The user-specified display name of the endpoint. If not set, a default name will be used." }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. The labels with user-defined metadata to organize your Endpoints. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "dedicatedEndpointEnabled": { "description": "Optional. Deprecated. Use dedicated_endpoint_disabled instead. If true, the endpoint will be exposed through a dedicated DNS [Endpoint.dedicated_endpoint_dns]. Your request to the dedicated DNS will be isolated from other users' traffic and will have better performance and reliability. Note: Once you enabled dedicated endpoint, you won't be able to send request to the shared DNS {region}-aiplatform.googleapis.com. The limitations will be removed soon.", "deprecated": true, "type": "boolean" } } }, "GoogleCloudAiplatformV1beta1ToolCallValidInput": { "type": "object", "description": "Input for tool call valid metric.", "id": "GoogleCloudAiplatformV1beta1ToolCallValidInput", "properties": { "instances": { "description": "Required. Repeated tool call valid instances.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolCallValidInstance" }, "type": "array" }, "metricSpec": { "description": "Required. Spec for tool call valid metric.", "$ref": "GoogleCloudAiplatformV1beta1ToolCallValidSpec" } } }, "GoogleCloudAiplatformV1beta1DataItemView": { "type": "object", "description": "A container for a single DataItem and Annotations on it.", "properties": { "hasTruncatedAnnotations": { "description": "True if and only if the Annotations field has been truncated. It happens if more Annotations for this DataItem met the request's annotation_filter than are allowed to be returned by annotations_limit. Note that if Annotations field is not being returned due to field mask, then this field will not be set to true no matter how many Annotations are there.", "type": "boolean" }, "annotations": { "description": "The Annotations on the DataItem. If too many Annotations should be returned for the DataItem, this field will be truncated per annotations_limit in request. If it was, then the has_truncated_annotations will be set to true.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Annotation" } }, "dataItem": { "description": "The DataItem.", "$ref": "GoogleCloudAiplatformV1beta1DataItem" } }, "id": "GoogleCloudAiplatformV1beta1DataItemView" }, "GenaiVertexV1beta1StepDeltaData": { "type": "object", "id": "GenaiVertexV1beta1StepDeltaData", "properties": { "image": { "$ref": "GenaiVertexV1beta1ImageDelta" }, "argumentsDelta": { "$ref": "GenaiVertexV1beta1ArgumentsDelta" }, "thoughtSignature": { "$ref": "GenaiVertexV1beta1ThoughtSignatureDelta" }, "functionResult": { "$ref": "GenaiVertexV1beta1FunctionResultDelta" }, "thoughtSummary": { "$ref": "GenaiVertexV1beta1ThoughtSummaryDelta" }, "textAnnotationDelta": { "$ref": "GenaiVertexV1beta1TextAnnotationDelta" }, "video": { "$ref": "GenaiVertexV1beta1VideoDelta" }, "serverToolCall": { "$ref": "GenaiVertexV1beta1ServerToolCallDelta" }, "document": { "$ref": "GenaiVertexV1beta1DocumentDelta" }, "text": { "$ref": "GenaiVertexV1beta1TextDelta" }, "audio": { "$ref": "GenaiVertexV1beta1AudioDelta" }, "serverToolResult": { "$ref": "GenaiVertexV1beta1ServerToolResultDelta" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlImageClassificationMetadata", "type": "object", "properties": { "successfulStopReason": { "enum": [ "SUCCESSFUL_STOP_REASON_UNSPECIFIED", "BUDGET_REACHED", "MODEL_CONVERGED" ], "description": "For successful job completions, this is the reason why the job has finished.", "type": "string", "enumDescriptions": [ "Should not be set.", "The inputs.budgetMilliNodeHours had been reached.", "Further training of the Model ceased to increase its quality, since it already has converged." ] }, "costMilliNodeHours": { "type": "string", "description": "The actual training cost of creating this model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed inputs.budgetMilliNodeHours.", "format": "int64" } } }, "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig": { "properties": { "projectAllowlist": { "items": { "type": "string" }, "type": "array", "description": "A list of Projects from which the forwarding rule will target the service attachment." }, "serviceAttachment": { "description": "Output only. The name of the generated service attachment resource. This is only populated if the endpoint is deployed with PrivateServiceConnect.", "type": "string", "readOnly": true }, "pscAutomationConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1PSCAutomationConfig" }, "type": "array", "description": "Optional. List of projects and networks where the PSC endpoints will be created. This field is used by Online Inference(Prediction) only." }, "enablePrivateServiceConnect": { "type": "boolean", "description": "Required. If true, expose the IndexEndpoint via private service connect." }, "enableSecurePrivateServiceConnect": { "description": "Optional. If set to true, enable secure private service connect with IAM authorization. Otherwise, private service connect will be done without authorization. Note latency will be slightly increased if authorization is enabled.", "type": "boolean" } }, "type": "object", "description": "Represents configuration for private service connect.", "id": "GoogleCloudAiplatformV1beta1PrivateServiceConnectConfig" }, "GoogleCloudAiplatformV1beta1RagRetrievalConfigHybridSearch": { "properties": { "alpha": { "description": "Optional. Alpha value controls the weight between dense and sparse vector search results. The range is [0, 1], while 0 means sparse vector search only and 1 means dense vector search only. The default value is 0.5 which balances sparse and dense vector search equally.", "format": "float", "type": "number" } }, "type": "object", "description": "Config for Hybrid Search.", "id": "GoogleCloudAiplatformV1beta1RagRetrievalConfigHybridSearch" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigAgentToAnywhereConfig": { "properties": { "agentGateway": { "description": "Required. The resource name of the Agent Gateway for outbound traffic. It must be set to a Google-managed gateway whose `governed_access_path` is `AGENT_TO_ANYWHERE`. Format: `projects/{project}/locations/{location}/agentGateways/{agent_gateway}`", "type": "string" } }, "description": "Configuration for traffic originating from a Reasoning Engine.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpecAgentGatewayConfigAgentToAnywhereConfig" }, "GenaiVertexV1beta1Interaction": { "description": "Response for InteractionService.CreateInteraction.", "properties": { "systemInstruction": { "description": "System instruction for the interaction.", "type": "string" }, "continuationToken": { "type": "string", "format": "byte", "description": "Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding." }, "steps": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1Step" }, "readOnly": true, "description": "Required. Output only. The steps that make up the interaction, when included in the response." }, "updated": { "description": "Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).", "type": "string", "readOnly": true }, "responseFormatList": { "$ref": "GenaiVertexV1beta1ResponseFormatList" }, "created": { "type": "string", "description": "Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).", "readOnly": true }, "responseMimeType": { "type": "string", "description": "The mime type of the response. This is required if response_format is set.", "deprecated": true }, "stepList": { "description": "Input only. The steps for the interaction.", "$ref": "GenaiVertexV1beta1StepList" }, "errors": { "description": "Output only. Diagnostic faults / platform errors recorded on the interaction.", "readOnly": true, "items": { "$ref": "GenaiVertexV1beta1Error" }, "type": "array" }, "usage": { "readOnly": true, "description": "Output only. Statistics on the interaction request's token usage.", "$ref": "GenaiVertexV1beta1InteractionUsage" }, "responseFormatSingleton": { "$ref": "GenaiVertexV1beta1ResponseFormat" }, "responseModalities": { "items": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Indicates the model should return text.", "Indicates the model should return images.", "Indicates the model should return audio.", "Indicates the model should return video.", "Indicates the model should return documents." ], "enum": [ "RESPONSE_MODALITY_UNSPECIFIED", "TEXT", "IMAGE", "AUDIO", "VIDEO", "DOCUMENT" ] }, "type": "array", "deprecated": true, "description": "The requested modalities of the response (TEXT, IMAGE, AUDIO)." }, "localEnvironment": { "$ref": "GenaiVertexV1beta1LocalEnvironmentConfig", "description": "The agent's environment lives on the client connection: its built-in environment operations (filesystem ops and running commands) are yielded to the client to execute, instead of running in a server-managed sandbox. Mutually exclusive with `remote_environment`. (Independent of any client-declared function tools, which are always executed on the client regardless of this field.)" }, "agentInteraction": { "$ref": "GenaiVertexV1beta1AgentInteraction", "description": "Interaction for generating the completion using agents." }, "status": { "description": "Required. Output only. The status of the interaction.", "enumDeprecated": [ false, false, false, false, false, false, false, true, false ], "enumDescriptions": [ "Default value. This value is unused.", "The interaction is in progress.", "The interaction requires action/input from the user.", "The interaction is completed.", "The interaction failed.", "The interaction was cancelled.", "The interaction is completed, but contains incomplete results (e.g. hitting max_tokens).", "Deprecated: Token and execution budget exhaustion returns INCOMPLETE (11).", "The interaction is queued, waiting for processing (e.g. waiting for off-peak capacity)." ], "type": "string", "readOnly": true, "enum": [ "UNSPECIFIED", "IN_PROGRESS", "REQUIRES_ACTION", "COMPLETED", "FAILED", "CANCELLED", "INCOMPLETE", "BUDGET_EXCEEDED", "QUEUED" ] }, "previousInteractionId": { "type": "string", "description": "The ID of the previous interaction, if any." }, "id": { "type": "string", "readOnly": true, "description": "Required. Output only. A unique identifier for the interaction completion." }, "envId": { "type": "string", "description": "The environment ID for the interaction. Can be 'remote' for default environment." }, "stringContent": { "description": "A string input for the interaction, it will be processed as a single text input.", "type": "string" }, "tools": { "description": "A list of tool declarations the model may call during interaction.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1Tool" } }, "serviceTier": { "type": "string", "enumDescriptions": [ "Default service tier, which is standard.", "Flex service tier.", "Standard service tier.", "Priority service tier.", "Deferred service tier." ], "description": "The service tier for the interaction.", "enum": [ "SERVICE_TIER_UNSPECIFIED", "SERVICE_TIER_FLEX", "SERVICE_TIER_STANDARD", "SERVICE_TIER_PRIORITY", "SERVICE_TIER_DEFERRED" ] }, "modelInteraction": { "$ref": "GenaiVertexV1beta1ModelInteraction", "description": "Interaction for generating the completion using models." }, "content": { "$ref": "GenaiVertexV1beta1Content", "description": "The content for the interaction." }, "environmentId": { "readOnly": true, "description": "Output only. The environment ID for the interaction. Only populated if environment config is set in the request.", "type": "string" }, "remoteEnvironment": { "$ref": "GenaiVertexV1beta1EnvironmentConfig" }, "safetySettings": { "description": "Safety settings for the interaction.", "items": { "$ref": "GenaiVertexV1beta1SafetySetting" }, "type": "array" }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The labels with user-defined metadata for the request. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter." } }, "type": "object", "id": "GenaiVertexV1beta1Interaction" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTextTransformation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationTextTransformation", "description": "Training pipeline will perform following transformation functions. * The text as is--no change to case, punctuation, spelling, tense, and so on. * Convert the category name to a dictionary lookup index and generate an embedding for each index.", "properties": { "columnName": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelEvaluationModelEvaluationExplanationSpec": { "type": "object", "properties": { "explanationType": { "description": "Explanation type. For AutoML Image Classification models, possible values are: * `image-integrated-gradients` * `image-xrai`", "type": "string" }, "explanationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec", "description": "Explanation spec details." } }, "id": "GoogleCloudAiplatformV1beta1ModelEvaluationModelEvaluationExplanationSpec" }, "GoogleCloudAiplatformV1beta1Blob": { "properties": { "mimeType": { "description": "Required. The IANA standard MIME type of the source data.", "type": "string" }, "data": { "format": "byte", "type": "string", "description": "Required. The raw bytes of the data." }, "displayName": { "type": "string", "description": "Optional. The display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server-side tools (`code_execution`, `google_search`, and `url_context`) are enabled." } }, "id": "GoogleCloudAiplatformV1beta1Blob", "description": "A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video.", "type": "object" }, "GenaiVertexV1beta1ResponseFormat": { "properties": { "image": { "$ref": "GenaiVertexV1beta1ImageResponseFormat" }, "video": { "$ref": "GenaiVertexV1beta1VideoResponseFormat" }, "text": { "$ref": "GenaiVertexV1beta1TextResponseFormat" }, "audio": { "$ref": "GenaiVertexV1beta1AudioResponseFormat" }, "structValue": { "$ref": "GenaiVertexV1beta1Struct", "description": "Multi-discriminator values is already enabled in GAOS" } }, "id": "GenaiVertexV1beta1ResponseFormat", "type": "object" }, "GoogleCloudAiplatformV1beta1TensorboardTimeSeries": { "description": "TensorboardTimeSeries maps to times series produced in training runs", "properties": { "etag": { "description": "Used to perform a consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "displayName": { "type": "string", "description": "Required. User provided name of this TensorboardTimeSeries. This value should be unique among all TensorboardTimeSeries resources belonging to the same TensorboardRun resource (parent resource)." }, "updateTime": { "format": "google-datetime", "description": "Output only. Timestamp when this TensorboardTimeSeries was last updated.", "type": "string", "readOnly": true }, "pluginData": { "format": "byte", "description": "Data of the current plugin, with the size limited to 65KB.", "type": "string" }, "pluginName": { "description": "Immutable. Name of the plugin this time series pertain to. Such as Scalar, Tensor, Blob", "type": "string" }, "metadata": { "readOnly": true, "description": "Output only. Scalar, Tensor, or Blob metadata for this TensorboardTimeSeries.", "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeriesMetadata" }, "description": { "description": "Description of this TensorboardTimeSeries.", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. Timestamp when this TensorboardTimeSeries was created." }, "valueType": { "enum": [ "VALUE_TYPE_UNSPECIFIED", "SCALAR", "TENSOR", "BLOB_SEQUENCE" ], "description": "Required. Immutable. Type of TensorboardTimeSeries value.", "type": "string", "enumDescriptions": [ "The value type is unspecified.", "Used for TensorboardTimeSeries that is a list of scalars. E.g. accuracy of a model over epochs/time.", "Used for TensorboardTimeSeries that is a list of tensors. E.g. histograms of weights of layer in a model over epoch/time.", "Used for TensorboardTimeSeries that is a list of blob sequences. E.g. set of sample images with labels over epochs/time." ] }, "name": { "readOnly": true, "description": "Output only. Name of the TensorboardTimeSeries.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries" }, "GoogleCloudAiplatformV1beta1MetadataSchema": { "id": "GoogleCloudAiplatformV1beta1MetadataSchema", "description": "Instance of a general MetadataSchema.", "type": "object", "properties": { "schemaType": { "enumDescriptions": [ "Unspecified type for the MetadataSchema.", "A type indicating that the MetadataSchema will be used by Artifacts.", "A typee indicating that the MetadataSchema will be used by Executions.", "A state indicating that the MetadataSchema will be used by Contexts." ], "enum": [ "METADATA_SCHEMA_TYPE_UNSPECIFIED", "ARTIFACT_TYPE", "EXECUTION_TYPE", "CONTEXT_TYPE" ], "type": "string", "description": "The type of the MetadataSchema. This is a property that identifies which metadata types will use the MetadataSchema." }, "schemaVersion": { "description": "The version of the MetadataSchema. The version's format must match the following regular expression: `^[0-9]+.+.+$`, which would allow to order/compare different versions. Example: 1.0.0, 1.0.1, etc.", "type": "string" }, "createTime": { "description": "Output only. Timestamp when this MetadataSchema was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "schema": { "description": "Required. The raw YAML string representation of the MetadataSchema. The combination of [MetadataSchema.version] and the schema name given by `title` in [MetadataSchema.schema] must be unique within a MetadataStore. The schema is defined as an OpenAPI 3.0.2 [MetadataSchema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#schemaObject)", "type": "string" }, "description": { "description": "Description of the Metadata Schema", "type": "string" }, "name": { "readOnly": true, "description": "Output only. The resource name of the MetadataSchema.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1UpdateModelDeploymentMonitoringJobOperationMetadata": { "description": "Runtime operation information for JobService.UpdateModelDeploymentMonitoringJob.", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UpdateModelDeploymentMonitoringJobOperationMetadata" }, "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataContentValidationStats": { "properties": { "validRecordCount": { "format": "int64", "description": "Number of records in this file that were successfully processed.", "type": "string" }, "validSparseRecordCount": { "description": "Number of sparse records in this file that were successfully processed.", "type": "string", "format": "int64" }, "partialErrors": { "description": "The detail information of the partial failures encountered for those invalid records that couldn't be parsed. Up to 50 partial errors will be reported.", "items": { "$ref": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataRecordError" }, "type": "array" }, "invalidSparseRecordCount": { "description": "Number of sparse records in this file we skipped due to validate errors.", "type": "string", "format": "int64" }, "sourceGcsUri": { "type": "string", "description": "Cloud Storage URI pointing to the original file in user's bucket." }, "invalidRecordCount": { "type": "string", "format": "int64", "description": "Number of records in this file we skipped due to validate errors." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NearestNeighborSearchOperationMetadataContentValidationStats" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceSpec": { "description": "Spec for question answering relevance metric.", "properties": { "useReference": { "description": "Optional. Whether to use instance.reference to compute question answering relevance.", "type": "boolean" }, "version": { "description": "Optional. Which version to use for evaluation.", "type": "integer", "format": "int32" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringRelevanceSpec" }, "GoogleCloudAiplatformV1beta1BatchImportModelEvaluationSlicesResponse": { "type": "object", "description": "Response message for ModelService.BatchImportModelEvaluationSlices", "properties": { "importedModelEvaluationSlices": { "type": "array", "description": "Output only. List of imported ModelEvaluationSlice.name.", "readOnly": true, "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1BatchImportModelEvaluationSlicesResponse" }, "GoogleCloudAiplatformV1beta1ProbeHttpGetAction": { "properties": { "scheme": { "description": "Scheme to use for connecting to the host. Defaults to HTTP. Acceptable values are \"HTTP\" or \"HTTPS\".", "type": "string" }, "port": { "type": "integer", "format": "int32", "description": "Number of the port to access on the container. Number must be in the range 1 to 65535." }, "httpHeaders": { "type": "array", "description": "Custom headers to set in the request. HTTP allows repeated headers.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ProbeHttpHeader" } }, "path": { "description": "Path to access on the HTTP server.", "type": "string" }, "host": { "description": "Host name to connect to, defaults to the model serving container's IP. You probably want to set \"Host\" in httpHeaders instead.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ProbeHttpGetAction", "type": "object", "description": "HttpGetAction describes an action based on HTTP Get requests." }, "GoogleCloudAiplatformV1beta1GenerateUserScenariosRequest": { "id": "GoogleCloudAiplatformV1beta1GenerateUserScenariosRequest", "properties": { "geminiAgentConfig": { "description": "Optional. Config for a Gemini Agent to generate user scenarios for.", "$ref": "GoogleCloudAiplatformV1beta1GeminiAgentConfig" }, "agents": { "description": "Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent. Required unless `gemini_agent_config` is set, in which case the agents map and `root_agent_id` are derived from the referenced Gemini Agent.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1AgentConfig" }, "type": "object" }, "userScenarioGenerationConfig": { "$ref": "GoogleCloudAiplatformV1beta1UserScenarioGenerationConfig", "description": "Required. Configuration for generating user scenarios." }, "allowCrossRegionModel": { "type": "boolean", "description": "Optional. Allows the scenario generation to use cross region models. When this flag is set, the service may route traffic to other regions if a model is unavailable in the current region (e.g., to a `global` endpoint). If a fully-qualified model endpoint resource name with a different region than the request location is provided elsewhere in the request, this flag must be set to true or the request will fail." }, "rootAgentId": { "description": "Optional. The agent id to identify the root agent. Required unless `gemini_agent_config` is set, in which case it is derived from the referenced Gemini Agent.", "type": "string" } }, "description": "Request message for DataFoundryService.GenerateUserScenarios.", "type": "object" }, "GoogleCloudAiplatformV1beta1PurgeExecutionsResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1PurgeExecutionsResponse", "description": "Response message for MetadataService.PurgeExecutions.", "properties": { "purgeSample": { "description": "A sample of the Execution names that will be deleted. Only populated if `force` is set to false. The maximum number of samples is 100 (it is possible to return fewer).", "items": { "type": "string" }, "type": "array" }, "purgeCount": { "type": "string", "format": "int64", "description": "The number of Executions that this request deleted (or, if `force` is false, the number of Executions that will be deleted). This can be an estimate." } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextClassificationInputs": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextClassificationInputs", "properties": { "multiLabel": { "type": "boolean" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricLLMBasedMetricSpec": { "properties": { "rubricGenerationSpec": { "description": "Dynamically generate rubrics using this specification.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricGenerationSpec" }, "systemInstruction": { "type": "string", "description": "Optional. System instructions for the judge model." }, "rubricGroupKey": { "description": "Use a pre-defined group of rubrics associated with the input. Refers to a key in the rubric_groups map of EvaluationInstance.", "type": "string" }, "additionalConfig": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. Optional additional configuration for the metric." }, "predefinedRubricGenerationSpec": { "description": "Dynamically generate rubrics using a predefined spec.", "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec" }, "metricPromptTemplate": { "type": "string", "description": "Required. Template for the prompt sent to the judge model." }, "judgeAutoraterConfig": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunEvaluationConfigAutoraterConfig", "description": "Optional. Optional configuration for the judge LLM (Autorater)." } }, "description": "Specification for an LLM based metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricLLMBasedMetricSpec" }, "GenaiVertexV1beta1GoogleSearchCallDelta": { "properties": { "arguments": { "$ref": "GenaiVertexV1beta1GoogleSearchCallContentGoogleSearchCallArguments" } }, "type": "object", "id": "GenaiVertexV1beta1GoogleSearchCallDelta" }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfig": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfig", "type": "object", "description": "Specification for a Memory Bank.", "properties": { "customizationConfigs": { "description": "Optional. Configuration for how to customize Memory Bank behavior for a particular scope.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfig" } }, "similaritySearchConfig": { "description": "Optional. Configuration for how to perform similarity search on memories. If not set, the Memory Bank will use the default embedding model `text-embedding-005`.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigSimilaritySearchConfig" }, "generationConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigGenerationConfig", "description": "Optional. Configuration for how to generate memories for the Memory Bank." }, "ttlConfig": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfig", "description": "Optional. Configuration for automatic TTL (\"time-to-live\") of the memories in the Memory Bank. If not set, TTL will not be applied automatically. The TTL can be explicitly set by modifying the `expire_time` of each Memory resource." }, "structuredMemoryConfigs": { "description": "Optional. Configuration for organizing structured memories for a particular scope.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1StructuredMemoryConfig" } }, "disableMemoryRevisions": { "type": "boolean", "description": "If true, no memory revisions will be created for any requests to the Memory Bank." } } }, "GoogleCloudAiplatformV1beta1RolloutOptions": { "id": "GoogleCloudAiplatformV1beta1RolloutOptions", "description": "Configuration for rolling deployments.", "type": "object", "properties": { "maxSurgePercentage": { "description": "Percentage of allowed additional replicas. For autoscaling deployments, this refers to the target replica count.", "format": "int32", "type": "integer" }, "revisionNumber": { "description": "Output only. Read-only. Revision number determines the relative priority of DeployedModels in the same rollout. The DeployedModel with the largest revision number specifies the intended state of the deployment.", "readOnly": true, "format": "int32", "type": "integer" }, "maxSurgeReplicas": { "type": "integer", "description": "Absolute count of allowed additional replicas.", "format": "int32" }, "previousDeployedModel": { "type": "string", "description": "ID of the DeployedModel that this deployment should replace." }, "maxUnavailableReplicas": { "type": "integer", "format": "int32", "description": "Absolute count of replicas allowed to be unavailable." }, "maxUnavailablePercentage": { "format": "int32", "type": "integer", "description": "Percentage of replicas allowed to be unavailable. For autoscaling deployments, this refers to the target replica count." } } }, "GoogleCloudAiplatformV1beta1ListTensorboardExperimentsResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListTensorboardExperimentsResponse", "properties": { "tensorboardExperiments": { "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardExperiment" }, "description": "The TensorboardExperiments mathching the request.", "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as ListTensorboardExperimentsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for TensorboardService.ListTensorboardExperiments." }, "GoogleCloudAiplatformV1beta1TrajectoryPrecisionSpec": { "type": "object", "properties": {}, "description": "Spec for TrajectoryPrecision metric - returns a float score based on average precision of individual tool calls.", "id": "GoogleCloudAiplatformV1beta1TrajectoryPrecisionSpec" }, "GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless": { "description": "Message to configure the serverless mode offered by RAG Engine.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoActionRecognitionInputs": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoActionRecognitionInputs", "properties": { "modelType": { "enumDescriptions": [ "Should not be set.", "A model best tailored to be used within Google Cloud, and which c annot be exported. Default.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as a TensorFlow or TensorFlow Lite model and used on a mobile or edge device afterwards.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) to a Jetson device afterwards.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as a TensorFlow or TensorFlow Lite model and used on a Coral device afterwards." ], "type": "string", "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD", "MOBILE_VERSATILE_1", "MOBILE_JETSON_VERSATILE_1", "MOBILE_CORAL_VERSATILE_1" ] } }, "type": "object" }, "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchResults": { "id": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchResults", "description": "Results for TrajectoryInOrderMatch metric.", "type": "object", "properties": { "trajectoryInOrderMatchMetricValues": { "readOnly": true, "description": "Output only. TrajectoryInOrderMatch metric values.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryInOrderMatchMetricValue" } } } }, "GoogleCloudAiplatformV1beta1DistillationHyperParameters": { "properties": { "adapterSize": { "enum": [ "ADAPTER_SIZE_UNSPECIFIED", "ADAPTER_SIZE_ONE", "ADAPTER_SIZE_TWO", "ADAPTER_SIZE_FOUR", "ADAPTER_SIZE_EIGHT", "ADAPTER_SIZE_SIXTEEN", "ADAPTER_SIZE_THIRTY_TWO" ], "type": "string", "enumDescriptions": [ "Adapter size is unspecified.", "Adapter size 1.", "Adapter size 2.", "Adapter size 4.", "Adapter size 8.", "Adapter size 16.", "Adapter size 32." ], "description": "Optional. Adapter size for distillation." }, "learningRate": { "format": "double", "type": "number", "description": "Optional. Specifies the learning rate for tuning. Mutually exclusive with `learning_rate_multiplier`. This feature is only available for open source models." }, "learningRateMultiplier": { "format": "double", "description": "Optional. Multiplier for adjusting the default learning rate.", "type": "number" }, "batchSize": { "type": "string", "format": "int64", "description": "Optional. Batch size for tuning. This feature is only available for open source models." }, "epochCount": { "type": "string", "description": "Optional. Number of complete passes the model makes over the entire training dataset during training.", "format": "int64" } }, "id": "GoogleCloudAiplatformV1beta1DistillationHyperParameters", "type": "object", "description": "Hyperparameters for Distillation." }, "GoogleCloudAiplatformV1beta1VertexAISearch": { "description": "Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder", "properties": { "datastore": { "type": "string", "description": "Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}`" }, "filter": { "description": "Optional. Filter strings to be passed to the search API.", "type": "string" }, "engine": { "description": "Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`", "type": "string" }, "dataStoreSpecs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1VertexAISearchDataStoreSpec" }, "type": "array", "description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used." }, "maxResults": { "type": "integer", "description": "Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10.", "format": "int32" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1VertexAISearch" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceMapInstance": { "description": "Instance data specified as a map.", "properties": { "mapInstance": { "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData" }, "type": "object", "description": "Optional. Map of instance data." } }, "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceMapInstance", "type": "object" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordMetadataChange": { "description": "An event payload describing a change to the task-level metadata.", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordMetadataChange", "properties": { "metadata": { "description": "Required. The updated task metadata after the change. This is a partial update that will be merged with the existing metadata.", "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } }, "updateMask": { "format": "google-fieldmask", "description": "Optional. A field mask indicating which metadata paths changed. If unset, all fields are updated.", "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1UpdateTensorboardOperationMetadata": { "description": "Details of operations that perform update Tensorboard.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Tensorboard." } }, "id": "GoogleCloudAiplatformV1beta1UpdateTensorboardOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexFeatureStore": { "type": "object", "description": "The config for the Vertex Feature Store.", "properties": { "featureViewResourceName": { "description": "The resource name of the FeatureView. Format: `projects/{project}/locations/{location}/featureOnlineStores/{feature_online_store}/featureViews/{feature_view}`", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigVertexFeatureStore" }, "GoogleLearningVertexApiInteractionsV1beta1ListVoicesResponse": { "id": "GoogleLearningVertexApiInteractionsV1beta1ListVoicesResponse", "type": "object", "properties": { "voices": { "type": "array", "description": "The voices from the specified collection.", "items": { "$ref": "GenaiVertexV1beta1Voice" } }, "nextPageToken": { "description": "A token that can be sent as `page_token` to retrieve the next page. If empty, there are no subsequent pages.", "type": "string" } }, "description": "Response message for `VoicesService.ListVoices`." }, "GoogleCloudAiplatformV1beta1ServingProfileCmekConfig": { "properties": { "encryptionSpec": { "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", "description": "Required. The customer-managed encryption key spec for the Serving Profile." } }, "id": "GoogleCloudAiplatformV1beta1ServingProfileCmekConfig", "description": "Configuration for Customer-Managed Encryption Keys (CMEK).", "type": "object" }, "GoogleCloudAiplatformV1beta1PredictResponse": { "id": "GoogleCloudAiplatformV1beta1PredictResponse", "type": "object", "description": "Response message for PredictionService.Predict.", "properties": { "model": { "type": "string", "description": "Output only. The resource name of the Model which is deployed as the DeployedModel that this prediction hits.", "readOnly": true }, "deployedModelId": { "description": "ID of the Endpoint's DeployedModel that served this prediction.", "type": "string" }, "modelVersionId": { "type": "string", "description": "Output only. The version ID of the Model which is deployed as the DeployedModel that this prediction hits.", "readOnly": true }, "predictions": { "type": "array", "items": { "type": "any" }, "description": "The predictions that are the output of the predictions call. The schema of any single prediction may be specified via Endpoint's DeployedModels' Model's PredictSchemata's prediction_schema_uri." }, "modelDisplayName": { "readOnly": true, "type": "string", "description": "Output only. The display name of the Model which is deployed as the DeployedModel that this prediction hits." }, "metadata": { "description": "Output only. Request-level metadata returned by the model. The metadata type will be dependent upon the model implementation.", "type": "any", "readOnly": true } } }, "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1UpdateExplanationDatasetOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Runtime operation information for ModelService.UpdateExplanationDataset." }, "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigInferenceAgentConfig": { "description": "Configuration that describes an agent.", "id": "GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigInferenceAgentConfig", "properties": { "tools": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "description": "Optional. The tools available to the agent." }, "developerInstruction": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Optional. The developer instruction for the agent." } }, "type": "object" }, "GenaiVertexV1beta1SpeechAnnotation": { "properties": { "style": { "type": "string", "description": "Style instruction for the speech synthesis." }, "speaker": { "description": "The speaker to associate with this turn.", "type": "string" } }, "description": "Speech annotation for text content.", "type": "object", "id": "GenaiVertexV1beta1SpeechAnnotation" }, "GoogleCloudAiplatformV1beta1DedicatedResources": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DedicatedResources", "properties": { "initialReplicaCount": { "type": "integer", "format": "int32", "description": "Immutable. Number of initial replicas being deployed on when scaling the workload up from zero or when creating the workload in case min_replica_count = 0. When min_replica_count \u003e 0 (meaning that the scale-to-zero feature is not enabled), initial_replica_count should not be set. When min_replica_count = 0 (meaning that the scale-to-zero feature is enabled), initial_replica_count should be larger than zero, but no greater than max_replica_count." }, "autoscalingMetricSpecs": { "type": "array", "description": "Immutable. The metric specifications that overrides a resource utilization metric (CPU utilization, accelerator's duty cycle, and so on) target value (default to 60 if not set). At most one entry is allowed per metric. If machine_spec.accelerator_count is above 0, the autoscaling will be based on both CPU utilization and accelerator's duty cycle metrics and scale up when either metrics exceeds its target value while scale down if both metrics are under their target value. The default target value is 60 for both metrics. If machine_spec.accelerator_count is 0, the autoscaling will be based on CPU utilization metric only with default target value 60 if not explicitly set. For example, in the case of Online Prediction, if you want to override target CPU utilization to 80, you should set autoscaling_metric_specs.metric_name to `aiplatform.googleapis.com/prediction/online/cpu/utilization` and autoscaling_metric_specs.target to `80`.", "items": { "$ref": "GoogleCloudAiplatformV1beta1AutoscalingMetricSpec" } }, "machineSpec": { "$ref": "GoogleCloudAiplatformV1beta1MachineSpec", "description": "Required. Immutable. The specification of a single machine being used." }, "scaleToZeroSpec": { "description": "Optional. Specification for scale-to-zero feature.", "$ref": "GoogleCloudAiplatformV1beta1DedicatedResourcesScaleToZeroSpec" }, "spot": { "description": "Optional. If true, schedule the deployment workload on [spot VMs](https://cloud.google.com/kubernetes-engine/docs/concepts/spot-vms).", "type": "boolean" }, "flexStart": { "$ref": "GoogleCloudAiplatformV1beta1FlexStart", "description": "Optional. Immutable. If set, use DWS resource to schedule the deployment workload. reference: (https://cloud.google.com/blog/products/compute/introducing-dynamic-workload-scheduler)" }, "requiredReplicaCount": { "description": "Optional. Number of required available replicas for the deployment to succeed. This field is only needed when partial deployment/mutation is desired. If set, the deploy/mutate operation will succeed once available_replica_count reaches required_replica_count, and the rest of the replicas will be retried. If not set, the default required_replica_count will be min_replica_count.", "format": "int32", "type": "integer" }, "maxReplicaCount": { "format": "int32", "description": "Immutable. The maximum number of replicas that may be deployed on when the traffic against it increases. If the requested value is too large, the deployment will error, but if deployment succeeds then the ability to scale to that many replicas is guaranteed (barring service outages). If traffic increases beyond what its replicas at maximum may handle, a portion of the traffic will be dropped. If this value is not provided, will use min_replica_count as the default value. The value of this field impacts the charge against Agent Platform CPU and GPU quotas. Specifically, you will be charged for (max_replica_count * number of cores in the selected machine type) and (max_replica_count * number of GPUs per replica in the selected machine type).", "type": "integer" }, "minReplicaCount": { "format": "int32", "description": "Required. Immutable. The minimum number of machine replicas that will be always deployed on. This value must be greater than or equal to 1. If traffic increases, it may dynamically be deployed onto more replicas, and as traffic decreases, some of these extra replicas may be freed.", "type": "integer" } }, "description": "A description of resources that are dedicated to a DeployedModel or DeployedIndex, and that need a higher degree of manual configuration." }, "GoogleCloudAiplatformV1beta1ContentMap": { "description": "Map of placeholder in metric prompt template to contents of model input.", "type": "object", "properties": { "values": { "description": "Optional. Map of placeholder to contents.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ContentMapContents" }, "type": "object" } }, "id": "GoogleCloudAiplatformV1beta1ContentMap" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerParsedResponseConversionScorer": { "description": "Scores responses by directly converting the parsed autorater response to a float reward. Note: Reward is clipped to be within `[-1, 1]`, i.e., `reward = max(min(reward, 1.0), -1.0)`.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningAutoraterScorerParsedResponseConversionScorer", "type": "object" }, "GoogleCloudAiplatformV1beta1SpeechConfig": { "description": "Configuration for speech generation.", "id": "GoogleCloudAiplatformV1beta1SpeechConfig", "type": "object", "properties": { "multiSpeakerVoiceConfig": { "description": "The configuration for a multi-speaker text-to-speech request. This field is mutually exclusive with `voice_config`.", "$ref": "GoogleCloudAiplatformV1beta1MultiSpeakerVoiceConfig" }, "languageCode": { "type": "string", "description": "Optional. The language code (ISO 639-1) for the speech synthesis." }, "voiceConfig": { "description": "The configuration for the voice to use.", "$ref": "GoogleCloudAiplatformV1beta1VoiceConfig" } } }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigWeaviate": { "description": "The config for the Weaviate.", "properties": { "collectionName": { "description": "The corresponding collection this corpus maps to. This value cannot be changed after it's set.", "type": "string" }, "httpEndpoint": { "type": "string", "description": "Weaviate DB instance HTTP endpoint. e.g. 34.56.78.90:8080 Vertex RAG only supports HTTP connection to Weaviate. This value cannot be changed after it's set." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigWeaviate" }, "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataMultimodalDatasetInputConfig": { "id": "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataMultimodalDatasetInputConfig", "description": "Specifies the input source and configuration.", "type": "object", "properties": { "bigquerySource": { "description": "BigQuery source table.", "$ref": "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataBigQuerySource" } } }, "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsRequest": { "description": "Request message for TensorboardService.BatchCreateTensorboardRuns.", "type": "object", "properties": { "requests": { "description": "Required. The request message specifying the TensorboardRuns to create. A maximum of 1000 TensorboardRuns can be created in a batch.", "items": { "$ref": "GoogleCloudAiplatformV1beta1CreateTensorboardRunRequest" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1BatchCreateTensorboardRunsRequest" }, "GoogleCloudAiplatformV1beta1TextResponseFormat": { "id": "GoogleCloudAiplatformV1beta1TextResponseFormat", "description": "Configuration for text-specific output formatting.", "type": "object", "properties": { "mimeType": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "JSON output format.", "Plain text output format." ], "enum": [ "MIME_TYPE_UNSPECIFIED", "APPLICATION_JSON", "TEXT_PLAIN" ], "description": "Optional. The IANA standard MIME type of the response." }, "schema": { "description": "Optional. The JSON schema that the output should conform to. Only applicable when mime_type is APPLICATION_JSON.", "type": "any" } } }, "GoogleCloudAiplatformV1beta1EvaluationPromptUserScenario": { "id": "GoogleCloudAiplatformV1beta1EvaluationPromptUserScenario", "description": "User scenario to help simulate multi-turn agent running results.", "type": "object", "properties": { "conversationPlan": { "type": "string", "description": "Required. The plan for the conversation, used to drive the multi-turn agent run and generate the simulated agent evaluation dataset." }, "startingPrompt": { "description": "Required. The prompt that starts the conversation between the simulated user and the agent under test.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1RetrieveContextsRequest": { "description": "Request message for VertexRagService.RetrieveContexts.", "properties": { "vertexRagStore": { "description": "The data source for Vertex RagStore.", "$ref": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStore" }, "query": { "description": "Required. Single RAG retrieve query.", "$ref": "GoogleCloudAiplatformV1beta1RagQuery" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RetrieveContextsRequest" }, "GoogleCloudAiplatformV1beta1Dataset": { "description": "A collection of DataItems and Annotations on them.", "id": "GoogleCloudAiplatformV1beta1Dataset", "type": "object", "properties": { "satisfiesPzi": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "etag": { "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, "updateTime": { "format": "google-datetime", "readOnly": true, "type": "string", "description": "Output only. Timestamp when this Dataset was last updated." }, "satisfiesPzs": { "type": "boolean", "readOnly": true, "description": "Output only. Reserved for future use." }, "name": { "type": "string", "description": "Output only. Identifier. The resource name of the Dataset. Format: `projects/{project}/locations/{location}/datasets/{dataset}`", "readOnly": true }, "metadataSchemaUri": { "description": "Required. Points to a YAML file stored on Google Cloud Storage describing additional information about the Dataset. The schema is defined as an OpenAPI 3.0.2 Schema Object. The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/metadata/.", "type": "string" }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a Dataset. If set, this Dataset and all sub-resources of this Dataset will be secured by this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "savedQueries": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SavedQuery" }, "description": "All SavedQueries belong to the Dataset will be returned in List/Get Dataset response. The annotation_specs field will not be populated except for UI cases which will only use annotation_spec_count. In CreateDataset request, a SavedQuery is created together if this field is set, up to one SavedQuery can be set in CreateDatasetRequest. The SavedQuery should not contain any AnnotationSpec." }, "labels": { "description": "The labels with user-defined metadata to organize your Datasets. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Dataset (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with \"aiplatform.googleapis.com/\" and are immutable. Following system labels exist for each Dataset: * \"aiplatform.googleapis.com/dataset_metadata_schema\": output only, its value is the metadata_schema's title.", "type": "object", "additionalProperties": { "type": "string" } }, "metadata": { "type": "any", "description": "Required. Additional information about the Dataset." }, "description": { "type": "string", "description": "The description of the Dataset." }, "dataItemCount": { "type": "string", "readOnly": true, "format": "int64", "description": "Output only. The number of DataItems in this Dataset. Only apply for non-structured Dataset." }, "modelReference": { "description": "Optional. Reference to the public base model last used by the dataset. Only set for prompt datasets.", "type": "string" }, "metadataArtifact": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the Artifact that was created in MetadataStore when creating the Dataset. The Artifact resource name pattern is `projects/{project}/locations/{location}/metadataStores/{metadata_store}/artifacts/{artifact}`." }, "createTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp when this Dataset was created." }, "displayName": { "type": "string", "description": "Required. The user-defined name of the Dataset. The name can be up to 128 characters long and can consist of any UTF-8 characters." } } }, "GoogleCloudAiplatformV1beta1TrajectoryRecallSpec": { "type": "object", "description": "Spec for TrajectoryRecall metric - returns a float score based on average recall of individual tool calls.", "id": "GoogleCloudAiplatformV1beta1TrajectoryRecallSpec", "properties": {} }, "GoogleCloudAiplatformV1beta1ModelGardenSource": { "properties": { "skipHfModelCache": { "type": "boolean", "description": "Optional. Whether to avoid pulling the model from the HF cache." }, "publicModelName": { "description": "Required. The model garden source model resource name.", "type": "string" }, "versionId": { "description": "Optional. The model garden source model version ID.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ModelGardenSource", "type": "object", "description": "Contains information about the source of the models generated from Model Garden." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningTask": { "description": "A TrainingJob that tunes Hypererparameters of a custom code Model.", "properties": { "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobMetadata" }, "inputs": { "description": "The input parameters of this HyperparameterTuningTask.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningJobSpec" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionHyperparameterTuningTask" }, "GoogleCloudAiplatformV1beta1SummarizationQualityInput": { "properties": { "metricSpec": { "description": "Required. Spec for summarization quality score metric.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationQualitySpec" }, "instance": { "description": "Required. Summarization quality instance.", "$ref": "GoogleCloudAiplatformV1beta1SummarizationQualityInstance" } }, "description": "Input for summarization quality metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SummarizationQualityInput" }, "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerSpec": { "properties": { "imageUri": { "description": "Required. The Artifact Registry Docker image URI (e.g., us-central1-docker.pkg.dev/my-project/my-repo/my-image:tag) of the container image that is to be run on each worker replica.", "type": "string" } }, "description": "Specification for deploying from a custom container image.", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironmentTemplateCustomContainerSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtable": { "type": "object", "properties": { "enableDirectBigtableAccess": { "type": "boolean", "description": "Optional. It true, enable direct access to the Bigtable instance." }, "autoScaling": { "description": "Required. Autoscaling config applied to Bigtable Instance.", "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableAutoScaling" }, "zone": { "description": "Optional. The zone where the underlying Bigtable cluster for the primary Bigtable instance will be provisioned. Only the zone must be provided. For example, only \"us-central1-a\" should be provided.", "type": "string" }, "bigtableMetadata": { "$ref": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtableBigtableMetadata", "description": "Output only. Metadata of the Bigtable instance. Output only.", "readOnly": true } }, "id": "GoogleCloudAiplatformV1beta1FeatureOnlineStoreBigtable" }, "GoogleCloudAiplatformV1beta1CreateTensorboardOperationMetadata": { "description": "Details of operations that perform create Tensorboard.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Tensorboard." } }, "id": "GoogleCloudAiplatformV1beta1CreateTensorboardOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingChunkWeb": { "id": "GoogleCloudAiplatformV1beta1GroundingChunkWeb", "type": "object", "properties": { "domain": { "description": "The domain of the web page that contains the evidence. This can be used to filter out low-quality sources.", "type": "string" }, "uri": { "description": "The URI of the web page that contains the evidence.", "type": "string" }, "title": { "description": "The title of the web page that contains the evidence.", "type": "string" } }, "description": "A `Web` chunk is a piece of evidence that comes from a web page. It contains the URI of the web page, the title of the page, and the domain of the page. This is used to provide the user with a link to the source of the information." }, "GoogleCloudAiplatformV1beta1ListSessionsResponse": { "id": "GoogleCloudAiplatformV1beta1ListSessionsResponse", "properties": { "sessions": { "type": "array", "description": "A list of sessions matching the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Session" } }, "nextPageToken": { "description": "A token, which can be sent as ListSessionsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.", "type": "string" } }, "description": "Response message for SessionService.ListSessions.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingMetadata", "description": "Model metadata specific to AutoML Forecasting.", "properties": { "evaluatedDataItemsBigqueryUri": { "description": "BigQuery destination uri for exported evaluated examples.", "type": "string" }, "trainCostMilliNodeHours": { "description": "Output only. The actual training cost of the model, expressed in milli node hours, i.e. 1,000 value in this field means 1 node hour. Guaranteed to not exceed the train budget.", "type": "string", "format": "int64" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1NearestNeighborQueryStringFilter": { "description": "String filter is used to search a subset of the entities by using boolean rules on string columns. For example: if a query specifies string filter with 'name = color, allow_tokens = {red, blue}, deny_tokens = {purple}',' then that query will match entities that are red or blue, but if those points are also purple, then they will be excluded even if they are red/blue. Only string filter is supported for now, numeric filter will be supported in the near future.", "type": "object", "id": "GoogleCloudAiplatformV1beta1NearestNeighborQueryStringFilter", "properties": { "allowTokens": { "description": "Optional. The allowed tokens.", "items": { "type": "string" }, "type": "array" }, "denyTokens": { "type": "array", "items": { "type": "string" }, "description": "Optional. The denied tokens." }, "name": { "description": "Required. Column names in BigQuery that used as filters.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessResult": { "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringHelpfulnessResult", "type": "object", "properties": { "score": { "format": "float", "description": "Output only. Question Answering Helpfulness score.", "readOnly": true, "type": "number" }, "explanation": { "description": "Output only. Explanation for question answering helpfulness score.", "type": "string", "readOnly": true }, "confidence": { "description": "Output only. Confidence for question answering helpfulness score.", "format": "float", "type": "number", "readOnly": true } }, "description": "Spec for question answering helpfulness result." }, "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethodLastEntry": { "description": "Configuration for using only the last entry of the conversation history as the search key.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1StoredContentsExampleSearchKeyGenerationMethodLastEntry", "type": "object" }, "GoogleCloudAiplatformV1beta1ListA2ATaskRecordsResponse": { "properties": { "a2aTaskRecords": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecord" }, "description": "List of A2ATaskRecords in the requested page." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as A2ATaskRecordService.ListA2ATaskRecordsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages." } }, "description": "Response message for A2ATaskRecordService.ListA2ATaskRecords.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListA2ATaskRecordsResponse" }, "GoogleCloudAiplatformV1beta1ListReasoningEnginesResponse": { "id": "GoogleCloudAiplatformV1beta1ListReasoningEnginesResponse", "description": "Response message for ReasoningEngineService.ListReasoningEngines", "type": "object", "properties": { "reasoningEngines": { "description": "List of ReasoningEngines in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngine" } }, "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListReasoningEnginesRequest.page_token to obtain that page.", "type": "string" } } }, "GenaiVertexV1beta1GoogleMapsCallStep": { "properties": { "arguments": { "description": "The arguments to pass to the Google Maps tool.", "$ref": "GenaiVertexV1beta1GoogleMapsCallStepGoogleMapsCallStepArguments" } }, "description": "Google Maps call step.", "id": "GenaiVertexV1beta1GoogleMapsCallStep", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDataset": { "properties": { "timestampField": { "description": "The timestamp field. Usually for serving data.", "type": "string" }, "bigquerySource": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringBigQuerySource", "description": "BigQuery data source." }, "vertexDataset": { "type": "string", "description": "Resource name of the Vertex AI managed dataset." }, "gcsSource": { "description": "Google Cloud Storage data source.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDatasetModelMonitoringGcsSource" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringInputModelMonitoringDataset", "description": "Input dataset spec.", "type": "object" }, "GoogleTypeInterval": { "id": "GoogleTypeInterval", "properties": { "endTime": { "format": "google-datetime", "type": "string", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end." }, "startTime": { "type": "string", "format": "google-datetime", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." } }, "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "type": "object" }, "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1QuestionAnsweringQualityInstance", "description": "Spec for question answering quality instance.", "properties": { "context": { "description": "Required. Text to answer the question.", "type": "string" }, "prediction": { "type": "string", "description": "Required. Output of the evaluated model." }, "instruction": { "type": "string", "description": "Required. Question Answering prompt for LLM." }, "reference": { "type": "string", "description": "Optional. Ground truth used to compare against the prediction." } } }, "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineRequest": { "description": "Request message for ReasoningEngineExecutionService.CancelAsyncQueryReasoningEngine.", "type": "object", "id": "GoogleCloudAiplatformV1beta1CancelAsyncQueryReasoningEngineRequest", "properties": { "operationName": { "type": "string", "description": "Required. The name of the longrunning operation returned from AsyncQueryReasoningEngine. Format: `projects/{project}/locations/{location}/operations/{operation}`" } } }, "GoogleCloudAiplatformV1beta1ProbeHttpHeader": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ProbeHttpHeader", "properties": { "name": { "type": "string", "description": "The header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header." }, "value": { "description": "The header field value", "type": "string" } }, "description": "HttpHeader describes a custom header to be used in HTTP probes" }, "GoogleCloudAiplatformV1beta1RebaseTunedModelRequest": { "id": "GoogleCloudAiplatformV1beta1RebaseTunedModelRequest", "description": "Request message for GenAiTuningService.RebaseTunedModel.", "properties": { "artifactDestination": { "description": "Optional. The Google Cloud Storage location to write the artifacts to.", "$ref": "GoogleCloudAiplatformV1beta1GcsDestination" }, "deployToSameEndpoint": { "description": "Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag is set to true, the new model will be deployed to the same endpoint as the original model. WARNING: If you deploy to the same endpoint, the original model will be un-deployed and replaced by the new model.", "type": "boolean" }, "tunedModelRef": { "$ref": "GoogleCloudAiplatformV1beta1TunedModelRef", "description": "Required. A reference to the tuned model to rebase." }, "tuningJob": { "$ref": "GoogleCloudAiplatformV1beta1TuningJob", "description": "Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListRagMetadataResponse": { "id": "GoogleCloudAiplatformV1beta1ListRagMetadataResponse", "type": "object", "properties": { "ragMetadata": { "description": "List of RagMetadata in the requested page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1RagMetadata" }, "type": "array" }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListRagMetadataRequest.page_token to obtain that page." } }, "description": "Response message for VertexRagDataService.ListRagMetadata." }, "GoogleCloudAiplatformV1beta1IngestEventsRequest": { "properties": { "revisionLabels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. Labels to be applied to the generated memory revisions. For example, you can use this to label a revision with its data source." }, "revisionTtl": { "type": "string", "format": "google-duration", "description": "Optional. The TTL for the revision. The expiration time is computed: now + TTL." }, "directContentsSource": { "$ref": "GoogleCloudAiplatformV1beta1IngestionDirectContentsSource", "description": "Ingest events directly from the request." }, "generationTriggerConfig": { "description": "Optional. Configuration for triggering memory generation from this ingestion. If not set, then the stream will be force flushed immediately.", "$ref": "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfig" }, "disableMemoryRevisions": { "description": "Optional. If true, no revisions will be created for this request.", "type": "boolean" }, "forceFlush": { "description": "Optional. Forces a flush of all pending events in the stream and triggers memory generation immediately bypassing any conditions configured in the `generation_trigger_config`.", "type": "boolean" }, "streamId": { "description": "Optional. The ID of the stream to ingest events into. If not provided, a new one will be created.", "type": "string" }, "metadata": { "type": "object", "description": "Optional. User-provided metadata for the generated memories. This is not generated by Memory Bank.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1MemoryMetadataValue" } }, "revisionExpireTime": { "format": "google-datetime", "type": "string", "description": "Optional. Timestamp of when the revision is considered expired. If not set, the memory revision will be kept until manually deleted." }, "metadataMergeStrategy": { "enum": [ "METADATA_MERGE_STRATEGY_UNSPECIFIED", "OVERWRITE", "MERGE", "REQUIRE_EXACT_MATCH" ], "description": "Optional. The strategy to use when applying metadata to existing memories.", "type": "string", "enumDescriptions": [ "Unspecified metadata merge strategy. If unspecified, the default behavior is to overwrite existing metadata (`OVERWRITE`).", "Replace the metadata of the updated memories with the new metadata.", "Append new metadata to the existing metadata. If there are duplicate keys, the existing values will be overwritten.", "Restrict consolidation to memories that have exactly the same metadata as the request. If a memory doesn't have the same metadata, it is not eligible for consolidation." ] }, "scope": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Required. The scope of the memories that should be generated from the stream. Memories will be consolidated across memories with the same scope. Scope values cannot contain the wildcard character '*'." } }, "type": "object", "description": "Request message for MemoryBankService.IngestEvents.", "id": "GoogleCloudAiplatformV1beta1IngestEventsRequest" }, "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentRequest": { "description": "Request message for SandboxEnvironmentExecutionService.Execute.", "properties": { "inputs": { "type": "array", "description": "Required. The inputs to the sandbox environment.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Chunk" } } }, "id": "GoogleCloudAiplatformV1beta1ExecuteSandboxEnvironmentRequest", "type": "object" }, "GenaiVertexV1beta1ExaAISearchConfig": { "description": "Used to specify configuration for ExaAISearch.", "properties": { "apiKey": { "type": "string", "description": "Required. The API key for ExaAiSearch." }, "customConfig": { "description": "Optional. This field can be used to pass any parameter from the Exa.ai Search API.", "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "type": "object" } }, "id": "GenaiVertexV1beta1ExaAISearchConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigTreeAHConfig": { "id": "GoogleCloudAiplatformV1beta1FeatureViewIndexConfigTreeAHConfig", "type": "object", "description": "Configuration options for the tree-AH algorithm.", "properties": { "leafNodeEmbeddingCount": { "type": "string", "format": "int64", "description": "Optional. Number of embeddings on each leaf node. The default value is 1000 if not set." } } }, "GoogleCloudAiplatformV1beta1CreateFeatureViewOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CreateFeatureViewOperationMetadata", "properties": { "genericMetadata": { "description": "Operation metadata for FeatureView Create.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Details of operations that perform create FeatureView.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfigGranularTtlConfig": { "properties": { "generateUpdatedTtl": { "description": "Optional. The TTL duration for memories updated via GenerateMemories (GenerateMemoriesResponse.GeneratedMemory.Action.UPDATED). In the case of an UPDATE action, the `expire_time` of the existing memory will be updated to the new value (now + TTL).", "format": "google-duration", "type": "string" }, "generateCreatedTtl": { "type": "string", "description": "Optional. The TTL duration for memories newly generated via GenerateMemories (GenerateMemoriesResponse.GeneratedMemory.Action.CREATED).", "format": "google-duration" }, "createTtl": { "description": "Optional. The TTL duration for memories uploaded via CreateMemory.", "type": "string", "format": "google-duration" } }, "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigTtlConfigGranularTtlConfig", "description": "Configuration for TTL of the memories in the Memory Bank based on the action that created or updated the memory.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecasting": { "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingInputs", "description": "The input parameters of this TrainingJob." }, "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecastingMetadata" } }, "description": "A TrainingJob that trains and uploads an AutoML Forecasting Model.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionTftForecasting", "type": "object" }, "GoogleCloudAiplatformV1beta1BlurBaselineConfig": { "properties": { "maxBlurSigma": { "type": "number", "description": "The standard deviation of the blur kernel for the blurred baseline. The same blurring parameter is used for both the height and the width dimension. If not set, the method defaults to the zero (i.e. black for images) baseline.", "format": "float" } }, "id": "GoogleCloudAiplatformV1beta1BlurBaselineConfig", "description": "Config for blur baseline. When enabled, a linear path from the maximally blurred image to the input image is created. Using a blurred baseline instead of zero (black image) is motivated by the BlurIG approach explained here: https://arxiv.org/abs/2004.03383", "type": "object" }, "GenaiVertexV1beta1ProcessingCallDelta": { "type": "object", "id": "GenaiVertexV1beta1ProcessingCallDelta", "description": "Streaming delta for a server-initiated media processing step.", "properties": {} }, "GoogleCloudAiplatformV1beta1DisableMonitoredAgentRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1DisableMonitoredAgentRequest", "description": "Request message for AgentAnomalyDetectionService.DisableMonitoredAgent.", "properties": {} }, "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPoint": { "properties": { "baselineStats": { "description": "Statistics from baseline dataset.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValue" }, "schedule": { "description": "Schedule resource name.", "type": "string" }, "algorithm": { "type": "string", "description": "Algorithm used to calculated the metrics, eg: jensen_shannon_divergence, l_infinity." }, "modelMonitoringJob": { "type": "string", "description": "Model monitoring job resource name." }, "thresholdValue": { "description": "Threshold value.", "type": "number", "format": "double" }, "currentStats": { "description": "Statistics from current dataset.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValue" }, "hasAnomaly": { "description": "Indicate if the statistics has anomaly.", "type": "boolean" }, "createTime": { "description": "Statistics create time.", "type": "string", "format": "google-datetime" } }, "type": "object", "description": "Represents a single statistics data point.", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPoint" }, "GoogleCloudAiplatformV1beta1SchemaPromptInstanceVariableValue": { "properties": { "partList": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecPartList", "description": "The parts of the variable value." } }, "description": "The value of a variable in prompt.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPromptInstanceVariableValue" }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponseWriteResponse": { "description": "Details about the write for each key.", "properties": { "onlineStoreWriteTime": { "type": "string", "description": "When the feature values were written to the online store. If FeatureViewDirectWriteResponse.status is not OK, this field is not populated.", "format": "google-datetime" }, "dataKey": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDataKey", "description": "What key is this write response associated with." } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponseWriteResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1TaskDescriptionStrategy": { "id": "GoogleCloudAiplatformV1beta1TaskDescriptionStrategy", "properties": { "taskDescription": { "description": "Required. A general description of the type of synthetic data you want to generate. For example, \"Generate customer reviews for a new smartphone.\"", "type": "string" } }, "description": "Defines a generation strategy based on a general task description.", "type": "object" }, "GoogleCloudAiplatformV1beta1A2aPart": { "properties": { "url": { "type": "string", "description": "Optional. A URL pointing to the content." }, "filename": { "description": "Optional. The name of the file, when the part represents a file.", "type": "string" }, "mediaType": { "description": "Optional. The IANA media type of the content, e.g. \"text/plain\" or \"image/png\".", "type": "string" }, "raw": { "type": "string", "description": "Optional. Raw binary content.", "format": "byte" }, "data": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. Structured data content." }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "description": "Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases." }, "text": { "description": "Optional. Textual content.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1A2aPart", "description": "A single part of a message or artifact. A part carries exactly one kind of content." }, "GenaiVertexV1beta1VideoContent": { "id": "GenaiVertexV1beta1VideoContent", "description": "A video content block. ", "properties": { "processingConfig": { "$ref": "GenaiVertexV1beta1VideoContentMediaProcessing" }, "data": { "format": "byte", "description": "The video content.", "type": "string" }, "uri": { "description": "The URI of the video.", "type": "string" }, "name": { "description": "A user-defined name for this content block. Can be referenced by the model in the final response.", "type": "string" }, "mimeTypeString": { "type": "string", "description": "Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key." }, "processingType": { "enum": [ "PROCESSING_UNSPECIFIED", "STATIC", "AGENTIC" ], "enumDescriptions": [ "Default. Uses model-specific processing (3.5 Pro+ --\u003e AGENTIC, older models --\u003e STATIC)", "Fixed-rate frame extraction. All frames placed in context.", "Model-driven dynamic navigation." ], "type": "string" }, "resolution": { "description": "The resolution of the media.", "enumDescriptions": [ "Default value. This value is unused.", "Low resolution.", "Medium resolution.", "High resolution.", "Ultra high resolution." ], "enum": [ "MEDIA_RESOLUTION_UNSPECIFIED", "LOW", "MEDIUM", "HIGH", "ULTRA_HIGH" ], "type": "string" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataFeatureValueDomain": { "description": "Domain details of the input feature value. Provides numeric information about the feature, such as its range (min, max). If the feature has been pre-processed, for example with z-scoring, then it provides information about how to recover the original feature. For example, if the input feature is an image and it has been pre-processed to obtain 0-mean and stddev = 1 values, then original_mean, and original_stddev refer to the mean and stddev of the original feature (e.g. image tensor) from which input feature (with mean = 0 and stddev = 1) was obtained.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ExplanationMetadataInputMetadataFeatureValueDomain", "properties": { "maxValue": { "format": "float", "description": "The maximum permissible value for this feature.", "type": "number" }, "originalMean": { "description": "If this input feature has been normalized to a mean value of 0, the original_mean specifies the mean value of the domain prior to normalization.", "type": "number", "format": "float" }, "originalStddev": { "description": "If this input feature has been normalized to a standard deviation of 1.0, the original_stddev specifies the standard deviation of the domain prior to normalization.", "format": "float", "type": "number" }, "minValue": { "description": "The minimum permissible value for this feature.", "type": "number", "format": "float" } } }, "GoogleCloudAiplatformV1beta1GoogleMaps": { "id": "GoogleCloudAiplatformV1beta1GoogleMaps", "properties": { "enableWidget": { "type": "boolean", "description": "Optional. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. If true, include the widget context token in the response.", "deprecated": true }, "groundingTypes": { "description": "Optional. Specifies the types of Google Maps grounding to enable. Defaults to `places` when unset.", "$ref": "GoogleCloudAiplatformV1beta1GoogleMapsGroundingTypes" } }, "type": "object", "description": "Tool to retrieve public maps data for grounding, powered by Google." }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpecShieldedInstanceConfig": { "description": "A set of Shielded VM options for the execution VM. Mirrors `google.cloud.notebooks.v2.ShieldedInstanceConfig`. See https://cloud.google.com/compute/docs/instances/modifying-shielded-vm.", "properties": { "enableIntegrityMonitoring": { "description": "Optional. Whether the VM instance has integrity monitoring enabled.", "type": "boolean" }, "enableVtpm": { "description": "Optional. Whether the VM instance has vTPM enabled.", "type": "boolean" }, "enableSecureBoot": { "type": "boolean", "description": "Optional. Whether the VM instance has Secure Boot enabled. Disabled by default." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobCustomEnvironmentSpecShieldedInstanceConfig" }, "GoogleCloudAiplatformV1beta1ListExtensionsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListExtensionsRequest.page_token to obtain that page." }, "extensions": { "description": "List of Extension in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Extension" } } }, "description": "Response message for ExtensionRegistryService.ListExtensions", "id": "GoogleCloudAiplatformV1beta1ListExtensionsResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1CachedContentUsageMetadata": { "description": "Metadata on the usage of the cached content.", "type": "object", "properties": { "videoDurationSeconds": { "format": "int32", "type": "integer", "description": "Duration of video in seconds." }, "totalTokenCount": { "description": "Total number of tokens that the cached content consumes.", "type": "integer", "format": "int32" }, "textCount": { "type": "integer", "description": "Number of text characters.", "format": "int32" }, "audioDurationSeconds": { "type": "integer", "description": "Duration of audio in seconds.", "format": "int32" }, "imageCount": { "format": "int32", "type": "integer", "description": "Number of images." } }, "id": "GoogleCloudAiplatformV1beta1CachedContentUsageMetadata" }, "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchSpec": { "properties": {}, "id": "GoogleCloudAiplatformV1beta1TrajectoryAnyOrderMatchSpec", "description": "Spec for TrajectoryAnyOrderMatch metric - returns 1 if all tool calls in the reference trajectory appear in the predicted trajectory in any order, else 0.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTextDatasetMetadata": { "id": "GoogleCloudAiplatformV1beta1SchemaTextDatasetMetadata", "properties": { "gcsBucket": { "description": "Google Cloud Storage Bucket name that contains the blob data of this Dataset.", "type": "string" }, "dataItemSchemaUri": { "type": "string", "description": "Points to a YAML file stored on Google Cloud Storage describing payload of the Text DataItems that belong to this Dataset." } }, "description": "The metadata of Datasets that contain Text DataItems.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTftFeatureImportance": { "properties": { "attributeWeights": { "type": "array", "items": { "type": "number", "format": "float" } }, "contextColumns": { "items": { "type": "string" }, "type": "array" }, "horizonWeights": { "items": { "type": "number", "format": "float" }, "type": "array" }, "horizonColumns": { "type": "array", "items": { "type": "string" } }, "attributeColumns": { "type": "array", "items": { "type": "string" } }, "contextWeights": { "items": { "format": "float", "type": "number" }, "type": "array", "description": "TFT feature importance values. Each pair for {context/horizon/attribute} should have the same shape since the weight corresponds to the column names." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionTftFeatureImportance" }, "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateRequest": { "description": "Request message for VizierService.CheckTrialEarlyStoppingState.", "type": "object", "properties": {}, "id": "GoogleCloudAiplatformV1beta1CheckTrialEarlyStoppingStateRequest" }, "GoogleCloudAiplatformV1beta1GenerateVideoResponse": { "description": "Generate video response.", "type": "object", "properties": { "raiMediaFilteredReasons": { "items": { "type": "string" }, "type": "array", "description": "Returns rai failure reasons if any." }, "raiMediaFilteredCount": { "description": "Returns if any videos were filtered due to RAI policies.", "type": "integer", "format": "int32" }, "generatedSamples": { "type": "array", "deprecated": true, "description": "The cloud storage uris of the generated videos.", "items": { "type": "string" } }, "videos": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GenerateVideoResponseVideo" }, "type": "array", "description": "List of video bytes or Cloud Storage URIs of the generated videos." } }, "id": "GoogleCloudAiplatformV1beta1GenerateVideoResponse" }, "CloudAiLargeModelsVisionRaiInfo": { "type": "object", "properties": { "raiCategories": { "description": "List of rai categories' information to return", "items": { "type": "string" }, "type": "array" }, "blockedEntities": { "description": "List of blocked entities from the blocklist if it is detected.", "items": { "type": "string" }, "type": "array" }, "modelName": { "type": "string", "description": "The model name used to indexing into the RaiFilterConfig map. Would either be one of imagegeneration@002-006, imagen-3.0-... api endpoint names, or internal names used for mapping to different filter configs (genselfie, ai_watermark) than its api endpoint." }, "scores": { "description": "List of rai scores mapping to the rai categories. Rounded to 1 decimal place.", "items": { "type": "number", "format": "float" }, "type": "array" }, "detectedLabels": { "description": "The list of detected labels for different rai categories.", "type": "array", "items": { "$ref": "CloudAiLargeModelsVisionRaiInfoDetectedLabels" } } }, "description": "Next ID: 6", "id": "CloudAiLargeModelsVisionRaiInfo" }, "GoogleCloudAiplatformV1beta1SamplingStrategyRandomSampleConfig": { "id": "GoogleCloudAiplatformV1beta1SamplingStrategyRandomSampleConfig", "properties": { "sampleRate": { "description": "Sample rate (0, 1]", "format": "double", "type": "number" } }, "type": "object", "description": "Requests are randomly selected." }, "GoogleCloudAiplatformV1beta1EvaluationRubricConfig": { "id": "GoogleCloudAiplatformV1beta1EvaluationRubricConfig", "type": "object", "properties": { "predefinedRubricGenerationSpec": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec", "description": "Dynamically generate rubrics using a predefined spec." }, "rubricGenerationSpec": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricGenerationSpec", "description": "Dynamically generate rubrics using this specification." }, "rubricGroupKey": { "type": "string", "description": "Required. The key used to save the generated rubrics. If a generation spec is provided, this key will be used for the name of the generated rubric group. Otherwise, this key will be used to look up the existing rubric group on the evaluation item. Note that if a rubric group key is specified on both a rubric config and an evaluation metric, the key from the metric will be used to select the rubrics for evaluation." } }, "description": "Configuration for a rubric group to be generated/saved for evaluation." }, "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInstance": { "type": "object", "id": "GoogleCloudAiplatformV1beta1TrajectoryExactMatchInstance", "properties": { "predictedTrajectory": { "description": "Required. Spec for predicted tool call trajectory.", "$ref": "GoogleCloudAiplatformV1beta1Trajectory" }, "referenceTrajectory": { "$ref": "GoogleCloudAiplatformV1beta1Trajectory", "description": "Required. Spec for reference tool call trajectory." } }, "description": "Spec for TrajectoryExactMatch instance." }, "GoogleCloudAiplatformV1beta1ProcessDataRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ProcessDataRequest", "properties": { "gcsSource": { "description": "Optional. A JSONL file containing a list of files to process stored in the user's GCS bucket.", "$ref": "GoogleCloudAiplatformV1beta1GcsSource" }, "outputBucketProjectNumber": { "description": "Optional. The project number of the project that the user expects to own the output Cloud Storage bucket referenced by gcs_destination. The service verifies that the bucket is actually owned by this project before writing to it, in order to prevent bucket squatting. If unset, the bucket is verified to be owned by the project the request is made for (parent).", "type": "string", "format": "int64" }, "veoSpec": { "$ref": "GoogleCloudAiplatformV1beta1ProcessDataRequestVeoSpec", "description": "Optional. Spec for Veo data processing." }, "gcsDestination": { "$ref": "GoogleCloudAiplatformV1beta1GcsDestination", "description": "Optional. The GCS bucket to store the processed videos and captions data." }, "inputBucketProjectNumber": { "type": "string", "format": "int64", "description": "Optional. The project number of the project that the user expects to own the input Cloud Storage bucket referenced by gcs_source. The service verifies that the bucket is actually owned by this project before reading from it, in order to prevent bucket squatting. If unset, the bucket is verified to be owned by the project the request is made for (parent)." } }, "description": "Request message for GenAiTuningService.ProcessData." }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoObjectTrackingPredictionResultFrame": { "description": "The fields `xMin`, `xMax`, `yMin`, and `yMax` refer to a bounding box, i.e. the rectangle over the video frame pinpointing the found AnnotationSpec. The coordinates are relative to the frame size, and the point 0,0 is in the top left of the frame.", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoObjectTrackingPredictionResultFrame", "properties": { "timeOffset": { "description": "A time (frame) of a video in which the object has been detected. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end.", "type": "string", "format": "google-duration" }, "yMax": { "type": "number", "description": "The bottommost coordinate of the bounding box.", "format": "float" }, "xMin": { "type": "number", "description": "The leftmost coordinate of the bounding box.", "format": "float" }, "yMin": { "format": "float", "description": "The topmost coordinate of the bounding box.", "type": "number" }, "xMax": { "description": "The rightmost coordinate of the bounding box.", "type": "number", "format": "float" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1GroundingMetadata": { "properties": { "imageSearchQueries": { "items": { "type": "string" }, "description": "Optional. The image search queries that were used to generate the content. This field is populated only when the grounding source is Google Search with the Image Search search_type enabled.", "type": "array" }, "groundingSupports": { "description": "Optional. A list of grounding supports that connect the generated content to the grounding chunks. This field is populated when the grounding source is Google Search or Vertex AI Search.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1GroundingSupport" } }, "retrievalMetadata": { "$ref": "GoogleCloudAiplatformV1beta1RetrievalMetadata", "readOnly": true, "description": "Optional. Output only. Metadata related to the retrieval grounding source." }, "webSearchQueries": { "description": "Optional. The web search queries that were used to generate the content. This field is populated only when the grounding source is Google Search.", "type": "array", "items": { "type": "string" } }, "searchEntryPoint": { "description": "Optional. A web search entry point that can be used to display search results. This field is populated only when the grounding source is Google Search.", "$ref": "GoogleCloudAiplatformV1beta1SearchEntryPoint" }, "sourceFlaggingUris": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GroundingMetadataSourceFlaggingUri" }, "description": "Optional. Output only. A list of URIs that can be used to flag a place or review for inappropriate content. This field is populated only when the grounding source is Google Maps.", "type": "array", "readOnly": true }, "retrievalQueries": { "items": { "type": "string" }, "type": "array", "description": "Optional. The queries that were executed by the retrieval tools. This field is populated only when the grounding source is a retrieval tool, such as Vertex AI Search." }, "groundingChunks": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GroundingChunk" }, "type": "array", "description": "A list of supporting references retrieved from the grounding source. This field is populated when the grounding source is Google Search, Vertex AI Search, or Google Maps." }, "googleMapsWidgetContextToken": { "deprecated": true, "readOnly": true, "type": "string", "description": "Optional. Output only. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and will no longer be populated once removed. A token that can be used to render a Google Maps widget with the contextual data. This field is populated only when the grounding source is Google Maps." } }, "description": "Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources.", "id": "GoogleCloudAiplatformV1beta1GroundingMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordEvent": { "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordEvent", "description": "An event that records a single change applied to a task's state.", "type": "object", "properties": { "generation": { "readOnly": true, "format": "int64", "description": "Output only. The generation number of the task after this event is applied.", "type": "string" }, "createTime": { "type": "string", "description": "Output only. The time at which the event was created.", "readOnly": true, "format": "google-datetime" }, "eventData": { "description": "Required. The data describing the change carried by this event.", "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordEventData" }, "metadata": { "description": "Optional. Additional context or parameters related to the event. Extensions can be used to strongly type metadata values for specific use cases.", "type": "object", "additionalProperties": { "description": "Properties of the object.", "type": "any" } } } }, "GoogleCloudAiplatformV1beta1MergeVersionAliasesRequest": { "description": "Request message for ModelService.MergeVersionAliases.", "type": "object", "properties": { "versionAliases": { "description": "Required. The set of version aliases to merge. The alias should be at most 128 characters, and match `a-z{0,126}[a-z-0-9]`. Add the `-` prefix to an alias means removing that alias from the version. `-` is NOT counted in the 128 characters. Example: `-golden` means removing the `golden` alias from the version. There is NO ordering in aliases, which means 1) The aliases returned from GetModel API might not have the exactly same order from this MergeVersionAliases API. 2) Adding and deleting the same alias in the request is not recommended, and the 2 operations will be cancelled out.", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1MergeVersionAliasesRequest" }, "GoogleCloudAiplatformV1beta1ListEventsResponse": { "properties": { "sessionEvents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SessionEvent" }, "description": "A list of events matching the request. Ordered by timestamp in ascending order." }, "nextPageToken": { "description": "A token, which can be sent as ListEventsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.", "type": "string" } }, "description": "Response message for SessionService.ListEvents.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ListEventsResponse" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationNumericTransformation": { "description": "Training pipeline will perform following transformation functions. * The value converted to float32. * The z_score of the value. * log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * z_score of log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionSeq2SeqPlusForecastingInputsTransformationNumericTransformation", "type": "object", "properties": { "columnName": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoObjectTrackingPredictionResult": { "properties": { "confidence": { "description": "The Model's confidence in correction of this prediction, higher value means higher confidence.", "type": "number", "format": "float" }, "displayName": { "type": "string", "description": "The display name of the AnnotationSpec that had been identified." }, "frames": { "type": "array", "description": "All of the frames of the video in which a single object instance has been detected. The bounding boxes in the frames identify the same object.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoObjectTrackingPredictionResultFrame" } }, "timeSegmentEnd": { "format": "google-duration", "description": "The end, inclusive, of the video's time segment in which the object instance has been detected. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end.", "type": "string" }, "id": { "description": "The resource ID of the AnnotationSpec that had been identified.", "type": "string" }, "timeSegmentStart": { "description": "The beginning, inclusive, of the video's time segment in which the object instance has been detected. Expressed as a number of seconds as measured from the start of the video, with fractions up to a microsecond precision, and with \"s\" appended at the end.", "format": "google-duration", "type": "string" } }, "type": "object", "description": "Prediction output format for Video Object Tracking.", "id": "GoogleCloudAiplatformV1beta1SchemaPredictPredictionVideoObjectTrackingPredictionResult" }, "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataGcsSource": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTimeSeriesDatasetMetadataGcsSource", "properties": { "uri": { "type": "array", "items": { "type": "string" }, "description": "Cloud Storage URI of one or more files. Only CSV files are supported. The first line of the CSV file is used as the header. If there are multiple files, the header is the first line of the lexicographically first file, the other files must either contain the exact same header or omit the header." } } }, "GoogleCloudAiplatformV1beta1FulfillmentInput": { "properties": { "metricSpec": { "description": "Required. Spec for fulfillment score metric.", "$ref": "GoogleCloudAiplatformV1beta1FulfillmentSpec" }, "instance": { "description": "Required. Fulfillment instance.", "$ref": "GoogleCloudAiplatformV1beta1FulfillmentInstance" } }, "id": "GoogleCloudAiplatformV1beta1FulfillmentInput", "description": "Input for fulfillment metric.", "type": "object" }, "GoogleCloudAiplatformV1beta1CancelDataLabelingJobRequest": { "description": "Request message for JobService.CancelDataLabelingJob.", "id": "GoogleCloudAiplatformV1beta1CancelDataLabelingJobRequest", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1UrlContextMetadata": { "properties": { "urlMetadata": { "items": { "$ref": "GoogleCloudAiplatformV1beta1UrlMetadata" }, "readOnly": true, "description": "Output only. A list of URL metadata, with one entry for each URL retrieved by the tool.", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1UrlContextMetadata", "description": "Metadata returned when the model uses the `url_context` tool to get information from a user-provided URL." }, "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualitySpec": { "id": "GoogleCloudAiplatformV1beta1PairwiseQuestionAnsweringQualitySpec", "type": "object", "properties": { "version": { "description": "Optional. Which version to use for evaluation.", "format": "int32", "type": "integer" }, "useReference": { "type": "boolean", "description": "Optional. Whether to use instance.reference to compute question answering quality." } }, "description": "Spec for pairwise question answering quality score metric." }, "GoogleCloudAiplatformV1beta1Neighbor": { "type": "object", "properties": { "neighborId": { "type": "string", "readOnly": true, "description": "Output only. The neighbor id." }, "neighborDistance": { "type": "number", "description": "Output only. The neighbor distance.", "readOnly": true, "format": "double" } }, "id": "GoogleCloudAiplatformV1beta1Neighbor", "description": "Neighbors for example-based explanations." }, "GoogleCloudAiplatformV1beta1AudioResponseFormat": { "type": "object", "id": "GoogleCloudAiplatformV1beta1AudioResponseFormat", "description": "Configuration for audio-specific output formatting.", "properties": { "mimeType": { "type": "string", "enum": [ "MIME_TYPE_UNSPECIFIED", "AUDIO_MP3", "AUDIO_OGG_OPUS", "AUDIO_L16", "AUDIO_WAV", "AUDIO_ALAW", "AUDIO_MULAW" ], "description": "Optional. The MIME type of the audio output.", "enumDescriptions": [ "Default value. This value is unused.", "MP3 audio format.", "OGG Opus audio format.", "Raw PCM (L16) audio format.", "WAV audio format.", "A-law audio format.", "Mu-law audio format." ] }, "delivery": { "enumDescriptions": [ "Default value. This value is unused.", "Generated bytes are returned inline in the response.", "Generated content is stored and a URI is returned." ], "type": "string", "enum": [ "DELIVERY_UNSPECIFIED", "INLINE", "URI" ], "description": "Optional. Delivery mode for the generated content." }, "bitRate": { "type": "integer", "format": "int32", "description": "Optional. Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus)." }, "sampleRate": { "format": "int32", "description": "Optional. Sample rate for the generated audio in Hertz.", "type": "integer" } } }, "GoogleCloudAiplatformV1beta1DeleteFeatureValuesOperationMetadata": { "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for Featurestore delete Features values." } }, "id": "GoogleCloudAiplatformV1beta1DeleteFeatureValuesOperationMetadata", "description": "Details of operations that delete Feature values.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListSkillRevisionsResponse": { "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "skillRevisions": { "description": "The list of Skill Revisions in the request page.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SkillRevision" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ListSkillRevisionsResponse", "description": "Response message for SkillRegistryService.ListSkillRevisions." }, "GoogleCloudAiplatformV1beta1ListA2aTaskEventsResponse": { "id": "GoogleCloudAiplatformV1beta1ListA2aTaskEventsResponse", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results." }, "events": { "type": "array", "description": "List of A2aTaskEvents in the requested page. Populated only by the TaskStoreService.", "items": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskEvent" } }, "taskEvents": { "description": "List of TaskEvents in the requested page. Populated only by the AgentEngineTaskStoreService.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TaskEvent" } } }, "description": "Response message for ListA2aTaskEvents." }, "GoogleCloudAiplatformV1beta1ToolGoogleSearchImageSearch": { "type": "object", "description": "Image search for grounding and related configurations.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1ToolGoogleSearchImageSearch" }, "GoogleCloudAiplatformV1beta1StudySpecMedianAutomatedStoppingSpec": { "type": "object", "properties": { "useElapsedDuration": { "type": "boolean", "description": "True if median automated stopping rule applies on Measurement.elapsed_duration. It means that elapsed_duration field of latest measurement of current Trial is used to compute median objective value for each completed Trials." } }, "id": "GoogleCloudAiplatformV1beta1StudySpecMedianAutomatedStoppingSpec", "description": "The median automated stopping rule stops a pending Trial if the Trial's best objective_value is strictly below the median 'performance' of all completed Trials reported up to the Trial's last measurement. Currently, 'performance' refers to the running average of the objective values reported by the Trial in each measurement." }, "GoogleCloudAiplatformV1beta1CopyModelOperationMetadata": { "id": "GoogleCloudAiplatformV1beta1CopyModelOperationMetadata", "type": "object", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "The common part of the operation metadata." } }, "description": "Details of ModelService.CopyModel operation." }, "GoogleCloudAiplatformV1beta1Int64Array": { "description": "A list of int64 values.", "properties": { "values": { "description": "A list of int64 values.", "items": { "type": "string", "format": "int64" }, "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Int64Array" }, "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigInputs": { "type": "object", "properties": { "artifacts": { "description": "Optional. Input artifacts.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigArtifactList" }, "type": "object" }, "parameterValues": { "type": "object", "additionalProperties": { "type": "any" }, "description": "Optional. Input parameters." } }, "id": "GoogleCloudAiplatformV1beta1PipelineTaskRerunConfigInputs", "description": "Runtime inputs data of the task." }, "GenaiVertexV1beta1AntigravityAgentConfig": { "description": "Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration.", "properties": { "model": { "type": "string", "description": "The model to use for agent reasoning." }, "maxTotalTokens": { "type": "string", "format": "int64", "description": "Max total tokens for the agent run." } }, "id": "GenaiVertexV1beta1AntigravityAgentConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobDataformRepositorySource": { "properties": { "dataformRepositoryResourceName": { "description": "The resource name of the Dataform Repository. Format: `projects/{project_id}/locations/{location}/repositories/{repository_id}`", "type": "string" }, "commitSha": { "type": "string", "description": "The commit SHA to read repository with. If unset, the file will be read at HEAD." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobDataformRepositorySource", "description": "The Dataform Repository containing the input notebook." }, "GoogleCloudAiplatformV1beta1SafetyResult": { "description": "Spec for safety result.", "properties": { "score": { "type": "number", "readOnly": true, "description": "Output only. Safety score.", "format": "float" }, "confidence": { "description": "Output only. Confidence for safety score.", "format": "float", "readOnly": true, "type": "number" }, "explanation": { "type": "string", "description": "Output only. Explanation for safety score.", "readOnly": true } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SafetyResult" }, "GoogleCloudAiplatformV1beta1A2aTaskStatus": { "description": "Represents the status of an A2aTask.", "properties": { "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED" ], "enumDescriptions": [ "The task is in an unknown or indeterminate state.", "Indicates that a task has been successfully submitted and acknowledged.", "Indicates that a task is actively being processed by the agent.", "Indicates that a task has finished successfully. This is a terminal state.", "Indicates that a task has finished with an error. This is a terminal state.", "Indicates that a task was canceled before completion. This is a terminal state.", "Indicates that the agent requires additional user input to proceed. This is an interrupted state.", "Indicates that the agent has decided to not perform the task. This may be done during initial task creation or later once an agent has determined it can't or won't proceed. This is a terminal state.", "Indicates that authentication is required to proceed. This is an interrupted state." ], "description": "Output only. The current state of the task.", "readOnly": true }, "message": { "description": "Output only. The status message associated with the state.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1A2aTaskMessage" }, "timestamp": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time at which the state was set." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1A2aTaskStatus" }, "GoogleCloudAiplatformV1beta1SearchMigratableResourcesResponse": { "type": "object", "description": "Response message for MigrationService.SearchMigratableResources.", "id": "GoogleCloudAiplatformV1beta1SearchMigratableResourcesResponse", "properties": { "migratableResources": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MigratableResource" }, "type": "array", "description": "All migratable resources that can be migrated to the location specified in the request." }, "nextPageToken": { "type": "string", "description": "The standard next-page token. The migratable_resources may not fill page_size in SearchMigratableResourcesRequest even when there are subsequent pages." } } }, "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest": { "description": "Request message for MemoryBankService.RetrieveMemories.", "properties": { "simpleRetrievalParams": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimpleRetrievalParams", "description": "Parameters for simple (non-similarity search) retrieval." }, "memoryTypes": { "type": "array", "description": "Optional. Specifies the types of memories to retrieve. If this field is empty or not provided, the request will default to retrieving only memories of type `NATURAL_LANGUAGE_COLLECTION`. If populated, the request will retrieve memories matching any of the specified `MemoryType` values.", "items": { "enumDescriptions": [ "Represents an unspecified memory type. This value should not be used.", "Indicates belonging to a collection of natural language memories.", "Indicates belonging to a structured profile." ], "type": "string", "enum": [ "MEMORY_TYPE_UNSPECIFIED", "NATURAL_LANGUAGE_COLLECTION", "STRUCTURED_PROFILE" ] } }, "similaritySearchParams": { "$ref": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequestSimilaritySearchParams", "description": "Parameters for semantic similarity search based retrieval." }, "filter": { "type": "string", "description": "Optional. The standard list filter that will be applied to the retrieved memories. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `fact` * `create_time` * `update_time` * `topics` (i.e. `topics.custom_memory_topic_label: \"example topic\" OR topics.managed_memory_topic: USER_PREFERENCES`)" }, "scope": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Required. The scope of the memories to retrieve. A memory must have exactly the same scope (`Memory.scope`) as the scope provided here to be retrieved (same keys and values). Order does not matter, but it is case-sensitive." }, "filterGroups": { "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryConjunctionFilter" }, "description": "Optional. Metadata filters that will be applied to the retrieved memories' `metadata` using OR logic. Filters are defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: [{key: \"author\", value: {string_value: \"agent 123\"}, op: EQUAL}]}, {filters: [{key: \"label\", value: {string_value: \"travel\"}, op: EQUAL}, {key: \"author\", value: {string_value: \"agent 321\"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = \"agent 123\" OR (metadata.label = \"travel\" AND metadata.author = \"agent 321\"))`.", "type": "array" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest" }, "GoogleCloudAiplatformV1beta1UrlContext": { "description": "Tool to support URL context.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1UrlContext", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecImageSpec": { "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecImageSpec", "properties": { "buildArgs": { "type": "object", "description": "Optional. Build arguments to be used. They will be passed through --build-arg flags.", "additionalProperties": { "type": "string" } } }, "description": "The image spec for building an image (within a single build step), based on the config file (i.e. Dockerfile) in the source directory.", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsRequest": { "description": "Request message for ModelMonitoringService.SearchModelMonitoringAlerts.", "type": "object", "properties": { "alertTimeInterval": { "$ref": "GoogleTypeInterval", "description": "If non-empty, returns the alerts in this time interval." }, "pageToken": { "type": "string", "description": "A page token received from a previous ModelMonitoringService.SearchModelMonitoringAlerts call." }, "pageSize": { "type": "integer", "description": "The standard list page size.", "format": "int32" }, "objectiveType": { "type": "string", "description": "If non-empty, returns the alerts of this objective type. Supported monitoring objectives: `raw-feature-drift` `prediction-output-drift` `feature-attribution`" }, "statsName": { "type": "string", "description": "If non-empty, returns the alerts of this stats_name." }, "modelMonitoringJob": { "type": "string", "description": "If non-empty, returns the alerts of this model monitoring job." } }, "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringAlertsRequest" }, "GoogleCloudAiplatformV1beta1ToolNameMatchSpec": { "type": "object", "description": "Spec for tool name match metric.", "properties": {}, "id": "GoogleCloudAiplatformV1beta1ToolNameMatchSpec" }, "GoogleCloudAiplatformV1beta1ResourcesConsumed": { "id": "GoogleCloudAiplatformV1beta1ResourcesConsumed", "type": "object", "properties": { "replicaHours": { "format": "double", "type": "number", "description": "Output only. The number of replica hours used. Note that many replicas may run in parallel, and additionally any given work may be queued for some time. Therefore this value is not strictly related to wall time.", "readOnly": true } }, "description": "Statistics information about resource consumption." }, "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityResult": { "description": "Spec for pairwise summarization quality result.", "type": "object", "properties": { "confidence": { "format": "float", "description": "Output only. Confidence for summarization quality score.", "readOnly": true, "type": "number" }, "pairwiseChoice": { "description": "Output only. Pairwise summarization prediction choice.", "readOnly": true, "enum": [ "PAIRWISE_CHOICE_UNSPECIFIED", "BASELINE", "CANDIDATE", "TIE" ], "type": "string", "enumDescriptions": [ "Unspecified prediction choice.", "Baseline prediction wins", "Candidate prediction wins", "Winner cannot be determined" ] }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for summarization quality score." } }, "id": "GoogleCloudAiplatformV1beta1PairwiseSummarizationQualityResult" }, "GoogleCloudAiplatformV1beta1ListRagDataSchemasResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListRagDataSchemasResponse", "description": "Response message for VertexRagDataService.ListRagDataSchemas.", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListRagDataSchemasRequest.page_token to obtain that page." }, "ragDataSchemas": { "description": "List of RagDataSchemas in the requested page.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1RagDataSchema" } } } }, "GenaiVertexV1beta1StepStart": { "properties": { "index": { "format": "int32", "type": "integer" }, "step": { "$ref": "GenaiVertexV1beta1Step" } }, "id": "GenaiVertexV1beta1StepStart", "type": "object" }, "GoogleCloudAiplatformV1beta1Extension": { "description": "Extensions are tools for large language models to access external data, run computations, etc.", "id": "GoogleCloudAiplatformV1beta1Extension", "properties": { "description": { "type": "string", "description": "Optional. The description of the Extension." }, "satisfiesPzs": { "readOnly": true, "description": "Output only. Reserved for future use.", "type": "boolean" }, "satisfiesPzi": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "displayName": { "description": "Required. The display name of the Extension. The name can be up to 128 characters long and can consist of any UTF-8 characters.", "type": "string" }, "manifest": { "$ref": "GoogleCloudAiplatformV1beta1ExtensionManifest", "description": "Required. Manifest of the Extension." }, "runtimeConfig": { "description": "Optional. Runtime config controlling the runtime behavior of this Extension.", "$ref": "GoogleCloudAiplatformV1beta1RuntimeConfig" }, "updateTime": { "type": "string", "description": "Output only. Timestamp when this Extension was most recently updated.", "readOnly": true, "format": "google-datetime" }, "extensionOperations": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ExtensionOperation" }, "readOnly": true, "description": "Output only. Supported operations." }, "name": { "description": "Identifier. The resource name of the Extension.", "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Timestamp when this Extension was created.", "readOnly": true, "type": "string" }, "toolUseExamples": { "description": "Optional. Examples to illustrate the usage of the extension as a tool.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolUseExample" }, "type": "array" }, "etag": { "type": "string", "description": "Optional. Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens." }, "privateServiceConnectConfig": { "$ref": "GoogleCloudAiplatformV1beta1ExtensionPrivateServiceConnectConfig", "description": "Optional. The PrivateServiceConnect config for the extension. If specified, the service endpoints associated with the Extension should be [registered with private network access in the provided Service Directory](https://cloud.google.com/service-directory/docs/configuring-private-network-access). If the service contains more than one endpoint with a network, the service will arbitrarilty choose one of the endpoints to use for extension execution." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationMaskAnnotation": { "description": "The mask based segmentation annotation.", "properties": { "annotationSpecColors": { "type": "array", "description": "The mapping between color and AnnotationSpec for this Annotation.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaAnnotationSpecColor" } }, "maskGcsUri": { "type": "string", "description": "Google Cloud Storage URI that points to the mask image. The image must be in PNG format. It must have the same size as the DataItem's image. Each pixel in the image mask represents the AnnotationSpec which the pixel in the image DataItem belong to. Each color is mapped to one AnnotationSpec based on annotation_spec_colors." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaImageSegmentationAnnotationMaskAnnotation" }, "GoogleCloudAiplatformV1beta1MetadataStore": { "properties": { "updateTime": { "type": "string", "description": "Output only. Timestamp when this MetadataStore was last updated.", "readOnly": true, "format": "google-datetime" }, "createTime": { "type": "string", "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp when this MetadataStore was created." }, "dataplexConfig": { "$ref": "GoogleCloudAiplatformV1beta1MetadataStoreDataplexConfig", "description": "Optional. Dataplex integration settings." }, "description": { "description": "Description of the MetadataStore.", "type": "string" }, "name": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the MetadataStore instance." }, "encryptionSpec": { "description": "Customer-managed encryption key spec for a Metadata Store. If set, this Metadata Store and all sub-resources of this Metadata Store are secured using this key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "state": { "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1MetadataStoreMetadataStoreState", "description": "Output only. State information of the MetadataStore." } }, "id": "GoogleCloudAiplatformV1beta1MetadataStore", "description": "Instance of a metadata store. Contains a set of metadata that can be queried.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpec": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpec", "description": "Specification for deploying from source code.", "properties": { "agentConfigSource": { "description": "Source code is generated from the agent config.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecAgentConfigSource" }, "developerConnectSource": { "description": "Source code is in a Git repository managed by Developer Connect.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecDeveloperConnectSource" }, "pythonSpec": { "description": "Configuration for a Python application.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecPythonSpec" }, "imageSpec": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecImageSpec", "description": "Optional. Configuration for building an image with custom config file." }, "inlineSource": { "description": "Source code is provided directly in the request.", "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource" } } }, "GoogleCloudAiplatformV1beta1PurgeContextsMetadata": { "description": "Details of operations that perform MetadataService.PurgeContexts.", "properties": { "genericMetadata": { "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata", "description": "Operation metadata for purging Contexts." } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PurgeContextsMetadata" }, "GoogleCloudAiplatformV1beta1LineageSubgraph": { "description": "A subgraph of the overall lineage graph. Event edges connect Artifact and Execution nodes.", "type": "object", "properties": { "executions": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Execution" }, "type": "array", "description": "The Execution nodes in the subgraph." }, "events": { "description": "The Event edges between Artifacts and Executions in the subgraph.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Event" } }, "artifacts": { "description": "The Artifact nodes in the subgraph.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Artifact" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1LineageSubgraph" }, "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInstance": { "id": "GoogleCloudAiplatformV1beta1RubricBasedInstructionFollowingInstance", "type": "object", "properties": { "jsonInstance": { "type": "string", "description": "Required. Instance specified as a json string. String key-value pairs are expected in the json_instance to render RubricBasedInstructionFollowing prompt templates." } }, "description": "Instance for RubricBasedInstructionFollowing metric - one instance corresponds to one row in an evaluation dataset." }, "GoogleCloudAiplatformV1beta1ResumeModelDeploymentMonitoringJobRequest": { "id": "GoogleCloudAiplatformV1beta1ResumeModelDeploymentMonitoringJobRequest", "description": "Request message for JobService.ResumeModelDeploymentMonitoringJob.", "properties": {}, "type": "object" }, "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigImportFeaturesAnalysis": { "id": "GoogleCloudAiplatformV1beta1FeaturestoreMonitoringConfigImportFeaturesAnalysis", "type": "object", "properties": { "state": { "enumDescriptions": [ "Should not be used.", "The default behavior of whether to enable the monitoring. EntityType-level config: disabled. Feature-level config: inherited from the configuration of EntityType this Feature belongs to.", "Explicitly enables import features analysis. EntityType-level config: by default enables import features analysis for all Features under it. Feature-level config: enables import features analysis regardless of the EntityType-level config.", "Explicitly disables import features analysis. EntityType-level config: by default disables import features analysis for all Features under it. Feature-level config: disables import features analysis regardless of the EntityType-level config." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "DEFAULT", "ENABLED", "DISABLED" ], "description": "Whether to enable / disable / inherite default hebavior for import features analysis." }, "anomalyDetectionBaseline": { "enum": [ "BASELINE_UNSPECIFIED", "LATEST_STATS", "MOST_RECENT_SNAPSHOT_STATS", "PREVIOUS_IMPORT_FEATURES_STATS" ], "description": "The baseline used to do anomaly detection for the statistics generated by import features analysis.", "enumDescriptions": [ "Should not be used.", "Choose the later one statistics generated by either most recent snapshot analysis or previous import features analysis. If non of them exists, skip anomaly detection and only generate a statistics.", "Use the statistics generated by the most recent snapshot analysis if exists.", "Use the statistics generated by the previous import features analysis if exists." ], "type": "string" } }, "description": "Configuration of the Featurestore's ImportFeature Analysis Based Monitoring. This type of analysis generates statistics for values of each Feature imported by every ImportFeatureValues operation." }, "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestGcsSource": { "type": "object", "properties": { "gcsUri": { "type": "string", "description": "Required. The Cloud Storage location of the input data." }, "importSchemaConfig": { "description": "Required. Schema configuration for the input data.", "$ref": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestImportSchemaConfig" } }, "id": "GoogleCloudAiplatformV1beta1ImportEvaluationSetRequestGcsSource", "description": "Source for loading data from Cloud Storage." }, "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints": { "description": "Deprecated: Use top-level `language_codes` instead. Provides hints to the model about possible languages present in the audio.", "id": "GoogleCloudAiplatformV1beta1AudioTranscriptionConfigLanguageHints", "deprecated": true, "type": "object", "properties": { "languageCodes": { "items": { "type": "string" }, "description": "Required. Deprecated: Use top-level `language_codes` instead. BCP-47 language codes. At least one must be specified.", "deprecated": true, "type": "array" } } }, "GoogleCloudAiplatformV1beta1NotebookSoftwareConfig": { "type": "object", "id": "GoogleCloudAiplatformV1beta1NotebookSoftwareConfig", "properties": { "colabImage": { "$ref": "GoogleCloudAiplatformV1beta1ColabImage", "description": "Optional. Google-managed NotebookRuntime colab image." }, "env": { "type": "array", "description": "Optional. Environment variables to be passed to the container. Maximum limit is 100.", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" } }, "postStartupScriptConfig": { "description": "Optional. Post startup script config.", "$ref": "GoogleCloudAiplatformV1beta1PostStartupScriptConfig" } }, "description": "Notebook Software Config. This is passed to the backend when user makes software configurations in UI." }, "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRagResource": { "type": "object", "properties": { "ragCorpus": { "type": "string", "description": "Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`" }, "ragFileIds": { "description": "Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.", "type": "array", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1RetrieveContextsRequestVertexRagStoreRagResource", "description": "The definition of the Rag resource." }, "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigMemoryCorpus": { "description": "Config for the memory corpus.", "properties": { "llmParser": { "description": "The LLM parser to use for the memory corpus.", "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfigLlmParser" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RagCorpusCorpusTypeConfigMemoryCorpus" }, "GoogleCloudAiplatformV1beta1ReinforcementTuningSpec": { "id": "GoogleCloudAiplatformV1beta1ReinforcementTuningSpec", "properties": { "validationDatasetUri": { "description": "Cloud Storage path to the file containing validation dataset for tuning. The dataset must be formatted as a JSONL file.", "type": "string" }, "hyperParameters": { "description": "Optional. Hyper-parameters for reinforcement tuning.", "$ref": "GoogleCloudAiplatformV1beta1ReinforcementTuningHyperParameters" }, "singleRewardConfig": { "description": "Single Reward function configuration for reinforcement tuning.", "$ref": "GoogleCloudAiplatformV1beta1SingleReinforcementTuningRewardConfig" }, "compositeRewardConfig": { "$ref": "GoogleCloudAiplatformV1beta1CompositeReinforcementTuningRewardConfig", "description": "Composite reward function configuration for reinforcement tuning." }, "trainingDatasetUri": { "type": "string", "description": "Cloud Storage path to the file containing training dataset for tuning. The dataset must be formatted as a JSONL file." } }, "description": "Tuning spec for Reinforcement Tuning.", "type": "object" }, "GoogleCloudAiplatformV1beta1ReadIndexDatapointsRequest": { "description": "The request message for MatchService.ReadIndexDatapoints.", "id": "GoogleCloudAiplatformV1beta1ReadIndexDatapointsRequest", "properties": { "ids": { "description": "IDs of the datapoints to be searched for.", "items": { "type": "string" }, "type": "array" }, "deployedIndexId": { "type": "string", "description": "The ID of the DeployedIndex that will serve the request." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1LargeModelReference": { "type": "object", "id": "GoogleCloudAiplatformV1beta1LargeModelReference", "description": "Contains information about the Large Model.", "properties": { "name": { "type": "string", "description": "Required. The unique name of the large Foundation or pre-built model. Like \"chat-bison\", \"text-bison\". Or model name with version ID, like \"chat-bison@001\", \"text-bison@005\", etc." } } }, "GoogleCloudAiplatformV1beta1A2aTaskEvent": { "description": "An event that records a single change applied to a task's state.", "id": "GoogleCloudAiplatformV1beta1A2aTaskEvent", "properties": { "generation": { "readOnly": true, "description": "Output only. The generation number of the task after this event is applied.", "format": "int64", "type": "string" }, "createTime": { "description": "Output only. The time at which the event was created.", "readOnly": true, "format": "google-datetime", "type": "string" }, "metadata": { "additionalProperties": { "description": "Properties of the object.", "type": "any" }, "description": "Optional. Additional context or parameters related to the event. Extensions can be used to strongly type metadata values for specific use cases.", "type": "object" }, "eventData": { "$ref": "GoogleCloudAiplatformV1beta1A2aTaskEventData", "description": "Required. The data describing the change carried by this event." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1AgentResponseCustomization": { "description": "Customizes the agent's response to the end user when a `SemanticGovernancePolicy` is evaluated (for example, with a custom message shown on denial).", "type": "object", "properties": { "denialMessage": { "type": "string", "description": "Optional. Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters." } }, "id": "GoogleCloudAiplatformV1beta1AgentResponseCustomization" }, "GoogleCloudAiplatformV1beta1ExampleStoreConfig": { "properties": { "vertexEmbeddingModel": { "description": "Required. The embedding model to be used for vector embedding. Immutable. Supported models: * \"text-embedding-005\" * \"text-multilingual-embedding-002\"", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExampleStoreConfig", "type": "object", "description": "Configuration for the Example Store." }, "GoogleCloudAiplatformV1beta1UndeploySolverOperationMetadata": { "type": "object", "id": "GoogleCloudAiplatformV1beta1UndeploySolverOperationMetadata", "properties": { "genericMetadata": { "description": "The generic operation information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Runtime operation information for SolverService.UndeploySolver." }, "GoogleCloudAiplatformV1beta1ApiAuth": { "description": "The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead.", "type": "object", "properties": { "apiKeyConfig": { "description": "The API secret.", "$ref": "GoogleCloudAiplatformV1beta1ApiAuthApiKeyConfig" } }, "id": "GoogleCloudAiplatformV1beta1ApiAuth" }, "GoogleCloudAiplatformV1beta1DnsPeeringConfig": { "id": "GoogleCloudAiplatformV1beta1DnsPeeringConfig", "properties": { "domain": { "type": "string", "description": "Required. The DNS name suffix of the zone being peered to, e.g., \"my-internal-domain.corp.\". Must end with a dot." }, "targetProject": { "description": "Required. The project ID hosting the Cloud DNS managed zone that contains the 'domain'. The Vertex AI Service Agent requires the dns.peer role on this project.", "type": "string" }, "targetNetwork": { "description": "Required. The VPC network name in the target_project where the DNS zone specified by 'domain' is visible.", "type": "string" } }, "description": "DNS peering configuration. These configurations are used to create DNS peering zones in the Vertex tenant project VPC, enabling resolution of records within the specified domain hosted in the target network's Cloud DNS.", "type": "object" }, "GoogleCloudAiplatformV1beta1TaskOutputChange": { "properties": { "taskArtifactChange": { "$ref": "GoogleCloudAiplatformV1beta1TaskArtifactChange", "description": "Required. A granular change to the list of artifacts." } }, "description": "An event representing a change to the task's outputs.", "type": "object", "id": "GoogleCloudAiplatformV1beta1TaskOutputChange" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsForecastingEvaluationMetrics": { "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsForecastingEvaluationMetrics", "description": "Metrics for forecasting evaluation results.", "type": "object", "properties": { "rootMeanSquaredLogError": { "description": "Root mean squared log error. Undefined when there are negative ground truth values or predictions.", "format": "float", "type": "number" }, "meanAbsolutePercentageError": { "type": "number", "format": "float", "description": "Mean absolute percentage error. Infinity when there are zeros in the ground truth." }, "rootMeanSquaredPercentageError": { "format": "float", "description": "Root Mean Square Percentage Error. Square root of MSPE. Undefined/imaginary when MSPE is negative.", "type": "number" }, "weightedAbsolutePercentageError": { "description": "Weighted Absolute Percentage Error. Does not use weights, this is just what the metric is called. Undefined if actual values sum to zero. Will be very large if actual values sum to a very small number.", "type": "number", "format": "float" }, "rootMeanSquaredError": { "format": "float", "description": "Root Mean Squared Error (RMSE).", "type": "number" }, "rSquared": { "format": "float", "type": "number", "description": "Coefficient of determination as Pearson correlation coefficient. Undefined when ground truth or predictions are constant or near constant." }, "meanAbsoluteError": { "type": "number", "format": "float", "description": "Mean Absolute Error (MAE)." }, "quantileMetrics": { "type": "array", "description": "The quantile metrics entries for each quantile.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsForecastingEvaluationMetricsQuantileMetricsEntry" } } } }, "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseFeatureDescriptor": { "id": "GoogleCloudAiplatformV1beta1ReadFeatureValuesResponseFeatureDescriptor", "description": "Metadata for requested Features.", "type": "object", "properties": { "id": { "description": "Feature ID.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1ModelMonitoringAnomaly": { "type": "object", "properties": { "modelMonitoringJob": { "type": "string", "description": "Model monitoring job resource name." }, "algorithm": { "type": "string", "description": "Algorithm used to calculated the metrics, eg: jensen_shannon_divergence, l_infinity." }, "tabularAnomaly": { "description": "Tabular anomaly.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringAnomalyTabularAnomaly" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringAnomaly", "description": "Represents a single model monitoring anomaly." }, "GoogleCloudAiplatformV1beta1RagEngineConfig": { "properties": { "name": { "type": "string", "description": "Identifier. The name of the RagEngineConfig. Format: `projects/{project}/locations/{location}/ragEngineConfig`" }, "ragManagedDbConfig": { "description": "The config of the RagManagedDb used by RagEngine.", "$ref": "GoogleCloudAiplatformV1beta1RagManagedDbConfig" } }, "type": "object", "description": "Config for RagEngine.", "id": "GoogleCloudAiplatformV1beta1RagEngineConfig" }, "GoogleCloudAiplatformV1beta1GroundingSupport": { "properties": { "renderedParts": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Indices into the `rendered_parts` field of the `GroundingMetadata` message. These indices specify which rendered parts are associated with this support message." }, "segment": { "description": "The content segment that this support message applies to.", "$ref": "GoogleCloudAiplatformV1beta1Segment" }, "groundingChunkIndices": { "description": "A list of indices into the `grounding_chunks` field of the `GroundingMetadata` message. These indices specify which grounding chunks support the claim made in the content segment. For example, if this field has the values `[1, 3]`, it means that `grounding_chunks[1]` and `grounding_chunks[3]` are the sources for the claim in the content segment.", "items": { "format": "int32", "type": "integer" }, "type": "array" }, "confidenceScores": { "type": "array", "items": { "type": "number", "format": "float" }, "description": "The confidence scores for the support references. This list is parallel to the `grounding_chunk_indices` list. A score is a value between 0.0 and 1.0, with a higher score indicating a higher confidence that the reference supports the claim. For Gemini 2.0 and before, this list has the same size as `grounding_chunk_indices`. For Gemini 2.5 and later, this list is empty and should be ignored." } }, "type": "object", "description": "A collection of supporting references for a segment or part of the model's response.", "id": "GoogleCloudAiplatformV1beta1GroundingSupport" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataEvents": { "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataEvents", "properties": { "event": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "type": "array", "description": "Optional. A list of events." } }, "description": "Represents a list of events for an agent.", "type": "object" }, "GoogleCloudAiplatformV1beta1TuningJobMetadata": { "properties": { "completedEpochCount": { "format": "int64", "description": "Output only. The number of epochs that have been completed.", "type": "string", "readOnly": true }, "completedStepCount": { "description": "Output only. The number of steps that have been completed. Set for Multi-Step RL.", "readOnly": true, "format": "int64", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1TuningJobMetadata", "description": "Tuning job metadata.", "type": "object" }, "GoogleCloudAiplatformV1beta1ListFeatureMonitorJobsResponse": { "id": "GoogleCloudAiplatformV1beta1ListFeatureMonitorJobsResponse", "properties": { "featureMonitorJobs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureMonitorJob" }, "description": "The FeatureMonitorJobs matching the request.", "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as ListFeatureMonitorJobsRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "Response message for FeatureRegistryService.ListFeatureMonitorJobs.", "type": "object" }, "GenaiVertexV1beta1InteractionStatusUpdate": { "type": "object", "id": "GenaiVertexV1beta1InteractionStatusUpdate", "properties": { "status": { "enum": [ "UNSPECIFIED", "IN_PROGRESS", "REQUIRES_ACTION", "COMPLETED", "FAILED", "CANCELLED", "INCOMPLETE", "BUDGET_EXCEEDED", "QUEUED" ], "enumDeprecated": [ false, false, false, false, false, false, false, true, false ], "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The interaction is in progress.", "The interaction requires action/input from the user.", "The interaction is completed.", "The interaction failed.", "The interaction was cancelled.", "The interaction is completed, but contains incomplete results (e.g. hitting max_tokens).", "Deprecated: Token and execution budget exhaustion returns INCOMPLETE (11).", "The interaction is queued, waiting for processing (e.g. waiting for off-peak capacity)." ] }, "usage": { "$ref": "GenaiVertexV1beta1InteractionUsage", "description": "Model usage statistics up to this checkpoint." }, "continuationToken": { "description": "An optional opaque continuation token used to resume decoding from the latest checkpoint after a disconnected stream.", "format": "byte", "type": "string" }, "interactionId": { "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataBigQuerySource": { "description": "Specifies the BigQuery source.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaMultimodalDatasetMetadataBigQuerySource", "properties": { "uri": { "description": "The URI of a BigQuery table. e.g. bq://project.bqDataset.bqTable", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionWindowConfig": { "type": "object", "description": "Config that contains the strategy used to generate sliding windows in time series training. A window is a series of rows that comprise the context up to the time of prediction, and the horizon following. The corresponding row for each window marks the start of the forecast horizon. Each window is used as an input example for training/evaluation.", "properties": { "maxCount": { "type": "string", "format": "int64", "description": "Maximum number of windows that should be generated across all time series." }, "column": { "type": "string", "description": "Name of the column that should be used to generate sliding windows. The column should contain either booleans or string booleans; if the value of the row is True, generate a sliding window with the horizon starting at that row. The column will not be used as a feature in training." }, "strideLength": { "format": "int64", "description": "Stride length used to generate input examples. Within one time series, every {$STRIDE_LENGTH} rows will be used to generate a sliding window.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionWindowConfig" }, "GoogleCloudAiplatformV1beta1CreateRagDataSchemaRequest": { "description": "Request message for VertexRagDataService.CreateRagDataSchema.", "properties": { "ragDataSchemaId": { "type": "string", "description": "Optional. The ID to use for the RagDataSchema, which will become the final component of the RagDataSchema's resource name if the user chooses to specify. Otherwise, RagDataSchema id will be generated by system. This value should be up to 63 characters, and valid characters are /a-z-/. The first character must be a letter, the last could be a letter or a number." }, "parent": { "description": "Required. The resource name of the RagCorpus to create the RagDataSchema in. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`", "type": "string" }, "ragDataSchema": { "$ref": "GoogleCloudAiplatformV1beta1RagDataSchema", "description": "Required. The RagDataSchema to create." } }, "id": "GoogleCloudAiplatformV1beta1CreateRagDataSchemaRequest", "type": "object" }, "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigGenerationConfig": { "type": "object", "properties": { "model": { "description": "Optional. The model used to generate memories. Format: `projects/{project}/locations/{location}/publishers/google/models/{model}`.", "type": "string" }, "generationTriggerConfig": { "$ref": "GoogleCloudAiplatformV1beta1MemoryGenerationTriggerConfig", "description": "Optional. Specifies the default trigger configuration for generating memories using `IngestEvents`." } }, "description": "Configuration for how to generate memories.", "id": "GoogleCloudAiplatformV1beta1ReasoningEngineContextSpecMemoryBankConfigGenerationConfig" }, "GoogleCloudAiplatformV1beta1EnvVar": { "type": "object", "description": "Represents an environment variable present in a Container or Python Module.", "properties": { "name": { "description": "Required. Name of the environment variable. Must be a valid C identifier.", "type": "string" }, "value": { "description": "Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1EnvVar" }, "GoogleCloudAiplatformV1beta1MachineSpec": { "type": "object", "description": "Specification of a single machine.", "properties": { "minGpuDriverVersion": { "description": "Optional. Immutable. The minimum GPU driver version that this machine requires. For example, \"535.104.06\". If not specified, the default GPU driver version will be used by the underlying infrastructure.", "type": "string" }, "acceleratorCount": { "type": "integer", "format": "int32", "description": "The number of accelerators to attach to the machine. For [accelerator optimized machine types](https://cloud.google.com/compute/docs/accelerator-optimized-machines), One may set the accelerator_count from 1 to N for machine with N GPUs. If accelerator_count is less than or equal to N / 2, Agent Platform co-schedules the replicas of the model into the same VM to save cost. For example, if the machine type is a3-highgpu-8g, which has 8 H100 GPUs, one can set accelerator_count to 1 to 8. If accelerator_count is 1, 2, 3, or 4, Agent Platform co-schedules 8, 4, 2, or 2 replicas of the model into the same VM to save cost. When co-scheduling, CPU, memory and storage on the VM will be distributed to replicas on the VM. For example, one can expect a co-scheduled replica requesting 2 GPUs out of a 8-GPU VM will receive 25% of the CPU, memory and storage of the VM. Note that the feature is not compatible with multihost_gpu_node_count. When multihost_gpu_node_count is set, the co-scheduling will not be enabled." }, "multihostGpuNodeCount": { "description": "Optional. Immutable. The number of nodes per replica for multihost GPU deployments.", "format": "int32", "type": "integer" }, "machineType": { "description": "Immutable. The type of the machine. See the [list of machine types supported for prediction](https://cloud.google.com/gemini-enterprise-agent-platform/machine-learning/predictions/configure-compute#machine-types) See the [list of machine types supported for custom training](https://cloud.google.com/gemini-enterprise-agent-platform/machine-learning/training/configure-compute#machine-types). For DeployedModel this field is optional, and the default value is `n1-standard-2`. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.", "type": "string" }, "reservationAffinity": { "$ref": "GoogleCloudAiplatformV1beta1ReservationAffinity", "description": "Optional. Immutable. Configuration controlling how this resource pool consumes reservation." }, "gpuPartitionSize": { "description": "Optional. Immutable. The Nvidia GPU partition size. When specified, the requested accelerators will be partitioned into smaller GPU partitions. For example, if the request is for 8 units of NVIDIA A100 GPUs, and gpu_partition_size=\"1g.10gb\", the service will create 8 * 7 = 56 partitioned MIG instances. The partition size must be a value supported by the requested accelerator. Refer to [Nvidia GPU Partitioning](https://cloud.google.com/kubernetes-engine/docs/how-to/gpus-multi#multi-instance_gpu_partitions) for the available partition sizes. If set, the accelerator_count should be set to 1.", "type": "string" }, "acceleratorType": { "enumDescriptions": [ "Unspecified accelerator type, which means no accelerator.", "Deprecated: Nvidia Tesla K80 GPU has reached end of support, see https://cloud.google.com/compute/docs/eol/k80-eol.", "Nvidia Tesla P100 GPU.", "Nvidia Tesla V100 GPU.", "Nvidia Tesla P4 GPU.", "Nvidia Tesla T4 GPU.", "Nvidia Tesla A100 GPU.", "Nvidia A100 80GB GPU.", "Nvidia L4 GPU.", "Nvidia H100 80Gb GPU.", "Nvidia H100 Mega 80Gb GPU.", "Nvidia H200 141Gb GPU.", "Nvidia B200 GPU.", "Nvidia GB200 GPU.", "Nvidia RTX Pro 6000 GPU.", "TPU v2.", "TPU v3.", "TPU v4.", "TPU v5." ], "enumDeprecated": [ false, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false ], "description": "Immutable. The type of accelerator(s) that may be attached to the machine as per accelerator_count.", "type": "string", "enum": [ "ACCELERATOR_TYPE_UNSPECIFIED", "NVIDIA_TESLA_K80", "NVIDIA_TESLA_P100", "NVIDIA_TESLA_V100", "NVIDIA_TESLA_P4", "NVIDIA_TESLA_T4", "NVIDIA_TESLA_A100", "NVIDIA_A100_80GB", "NVIDIA_L4", "NVIDIA_H100_80GB", "NVIDIA_H100_MEGA_80GB", "NVIDIA_H200_141GB", "NVIDIA_B200", "NVIDIA_GB200", "NVIDIA_RTX_PRO_6000", "TPU_V2", "TPU_V3", "TPU_V4_POD", "TPU_V5_LITEPOD" ] }, "tpuTopology": { "type": "string", "description": "Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: \"2x2x1\")." } }, "id": "GoogleCloudAiplatformV1beta1MachineSpec" }, "GoogleCloudAiplatformV1beta1ToolUseExampleExtensionOperation": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ToolUseExampleExtensionOperation", "properties": { "operationId": { "type": "string", "description": "Required. Operation ID of the extension." }, "extension": { "description": "Resource name of the extension.", "type": "string" } }, "description": "Identifies one operation of the extension." }, "GoogleCloudAiplatformV1beta1Metadata": { "id": "GoogleCloudAiplatformV1beta1Metadata", "description": "Metadata for a chunk.", "properties": { "attributes": { "type": "object", "description": "Optional. Attributes attached to the data. The keys have semantic conventions and the consumers of the attributes should know how to deserialize the value bytes based on the keys.", "additionalProperties": { "type": "string", "format": "byte" } } }, "type": "object" }, "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResultPlaces": { "properties": { "placeId": { "type": "string", "description": "The ID of the place, in `places/{place_id}` format." }, "name": { "type": "string", "description": "Title of the place." }, "reviewSnippets": { "description": "Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.", "items": { "$ref": "GenaiVertexV1beta1ReviewSnippet" }, "type": "array" }, "url": { "description": "URI reference of the place.", "type": "string" } }, "id": "GenaiVertexV1beta1GoogleMapsResultContentGoogleMapsResultPlaces", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaVideoObjectTrackingAnnotation": { "id": "GoogleCloudAiplatformV1beta1SchemaVideoObjectTrackingAnnotation", "properties": { "xMax": { "format": "double", "description": "The rightmost coordinate of the bounding box.", "type": "number" }, "timeOffset": { "description": "A time (frame) of a video to which this annotation pertains. Represented as the duration since the video's start.", "format": "google-duration", "type": "string" }, "instanceId": { "description": "The instance of the object, expressed as a positive integer. Used to track the same object across different frames.", "format": "int64", "type": "string" }, "yMax": { "type": "number", "format": "double", "description": "The bottommost coordinate of the bounding box." }, "xMin": { "format": "double", "type": "number", "description": "The leftmost coordinate of the bounding box." }, "yMin": { "type": "number", "format": "double", "description": "The topmost coordinate of the bounding box." }, "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." }, "displayName": { "type": "string", "description": "The display name of the AnnotationSpec that this Annotation pertains to." } }, "description": "Annotation details specific to video object tracking.", "type": "object" }, "GoogleCloudAiplatformV1beta1RetrieveExpressProjectResponse": { "description": "Response message for ExpressModeService.RetrieveExpressProject.", "properties": { "expressProject": { "$ref": "GoogleCloudAiplatformV1beta1ExpressProject", "description": "The project for Vertex AI Express Mode." } }, "id": "GoogleCloudAiplatformV1beta1RetrieveExpressProjectResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1Tensor": { "properties": { "floatVal": { "description": "FLOAT", "type": "array", "items": { "format": "float", "type": "number" } }, "int64Val": { "description": "INT64", "items": { "format": "int64", "type": "string" }, "type": "array" }, "uint64Val": { "type": "array", "items": { "format": "uint64", "type": "string" }, "description": "UINT64" }, "uintVal": { "description": "UINT8 UINT16 UINT32", "type": "array", "items": { "type": "integer", "format": "uint32" } }, "dtype": { "enum": [ "DATA_TYPE_UNSPECIFIED", "BOOL", "STRING", "FLOAT", "DOUBLE", "INT8", "INT16", "INT32", "INT64", "UINT8", "UINT16", "UINT32", "UINT64" ], "description": "The data type of tensor.", "enumDescriptions": [ "Not a legal value for DataType. Used to indicate a DataType field has not been set.", "Data types that all computation devices are expected to be capable to support.", "", "", "", "", "", "", "", "", "", "", "" ], "type": "string" }, "boolVal": { "items": { "type": "boolean" }, "type": "array", "description": "Type specific representations that make it easy to create tensor protos in all languages. Only the representation corresponding to \"dtype\" can be set. The values hold the flattened representation of the tensor in row major order. BOOL" }, "listVal": { "type": "array", "description": "A list of tensor values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" } }, "doubleVal": { "description": "DOUBLE", "type": "array", "items": { "type": "number", "format": "double" } }, "tensorVal": { "description": "Serialized raw tensor content.", "format": "byte", "type": "string" }, "stringVal": { "description": "STRING", "items": { "type": "string" }, "type": "array" }, "structVal": { "type": "object", "description": "A map of string to tensor.", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" } }, "bytesVal": { "description": "STRING", "items": { "format": "byte", "type": "string" }, "type": "array" }, "intVal": { "type": "array", "description": "INT_8 INT_16 INT_32", "items": { "type": "integer", "format": "int32" } }, "shape": { "type": "array", "items": { "type": "string", "format": "int64" }, "description": "Shape of the tensor." } }, "description": "A tensor value type.", "type": "object", "id": "GoogleCloudAiplatformV1beta1Tensor" }, "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistribution": { "id": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistribution", "type": "object", "description": "Dataset distribution for Supervised Tuning.", "properties": { "min": { "type": "number", "readOnly": true, "description": "Output only. The minimum of the population values.", "format": "double" }, "p95": { "readOnly": true, "type": "number", "description": "Output only. The 95th percentile of the values in the population.", "format": "double" }, "billableSum": { "type": "string", "description": "Output only. Sum of a given population of values that are billable.", "format": "int64", "readOnly": true }, "mean": { "type": "number", "readOnly": true, "format": "double", "description": "Output only. The arithmetic mean of the values in the population." }, "median": { "format": "double", "readOnly": true, "description": "Output only. The median of the values in the population.", "type": "number" }, "sum": { "description": "Output only. Sum of a given population of values.", "format": "int64", "readOnly": true, "type": "string" }, "max": { "type": "number", "description": "Output only. The maximum of the population values.", "readOnly": true, "format": "double" }, "p5": { "format": "double", "description": "Output only. The 5th percentile of the values in the population.", "readOnly": true, "type": "number" }, "buckets": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SupervisedTuningDatasetDistributionDatasetBucket" }, "description": "Output only. Defines the histogram bucket.", "readOnly": true, "type": "array" } } }, "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpecRepeatedRubrics": { "type": "object", "properties": { "rubrics": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Rubric" }, "description": "The list of rubrics.", "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpecRepeatedRubrics", "description": "Defines a list of rubrics, used when providing rubrics inline." }, "GoogleCloudAiplatformV1beta1ProbeGrpcAction": { "type": "object", "description": "GrpcAction checks the health of a container using a gRPC service.", "id": "GoogleCloudAiplatformV1beta1ProbeGrpcAction", "properties": { "port": { "description": "Port number of the gRPC service. Number must be in the range 1 to 65535.", "type": "integer", "format": "int32" }, "service": { "description": "Service is the name of the service to place in the gRPC HealthCheckRequest. See https://github.com/grpc/grpc/blob/master/doc/health-checking.md. If this is not specified, the default behavior is defined by gRPC.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1RagFileChunkingConfig": { "id": "GoogleCloudAiplatformV1beta1RagFileChunkingConfig", "description": "Specifies the size and overlap of chunks for RagFiles.", "properties": { "fixedLengthChunking": { "description": "Specifies the fixed length chunking config.", "$ref": "GoogleCloudAiplatformV1beta1RagFileChunkingConfigFixedLengthChunking" }, "chunkSize": { "type": "integer", "description": "The size of the chunks.", "format": "int32", "deprecated": true }, "chunkOverlap": { "description": "The overlap between chunks.", "deprecated": true, "type": "integer", "format": "int32" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecValue": { "properties": { "floatValue": { "format": "float", "description": "Float type.", "type": "number" }, "stringValue": { "type": "string", "description": "String type." } }, "type": "object", "description": "Single value that supports strings and floats.", "id": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpecValue" }, "GoogleCloudAiplatformV1beta1CreateTensorboardTimeSeriesRequest": { "type": "object", "id": "GoogleCloudAiplatformV1beta1CreateTensorboardTimeSeriesRequest", "description": "Request message for TensorboardService.CreateTensorboardTimeSeries.", "properties": { "tensorboardTimeSeriesId": { "description": "Optional. The user specified unique ID to use for the TensorboardTimeSeries, which becomes the final component of the TensorboardTimeSeries's resource name. This value should match \"a-z0-9{0, 127}\"", "type": "string" }, "parent": { "description": "Required. The resource name of the TensorboardRun to create the TensorboardTimeSeries in. Format: `projects/{project}/locations/{location}/tensorboards/{tensorboard}/experiments/{experiment}/runs/{run}`", "type": "string" }, "tensorboardTimeSeries": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardTimeSeries", "description": "Required. The TensorboardTimeSeries to create." } } }, "GoogleCloudAiplatformV1beta1RemoveContextChildrenRequest": { "id": "GoogleCloudAiplatformV1beta1RemoveContextChildrenRequest", "properties": { "childContexts": { "type": "array", "items": { "type": "string" }, "description": "The resource names of the child Contexts." } }, "description": "Request message for MetadataService.DeleteContextChildrenRequest.", "type": "object" }, "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilter": { "description": "Filter for searching ModelMonitoringStats.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilter", "properties": { "tabularStatsFilter": { "description": "Tabular statistics filter.", "$ref": "GoogleCloudAiplatformV1beta1SearchModelMonitoringStatsFilterTabularStatsFilter" } } }, "GenaiVertexV1beta1RetrievalResultStep": { "description": "Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.", "properties": { "isError": { "type": "boolean", "description": "Whether the retrieval resulted in an error." } }, "id": "GenaiVertexV1beta1RetrievalResultStep", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponse": { "properties": { "status": { "$ref": "GoogleRpcStatus", "description": "Response status for the keys listed in FeatureViewDirectWriteResponse.write_responses. The error only applies to the listed data keys - the stream will remain open for further FeatureOnlineStoreService.FeatureViewDirectWriteRequest requests. Partial failures (e.g. if the first 10 keys of a request fail, but the rest succeed) from a single request may result in multiple responses - there will be one response for the successful request keys and one response for the failing request keys." }, "writeResponses": { "description": "Details about write for each key. If status is not OK, WriteResponse.data_key will have the key with error, but WriteResponse.online_store_write_time will not be present.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponseWriteResponse" } } }, "type": "object", "description": "Response message for FeatureOnlineStoreService.FeatureViewDirectWrite.", "id": "GoogleCloudAiplatformV1beta1FeatureViewDirectWriteResponse" }, "GoogleCloudAiplatformV1beta1ResourcePool": { "description": "Represents the spec of a group of resources of the same type, for example machine type, disk, and accelerators, in a PersistentResource.", "id": "GoogleCloudAiplatformV1beta1ResourcePool", "properties": { "usedReplicaCount": { "type": "string", "readOnly": true, "format": "int64", "description": "Output only. The number of machines currently in use by training jobs for this resource pool. Will replace idle_replica_count." }, "diskSpec": { "description": "Optional. Disk spec for the machine in this node pool.", "$ref": "GoogleCloudAiplatformV1beta1DiskSpec" }, "id": { "type": "string", "description": "Immutable. The unique ID in a PersistentResource for referring to this resource pool. User can specify it if necessary. Otherwise, it's generated automatically." }, "autoscalingSpec": { "description": "Optional. Optional spec to configure GKE or Ray-on-Vertex autoscaling", "$ref": "GoogleCloudAiplatformV1beta1ResourcePoolAutoscalingSpec" }, "machineSpec": { "$ref": "GoogleCloudAiplatformV1beta1MachineSpec", "description": "Required. Immutable. The specification of a single machine." }, "replicaCount": { "type": "string", "description": "Optional. The total number of machines to use for this resource pool.", "format": "int64" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ImportExtensionOperationMetadata": { "properties": { "genericMetadata": { "description": "The common part of the operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Details of ExtensionRegistryService.ImportExtension operation.", "id": "GoogleCloudAiplatformV1beta1ImportExtensionOperationMetadata", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValueDistributionDataValue": { "id": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsDataPointTypedValueDistributionDataValue", "description": "Summary statistics for a population of values.", "type": "object", "properties": { "distribution": { "type": "any", "description": "Predictive monitoring drift distribution in `tensorflow.metadata.v0.DatasetFeatureStatistics` format." }, "distributionDeviation": { "type": "number", "description": "Distribution distance deviation from the current dataset's statistics to baseline dataset's statistics. * For categorical feature, the distribution distance is calculated by L-inifinity norm or Jensen–Shannon divergence. * For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence.", "format": "double" } } }, "GoogleCloudAiplatformV1beta1MetricResult": { "id": "GoogleCloudAiplatformV1beta1MetricResult", "properties": { "rubricVerdicts": { "description": "Output only. For rubric-based metrics, the verdicts for each rubric.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleCloudAiplatformV1beta1RubricVerdict" } }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. The explanation for the metric result." }, "score": { "readOnly": true, "format": "float", "type": "number", "description": "Output only. The score for the metric. Please refer to each metric's documentation for the meaning of the score." }, "error": { "description": "Output only. The error status for the metric result.", "readOnly": true, "$ref": "GoogleRpcStatus" } }, "description": "Result for a single metric on a single instance.", "type": "object" }, "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataAgentEvent": { "type": "object", "id": "GoogleCloudAiplatformV1beta1EvaluationInstanceDeprecatedAgentDataAgentEvent", "properties": { "author": { "description": "Required. The ID of the agent or entity that generated this event.", "type": "string" }, "content": { "description": "Required. The content of the event (e.g., text response, tool call, tool response).", "$ref": "GoogleCloudAiplatformV1beta1Content" }, "activeTools": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Tool" }, "description": "Optional. The list of tools that were active/available to the agent at the time of this event. This overrides the `AgentConfig.tools` if set." }, "eventTime": { "type": "string", "format": "google-datetime", "description": "Optional. The timestamp when the event occurred." }, "stateDelta": { "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object", "description": "Optional. The change in the session state caused by this event. This is a key-value map of fields that were modified or added by the event." } }, "description": "A single event in the execution trace." }, "GenaiVertexV1beta1EnvironmentConfig": { "description": "Configuration for a custom environment.", "type": "object", "id": "GenaiVertexV1beta1EnvironmentConfig", "properties": { "environmentId": { "type": "string", "description": "Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one." }, "networkAllowlist": { "description": "Allow only specific domains.", "$ref": "GenaiVertexV1beta1EnvironmentConfigEnvironmentNetworkEgressAllowlist" }, "sources": { "items": { "$ref": "GenaiVertexV1beta1EnvironmentConfigSource" }, "type": "array" }, "networkMode": { "type": "string", "enumDescriptions": [ "Default value. Unused.", "All network egress is blocked." ], "description": "Network egress mode.", "enum": [ "NETWORK_MODE_UNSPECIFIED", "DISABLED" ] } } }, "GoogleCloudAiplatformV1beta1ListEvaluationSetsResponse": { "id": "GoogleCloudAiplatformV1beta1ListEvaluationSetsResponse", "properties": { "evaluationSets": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationSet" }, "description": "List of EvaluationSets in the requested page." }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results." } }, "description": "Response message for EvaluationManagementService.ListEvaluationSets.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutomlImageTrainingTunableParameter": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutomlImageTrainingTunableParameter", "type": "object", "description": "A wrapper class which contains the tunable parameters in an AutoML Image training job.", "properties": { "studySpec": { "description": "Optioinal. StudySpec of hyperparameter tuning job. Required for `model_garden_trainer`.", "$ref": "GoogleCloudAiplatformV1beta1StudySpec" }, "checkpointName": { "description": "Optional. An unique name of pretrained model checkpoint provided in model garden, it will be mapped to a GCS location internally.", "type": "string" }, "trainerType": { "enum": [ "TRAINER_TYPE_UNSPECIFIED", "AUTOML_TRAINER", "MODEL_GARDEN_TRAINER" ], "type": "string", "enumDescriptions": [ "Default value.", "", "" ] }, "trainerConfig": { "additionalProperties": { "type": "string" }, "description": "Customizable trainer settings, used in the `model_garden_trainer`.", "type": "object" }, "datasetConfig": { "type": "object", "description": "Customizable dataset settings, used in the `model_garden_trainer`.", "additionalProperties": { "type": "string" } } } }, "GenaiVertexV1beta1InteractionUsage": { "id": "GenaiVertexV1beta1InteractionUsage", "type": "object", "description": "Statistics on the interaction request's token usage.", "properties": { "groundingToolCount": { "description": "Grounding tool count.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1InteractionUsageGroundingToolCount" } }, "inputTokensByModality": { "items": { "$ref": "GenaiVertexV1beta1InteractionUsageModalityTokens" }, "description": "A breakdown of input token usage by modality.", "type": "array" }, "totalTokens": { "format": "int32", "description": "Total token count for the interaction request (prompt + responses + other internal tokens).", "type": "integer" }, "totalThoughtTokens": { "description": "Number of tokens of thoughts for thinking models.", "type": "integer", "format": "int32" }, "totalCachedTokens": { "description": "Number of tokens in the cached part of the prompt (the cached content).", "type": "integer", "format": "int32" }, "totalInputTokens": { "format": "int32", "description": "Number of tokens in the prompt (context).", "type": "integer" }, "toolUseTokensByModality": { "description": "A breakdown of tool-use token usage by modality.", "items": { "$ref": "GenaiVertexV1beta1InteractionUsageModalityTokens" }, "type": "array" }, "totalToolUseTokens": { "type": "integer", "description": "Number of tokens present in tool-use prompt(s).", "format": "int32" }, "totalOutputTokens": { "description": "Total number of tokens across all the generated responses.", "format": "int32", "type": "integer" }, "cachedTokensByModality": { "description": "A breakdown of cached token usage by modality.", "items": { "$ref": "GenaiVertexV1beta1InteractionUsageModalityTokens" }, "type": "array" }, "outputTokensByModality": { "description": "A breakdown of output token usage by modality.", "type": "array", "items": { "$ref": "GenaiVertexV1beta1InteractionUsageModalityTokens" } } } }, "GoogleCloudAiplatformV1beta1AgentResource": { "properties": { "agentFramework": { "description": "Optional. The framework used to build the agent, orthogonal to the runtime `agent_type`.", "type": "string", "enumDescriptions": [ "The default value, used when the framework is unspecified.", "The agent is built with the Agent Development Kit (ADK)." ], "enum": [ "AGENT_FRAMEWORK_UNSPECIFIED", "ADK" ] }, "agentType": { "enumDescriptions": [ "The default value, used when the runtime type is unspecified.", "The agent runs on the Gemini Enterprise Agent Platform Agent Runtime (Reasoning Engine).", "The agent runs as a Google Cloud Run service.", "The agent runs as a workload on Google Kubernetes Engine.", "The agent runs on a Compute Engine instance.", "The agent runs on another runtime, such as a self-hosted, on-premises, or non-Google Cloud environment, or any runtime not represented by the values above." ], "type": "string", "description": "Required. The runtime type of the agent.", "enum": [ "AGENT_TYPE_UNSPECIFIED", "REASONING_ENGINE", "CLOUD_RUN_SERVICE", "GKE_WORKLOAD", "GCE_INSTANCE", "AGENT_TYPE_OTHER" ] }, "location": { "description": "Output only. The Google Cloud location (region) of the agent resource (for example, `us-central1`).", "readOnly": true, "type": "string" }, "agent": { "description": "Required. The resource name or identifier of the agent to monitor. The format depends on `agent_type`: * `REASONING_ENGINE`: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}` * `CLOUD_RUN_SERVICE`, `GKE_WORKLOAD`, `GCE_INSTANCE`: the resource name of the agent's runtime. * `AGENT_TYPE_OTHER`: a stable identifier for the agent.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1AgentResource", "description": "Defines the identity of an agent being monitored.", "type": "object" }, "GoogleCloudAiplatformV1beta1InferenceEventLoggingConfig": { "id": "GoogleCloudAiplatformV1beta1InferenceEventLoggingConfig", "description": "Configures emission of the per-request `aiplatform.googleapis.com/inference_request` Cloud Logging log.", "type": "object", "properties": { "state": { "enumDescriptions": [ "Not specified. Treated as `DISABLED`.", "Inference-event logging is enabled.", "Inference-event logging is disabled." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "ENABLED", "DISABLED" ], "description": "Optional. Whether the `aiplatform.googleapis.com/inference_request` log is enabled." } } }, "GoogleCloudAiplatformV1beta1Example": { "properties": { "createTime": { "description": "Output only. Timestamp when this Example was created.", "type": "string", "readOnly": true, "format": "google-datetime" }, "displayName": { "type": "string", "description": "Optional. The display name for Example." }, "exampleId": { "description": "Optional. Immutable. Unique identifier of an example. If not specified when upserting new examples, the example_id will be generated.", "type": "string" }, "storedContentsExample": { "description": "An example of chat history and its expected outcome to be used with GenerateContent.", "$ref": "GoogleCloudAiplatformV1beta1StoredContentsExample" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1Example" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigPredictionDriftDetectionConfig": { "description": "The config for Prediction data drift detection.", "type": "object", "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveConfigPredictionDriftDetectionConfig", "properties": { "defaultDriftThreshold": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig", "description": "Drift anomaly detection threshold used by all features. When the per-feature thresholds are not set, this field can be used to specify a threshold for all features." }, "driftThresholds": { "description": "Key is the feature name and value is the threshold. If a feature needs to be monitored for drift, a value threshold must be configured for that feature. The threshold here is against feature distribution distance between different time windws.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig" } }, "attributionScoreDriftThresholds": { "description": "Key is the feature name and value is the threshold. The threshold here is against attribution score distance between different time windows.", "type": "object", "additionalProperties": { "$ref": "GoogleCloudAiplatformV1beta1ThresholdConfig" } } } }, "GoogleCloudAiplatformV1beta1StringArray": { "id": "GoogleCloudAiplatformV1beta1StringArray", "type": "object", "properties": { "values": { "type": "array", "description": "A list of string values.", "items": { "type": "string" } } }, "description": "A list of string values." }, "GoogleCloudAiplatformV1beta1RayLogsSpec": { "type": "object", "properties": { "disabled": { "description": "Optional. Flag to disable the export of Ray OSS logs to Cloud Logging.", "type": "boolean" } }, "description": "Configuration for the Ray OSS Logs.", "id": "GoogleCloudAiplatformV1beta1RayLogsSpec" }, "GoogleCloudAiplatformV1beta1ExtensionManifestApiSpec": { "type": "object", "description": "The API specification shown to the LLM.", "properties": { "openApiYaml": { "description": "The API spec in Open API standard and YAML format.", "type": "string" }, "openApiGcsUri": { "description": "Cloud Storage URI pointing to the OpenAPI spec.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1ExtensionManifestApiSpec" }, "GoogleCloudAiplatformV1beta1ImportDataRequest": { "properties": { "importConfigs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ImportDataConfig" }, "type": "array", "description": "Required. The desired input locations. The contents of all input locations will be imported in one batch." } }, "id": "GoogleCloudAiplatformV1beta1ImportDataRequest", "description": "Request message for DatasetService.ImportData.", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpec": { "description": "Monitoring objectives spec.", "properties": { "targetDataset": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInput", "description": "Target dataset." }, "baselineDataset": { "description": "Baseline dataset. It could be the training dataset or production serving dataset from a previous period.", "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringInput" }, "tabularObjective": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpecTabularObjective", "description": "Tabular monitoring objective." }, "explanationSpec": { "description": "The explanation spec. This spec is required when the objectives spec includes feature attribution objectives.", "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec" } }, "id": "GoogleCloudAiplatformV1beta1ModelMonitoringObjectiveSpec", "type": "object" }, "GoogleCloudAiplatformV1beta1RuntimeConfigVertexAISearchRuntimeConfig": { "type": "object", "properties": { "engineId": { "description": "Optional. Vertex AI Search engine ID. This is used to construct the search request. By setting this engine_id, API will construct the serving config using the default value to call search API for the user. The engine_id and serving_config_name cannot both be empty at the same time.", "type": "string" }, "servingConfigName": { "type": "string", "description": "Optional. Vertex AI Search serving config name. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}`" } }, "id": "GoogleCloudAiplatformV1beta1RuntimeConfigVertexAISearchRuntimeConfig" }, "GoogleCloudAiplatformV1beta1TrajectoryRecallInput": { "properties": { "instances": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TrajectoryRecallInstance" }, "description": "Required. Repeated TrajectoryRecall instance." }, "metricSpec": { "description": "Required. Spec for TrajectoryRecall metric.", "$ref": "GoogleCloudAiplatformV1beta1TrajectoryRecallSpec" } }, "description": "Instances and metric spec for TrajectoryRecall metric.", "id": "GoogleCloudAiplatformV1beta1TrajectoryRecallInput", "type": "object" }, "GoogleCloudAiplatformV1beta1ListSemanticGovernancePoliciesResponse": { "id": "GoogleCloudAiplatformV1beta1ListSemanticGovernancePoliciesResponse", "description": "Response message for SemanticGovernancePolicyService.ListSemanticGovernancePolicies.", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Pass to ListSemanticGovernancePoliciesRequest.page_token to obtain that page." }, "semanticGovernancePolicies": { "items": { "$ref": "GoogleCloudAiplatformV1beta1SemanticGovernancePolicy" }, "type": "array", "description": "The list of SemanticGovernancePolicies." } } }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfigSourceEntry": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfigSourceEntry", "properties": { "type": { "enumDescriptions": [ "", "Uses Web Search to check the grounding.", "Uses Vertex AI Search to check the grounding. Deprecated. Use VERTEX_AI_SEARCH instead.", "Uses Vertex AI Search to check the grounding", "Uses inline context to check the grounding." ], "enumDeprecated": [ false, false, true, false, false ], "enum": [ "UNSPECIFIED", "WEB", "ENTERPRISE", "VERTEX_AI_SEARCH", "INLINE" ], "description": "The type of the grounding checking source.", "type": "string" }, "enterpriseDatastore": { "deprecated": true, "type": "string", "description": "The uri of the Vertex AI Search data source. Deprecated. Use vertex_ai_search_datastore instead." }, "inlineContext": { "description": "The grounding text passed inline with the Predict API. It can support up to 1 million bytes.", "type": "string" }, "vertexAiSearchDatastore": { "description": "The uri of the Vertex AI Search data source.", "type": "string" } }, "description": "Single source entry for the grounding checking.", "type": "object" }, "CloudAiLargeModelsVisionMedia": { "description": "Media.", "type": "object", "id": "CloudAiLargeModelsVisionMedia", "properties": { "image": { "description": "Image.", "$ref": "CloudAiLargeModelsVisionImage" }, "video": { "$ref": "CloudAiLargeModelsVisionVideo", "description": "Video" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsGranularity": { "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlForecastingInputsGranularity", "properties": { "unit": { "type": "string", "description": "The time granularity unit of this time period. The supported units are: * \"minute\" * \"hour\" * \"day\" * \"week\" * \"month\" * \"year\"" }, "quantity": { "description": "The number of granularity_units between data points in the training data. If `granularity_unit` is `minute`, can be 1, 5, 10, 15, or 30. For all other values of `granularity_unit`, must be 1.", "format": "int64", "type": "string" } }, "type": "object", "description": "A duration of time expressed in time granularity units." }, "GoogleCloudAiplatformV1beta1ImportDataResponse": { "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1ImportDataResponse", "description": "Response message for DatasetService.ImportData." }, "GoogleCloudAiplatformV1beta1MetricxSpec": { "description": "Spec for MetricX metric.", "type": "object", "id": "GoogleCloudAiplatformV1beta1MetricxSpec", "properties": { "sourceLanguage": { "description": "Optional. Source language in BCP-47 format.", "type": "string" }, "version": { "enum": [ "METRICX_VERSION_UNSPECIFIED", "METRICX_24_REF", "METRICX_24_SRC", "METRICX_24_SRC_REF" ], "description": "Required. Which version to use for evaluation.", "enumDescriptions": [ "MetricX version unspecified.", "MetricX 2024 (2.6) for translation + reference (reference-based).", "MetricX 2024 (2.6) for translation + source (QE).", "MetricX 2024 (2.6) for translation + source + reference (source-reference-combined)." ], "type": "string" }, "targetLanguage": { "description": "Optional. Target language in BCP-47 format. Covers both prediction and reference.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTimestampTransformation": { "description": "Training pipeline will perform following transformation functions. * Apply the transformation functions for Numerical columns. * Determine the year, month, day,and weekday. Treat each value from the * timestamp as a Categorical column. * Invalid numerical values (for example, values that fall outside of a typical timestamp range, or are extreme values) receive no special treatment and are not removed.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationTimestampTransformation", "properties": { "columnName": { "type": "string" }, "timeFormat": { "description": "The format in which that time field is expressed. The time_format must either be one of: * `unix-seconds` * `unix-milliseconds` * `unix-microseconds` * `unix-nanoseconds` (for respectively number of seconds, milliseconds, microseconds and nanoseconds since start of the Unix epoch); or be written in `strftime` syntax. If time_format is not set, then the default format is RFC 3339 `date-time` format, where `time-offset` = `\"Z\"` (e.g. 1985-04-12T23:20:50.52Z)", "type": "string" }, "invalidValuesAllowed": { "type": "boolean", "description": "If invalid values is allowed, the training pipeline will create a boolean feature that indicated whether the value is valid. Otherwise, the training pipeline will discard the input row from trainining data." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericTransformation": { "properties": { "invalidValuesAllowed": { "description": "If invalid values is allowed, the training pipeline will create a boolean feature that indicated whether the value is valid. Otherwise, the training pipeline will discard the input row from trainining data.", "type": "boolean" }, "columnName": { "type": "string" } }, "description": "Training pipeline will perform following transformation functions. * The value converted to float32. * The z_score of the value. * log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * z_score of log(value+1) when the value is greater than or equal to 0. Otherwise, this transformation is not applied and the value is considered a missing value. * A boolean value that indicates whether the value is valid.", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputsTransformationNumericTransformation", "type": "object" }, "GoogleCloudAiplatformV1beta1ListReasoningEngineRuntimeRevisionsResponse": { "id": "GoogleCloudAiplatformV1beta1ListReasoningEngineRuntimeRevisionsResponse", "type": "object", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Pass to ListReasoningEngineRuntimeRevisionsRequest.page_token to obtain that page.", "type": "string" }, "reasoningEngineRuntimeRevisions": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ReasoningEngineRuntimeRevision" }, "description": "List of ReasoningEngineRuntimeRevisions in the requested page." } }, "description": "Response message for ReasoningEngineRuntimeRevisionService.ListReasoningEngineRuntimeRevisions" }, "GoogleCloudAiplatformV1beta1ToolCallValidMetricValue": { "id": "GoogleCloudAiplatformV1beta1ToolCallValidMetricValue", "type": "object", "description": "Tool call valid metric value for an instance.", "properties": { "score": { "type": "number", "format": "float", "readOnly": true, "description": "Output only. Tool call valid score." } } }, "GoogleCloudAiplatformV1beta1PauseSandboxEnvironmentRequest": { "description": "Request message for SandboxEnvironmentService.PauseSandboxEnvironment.", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1PauseSandboxEnvironmentRequest" }, "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifactChange": { "description": "An event payload describing a change to one of the task's artifacts.", "id": "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifactChange", "properties": { "lastChunk": { "description": "Optional. Whether this is the last chunk of a streamed artifact.", "type": "boolean" }, "append": { "description": "Optional. Whether the artifact parts should be appended to an existing artifact rather than replacing it.", "type": "boolean" }, "artifact": { "$ref": "GoogleCloudAiplatformV1beta1A2ATaskRecordArtifact", "description": "Required. The artifact that was added or updated." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListModelDeploymentMonitoringJobsResponse": { "type": "object", "description": "Response message for JobService.ListModelDeploymentMonitoringJobs.", "properties": { "modelDeploymentMonitoringJobs": { "description": "A list of ModelDeploymentMonitoringJobs that matches the specified filter in the request.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelDeploymentMonitoringJob" } }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } }, "id": "GoogleCloudAiplatformV1beta1ListModelDeploymentMonitoringJobsResponse" }, "GoogleCloudAiplatformV1beta1BatchPredictionJob": { "type": "object", "id": "GoogleCloudAiplatformV1beta1BatchPredictionJob", "properties": { "modelParameters": { "description": "The parameters that govern the predictions. The schema of the parameters may be specified via the Model's PredictSchemata's parameters_schema_uri.", "type": "any" }, "generateExplanation": { "type": "boolean", "description": "Generate explanation with the batch prediction results. When set to `true`, the batch prediction output changes based on the `predictions_format` field of the BatchPredictionJob.output_config object: * `bigquery`: output includes a column named `explanation`. The value is a struct that conforms to the Explanation object. * `jsonl`: The JSON objects on each line include an additional entry keyed `explanation`. The value of the entry is a JSON object that conforms to the Explanation object. * `csv`: Generating explanations for CSV format is not supported. If this field is set to true, either the Model.explanation_spec or explanation_spec must be populated." }, "error": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. Only populated when the job's state is JOB_STATE_FAILED or JOB_STATE_CANCELLED." }, "endpoint": { "description": "For Bring-Your-Own-Endpoint (BYOE), the name of the Endpoint resource that produces the predictions via this job, must share the same ancestor Location. Exactly one of model, unmanaged_container_model, or endpoint must be set. Example: `projects/193595526740/locations/us-central1/endpoints/4203439000301600768`", "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. Time when the BatchPredictionJob was created.", "readOnly": true, "type": "string" }, "state": { "readOnly": true, "enumDescriptions": [ "The job state is unspecified.", "The job has been just created or resumed and processing has not yet begun.", "The service is preparing to run the job.", "The job is in progress.", "The job completed successfully.", "The job failed.", "The job is being cancelled. From this state the job may only go to either `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED` or `JOB_STATE_CANCELLED`.", "The job has been cancelled.", "The job has been stopped, and can be resumed.", "The job has expired.", "The job is being updated. Only jobs in the `RUNNING` state can be updated. After updating, the job goes back to the `RUNNING` state.", "The job is partially succeeded, some results may be missing due to errors." ], "description": "Output only. The detailed state of the job.", "type": "string", "enum": [ "JOB_STATE_UNSPECIFIED", "JOB_STATE_QUEUED", "JOB_STATE_PENDING", "JOB_STATE_RUNNING", "JOB_STATE_SUCCEEDED", "JOB_STATE_FAILED", "JOB_STATE_CANCELLING", "JOB_STATE_CANCELLED", "JOB_STATE_PAUSED", "JOB_STATE_EXPIRED", "JOB_STATE_UPDATING", "JOB_STATE_PARTIALLY_SUCCEEDED" ] }, "modelMonitoringStatsAnomalies": { "description": "Get batch prediction job monitoring statistics.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringStatsAnomalies" } }, "manualBatchTuningParameters": { "description": "Immutable. Parameters configuring the batch behavior. Currently only applicable when dedicated_resources are used (in other cases Vertex AI does the tuning itself).", "$ref": "GoogleCloudAiplatformV1beta1ManualBatchTuningParameters" }, "instanceConfig": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJobInstanceConfig", "description": "Configuration for how to convert batch prediction input instances to the prediction instances that are sent to the Model." }, "model": { "description": "The name of the Model resource that produces the predictions via this job, must share the same ancestor Location. Starting this job has no impact on any existing deployments of the Model and their resources. Exactly one of model, unmanaged_container_model, or endpoint must be set. The model resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed. The model resource could also be a publisher model. Example: `publishers/{publisher}/models/{model}` or `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`", "type": "string" }, "modelMonitoringStatus": { "readOnly": true, "$ref": "GoogleRpcStatus", "description": "Output only. The running status of the model monitoring pipeline." }, "endTime": { "format": "google-datetime", "type": "string", "readOnly": true, "description": "Output only. Time when the BatchPredictionJob entered any of the following states: `JOB_STATE_SUCCEEDED`, `JOB_STATE_FAILED`, `JOB_STATE_CANCELLED`." }, "serviceAccount": { "description": "The service account that the DeployedModel's container runs as. If not specified, a system generated one will be used, which has minimal permissions and the custom container, if used, may not have enough permission to access other Google Cloud resources. Users deploying the Model must have the `iam.serviceAccounts.actAs` permission on this service account.", "type": "string" }, "satisfiesPzs": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "dedicatedResources": { "description": "The config of resources used by the Model during the batch prediction. If the Model supports DEDICATED_RESOURCES this config may be provided (and the job will use these resources), if the Model doesn't support AUTOMATIC_RESOURCES, this config must be provided.", "$ref": "GoogleCloudAiplatformV1beta1BatchDedicatedResources" }, "name": { "description": "Output only. Resource name of the BatchPredictionJob.", "type": "string", "readOnly": true }, "disableContainerLogging": { "type": "boolean", "description": "For custom-trained Models and AutoML Tabular Models, the container of the DeployedModel instances will send `stderr` and `stdout` streams to Cloud Logging by default. Please note that the logs incur cost, which are subject to [Cloud Logging pricing](https://cloud.google.com/logging/pricing). User can disable container logging by setting this flag to true." }, "outputInfo": { "description": "Output only. Information further describing the output of this job.", "readOnly": true, "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputInfo" }, "modelVersionId": { "type": "string", "description": "Output only. The version ID of the Model that produces the predictions via this job.", "readOnly": true }, "displayName": { "description": "Required. The user-defined name of this BatchPredictionJob.", "type": "string" }, "encryptionSpec": { "description": "Customer-managed encryption key options for a BatchPredictionJob. If this is set, then all resources created by the BatchPredictionJob will be encrypted with the provided encryption key.", "$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "The labels with user-defined metadata to organize BatchPredictionJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels." }, "startTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Time when the BatchPredictionJob for the first time entered the `JOB_STATE_RUNNING` state.", "type": "string" }, "updateTime": { "format": "google-datetime", "description": "Output only. Time when the BatchPredictionJob was most recently updated.", "type": "string", "readOnly": true }, "partialFailures": { "description": "Output only. Partial failures encountered. For example, single files that can't be read. This field never exceeds 20 entries. Status details fields contain standard Google Cloud error details.", "type": "array", "items": { "$ref": "GoogleRpcStatus" }, "readOnly": true }, "unmanagedContainerModel": { "$ref": "GoogleCloudAiplatformV1beta1UnmanagedContainerModel", "description": "Contains model information necessary to perform batch prediction without requiring uploading to model registry. Exactly one of model, unmanaged_container_model, or endpoint must be set." }, "inputConfig": { "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJobInputConfig", "description": "Required. Input configuration of the instances on which predictions are performed. The schema of any single instance may be specified via the Model's PredictSchemata's instance_schema_uri." }, "satisfiesPzi": { "type": "boolean", "description": "Output only. Reserved for future use.", "readOnly": true }, "explanationSpec": { "$ref": "GoogleCloudAiplatformV1beta1ExplanationSpec", "description": "Explanation configuration for this BatchPredictionJob. Can be specified only if generate_explanation is set to `true`. This value overrides the value of Model.explanation_spec. All fields of explanation_spec are optional in the request. If a field of the explanation_spec object is not populated, the corresponding field of the Model.explanation_spec object is inherited." }, "completionStats": { "$ref": "GoogleCloudAiplatformV1beta1CompletionStats", "description": "Output only. Statistics on completed and failed prediction instances.", "readOnly": true }, "outputConfig": { "description": "Required. The Configuration specifying where output predictions should be written. The schema of any single prediction may be specified as a concatenation of Model's PredictSchemata's instance_schema_uri and prediction_schema_uri.", "$ref": "GoogleCloudAiplatformV1beta1BatchPredictionJobOutputConfig" }, "resourcesConsumed": { "description": "Output only. Information about resources that had been consumed by this job. Provided in real time at best effort basis, as well as a final value once the job completes. Note: This field currently may be not populated for batch predictions that use AutoML Models.", "$ref": "GoogleCloudAiplatformV1beta1ResourcesConsumed", "readOnly": true }, "modelMonitoringConfig": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringConfig", "description": "Model monitoring config will be used for analysis model behaviors, based on the input and output to the batch prediction job, as well as the provided training dataset." } }, "description": "A job that uses a Model to produce predictions on multiple input instances. If predictions for significant portion of the instances fail, the job may finish without attempting predictions for all remaining instances." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextSentiment": { "type": "object", "properties": { "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextSentimentInputs", "description": "The input parameters of this TrainingJob." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTextSentiment", "description": "A TrainingJob that trains and uploads an AutoML Text Sentiment Model." }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoClassificationInputs": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlVideoClassificationInputs", "properties": { "modelType": { "enum": [ "MODEL_TYPE_UNSPECIFIED", "CLOUD", "MOBILE_VERSATILE_1", "MOBILE_JETSON_VERSATILE_1" ], "enumDescriptions": [ "Should not be set.", "A model best tailored to be used within Google Cloud, and which cannot be exported. Default.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) as a TensorFlow or TensorFlow Lite model and used on a mobile or edge device afterwards.", "A model that, in addition to being available within Google Cloud, can also be exported (see ModelService.ExportModel) to a Jetson device afterwards." ], "type": "string" } } }, "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTables": { "description": "A TrainingJob that trains and uploads an AutoML Tables Model.", "properties": { "metadata": { "description": "The metadata information.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesMetadata" }, "inputs": { "$ref": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTablesInputs", "description": "The input parameters of this TrainingJob." } }, "id": "GoogleCloudAiplatformV1beta1SchemaTrainingjobDefinitionAutoMlTables", "type": "object" }, "GoogleCloudAiplatformV1beta1ListEvaluationExperimentsResponse": { "id": "GoogleCloudAiplatformV1beta1ListEvaluationExperimentsResponse", "description": "Response message for EvaluationManagementService.ListEvaluationExperiments.", "properties": { "evaluationExperiments": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1EvaluationExperiment" }, "description": "List of EvaluationExperiments in the requested page." }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results." } }, "type": "object" }, "GenaiVertexV1beta1FileSearchResultContentFileSearchResult": { "id": "GenaiVertexV1beta1FileSearchResultContentFileSearchResult", "properties": {}, "type": "object", "description": "The result of the File Search." }, "GoogleCloudAiplatformV1beta1RagFileParsingConfig": { "properties": { "useAdvancedPdfParsing": { "deprecated": true, "type": "boolean", "description": "Whether to use advanced PDF parsing." }, "advancedParser": { "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfigAdvancedParser", "description": "The Advanced Parser to use for RagFiles." }, "llmParser": { "description": "The LLM Parser to use for RagFiles.", "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfigLlmParser" }, "layoutParser": { "description": "The Layout Parser to use for RagFiles.", "$ref": "GoogleCloudAiplatformV1beta1RagFileParsingConfigLayoutParser" } }, "description": "Specifies the parsing config for RagFiles.", "type": "object", "id": "GoogleCloudAiplatformV1beta1RagFileParsingConfig" }, "GenaiVertexV1beta1GoogleMaps": { "id": "GenaiVertexV1beta1GoogleMaps", "properties": { "enableWidget": { "description": "Whether to return a widget context token in the tool call result of the response.", "type": "boolean" }, "latitude": { "description": "The latitude of the user's location.", "type": "number", "format": "double" }, "longitude": { "format": "double", "type": "number", "description": "The longitude of the user's location." } }, "type": "object", "description": "A tool that can be used by the model to call Google Maps." }, "GoogleCloudAiplatformV1beta1FeatureViewVertexRagSource": { "properties": { "ragCorpusId": { "format": "int64", "description": "Optional. The RAG corpus id corresponding to this FeatureView.", "type": "string" }, "uri": { "type": "string", "description": "Required. The BigQuery view/table URI that will be materialized on each manual sync trigger. The table/view is expected to have the following columns and types at least: - `corpus_id` (STRING, NULLABLE/REQUIRED) - `file_id` (STRING, NULLABLE/REQUIRED) - `chunk_id` (STRING, NULLABLE/REQUIRED) - `chunk_data_type` (STRING, NULLABLE/REQUIRED) - `chunk_data` (STRING, NULLABLE/REQUIRED) - `embeddings` (FLOAT, REPEATED) - `file_original_uri` (STRING, NULLABLE/REQUIRED)" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1FeatureViewVertexRagSource", "description": "A Vertex Rag source for features that need to be synced to Online Store." }, "GoogleCloudAiplatformV1beta1GdcConfig": { "properties": { "zone": { "description": "GDC zone. A cluster will be designated for the Vertex AI workload in this zone.", "type": "string" } }, "description": "Google Distributed Cloud (GDC) config.", "id": "GoogleCloudAiplatformV1beta1GdcConfig", "type": "object" }, "GoogleCloudAiplatformV1beta1ModelEvaluation": { "type": "object", "properties": { "biasConfigs": { "description": "Specify the configuration for bias detection.", "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationBiasConfig" }, "explanationSpecs": { "description": "Describes the values of ExplanationSpec that are used for explaining the predicted values on the evaluated data.", "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationModelEvaluationExplanationSpec" } }, "modelExplanation": { "description": "Aggregated explanation metrics for the Model's prediction output over the data this ModelEvaluation uses. This field is populated only if the Model is evaluated with explanations, and only for AutoML tabular Models. ", "$ref": "GoogleCloudAiplatformV1beta1ModelExplanation" }, "metadata": { "description": "The metadata of the ModelEvaluation. For the ModelEvaluation uploaded from Managed Pipeline, metadata contains a structured value with keys of \"pipeline_job_id\", \"evaluation_dataset_type\", \"evaluation_dataset_path\", \"row_based_metrics_path\".", "type": "any" }, "metricsSchemaUri": { "type": "string", "description": "Points to a YAML file stored on Google Cloud Storage describing the metrics of this ModelEvaluation. The schema is defined as an OpenAPI 3.0.2 [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject)." }, "createTime": { "readOnly": true, "description": "Output only. Timestamp when this ModelEvaluation was created.", "format": "google-datetime", "type": "string" }, "metrics": { "description": "Evaluation metrics of the Model. The schema of the metrics is stored in metrics_schema_uri", "type": "any" }, "displayName": { "type": "string", "description": "The display name of the ModelEvaluation." }, "name": { "type": "string", "description": "Output only. The resource name of the ModelEvaluation.", "readOnly": true }, "sliceDimensions": { "type": "array", "description": "All possible dimensions of ModelEvaluationSlices. The dimensions can be used as the filter of the ModelService.ListModelEvaluationSlices request, in the form of `slice.dimension = `.", "items": { "type": "string" } } }, "id": "GoogleCloudAiplatformV1beta1ModelEvaluation", "description": "A collection of metrics calculated by comparing Model's predictions on all of the test data against annotations from the test data." }, "GoogleCloudAiplatformV1beta1AnalyzedInvocation": { "id": "GoogleCloudAiplatformV1beta1AnalyzedInvocation", "description": "Represents an analyzed invocation for a monitored agent's session.", "type": "object", "properties": { "name": { "description": "Identifier. The resource name of the AnalyzedInvocation.", "type": "string" }, "invocationId": { "readOnly": true, "type": "string", "description": "Output only. The invocation ID." }, "invocationState": { "description": "Output only. The state of the invocation.", "enum": [ "INVOCATION_STATE_UNSPECIFIED", "INVOCATION_STATE_ANOMALOUS", "INVOCATION_STATE_NOT_ANOMALOUS" ], "enumDescriptions": [ "Unspecified state.", "The invocation is anomalous.", "The invocation is not anomalous." ], "type": "string", "readOnly": true }, "assessment": { "$ref": "GoogleCloudAiplatformV1beta1Assessment", "readOnly": true, "description": "Output only. The assessment of the invocation." } } }, "GoogleCloudAiplatformV1beta1ContentMapContents": { "properties": { "contents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Optional. Repeated contents." } }, "id": "GoogleCloudAiplatformV1beta1ContentMapContents", "type": "object", "description": "Repeated Content type." }, "GoogleCloudAiplatformV1beta1DirectPredictResponse": { "description": "Response message for PredictionService.DirectPredict.", "properties": { "parameters": { "description": "The parameters that govern the prediction.", "$ref": "GoogleCloudAiplatformV1beta1Tensor" }, "outputs": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Tensor" }, "type": "array", "description": "The prediction output." } }, "id": "GoogleCloudAiplatformV1beta1DirectPredictResponse", "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigTreeAHConfig": { "type": "object", "properties": { "leafNodeEmbeddingCount": { "description": "Optional. Number of embeddings on each leaf node. The default value is 1000 if not set.", "format": "int64", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1FeatureViewVectorSearchConfigTreeAHConfig" }, "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairList": { "description": "Response structure in the format of key (feature name) and (feature) value pair.", "properties": { "features": { "items": { "$ref": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairListFeatureNameValuePair" }, "type": "array", "description": "List of feature names and values." } }, "id": "GoogleCloudAiplatformV1beta1FetchFeatureValuesResponseFeatureNameValuePairList", "type": "object" }, "GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback": { "description": "Content filter results for a prompt sent in the request. Note: This is sent only in the first stream chunk and only if no candidates were generated due to content violations.", "type": "object", "properties": { "safetyRatings": { "type": "array", "description": "Output only. A list of safety ratings for the prompt. There is one rating per category.", "items": { "$ref": "GoogleCloudAiplatformV1beta1SafetyRating" }, "readOnly": true }, "blockReasonMessage": { "readOnly": true, "description": "Output only. A readable message that explains the reason why the prompt was blocked.", "type": "string" }, "blockReason": { "enumDescriptions": [ "The blocked reason is unspecified.", "The prompt was blocked for safety reasons.", "The prompt was blocked for other reasons. For example, it may be due to the prompt's language, or because it contains other harmful content.", "The prompt was blocked because it contains a term from the terminology blocklist.", "The prompt was blocked because it contains prohibited content.", "The prompt was blocked by Model Armor.", "The prompt was blocked because it contains content that is unsafe for image generation.", "The prompt was blocked as a jailbreak attempt." ], "enum": [ "BLOCKED_REASON_UNSPECIFIED", "SAFETY", "OTHER", "BLOCKLIST", "PROHIBITED_CONTENT", "MODEL_ARMOR", "IMAGE_SAFETY", "JAILBREAK" ], "readOnly": true, "type": "string", "description": "Output only. The reason why the prompt was blocked." } }, "id": "GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback" }, "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInput": { "description": "Input for tool parameter key match metric.", "type": "object", "properties": { "metricSpec": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchSpec", "description": "Required. Spec for tool parameter key match metric." }, "instances": { "items": { "$ref": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInstance" }, "type": "array", "description": "Required. Repeated tool parameter key match instances." } }, "id": "GoogleCloudAiplatformV1beta1ToolParameterKeyMatchInput" }, "GoogleCloudAiplatformV1beta1PairwiseMetricInput": { "id": "GoogleCloudAiplatformV1beta1PairwiseMetricInput", "description": "Input for pairwise metric.", "properties": { "instance": { "description": "Required. Pairwise metric instance.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricInstance" }, "metricSpec": { "description": "Required. Spec for pairwise metric.", "$ref": "GoogleCloudAiplatformV1beta1PairwiseMetricSpec" } }, "type": "object" }, "GoogleLongrunningListOperationsResponse": { "properties": { "operations": { "type": "array", "items": { "$ref": "GoogleLongrunningOperation" }, "description": "A list of operations that matches the specified filter in the request." }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations." } }, "description": "The response message for Operations.ListOperations.", "type": "object", "id": "GoogleLongrunningListOperationsResponse" }, "GenaiVertexV1beta1GoogleMapsResultStep": { "id": "GenaiVertexV1beta1GoogleMapsResultStep", "description": "Google Maps result step.", "type": "object", "properties": { "result": { "type": "array", "items": { "$ref": "GenaiVertexV1beta1GoogleMapsResultStepGoogleMapsResultItem" } } } }, "GoogleCloudAiplatformV1beta1ResponseFormat": { "id": "GoogleCloudAiplatformV1beta1ResponseFormat", "type": "object", "description": "Configuration for the model to configure output formatting and delivery.", "properties": { "audio": { "$ref": "GoogleCloudAiplatformV1beta1AudioResponseFormat", "description": "Audio output format." }, "image": { "$ref": "GoogleCloudAiplatformV1beta1ImageResponseFormat", "description": "Image output format." }, "video": { "$ref": "GoogleCloudAiplatformV1beta1VideoResponseFormat", "description": "Video output format." }, "text": { "$ref": "GoogleCloudAiplatformV1beta1TextResponseFormat", "description": "Text output format." } } }, "GoogleCloudAiplatformV1beta1DeleteOnlineEvaluatorOperationMetadata": { "type": "object", "properties": { "genericMetadata": { "description": "Generic operation metadata.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } }, "description": "Metadata for the DeleteOnlineEvaluator operation.", "id": "GoogleCloudAiplatformV1beta1DeleteOnlineEvaluatorOperationMetadata" }, "GoogleCloudAiplatformV1beta1RagChunk": { "id": "GoogleCloudAiplatformV1beta1RagChunk", "description": "A RagChunk includes the content of a chunk of a RagFile, and associated metadata.", "properties": { "fileId": { "description": "The ID of the file that the chunk belongs to.", "type": "string" }, "chunkId": { "type": "string", "description": "The ID of the chunk." }, "text": { "type": "string", "description": "The content of the chunk." }, "pageSpan": { "description": "If populated, represents where the chunk starts and ends in the document.", "$ref": "GoogleCloudAiplatformV1beta1RagChunkPageSpan" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfig": { "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfig", "properties": { "sources": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1SchemaPredictParamsGroundingConfigSourceEntry" }, "description": "The sources for the grounding checking." }, "disableAttribution": { "deprecated": true, "description": "If set, skip finding claim attributions (i.e not generate grounding citation).", "type": "boolean" } }, "description": "The configuration for grounding checking.", "type": "object" }, "GoogleCloudAiplatformV1beta1SchemaVideoActionRecognitionAnnotation": { "description": "Annotation details specific to video action recognition.", "properties": { "timeSegment": { "description": "This Annotation applies to the time period represented by the TimeSegment. If it's not set, the Annotation applies to the whole video.", "$ref": "GoogleCloudAiplatformV1beta1SchemaTimeSegment" }, "annotationSpecId": { "type": "string", "description": "The resource Id of the AnnotationSpec that this Annotation pertains to." }, "displayName": { "description": "The display name of the AnnotationSpec that this Annotation pertains to.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaVideoActionRecognitionAnnotation" }, "GoogleCloudAiplatformV1beta1AugmentPromptRequestModel": { "type": "object", "properties": { "modelVersion": { "type": "string", "description": "Optional. The model version of the backend deployed model." }, "model": { "type": "string", "description": "Optional. The model that the user will send the augmented prompt for content generation." } }, "id": "GoogleCloudAiplatformV1beta1AugmentPromptRequestModel", "description": "Metadata of the backend deployed model." }, "GoogleCloudAiplatformV1beta1ListFeaturestoresResponse": { "description": "Response message for FeaturestoreService.ListFeaturestores.", "id": "GoogleCloudAiplatformV1beta1ListFeaturestoresResponse", "type": "object", "properties": { "featurestores": { "items": { "$ref": "GoogleCloudAiplatformV1beta1Featurestore" }, "type": "array", "description": "The Featurestores matching the request." }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as ListFeaturestoresRequest.page_token to retrieve the next page. If this field is omitted, there are no subsequent pages." } } }, "GoogleCloudAiplatformV1beta1GeminiPreferenceExample": { "type": "object", "id": "GoogleCloudAiplatformV1beta1GeminiPreferenceExample", "properties": { "contents": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1Content" }, "description": "Multi-turn contents that represents the Prompt." }, "completions": { "items": { "$ref": "GoogleCloudAiplatformV1beta1GeminiPreferenceExampleCompletion" }, "description": "List of completions for a given prompt.", "type": "array" } }, "description": "Input example for preference optimization." }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopic": { "properties": { "managedMemoryTopic": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicManagedMemoryTopic", "description": "A managed memory topic defined by Memory Bank." }, "customMemoryTopic": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopicCustomMemoryTopic", "description": "A custom memory topic defined by the developer." } }, "description": "A topic of information that should be extracted from conversations and stored as memories.", "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigMemoryTopic", "type": "object" }, "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExample": { "id": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExample", "description": "An example of how to generate memories for a particular scope.", "properties": { "conversationSource": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSource", "description": "A conversation source for the example." }, "generatedMemories": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleGeneratedMemory" }, "description": "Optional. Represents the memories that are expected to be generated from the input conversation. An empty list indicates that no memories are expected to be generated for the input conversation." } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FileData": { "description": "URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage.", "id": "GoogleCloudAiplatformV1beta1FileData", "type": "object", "properties": { "displayName": { "type": "string", "description": "Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled." }, "fileUri": { "type": "string", "description": "Required. The URI of the file in Google Cloud Storage." }, "mimeType": { "type": "string", "description": "Required. The IANA standard MIME type of the source data." } } }, "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageObjectDetectionPredictionParams": { "description": "Prediction model parameters for Image Object Detection.", "type": "object", "properties": { "confidenceThreshold": { "description": "The Model only returns predictions with at least this confidence score. Default value is 0.0", "format": "float", "type": "number" }, "maxPredictions": { "format": "int32", "type": "integer", "description": "The Model only returns up to that many top, by confidence score, predictions per instance. Note that number of returned predictions is also limited by metadata's predictionsLimit. Default value is 10." } }, "id": "GoogleCloudAiplatformV1beta1SchemaPredictParamsImageObjectDetectionPredictionParams" }, "GoogleCloudAiplatformV1beta1SchemaImageDataItem": { "description": "Payload of Image DataItem.", "properties": { "mimeType": { "type": "string", "readOnly": true, "description": "Output only. The mime type of the content of the image. Only the images in below listed mime types are supported. - image/jpeg - image/gif - image/png - image/webp - image/bmp - image/tiff - image/vnd.microsoft.icon" }, "gcsUri": { "type": "string", "description": "Required. Google Cloud Storage URI points to the original image in user's bucket. The image is up to 30MB in size." } }, "id": "GoogleCloudAiplatformV1beta1SchemaImageDataItem", "type": "object" }, "GoogleCloudAiplatformV1beta1DistillationSpec": { "properties": { "promptDatasetUri": { "description": "Optional. Cloud Storage path to file containing prompt dataset for distillation. The dataset must be formatted as a JSONL file.", "type": "string" }, "studentModel": { "description": "The student model that is being tuned, e.g., \"google/gemma-2b-1.1-it\". Deprecated. Use base_model instead.", "type": "string", "deprecated": true }, "hyperParameters": { "$ref": "GoogleCloudAiplatformV1beta1DistillationHyperParameters", "description": "Optional. Hyperparameters for Distillation." }, "validationDatasetUri": { "description": "Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file.", "type": "string" }, "tuningMode": { "enum": [ "TUNING_MODE_UNSPECIFIED", "TUNING_MODE_FULL", "TUNING_MODE_PEFT_ADAPTER" ], "description": "Optional. Specifies the tuning mode for distillation (sft part). This feature is only available for open source models.", "enumDescriptions": [ "Tuning mode is unspecified.", "Full fine-tuning mode.", "PEFT adapter tuning mode." ], "type": "string" }, "pipelineRootDirectory": { "description": "Deprecated. A path in a Cloud Storage bucket, which will be treated as the root output directory of the distillation pipeline. It is used by the system to generate the paths of output artifacts.", "type": "string", "deprecated": true }, "trainingDatasetUri": { "type": "string", "description": "Deprecated. Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file.", "deprecated": true }, "baseTeacherModel": { "description": "The base teacher model that is being distilled. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models).", "type": "string" }, "tunedTeacherModelSource": { "description": "The resource name of the Tuned teacher model. Format: `projects/{project}/locations/{location}/models/{model}`.", "type": "string" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1DistillationSpec", "description": "Tuning Spec for Distillation." }, "GoogleLearningVertexApiInteractionsV1beta1CreateVoiceHttpTranscoderRequest": { "id": "GoogleLearningVertexApiInteractionsV1beta1CreateVoiceHttpTranscoderRequest", "description": "Request message for `VoicesHttpService.CreateVoiceHttp`.", "properties": { "httpBody": { "description": "Required. The request body containing the `CreateVoiceRequest` payload.", "$ref": "GoogleApiHttpBody" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1FeatureValueMetadata": { "properties": { "generateTime": { "format": "google-datetime", "description": "Feature generation timestamp. Typically, it is provided by user at feature ingestion time. If not, feature store will use the system timestamp when the data is ingested into feature store. Legacy Feature Store: For streaming ingestion, the time, aligned by days, must be no older than five years (1825 days) and no later than one year (366 days) in the future.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1FeatureValueMetadata", "description": "Metadata of feature value.", "type": "object" }, "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbKNN": { "description": "Config for KNN search.", "properties": {}, "type": "object", "id": "GoogleCloudAiplatformV1beta1RagVectorDbConfigRagManagedDbKNN" }, "GoogleCloudAiplatformV1beta1UndeployIndexOperationMetadata": { "description": "Runtime operation information for IndexEndpointService.UndeployIndex.", "id": "GoogleCloudAiplatformV1beta1UndeployIndexOperationMetadata", "type": "object", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" } } }, "GoogleCloudAiplatformV1beta1PauseScheduleRequest": { "properties": {}, "description": "Request message for ScheduleService.PauseSchedule.", "type": "object", "id": "GoogleCloudAiplatformV1beta1PauseScheduleRequest" }, "GoogleCloudAiplatformV1beta1PublisherModelParent": { "description": "The information about the parent of a model.", "properties": { "displayName": { "type": "string", "description": "Required. The display name of the parent. E.g., LaMDA, T5, Vision API, Natural Language API." }, "reference": { "description": "Optional. The Google Cloud resource name or the URI reference.", "$ref": "GoogleCloudAiplatformV1beta1PublisherModelResourceReference" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1PublisherModelParent" }, "GoogleCloudAiplatformV1beta1ExecuteExtensionRequest": { "description": "Request message for ExtensionExecutionService.ExecuteExtension.", "id": "GoogleCloudAiplatformV1beta1ExecuteExtensionRequest", "type": "object", "properties": { "operationParams": { "description": "Optional. Request parameters that will be used for executing this operation. The struct should be in a form of map with param name as the key and actual param value as the value. E.g. If this operation requires a param \"name\" to be set to \"abc\". you can set this to something like {\"name\": \"abc\"}.", "additionalProperties": { "type": "any", "description": "Properties of the object." }, "type": "object" }, "operationId": { "description": "Required. The desired ID of the operation to be executed in this extension as defined in ExtensionOperation.operation_id.", "type": "string" }, "runtimeAuthConfig": { "$ref": "GoogleCloudAiplatformV1beta1AuthConfig", "description": "Optional. Auth config provided at runtime to override the default value in Extension.manifest.auth_config. The AuthConfig.auth_type should match the value in Extension.manifest.auth_config." } } }, "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsResponse": { "type": "object", "properties": { "importedEvaluatedAnnotationsCount": { "description": "Output only. Number of EvaluatedAnnotations imported.", "readOnly": true, "format": "int32", "type": "integer" } }, "id": "GoogleCloudAiplatformV1beta1BatchImportEvaluatedAnnotationsResponse", "description": "Response message for ModelService.BatchImportEvaluatedAnnotations" }, "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageSegmentationEvaluationMetricsConfidenceMetricsEntry": { "type": "object", "id": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsImageSegmentationEvaluationMetricsConfidenceMetricsEntry", "properties": { "iouScore": { "format": "float", "description": "The intersection-over-union score. The measure of overlap of the annotation's category mask with ground truth category mask on the DataItem.", "type": "number" }, "precision": { "description": "Precision for the given confidence threshold.", "type": "number", "format": "float" }, "diceScoreCoefficient": { "type": "number", "description": "DSC or the F1 score, The harmonic mean of recall and precision.", "format": "float" }, "confusionMatrix": { "description": "Confusion matrix for the given confidence threshold.", "$ref": "GoogleCloudAiplatformV1beta1SchemaModelevaluationMetricsConfusionMatrix" }, "recall": { "format": "float", "description": "Recall (True Positive Rate) for the given confidence threshold.", "type": "number" }, "confidenceThreshold": { "description": "Metrics are computed with an assumption that the model never returns predictions with score lower than this value.", "format": "float", "type": "number" } } }, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScope": { "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScope", "properties": { "filter": { "items": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScopePredicate" }, "type": "array", "description": "Optional. A list of predicates to filter traces. Multiple predicates are combined using AND. The maximum number of predicates is 10." } }, "description": "If chosen, the online evaluator will evaluate single traces matching specified `filter`.", "type": "object" }, "GoogleCloudAiplatformV1beta1RollbackMemoryRequest": { "description": "Request message for MemoryBankService.RollbackMemory.", "properties": { "targetRevisionId": { "description": "Required. The ID of the revision to rollback to.", "type": "string", "format": "int64" } }, "type": "object", "id": "GoogleCloudAiplatformV1beta1RollbackMemoryRequest" }, "GoogleCloudAiplatformV1beta1SandboxEnvironment": { "properties": { "name": { "type": "string", "description": "Identifier. The name of the SandboxEnvironment." }, "owner": { "description": "Optional. Owner information for this sandbox environment. A Sandbox can only be restored from a snapshot that belongs to the same owner. If not set, sandbox will be created as the default owner.", "type": "string" }, "ttl": { "format": "google-duration", "type": "string", "description": "Optional. Input only. The TTL for the sandbox environment. The expiration time is computed: now + TTL." }, "sandboxEnvironmentSnapshot": { "description": "Optional. The resource name of the SandboxEnvironmentSnapshot to use for creating this SandboxEnvironment. Format: `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sandboxEnvironmentSnapshots/{sandbox_environment_snapshot}`", "type": "string" }, "spec": { "description": "Optional. The configuration of the SandboxEnvironment.", "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentSpec" }, "updateTime": { "description": "Output only. The timestamp when this SandboxEnvironment was most recently updated.", "readOnly": true, "format": "google-datetime", "type": "string" }, "latestSandboxEnvironmentSnapshot": { "description": "Output only. The resource name of the latest snapshot taken for this SandboxEnvironment.", "readOnly": true, "type": "string" }, "sandboxEnvironmentTemplate": { "type": "string", "description": "Optional. The name of the SandboxEnvironmentTemplate specified in the parent Agent Engine resource that this SandboxEnvironment is created from." }, "displayName": { "description": "Required. The display name of the SandboxEnvironment.", "type": "string" }, "state": { "description": "Output only. The runtime state of the SandboxEnvironment.", "enumDescriptions": [ "The default value. This value is unused.", "Runtime resources are being allocated for the sandbox environment.", "Sandbox runtime is ready for serving.", "Sandbox runtime is halted, performing tear down tasks.", "Sandbox has terminated with underlying runtime failure.", "Sandbox runtime has been deleted.", "Sandbox runtime is paused.", "Sandbox runtime is pausing.", "Sandbox runtime is resuming.", "Sandbox runtime is stopping." ], "enum": [ "STATE_UNSPECIFIED", "STATE_PROVISIONING", "STATE_RUNNING", "STATE_DEPROVISIONING", "STATE_TERMINATED", "STATE_DELETED", "STATE_PAUSED", "STATE_PAUSING", "STATE_RESUMING", "STATE_STOPPING" ], "readOnly": true, "type": "string" }, "createTime": { "readOnly": true, "type": "string", "description": "Output only. The timestamp when this SandboxEnvironment was created.", "format": "google-datetime" }, "connectionInfo": { "$ref": "GoogleCloudAiplatformV1beta1SandboxEnvironmentConnectionInfo", "readOnly": true, "description": "Output only. The connection information of the SandboxEnvironment." }, "expireTime": { "type": "string", "format": "google-datetime", "description": "Optional. Timestamp in UTC of when this SandboxEnvironment is considered expired. This is *always* provided on output, regardless of what `expiration` was sent on input." } }, "description": "SandboxEnvironment is a containerized environment that provides a customizable secure execution runtime for AI agents.", "type": "object", "id": "GoogleCloudAiplatformV1beta1SandboxEnvironment" }, "GoogleCloudAiplatformV1beta1ModelEvaluationBiasConfig": { "description": "Configuration for bias detection.", "type": "object", "properties": { "biasSlices": { "description": "Specification for how the data should be sliced for bias. It contains a list of slices, with limitation of two slices. The first slice of data will be the slice_a. The second slice in the list (slice_b) will be compared against the first slice. If only a single slice is provided, then slice_a will be compared against \"not slice_a\". Below are examples with feature \"education\" with value \"low\", \"medium\", \"high\" in the dataset: Example 1: bias_slices = [{'education': 'low'}] A single slice provided. In this case, slice_a is the collection of data with 'education' equals 'low', and slice_b is the collection of data with 'education' equals 'medium' or 'high'. Example 2: bias_slices = [{'education': 'low'}, {'education': 'high'}] Two slices provided. In this case, slice_a is the collection of data with 'education' equals 'low', and slice_b is the collection of data with 'education' equals 'high'.", "$ref": "GoogleCloudAiplatformV1beta1ModelEvaluationSliceSliceSliceSpec" }, "labels": { "description": "Positive labels selection on the target field.", "items": { "type": "string" }, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ModelEvaluationBiasConfig" }, "GoogleCloudAiplatformV1beta1PartialArg": { "properties": { "boolValue": { "type": "boolean", "description": "Optional. Represents a boolean value." }, "numberValue": { "type": "number", "format": "double", "description": "Optional. Represents a double value." }, "nullValue": { "type": "string", "description": "Optional. Represents a null value.", "enum": [ "NULL_VALUE" ], "enumDescriptions": [ "Null value." ] }, "jsonPath": { "description": "Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. \"$.foo.bar[0].data\".", "type": "string" }, "willContinue": { "type": "boolean", "description": "Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow." }, "stringValue": { "description": "Optional. Represents a string value.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1PartialArg", "description": "Partial argument value of the function call.", "type": "object" }, "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntime": { "type": "object", "properties": { "customContainerImage": { "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeContainerImage", "description": "A user-provided container image. The notebook executes inside this container on a managed container-host (COS) VM." }, "vmImage": { "description": "A specific Compute Engine VM image to run the notebook on.", "$ref": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntimeVmImage" } }, "description": "Configuration for a Workbench Instances-based environment.", "id": "GoogleCloudAiplatformV1beta1NotebookExecutionJobWorkbenchRuntime" }, "GoogleCloudAiplatformV1beta1UpsertExamplesResponse": { "id": "GoogleCloudAiplatformV1beta1UpsertExamplesResponse", "properties": { "results": { "description": "A list of results for creating/updating. It's either a successfully created/updated example or a status with an error message.", "items": { "$ref": "GoogleCloudAiplatformV1beta1UpsertExamplesResponseUpsertResult" }, "type": "array" } }, "description": "Response message for ExampleStoreService.UpsertExamples.", "type": "object" }, "GoogleCloudAiplatformV1beta1GroundednessSpec": { "type": "object", "properties": { "version": { "description": "Optional. Which version to use for evaluation.", "format": "int32", "type": "integer" } }, "description": "Spec for groundedness metric.", "id": "GoogleCloudAiplatformV1beta1GroundednessSpec" }, "GoogleCloudAiplatformV1beta1ModelExportFormat": { "type": "object", "description": "Represents export format supported by the Model. All formats export to Google Cloud Storage.", "properties": { "id": { "readOnly": true, "description": "Output only. The ID of the export format. The possible format IDs are: * `tflite` Used for Android mobile devices. * `edgetpu-tflite` Used for [Edge TPU](https://cloud.google.com/edge-tpu/) devices. * `tf-saved-model` A tensorflow model in SavedModel format. * `tf-js` A [TensorFlow.js](https://www.tensorflow.org/js) model that can be used in the browser and in Node.js using JavaScript. * `core-ml` Used for iOS mobile devices. * `custom-trained` A Model that was uploaded or trained by custom code. * `genie` A tuned Model Garden model.", "type": "string" }, "exportableContents": { "items": { "enumDescriptions": [ "Should not be used.", "Model artifact and any of its supported files. Will be exported to the location specified by the `artifactDestination` field of the ExportModelRequest.output_config object.", "The container image that is to be used when deploying this Model. Will be exported to the location specified by the `imageDestination` field of the ExportModelRequest.output_config object." ], "type": "string", "enum": [ "EXPORTABLE_CONTENT_UNSPECIFIED", "ARTIFACT", "IMAGE" ] }, "description": "Output only. The content of this Model that may be exported.", "readOnly": true, "type": "array" } }, "id": "GoogleCloudAiplatformV1beta1ModelExportFormat" }, "GoogleCloudAiplatformV1beta1PublisherModelEulaAcceptance": { "id": "GoogleCloudAiplatformV1beta1PublisherModelEulaAcceptance", "description": "Response message for ModelGardenService.UpdatePublisherModelEula.", "properties": { "publisherModel": { "description": "The publisher model resource name.", "type": "string" }, "publisherModelEulaAcked": { "description": "The EULA content acceptance status.", "type": "boolean" }, "projectNumber": { "description": "The project number requesting access for named model.", "type": "string", "format": "int64" } }, "type": "object" }, "GoogleCloudAiplatformV1beta1ListModelMonitoringJobsResponse": { "type": "object", "id": "GoogleCloudAiplatformV1beta1ListModelMonitoringJobsResponse", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "modelMonitoringJobs": { "description": "A list of ModelMonitoringJobs that matches the specified filter in the request.", "items": { "$ref": "GoogleCloudAiplatformV1beta1ModelMonitoringJob" }, "type": "array" } }, "description": "Response message for ModelMonitoringService.ListModelMonitoringJobs." }, "GoogleCloudAiplatformV1beta1StartNotebookRuntimeOperationMetadata": { "description": "Metadata information for NotebookService.StartNotebookRuntime.", "type": "object", "id": "GoogleCloudAiplatformV1beta1StartNotebookRuntimeOperationMetadata", "properties": { "genericMetadata": { "description": "The operation generic information.", "$ref": "GoogleCloudAiplatformV1beta1GenericOperationMetadata" }, "progressMessage": { "description": "A human-readable message that shows the intermediate progress details of NotebookRuntime.", "type": "string" } } }, "GoogleCloudAiplatformV1beta1EvaluationParserConfigCustomCodeParserConfig": { "properties": { "parsingFunction": { "description": "Required. Python function for parsing results. The function should be defined within this string. The function takes a list of strings (LLM responses) and should return either a list of dictionaries (for rubrics) or a single dictionary (for a metric result). Example function signature: def parse(responses: list[str]) -\u003e list[dict[str, Any]] | dict[str, Any]: When parsing rubrics, return a list of dictionaries, where each dictionary represents a Rubric. Example for rubrics: [ { \"content\": {\"property\": {\"description\": \"The response is factual.\"}}, \"type\": \"FACTUALITY\", \"importance\": \"HIGH\" }, { \"content\": {\"property\": {\"description\": \"The response is fluent.\"}}, \"type\": \"FLUENCY\", \"importance\": \"MEDIUM\" } ] When parsing critique results, return a dictionary representing a MetricResult. Example for a metric result: { \"score\": 0.8, \"explanation\": \"The model followed most instructions.\", \"rubric_verdicts\": [...] } ... code for result extraction and aggregation", "type": "string" }, "codeExecutionRegion": { "description": "Optional. The region to use for code execution. If set, the Code Execution Sandbox will be invoked in the specified region regardless of the request's originating region. Must be a region where the Code Execution Sandbox is available. For the current list of [supported regions](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/locations). If unset, the request's originating region is used.", "type": "string" } }, "id": "GoogleCloudAiplatformV1beta1EvaluationParserConfigCustomCodeParserConfig", "type": "object", "description": "Configuration for parsing the LLM response using custom code." }, "GoogleTypeExpr": { "type": "object", "properties": { "description": { "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", "type": "string" }, "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "title": { "type": "string", "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression." }, "location": { "type": "string", "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file." } }, "id": "GoogleTypeExpr", "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information." }, "GoogleCloudAiplatformV1beta1ReadTensorboardBlobDataResponse": { "type": "object", "description": "Response message for TensorboardService.ReadTensorboardBlobData.", "id": "GoogleCloudAiplatformV1beta1ReadTensorboardBlobDataResponse", "properties": { "blobs": { "type": "array", "items": { "$ref": "GoogleCloudAiplatformV1beta1TensorboardBlob" }, "description": "Blob messages containing blob bytes." } } }, "GoogleCloudAiplatformV1beta1Presets": { "type": "object", "properties": { "query": { "description": "Preset option controlling parameters for speed-precision trade-off when querying for examples. If omitted, defaults to `PRECISE`.", "enum": [ "PRECISE", "FAST" ], "enumDescriptions": [ "More precise neighbors as a trade-off against slower response.", "Faster response as a trade-off against less precise neighbors." ], "type": "string" }, "modality": { "type": "string", "enumDescriptions": [ "Should not be set. Added as a recommended best practice for enums", "IMAGE modality", "TEXT modality", "TABULAR modality" ], "enum": [ "MODALITY_UNSPECIFIED", "IMAGE", "TEXT", "TABULAR" ], "description": "The modality of the uploaded model, which automatically configures the distance measurement and feature normalization for the underlying example index and queries. If your model does not precisely fit one of these types, it is okay to choose the closest type." } }, "id": "GoogleCloudAiplatformV1beta1Presets", "description": "Preset configuration for example-based explanations" }, "GoogleCloudAiplatformV1beta1FluencyResult": { "id": "GoogleCloudAiplatformV1beta1FluencyResult", "properties": { "score": { "type": "number", "description": "Output only. Fluency score.", "format": "float", "readOnly": true }, "confidence": { "type": "number", "format": "float", "description": "Output only. Confidence for fluency score.", "readOnly": true }, "explanation": { "readOnly": true, "type": "string", "description": "Output only. Explanation for fluency score." } }, "description": "Spec for fluency result.", "type": "object" }, "GoogleCloudAiplatformV1beta1StructValue": { "type": "object", "description": "Struct (or object) type feature value.", "id": "GoogleCloudAiplatformV1beta1StructValue", "properties": { "values": { "description": "A list of field values.", "items": { "$ref": "GoogleCloudAiplatformV1beta1StructFieldValue" }, "type": "array" } } } }, "baseUrl": "https://aiplatform.googleapis.com/", "rootUrl": "https://aiplatform.googleapis.com/", "basePath": "", "parameters": { "$.xgafv": { "description": "V1 error format.", "location": "query", "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ] }, "alt": { "type": "string", "default": "json", "description": "Data format for response.", "enum": [ "json", "media", "proto" ], "location": "query", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "type": "string", "location": "query" }, "uploadType": { "type": "string", "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "type": "string", "location": "query" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "location": "query", "type": "boolean", "default": "true" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "type": "string", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" } }, "ownerName": "Google", "id": "aiplatform:v1beta1", "documentationLink": "https://cloud.google.com/vertex-ai/", "kind": "discovery#restDescription", "mtlsRootUrl": "https://aiplatform.mtls.googleapis.com/", "servicePath": "", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform.read-only": { "description": "View your data across Google Cloud services and see the email address of your Google Account" }, "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/aiplatform": { "description": "See, edit, configure, and delete your Google Cloud Vertex AI data and see the email address for your Google Account" } } } }, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "canonicalName": "Aiplatform", "discoveryVersion": "v1", "description": "Build, scale, govern, and optimize sophisticated agents and models.", "fullyEncodeReservedExpansion": true, "name": "aiplatform", "batchPath": "batch" }