Device Agents API
TrueSight Network Automation REST API – Version 3.0 – Device Agents
The base URL for the API is:
https://serverName:portNumber/bca-networks/api
GET /v3.0/device_agents
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
orderBy | query | Sort by the specified attribute (name, address, enabledFlag, state, or a listable device agent 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 device agents 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 device agents | |
500 | Internal server error: Unexpected exception occurred |
POST /v3.0/device_agents
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
body | body | Complete attributes of the new device agent | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
201 | Created: New device agent successfully added | |
400 | Bad request: Input device agent DTO is missing or new device agent 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 device agent | |
500 | Internal server error: Unexpected exception occurred |
GET /v3.0/device_agents/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the device agent 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 device agents | |
404 | Not found: No single matching device agent found | |
500 | Internal server error: Unexpected exception occurred |
PUT /v3.0/device_agents/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the device agent to be modified |
| |
body | body | Complete new attribute values for the device agent; anything left out will be considered to be null and will be nulled out in the device agent | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
400 | Bad request: Input device agent DTO is missing or modified device agent 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 device agent | |
404 | Not found: No single matching device agent found | |
500 | Internal server error: Unexpected exception occurred |
DELETE /v3.0/device_agents/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the device agent to be deleted |
| |
Authorization | header | Authorization token formatted as 'Bearer [token]' |
|
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation |
|
400 | Bad request: device agent 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 device agent | |
404 | Not found: No single matching device agent found | |
500 | Internal server error: Unexpected exception occurred |
PATCH /v3.0/device_agents/{nameOrKey
}
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the device agent to be modified |
| |
body | body | New attribute values for the device agent, 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 device agent 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 device agent | |
404 | Not found: No single matching device agent found | |
500 | Internal server error: Unexpected exception occurred |
Object Definitions
Object | Schema |
---|---|
DeviceAgentDTO | Information about a device agent
|
DeviceAgentNICDTO | Information about a device-facing NIC within a device agent
|
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.
|
Comments
Log in or register to comment.