Lista contactedReviewers
Espacio de nombres: microsoft.graph
Obtenga a los revisores una instancia de revisión de acceso, independientemente de si han recibido o no una notificación. Los revisores se representan mediante un objeto accessReviewReviewer . Se devuelve una lista de cero o más objetos, incluidas todas sus propiedades anidadas.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | AccessReview.Read.All | AccessReview.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | AccessReview.Read.All | AccessReview.ReadWrite.All |
Importante
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación.
Para leer las revisiones de acceso de un grupo o aplicación: el creador de la revisión de acceso; Lector global, Lector de seguridad, Administrador de usuarios, Administrador de gobernanza de identidades, Administrador de seguridad
Para leer las revisiones de acceso de un rol de Microsoft Entra: Lector de seguridad, Administrador de gobernanza de identidades, Administrador de roles con privilegios, Administrador de seguridad
Solicitud HTTP
GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/contactedReviewers
Parámetros de consulta opcionales
Este método admite $selectlos parámetros de consulta , $filter, $orderby, $skipy $top OData para ayudar a personalizar la respuesta. Para obtener información general, vea Parámetros de consulta OData.
El tamaño de página predeterminado de esta API es de 100 objetos accessReviewReviewer . Para mejorar la eficacia y evitar tiempos de espera debidos a grandes conjuntos de resultados, aplique la paginación mediante los $skip parámetros de consulta y $top . Para obtener más información, vea Paginación de los datos de Microsoft Graph en su aplicación.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos accessReviewReviewer en el cuerpo de la respuesta.
Ejemplos
Solicitud
GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/2dca8959-b716-4b4c-a93d-a535c01eb6e0/instances/8d035c9d-798d-47fa-beb4-f986a4b8126f/contactedReviewers
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/accessReviews/definitions('2dca8959-b716-4b4c-a93d-a535c01eb6e0')/instances('8d035c9d-798d-47fa-beb4-f986a4b8126f')/contactedReviewers",
"@odata.count": 1,
"value": [
{
"id": "139166ec-d214-4835-95aa-3c1d89581e51",
"displayName": "Adele Vance",
"userPrincipalName": "AdeleV@contoso.com",
"createdDateTime": "2021-03-09T23:10:28.83Z"
}
]
}