title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
List childHostPairs |
Get the list of hostPair resources associated with a host, where that host is the parent and has an outgoing pairing to a child. |
jakedavies-microsoft |
medium |
security |
apiPageType |
Namespace: microsoft.graph.security
[!INCLUDE beta-disclaimer]
[!INCLUDE threatintelligence-api-disclaimer]
Get the list of hostPair resources associated with a specified host, where that host is the parent and has an outgoing pairing to a child.
[!INCLUDE national-cloud-support]
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
GET /security/threatIntelligence/hosts/{hostId}/childHostPairs
This method supports $count
, $filter
, $orderby
, $select
, $skip
, and $top
OData query parameters to help customize the response. For general information, see OData query parameters.
The following properties can be used for $filter
calls.
Property | Example | Notes |
---|---|---|
All hostPair properties | $filter=(linkKind eq 'redirect') |
Use the name as it appears in the hostPair resource. |
childHost/id | $filter=(childHost/id eq 'contoso.com') |
Full path is requried for $filter usage. |
parentHost/id | $filter=(parentHost/id in ('contoso.com','downstream.consoso.com')) |
Full path is required for $filter usage. |
The following properties can be used for $orderby
calls.
Property | Example |
---|---|
firstSeenDateTime | $orderby=firstSeenDateTime desc |
lastSeenDateTime | $orderby=lastSeenDateTime asc |
The following properties can be used for $select
calls.
Property | Example | Notes |
---|---|---|
All hostPair properties | $select=id,firstSeenDateTime |
Use the name as it appears in the hostPair resource. |
parentHost | $select=parentHost |
Does not support selecting on nested properties (for example parentHost/id ). |
childHost | $select=childHost |
Does not support selecting on nested properties (for example childHost/id ). |
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and a collection of microsoft.graph.security.hostPair objects in the response body.
The following example shows a request.
GET https://graph.microsoft.com/beta/security/threatIntelligence/hosts/contoso.com/childHostPairs
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.security.hostPair",
"id": "ZmluYWxSZWRpcmVjdCQkY29udG9zby5jb20kJGNvbnRvc28uY29tJCRjb250b3NvLmNvbQ==",
"firstSeenDateTime": "2022-05-11T01:27:14.187Z",
"lastSeenDateTime": "2023-06-23T06:33:31.493Z",
"linkKind": "finalRedirect",
"parentHost": {
"id": "microsoft.com"
},
"childHost": {
"id": "contoso.com"
}
}
]
}