agreement リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Entra ID ガバナンスで作成および管理されるテナントのカスタマイズ可能な使用条件契約を表します。 次の方法を使用して、シナリオに応じてMicrosoft Entra使用条件機能を作成および管理できます。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | 契約 | 契約コレクションに転記して、新しい契約を作成します。 |
| List | 契約 の収集 | 契約オブジェクト コレクションを取得します。 |
| Get | 契約 | アグリーメント オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | なし | 契約オブジェクトを更新します。 |
| Delete | なし | 契約オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| displayName | String | 契約の表示名。 表示名は、契約の内部追跡に使用されますが、契約を表示するエンド ユーザーには表示されません。
$filter (eq)をサポートしています。 |
| id | String | 読み取り専用。
$filter (eq)をサポートしています。 |
| isPerDeviceAcceptanceRequired | ブール型 | この設定を使用すると、エンド ユーザーがアクセス元のすべてのデバイスでこの契約に同意することを要求できます。 エンド ユーザーがまだデバイスを登録していない場合は、Microsoft Entra IDにデバイスを登録する必要があります。
$filter (eq)をサポートしています。 |
| isViewingBeforeAcceptanceRequired | ブール型 | 同意する前に、ユーザーが契約を展開する必要があるかどうかを示します。
$filter (eq)をサポートしています。 |
| termsExpiration | termsExpiration | すべてのユーザーの有効期限スケジュールと契約の頻度。
$filter (eq)をサポートしています。 |
| userReacceptRequiredFrequency | 期間 | ユーザーが使用条件を再同意する必要がある期間。 値は ISO 8601 形式で表示されます。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| 承諾 | agreementAcceptance コレクション | 読み取り専用。 本契約の同意に関する情報。 |
| file | agreementFile | 本契約にリンクされている既定の PDF。 |
| ファイル | agreementFileLocalization コレクション | 本契約にリンクされている PDF。 メモ： このプロパティは非推奨の処理中です。 代 わりに file プロパティ を使用します。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.agreement",
"id": "String (identifier)",
"displayName": "String",
"termsExpiration": {
"@odata.type": "microsoft.graph.termsExpiration"
},
"userReacceptRequiredFrequency": "String (duration)",
"isViewingBeforeAcceptanceRequired": "Boolean",
"isPerDeviceAcceptanceRequired": "Boolean"
}