Tipo de recurso accessReview (en desuso)

  • 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.

Precaución

Esta versión de la API de revisión de acceso está en desuso y dejará de devolver datos el 19 de mayo de 2023. Use la API de revisiones de acceso.

Representa una revisión de acceso Microsoft Entra.

Métodos

Método Tipo de valor devuelto Descripción
Lista de accesoOpiniones colección accessReview Enumerar accessOpiniones para una clase businessFlowTemplate.
Obtener accessReview accessReview Obtenga una revisión de acceso con un identificador específico.
Creación de accessReview accessReview Cree un nuevo accessReview.
Actualizar accessReview accessReview Actualice accessReview.
Eliminar accessReview Ninguno. Eliminar un accessReview.
Enumeración de los revisores de accessReview colección userIdentity Obtenga los revisores de un accessReview.
Agregar accessReview reviewer Ninguno. Agregue un revisor a accessReview.
Quitar accessReview reviewer Ninguno. Quite un revisor de accessReview.
Enumerar las decisiones de accessReview colección accessReviewDecision Obtenga las decisiones de un accessReview.
Enumerar mis decisiones de accessReview colección accessReviewDecision Como revisor, obtenga mis decisiones de accessReview.
Enviar aviso de accessReview Ninguno. Envíe un recordatorio a los revisores de accessReview.
Detener accessReview Ninguno. Detenga un accessReview.
Restablecer las decisiones de accessReview Ninguno. Restablezca las decisiones en un accessReview en curso.
Aplicación de decisiones de accessReview Ninguno. Aplique las decisiones de un accessReview completado.

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único asignado a características de una revisión de acceso.
displayName Cadena Nombre de la revisión de acceso. Obligatorio al crear.
startDateTime DateTimeOffset Fecha y hora en que se programa el inicio de la revisión. Esta fecha puede ser en el futuro. Obligatorio al crear.
endDateTime DateTimeOffset Fecha y hora en que la revisión está programada para finalizar. Debe ser al menos un día después de la fecha de inicio. Obligatorio al crear.
status Cadena Este campo de solo lectura especifica el estado de un accessReview. Los estados típicos incluyen Initializing, NotStarted, Starting,InProgress , Completing, Completed, AutoReviewingy AutoReviewed.
description Cadena Descripción proporcionada por el creador de la revisión de acceso para mostrarla a los revisores.
businessFlowTemplateId Cadena Identificador de plantilla de flujo de negocio. Obligatorio al crear. Este valor distingue mayúsculas de minúsculas.
reviewerType Cadena El tipo de relación del revisor con el objeto de destino, uno de: self, delegated, entityOwners. Obligatorio al crear.
createdBy userIdentity El usuario que creó esta revisión.
reviewedEntity identity Objeto para el que la revisión de acceso está revisando las asignaciones de derechos de acceso. Esta identidad puede ser el grupo para la revisión de pertenencias de usuarios de un grupo o la aplicación para una revisión de las asignaciones de usuarios a una aplicación. Obligatorio al crear.
configuración accessReviewSettings La configuración de accessReview, consulte la definición de tipo siguiente.

Relaciones

Relación Tipo Descripción
Revisores colección userIdentity Colección de revisores para una revisión de acceso, si review reviewerType de acceso es de tipo delegated.
Decisiones colección accessReviewDecision Colección de decisiones para esta revisión de acceso.
myDecisions colección accessReviewDecision Colección de decisiones para el autor de la llamada, si el autor de la llamada es un revisor.
instances colección accessReview La colección de revisiones de acceso revisa instancias pasadas, presentes y futuras, si este objeto es una revisión de acceso periódica.

Si estas relaciones están presentes en un objeto, depende de si el objeto es una revisión de acceso única, la serie de una revisión de acceso periódica o una instancia de una revisión de acceso periódica.

Escenario ¿Tiene revisores? ¿Tiene decisiones y myDecisions? ¿Tiene instancias?
Revisión de acceso única Sí Sí, una vez iniciado No
Revisión de acceso periódica Sí No Sí
Instancia de una revisión de acceso periódica Sí Sí, una vez iniciado No

Representación JSON

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

{
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "description": "string",
 "businessFlowTemplateId": "string (identifier)",
 "reviewerType": "string",
 "createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
 "reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
 "settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
 "reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}