hostname resource type
Namespace: microsoft.graph.security
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Note
The Microsoft Graph API for Microsoft Defender Threat Intelligence requires an active Defender Threat Intelligence Portal license and API add-on license for the tenant.
Represents a named host that is (or has been) addressable over the internet. This entity acts as a grouping mechanism for related details about the host, such as the reputation, any related trackers or cookies, and so on.
You cannot retrieve this type directly. To access it, retrieve the host resource.
Inherits from host.
Methods
| Method | Return type | Description |
|---|---|---|
| List components | microsoft.graph.security.hostComponent collection | Get a list of hostComponent resources. |
| List cookies | microsoft.graph.security.hostCookie collection | Get a list of hostCookie resources. |
| List passiveDns | microsoft.graph.security.passiveDnsRecord collection | Get a list of passiveDnsRecord resources. |
| List passiveDnsReverse | microsoft.graph.security.passiveDnsRecord collection | Get a list of passiveDnsRecord resources. |
| Get reputation | microsoft.graph.security.hostReputation | Get the properties and relationships of a hostReputation object. |
| List trackers | microsoft.graph.security.hostTracker collection | Get a list of hostTracker resources. |
| Get whoisRecord | microsoft.graph.security.whoisRecord | Get the specified whoisRecord resource. |
Properties
| Property | Type | Description |
|---|---|---|
| firstSeenDateTime | DateTimeOffset | The first date and time that this host was observed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from microsoft.graph.security.host. |
| id | String | Unique identifier for the hostname. Read-only. Inherited from microsoft.graph.security.artifact. |
| lastSeenDateTime | DateTimeOffset | The most recent date and time that this host was observed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from microsoft.graph.security.host. |
| registrant | String | The company or individual who registered this hostname, from WHOIS data. |
| registrar | String | The registrar for this hostname, from WHOIS data. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| components | microsoft.graph.security.hostComponent collection | The hostComponents that are associated with this host. Inherited from host. |
| cookies | microsoft.graph.security.hostCookie collection | The hostCookies that are associated with this host. Inherited from host. |
| passiveDns | microsoft.graph.security.passiveDnsRecord collection | Passive DNS retrieval about this host. Inherited from host. |
| passiveDnsReverse | microsoft.graph.security.passiveDnsRecord collection | Reverse passive DNS retrieval about this host. Inherited from host. |
| reputation | microsoft.graph.security.hostReputation | Represents a calculated reputation of this host. Inherited from host. |
| trackers | microsoft.graph.security.hostTracker collection | The hostTrackers that are associated with this host. Inherited from host. |
| whois | microsoft.graph.security.whoisRecord | The most recent whoisRecord for this host. Inherited from host. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.security.hostname",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastSeenDateTime": "String (timestamp)",
"registrar": "String",
"registrant": "String"
}