Policies
Policy management operations
Lists policies
Authentication token obtained from the authentication service
Filter by policy type
Requests a page size of items
The ID of the last-seen item for pagination
A valid authentication token
Policies listed successfully
Some content in the request was invalid
User must authenticate before making a request
Policy does not allow current user to do this operation
GET /v3/policies HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*
{
"policies": [
{
"id": "text",
"type": "text",
"blob": {},
"links": {
"self": "text",
"previous": "text",
"next": "text"
}
}
],
"links": {
"self": "text",
"previous": "text",
"next": "text"
}
}Creates a policy
Authentication token obtained from the authentication service
A valid authentication token
Policy created successfully
Some content in the request was invalid
User must authenticate before making a request
Policy does not allow current user to do this operation
This operation conflicted with another operation on this resource
POST /v3/policies HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"policy": {
"type": "text",
"blob": {}
}
}{
"policy": {
"id": "text",
"type": "text",
"blob": {},
"links": {
"self": "text",
"previous": "text",
"next": "text"
}
}
}Shows details for a policy
Authentication token obtained from the authentication service
The policy ID
A valid authentication token
Policy details retrieved successfully
Some content in the request was invalid
User must authenticate before making a request
Policy does not allow current user to do this operation
The requested resource could not be found
GET /v3/policies/{policy_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*
{
"policy": {
"id": "text",
"type": "text",
"blob": {},
"links": {
"self": "text",
"previous": "text",
"next": "text"
}
}
}Deletes a policy
Authentication token obtained from the authentication service
The policy ID
A valid authentication token
Policy deleted successfully
Some content in the request was invalid
User must authenticate before making a request
Policy does not allow current user to do this operation
The requested resource could not be found
DELETE /v3/policies/{policy_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Accept: */*
No content
Updates a policy
Authentication token obtained from the authentication service
The policy ID
A valid authentication token
Policy updated successfully
Some content in the request was invalid
User must authenticate before making a request
Policy does not allow current user to do this operation
The requested resource could not be found
This operation conflicted with another operation on this resource
PATCH /v3/policies/{policy_id} HTTP/1.1
Host: identity.example.com
X-Auth-Token: text
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"policy": {
"type": "text",
"blob": {}
}
}{
"policy": {
"id": "text",
"type": "text",
"blob": {},
"links": {
"self": "text",
"previous": "text",
"next": "text"
}
}
}Last updated
Was this helpful?