v4.0 Configuration Export Tasks API


TrueSight Network Automation REST API – ConfigurationExportTaskService
The base URL for the API is:

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

configuration_export_tasks

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

 /v4.0/configuration_export_tasks
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

orderBy

query

Sort by the specified attribute (enabledFlag, executionStatus, lastExecutedTimestamp, name, recurring, or schedule) in the specified order (prefix with a '+' for ascending or a '-' for descending)

"+name"

string
Enum: [
  "+enabledFlag",
  "-enabledFlag",
  "+executionStatus",
  "-executionStatus",
  "+lastExecutedTimestamp",
  "-lastExecutedTimestamp",
  "+name",
  "-name",
  "+recurring",
  "-recurring",
  "+schedule",
  "-schedule"
]

offset

query

Return the specified page number

1

integer

limit

query

Define the number of rows in a page or the maximum number of configuration export tasks to return

25

integer

Authorization

header

Authorization token formatted as 'Bearer [token]'


String*

Responses

Code

Description

Schema

200

successful operation

401

Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to access configuration export tasks


500

Internal server error: Unexpected exception occurred


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

 /v4.0/configuration_export_tasks
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

body

body

Complete attributes of the new configuration export task


Authorization

header

Authorization token formatted as 'Bearer [token]'


string*

Responses

Code

Description

Schema

201

Created: New configuration export task successfully added


400

Bad request: Input configuration export task DTO is missing or new configuration export task is invalid


401

Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to add a new configuration export task


500

Internal server error: Unexpected exception occurred


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

 /v4.0/configuration_export_tasks/{nameOrKey
}
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

nameOrKey

path

Name or database key of the configuration export task


string*

Authorization

header

Authorization token formatted as 'Bearer [token]'


String*

Responses

Code

Description

Schema

200

successful operation

401

Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to access configuration export tasks


404

Not found: No single matching accessible configuration export task found


500

Internal server error: Unexpected exception occurred


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

 /v4.0/configuration_export_tasks/{nameOrKey
}
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

nameOrKey

path

Name or database key of the configuration export task to be modified


string*

body

body

Complete new attribute values for the configuration export task; anything left out will be considered to be null and will be nulled out in the configuration export task


Authorization

header

Authorization token formatted as 'Bearer [token]'


string*

Responses

Code

Description

Schema

200

successful operation

400

Bad request: Input configuration export task DTO is missing or modified configuration export task is invalid


401

Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to modify the configuration export task


404

Not found: No single matching accessible configuration export task found


500

Internal server error: Unexpected exception occurred


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

 /v4.0/configuration_export_tasks/{nameOrKey
}
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

nameOrKey

path

Name or database key of the configuration export task to be deleted


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 accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to delete the configuration export task


404

Not found: No single matching accessible configuration export task found


500

Internal server error: Unexpected exception occurred


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

 /v4.0/configuration_export_tasks/{nameOrKey}/results
Click here to expand...


Parameters

Name

Located in

Description

Default

Schema

nameOrKey

path

Name or database key of the configuration export task of interest


string*

filter.status

query

Filter for individual results with this execution status


integer

orderBy

query

Sort by the specified attribute (name, message, or status) in the specified order (prefix with a '+' for ascending or a '-' for descending)

"+status"

string
Enum: [
  "+name",
  "-name",
  "+message",
  "-message",
  "+status",
  "-status"
]

offset

query

Return the specified page number

1

integer

limit

query

Define the number of rows in a page or the maximum number of individual configuration export results to return

25

integer

Authorization

header

Authorization token formatted as 'Bearer [token]'


string*

Responses

Code

Description

Schema

200

successful operation

401

Unauthorized: Failed to provide a suitable Authorization header or accessToken cookie, or the specified user is not logged in


403

Forbidden: Not allowed to access configuration export tasks


404

Not found: No single matching accessible configuration export task found, or no execution results are currently present in the task


500

Internal server error: Unexpected exception occurred



Object Definitions

Object

Schema

ComboGroupFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    nameMatch: string
    Search for combo groups whose name matches this wildcard-enabled string
 
    realmName: string
    Search for combo groups that belong to this exact realm
}

ComponentFilterDTO


Click here to expand...

Subclasses:
TemplateFilterDTO
OsImageFilterDTO
DeviceFilterDTO
PredefinedJobFilterDTO
RuleSetFilterDTO
JobFilterDTO
RuleFilterDTO
ComboGroupFilterDTO
GroupFilterDTO

{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
}

ComponentId


Click here to expand...


{
    id: string
    The database key of the component; an incoming component can be identified either by its database key, or by its unique name, or by its name with qualifiers which are unique when combined; when this database key is present, it takes precedence and componentName and qualifiers(when present) are used to verify the retrieved component
 
    componentName: string
    The name of the component; an incoming component can be identified either by its database key, or by its unique name, or by its name with qualifiers which are unique when combined; this name is used to verify any component retrieved by database key, and is used if there is no database key or if the database key fails to resolve; for componentType Configuration and HardwareInventory, componentName is the created timestamp (in milliseconds); for componentType SecurityVulnerability, componentName is the securityVulnerabilityID; for componentType SnmpManagerStation, componentName is the address
 
    componentType: string*
    The type of the component, used to verify what is retrieved by key/name; valid values are: Combogroup, Condition, Configuration, Device, DeviceAdapter, DeviceAgent, DeviceSecurityProfile DynamicField, EmailDistributionList, Group, HardwareInventory, JobApprovalType, Keyword, Model, OsImage, PredefinedJob, Realm, RemoteFileServer, Role, Rule, RuleSet, SecurityVulnerability, SnmpManagerStation, Template, and User
 
    qualifiers: {
      Any additional single qualifier needed to identify the component uniquely, when the name alone is not sufficient; the map key is the extra attribute name string; the map value string completes the identification of the component; for componentType Configuration and HardwareInventory: key=deviceKey, value=database key of the device the item belongs to, key=deviceName, value=name of the device the item belongs to, key=timestamp, value=creation date/time in server display format; for componentType DeviceAdapter: key=adapterType, value=type of the device adapter, key=parent, value=parent or owner used for organizing certain types of adapters, key=vendorName, value=name of the vendor that owns a device type; for componentType DynamicField: key=type, value=base class name of the component associated with the dynamic field; for componentType Group, ComboGroup: key=realmName, value=name of the realm the group belongs to; for componentType Model: key=vendorGuid, value=the vendor GUID; for componentType OsImage: key=filename, value=name of the file(s) making up the image; for componentType SecurityVulnerability: key=vendorGuid, value=the vendor GUID
    }
}

ConfigurationExportTaskDTO


Click here to expand...


{
    id: string
    The unique database key of the task (read-only)
 
    name: string*
    The unique display name of the task
 
    annotation: string
    Notes, comments, description, explanation
 
    autoPurgeFlag: boolean
    Whether or not the task is automatically deleted when it is non-recurring and its execution date/time has passed
 
    enabledFlag: boolean
    Whether or not the task is enabled for execution
 
    executionSchedule: ImportExportTaskScheduleDTO*
    When the task is scheduled to execute
 
    executionStatus: string
    Information about the most recent execution of the task (read-only)
 
    lastExecutedTimestamp: date-time
    When this task most recently completed executing (read-only)
     Example: 2017-01-31T13:45:00.000+0000
 
    schedule: string
    A readable representation of the task's schedule (read-only)
 
    canCopyFlag: boolean
    Whether or not the user is allowed to copy this task (read-only)
 
    canDeleteFlag: boolean
    Whether or not the user is allowed to delete this task (read-only)
 
    canEditFlag: boolean
    Whether or not the user is allowed to edit this task (read-only)
 
    destinationDirectory: string*
    The directory where the exported configurations are written
 
    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 export; ignored when the selected network span is a single device
 
    exportedResultFilenamePattern: string*
    How the resulting files are named
 
    historicalCfgAsOf: date-time
    When the scriptTypeId selects a configuration active on a date/time, specifies the date/time; when the timestamp is missing the timezone, the server local timezone is assumed
     Example: 2017-01-31T13:45:00.000+0000
 
    localServerFlag: boolean
    Whether or not the configurations are written to files residing locally; when true, files are written to the destination directory on the server's file system; when false, files are written to a the remote file server using SCP
 
    networkSpan: ComponentId*
    Which devices are to have their configurations exported
 
    onlyCfgsChangedSinceLastExportFlag: boolean
    Whether or not to export only changed configurations; when true, exports only configurations changed since the last time this export task was run; when false, exports all configurations
 
    overwriteExistingFilesFlag: boolean
    Whether or not to over-write existing files by the same name; when true, any existing files are over-written; when false, existing files are preserved and devices are flagged as skipped; applicable only when exporting to the local file system; must be set to true when exporting to a remote server
 
    realmId: ComponentId
   Realm associated with the network span (read-only)
 
    remoteHostname: string
    When exporting to a remote server, the IP address or host name of the server
 
    remotePassword: string
    Password for logging in to the remote server
 
    remotePasswordEncryptedFlag: boolean
    Whether or not the remotePassword value is encrypted; when false, remotePassword is in clear text
 
    remoteSshPort: integer
    SSH port number on the remote server
 
    remoteUsername: string
    Username for logging in to the remote server
 
    scriptTypeId: integer*
    Which configuration is exported
 
    scriptTypeName: string
    The meaning of the numeric scriptTypeId (read-only)
 
    whichTrailId: ComponentId
   When the selected configuration is Other Current or Other Historical, which trail is exported
 
    zippedExportedFilename: string
    When zipping up the exported files, the name of the zip file
 
    zippedFlag: boolean
    Whether or not the exported files are combined into a zip archive
}

DeviceFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    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: TimePeriodDTO
   Search for devices created within this time period
 
    defaultDeviceAgentNICFlag: boolean
    Whether or not to search for devices whose interface is set to use the default NIC of its selected device agent; when true, the deviceAgentNICName field is ignored
 
    deviceAgentName: string
    Search for devices whose device agent equals this name
 
    deviceAgentNICName: string
    Search for devices whose NIC equals this name, within the device agent specified by the deviceAgentName field; to search for devices using the "(Default)" NIC, use the defaultDeviceAgentNICFlag field instead
 
    deviceSecurityProfileName: string
    Search for devices whose device security profile equals this name
 
    deviceTypeId: ComponentId
   Search for devices whose device type equals this device type
 
    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, NIC, 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, NIC, and device security profile)
 
    groupName: string
    Search for devices that belong to this group in the realm specified by realmName
 
    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 or secondary 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
 
    realmName: string
    Search for devices that belong to this exact realm
 
    securityContextTypeId: integer
    Search for devices set to this type of security context
 
    transferModeId: integer
    Search for devices with this file transfer mode
 
    vendorId: ComponentId
   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
 
    includedViolationTrailIds: [
      Include devices in the results that have a compliance violation in one of these trails
 
       ComponentId
   ]
 
    excludedViolationTrailIds: [
      Exclude devices from the results that have a compliance violation in one of these trails
 
       ComponentId
   ]
 
    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: TimePeriodDTO
   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
}

DynamicFieldFilterDTO


Click here to expand...


{
    dynamicField: ComponentId*
    The dynamic field whose value is being searched for
 
    value: string*
    The filter string (the value to be matched); if this value is null or empty, no filtering is done on the specified dynamic field; menu-type dynamic fields support only exact matching; the filter string must be formatted properly when the dynamic field is a Date or Integer type
}

GroupFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    nameMatch: string
    Search for groups whose name matches this wildcard-enabled string
 
    realmName: string
    Search for groups that belong to this exact realm
 
    showAutoGroupsFlag: boolean
    Whether or not to include auto-groups in the results
 
    showSimpleGroupsFlag: boolean
    Whether or not to include manually-created groups in the results
 
    showEmptyAutoGroupsFlag: boolean
    Whether or not to include empty auto-groups in the results
}

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
}

ImportExportTaskResultsDTO


Click here to expand...


{
    lastExecutionCompletedTimestamp: date-time
    When the task's last execution was completed
     Example: 2017-01-31T13:45:00.000+0000
 
    lastExecutionStartedTimestamp: date-time
    When the task's last execution was started
     Example: 2017-01-31T13:45:00.000+0000
 
    lastExecutionStatus: string
    Overall status of the task's last execution
 
    overallErrorMessage: string
    If the execution failed, the overall error message
 
    perComponentResults: [
      Status of importing or exporting each individual component
 
       IndividualImportExportResultDTO
   ]
}

ImportExportTaskScheduleDTO


Click here to expand...


{
    dayOfMonth: integer
    When the task is set for monthly execution, the day of the month the task runs
 
    executionHour: integer
    The hour of the day the task runs
 
    executionMinute: integer
    The minute within the hour the task runs
 
    executionDays: [
      When the task is set for weekly execution, days of the week the task runs
 
      integer
    ]
 
    executionTimestamp: date-time
    When the task is set for a single execution, the exact date/time the task runs; when the timestamp is missing the timezone, the server local timezone is assumed
     Example: 2017-01-31T13:45:00.000+0000
 
    repeatTypeId: integer
    How often the task runs
 
    repeatTypeName: string
    The meaning of the numeric repeatTypeId (read-only)
}

IndividualImportExportResultDTO


Click here to expand...


{
    name: string
    The name of the component
 
    message: string
    More details about the status; that is, the exact error message for a failure, the reason for a skip, or the specific action taken on a success
 
    statusId: integer
    Specific action taken on the component during the import or export
 
    statusName: string
    The meaning of the numeric statusId
}

JobFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    actionGuids: [
      Search for jobs that include one of these actions
 
      string
    ]
 
    changeIdMatch: string
    Search for jobs whose change ID matches this wildcard-enabled string
 
    creationTime: TimePeriodDTO
   Search for jobs whose creation date/time falls within this date/time range
 
    editorNameMatch: string
    Search for jobs with a creator or an editor matching this wildcard-enabled string
 
    jobIdMatch: string
    Search for jobs whose job ID matches this wildcard-enabled string
 
    jobApprovalModeId: integer
    Search for jobs with this job approval mode
 
    jobApprovalTypeName: string
    Search for jobs whose job approval type matches this exact name
 
    networkSpanNameMatch: string
    Search for jobs that have actions acting on a network span whose name matches this wildcard-enabled string
 
    originatorMatch: string
    Search for jobs whose originator matches this wildcard-enabled string
 
    originatorTypeId: integer
    Search for jobs with this type of originator
 
    preparedFromPredefinedJobNameMatch: string
    Search for jobs which were prepared from a predefined job whose name matches this wildcard-enabled string
 
    reconciliationStatusId: integer
    Search for jobs with this reconciliation status
 
    showOnlyJobsICanApproveFlag: boolean
    When searching for jobs with status "waiting for approval", whether or not to only include jobs that the user for this session can approve
 
    statusIds: [
      Search for jobs whose current status matches one of these statuses
 
      integer
    ]
 
    taskIdMatch: string
    Search for jobs whose task ID matches this wildcard-enabled string
}

OsImageFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    deviceTypeId: ComponentId
   Search for OS images associated with this device type
 
    fileNameMatch: string
    Search for OS images with filenames that match this wildcard-enabled string
 
    modelNameMatch: string
    Search for OS images associated with a model whose name matches this wildcard-enabled string
 
    nameMatch: string
    Search for OS images whose name matches this wildcard-enabled string
 
    vendorId: ComponentId
   Search for OS images whose device type belongs to this vendor
}

PredefinedJobFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    actionGuids: [
      Search for predefined jobs that include one of these actions
 
      string
    ]
 
    nameMatch: string
    Search for predefined jobs whose name matches this wildcard-enabled string
 
    networkSpanNameMatch: string
    Search for predefined jobs that have actions acting on a network span whose name matches this wildcard-enabled string
}

RuleFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    activationTimePeriod: TimePeriodDTO
   Search for rules whose activation date/time falls within this date/time range
 
    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: TimePeriodDTO
   Search for rules whose deactivation date/time falls within this date/time range
 
    deviceTypeId: ComponentId
   Search for rules associated 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
 
    includeNonCorrectableRulesFlag: boolean
    Search for rules that cannot be corrected (that is, a rule that has no corrective actions, is in a disabled rule set, is not currently activated, or has a grammar whose violation cannot be automatically corrected); when all include*Flag values are false, then filtering based on correctability is skipped; note using the include*Flags is not allowed in jobs or predefined jobs
 
    includeRulesCorrectableViaDeployToActiveFlag: boolean
    Search for rules that can be corrected by running a Deploy to Active action; when all include*Flag values are false, then filtering based on correctability is skipped; note using the include*Flags is not allowed in jobs or predefined jobs
 
    includeRulesCorrectableViaDeployToStoredFlag: boolean
    Search for rules that can be corrected by running a Deploy to Stored action; when all include*Flag values are false, then filtering based on correctability is skipped; note using the include*Flags is not allowed in jobs or predefined jobs
 
    includeRulesCorrectableViaRemediateFlag: boolean
    Search for rules that can be corrected by running a Remediate action; when all include*Flag values are false, then filtering based on correctability is skipped; note using the include*Flags is not allowed in jobs or predefined jobs
 
    isNullSecurityVulnerabilityFlag: boolean
    Whether or not to search for rules that have no associated security vulnerability; when true, search only for such rules; when false or null, do not filter on associated security vulnerability; this flag cannot be used and must be null when this filter is used in a job, predefined job, policy, or view
 
    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
    ]
 
    vendorId: ComponentId
   Search for rules whose device type belongs to this vendor
}

RuleSetFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    nameMatch: string
    Search for rule sets whose name matches this wildcard-enabled string
 
    enabledFlag: boolean
    Search for rule sets that are enabled (true) or disabled (false); null means do not filter on the enabled/disabled state
}

TemplateFilterDTO


Click here to expand...


{
    dynamicFieldFilters: [
      Any filters on dynamic fields
 
       DynamicFieldFilterDTO
   ]
 
    containsUnresolvableDynamicFieldFiltersFlag: boolean
    Indicates that one or more of the dynamic fields being filtered on no longer exists and thus re-using this filter may not result in the same outcome (read-only)
 
    containerBlueprintName: string
    Search for templates referenced by this exact container blueprint
 
    contentsMatch: string
    Search for templates whose content matches this wildcard-enabled string
 
    deviceTypeId: ComponentId
   Search for templates associated with this device type
 
    nameMatch: string
    Search for templates whose name matches this wildcard-enabled string
 
    vendorId: ComponentId
   Search for templates whose device type belongs to this vendor
}

TimePeriodDTO


Click here to expand...


{
    timePeriodTypeId: integer*
    What sort of time period this is
 
    timePeriodTypeName: string
    The meaning of the numeric timePeriodTypeId (read-only)
 
    startTimestamp: date-time
    The start date/time. Required only for certain user-defined time period types of After and Range; when the timestamp is missing the timezone, the server local timezone is assumed
     Example: 2017-01-31T13:45:00.000+0000
 
    endTimestamp: date-time
    The end date/time. Required only for certain user-defined time period types of Before and Range; when the timestamp is missing the timezone, the server local timezone is assumed
     Example: 2017-01-31T13:45:00.000+0000
}

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Network Automation 22.1