Freigeben über


Agreement-Ressourcentyp

Namespace: microsoft.graph

Stellt die anpassbare Nutzungsbedingungen eines Mandanten dar, die mit Microsoft Entra ID Governance erstellt und verwaltet wird. Sie können die folgenden Methoden verwenden, um das Feature Microsoft Entra Nutzungsbedingungen entsprechend Ihrem Szenario zu erstellen und zu verwalten.

Methoden

Methode Rückgabetyp Beschreibung
List Vereinbarungssammlung Ruft eine Objektauflistung für Vereinbarungen ab.
Create Verträge Erstellen Sie eine neue Vereinbarung, indem Sie in der Vertragssammlung veröffentlichen.
Get Verträge Liest Eigenschaften und Beziehungen eines Vereinbarungsobjekts.
Update Keine Aktualisieren eines Vereinbarungsobjekts.
Delete Keine Löschen sie ein Vereinbarungsobjekt.

Eigenschaften

Eigenschaft Typ Beschreibung
displayName String Anzeigename der Vereinbarung. Der Anzeigename wird für die interne Nachverfolgung der Vereinbarung verwendet, endbenutzern, die die Vereinbarung anzeigen, jedoch nicht angezeigt. Unterstützt $filter (eq).
id String Der Bezeichner der Vereinbarung. Schreibgeschützt. Unterstützt $filter (eq).
isPerDeviceAcceptanceRequired Boolesch Gibt an, ob Endbenutzer diese Vereinbarung auf jedem Gerät akzeptieren müssen, von dem aus sie darauf zugreifen. Der Endbenutzer muss sein Gerät in Microsoft Entra ID registrieren, sofern noch nicht geschehen. Unterstützt $filter (eq).
isViewingBeforeAcceptanceRequired Boolesch Gibt an, ob der Benutzer die Vereinbarung erweitern muss, bevor er akzeptiert. Unterstützt $filter (eq).
termsExpiration termsExpiration Ablaufzeitplan und Häufigkeit der Vereinbarung für alle Benutzer. Unterstützt $filter (eq).
userReacceptRequiredFrequency Dauer Die Dauer, nach der der Benutzer die Nutzungsbedingungen erneut akzeptieren muss. Der Wert wird für die Dauer im ISO 8601-Format dargestellt. Unterstützt $filter (eq).

Beziehungen

Beziehung Typ Beschreibung
Akzepte agreementAcceptance-Sammlung Schreibgeschützt. Informationen über die Annahmen dieser Vereinbarung.
file agreementFile Standard-PDF, die mit dieser Vereinbarung verknüpft ist.
files agreementFileLocalization-Auflistung PDFs, die mit dieser Vereinbarung verknüpft sind. Diese Eigenschaft wird derzeit als veraltet gekennzeichnet. Verwenden Sie stattdessen die Dateieigenschaft . Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.agreement",
  "displayName": "String",
  "id": "String (identifier)",
  "isPerDeviceAcceptanceRequired": "Boolean",
  "isViewingBeforeAcceptanceRequired": "Boolean",
  "termsExpiration": {
    "@odata.type": "microsoft.graph.termsExpiration"
  },
  "userReacceptRequiredFrequency": "String (duration)"
}