permissionScope リソースの種類

名前空間: microsoft.graph

重要

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

委任されたアクセス許可の 定義を表します。

委任されたアクセス許可は、アクセス許可を定義した API へのアクセス トークンを必要とするクライアント アプリケーションから要求できます。 委任されたアクセス scopes許可は、Microsoft ID プラットフォーム への承認要求のパラメーターを使用して動的に要求するか、アプリケーション オブジェクトの requiredResourceAccess コレクションを介して静的に 要求できます。

プロパティ

プロパティ	型	説明
adminConsentDescription	String	すべてのユーザーに代わってアクセス許可を付与する管理者が読み取る目的で委任されたアクセス許可の説明。 このテキストは、テナント全体の管理者の同意エクスペリエンスに表示されます。
adminConsentDisplayName	String	すべてのユーザーに代わってアクセス許可を付与する管理者が読み取る権限のタイトル。
id	Guid	リソース アプリケーションに対して定義された委任されたアクセス許可のコレクション内の一意の委任されたアクセス許可識別子。
isEnabled	ブール値	アクセス許可を作成または更新する場合、このプロパティを true (既定値) に設定する必要があります。 アクセス許可を削除するには、まずこのプロパティを false に設定する必要 があります。 その時点で、後続の呼び出しで、アクセス許可が削除される可能性があります。
type	String	指定できる値は次のとおりですAdmin。 User 管理者以外のユーザーが自分自身に代わって同意するために、この委任されたアクセス許可を安全と見なす必要があるかどうか、または管理者の同意を常に必要とするかどうかを指定します。 Microsoft Graphは、各アクセス許可の既定の同意要件を定義しますが、テナント管理者は組織内の動作を上書きすることがあります (この委任されたアクセス許可に対するユーザーの同意を許可、制限、または制限することで)。 詳細については、「ユーザーがアプリケーション に同意する方法を構成する」を参照してください。
userConsentDescription	String	委任されたアクセス許可の説明 。ユーザーが自分の代わりにアクセス許可を付与することを目的とします。 このテキストは、ユーザーが自分自身の代わりにのみ同意している同意エクスペリエンスに表示されます。
userConsentDisplayName	String	アクセス許可のタイトルで、自分の代わりにアクセス許可を付与するユーザーが読み取る対象です。 このテキストは、ユーザーが自分自身の代わりにのみ同意している同意エクスペリエンスに表示されます。
value	文字列型 (String)	アクセス トークンに (スコープ) クレームに scp 含める値を指定します。 長さは 120 文字以内です。 使用できる文字は、: ` ] @ ^ ' & ( % $ # ! > ? [ ; ~< } + * , - . ) / _ | = { : +範囲の文字と同様に0-9、および です。 A-Z a-z その他の文字 (スペース文字を含む) は使用できない。 で始めない場合があります .。

JSON 表記

以下は、リソースの JSON 表記です

{
  "id": "Guid",
  "adminConsentDisplayName": "String",
  "adminConsentDescription": "String",
  "userConsentDisplayName": "String",
  "userConsentDescription": "String",
  "value": "String",
  "type": "String",
  "isEnabled": true
}