Type de ressource agreement

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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
Créer contrat Créez un contrat en publiant dans la collection de contrats.
List collection de contrats Obtenir une collection d’objets de contrat.
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 En lecture seule. Prend en charge $filter (eq).
isPerDeviceAcceptanceRequired Valeur booléenne Ce paramètre vous permet d’exiger que les utilisateurs finaux acceptent 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.

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. Note: Cette propriété est en cours de dépréciation. Utilisez la propriété de fichier à la place.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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