Compartir a través de

tipo de recurso agreement

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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
Crear contrato Cree un nuevo contrato publicándolo en la colección de contratos.
Lista colección de contratos Obtener una colección de objetos de contrato.
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 Solo lectura. Admite $filter (eq).
isPerDeviceAcceptanceRequired Booleano Esta configuración le permite exigir a los usuarios finales que acepten 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.

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. Nota: Esta propiedad está en desuso. Use la propiedad file en su lugar.

Representación JSON

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

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

Contenido relacionado