Rule Sets API
TrueSight Network Automation REST API – Version 3.0 – RuleSetService
The base URL for the API is:
https://serverName:portNumber/bca-networks/api
GET /v3.0/rule_sets
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
query | Filter for rule sets matching this name, asterisk wildcards allowed |
| ||
filter.enabled | query | Filter for enabled or disabled rule sets; when true, returns only enabled rule sets; when false, returns only disabled rule sets; when this filter is absent, no filtering is done |
| |
orderBy | query | Sort by the specified attribute ('name' or a listable rule set dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending) | "+name" |
|
offset | query | Return the specified page number | 1 |
|
limit | query | Define the number of rows in a page or the maximum number of rule set to return | 25 |
|
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation |
|
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to access rule sets | |
500 | Internal server error: Unexpected exception occurred |
POST /v3.0/rule_sets
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
body | body | Complete attributes of the new rule set | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
201 | Created: New rule set successfully added | |
400 | Bad request: Input rule set DTO is missing or new rule set is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to add a new rule set | |
500 | Internal server error: Unexpected exception occurred |
GET /v3.0/rule_sets/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the rule set of interest |
| |
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to access rule sets | |
404 | Not found: No single matching accessible rule set found | |
500 | Internal server error: Unexpected exception occurred |
PUT /v3.0/rule_sets/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or Database key of the rule set to be modified |
| |
body | body | Complete new attribute values for the rule set; anything left out will be considered to be null and will be nulled out in the rule set; any required dynamic fields missing or null in the input will revert to default values | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
400 | Bad request: Input rule set DTO is missing or modified rule set is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to modify the rule set | |
404 | Not found: No single matching accessible rule set found | |
500 | Internal server error: Unexpected exception occurred |
DELETE /v3.0/rule_sets/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the rule set to be deleted |
| |
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation |
|
400 | Bad request: Rule set is currently in use | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to delete the rule set | |
404 | Not found: No single matching accessible rule set found | |
500 | Internal server error: Unexpected exception occurred |
PATCH /v3.0/rule_sets/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the rule set to be modified |
| |
body | body | New attribute values for the rule set, in JSON Patch format | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
400 | Bad request: Input JSON patch information is missing or modified rule set is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
403 | Forbidden: Not allowed to modify the rule set | |
404 | Not found: No single matching accessible rule set found | |
500 | Internal server error: Unexpected exception occurred |
Object Definitions
Object | Schema |
---|---|
ComponentId | Identifies a component in a form that can be input to either the same TrueSight Network Automation server that emitted it or to a different TrueSight Network Automation server; the name, qualifiers, and type uniquely identify a component; and they verify that anything successfully retrieved by a database key is the right component
|
DynamicFieldValueDTO | A dynamic field value
|
JsonPatch | A list of JSON Patch operations
|
JsonPatch.OneOperation | One JSON Patch operation |
JsonPatch.Pointer | Pointer or path to an element or property
|
JsonPatch.Add | Add a value to an object or inserts it into an array. In the case of an array, the value is inserted before the given index. The - character can be used instead of an index to insert at the end of an array. The value can be any JSON value.
|
JsonPatch.Remove | Remove a value from an object or array.
|
JsonPatch.Replace | Replace an existing value. THe value can be any JSON value.
|
JsonPatch.Move | Move a value from one location to the other. "path" is the destination.
|
JsonPatch.Copy | Copy a value from one location to another. "path" is the destination.
|
JsonPatch.Test | Test that the specified value is set in the document at the specified path. If the test fails, then the patch as a whole is not applied. The Value can be any JSON value.
|
RuleSetDTO | Details about a rule set
|
Comments
Log in or register to comment.