List all access policies

GET 
/iam/v1/access_policies

List all access policies. If role or principal is specified, this returns all access policies using the specified role or or that is assigned to the identified principal.

Request

Query Parameters

role string

The role that you want to use for this list operation.

principal string

The email address of the principal that you want to use for this list operation.

Responses

200

Successful response.

application/json

Schema

Schema

count integerrequired

Default value: 1

Total count of the items

items object[]required
Array [
id string
Access policy unique identifier.
inherited_from string
The lowest level TSG to which the access policy belongs.
principal string
The email address of the user or service account that is granted this access policy.
principal_display_name string
firstname lastname OR firstname OR username.
principal_type string
Whether the principal is a user or a service account.
resource string
The resource to which this access policy is assigned. It is in the format:
prn:<TSG_ID>::::
role string
The role used for this access policy.
]

Example (from schema)

{
  "count": 1,
  "items": [
    {
      "id": "9d5104a0-1b0e-4f1d-be40-87f7810327e9",
      "inherited_from": "1234567890",
      "principal": "user@paloaltonetworks.com",
      "principal_display_name": "firstname lastname",
      "principal_type": "user",
      "resource": "prn:123::::",
      "role": "superuser"
    }
  ]
}

Loading...