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 Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
Returns your permissions on a specified policy tag or taxonomy.
HTTP request
POST https://datacatalog.googleapis.com/v1/{resource}:testIamPermissions
Path parameters
Parameters
resource
string
REQUIRED: The resource for which the policy detail is being requested. See Resource names for the appropriate value for this field. It takes the form projects/{project}/locations/{location}/taxonomies/{taxonomies}.
Request body
The request body contains data with the following structure:
JSON representation
{"permissions": [string]}
Fields
permissions[]
string
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.
[[["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-02-25 UTC."],[[["This API endpoint uses a POST request to test permissions on a specified policy tag or taxonomy within Google Cloud Data Catalog."],["The request URL requires a `resource` path parameter, representing the specific taxonomy for which you want to check permissions in the format `projects/{project}/locations/{location}/taxonomies/{taxonomies}`."],["The request body must contain a JSON object specifying the `permissions` array, which lists the exact permissions to check against the resource, without wildcards."],["A successful response will contain a `TestIamPermissionsResponse` object, indicating the outcome of the permission check."],["The API call requires the `https://www.googleapis.com/auth/cloud-platform` OAuth scope for authorization."]]],[]]
