tipo de recurso agreement

Espacio de nombres: microsoft.graph

Representa el contrato de términos de uso personalizable de un inquilino que se crea y administra con Gobierno de Microsoft Entra ID. Puede usar los métodos siguientes para crear y administrar la característica de términos de uso de Microsoft Entra según su escenario.

Métodos

Método Tipo de valor devuelto Descripción
List colección de contratos Obtener una colección de objetos de contrato.
Crear contrato Cree un nuevo contrato publicándolo en la colección de contratos.
Get contrato Lee las propiedades y las relaciones de un objeto de contrato.
Actualizar Ninguno Actualizar un objeto de contrato.
Delete Ninguno Eliminar un objeto de contrato.

Propiedades

Propiedad Tipo Descripción
displayName Cadena Nombre para mostrar del contrato. El nombre para mostrar se usa para el seguimiento interno del contrato, pero no se muestra a los usuarios finales que ven el contrato. Admite $filter (eq).
id Cadena Identificador del contrato. Solo lectura. Admite $filter (eq).
isPerDeviceAcceptanceRequired Booleano Indica si los usuarios finales deben aceptar este contrato en todos los dispositivos desde los que acceden. El usuario final debe registrar su dispositivo en Microsoft Entra ID, si aún no lo ha hecho. Admite $filter (eq).
isViewingBeforeAcceptanceRequired Booleano Indica si el usuario tiene que expandir el contrato antes de aceptarlo. Admite $filter (eq).
termsExpiration termsExpiration Programación de expiración y frecuencia de contrato para todos los usuarios. Admite $filter (eq).
userReacceptRequiredFrequency Duración La duración después de la cual el usuario debe aceptar los términos de uso. El valor se representa en formato ISO 8601 para las duraciones. Admite $filter (eq).

Relaciones

Relación Tipo Descripción
Aceptaciones Colección agreementAcceptance Solo lectura. Información sobre las aceptaciones de este contrato.
archivo agreementFile PDF predeterminado vinculado a este contrato.
archivos colección agreementFileLocalization Archivos PDF vinculados a este contrato. Esta propiedad está en desuso. Use la propiedad file en su lugar. Admite $expand.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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