POST api/v1/DetailRecord/query

フィルターに一致するリスク分析の詳細レコードをエクスポートします。

要求の例

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

 

{

filters: [

        {

            id: module,

            values: [

                1,

                2,

                3,

                4

            ]

        },

        {

            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: Location,

            values: [

                https://yourcompany.sharepoint.com/sites/site03,

                https://yourcompany.sharepoint.com/sites/site02,

                https://yourcompany.sharepoint.com/sites/site01/shared documents/folder 02/test.txt

            ]

        },

        {

            id: siteName,

            values: [

                access

            ]

        },

        {

            id: tagName,

            values: [

                In Progress

            ]

        }

],

token: null,

language: en_US,

pageSize: 100

応答の例

{

results: [

        {

            id: 90fab486-81de-0970-c233-6cac9f2b8142,

            name: ABA Routing Number.docx,

            location: https://yourcompany.sharepoint.com/sites/site01/shared documents/folder 03/aba routing number.docx,

            objectType: File,

            createdBy: User01,

            module: Microsoft Teams,

            inheritance: No,

            siteName: site01,

            sensitivityLevel: Medium,

            exposureLevel: High,

            scannedTime: 2023-10-30T09:47:59Z,

            createdTime: 2021-10-20T07:28:36Z,

            modifiedTime: 2020-08-13T05:06:00Z,

            channelName: Channel001,

            riskLevel: High,

            privacy: Private,

            sensitiveInfoType: [

                Custom ABA,

                ABA Routing Number

            ],

            sensitivityLabel: null,

            tagName: In Progress,

            "retentionLabel": "Retention label01"

            "creatorEmail": "username@domain.com"

        }

],

status: 200,

message: “”,

content: null,

nextToken: {Next Token}

}

要求情報

要素

説明

種類

必須

filters

module

詳細レコードをエクスポートするワークスペースを設定します。

Int

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

1 (Microsoft Teams )

2 (SharePoint Online)

3 (OneDrive)

4 (Microsoft 365 グループ)

いいえ

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 ()

location

オブジェクト URL を設定します。

String

siteName

詳細レコードが存在するサイトの名前を設定します。

String

token

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

String

いいえ

language

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

String

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

en-US (英語)

ja-JP (日本語)

fr-FR (フランス語)

いいえ

pageSize

結果の各ページに表示されるリンクの数を設定します。この数の上限は 100 です。

Int

はい

 

応答情報

要素

説明

種類

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