Gets the access control policy for a folder. The returned policy may be empty if no such policy or resource exists. The resource
field should be the folder's resource name, for example: "folders/1234". The caller must have resourcemanager.folders.getIamPolicy
permission on the identified folder.
HTTP request
POST https://cloudresourcemanager.googleapis.com/v3/{resource=folders/*}:getIamPolicy
The URL uses gRPC Transcoding syntax.
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 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/cloudplatformfolders -
https://www.googleapis.com/auth/cloudplatformfolders.readonly
For more information, see the Authentication Overview .
