orb-policies (1.0.0)

Download OpenAPI specification:Download

policy

List Agent Policies

query Parameters
limit
integer [ 1 .. 100 ]
Default: 10

Size of the subset to retrieve.

offset
integer >= 0
Default: 0

Number of items to skip during retrieval.

name
string

Name filter. Filtering is performed as a case-insensitive partial match.

order
string
Default: "id"
Enum: "name" "id"

Order type.

dir
string
Default: "desc"
Enum: "asc" "desc"

Order direction.

tags
string
Default: "{\"key\":\"value\"}"

Tags filter. Filtering is performed as a case-insensitive partial key value match.

header Parameters
Authorization
required
string <jwt>

User's access token.

Responses

Response samples

Content type
application/json
{
  • "policy": [
    ],
  • "total": 0,
  • "offset": 0,
  • "limit": 0
}

Create new Agent Policy

header Parameters
Authorization
required
string <jwt>

User's access token.

Request Body schema: application/json

JSON-formatted document describing the new Policy configuration

One of
name
required
string

A unique name label

description
required
string

User description of this Policy

tags
required
object

User defined key/values for organization and searching

backend
required
string

Agent backend this policy is for. Cannot change once created.

policy
required
object

Agent backend specific policy data in json format

Responses

Request samples

Content type
application/json
Example
{
  • "name": "my-policy",
  • "description": "A policy example",
  • "tags": {
    },
  • "backend": "pktvisor",
  • "policy": {
    }
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "my-policy",
  • "description": "An example policy",
  • "tags": {
    },
  • "backend": "pktvisor",
  • "ts_created": "2019-08-24T14:15:22Z",
  • "version": 0,
  • "policy": {
    }
}

Get an existing Agent Policy

path Parameters
id
required
string <uuid>

Unique Agent Policy identifier.

header Parameters
Authorization
required
string <jwt>

User's access token.

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "my-policy",
  • "description": "An example policy",
  • "tags": {
    },
  • "backend": "pktvisor",
  • "ts_created": "2019-08-24T14:15:22Z",
  • "version": 0,
  • "policy": {
    }
}

Update an existing Agent Policy

path Parameters
id
required
string <uuid>

Unique Agent Policy identifier.

header Parameters
Authorization
required
string <jwt>

User's access token.

Request Body schema: application/json

JSON-formatted document describing the updated Policy configuration

One of
name
string

A unique name label

description
string

User description of this Policy

tags
object

User defined key/values for organization and searching

policy
object

Agent backend specific policy data in json format

Responses

Request samples

Content type
application/json
Example
{
  • "name": "my-policy",
  • "description": "A policy example",
  • "tags": {
    },
  • "policy": {
    }
}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "my-policy",
  • "description": "An example policy",
  • "tags": {
    },
  • "backend": "pktvisor",
  • "ts_created": "2019-08-24T14:15:22Z",
  • "version": 0,
  • "policy": {
    }
}

Delete an existing Agent Policy

path Parameters
id
required
string <uuid>

Unique Agent Policy identifier.

header Parameters
Authorization
required
string <jwt>

User's access token.

Responses

Response samples

Content type
application/json
"string"

Validate an Agent Policy configuration without saving it

header Parameters
Authorization
required
string <jwt>

User's access token.

Request Body schema: application/json

JSON-formatted document describing the new Policy configuration

One of
name
required
string

A unique name label

description
required
string

User description of this Policy

tags
required
object

User defined key/values for organization and searching

backend