POST api/v1/DetailRecord/querybysite

各サイト コレクションのリスク分析の詳細レコードをエクスポートします。これは、リスク分析の詳細レコードをエクスポートするための推奨 API です。

要求の例

http://hostname:port/api/v1/DetailRecord/querybysite

 

{

    "filters": [

        {

            "id": "objecttype",

            "values": [

                "2",

                "3",

                "13"

            ]

        },

        {

            "id": "sensitivitylevel",

            "values": [

                "0",

                "1",

                "2",

                "3"

            ]

        },

        {

            "id": "Exposurelevel",

            "values": [

                "1",

                "2",

                "3"

            ]

        },

        {

            "id": "riskLevel",

            "values": [

                "0",

                "1",

                "2",

                "3"

            ]

        },

        {

            "id": "tagname",

            "values": [

                "In Progress"

            ]

        },

        {

            "id": "createdby",

            "values": [

                "username@domain.com"

            ]

        },

        {

            "id": "modifiedtime",

            "values": [

                "2024-09-20T10:57:28Z",

                "2024-09-27T10:57:28Z"

            ]

        },

    ],

    "siteId": "siteID",

    "token": null,

    "language": "en_US",

    "pageSize": 100

}

応答の例

{

  "results": [

    {

      "id": "ID",

      "name": "Demo1.xlsx",

      "location": "https://org.sharepoint.com/sites/site01/shared documents/Demo1.xlsx",

      "objectType": "File",

      "createdBy": "User01",

      "module": "Microsoft Teams",

      "inheritance": "Yes",

      "siteName": "site01",

      "sensitivityLevel": "Low",

      "exposureLevel": "Low",

      "scannedTime": "2024-11-11T02:46:58Z",

      "createdTime": "2024-02-22T02:28:40Z",

      "modifiedTime": "2024-02-22T02:28:40Z",

      "channelName": "Shared channel",

      "riskLevel": "Low",

      "privacy": "Private",

      "sensitiveInfoType": [

        "CR 2"

      ],

      "sensitivityLabel": "Label01",

      "tagName": "",

      "retentionLabel": null,

      "creatorEmail": "username@domain.com"

    },

    {

      "id": "ID",

      "name": "Demo2.pptx",

      "location": "https://org.sharepoint.com/sites/site01/shared documents/Demo2.pptx",

      "objectType": "File",

      "createdBy": "User02",

      "module": "Microsoft Teams",

      "inheritance": "No",

      "siteName": "site01",

      "sensitivityLevel": "N/A",

      "exposureLevel": "Medium",

      "scannedTime": "2024-11-01T09:22:18Z",

      "createdTime": "2024-04-03T06:57:39Z",

      "modifiedTime": "",

      "channelName": "Shared channel",

      "riskLevel": "N/A",

      "privacy": "Private",

      "sensitiveInfoType": [],

      "sensitivityLabel": null,

      "tagName": "",

      "retentionLabel": "",

      "creatorEmail": "username@domain.com"

    }

  ],

  "status": 200,

  "message": "",

  "content": null,

  "nextToken": null

}

要求情報

要素

説明

種類

必須

filters

objectType

オブジェクト タイプを設定します。

Int

有効な値は次のとおりです。

1 (フォルダー)

2 (ファイル)

3 (アイテム)

11 (サイト コレクション)

12 (サイト)

13 (リスト)

14 (ライブラリ)

はい

tagName

Insights に存在するタブ名を設定します。

String

sensitivityLevel

秘密度ラベルを設定します。

Int

有効な値は次のとおりです。

0 (該当なし)

1 ()

2 ()

3 ()

exposureLevel

露出レベルを設定します。

Int

有効な値は次のとおりです。

1 ()

2 ()

3 ()

riskLevel

リスク レベルを設定します。

Int

有効な値は次のとおりです。

0 (該当なし)

1 ()

2 ()

3 ()

createdBy

アイテムを作成したユーザーを設定します。

String

modifiedTime

アイテムが最終に変更された日時を設定します。最大 2 つの値を設定できます。

Datetime

token

100 件以上の結果が出たリクエストの残りの結果を取得するかどうかを設定します。

String

いいえ

language

エクスポートしようとしているレポートの言語を設定します。

String

有効な値は次のとおりです。

en-US (英語)

ja-JP (日本語)

fr-FR for French

いいえ

pageSize

各ページに表示する結果の数を設定します。その数は 100 以内で設定する必要があります。

Int

はい

siteId

エクスポートする詳細レコードが存在するサイト コレクションの ID を設定します。

String

はい

応答情報

要素

説明

種類

results

id

オブジェクトの固有 ID です。

String

name

オブジェクト名です。

String

location

オブジェクトの完全 URL です。

String

objectType

オブジェクト タイプです。

Int

createdBy

オブジェクトの作成者です。

Int

module

オブジェクトが存在するサイトのワークスペースです。

Int

inheritance

オブジェクトの継承状態です。

Int

siteName

オブジェクトが存在するサイトの名前です。

String

sensitivityLevel

オブジェクトの秘密度度レベルです。

Int

exposureLevel

オブジェクトの露出レベルです。

Int

scannedTime

オブジェクトのスキャン日時です。

String

createdTime

オブジェクトの作成日時です。

String

modifiedTime

オブジェクトの更新日時です。

String

channelName

オブジェクトが所属するチャネルの名前です。

String

riskLevel

オブジェクトのリスク レベルです。

String

privacy

オブジェクトが所属するチームまたは Microsoft グループのプライバシーです。

String

sensitiveInfoType

オブジェクトが一致する機密情報の種類です。

String

sensitivityLabel

オブジェクトに適用する秘密度ラベルです。

String

tagName

オブジェクトに適用するタグの名前です。

String

retentionLabel

オブジェクトに適用する秘密度ラベルです。

String

 

creatorEmail

オブジェクトを作成したユーザーのメールです。

String

status

HTTP の応答状態コード

Int

message

エラー メッセージ

String

content

備考です。この要素はこの API で使用されません。既定は null が応答されます。

String

nextToken

このリクエストの残りの結果を得るために使用されるトークンです。

String