v4.0 Remote File Servers API
TrueSight Network Automation REST API – RemoteFileServerService
The base URL for the API is:
remote_file_servers
{{status subtle="false" colour="Blue" title="GET"/}}
/v4.0/remote_file_servers
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
query | Filter for remote file servers matching this name, asterisk wildcards allowed | string | ||
orderBy | query | Sort by the specified attribute (name, address, ftpTransferUsername, scpTransferUsername, or a listable dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending) | "+name" | string |
offset | query | Return the specified page number | 1 | integer |
limit | query | Define the number of rows in a page or the maximum number of remote file servers to return | 25 | integer |
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 accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to access remote file servers | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Green" title="POST"/}}
/v4.0/remote_file_servers
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
body | body | Complete attributes of the new remote file server | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' | string * |
Responses
Code | Description | Schema |
|---|---|---|
201 | Created: New remote file server successfully added | |
400 | Bad request: Input remote file server DTO is missing or new remote file server is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to add a new remote file server | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Yellow" title="PUT"/}}
/v4.0/remote_file_servers/multiple_remote_file_server_updates
Click here to expand...
Description
Modifies the specified static and dynamic fields in the selected remote file servers; the response reports which remote file servers are successfully updated and which are not updated due to some validation error; note there are no partial updates; any one remote file server either has all the changes applied to it or none of them
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
body | body | What changes to make and to which remote file servers | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' | string * |
Responses
Code | Description | Schema |
|---|---|---|
200 | successful operation | |
400 | Bad request: Input DTO is missing or invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to modify remote file servers | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Blue" title="GET"/}}
/v4.0/remote_file_servers/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
nameOrKey | path | Name or database key of the remote file server 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 accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to access remote file servers | |
404 | Not found: No single matching remote file server found | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Yellow" title="PUT"/}}
/v4.0/remote_file_servers/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
nameOrKey | path | Name or database key of the remote file server to be modified | string * | |
body | body | Complete new attribute values for the remote file server; anything left out will be considered to be null and will be nulled out in the remote file server | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' | string * |
Responses
Code | Description | Schema |
|---|---|---|
200 | successful operation | |
400 | Bad request: Input remote file server DTO is missing or modified remote file server is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to modify the remote file server | |
404 | Not found: No single matching remote file server found | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Red" title="DELETE"/}}
/v4.0/remote_file_servers/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
nameOrKey | path | Name or database key of the remote file server to be deleted | string * | |
Authorization | header | Authorization token formatted as 'Bearer [token]' | string * |
Responses
Code | Description | Schema |
|---|---|---|
200 | OK: Remote file servers update request was processed | string |
400 | Bad request: Remote file server is currently in use by a device or device import task | |
401 | Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to delete the remote file server | |
404 | Not found: No single matching remote file server found | |
500 | Internal server error: Unexpected exception occurred |
{{status subtle="false" colour="Yellow" title="PATCH"/}}
/v4.0/remote_file_servers/{nameOrKey}
Click here to expand...
Parameters
Name | Located in | Description | Default | Schema |
|---|---|---|---|---|
nameOrKey | path | Name or database key of the remote file server to be modified | string * | |
body | body | New attribute values for the remote file server, in JSON Patch format | ||
Authorization | header | Authorization token formatted as 'Bearer [token]' | string * |
Responses
Code | Description | Schema |
|---|---|---|
200 | successful operation | |
400 | Bad request: Input JSON patch information is missing or modified remote file server is invalid | |
401 | Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in | |
403 | Forbidden: Not allowed to modify the remote file server | |
404 | Not found: No single matching remote file server found | |
500 | Internal server error: Unexpected exception occurred |
Object Definitions
Object | Schema |
|---|---|
ComponentId | Click here to expand...{ |
DynamicFieldEditDTO | Click here to expand...{ |
DynamicFieldValueDTO | Click here to expand...{ |
JsonPatch | Click here to expand...[ |
JsonPatch.OneOperation | Click here to expand... |
JsonPatch.Pointer | Click here to expand...string |
JsonPatch.Add | Click here to expand...{ |
JsonPatch.Remove | Click here to expand...{ |
JsonPatch.Replace | Click here to expand...{ |
JsonPatch.Move | Click here to expand...{ |
JsonPatch.Copy | Click here to expand...{ |
JsonPatch.Test | Click here to expand...{ |
RemoteFileServerDTO | Click here to expand...{ |
RemoteFileServerMultiEditDTO | Click here to expand...{ |
RemoteFileServerMultiEditResultDTO | Click here to expand...{ |
StaticFieldEditDTO | Click here to expand...{ |