tipo de recurso accessReviewStage

Artículo
10/18/2023

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 fase de una periodicidad de revisión de acceso de Microsoft Entra. Si el accessReviewScheduleDefinition primario ha definido la propiedad stageSettings , accessReviewInstance consta de hasta tres fases posteriores. Cada fase puede tener un conjunto diferente de revisores que pueden actuar sobre las decisiones de la fase y la configuración que determina qué decisiones pasan de una fase a otra.

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

Métodos

Método	Tipo devuelto	Descripción
Acceso de listaReviewStages	colección accessReviewStage	Obtenga una lista de los objetos accessReviewStage y sus propiedades.
Obtener accesoReviewStage	accessReviewStage	Lea las propiedades y relaciones de un objeto accessReviewStage .
Actualizar accessReviewStage	accessReviewStage	Actualice las propiedades de un objeto accessReviewStage .
stop	Ninguno	Detenga manualmente un accessReviewStage.
filterByCurrentUser	colección accessReviewStage	Devuelve todas las fases de un accessReviewInstance determinado para el que el usuario que realiza la llamada es un revisor.
Enumerar decisiones	colección accessReviewInstanceDecisionItem	Obtenga las decisiones tomadas en accessReviewStage.

Propiedades

Propiedad	Tipo	Descripción
endDateTime	DateTimeOffset	DateTime cuando la fase 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`. Esta propiedad es el total acumulado de durationInDays para todas las fases. 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 puede 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.
id	Cadena	Identificador único de la fase. 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. 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.
startDateTime	DateTimeOffset	DateTime cuando la fase 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`. Solo lectura.
status	Cadena	Especifica el estado de un accessReviewStage. Valores posibles: `Initializing`, `NotStarted`, , `InProgressStarting`, `Completing`, `Completed`, y `AutoReviewingAutoReviewed`. Admite `$orderby`, y `$filter` (`eq` solo). Solo lectura.

Relaciones

Relación	Tipo	Descripción
Decisiones	colección accessReviewInstanceDecisionItem	Cada usuario revisado en un accessReviewStage tiene un elemento de decisión que representa si se ha aprobado, denegado o aún no revisado.

Representación JSON

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

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