- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Examples
- Try it!
Retrieves the policies of the specified kind that are attached to a resource.
The response lists only policy metadata. In particular, policy rules are omitted.
HTTP request
GET https://iam.googleapis.com/v2beta/{parent=policies/*/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The resource that the policy is attached to, along with the kind of policy to list. Format: The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, For organizations and folders, use the numeric ID in the full resource name. For projects, you can use the alphanumeric or the numeric ID. |
Query parameters
Parameters | |
---|---|
pageSize |
The maximum number of policies to return. IAM ignores this value and uses the value 1000. |
pageToken |
A page token received in a |
Request body
The request body must be empty.
Response body
Response message for policies.listPolicies
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"policies": [
{
object ( |
Fields | |
---|---|
policies[] |
Metadata for the policies that are attached to the resource. |
nextPageToken |
A page token that you can use in a |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/iam
For more information, see the Authentication Overview.