passiveDns を一覧表示する

[アーティクル]
06/11/2024

名前空間: microsoft.graph.security

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

注:

Microsoft Graph API for Microsoft Defender Threat Intelligence には、テナントのアクティブな Defender 脅威インテリジェンスポータルライセンスと API アドオンライセンスが必要です。

ホストに関連付けられている passiveDnsRecord リソースの一覧を取得します。

このメソッドは、指定したホストの IP アドレスをホスト名を使用してクエリを実行する前方 DNS 参照です。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	❌	❌	❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類	最小特権アクセス許可	より高い特権のアクセス許可
委任 (職場または学校のアカウント)	ThreatIntelligence.Read.All	注意事項なし。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	ThreatIntelligence.Read.All	注意事項なし。

HTTP 要求

GET /security/threatIntelligence/hosts/{hostId}/passiveDns

オプションのクエリパラメーター

このメソッドは、応答のカスタマイズに$orderBy$filter$select$count$top役立つ、および $skip OData クエリパラメーターをサポートします。一般的な情報については、「OData クエリパラメーター」を参照してください。

名前	説明
$count	`$count` は、 passiveDnsRecord オブジェクトの数の全体的なカウントを返すためにサポートされています。 `$count`は、クエリパラメーター () またはパスパラメーター (`?$count=true/$count`) としてサポートされます。
$orderby	`$orderby` では、 passiveDns リソースの一部のプロパティがサポートされています。詳細については、「 $orderbyでサポートされるプロパティ」を参照してください。
$filter	`$filter` は、この API の要求 URL に必要です。現在、API では、呼び出し内の 1 つのフィールドによるフィルター処理のみがサポートされています。詳細については、「 $filterでサポートされるプロパティ」を参照してください。
$select	`$select` は、このクエリで返されるプロパティを制限するためにサポートされています。
$skip	`$skip` は、ページ内の要素をスキップするためにサポートされています。と `$top` を組み合わせて改ページ処理を実行するか、サーバー側の改ページ処理にを `@odata.nextLink` 使用します。
$top	`$top` は、ページあたりの要素数を制限するためにサポートされています。と `$skip` を組み合わせて改ページ処理を実行するか、サーバー側の改ページ処理にを `@odata.nextLink` 使用します。

$filterでサポートされるプロパティ

呼び出しには、次のプロパティを $filter 使用できます。

プロパティ	例
recordType	`$filter=recordType eq 'A'`

$orderbyでサポートされるプロパティ

呼び出しには、次のプロパティを $orderby 使用できます。

プロパティ	例
firstSeenDateTime	`$orderby=firstSeenDateTime desc`
lastSeenDateTime	`$orderby=lastSeenDateTime desc`

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須です。認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは応答コードと、応答本文の microsoft.graph.security.passiveDnsRecord オブジェクトのコレクションを返200 OKします。

例

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/beta/security/threatIntelligence/hosts/contoso.com/passiveDns


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.ThreatIntelligence.Hosts["{host-id}"].PassiveDns.GetAsync();

重要

Microsoft Graph SDK では、既定で v1.0 バージョンの API が使用され、ベータ版で使用可能なすべての型、プロパティ、API がサポートされているわけではありません。 SDK を使用してベータ API にアクセスする方法の詳細については、「ベータ API で Microsoft Graph SDK を使用する」を参照してください。

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。



mgc-beta security threat-intelligence hosts passive-dns list --host-id {host-id}

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
passiveDns, err := graphClient.Security().ThreatIntelligence().Hosts().ByHostId("host-id").PassiveDns().Get(context.Background(), nil)

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.security.PassiveDnsRecordCollectionResponse result = graphClient.security().threatIntelligence().hosts().byHostId("{host-id}").passiveDns().get();

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


const options = {
	authProvider,
};

const client = Client.init(options);

let passiveDns = await client.api('/security/threatIntelligence/hosts/contoso.com/passiveDns')
	.version('beta')
	.get();

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->security()->threatIntelligence()->hosts()->byHostId('host-id')->passiveDns()->get()->wait();

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


Import-Module Microsoft.Graph.Beta.Security

Get-MgBetaSecurityThreatIntelligenceHostPassiveDns -HostId $hostId

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.threat_intelligence.hosts.by_host_id('host-id').passive_dns.get()

重要

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.passiveDnsRecord",
      "id": "Y29udG9zby5jb20kJDIwLjEwMy44NS4zMyQkZmFsc2U=",
      "firstSeenDateTime": "2022-04-18T10:31:12Z",
      "lastSeenDateTime": "2023-03-07T13:19:35Z",
      "collectedDateTime": "2023-03-07T13:59:34.735Z",
      "recordType": "A",
      "parentHost": {
          "id": "contoso.com"
      },
      "artifact": {
          "@odata.type": "#microsoft.graph.security.ipAddress",
          "id": "20.103.85.33"
      }
    }
  ]
}

次の方法で共有

passiveDns を一覧表示する

アクセス許可

HTTP 要求

オプションのクエリパラメーター

$filterでサポートされるプロパティ

$orderbyでサポートされるプロパティ

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース

次の方法で共有

passiveDns を一覧表示する

アクセス許可

HTTP 要求

オプションのクエリ パラメーター

$filterでサポートされるプロパティ

$orderbyでサポートされるプロパティ

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース

オプションのクエリパラメーター