Data Catalog API methods that are related to Data Catalog search and metadata are deprecated and will be discontinued on January 30, 2026. See Transition from Data Catalog to Dataplex Universal Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
Gets the access control policy for a resource. A NOT_FOUND error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.
Supported resources are: - Tag templates. - Entries. - Entry groups. Note, this method cannot be used to manage policies for BigQuery, Pub/Sub and any external Google Cloud Platform resources synced to Data Catalog.
Callers must have following Google IAM permission - datacatalog.tagTemplates.getIamPolicy to get policies on tag templates. - datacatalog.entries.getIamPolicy to get policies on entries. - datacatalog.entryGroups.getIamPolicy to get policies on entry groups.
HTTP request
POST https://datacatalog.googleapis.com/v1beta1/{resource}:getIamPolicy
Path parameters
Parameters
resource
string
REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.
Request body
The request body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-17 UTC."],[[["This page details how to retrieve the access control policy for specific resources within the Data Catalog, which include tag templates, entries, and entry groups."],["The required HTTP request is a POST method to the specified URL, with the resource path as a parameter."],["The request body structure is defined using JSON representation, including optional fields like `options` for specifying `GetPolicyOptions`."],["Successful requests will return a response body containing an instance of `Policy`."],["Retrieving a resource's access control policy requires specific Google IAM permissions depending on the resource type, and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope is necessary for authorization."]]],[]]
