Agreement-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt den anpassbaren Nutzungsbedingungen eines Mandanten dar, der mit Azure Active Directory (Azure AD) erstellt und verwaltet wird. Sie können die folgenden Methoden verwenden, um das Feature Azure Active Directory Nutzungsbedingungen gemäß Ihrem Szenario zu erstellen und zu verwalten.

Methoden

Methode	Rückgabetyp	Beschreibung
Create	Vereinbarung	Erstellen Sie einen neuen Vertrag durch Veröffentlichung in der Vertragssammlung.
Liste	Vereinbarungssammlung	Dient zum Abrufen einer Agreement-Objektsammlung.
Get	Vereinbarung	Dient zum Lesen von Eigenschaften und Beziehungen eines Vertragsobjekts.
Update	Keine	Dient zum Aktualisieren eines Vertragsobjekts.
Löschen	Keine	Dient zum Löschen eines Vertragsobjekts.
Akzeptanzen auflisten	agreementAcceptance-Sammlung	Rufen Sie die Details zu den Annahmedatensätzen für einen bestimmten Vertrag ab.
agreementAcceptances auflisten	agreementAcceptance-Sammlung	Rufen Sie die Zustimmungen für den angemeldeten Benutzer ab.
agreementFile abrufen	agreementFile-Sammlung	Rufen Sie die Details der Standarddatei für einen Vertrag ab, einschließlich der Sprach- und Versionsinformationen.
Dateien auflisten	agreementFileLocalization-Sammlung	Rufen Sie alle lokalisierten Dateien im Zusammenhang mit einem Vertrag ab.
agreementFileLocalization erstellen	agreementFileLocalization	Erstellen Sie eine neue lokalisierte Vereinbarungsdatei.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	Zeichenfolge	Anzeigename des Vertrags. Der Anzeigename wird für die interne Nachverfolgung des Vertrags verwendet, wird jedoch nicht für Endbenutzer angezeigt, die den Vertrag anzeigen. Unterstützt $filter (eq).
id	Zeichenfolge	Schreibgeschützt. Unterstützt $filter (eq).
isPerDeviceAcceptanceRequired	Boolean	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 Azure AD registrieren, sofern dies noch nicht geschehen ist. Unterstützt $filter (eq).
isViewingBeforeAcceptanceRequired	Boolean	Gibt an, ob der Benutzer den Vertrag vor der Annahme erweitern muss. 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 dauer im ISO 8601-Format dargestellt.

Beziehungen

Beziehung	Typ	Beschreibung
Akzepte	agreementAcceptance-Sammlung	Schreibgeschützt. Informationen über die Annahme dieser Vereinbarung.
file	agreementFile	Standard-PDF, die mit diesem Vertrag verknüpft ist.
files	agreementFileLocalization-Sammlung	PDFs, die mit dieser Vereinbarung verknüpft sind. Hinweis: Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen die Dateieigenschaft .

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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