Acceso de listaOpiniones (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.

Recupere los objetos accessReview para una clase businessFlowTemplate determinada. Se devuelve una lista de cero o más objetos accessReview para cada revisión de acceso periódica y única que se creó con esa plantilla de flujo de negocio. Tenga en cuenta que los identificadores de plantilla de flujo de negocio distinguen mayúsculas de minúsculas.

Nota:

Si cualquiera de las revisiones de acceso que coinciden con el filtro es una revisión de acceso periódica, se devolverá un objeto accessReview para representar cada serie periódica en su conjunto, además de cualquier instancia actual, pasada y próxima. Por ejemplo, si hay una revisión de acceso periódica mensual de los miembros invitados del grupo A, una revisión de acceso periódica trimestral de los miembros invitados del grupo B y una revisión de acceso única de los miembros invitados del grupo C, cada una de estas periodicidades acaba de comenzar y el llamador consulta las revisiones de acceso con una plantilla de flujo de negocio de revisiones de los miembros invitados de grupos, se devolverán tres objetos que representan las tres series, así como tres objetos para las instancias de revisión de acceso actuales y, potencialmente, tres objetos para las próximas instancias. Para recuperar las instancias de una revisión de acceso periódica o la instancia de revisión de acceso programada para un mes o trimestre determinados, el autor de la llamada puede navegar posteriormente por la relación de instancia del objeto accessReview periódico. La relación de instancia se vincula a los objetos accessReview de las instancias actuales o anteriores de la revisión de acceso periódica.

Si muchas revisiones de acceso coinciden con el filtro, para mejorar la eficacia y evitar tiempos de espera, recupere el conjunto de resultados en las páginas, incluyendo tanto el parámetro de $top consulta con un tamaño de página, por ejemplo 100, como el parámetro de $skip=0 consulta en la solicitud. Estos parámetros se pueden incluir incluso cuando no se prevé que la solicitud abarcará varias páginas. Cuando un conjunto de resultados abarca varias páginas, Microsoft Graph devuelve esa página con una @odata.nextLink propiedad en la respuesta que contiene una dirección URL a la página siguiente de resultados. Si dicha propiedad está presente, continúe realizando solicitudes adicionales con la URL @odata.nextLink en cada respuesta, hasta que se devuelvan todos los resultados, tal y como se describe en paginación de datos de Microsoft Graph en la aplicación.

Los objetos accessReview devueltos por esta API no incluirán propiedades de estructura anidadas, como la configuración o las relaciones. Para recuperar una configuración o relaciones de revisión de acceso, use la API get accessReview .

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.Membership, AccessReview.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación AccessReview.Read.All AccessReview.ReadWrite.Membership

El usuario que ha iniciado sesión también debe estar en un rol de directorio que le permita leer una revisión de acceso.

Solicitud HTTP

GET /accessReviews?$filter=businessFlowTemplateId eq {businessFlowTemplate-id}&$top={pagesize}&$skip=0

Encabezados de solicitud

Nombre Tipo Descripción
Authorization string {token} de portador. Obligatorio.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una matriz de objetos accessReview en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra una solicitud para recuperar todas las revisiones de acceso periódicas y únicas de una plantilla de flujo de negocio "6e4f3d20-c5c3-407f-9695-8460952bcc68".

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0
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

{
    "value":[
       {
         "id": "2b83cc42-09db-46f6-8c6e-16fec466a82d",
         "displayName": "review",
         "startDateTime": "2017-11-14T01:14:54.89Z",
         "endDateTime": "2017-12-14T01:14:54.89Z",
         "status": "InProgress",
         "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
         "reviewerType": "self",
         "description": "",
         "reviewedEntity":{"id":"3b4f7e74-eb82-4120-9ff5-ba429c1ea6df","displayName":"Salesforce"}
       }
    ]
}

Contenido relacionado