This documentation supports the 20.02 (12.0) version of BMC Discovery.To view an earlier version of the product, select the version from the Product version menu.

DataSourceAccess node

Each time an data source is discovered, a DataSourceAccess node is created. It has relationships to the retrieved discovery information. DataSourceAccess nodes are created even if discovery fails, so that failed access is clearly identified in the model.

The endpoint attribute of a DataSourceAccess node describes the target used for discovery. The target for discovery is currently an IP v4 or IP v6 address.

DataSourceAccess Lifecycle

The following section describes the scenarios in which a DataSourceAccess is created or destroyed. DDD nodes are never updated.

Creation

A DataSourceAccess node is created when a data source pattern is triggered as part of discovery.

Removal

Aging parameters exist for Directly Discovered Data Nodes which have a particular cut-off time. The Aging process will remove any DataSourceAccess Nodes and all of the other DDD Nodes associated with that node if this default time period is exceeded.

However, if the DataSourceAccess Node is the only one for an endpoint, then it is not removed, unless it is considered dark space. This enables BMC Discovery to keep a permanent record of every endpoint that has ever been scanned. These DataSourceAccess Nodes are the only ones which can exceed the default cut-off Aging process. 

The cut-off time is configurable, see DDD removal for more information.

DataSourceAccess node attributes

The attributes of a DataSourceAccess node are as described in the following table:

UI Name
Attribute Name and Type

Description

Data Source Name
name string

Data source name

Range Prefix
range_prefix string

Distinguish overlapping address spaces

Endpoint
endpoint string

Accessed endpoint

Database Name
database string

Database name

Port
port int

Port number

Start Time
starttime date

Date and time this data source access was created

Discovery Start Time
discovery_starttime date

Date and time access started

Failure Reason
reason string

Reason for failure, if any

Not displayed in UI
consolidation_done _list:string

List of the consolidation appliance identifiers this has been be sent to

Retrieved by scanning appliance
is_consolidation boolean

If present, always have the value True and indicates that the data for this DataSourceAccess originated from a scanning appliance before being consolidated on this one

DataSourceAccess node relationships

The relationships of a DataSourceAccess node are as described in the following table:

Destination

Relationship

Description

Directories

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DirectoryListing

Directory Listing.

API Call Results

DiscoveryAccess:
DiscoveryAccessResult:DiscoveryResult:DiscoveredAPIResult

API call results.

API Call Result Lists

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredAPIResultList

API call result lists.

Cloud API Call Result Lists

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCloudAPIResultList

Cloud API call result lists.

Command Results

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredCommandResult

Command results.

Files

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredFile

Files.

Mainframe View Results

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredMainframeViewResultList

Mainframe View Results.

Registry Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredRegistryValue

Registry Queries.

SNMP Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSNMP

SNMP Query.

SNMP Table Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSNMPTable

SNMP Table Query.

SQL Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredSQLQuery

SQL Queries.

WBEM Associators

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMAssociators

WBEM Associators.

WBEM Instances

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMEnumInstances

WBEM Instances.

WBEM Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWBEMQuery

WBEM Queries.

WMI Queries

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
DiscoveredWMIQuery

WMI Queries.

Registry Keys

DiscoveryAccess:
DiscoveryAccessResult:
DiscoveryResult:
RegistryListing

Registry Keys.

Discovery Run

Member:
List:
List:
DiscoveryRun

Discovery Run.

Not displayed in UI

DiscoveryAccess:
Metadata:
Detail:
SessionResult

Session details.

Session Log

ItemWithLog:
Log:
Log:
SessionLog

Session log.

 

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