Agreement-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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
Create Verträge Erstellen Sie eine neue Vereinbarung, indem Sie in der Vertragssammlung veröffentlichen.
List Vereinbarungssammlung Ruft eine Objektauflistung für Vereinbarungen ab.
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 Schreibgeschützt. Unterstützt $filter (eq).
isPerDeviceAcceptanceRequired Boolesch Mit dieser Einstellung können Sie festlegen, dass Endbenutzer diese Vereinbarung auf jedem Gerät akzeptieren, 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.

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. Hinweis: Diese Eigenschaft wird derzeit als veraltet gekennzeichnet. Verwenden Sie stattdessen die Dateieigenschaft .

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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

Verwandte Inhalte