tipo de recurso accessReviewInstance

Espacio de nombres: microsoft.graph

Representa una periodicidad Azure AD revisión de acceso. Generado por el sistema basado en el objeto accessReviewScheduleDefinition primario. Todas las propiedades son de solo lectura.

Si la instancia forma parte de una revisión de acceso periódica, las instancias representan cada periodicidad. Una revisión que no se repita tendrá exactamente una instancia. Las instancias también representan cada recurso único que se está revisando en la definición de programación. Si una definición de programación revisa varios recursos, cada recurso tendrá una instancia única para cada periodicidad.

Cada accessReviewInstance contiene una lista de decisiones en las que los revisores pueden tomar medidas. Hay una decisión por identidad que se está revisando.

Hereda de la entidad.

Métodos

Método Tipo devuelto Descripción
Enumerar accessReviewInstances colección accessReviewInstance Obtenga una lista de los objetos accessReviewInstance y sus propiedades.
Obtener accessReviewInstance accessReviewInstance Lea las propiedades y las relaciones de un objeto accessReviewInstance.
Actualizar accessReviewInstance accessReviewInstance Actualice los revisores de un objeto accessReviewInstance.
filterByCurrentUser colección accessReviewInstance Devuelve todos los objetos de instancia de una definición para la que el usuario que llama es el revisor.
Enumerar revisores contactados colección accessReviewReviewer Obtener los revisores que recibieron notificaciones para una instancia de revisión de acceso.
sendReminder Ninguno Envíe un aviso a los revisores de un accessReviewInstance.
stop Ninguno Detenga manualmente un accessReviewInstance.
acceptRecommendations Ninguno Permite al usuario que realiza la llamada aceptar la recomendación de decisión para cada objeto AccessReviewedReviewInstanceDecisionItem en el que sea revisor de un accessReviewInstance específico.
applyDecisions Ninguno Aplicar manualmente la decisión en un accessReviewInstance.
batchRecordDecisions Ninguno Revise lotes de entidades de seguridad o recursos en una llamada.
resetDecisions Ninguno Restablece todos los elementos de decisión de una instancia a notReviewed
Enumerar decisiones colección accessReviewInstanceDecisionItem Obtenga los recursos accessReviewInstanceDecisionItem de la propiedad de navegación decisions.

Propiedades

Propiedad Tipo Descripción
endDateTime DateTimeOffset DateTime cuando la instancia de revisión está programada para finalizar. El tipo DatetimeOffset representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Admite $select. Solo lectura.
fallbackReviewers colección accessReviewReviewerScope Esta colección de ámbitos de revisor se usa para definir la lista de revisores de reserva. Se notificará a estos revisores de reserva para que tomen medidas si no se encuentra ningún usuario en la lista de revisores especificada. Esto puede ocurrir cuando el propietario del grupo se especifica como revisor, pero el propietario del grupo no existe, o el administrador se especifica como revisor, pero el administrador de un usuario no existe. Admite $select.
id Cadena Identificador único de la instancia. Heredado de la entidad. Admite $select. Solo lectura.
scope accessReviewScope Creado según el ámbito y el instanceEnumerationScope en el nivel accessReviewScheduleDefinition. Define el ámbito de los usuarios revisados en un grupo. Admite $select y $filter ( contains solo). Solo lectura.
startDateTime DateTimeOffset DateTime cuando la instancia de revisión está programada para iniciarse. Puede ser en el futuro. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Admite $select. Solo lectura.
status Cadena Especifica el estado de un accessReview. Valores posibles: Initializing , , , , , , y NotStarted Starting InProgress Completing Completed AutoReviewing AutoReviewed . Admite $select , y ( $orderby $filter eq solo). Solo lectura.
revisores colección accessReviewReviewerScope Esta colección de ámbitos de revisión de acceso se usa para definir quiénes son los revisores. Admite $select. Para obtener ejemplos de opciones para asignar revisores, vea Asignar revisores a la definición de revisión de acceso mediante la API Graph Microsoft.

Relaciones

Relación Tipo Descripción
decisiones colección accessReviewInstanceDecisionItem Cada entidad de seguridad revisada en un accessReviewInstance tiene un elemento de decisión que representa si se aprobaron, denegaron o aún no se revisaron.
contactedReviewers colección accessReviewReviewer Devuelve la colección de revisores a los que se ha contactado para completar esta revisión. Aunque las propiedades revisores y fallbackReviewers de accessReviewScheduleDefinition pueden especificar propietarios o administradores de grupos como revisores, contactedReviewers devuelve sus identidades individuales. Admite $select. Solo lectura.

Representación JSON

La siguiente es una representación JSON del recurso

{
  "@odata.type": "#microsoft.graph.accessReviewInstance",
  "id": "String (identifier)",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}