Endpoints in the REST API v1.0 (deprecated)

BMC Network Automation REST API – Version 1.0

Warning

REST API v2.0 is deprecated as of product versions 8.9.02 and 8.9.03.

The base URL for the API is:

https://serverName:portNumber/bca-networks/api

combo_groups

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups

Click here to expand...

Description

Retrieves combo groups, matching any filter criteria; may filter by filterable combo group dynamic fields by including query parameters in the form 'filter.dynamicFieldName=value'

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for combo groups matching this name, asterisk wildcards allowed		string
filter.realm	query	Filter for combo groups that belong to this realm		string
orderBy	query	Sort by the specified attribute (name, realm, or a listable combo group dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending)	"+name"	string Enum: [ "+name", "-name", "+realm", "-realm" ]
offset	query	Return the specified page number	1	integer
limit	query	Define the number of rows in a page or the maximum number of combo groups to return	25	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ ComboGroupDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access combo groups
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/combo_groups

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
body	body	Complete attributes of the new combo group		ComboGroupDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
201	Created: New combo group successfully added
400	Bad request: Input combo group DTO is missing or new combo group 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 combo group
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/combo_groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the combo group to be modified	string*
body	body	Complete new attribute values for the combo group; anything left out will be considered to be null and will be nulled out in the combo group; any required dynamic fields missing or null in the input will revert to default values; to change the realm a combo group belongs to, must first remove all groups from the combo group or specify new groups in the new realm	ComboGroupDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	ComboGroupDTO
400	Bad request: Input combo group DTO is missing or modified combo group 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 combo group
404	Not found: No single matching accessible combo group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/combo_groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
id	path	Database key of the combo group to be deleted		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: combo group 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 combo group
404	Not found: No single matching accessible combo group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/combo_groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the combo group to be modified	string*
body	body	New attribute values for the combo group, in JSON Patch format	JsonPatch
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	ComboGroupDTO
400	Bad request: Input JSON patch information is missing or modified combo group 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 combo group
404	Not found: No single matching accessible combo group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups/{id}/devices

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
id	path	Database key of the combo group of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedDeviceDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access combo groups
404	Not found: No single matching accessible combo group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the combo group of interest; a name must be unique across all realms for a combo group to be returned		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	ComboGroupDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access combo group
404	Not found: No single matching accessible combo group found
500	Internal server error: Unexpected exception occurred

devices

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices

Click here to expand...

Description

Retrieves devices, matching any filter criteria, with the returned result being abbreviated or partially-detailed devices. May filter by filterable device dynamic fields by including query parameters in the form 'filter.dynamicFieldName=value'

Parameters

Name	Located in	Description	Default	Schema
orderBy	query	Sort by the specified attribute (name, realm, address, model, osImage, or a listable device dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending)	"+name"	string Enum: [ "+name", "-name", "+realm", "-realm", "+address", "-address", "+model", "-model", "+osImage", "-osImage" ]
limit	query	Define the number of rows in a page or the maximum number of devices to return	25	integer
offset	query	Return the specified page number	1	integer
filter.name	query	Filter for devices matching this name, asterisk wildcards allowed		string
filter.realm	query	Filter for devices that belong to this realm		string
filter.address	query	Filter for devices matching this address, asterisk wildcards allowed		string
filter.vendor	query	Filter for devices from this vendor, by GUID		string
filter.deviceType	query	Filter for devices of this device type, by GUID		string
filter.model	query	Filter for devices matching this model, asterisk wildcards allowed		string
filter.osImage	query	Filter for devices matching this operating system name, asterisk wildcards allowed		string
filter.online	query	Filter for devices that are online or offline		boolean
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedDeviceDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/devices

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
body	body	Complete attributes of the new device		DeviceDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
201	Created: New device successfully added
400	Bad request: Input device DTO is missing or new device 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
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the device of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	DeviceDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/devices/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
body	body	Complete new attribute values for the device; anything left out will be considered to be null and will be nulled out in the device; any required dynamic fields missing or null in the input will revert to default values	DeviceDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	DeviceDTO
400	Bad request: Input device DTO is missing or modified device 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
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/devices/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the device of interest		string*
clearReferences	query	When true, will attempt to clear references to the device that would normally prevent it from being deleted. Not every reference can be cleared, so this call can still fail.	false	boolean
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: device 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
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/devices/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
body	body	New attribute values for the device, in JSON Patch format	JsonPatch
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	DeviceDTO
400	Bad request: Input JSON patch information is missing or modified device 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
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
cfgKey	path	Database key of the configuration of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	ConfigurationDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device or configuration found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}/binaryData

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
cfgKey	path	Database key of the configuration of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	OK: Request completed successfully
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device or configuration found, or the configuration has no binary data
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}/data

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
cfgKey	path	Database key of the configuration of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	string
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device or configuration found, or the configuration has no ASCII data
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{trailGuid}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
trailGuid	path	The GUID of the configuration trail of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	[ ConfigurationDTO ]
400	Bad request: Input trail GUID is invalid
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/current_configurations

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the device of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ ConfigurationDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/status

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the device of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	DeviceStatusDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/status/{actionGuid}/transcript

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the device of interest	string*
actionGuid	path	The GUID of the device action of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Input action GUID is invalid
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices or transcripts
404	Not found: No single matching accessible device found, or device has no transcript for the specified action
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/trusted_configurations

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the device of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ ConfigurationDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access devices
404	Not found: No single matching accessible device found
500	Internal server error: Unexpected exception occurred

groups

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups

Click here to expand...

Description

Retrieves groups, matching any filter criteria; may filter by filterable group dynamic fields by including query parameters in the form 'filter.dynamicFieldName=value'

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for groups matching this name, asterisk wildcards allowed		string
filter.realm	query	Filter for groups that belong to this realm		string
filter.autoGroup	query	Filter for auto-groups or non-auto-groups; when true, returns only auto-groups (including empty ones); when false, returns only non-auto-groups; when this filter is absent, no filtering is done		boolean Enum: [ "true", "false" ]
orderBy	query	Sort by the specified attribute (name, realm, or a listable group dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending)	"+name"	string Enum: [ "+name", "-name", "+realm", "-realm" ]
offset	query	Return the specified page number	1	integer
limit	query	Define the number of rows in a page or the maximum number of groups to return	25	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ GroupDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access groups
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/groups

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
body	body	Complete attributes of the new group		GroupDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
201	Created: New group successfully added
400	Bad request: Input group DTO is missing or new group 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 group
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the group to be modified	string*
body	body	Complete new attribute values for the group; anything left out will be considered to be null and will be nulled out in the group; any required dynamic fields missing or null in the input will revert to default values; to change the realm a group belongs to, must first remove all devices from the group	GroupDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	GroupDTO
400	Bad request: Input group DTO is missing, modified group is invalid, or attempted to make an illegal type of change (such as renaming an auto-group); see error message for details
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to modify the group
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
id	path	Database key of the group to be deleted		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: group is currently in use or is a non-empty auto-group
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to delete the group
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/groups/{id}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the group to be modified	string*
body	body	New attribute values for the group, in JSON Patch format	JsonPatch
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	GroupDTO
400	Bad request: Input JSON patch information is missing, Modified group is invalid, or attempted to make an illegal type of change (such as renaming an auto-group); see error message for details
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to modify the group
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups/{id}/devices

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
id	path	Database key of the group of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedDeviceDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access groups
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/groups/{id}/devices/{deviceId}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the group of interest	string*
deviceId	path	Database key of the device to be added to the group	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Device database key is not valid, device is not in the same realm as the group, or attempted to add a device to an auto-group
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to modify the group
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/groups/{id}/devices/{deviceId}

Click here to expand...

Parameters

Name	Located in	Description	Schema
id	path	Database key of the group of interest	string*
deviceId	path	Database key of the device to be removed from the group	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Device database key is not valid, device is not a member of the group, or attempted to remove a device from an auto-group
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to modify the group
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the group of interest; a name must be unique across all realms for a group to be returned		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	GroupDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access groups
404	Not found: No single matching accessible group found
500	Internal server error: Unexpected exception occurred

jobs

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs

Click here to expand...

Description

Retrieves jobs, matching any filter criteria, with the returned result being abbreviated or partially-detailed jobs. May filter by filterable job dynamic fields by including query parameters in the form 'filter.dynamicFieldName=value'

Parameters

Name	Located in	Description	Default	Schema
filter.jobID	query	Filter for jobs matching this job ID, asterisk wildcards allowed		string
filter.changeID	query	Filter for jobs matching this change ID, asterisk wildcards allowed		string
filter.taskID	query	Filter for jobs matching this task ID, asterisk wildcards allowed		string
filter.action	query	Filter for jobs containing this type of action, by action GUID		string
filter.status	query	Filter for jobs currently in this numeric state		integer
filter.originator	query	Filter for jobs matching this originator name, asterisk wildcards allowed		string
orderBy	query	Sort by the specified attribute (jobID, changeID, taskID, status, originator, or a listable job dynamic field name) in the specified order (prefix with a '+' for ascending or a '-' for descending); note that status is a numeric sort on the current job state (not on the display names for the states)	"+jobID"	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 jobs to return	25	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedJobDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
body	body	Complete attributes of the new job		JobDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
201	Created: New job successfully added
400	Bad request: Input job DTO is missing or new job 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 job
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
jobIdOrKey	path	Job ID or database key of the job of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	JobDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/jobs/{jobIdOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the draft job to be modified	string*
body	body	Complete new attribute values for the job; anything left out will be considered to be null and will be nulled out in the job; any required dynamic fields missing or null in the input will revert to default values	JobDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	JobDTO
400	Bad request: Input job DTO is missing, job is not in the draft state, or modified job 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 job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/jobs/{jobIdOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
jobIdOrKey	path	Job ID or database key of the draft job to be deleted		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Job is not in the draft state
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to delete the job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/jobs/{jobIdOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the draft job to be modified	string*
body	body	New attribute values for the job, in JSON Patch format	JsonPatch
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	JobDTO
400	Bad request: Input JSON patch information is missing, job is not in the draft state, or modified job 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 job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/action_results/{actionNumber}

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job of interest	string*
actionNumber	path	The number of the action of interest within the job, where action numbers start at one	integer*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	ActionResultDTO
400	Bad request: Job is not in a completed state
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs
404	Not found: No single matching accessible job found, or specified action not found in the job
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/approval

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job to be approved	string*
reason	query	The reason or explanation or annotation for this approval	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'; this identifies the user making the approval	String*

Responses

Code	Description	Schema
200	OK: Job approved successfully
400	Bad request: Job is not in the wait for approval state, or the required 'reason' query parameter is missing, or the logged-in user is not a pending approver
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to approve the job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/cancellation

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job to be cancelled/aborted	string*
reason	query	The reason or explanation or annotation for this cancellation	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	OK: Job cancelled successfully, or abort requested successfully
400	Bad request: Job is not a in state where it can be cancelled or aborted, or the required 'reason' query parameter is missing
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to cancel/abort the job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/desubmission

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
jobIdOrKey	path	Job ID or database key of the scheduled job to be de-submitted		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	OK: Job de-submitted successfully
400	Bad request: Job is not in a scheduled or wait for approval state, or an external approval has already been obtained
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to de-submit the job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
jobIdOrKey	path	Job ID or database key of the job of interest		string*
filter.actionNumber	query	Filter for results from this one action within the job; action numbers start with 1		integer
filter.subactionNumber	query	Filter for results from this one sub-action within the action specified by the filter.actionNumber parameter; sub-action numbers start with 1; this is ignored if you fail to specify filter.actionNumber		integer
filter.status	query	Filter for results with this numeric completion status		integer
filter.errorMessage	query	Filter for results that failed with this error message, asterisk wildcards allowed		string
orderBy	query	Sort by the specified attribute (actionNumber, deviceName, status, startTime, endTime, or errorMessage) in the specified order (prefix with a '+' for ascending or a '-' for descending); note that status is a numeric sort on the device action's completion status	"+actionNumber"	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 results to return	25	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedDeviceResultDTO ]
400	Bad request: Job is not in a completed state, or filter.errorMessage is invalid
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results/{resultKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job of interest	string*
resultKey	path	Database key of the device result of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	DeviceResultDTO
400	Bad request: Job is not in a completed state
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs
404	Not found: No single matching accessible job found, or device result not found in the job
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results/{resultKey}/transcript

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job of interest	string*
resultKey	path	Database key of the device result whose transcript is of interest	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Job is not in a completed state
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access jobs or transcripts
404	Not found: No single matching accessible job found, device result not found in the job, or device result has no transcript
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/rejection

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the job to be rejected	string*
reason	query	The reason or explanation or annotation for this rejection	string*
Authorization	header	Authorization token formatted as 'Bearer [token]'; this identifies the user making the rejection	String*

Responses

Code	Description	Schema
200	OK: Job successfully rejected
400	Bad request: Job is not in the wait for approval state, or the required 'reason' query parameter is missing, or the logged-in user is not a pending approver
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to reject the job
404	Not found: No single matching accessible job found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/submission

Click here to expand...

Parameters

Name	Located in	Description	Schema
jobIdOrKey	path	Job ID or database key of the draft job to be submitted	string*
jobApprovalTypeId	query	When the job requires approval, the database key of the job approval type that specifies who must approve the job prior to execution; ignored if the job does not require approval	string
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	OK: Job submitted successfully
400	Bad request: Job is not in the draft state, or query parameter 'jobApprovalTypeId' is missing for a job requiring approval
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to submit the job
404	Not found: No single matching accessible job or job approval type found
500	Internal server error: Unexpected exception occurred

realms

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/realms

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for realms matching this name, asterisk wildcards allowed		string
orderBy	query	Sort by the specified attribute ('name' or a listable realm 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 realms to return	25	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ RealmDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access realms
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/realms

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
body	body	Complete attributes of the new realm		RealmDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
201	Created: New realm successfully added
400	Bad request: Input realm DTO is missing or new realm 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 realm
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/realms/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the realm of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	RealmDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access realms
404	Not found: No single matching accessible realm found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/realms/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the realm to be modified	string*
body	body	Complete new attribute values for the realm; anything left out will be considered to be null and will be nulled out in the realm; any required fallback or hardware inventory purge criteria or dynamic fields missing or null in the input will revert to default values	RealmDTO
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	RealmDTO
400	Bad request: Input realm DTO is missing or modified realm 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 realm
404	Not found: No single matching accessible realm found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/realms/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the realm to be deleted		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	string
400	Bad request: Realm is currently in use, or it is the only realm and cannot be deleted
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to delete the realm
404	Not found: No single matching accessible realm found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/realms/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Schema
nameOrKey	path	Name or database key of the realm to be modified	string*
body	body	New attribute values for the realm, in JSON Patch format	JsonPatch
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	RealmDTO
400	Bad request: Input JSON patch information is missing or Modified realm 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 realm
404	Not found: No single matching accessible realm found
500	Internal server error: Unexpected exception occurred

rules

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/rules

Click here to expand...

Description

Retrieves rules, matching any filter criteria, with the returned result being abbreviated or partially-detailed rules. May filter by filterable rule dynamic fields by including query parameters in the form 'filter.dynamicFieldName=value'

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for rules matching this name, asterisk wildcards allowed		string
filter.ruleSetName	query	Filter for rules that belong to a rule set matching this rule set name, asterisk wildcards allowed		string
filter.correctable	query	Filter for correctable or non-correctable rules; when true, returns only correctable rules; when false, returns only non-correctable rules; when this filter is absent, no filtering is done		boolean
filter.onlyRulesWithCveIds	query	Filter for rules with associated CVE ID(s); when true, returns only rules that are associated with at least one CVE ID; when false or when this filter is absent, no filtering is done		boolean
limit	query	Define the number of rows in a page or the maximum number of rules to return	25	integer
offset	query	Return the specified page number	1	integer
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ AbbreviatedRuleDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access rules
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/rules/{fullNameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
fullNameOrKey	path	Rule-set-name-qualified full name or database key of the one rule of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	RuleDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access rules
404	Not found: No single matching accessible rule found
500	Internal server error: Unexpected exception occurred

supporting components

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.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 Enum: [ "configurationTrail", "customAction", "deviceType", "externalScriptAction", "vendor" ]
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ DeviceAdapterDTO ]
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 subtle="false" colour="Blue" title="GET"/}}

/v1.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	DeviceAdapterDTO
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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_agents

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	[ DeviceAgentDTO ]
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

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_agents/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one device agent of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	DeviceAgentDTO
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

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_security_profiles

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for device security profiles matching this name, asterisk wildcards allowed		string
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ DeviceSecurityProfileDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access device security profiles
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_security_profiles/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one device security profile of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	DeviceSecurityProfileDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access device security profiles
404	Not found: No single matching accessible device security profile found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/dynamic_fields

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
filter.component	query	Filter for dynamic fields associated with this component (realm, group, combogroup, device, or job)		string Enum: [ "realm", "group", "combogroup", "device", "job" ]
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ DynamicFieldDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access dynamic fields
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/dynamic_fields/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one dynamic field of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	DynamicFieldDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access dynamic field
404	Not found: No single matching dynamic field found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/email_distribution_lists

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	[ EmailDistributionListDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access email distribution lists
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/email_distribution_lists/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one email distribution list of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	EmailDistributionListDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access email distribution list
404	Not found: No single matching email distribution list found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_approval_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	[ JobApprovalTypeDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access job approval types
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_approval_types/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one job approval type of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	JobApprovalTypeDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access job approval type
404	Not found: No single matching accessible job approval type found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/os_images

Click here to expand...

Parameters

Name	Located in	Description	Schema
filter.name	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	[ OsImageDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access OS image library
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/os_images/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one OS image of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	OsImageDTO
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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/remote_file_servers

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for remote file servers matching this name, asterisk wildcards allowed		string
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ RemoteFileServerDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header 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="Blue" title="GET"/}}

/v1.0/remote_file_servers/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one remote file server of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	RemoteFileServerDTO
401	Unauthorized: Failed to provide a suitable Authorization header 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="Blue" title="GET"/}}

/v1.0/rule_sets

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
filter.name	query	Filter for rule sets matching this name, asterisk wildcards allowed		string
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	[ RuleSetDTO ]
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

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/rule_sets/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one rule set of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	RuleSetDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access rule set
404	Not found: No single matching accessible rule set found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/snmp_manager_stations

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	[ SnmpManagerStationDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access SNMP manager stations
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/snmp_manager_stations/{addressOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
addressOrKey	path	Address or database key of the one SNMP manager station of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	SnmpManagerStationDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to SNMP manager stations
404	Not found: No single matching SNMP manager station found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/templates

Click here to expand...

Parameters

Name	Located in	Description	Schema
filter.name	query	Filter for templates matching this name, asterisk wildcards allowed	string
filter.contents	query	Filter for templates containing this text, asterisk wildcards allowed	string
Authorization	header	Authorization token formatted as 'Bearer [token]'	String*

Responses

Code	Description	Schema
200	successful operation	[ TemplateDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access templates
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/templates/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one template of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	TemplateDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access templates
404	Not found: No single matching accessible template found
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/users

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	[ UserDTO ]
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access users
500	Internal server error: Unexpected exception occurred

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/users/{nameOrKey}

Click here to expand...

Parameters

Name	Located in	Description	Default	Schema
nameOrKey	path	Name or database key of the one user of interest		string*
Authorization	header	Authorization token formatted as 'Bearer [token]'		String*

Responses

Code	Description	Schema
200	successful operation	UserDTO
401	Unauthorized: Failed to provide a suitable Authorization header or the specified user is not logged in
403	Forbidden: Not allowed to access user
404	Not found: No single matching accessible user found
500	Internal server error: Unexpected exception occurred

value mappings

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_delete_current_image_options

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_image_sources

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_reboot_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_script_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_smart_merge_modes

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/action_statuses

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/boolean_expression_operators

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/canned_actions

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_access_modes

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_adapter_states

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_adapter_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_categories

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_security_context_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/device_transfer_modes

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/emailed_report_formats

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_approval_type_methods

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_originator_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_reconciliation_statuses

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_states

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/job_summary_link_report_by_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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/quarantine_isolation_levels

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/rule_severities

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 subtle="false" colour="Blue" title="GET"/}}

/v1.0/snmp_trap_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

Object Definitions

Object	Schema
AbbreviatedActionDTO	Click here to expand... { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action) guid: string The GUID that identifies the type of action name: string The type of action referred to by the GUID summary: string Brief summary of what this action does annotation: string Notes, comments, description, explanation networkSpanTypeName: string The type of network span (if any) that this action acts on networkSpanId: string The database key of the network span (if any) that this action acts on networkSpanName: string The network span (if any) that this action acts on realmId: string The database key of the realm that the network span belongs to realmName: string The realm that the network span belongs to deviceFilter: string Any device filter in a summarized format statusId: integer The current execution status of this action statusName: string The meaning of the numeric statusId startTimestamp: date-time When the action execution began Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed subactions: [ Any sub-actions generated at execution time, ordered by sub-action number AbbreviatedActionDTO ] }
AbbreviatedDeviceDTO	Click here to expand... { id: string The device's unique database key name: string The device's unique name deviceDetailsLink: string Link to get complete details about this device realmId: string The database key of the realm this device belongs to realmName: string The name of the realm this device belongs to modelName: string The discovered model osImageName: string The discovered operating system version deviceTypeGuid: string The GUID of the device type deviceTypeName: string The name of the device type vendorGuid: string The GUID of the vendor vendorName: string The name of the vendor categoryId: integer The category categoryName: string The meaning of the numeric categoryId onlineFlag: boolean Whether or not this device is online discrepanciesFlag: boolean Whether or not this device has discrepancies violationsFlag: boolean Whether or not this device has compliance violations primaryInterfaceAddress: string The primary interface IP address, host name, or URL primaryInterfaceDeviceAgentId: string The database key of the primary interface device agent primaryInterfaceDeviceAgentName: string The name of the primary interface device agent primaryInterfaceAccessModeId: integer The primary interface access mode primaryInterfaceAccessModeName: string The meaning of the numeric primaryInterfaceAccessModeId primaryInterfaceTransferModeId: integer The primary interface transfer mode primaryInterfaceTransferModeName: string The meaning of the numeric primaryInterfaceTransferModeId primaryInterfaceDeviceSecurityProfileId: string The database key of the primary interface device security profile primaryInterfaceDeviceSecurityProfileName: string The name of the primary interface device security profile dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
AbbreviatedDeviceResultDTO	Click here to expand... { id: string This device result's unique database key deviceResultDetailsLink: string Link to retrieve full details about the device deviceId: string The unique database key of the device where this action ran deviceName: string The name of the device where this action ran realmName: string The name of the realm the device belonged to at execution time actionNumber: integer Which action within the job's list of actions subactionNumber: integer Which sub-action within the action; when null, does not refer to a sub-action statusId: integer The completion status of the device action statusName: string The meaning of the numeric statusId startTimestamp: date-time When the device action began execution Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the device action completed execution Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason for a device action execution failure exception: string Further details about a device action execution failure }
AbbreviatedJobApprovalStatusDTO	Click here to expand... { approvals: [ The approvals that have been made; null means no approvals have been made JobApprovalDTO ] externalApprovalObtainedTimestamp: date-time The time at which an external approval was obtained; null means no such approval is needed or it is still pending Example: 2017-01-31T13:45:00.000+0000 jobApprovalTypeId: string The job approval type's unique database key; note that it is possible for this job approval type to have been deleted since the job was submitted jobApprovalTypeName: string The name of the job approval type }
AbbreviatedJobDTO	Click here to expand... { id: string The job's unique database key jobID: string The job's unique ID changeID: string The optional change ID, for mapping into any external change management system taskID: string The optional task ID, for mapping into any external change management system jobDetailsLink: string Link to get complete details about this job approvalStatus: AbbreviatedJobApprovalStatusDTO The approvals that have been made currentStatus: AbbreviatedJobStatusDTO The current state of the job originatorTypeId: integer The type of the originator originatorTypeName: string The meaning of the numeric originatorTypeId originator: string The originating user name or policy name runAtTimestamp: date-time When the job is to execute; null means now or when approved Example: 2017-01-31T13:45:00.000+0000 dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] actions: [ The actions, ordered by action number AbbreviatedActionDTO ] }
AbbreviatedJobStatusDTO	Click here to expand... { annotation: string The annotation or reason, present only when the user approves, rejects, aborts, or cancels a job originator: string The name of the user or policy that caused the job to move into this state timestamp: date-time The time at which this state was initiated Example: 2017-01-31T13:45:00.000+0000 stateId: integer The state of the job at the timestamp stateName: string The meaning of the numeric stateId }
AbbreviatedRuleDTO	Click here to expand... { id: string The database key name: string The rule's display name activationDate: date-time When the rule starts to be active annotation: string Notes, comments, description, explanation applicableSecurityContextTypeId: integer The types of security contexts this rule applies to applicableSecurityContextTypeName: string The meaning of the numeric applicableSecurityContextTypeId correctableFlag: boolean Whether or not this rule is correctable cveIDs: [ Associated security vulnerability CVE ID(s) string ] deactivationDate: date-time When the rule stops being active deviceTypeGuid: string Which device type this rules applies to; null means it applies to all device types deviceTypeName: string The name of the device type releases: string The operating system image versions this rule applies to ruleSetId: string The database key of the owning rule set ruleSetName: string The name of the owning rule set severityId: integer The violation severity severityName: string The meaning of the numeric severityId dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
ActionDTO	Click here to expand... Subclasses: TrapActionDTO SpanActionDTO FindEndpointActionDTO EventActionDTO UnquarantineEndpointActionDTO ExternalScriptActionDTO EmailActionDTO QuarantineEndpointActionDTO { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] }
ActionResultDTO	Click here to expand... Subclasses: EndpointActionResultDTO ExternalScriptActionResultDTO { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action) guid: string The GUID that identifies the type of action name: string The type of action referred to by the GUID annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action startTimestamp: date-time When the action execution began Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed }
ActionSpecificResultsDTO	Click here to expand... Subclasses: SyntaxScanResultsDTO DeployToActiveResultsDTO CustomActionResultsDTO ComplianceStatusResultsDTO GetNextSwitchResultsDTO { }
ActionStatusDTO	Click here to expand... { actionGuid: string The GUID of the device action that was executed actionName: string The action name statusId: integer The completion status of the device action date: date-time The last time this action was attempted Example: 2017-01-31T13:45:00.000+0000 accessModeId: integer The access mode that was used to connect to the device transferModeId: integer The transfer mode that was used to exchange files with the device deviceAgentName: string The device agent that was used to communicate with the device deviceInterfaceName: string Which set of interface settings was used (primary or auxiliary) port: string The TCP port that was used to connect to the device deviceSecurityProfileName: string The credentials that were used to login to the device message: string Reason for a device action execution failure transcriptLink: string Link to get the recorded device interaction transcript, when there is such a transcript (may not have one on certain error conditions) }
ApprovalStepDTO	Click here to expand... { jobApproverUserNames: [ The users who can approve the job in this step string ] jobApproverRoleNames: [ The roles who can approve the job in this step string ] numRequired: integer The number of approvals required at this step }
AssignTargetCfgActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$AssignTargetCfgActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span replaceCurrentFlag: boolean When true, replaces any existing target configuration with the selected one; when false, only assigns new target configuration to devices that currently have none scriptParams: ScriptParamsDTO* Which script or configuration is to be copied into the target configuration, or selects to clear the target configuration }
BooleanExpressionDTO	Click here to expand... { leftParenFlag: boolean Whether or not this expression begins with a left parenthesis rightParenFlag: boolean Whether or not this expression ends with a right parenthesis booleanExpressionOperatorId: integer* How the left and right terms are joined together; when there is only a single term, this should be no operator; when there are two terms, this should be either the AND or the OR operator left: TermDTO The term or operand to the left of the operator right: TermDTO The term or operand to the right of the operator }
ChangeSummaryParametersDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$ChangeSummaryParametersDTO" { includeEventsFlag: boolean Whether or not events are shown in the report spanParams: SpanParamsDTO* The network span to report on timePeriod: string* Which configuration changes are to be included in the report; that is, include the changes that occurred within this time period whichTrailGuid: string* Which configuration trail is to be reported on }
ComboGroupDTO	Click here to expand... { id: string The combo group's unique database key (read-only) name: string* The combo group's display name realmId: string* The database key of the realm this combo group belongs to realmDetailsLink: string Link to get complete details about the parent realm (read-only) groups: BooleanExpressionDTO* How groups are combined to form this combo group dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] memberDevicesLink: string Link to get a list of the member devices (read-only) }
CommitActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$CommitActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span commitAllContextsFlag: boolean When the device supports multiple security contexts, which should be committed; false means just the context logged in to; true means all contexts markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted }
ComplianceStatusActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$ComplianceStatusActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span ruleSetNames: [ The names of the rule sets to be reported on; when null/empty, then this action reports on all rule sets (read-only) string ] }
ComplianceStatusDTO	Click here to expand... { passedRules: [ The rules that are currently compliant PassedRuleDTO ] violatedRules: [ The rules that are currently in violation FailedRuleDTO ] }
ComplianceStatusResultsDTO	Click here to expand... { ruleResults: [ Compliance status for each rule ComplianceStatusRuleResultDTO ] }
ComplianceStatusRuleResultDTO	Click here to expand... { annotation: string The rule's annotation category: string The rule's category ruleId: string The rule's database key ruleName: string The rule's name ruleSetName: string The name of the rule's parent rule set status: string The compliance status trailName: string Which configuration trail this is a status for violationSeverityId: integer The rule's violation severity }
ComplianceSummaryParametersDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$ComplianceSummaryParametersDTO" { categories: [ Selects rules in these categories; null/empty means no filtering of rules by category is done string ] forceReevaluationFlag: boolean When enabling to report only on devices assigned to the selected rules/rule sets, whether to use stored compliance status (false) or r-evaluate or re-compute the status (true) in case the stored results may be stale (such as after adding new rules or changing rules such that no status is currently stored) onlyShowDevicesAssignedToSelectedFlag: boolean Whether or not to report only on devices assigned to the selected rules or rule sets; when true, this pulls results from stored compliance status, which is far more efficient than re-evaluating each rule's status ruleIds: [ The database keys of which rules are to be reported on; can specify rules or rule sets, but not both; when both are null/empty, reports on all rule sets string ] ruleSetIds: [ The database keys of which rule sets are to be reported on; can specify rules or rule sets, but not both; when both are null/empty, reports on all rule sets string ] scriptTypeId: integer* Which script or configuration is to be reported on; limited to current/trusted running and startup, and other current showAddressColumnFlag: boolean Whether or not the report includes a column showing the device's primary interface host name/IP address/URL showBaseScoreColumnFlag: boolean Whether or not the report includes a column showing the rule's associated security vulnerability base score showFailedStatusFlag: boolean Whether or not the report includes rows where the result is 'Failed' showSuccessfulStatusFlag: boolean Whether or not the report includes rows where the result is 'Passed' showNonApplicableStatusFlag: boolean Whether or not the report includes rows where the result is 'N/A' spanParams: SpanParamsDTO* The network span to report on whichTrailGuid: string When the script or configuration type is other current, specifies which other trail is to be reported on }
ConfigCompareParametersDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$ConfigCompareParametersDTO" { compareScriptTypeId: integer* Which script or configuration is to be compared, appearing on the left side of the report; limited to current running and current startup compareToScriptTypeId: integer* Which script or configuration is to be compared, appearing on the right side of the report; limited to current/trusted running and startup, target, and template runtimeProperties: { When the script being compared to is a template and the template contains runtime substitution parameters, provides the values for those parameters; this is a map where the key is the property name string and the value is the property value string } spanParams: SpanParamsDTO* The network span to report on templateId: string When the script being compared to is a template, the database key of the selected template }
ConfigurationDTO	Click here to expand... { id: string The configuration's unique database key created: date-time Date/time this configuration was obtained from the device Example: 2017-01-31T13:45:00.000+0000 trailGuid: string The GUID of the configuration trail osImageName: string The discovered operating system version annotation: string The user-defined notes or description about this configuration changeID: string The change ID from the job that generated this configuration, for mapping into any external change management system jobID: string The job ID of the job that generated this configuration externalFlag: boolean Whether this configuration resulted from an external change made to the device (true) or from an internal change made to the device (false); an internal change occurs when the system is used to make the change; an external change occurs when the device is changed by other means outside the system and detected via syslog historicalFlag: boolean Whether this is a historical configuration (true) or a current configuration (false) trustedFlag: boolean Whether or not this configuration is trusted trustedTimestamp: date-time Date/time this configuration was marked as trusted Example: 2017-01-31T13:45:00.000+0000 filename: string The name of the file that any binary data was copied from dataLength: integer The length of the ASCII data in bytes; a zero indicates there is no ASCII data binaryDataLength: integer The length of the binary data in bytes; a zero indicates there is no binary data dataLink: string Link to retrieve the ASCII data binaryDataLink: string Link to retrieve the binary data }
CustomActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$CustomActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span commitFlag: boolean Whether or not to commit changes after running the commands in the custom action markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted rebootFlag: boolean Whether or not the device should be rebooted after running the commands in the custom action runtimeProperties: { Name/value pairs for any runtime parameters, for substitution into device commands; this is a map where the key is the property name string and the value is the property value string } }
CustomActionResultsDTO	Click here to expand... { resultProperties: { Any result.* properties that were discovered or populated while executing the custom action, as name/value pairs; this is a map where the key is the property name string and the value is the property value string } }
DeployOsImageActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$DeployOsImageActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span activationKey: string When image source is from remote file server, license key to activate features in the binary image on the device deleteCurrentImageId: integer* How to handle the current image file, when the device supports file management of its binary files files: [ When image source is from remote file server, which file (or files, for device with multi-file images) are to be deployed OsFileDTO ] footprintKbytes: integer When image source is from remote file server, the memory footprint, in kilobytes, for the remote image, to verify the new image can run in the device (for those devices that support memory size discovery) imageActiveOnTimestamp: date-time When image source is image active on date, specifies the date/time Example: 2017-01-31T13:45:00.000+0000 imageFromLibraryId: string When image source is image from library, the database key of the OS image in the library imageSourceId: integer* Which OS image is to be deployed; note that you will not be able to create or update this action to deploy from a file (feature is not currently supported) markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted parallelExecutionFlag: boolean When true, runs this action on multiple devices concurrently; when false, runs this action on multiple devices one by one sequentially (to reduce memory overhead due to large or identical images) rebootTypeId: integer* Whether or not to reboot after the image is deployed, and how to handle unsaved changes prior to rebooting restoreAssociatedStartupFlag: boolean Whether or not to restore the startup configuration active when an image from the library was active, or active at the selected date/time targetImageFilesystem: string* Where the binary file is to be placed on the device's file systems transferModeId: integer When image source is from remote file server, which file transfer mode is to be used to copy files from the remote server to the device }
DeployToActiveActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$DeployToActiveActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span commitFlag: boolean Whether or not to commit changes after deploying the script or configuration forceTunneledTransferFlag: boolean Whether or not to deploy the script in tunneled mode, overriding the transfer mode set in the device markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted overrideCorrectiveActionOptionsFlag: boolean When remediating, whether or not to use various options as defined in the rule corrective actions, or to use options as defined here as an override; when false, the commitFlag, forceTunneledTransferFlag, markAsTrustedFlag, smartMergeModeId,stopOnSyntaxErrorFlag, and syntaxScanFlag included here are ignored scriptParams: ScriptParamsDTO* Which script or configuration is to be deployed to the device smartMergeModeId: integer Selects to build an incremental merge script or a full merge script stopOnSyntaxErrorFlag: boolean When deploying in tunneled mode, whether or not to stop pushing commands from the script once a syntax error is detected syntaxScanFlag: boolean Whether or not to validate the command line syntax in the script prior to deploying it }
DeployToActiveResultsDTO	Click here to expand... { scriptContents: string The script that was deployed to the device }
DeployToStoredActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$DeployToStoredActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted overrideCorrectiveActionOptionsFlag: boolean When remediating, whether or not to use various options as defined in the rule corrective actions, or to use options as defined here as an override; when false, the markAsTrustedFlag and rebootFlag included here are ignored rebootFlag: boolean Whether or not the device should be rebooted after deploying the script or configuration scriptParams: ScriptParamsDTO* Which script or configuration is to be deployed to the device }
DeviceAdapterDTO	Click here to expand... { id: string The database key name: string The adapter's display name annotation: string Annotation with reasons for modification enabledFlag: boolean Whether or not this adapter is enabled guid: string The adapter's GUID lastModifiedTimestamp: date-time When this adapter was last modified Example: 2017-01-31T13:45:00.000+0000 lastModifiedUserName: string The name of the user who last modified this adapter requiresMergeFlag: boolean Whether or not the adapter requires a manual three-way merge, caused by a software upgrade stateId: integer Whether an adapter is currently in the new, modified, or baseline state stateName: string The meaning of the numeric stateId typeId: integer The type of device adapter typeName: string The meaning of the numeric typeId }
DeviceAgentDTO	Click here to expand... { id: string The database key name: string The device agent's unique display name address: string The address of the device agent port: integer The port of the device agent deviceFacingIpv4Address: string The IPv4 address of the agent relative to its managed devices deviceFacingIpv6Address: string The IPv6 address of the agent relative to its managed devices enabledFlag: boolean Whether or not this device agent is enabled localFlag: boolean Whether or not this device agent is local dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
DeviceDTO	Click here to expand... { id: string The device's unique database key (read-only) name: string* The device's unique name realmId: string* The database key of the realm this device belongs to realmDetailsLink: string Link to get complete details about the parent realm (read-only) onlineFlag: boolean Whether or not this device is online modelName: string The discovered model (read-only) osImageName: string The discovered operating system version (read-only) deviceTypeGuid: string* The GUID of the device type vendorGuid: string The GUID of the vendor categoryId: integer* The category created: date-time The date/time this device was created (read-only) Example: 2017-01-31T13:45:00.000+0000 externalId: string A key or identifier into some external system remoteImageFileServerId: string The database key of the remote image file server remoteImageFileServerDetailsLink: string Link to get complete details about the remote image file server (read-only) lastOnlineStateChange: date-time The last time the device's online state changed (either came online or was taken offline; read-only) Example: 2017-01-31T13:45:00.000+0000 securityContextName: string The security context name securityContextTypeId: integer The security context type targetConfigurationId: string The database key of the target configuration read-only) targetConfigurationDetailsLink: string Link to get complete details about the target configuration (read-only) managerDeviceId: string The database key of the device that manages this device managerDeviceDetailsLink: string Link to get complete details about the manager device (read-only) numVfws: integer The number of virtual firewalls in this device (read-only) numVlbs: integer The number of virtual load balancers in this device (read-only) numVrfs: integer The number of VRFs in this device (read-only) primaryInterface: DeviceInterfaceDTO* The device's primary interface auxiliaryInterface: DeviceInterfaceDTO The device's auxiliary interface dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] statusLink: string Link to get detailed device status (read-only) currentConfigurationsLink: string Link to get the current configurations (read-only) trustedConfigurationsLink: string Link to get the trusted configurations (read-only) configurationsLinks: [ Links to get all configurations per trail (read-only) string ] }
DeviceFilterDTO	Click here to expand... { dynamicFieldFilters: { Any filters on dynamic fields; this is a map where the key is the database key of the dynamic field and the value is the filter value string; value must be formatted properly when the dynamic field is a Date or Integer type } accessModeId: integer Search for devices with this access mode addressMatch: string Search for devices matching this wildcard-enabled IP address or host name autoDspFlag: boolean Search for devices set for device security profile auto-discovery (true) or set to an explicit profile (false); null means do no auto-discovery mode filtering categoryId: integer Search for devices in this category createdTimePeriod: string Search for devices created within this time period deviceAgentName: string Search for devices whose device agent equals this name deviceSecurityProfileName: string Search for devices whose device security profile equals this name deviceTypeGuid: string Search for devices whose device type equals this GUID filterAuxiliaryInterfaceFlag: boolean Whether or not to examine the auxiliary interface settings when matching on the interface-related fields (access mode, transfer mode, address, NAT address, device agent, and device security profile) filterPrimaryInterfaceFlag: boolean Whether or not to examine the primary interface settings when matching on the interface-related fields (access mode, transfer mode, address, NAT address, device agent, and device security profile) managerDeviceName: string Search for devices whose manager name equals this name modelNameMatch: string Search for devices whose model name matches this wildcard-enabled string nameMatch: string Search for devices whose name matches this wildcard-enabled string natAddressMatch: string Search for devices whose NAT address matches this wildcard-enabled string onlineFlag: boolean Search for either online devices (true) or offline devices (false); null means do not filter on the online/offline state osImageNameMatch: string Search for devices whose OS image name matches this wildcard-enabled string securityContextTypeId: integer Search for devices set to this type of security context transferModeId: integer Search for devices with this file transfer mode vendorGuid: string Search for devices whose device type belongs to this vendor noDiscrepanciesFlag: boolean Search for devices that have no discrepancies at all noDiscrepanciesIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have no discrepancies osImageDiscrepancyFlag: boolean Search for devices that have an OS image discrepancy osImageDiscrepancyIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have an OS image discrepancy runningStartupDiscrepancyFlag: boolean Search for devices that have a Running vs Startup discrepancy runningStartupDiscrepancyIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have a Running vs Startup discrepancy runningTrustedDiscrepancyFlag: boolean Search for devices that have a Running vs Trusted Running discrepancy runningTrustedDiscrepancyIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have a Running vs trusted Running discrepancy startupTrustedDiscrepancyFlag: boolean Search for devices that have a Startup vs Trusted Startup discrepancy startupTrustedDiscrepancyIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have a Startup vs trusted Startup discrepancy noViolationsFlag: boolean Search for devices that have no compliance violations noViolationsIncludeFlag: boolean Whether to include (true) or exclude (false) devices that have no compliance violations includedViolationTrailGuids: [ Include devices in the results that have a compliance violation in one of these trails string ] excludedViolationTrailGuids: [ Exclude devices from the results that have a compliance violation in one of these trails string ] lastAttemptedSpanActionFlag: boolean Search for devices whose last attempted span action matches a particular completion status lastAttemptedSpanActionGuid: string When lastAttemptedSpanActionFlag is true, specifies which span action to examine lastAttemptedSpanActionStatusId: integer When lastAttemptedSpanActionFlag is true, specifies which completion status to search for lastAttemptedSpanActionErrorMatch: string When lastAttemptedSpanActionFlag is true, specifies which completion error message to search for, wildcards allowed lastSuccessfulSpanActionFlag: boolean Search for devices whose last successful span action occurred within a selected time period lastSuccessfulSpanActionGuid: string When lastSuccessfulSpanActionFlag is true, specifies which span action to examine lastSuccessfulSpanActionTimePeriod: string When lastSuccessfulSpanActionFlag is true, specifies when the action is to have succeeded noAttemptedSpanActionFlag: boolean Searches for devices that have not attempted a span action within a specified number of days noAttemptedSpanActionGuid: string When noAttemptedSpanActionFlag is true, specifies which span action to examine noAttemptedSpanActionDays: integer When noAttemptedSpanActionFlag is true, specifies when the action is to have been attempted noSuccessfulSpanActionFlag: boolean Searches for devices that have not succeeded executing a span action within a specified number of days noSuccessfulSpanActionGuid: string When noSuccessfulSpanActionFlag is true, specifies which span action to examine noSuccessfulSpanActionDays: integer When noSuccessfulSpanActionFlag is true, specifies when the action is to have succeeded iosHwFilter: IOSHardwareInventoryFilterDTO Options for filtering on hardware inventory information obtained from Cisco IOS or IOS-like devices }
DeviceInterfaceDTO	Click here to expand... { address: string* The IP address, host name, or URL of the device port: string The TCP port used to connect to the device natAddress: string The device agent's address as it is known to the device, either an IP address or a host name accessModeId: integer* The protocol used to connect to the device transferModeId: integer* The protocol used to exchange files with the device deviceAgentId: string* The database key of the device agent that manages this device deviceAgentDetailsLink: string Link to get complete details about the device agent (read-only) deviceSecurityProfileId: string The login credentials for accessing the device deviceSecurityProfileDetailsLink: string Link to get complete details about the device security profile (read-only) autoDiscoverDspFlag: boolean Whether or not the device security profile is to be discovered automatically at the next login attempt }
DeviceResultDTO	Click here to expand... { id: string This device result's unique database key deviceId: string The unique database key of the device where this action ran deviceName: string The name of the device where this action ran realmName: string The name of the realm the device belonged to at execution time actionNumber: integer Which action within the job's list of actions subactionNumber: integer Which sub-action within the action; when null, does not refer to a sub-action statusId: integer The completion status of the device action startTimestamp: date-time When the device action began execution Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the device action completed execution Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason for a device action execution failure exception: string Further details about a device action execution failure accessModeId: integer The access mode that was used to connect to the device transferModeId: integer The transfer mode that was used to exchange files with the device deviceAgentName: string The device agent that was used to communicate with the device deviceInterfaceName: string Which set of interface settings was used (primary or auxiliary) deviceTypeName: string Which device type was used to interact with the device port: string The TCP port that was used to connect to the device deviceSecurityProfileName: string The credentials that were used to login to the device actionSpecificResults: ActionSpecificResultsDTO Further detailed results transcriptLink: string Link to get the recorded device interaction transcript, when there is such a transcript (may not have one on certain error conditions) }
DeviceSecurityProfileDTO	Click here to expand... { id: string The database key name: string The device security profile's unique display name loginUserName: string Username for logging in to devices privilegedUserName: string Privileged username for logging in to devices realmId: string The associated realm's database key; when null, this profile is available to the entire network realmName: string The associated realm's name realmDetailsLink: string Link to get complete details about the associated realm }
DeviceStatusDTO	Click here to expand... { id: string The unique database key of this device status runningViolationTimestamp: date-time Date/time the earliest running compliancy violation occurred Example: 2017-01-31T13:45:00.000+0000 startupViolationTimestamp: date-time Date/time the earliest startup compliancy violation occurred Example: 2017-01-31T13:45:00.000+0000 otherTrailsViolationTimestamp: date-time Date/time the earliest other compliancy violation occurred Example: 2017-01-31T13:45:00.000+0000 rvtDiscrepancyTimestamp: date-time Date/time the Running vs Trusted discrepancy occurred Example: 2017-01-31T13:45:00.000+0000 svtDiscrepancyTimestamp: date-time Date/time the Startup vs Trusted discrepancy occurred Example: 2017-01-31T13:45:00.000+0000 rvsDiscrepancyTimestamp: date-time Date/time the Running vs Startup discrepancy occurred Example: 2017-01-31T13:45:00.000+0000 osImageDiscrepancyTimestamp: date-time Date/time the OS image discrepancy occurred Example: 2017-01-31T13:45:00.000+0000 currentHardwareInventory: HardwareInventoryDTO The current discovered or imported hardware inventory information osImageLoadHistory: [ Which OS images have been discovered or deployed on the device OsImageLoadHistoryDTO ] actionStatus: [ Latest device action execution status ActionStatusDTO ] complianceStatus: { Latest compliance status (rules passed and failed during the latest scan); keyed by the configuration trail GUID of the configuration that was examined } }
DiscrepancySummaryParametersDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$DiscrepancySummaryParametersDTO" { spanParams: SpanParamsDTO* The network span to report on }
DynamicFieldDTO	Click here to expand... { id: string The database key name: string The dynamic field's display name annotation: string Notes, comments, description, explanation assignmentMechanism: string The assignment mechanism for dynamic field autoGroupFlag: boolean For a device dynamic field, whether or not devices are auto-grouped based on this field's value displayInListsFlag: boolean Whether or not this dynamic field is displayed as a column in the component list enabledFlag: boolean Whether or not the dynamic field is enabled filterableFlag: boolean Whether or not components can be filtered by this dynamic field's value component: string The component valueType: string The type of values that can be assigned }
DynamicFieldValueDTO	Click here to expand... { id: string The database key of the dynamic field whose value this is (read-only) name: string The name of the dynamic field (read-only) values: [ The value(s) for the dynamic field string ] dynamicFieldDetailsLink: string Link to get more detailed information about the dynamic field (read-only) }
EmailActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$EmailActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] attachedReportParameters: EmailedReportParametersDTO When attaching a report, parameters specific to the type of report attachmentFormatId: integer The format of an attached report (CSV, HTML, PDF, or RTF) attachmentIncludedFlag: boolean Whether or not a report is attached to the email detailsIncludedFlag: boolean Whether or not an attached report includes additional sub-reports for all its details hideCsvHeaderFooterFlag: boolean Whether or not an attached CSV-formatted report includes headers and footers that are not strictly part of the column-oriented report data linkIncludedFlag: boolean Whether or not the email includes a link to a report sensitiveDataHiddenFlag: boolean Whether or not sensitive data is hidden in any attached report subject: string* The subject of the email message text: string* The text that appears in the body of the email message toAdhocAddresses: [ Any ad-hoc email addresses of the other interested recipients of the email string ] toEmailListIds: [ Any email distribution lists to receive the email string ] toUserIds: [ Any users to receive the email string ] }
EmailDistributionListDTO	Click here to expand... { id: string The database key name: string The email distribution list's unique display name addresses: [ The email addresses that make up this list string ] dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
EmailNotificationParametersDTO	Click here to expand... { jobStateIds: [ The job states of interest; the trap is sent when the job enters any of these states integer ]* emailApproverFlag: boolean Whether or not the job state change email should be sent to the user(s) who can approve the job emailCreatorFlag: boolean Whether or not the job state change email should be sent to the user who created the job emailOtherFlag: boolean Whether or not the job state change email should be sent to users other than the creator or approvers jobDetailsAttachmentIncludedFlag: boolean Whether or not the email includes an attached job details jobDetailsLinkIncludedFlag: boolean Whether or not the email includes a link to access the job details web page jobDetailsAllDetailsIncludedFlag: boolean Whether or not an attached job details includes all details (that is, device interaction transcripts) emailedJobDetailsAttachmentFormatId: integer The format of an attached job details (HTML, PDF, or RTF) jobSummaryAttachmentIncludedFlag: boolean Whether or not the email includes an attached job summary report jobSummaryLinkIncludedFlag: boolean Whether or not the email includes a link to access the job summary report web page emailedJobSummaryAttachmentFormatId: integer The format of an attached job summary report (HTML, PDF, or RTF) showJobSummaryById: integer When including the link to a job summary report, how the generated report is to be oriented (by job ID, by change ID, or by task ID) toAdhocAddresses: [ When emailing to others, any ad-hoc email addresses of the other interested recipients of the email string ] toEmailListIds: [ When emailing to others, any email distribution lists to receive the email string ] toEmailListsDetailsLinks: [ When emailing to others, links to get more detailed information about the email distribution lists (read-only) string ] toUserIds: [ When emailing to others, any users to receive the email string ] toUsersDetailsLinks: [ When emailing to others, links to get more detailed information about the users (read-only) string ] }
EmailedReportParametersDTO	Click here to expand... Subclasses: ComplianceSummaryParametersDTO ChangeSummaryParametersDTO DiscrepancySummaryParametersDTO ConfigCompareParametersDTO { }
EndpointActionResultDTO	Click here to expand... { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action) guid: string The GUID that identifies the type of action name: string The type of action referred to by the GUID annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action startTimestamp: date-time When the action execution began Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed aclLabels: [ Any ACLs modified by the action; will be null/empty when no ACLs were modified string ] endpointMacAddress: string The discovered ethernet MAC address of the endpoint endpointPortLocation: string The port the endpoint was seen on within the managing switch endpointPortType: string For an IOS switch, the type of port that the endpoint was seen on managingSwitchDeviceId: string The database key of the device that is the endpoint's managing switch managingSwitchName: string The name of the device that is the endpoint's managing switch tracerouteErrorText: string Any output to stderr emitted by the traceroute command tracerouteExitCode: integer The exit code of the traceroute command tracerouteManagingRouterAddress: string The IP address of the router nearest to the endpoint, as discovered by running the traceroute command tracerouteOutputText: string Any output to stdout emitted by the traceroute command tracerouteException: string Any unexpected error that occurred while running the traceroute command vlanMap: string Name of the VLAN map on which the ACL(s) was applied; will be null/empty when no VLAN map was modified vlanNumber: integer VLAN number on which the ACL(s) were applied; will be null/empty when no ACL was applied }
EntityDTO	Click here to expand... { name: string The name of the component descr: string {{ The description of the component}} pid: string The product id or part number vid: string The version id sid: string The serial number }
EventActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$EventActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] }
ExternalScriptActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$ExternalScriptActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] adhocTemplate: TemplateDTO Any template that is passed to the script as a file continueOnFailureFlag: boolean Whether or not to continue sequential execution per device when script execution encounters an error runtimeProperties: { Name/value pairs for any runtime parameters, for substitution into the script execution command line; this is a map where the key is the property name string and the value is the property value string } spanParams: SpanParamsDTO Any selected network span }
ExternalScriptActionResultDTO	Click here to expand... { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action) guid: string The GUID that identifies the type of action name: string The type of action referred to by the GUID annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action startTimestamp: date-time When the action execution began Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed transcript: string When script was not run per-device, contains the transcript of the script's single execution, in an XML format containing stdout and stderr }
FailedRuleDTO	Click here to expand... { date: date-time Date/time when the rule was checked and found to be in violation Example: 2017-01-31T13:45:00.000+0000 ruleId: string The rule's unique database key ruleDetailsLink: string Link to get complete details about the rule correctableFlag: boolean Whether or not the rule can be corrected }
FindEndpointActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$FindEndpointActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] boundingSpanParams: SpanParamsDTO* The bounding network span, within which the search is to be limited endpointAddress: string* The address to be located }
GetNextSwitchResultsDTO	Click here to expand... { endpointMacAddress: string Ethernet MAC address of the endpoint, in the form 'xxxx.xxxx.xxxx'; populated if the MAC address was first discovered by this device action; will be null if it was already known from a previous device action endpointPortLocation: string The port the endpoint was seen on within this switch endpointPortType: string For an IOS switch, the type of port that the endpoint was seen on (for example, Ethernet, FastEthernet, GigabitEthernet) nextSwitchAddress: string IP address of the next switch for reaching the endpoint; will be null/empty when this switch is the endpoint's closest managing switch }
GroupDTO	Click here to expand... { id: string The group's unique database key (read-only) name: string* The group's display name realmId: string* The database key of the realm this group belongs to realmDetailsLink: string Link to get complete details about the parent realm (read-only) autoGroupFlag: boolean Whether or not this group is an auto-group (read-only) dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] memberDevicesLink: string Link to get a list of the member devices (read-only) }
HardwareInventoryDTO	Click here to expand... { created: date-time Time this inventory was created or last updated Example: 2017-01-31T13:45:00.000+0000 importedInventory: string Inventory imported from an external element manager entities: [ Hardware components reported in 'show inventory' command EntityDTO ] fileSystems: [ Data reported in 'dir all-filesystems' command StorageDTO ] memories: [ Data reported in 'show memory statistics' command StorageDTO ] }
IOSHardwareInventoryFilterDTO	Click here to expand... { entityNameMatch: string Search for devices matching this wildcard-enabled hardware entity name entityDescrMatch: string Search for devices matching this wildcard-enabled hardware entity descr entityPidMatch: string Search for devices matching this wildcard-enabled hardware entity PID entityVidMatch: string Search for devices matching this wildcard-enabled hardware entity VID entitySnMatch: string Search for devices matching this wildcard-enabled hardware entity SN fileSystemFreeSizeIntegerRange: string Search for devices with a file system free size matching this range specification fileSystemNameMatch: string Search for devices matching this wildcard-enabled file system name fileSystemTotalSizeIntegerRange: string Search for devices with a file system total size matching this range specification memoryNameMatch: string Search for devices matching this wildcard-enabled memory name memorySizeIntegerRange: string Search for devices with a memory size matching this range specification }
JobApprovalDTO	Click here to expand... { message: string The explanation, notes, or comments for this approval timestamp: date-time The time at which this approval was made Example: 2017-01-31T13:45:00.000+0000 username: string The user who made this approval }
JobApprovalStatusDTO	Click here to expand... { approvals: [ The approvals that have been made; null means no approvals have been made JobApprovalDTO ] externalApprovalObtainedTimestamp: date-time The time at which an external approval was obtained; null means no such approval is needed or it is still pending Example: 2017-01-31T13:45:00.000+0000 }
JobApprovalTypeDTO	Click here to expand... { name: string The unique identifying name accessibleToUserNames: [ The users allowed to use this job approval type on jobs they submit; when accessible users and roles are both null, this job approval type is accessible to all string ] accessibleToRoleNames: [ The roles allowed to use this job approval type on jobs they submit; when accessible users and roles are both null, this job approval type is accessible to all string ] approvalSteps: [ Who must approve and in what order ApprovalStepDTO ] methodName: string What sort of approval process is required sendEmailFlag: boolean Whether or not to send an email to the users when their approval is pending for a job externalApprovalRequiredFlag: boolean Whether or not approval is required from an external change management system dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
JobDTO	Click here to expand... { id: string The job's unique database key (read-only) jobID: string The job's unique ID (read-only) changeID: string The optional change ID, for mapping into any external change management system taskID: string The optional task ID, for mapping into any external change management system approvalStatus: JobApprovalStatusDTO The approvals that have been made (read-only) jobApprovalType: JobApprovalTypeDTO The approvals that are required (read-only) statusHistory: [ The history of job state transitions; the last or most recent entry is the current state (read-only) JobStatusDTO ] includeDebugTraceFlag: boolean Whether or not to include debugging or processing trace messages in device interaction transcripts loginUsername: string Username for logging in to devices loginPassword: string Password for logging in to devices privilegedUsername: string Privileged username for logging in to devices privilegedPassword: string Privileged password for logging in to devices originatorTypeId: integer The type of the originator (read-only) originator: string The originating user name or policy name (read-only) reconciliationTimestamp: date-time When the job was reconciled (read-only) Example: 2017-01-31T13:45:00.000+0000 reconciliationErrorMsg: string Any error message from a failed reconciliation (read-only) reconciliationStatusId: integer Whether or not the job has been reconciled (read-only) runAtTimestamp: date-time When the job is to execute; null means now or when approved Example: 2017-01-31T13:45:00.000+0000 skipRemainingActionsOnErrorFlag: boolean Whether or not remaining actions should be skipped once an action encounters an error triggeringEventSummary: string Any event that caused this job to be created/executed by an event-based policy (read-only) emailParams: EmailNotificationParametersDTO Any parameters for sending an email as a notification that the job has changed its state snmpTrapParams: SnmpTrapNotificationParametersDTO Any parameters for sending an SNMP trap as a notification that the job has changed its state dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] actions: [ The actions, ordered n execution order ActionDTO ]* submissionLink: string Link to submit a draft job for execution (read-only) desubmissionLink: string Link to cancel a scheduled execution and make the job editable again (that is, re-draft; read-only) cancellationLink: string Link to cancel a scheduled execution or abort an executing job (read-only) approvalLink: string Link to approve the job (read-only) rejectionLink: string Link to reject the job (read-only) deviceResultsLink: string Link to retrieve device results (read-only) }
JobStatusDTO	Click here to expand... { annotation: string The annotation or reason, present only when the user approves, rejects, aborts, or cancels a job originator: string The name of the user or policy that caused the job to move into this state timestamp: date-time The time at which this state was initiated Example: 2017-01-31T13:45:00.000+0000 stateId: integer The state of the job at the timestamp }
JsonPatch	Click here to expand... [ A list of JSON Patch operations JsonPatch.OneOperation ]
JsonPatch.OneOperation	Click here to expand... Subclasses: JsonPatch.Move JsonPatch.Remove JsonPatch.Copy JsonPatch.Replace JsonPatch.Test JsonPatch.Add { }
JsonPatch.Pointer	Click here to expand... string Pointer or path to an element or property
JsonPatch.Add	Click here to expand... { op: string* Enum: [ "add" ] value: any* path: JsonPatch.Pointer* }
JsonPatch.Remove	Click here to expand... { op: string* Enum: [ "remove" ] path: JsonPatch.Pointer* }
JsonPatch.Replace	Click here to expand... { op: string* Enum: [ "replace" ] value: any* path: JsonPatch.Pointer* }
JsonPatch.Move	Click here to expand... { op: string* Enum: [ "move" ] path: JsonPatch.Pointer* from: JsonPatch.Pointer* }
JsonPatch.Copy	Click here to expand... { op: string* Enum: [ "copy" ] path: JsonPatch.Pointer* from: JsonPatch.Pointer* }
JsonPatch.Test	Click here to expand... { op: string* Enum: [ "test" ] value: any* path: JsonPatch.Pointer* }
MarkAsTrustedActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$MarkAsTrustedActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span cfgTimestamp: date-time Selects the configuration(s) active at this date and time to be the new trusted configuration(s); null when cfgId is set Example: 2017-01-31T13:45:00.000+0000 cfgId: string Which one running or startup configuration is to be marked as the trusted configuration; null when cfgTimestamp is set currentFlag: boolean Whether or not the current running and/or startup configuration is to be marked as trusted; when false, a cfgTimestamp or cfgId must be provided to select the configuration(s) runningTrailFlag: boolean Whether or not a running configuration is to be marked as trusted startupTrailFlag: boolean Whether or not a startup configuration is to be marked as trusted }
OsFileDTO	Click here to expand... { imageTypeName: string What type of binary file this is, when a device supports multi-file images name: string The name of the file sizeBytes: integer The size of the file in bytes messageDigest: string The MD5 checksum or digest }
OsImageDTO	Click here to expand... { id: string The database key name: string The OS image's display name; null/empty when this image has not been verified as having run on a device deviceTypeGuid: string Which device type this OS image applies to deviceTypeName: string The name of the device type vendorGuid: string Which vendor owns the associated device type vendorName: string The name of the vendor forbidDeploymentFlag: boolean Whether or not this OS image is allowed to be deployed annotation: string Notes, comments, description, explanation memoryFootprintBytes: integer Bytes of memory this image consumes; a zero indicates this value is not used by the device activationKey: string License key to activate features in the binary image on the device files: [ The binary files; null/empty when no image snapshot has been taken from a device running this image, or user has not supplied any files OsFileDTO ] modelNames: [ The models where this image can be deployed string ] dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
OsImageLoadHistoryDTO	Click here to expand... { date: date-time Date/time this OS image was discovered or deployed Example: 2017-01-31T13:45:00.000+0000 filename: string The image file name imageName: string The image name username: string The user who deployed this image }
PassedRuleDTO	Click here to expand... { date: date-time Date/time when the rule was checked and found to be compliant Example: 2017-01-31T13:45:00.000+0000 ruleId: string The rule's unique database key ruleDetailsLink: string Link to get complete details about the rule }
PurgeCriteriaDTO	Click here to expand... { purgeByCountFlag: boolean Whether or not to purge by count purgeCount: integer The number of entities to be retained before the oldest are purged away purgeByDaysFlag: boolean Whether or not to purge by age purgeDays: integer The number of days an entity can age before it is purged away }
QuarantineEndpointActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$QuarantineEndpointActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] boundingSpanParams: SpanParamsDTO* The bounding network span, within which the search for the endpoint is to be limited changeVlanOfSharedPortFlag: boolean Whether or not to proceed with changing VLAN membership of the endpoint's switch port when the switch has seen traffic with other endpoints on the same port; when false, changing VLAN membership of the shared port is skipped commitFlag: boolean Whether or not to commit changes after performing the quarantine operation disableSharedPortFlag: boolean Whether or not to proceed with disabling of the endpoint's switch port when the switch has seen traffic with other endpoints on the same port when false, the disabling of the shared port is skipped endpointAddress: string* The address to be located and quarantined markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted quarantineIsolationLevelId: integer* How the quarantine is to be effected remediationAddress: string IP address or host name of a server which will be allowed to talk to the endpoint after it is quarantined, for remediation purposes remediationVlan: string A network from which the endpoint can be accessed after it is quarantined, for remediation purposes }
RealmDTO	Click here to expand... { id: string The realm's unique database key (read-only) name: string* The realm's unique name fallbackConfigsPurgeCriteria: PurgeCriteriaDTO Fallback purge criteria for device configurations (those configurations not covered by the per-trail or per-device-type purge criteria) hardwareInventoryPurgeCriteria: PurgeCriteriaDTO Purge criteria for device hardware inventory purgeConfigsByDeviceTypes: { Per-device-type device configuration purge criteria; this is a map where the key is a device type GUID string and the value is a PurgeCriteriaDTO } purgeConfigsByTrails: { Per-trail device configuration purge criteria; this is a map where the key is a configuration trail GUID string and the value is a PurgeCriteriaDTO } purgeDevicesByDaysFlag: boolean Whether or not to purge (automatically delete) devices that are flagged as offline purgeDevicesDays: integer Number of days a device can be offline before it is purged away (automatically deleted from the system) dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
RebootActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$RebootActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted rebootTypeId: integer* How to handle unsaved changes prior to rebooting }
RefreshDeviceStatusActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$RefreshDeviceStatusActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span offlineCheckDays: integer Number of days a device must be offline before it is deleted, when performing the offline device check runComplianceCheckFlag: boolean Whether or not to refresh device compliance status runDeviceAttributesGenerationFlag: boolean Whether or not to generate fresh device attribute configurations runDiscrepancyCheckFlag: boolean Whether or not to refresh device discrepancy status runOfflineCheckFlag: boolean Whether or not to check for devices that have been offline for too long, and to delete those that exceed the offlineCheckDays runProfileCheckFlag: boolean Whether or not to refresh configuration attribute profiled dynamic fields }
RemediateActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$RemediateActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span collapseSubactionsFlag: boolean Whether or not identical generated sub-actions are collapsed into a minimal set of unique sub-actions, to reduce device access overhead; true is the recommended value scriptParams: ScriptParamsDTO* Which rule(s) and/or rule set(s) are to be remediated }
RemoteFileServerDTO	Click here to expand... { id: string The database key name: string The remote file server's unique display name address: string The IP address or host name of the remote system dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
RuleDTO	Click here to expand... { id: string The database key name: string The rule's display name activationDate: date-time When the rule starts to be active annotation: string Notes, comments, description, explanation applicableSecurityContextTypeId: integer The types of security contexts this rule applies to correctableFlag: boolean Whether or not this rule is correctable (read-only) cveIDs: [ Associated security vulnerability CVE ID(s) string ] deactivationDate: date-time When the rule stops being active deviceTypeGuid: string Which device type this rule applies to; null means it applies to all device types maxRelease: string The maximum OS version, for when this rule applies to a min/max range of operating system versions minRelease: string The minimum OS version, for when this rule applies to a min/max range of operating system versions osImageNamePatterns: [ The regular expressions for matching on OS version names, when this rule applies to a discrete set of images string ] ruleSetId: string The database key of the owning rule set ruleSetDetailsLink: string The name of the owning rule set severityId: integer The violation severity dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
RuleFilterDTO	Click here to expand... { dynamicFieldFilters: { Any filters on dynamic fields; this is a map where the key is the database key of the dynamic field and the value is the filter value string; value must be formatted properly when the dynamic field is a Date or Integer type } activationTimePeriod: string Search for rules whose activation date matches this criteria contentsMatch: string Search for rules whose trigger, subject, or domain contains text that matches this wildcard-enabled string cveIDs: [ Search for rules whose associated CVE IDs include one of these CVE IDs string ] deactivationTimePeriod: string Search for rules whose deactivation date matches this criteria deviceTypeGuid: string Search for rules with this device type excludeRulesWithAllDeviceTypesFlag: boolean When searching for rules of a particular device type, whether or not rules associated with all device types are included in what matches or are excluded ruleNameMatch: string Search for rules whose name matches this wildcard-enabled string ruleSetNameMatch: string Search for rules whose parent rule set name matches this wildcard-enabled string severityIds: [ Search for rules whose severity matches one of these severities integer ] vendorGuid: string Search for rules whose device type belongs to this vendor }
RuleSetDTO	Click here to expand... { id: string The database key name: string The rule set's unique display name enabledFlag: boolean Whether or not the rule set is enabled dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
ScriptParamsDTO	Click here to expand... { adhocTemplate: TemplateDTO When the selected script type is ad-hoc template, this is the template cfgTimestamp: date-time When the selected script type is historical, this selects the configuration active at this date/time Example: 2017-01-31T13:45:00.000+0000 componentIds: [ When the selected script type is template, this contains the database key of the template; when the script type is 'remediate with...', this contains the database keys of the rule(s) and/or rule set(s); when the script type is a selected single configuration, this contains the database key of the configuration string ] ignoreRuleConflictsFlag: boolean When remediating multiple rules, whether or not to ignore conflicts in the corrections made to the same device by different rules; ignored when not performing remediattion ruleFilter: RuleFilterDTO When remediating with all assigned, selects which rules are selected for remediation runtimeProperties: { When the selected script type is template, and the template contains runtime substitution parameters, this contains the name/value pairs for those parameters; this is a map where the key is the property name string and the value is the property value string } scriptTypeId: integer* The selected script or configuration type selectedTrailGuids: [ When the selected script type is other trails, this specifies the trails string ] }
SnapshotActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$SnapshotActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted }
SnapshotOsImageActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$SnapshotOsImageActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span parallelExecutionFlag: boolean When true, runs this action on multiple devices concurrently; When false, runs this action on multiple devices one by one sequentially (to reduce memory overhead due to large or identical images) transferModeId: integer When using remote image file servers, selects which file transfer mode is used useRemoteImageFileServerFlag: boolean Whether or not to deposit the images to a remote file server; when false, saves images to the database; when true, saves images to the remote image file server associated with each device }
SnmpManagerStationDTO	Click here to expand... { id: string The database key address: string The address of the SNMP manager port: string The port where the SNMP manager listens for traps trapCommunity: string The trap community accepted by the SNMP manager versionName: string The SNMP version dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }
SnmpTrapNotificationParametersDTO	Click here to expand... { annotation: string Notes or comments to include in the SNMP trap jobStateIds: [ The job states of interest; the SNMP trap is sent when the job enters any of these states integer ]* destinationSnmpManagerStationIds: [ The database key of the SNMP manager station(s) to be sent the job state change SNMP trap string ]* destinationSnmpManagerStationDetailsLinks: [ Link to get more detailed information about the SNMP manager stations (read-only) string ] jobDetailsLinkIncludedFlag: boolean Whether or not the SNMP trap includes a link to access the job details web page jobSummaryLinkIncludedFlag: boolean Whether or not the SNMP trap includes a link to access the job summary report web page showJobSummaryById: integer When including the link to a job summary report, how the generated report is to be oriented (by job ID, by change ID, or by task ID) }
SpanActionDTO	Click here to expand... Subclasses: TelnetSshSessionActionDTO ComplianceStatusActionDTO DeployToStoredActionDTO CustomActionDTO CommitActionDTO SnapshotActionDTO DeployToActiveActionDTO SnapshotOsImageActionDTO RefreshDeviceStatusActionDTO MarkAsTrustedActionDTO AssignTargetCfgActionDTO SyntaxScanActionDTO RebootActionDTO DeployOsImageActionDTO RemediateActionDTO { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span }
SpanParamsDTO	Click here to expand... { deviceFilter: DeviceFilterDTO When the selected network span is a realm, group, or combo group, narrows down which devices in that span are included in the action; ignored when the selected network span is a single device or multiple devices spanIds: [ The database key of the single selected realm, group, combo group, or device; or the database keys of the multiple selected devices; or, in the case of emailed reports, null to indicate the report is to be generated for the entire network string ]* unresolvableSpanSummary: string When getting a job and one or more devices in a multi-device span have been deleted since the job was executed, contains the names of all the devices in the multi-device span (since all the database keys are no longer usable; read-only) }
StorageDTO	Click here to expand... { name: string The identifying name bytesFree: integer The number of bytes that are unused bytesTotal: integer The total size of the storage in bytes bytesUsed: integer The number of bytes that are filled up }
SyntaxScanActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$SyntaxScanActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span scriptParams: ScriptParamsDTO* Which script or configuration is to be checked by the device }
SyntaxScanResultsDTO	Click here to expand... { scriptLines: [ Results of checking each line in the configuration or template or script SyntaxScanScriptLineDTO ] }
SyntaxScanScriptLineDTO	Click here to expand... { commandLine: string The command line from the configuration or template errorMessage: string The device's response to validating or checking the command line scanned: boolean Whether or not the command line was checked; some command lines are skipped, such as comments, lines inside multi-line commands (such as banners), and lines inside blocks whose header reported a syntax error }
TelnetSshSessionActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$TelnetSshSessionActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] useAuxiliaryInterfaceFlag: boolean Whether or not the auxiliary interface of the selected device is to be used for connecting to the device; applicable only when the network span is a single device spanParams: SpanParamsDTO* The selected network span loginUsername: string Username for logging in to the device loginPassword: string Password for logging in to the device }
TemplateDTO	Click here to expand... { contents: string* The text contents injectionFlag: boolean Whether or not the contents contain device type interaction XML code substitutionParameterCheckFlag: boolean Whether or not the contents should be validated for correct substitution parameter syntax }
TermDTO	Click here to expand... { notFlag: boolean Whether or not the opposite of the operand is to be computed groupId: string The database key of the group that makes up this term; must specify either a simple 'groupId' or a more complex 'groups' to define this term as an operand in a boolean expression groupDetailsLink: string Link to get complete details about the group (read-only) groups: BooleanExpressionDTO Complex combination of groups that make up this term }
TrapActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$TrapActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] destinationSnmpManagerStationIds: [ The database keys of the recipients of the SNMP trap string ]* deviceId: string The database key of any related device to include in the SNMP trap snmpTrapTypeId: integer* Which SNMP trap to emit }
UnquarantineEndpointActionDTO	Click here to expand... Discriminator: "@class" : "com.bmc.bcan.rest.services.v1_0.JobService$UnquarantineEndpointActionDTO" { actionNumber: integer The number of this action within the list of actions in the owning job (or in the owning action, when this is a sub-action; read-only) guid: string The GUID that identifies the type of action; read-only for canned actions; required for custom and external script actions name: string The type of action referred to by the GUID (read-only) annotation: string Notes, comments, description, explanation statusId: integer The current execution status of this action (read-only) startTimestamp: date-time When the action execution began (read-only) Example: 2017-01-31T13:45:00.000+0000 endTimestamp: date-time When the action execution completed (read-only) Example: 2017-01-31T13:45:00.000+0000 errorMessage: string Reason that a completed action failed (read-only) subactions: [ Any sub-actions generated at execution time, ordered by sub-action number (read-only) ActionDTO ] commitFlag: boolean Whether or not to commit changes after performing the unquarantine operation endpointAddress: string* The address to be unquarantined, which has previously been quarantined by the system markAsTrustedFlag: boolean Whether or not any changed configurations resulting from running this action should be marked as trusted }
UserDTO	Click here to expand... { id: string The database key name: string The user's unique display name emailAddress: string The email address of the user enabledFlag: boolean Whether or not the user account is enabled rootAccountFlag: boolean Whether or not this is a root account roleNames: [ The roles this user belongs to string ] dynamicFields: [ The dynamic fields DynamicFieldValueDTO ] }

REST API version 2.0 is deprecated as of product version 8.9.03.

Endpoints in the REST API v1.0 (deprecated)

combo_groups

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/combo_groups

Description

Parameters

Responses

{{status subtle="false" colour="Green" title="POST"/}} /v1.0/combo_groups

Parameters

Responses

{{status subtle="false" colour="Yellow" title="PUT"/}} /v1.0/combo_groups/{id}

Parameters

Responses

{{status subtle="false" colour="Red" title="DELETE"/}} /v1.0/combo_groups/{id}

Parameters

Responses

{{status subtle="false" colour="Yellow" title="PATCH"/}} /v1.0/combo_groups/{id}

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/combo_groups/{id}/devices

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/combo_groups/{nameOrKey}

Parameters

Responses

devices

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices

Description

Parameters

Responses

{{status subtle="false" colour="Green" title="POST"/}} /v1.0/devices

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}

Parameters

Responses

{{status subtle="false" colour="Yellow" title="PUT"/}} /v1.0/devices/{nameOrKey}

Parameters

Responses

{{status subtle="false" colour="Red" title="DELETE"/}} /v1.0/devices/{nameOrKey}

Parameters

Responses

{{status subtle="false" colour="Yellow" title="PATCH"/}} /v1.0/devices/{nameOrKey}

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/configurations/{cfgKey}

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/configurations/{cfgKey}/binaryData

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/configurations/{cfgKey}/data

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/configurations/{trailGuid}

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/current_configurations

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/status

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/status/{actionGuid}/transcript

Parameters

Responses

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/devices/{nameOrKey}/trusted_configurations

Parameters

Responses

groups

{{status subtle="false" colour="Blue" title="GET"/}} /v1.0/groups

Description

Parameters

Responses

{{status subtle="false" colour="Green" title="POST"/}} /v1.0/groups

Parameters

Responses

{{status subtle="false" colour="Yellow" title="PUT"/}} /v1.0/groups/{id}

Parameters

Responses

{{status subtle="false" colour="Red" title="DELETE"/}} /v1.0/groups/{id}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/combo_groups

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/combo_groups/{id}

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/combo_groups/{id}

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/combo_groups/{id}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups/{id}/devices

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/combo_groups/{nameOrKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/devices

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/devices/{nameOrKey}

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/devices/{nameOrKey}

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/devices/{nameOrKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}/binaryData

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{cfgKey}/data

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/configurations/{trailGuid}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/current_configurations

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/status

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/status/{actionGuid}/transcript

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/devices/{nameOrKey}/trusted_configurations

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/groups

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/groups/{id}

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/groups/{id}

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/groups/{id}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups/{id}/devices

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/groups/{id}/devices/{deviceId}

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/groups/{id}/devices/{deviceId}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/groups/{nameOrKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}

{{status subtle="false" colour="Yellow" title="PUT"/}}

/v1.0/jobs/{jobIdOrKey}

{{status subtle="false" colour="Red" title="DELETE"/}}

/v1.0/jobs/{jobIdOrKey}

{{status subtle="false" colour="Yellow" title="PATCH"/}}

/v1.0/jobs/{jobIdOrKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/action_results/{actionNumber}

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/approval

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/cancellation

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/desubmission

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results/{resultKey}

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/jobs/{jobIdOrKey}/device_results/{resultKey}/transcript

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/rejection

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/jobs/{jobIdOrKey}/submission

{{status subtle="false" colour="Blue" title="GET"/}}

/v1.0/realms

{{status subtle="false" colour="Green" title="POST"/}}

/v1.0/realms