POST api/v1/User/permission

特定のユーザーの権限関連情報を取得します。

*注意: api/v1/user/permission/export API は、エクスポートしようとしているユーザーが 2,000 名を超える場合に推奨されます。

要求の例

http://hostnameport/api/v1/User/permission

 

{

SiteUrls: [https://yourcompany.sharepoint.com/sites/site01],

Emails: [username@domain],

Token: null,

Top: 100,

Language: en-US

 

}

応答の例

{

results: [

        {

            module: Microsoft Teams,

            siteName: site01,

            name: U.S. Personally Identifiable Information (PII) Data-High.docx,

            location: https://yourcompany.sharepoint.com/sites/site01/shared documents/general/u.s. personally identifiable information (pii) data-high.docx,

            objectType: File,

            inheritType: false,

            permission: Contribute,

            sensitivityLevel: High,

            sensitiveInfoType: U.S. Individual Taxpayer Identification Number (ITIN), U.S. Social Security Number (SSN), U.S. / U.K. Passport Number,

            isDirect: false,

            sensitivityLabel: “”,

            inheritedFrom: sharinglinks.selfID.flexible.linkID

        }

],

status: 200,

message: “”,

content: null,

nextToken: {Next Token}

}

要求情報

要素

説明

種類

必須

SiteUrl

特定のユーザーの権限関連情報を取得するサイト コレクションの URL を設定します。URL は最大 100 件です。URL が設定されていない場合は、構成されたデータ範囲内のサイト コレクションがすべてスキャンされます。

リスト

いいえ

Language

取得しようとしている情報の言語を設定します。

 

String

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

en-US (英語) (既定)

ja-JP (日本語)

fr-FR (フランス語)

いいえ

Emails

権限に関する情報を取得するユーザーのメールまたはプリンシパル名を設定します。メールは最大 100 件です。

リスト

はい

Token

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

String

いいえ

Top

1 ページ分の検索結果の数を設定します。最大で 1 ページに 100 件の検索結果が表示されます。

Int

いいえ

応答情報

要素

説明

種類

results

module

データ ソース

String

siteName

サイトの名前

String

name

権限の名前

String

location

オブジェクトの URL

String

objectType

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

String

inheritType

オブジェクトが親からの継承を解除しているかどうかの状態

Bool

permission

権限

String

sensitivityLevel

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

String

sensitiveInfoType

オブジェクトの機密情報の種類

String

isDirect

権限が直接付与されているかどうかの状態

Bool

sensitivityLabel

オブジェクトの秘密度ラベル

String

inheritedFrom

権限の継承元である親

String

status

HTTP の応答状態コード

Int

message

エラー メッセージ

String

nextToken

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

String