/policies
This resource is available only to principals with these entitlements: com.unboundid.broker.models.security.access.BrokerRole.READ_POLICY com.unboundid.broker.models.security.access.BrokerRole.BROKER_ADMIN
Mount Point: /auth/api/v1/policies/
GET
This operation is available only to principals with these entitlements: com.unboundid.broker.models.security.access.BrokerRole.READ_POLICY com.unboundid.broker.models.security.access.BrokerRole.BROKER_ADMIN
Retrieve a list of policies from the entire set of defined policies.
Parameters
| name | description | type | default |
|---|---|---|---|
| includeXml | Indicates whether the XACML for each policy should be included in the results. Specify true to include XACML for policies or false otherwise. | query | false |
| startIndex | The index number of the first item to be provided in the results. A null value is equivalent to 0. | query | 0 |
| count | The maximum number of items to be provided in the results. A null value signifies no maximum. | query | |
| sortBy | Specifies how the results should be sorted. Allowed values are NAME_ASCENDING, NAME_DESCENDING, POLICY_ID_ASCENDING, POLICY_ID_DESCENDING, POLICY_ENABLED, and POLICY_DISABLED. | query | NAME_ASCENDING |
| filterBy | Specifies how filtering will occur. Allowed values are NAME_EQUALITY, NAME, DESCRIPTION, ID, VERSION. | query | |
| filter | user-supplied input used for filtering. | query | |
| excludesList | comma-separated list of ids to exclude from results. | query |
Response Body
| result: | persistedPolicy |
| media types: | application/json |
Paged results of all requested policies.
Status Codes
| code | description |
|---|---|
| 200 | Success |
POST
This operation is available only to principals with these entitlements: com.unboundid.broker.models.security.access.BrokerRole.CREATE_POLICY com.unboundid.broker.models.security.access.BrokerRole.BROKER_ADMIN
Imports the given policy. If a policy already exists with the same policy Id, the policy is updated, otherwise a new policy is created.
Parameters
| name | description | type | default |
|---|---|---|---|
| name | The friendly name for the policy, or null if the policy ID should be used as the friendly name. | query | |
| enabled | whether the policy should be enabled, default is disabled | query | false |
Request Body
| element: | Policy |
| media types: | text/xml |
XML content of policy of type com.unboundid.broker.models.policy.XACMLPolicy.
Response Body
| result: | persistedPolicy |
| media types: | application/json |
The policy, as persisted.
Status Codes
| code | description |
|---|---|
| 201 | Success |
| 400 | Bad Request |