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"
    }
  ]
}