tipo de recurso accessReviewInstance

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.

Nota:

Esta es la API recomendada para las revisiones de acceso. La versión anterior de la API de revisiones de acceso está en desuso .

Representa una periodicidad de revisión de acceso de Microsoft Entra. Si el accessReviewScheduleDefinition primario es 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 grupo único que se está revisando en la definición de programación. Si una definición de programación revisa varios grupos, cada grupo tiene una instancia única para cada periodicidad.

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

Métodos

Método	Tipo de valor devuelto	Descripción
List	colección accessReviewInstance	Obtenga una lista de los objetos accessReviewInstance y sus propiedades.
Get	accessReviewInstance	Lea las propiedades y relaciones de un objeto accessReviewInstance .
Actualizar	accessReviewInstance	Actualice los revisores de un objeto accessReviewInstance .
Filtrar por usuario actual	colección accessReviewInstance	Devuelve todas las instancias de un accessReviewScheduleDefinition determinado para el que el usuario que realiza la llamada es el revisor de una o varias decisiones.
Lista de revisores contactados	colección accessReviewReviewer	Obtenga los revisores que recibieron notificaciones para una instancia de revisión de acceso.
Enviar recordatorio	Ninguno.	Envíe un recordatorio a los revisores de una accessReviewInstance.
Stop	Ninguno.	Detenga manualmente una accessReviewInstance.
Aceptar recomendaciones	Ninguno.	Permite al usuario que realiza la llamada aceptar la recomendación de decisión para cada accessReviewInstanceDecisionItem notreviewed en el que sea el revisor de un accessReviewInstance específico.
Aplicar decisiones	Ninguno.	Aplique manualmente las decisiones en accessReviewInstance.
Detener las decisiones de aplicación	Ninguno.	Permite al usuario que realiza la llamada detener la acción de decisión de aplicación en un accessReviewInstance específico.
Decisiones de registros por lotes	Ninguno	Revise los lotes de entidades de seguridad o recursos en una llamada.
Restablecer decisiones	Ninguno	Restablece todos los elementos de decisión de una instancia a notReviewed.
Fases de lista	colección accessReviewStage	Recupere las fases de una instancia de revisión de acceso de varias fases.
Enumerar decisiones	colección accessReviewInstanceDecisionItem	Obtenga los recursos accessReviewInstanceDecisionItem de la propiedad de navegación decisiones.
Enumerar instancias de revisión de acceso pendientes (en desuso)	colección accessReviewInstance .	Obtenga todos los recursos accessReviewInstance pendientes asignados al usuario que realiza la llamada. Este método está en desuso y se reemplaza por filterByCurrentUser.

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.
errores	colección accessReviewError	Recopilación de errores en el ciclo de vida de una instancia de revisión de acceso. Solo lectura.
fallbackReviewers	colección accessReviewReviewerScope	Esta colección de ámbitos de revisor se usa para definir la lista de revisores de reserva. A estos revisores de reserva se les notifica que tomen medidas si no se encuentra ningún usuario en la lista de revisores especificada. Esto podría ocurrir cuando se especifica el propietario del grupo como revisor, pero el propietario del grupo no existe, o cuando el administrador se especifica como revisor, pero el administrador de un usuario no existe. Admite $select.
id	Cadena	Identificador único de la instancia. Admite $select. Solo lectura.
ámbito	accessReviewScope	Creado en función del ámbito y la instanciaEnumerationScope 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, NotStarted, , InProgressStarting, Completing, Completed, y AutoReviewingAutoReviewed. Admite $select, $orderbyy $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, consulte Asignación de revisores a la definición de revisión de acceso mediante Microsoft Graph API.

Relaciones

Relación	Tipo	Descripción
contactedReviewers	colección accessReviewReviewer	Devuelve la colección de revisores con los que se ha contactado para completar esta revisión. Aunque las propiedades reviewers y fallbackReviewers de accessReviewScheduleDefinition pueden especificar propietarios o administradores del grupo como revisores, contactedReviewers devuelve sus identidades individuales. Admite $select. Solo lectura.
definición	accessReviewScheduleDefinition	Hay exactamente un accessReviewScheduleDefinition asociado a cada instancia. Es la programación primaria de la instancia, donde se crean instancias para cada periodicidad de una definición de revisión y cada grupo seleccionado para revisar por la definición.
etapas	colección accessReviewStage	Si la instancia tiene varias fases, devuelve la colección de fases. Solo se creará una nueva fase cuando finalice la fase anterior. La existencia, el número y la configuración de las fases de una instancia de revisión se crean en función de accessReviewStageSettings en el accessReviewScheduleDefinition primario.
Decisiones	colección accessReviewInstanceDecisionItem	Cada usuario revisado en accessReviewInstance tiene un elemento de decisión que representa si se han aprobado, denegado o no revisado todavía.

Representación JSON

La siguiente representación JSON muestra el tipo de 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"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}