Type de ressource agreement
Espace de noms: microsoft.graph
Représente le contrat de conditions d’utilisation personnalisable d’un locataire qui est créé et géré avec Gouvernance Microsoft Entra ID. Vous pouvez utiliser les méthodes suivantes pour créer et gérer la fonctionnalité Microsoft Entra conditions d’utilisation en fonction de votre scénario.
Méthodes
Méthode | Type renvoyé | Description |
---|---|---|
List | collection de contrats | Obtenir une collection d’objets de contrat. |
Create | contrat | Créez un contrat en publiant dans la collection de contrats. |
Obtenir | contrat | Lit les propriétés et les relations d’un objet de contrat. |
Mettre à jour | Aucun | Mettre à jour un objet de contrat. |
Supprimer | Aucune | Supprimer un objet de contrat. |
Propriétés
Propriété | Type | Description |
---|---|---|
displayName | Chaîne | Nom d’affichage du contrat. Le nom d’affichage est utilisé pour le suivi interne du contrat, mais n’est pas affiché aux utilisateurs finaux qui affichent le contrat. Prend en charge $filter (eq ). |
id | Chaîne | Identificateur du contrat. En lecture seule. Prend en charge $filter (eq ). |
isPerDeviceAcceptanceRequired | Valeur booléenne | Indique si les utilisateurs finaux sont tenus d’accepter ce contrat sur chaque appareil à partir duquel ils y accèdent. L’utilisateur final doit inscrire son appareil dans Microsoft Entra ID, s’il ne l’a pas déjà fait. Prend en charge $filter (eq ). |
isViewingBeforeAcceptanceRequired | Valeur booléenne | Indique si l’utilisateur doit développer le contrat avant d’accepter. Prend en charge $filter (eq ). |
termsExpiration | termsExpiration | Calendrier d’expiration et fréquence du contrat pour tous les utilisateurs. Prend en charge $filter (eq ). |
userReacceptRequiredFrequency | Durée | Durée après laquelle l’utilisateur doit réaccepter les conditions d’utilisation. La valeur est représentée au format ISO 8601 pour les durées. Prend en charge $filter (eq ). |
Relations
Relation | Type | Description |
---|---|---|
Acceptations | collection agreementAcceptance | En lecture seule. Informations sur les acceptations du présent contrat. |
file | agreementFile | PDF par défaut lié à ce contrat. |
fichiers | collection agreementFileLocalization | Fichiers PDF liés à ce contrat. Cette propriété est en cours de dépréciation. Utilisez la propriété de fichier à la place. Prend en charge $expand . |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.agreement",
"displayName": "String",
"id": "String (identifier)",
"isPerDeviceAcceptanceRequired": "Boolean",
"isViewingBeforeAcceptanceRequired": "Boolean",
"termsExpiration": {
"@odata.type": "microsoft.graph.termsExpiration"
},
"userReacceptRequiredFrequency": "String (duration)"
}