googleapis--mcp-toolbox/docs/en/integrations/knowledge-catalog/tools/knowledge-catalog-get-operation.md

title, type, weight, description, aliases

title	type	weight	description	aliases
dataplex-get-operation	docs	1	Retrieves the status of an asynchronous Dataplex Long-Running Operation (LRO).	/integrations/dataplex/tools/dataplex-get-operation/

About

A dataplex-get-operation tool retrieves the status of a Dataplex long-running operation (LRO) like scan creation.

Poll this tool until the done field from the response is true. Once completed, the response field will contain the created DataScan resource, from which you can extract the scanId (the last part of the name field, e.g. nq-doc-1234) to pass to get_run_status and get results. WARNING: This only tracks the creation of the scan template, NOT the actual background execution.

Compatible Sources

{{< compatible-sources >}}

Requirements

IAM Permissions

Knowledge Catalog uses Identity and Access Management (IAM) to control user and group access to Knowledge Catalog resources. Toolbox will use your Application Default Credentials (ADC) to authorize and authenticate when interacting with [Knowledge Catalog][dataplex-docs].

In addition to setting the ADC for your server, you need to ensure the IAM identity has been given the correct IAM permissions for the tasks you intend to perform. See Knowledge Catalog IAM permissions and Knowledge Catalog IAM roles for more information on applying IAM permissions and roles to an identity.

Parameters

The dataplex-get-operation tool accepts the following parameters:

field	type	required	description
operationName	string	true	The full operation resource name (format: projects/{project}/locations/{location}/operations/{operation_id}).

Example

kind: tool
name: get_operation
type: dataplex-get-operation
source: my-dataplex-source
description: Check the status of a long-running scan template creation.

Reference

field	type	required	description
type	string	true	Must be "dataplex-get-operation".
source	string	true	Name of the source the tool should execute on.
description	string	true	Description of the tool that is passed to the LLM.