Method: projects.getIamPolicy

HTTP request
Path parameters
Request body
- JSON representation
Response body
Authorization scopes
Try it!

Returns the IAM access control policy for the specified project, in the format projects/{ProjectIdOrNumber} e.g. projects/123. Permission is denied if the policy or the resource do not exist.

HTTP request

POST https://cloudresourcemanager.googleapis.com/v3/{resource=projects/*}:getIamPolicy

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`resource`	`string` REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.

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:

JSON representation
{ "options" : { object ( `GetPolicyOptions` ) } }

Fields

Fields
`options`	`object ( GetPolicyOptions )` OPTIONAL: A `GetPolicyOptions` object for specifying options to `projects.getIamPolicy` .

options

object ( GetPolicyOptions )

OPTIONAL: A GetPolicyOptions object for specifying options to projects.getIamPolicy .

Response body

If successful, the response body contains an instance of Policy .

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
https://www.googleapis.com/auth/cloudplatformprojects
https://www.googleapis.com/auth/cloudplatformprojects.readonly

For more information, see the Authentication Overview .