reports: destinationReport

名前空間: microsoft.graph.networkaccess

指定した時間枠内のすべての発信ネットワーク接続に関する情報を含むレポートを取得します。

アクセス許可

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

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされている Microsoft Entra ロール またはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

• グローバル閲覧者
• グローバル セキュリティで保護されたアクセス管理者
• セキュリティ管理者

HTTP 要求

GET /networkAccessRoot/reports/destinationReport(startDateTime={startDateTime}, endDateTime={endDateTime})

関数パラメーター

要求 URL で、次のクエリ パラメーターに値を指定します。 次の表に、この関数で使用できるパラメーターを示します。

要求ヘッダー

要求本文

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

応答

成功した場合、この関数は応答本文に 200 OK 応答コードと microsoft.graph.networkaccess.destination コレクションを返します。

例

要求

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

GET https://graph.microsoft.com/beta/networkaccess/reports/destinationReport(startDateTime=2023-08-20T12:12:59.076Z, endDateTime=2023-08-21T12:12:59.076Z) 

const options = {
	authProvider,
};

const client = Client.init(options);

let destinationReport = await client.api('/networkaccess/reports/destinationReport(startDateTime=2023-08-20T12:12:59.076Z, endDateTime=2023-08-21T12:12:59.076Z)')
	.version('beta')
	.get();

応答

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

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

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

{
  "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.networkaccess.destination)",
  "value":[
     {
        "fqdn":"login.microsoftonline.com",
        "ip":"6.6.0.1",
        "port":443,
        "networkingProtocol":"TCP",
        "trafficProfile":"microsoft365",
        "lastAccessDateTime":"2023-08-09T13:20:04Z",
        "trafficType":"microsoft365"
     },
     {
        "ip":"130.20.20.20",
        "port":443,
        "networkingProtocol":"TCP",
        "trafficProfile":"private",
        "lastAccessDateTime":"2023-08-09T13:20:04Z",
        "trafficType":"private"
     }
  ]
}