次の方法で共有


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"
}