Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph.security
Observação
As APIs de Inteligência contra Ameaças da Microsoft estão disponíveis para todos os clientes com uma licença do Microsoft Defender XDR ou do Microsoft Sentinel. Nenhuma licença separada é necessária para acessar essas APIs.
Representa um par de hosts pai-filho nos quais o host filho pode ser acessado por meio do host pai. Por exemplo, se contoso.com redireciona para microsoft.com, contoso.com representa o host pai e microsoft.com o host filho.
Relações de pares de hosts compartilhadas em um ponto anterior ou que compartilham atualmente uma conexão observada em um rastreamento da Microsoft. Um host pai leva ao host filho talvez por meio de um redirecionamento de nível superior simples (HTTP 302) ou algo mais complexo, como um iframe ou referência de origem de script. Em outros casos, um rastreamento da Web pode revelar comportamentos estranhos, como relacionamentos de pares de hosts entre endereços IP e domínios/hosts que vão contra os padrões DNS.
A propriedade linkKind observa o motivo para identificar os hosts como um par pai-filho. Um exemplo disso pode ser redirect.
Para obter mais informações sobre pares de hosts, consulte a documentação da Inteligência contra Informações sobre Ameaças do Microsoft Defender para conjuntos de dados.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Get | microsoft.graph.security.hostPair | Leia as propriedades e relações de um objeto hostPair . |
| Lista para um host | Coleção microsoft.graph.security.hostPair | Obtenha uma lista de objetos hostPair associados a um host especificado, onde o host é o pai ou o filho. |
| Listar para um host como filho | Coleção microsoft.graph.security.hostPair | Obtenha uma lista de objetos hostPair associados a um host, onde esse host é o filho e tem um emparelhamento de entrada com um pai. |
| Lista de um host como pai | Coleção microsoft.graph.security.hostPair | Obtenha uma lista de objetos hostPair associados a um host, onde esse host é o pai e tem um emparelhamento de saída com um filho. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| firstSeenDateTime | DateTimeOffset | A data e a hora em que a Inteligência contra Informações sobre Ameaças do Microsoft Defender observou o hostPair pela primeira vez. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| id | Cadeia de caracteres | Uma ID gerada pelo sistema para o hostPair. |
| lastSeenDateTime | DateTimeOffset | A data e a hora em que a Inteligência contra Informações sobre Ameaças do Microsoft Defender observou o hostPair pela última vez. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. |
| linkKind | Cadeia de caracteres | O motivo pelo qual dois hosts são identificados como hostPair. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| childHost | Microsoft.Graph.Security.Host | Host alcançado por meio do parentHost. |
| parentHost | Microsoft.Graph.Security.Host | Host usado para acessar o childHost. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.security.hostPair",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastSeenDateTime": "String (timestamp)",
"linkKind": "String"
}