application#

Autogenerated API

argus_api.lib.assets.v1.application.add_host_application(hostID: str = None, roleID: int = None, name: str = None, description: str = None, properties: dict = None, source: str = None, cpe: str = None, sockets: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Creates a new HostApplication. (PUBLIC)

Parameters

  • hostID (str) – Specify parent host.

  • roleID (int) – Specify application role.

  • name (str) – Name of application. => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • description (str) – Description of application. => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • properties (dict) – Custom user-defined properties. => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • source (str) – Source of the request. (default USER)

  • cpe (str) – CPE of application.

  • sockets (list) – Specify socket strings of the application.

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

dictionary translated from JSON

argus_api.lib.assets.v1.application.delete_host_application(id: str, source: str = 'USER', json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Marks a HostApplication as deleted. (PUBLIC)

Parameters

  • id (str) – HostApplication ID

  • source (str) – Request source (default USER)

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

dictionary translated from JSON

argus_api.lib.assets.v1.application.get_host_application(id: str, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Returns a HostApplication identified by its ID. (PUBLIC)

Parameters

  • id (str) – HostApplication ID

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

dictionary translated from JSON

argus_api.lib.assets.v1.application.search_host_application_statistics(name: str = None, keywords: str = None, keywordMatchStrategy: str = None, timeMatchStrategy: str = None, hostID: str = None, serviceID: str = None, businessProcessID: str = None, ipRange: str = None, applicationPort: int = None, applicationProtocol: str = None, cpe: str = None, hostCPE: str = None, applicationCPE: str = None, countTimeout: int = None, limit: int = None, offset: int = None, includeDeleted: bool = None, subCriteria: dict = None, exclude: bool = None, required: bool = None, customerID: int = None, startTimestamp: str = None, endTimestamp: str = None, applicationRole: int = None, timeFieldStrategy: str = None, keywordFieldStrategy: str = None, groupBy: str = None, values: str = None, resolution: int = None, cutoff: int = None, cutoffValue: str = None, includeOthers: bool = None, sortBy: str = None, includeFlags: str = None, excludeFlags: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Fetch host application statistics base on criteria (PUBLIC)

Parameters

  • name (list) – Restrict search to specific asset name

  • keywords (list) – Search for keywords.

  • keywordMatchStrategy (str) – Defines the MatchStrategy for keywords (default match all keywords).

  • timeMatchStrategy (str) – Defines how strict to match against different timestamps (all/any) using start and end timestamp (default any)

  • hostID (list) – Restrict search to specific host UUIDs.

  • serviceID (list) – Restrict search to specific service UUIDs.

  • businessProcessID (list) – Restrict search to specific business process UUIDs.

  • ipRange (str) – Restrict search to entities related to these IP-addresses (may specify single IPs, IP networks or IP ranges.

  • applicationPort (list) – Restrict to applications listening on specific ports.

  • applicationProtocol (list) – Restrict to applications by transport protocol name.

  • cpe (str) – Restrict to applications or hosts by CPE.

  • hostCPE (str) – Restrict to hosts by CPE.

  • applicationCPE (str) – Restrict to applications by CPE.

  • countTimeout (int) – Max wait in seconds for count query, if max wait passed and count query still executing the query; or -1 is set to indicate do not count, then the query will be cancelled and return count -1. Default value 0 means execute as long as service allows, -1 means do not count, max value is 30 (seconds).

  • limit (int) – Max number of results.

  • offset (int) – Skip the first (offset) objects. By default, return result from first object.

  • includeDeleted (bool) – Set to true to include deleted objects. By default, exclude deleted objects.

  • subCriteria (list) – Set additional criterias which are applied using a logical OR.

  • exclude (bool) – Only relevant for subcriteria. If set to true, objects matching this subcriteria object will be excluded.

  • required (bool) – Only relevant for subcriteria. If set to true, objects matching this subcriteria are required (AND-ed together with parent criteria).

  • customerID (list) – Restrict search to data belonging to specified customers.

  • startTimestamp (str) – Restrict search to a time frame based on the set TimeFieldStrategy (start timestamp).

  • endTimestamp (str) – Restrict search to a time frame based on the set TimeFieldStrategy (end timestamp).

  • applicationRole (list) – Search for applications by role (list of role IDs).

  • timeFieldStrategy (list) – Defines which timestamps will be included in the search (default lastUpdatedTimestamp).

  • keywordFieldStrategy (list) – Defines which fields will be searched by keywords (default all supported fields).

  • groupBy (list) – Specify which fields will be grouped by in stats

  • values (list) – Specify which values will be included in stats (default applications)

  • resolution (int) – Stats resolution period in milliseconds, if is 0 means to generate non-timeline statistics

  • cutoff (int) – Reduce stats keys to the cutoff amount of keys that has largest hit count, default 0 means no reduce

  • cutoffValue (str) – Specify which value to be cutoff on (default applications)

  • includeOthers (bool) – If reduce (cutoff >0), true means remaining keys (other than cutoff keys) are collected into an “other” key, default false

  • sortBy (list) – List of properties to sort by (prefix with “-” to sort descending).

  • includeFlags (list) – Only include objects which have includeFlags set.

  • excludeFlags (list) – Exclude objects which have excludeFlags set.

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

dictionary translated from JSON

argus_api.lib.assets.v1.application.search_host_applications(name: str = None, keywords: str = None, keywordMatchStrategy: str = None, timeMatchStrategy: str = None, hostID: str = None, serviceID: str = None, businessProcessID: str = None, ipRange: str = None, applicationPort: int = None, applicationProtocol: str = None, cpe: str = None, hostCPE: str = None, applicationCPE: str = None, countTimeout: int = None, limit: int = None, offset: int = None, includeDeleted: bool = None, subCriteria: dict = None, exclude: bool = None, required: bool = None, customerID: int = None, startTimestamp: str = None, endTimestamp: str = None, applicationRole: int = None, timeFieldStrategy: str = None, keywordFieldStrategy: str = None, sortBy: str = None, includeFlags: str = None, excludeFlags: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Returns a set of HostApplications defined by a HostApplicationSearchCriteria. (PUBLIC)

Parameters

  • name (list) – Restrict search to specific asset name

  • keywords (list) – Search for keywords.

  • keywordMatchStrategy (str) – Defines the MatchStrategy for keywords (default match all keywords).

  • timeMatchStrategy (str) – Defines how strict to match against different timestamps (all/any) using start and end timestamp (default any)

  • hostID (list) – Restrict search to specific host UUIDs.

  • serviceID (list) – Restrict search to specific service UUIDs.

  • businessProcessID (list) – Restrict search to specific business process UUIDs.

  • ipRange (str) – Restrict search to entities related to these IP-addresses (may specify single IPs, IP networks or IP ranges.

  • applicationPort (list) – Restrict to applications listening on specific ports.

  • applicationProtocol (list) – Restrict to applications by transport protocol name.

  • cpe (str) – Restrict to applications or hosts by CPE.

  • hostCPE (str) – Restrict to hosts by CPE.

  • applicationCPE (str) – Restrict to applications by CPE.

  • countTimeout (int) – Max wait in seconds for count query, if max wait passed and count query still executing the query; or -1 is set to indicate do not count, then the query will be cancelled and return count -1. Default value 0 means execute as long as service allows, -1 means do not count, max value is 30 (seconds).

  • limit (int) – Max number of results.

  • offset (int) – Skip the first (offset) objects. By default, return result from first object.

  • includeDeleted (bool) – Set to true to include deleted objects. By default, exclude deleted objects.

  • subCriteria (list) – Set additional criterias which are applied using a logical OR.

  • exclude (bool) – Only relevant for subcriteria. If set to true, objects matching this subcriteria object will be excluded.

  • required (bool) – Only relevant for subcriteria. If set to true, objects matching this subcriteria are required (AND-ed together with parent criteria).

  • customerID (list) – Restrict search to data belonging to specified customers.

  • startTimestamp (str) – Restrict search to a time frame based on the set TimeFieldStrategy (start timestamp).

  • endTimestamp (str) – Restrict search to a time frame based on the set TimeFieldStrategy (end timestamp).

  • applicationRole (list) – Search for applications by role (list of role IDs).

  • timeFieldStrategy (list) – Defines which timestamps will be included in the search (default lastUpdatedTimestamp).

  • keywordFieldStrategy (list) – Defines which fields will be searched by keywords (default all supported fields).

  • sortBy (list) – List of properties to sort by (prefix with “-” to sort descending).

  • includeFlags (list) – Only include objects which have includeFlags set.

  • excludeFlags (list) – Exclude objects which have excludeFlags set.

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

requests.Response object or dictionary translated from JSON

argus_api.lib.assets.v1.application.search_host_applications_simplified(keywords: str = None, keywordField: str = None, name: str = None, hostID: str = None, serviceID: str = None, businessProcessID: str = None, customerID: int = None, ip: str = None, port: int = None, protocol: str = None, cpe: str = None, includeFlag: str = None, excludeFlag: str = None, sortBy: str = None, countTimeout: int = None, limit: int = 25, keywordMatch: str = 'all', offset: int = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Returns a set of HostApplications defined by query parameters. (PUBLIC)

Parameters

  • keywords (list) – Search by keywords

  • keywordField (list) – Set field strategy for keyword search

  • name (list) – Search by name

  • hostID (list) – Search by HostAsset ID

  • serviceID (list) – Search by ServiceAsset ID

  • businessProcessID (list) – Search by BusinessProcess ID

  • customerID (list) – Search by customer ID

  • ip (list) – Search by IP range

  • port (list) – Search by application port

  • protocol (list) – Search by application protocol

  • cpe (list) – Search by CPE

  • includeFlag (list) – Include certain HostApplications in the search result based on set flags

  • excludeFlag (list) – Exclude certain HostApplications from the search result based on set flags

  • sortBy (list) – Sort search result

  • countTimeout (int) – Max wait in seconds for count query. Value 0 means execute as long as service allows, -1 means do not count, max value is 30 (seconds).

  • limit (int) – Maximum number of returned results

  • keywordMatch (str) – Set match strategy for keyword search

  • offset (int) – Skip a number of results

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

requests.Response object or dictionary translated from JSON

argus_api.lib.assets.v1.application.update_host_application(id: str, roleID: int = None, name: str = None, description: str = None, addProperties: dict = None, deleteProperties: str = None, source: str = None, cpe: str = None, addSockets: str = None, deleteSockets: str = None, json: bool = True, verify: Optional[bool] = None, proxies: Optional[dict] = None, apiKey: Optional[str] = None, authentication: Optional[dict] = None, server_url: Optional[str] = None, body: Optional[dict] = None, api_session: Optional[ArgusAPISession] = None) → dict#

Updates an existing HostApplication. (PUBLIC)

Parameters

  • id (str) – HostApplication ID

  • roleID (int) – Change application role.

  • name (str) – Change application name. => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • description (str) – Change application description. => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • addProperties (dict) – Add properties to application (updates a property if key already exists). => [sw\{\}\$\-\(\).\[\]”'_/\,\*\+\#:@!?;=]*

  • deleteProperties (list) – Remove properties from application by key.

  • source (str) – Source of the request. (default USER)

  • cpe (str) – Change application CPE.

  • addSockets (list) – Add sockets to application (list of protocol/port, e.g. tcp/80).

  • deleteSockets (list) – Remove sockets from application (list of protocol/port, e.g. tcp/80).

  • json – return the response’s body as a dict parsed from json. True by default. If set to false, the raw requests.Response object will be returned.

  • verify – path to a certificate bundle or boolean indicating whether SSL verification should be performed.

  • apiKey – Argus API key.

  • authentication – authentication override

  • server_url – API base URL override

  • body – body of the request. other parameters will override keys defined in the body.

  • api_session – session to use for this request. If not set, the global session will be used.

Raises
Returns

dictionary translated from JSON