Supporting Components API
TrueSight Network Automation REST API – Listing Service
The base URL for the API is:
GET
/v3.0/device_adapters =====
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
filter.type | query | Filter for device adapters matching this type | string | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
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 adapters | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/device_adapters/{nameOrKeyOrGuid}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKeyOrGuid | path | Name or database key or GUID of the one device adapter of interest | string* | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
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 adapters | |
404 | Not found: No single matching device adapter found | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/models
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | [ |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/models/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the model of interest | string* | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
404 | Not found: No single matching model found | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/os_images
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
query | Filter for OS images matching this name, asterisk wildcards allowed | string | ||
filter.filename | query | Filter for OS images matching this filename, asterisk wildcards allowed | string | |
filter.onlyDeployable | query | Filter for OS images that can be deployed; when true, returns only OS images whose 'Forbid Deployment of This Image' setting is unchecked; when false or when this filter is absent, no filtering is done | boolean | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
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 the OS image library | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/os_images/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
nameOrKey | path | Name or database key of the OS image of interest | string* | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
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 the OS image library | |
404 | Not found: No single matching OS image found | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/time_period_types
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
500 | Internal server error: Unexpected exception occurred |
{{status colour="Blue" title="GET"/}}
/v3.0/time_period_types/{idOrUrlKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
---|---|---|---|---|
idOrUrlKey | path | ID or urlKey of the time period type of interest | string* | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string* |
Responses
Code | Description | Schema |
---|---|---|
200 | successful operation | |
401 | Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in | |
404 | Not found: No single matching time period type found | |
500 | Internal server error: Unexpected exception occurred |
Object Definitions
Object | Schema |
---|---|
DeviceAdapterDTO | Click here to expand...{ |
DynamicFieldValueDTO | Click here to expand...{ |
ModelDTO | Click here to expand...{ |
OsFileDTO | Click here to expand...{ |
OsImageDTO | Click here to expand...{ |
TimePeriodTypeDTO | Click here to expand...{ |