GET /config/event_sources/log_source_management/log_source_types

Retrieves a list of log source types.

Table 1. GET /config/event_sources/log_source_management/log_source_types resource details
MIME Type

application/json

Table 2. GET /config/event_sources/log_source_management/log_source_types request parameter details
Parameter Type Optionality Data Type MIME Type Description

Range

header

Optional

String

text/plain

Optional - Use this parameter to restrict the number of elements that are returned in the list to a specified range. The list is indexed starting at zero.

fields

query

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

filter

query

Optional

String

text/plain

Optional - This parameter is used to restrict the elements in a list base on the contents of various fields.

Table 3. GET /config/event_sources/log_source_management/log_source_types response codes
HTTP Response Code Unique Code Description

200

The log source types were retrieved successfully.

500

1020

An error occurred during the attempt to retrieve the log source types.

Response Description

The list of all log source types. A log source type contains the following fields:
  • id - Integer - The ID of the log source type.
  • name - String - The unique name of the log source type. The name is not localized.
  • internal - Boolean - The condition is set to 'true' if the log source type is an internal log source type (for example, System Notification, SIM Audit, Asset Profiler, and so on) for which log sources cannot be created, edited, or deleted. If this is a user configurable log source type, the condition is set to 'false'.
  • custom - Boolean - The condition is set to 'true' if this is a custom log source type; otherwise, the condition is set to 'false'.
  • protocol_types - Array - The full list of supported protocol types for the log source type. Ensure that every log source type links to at least one protocol type. Each item in this array is a ProtocolMapping structure, defining both the ID of the protocol type and a Boolean that indicates whether the protocol is documented/fully supported for this log source type.
  • default_protocol_id - Long - The ID of the default protocol type for this log source type. The ID must correspond to an existing protocol type. See the Protocol Type API (/api/config/event_sources/log_source_management/protocol_types/).
  • log_source_extension_id - Long - The log source extension that is associated with the log source type. The ID must correspond to an existing log source extension or be set to 'null'. See the Log Source Extension API (/api/config/event_sources/log_source_management/log_source_extensions/).
  • supported_language_ids - Array - The IDs of the languages supported by this log source type. Each ID must correspond to an existing log source language. See the Log Source Language API (/api/config/event_sources/log_source_management/log_source_languages/). All non-custom log source types link to at least one language. Because languages are irrelevant for custom log source types, this field is 'null' for custom types.
  • version - String - The log source type plugin version.

Response Sample


[
    {
        "custom": true,
        "default_protocol_id": 42,
        "id": 42,
        "internal": true,
        "log_source_extension_id": 42,
        "name": "String",
        "protocol_types": [
            {
                "documented": true,
                "protocol_id": 42
            }
        ],
        "supported_language_ids": [
            42
        ],
        "version": "String"
    }
]