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 |
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:
JSON representation |
---|
{
"options": {
object ( |
Fields | |
---|---|
options |
OPTIONAL: A |
Response body
If successful, the response body contains an instance of Policy
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.