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