Enumeración de asignacionesRequests
Espacio de nombres: microsoft.graph
En Microsoft Entra administración de derechos, recupere una lista de objetos accessPackageAssignmentRequest. La lista resultante incluye todas las solicitudes de asignación, actuales y expiradas, a las que el autor de la llamada tiene acceso para leer en todos los catálogos y paquetes de acceso.
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) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
Solicitud HTTP
GET /identityGovernance/entitlementManagement/assignmentRequests
Parámetros de consulta
Este método admite los $select
parámetros de consulta y $expand
$filter
OData para ayudar a personalizar la respuesta. No se admiten todos los atributos de un accessPackageAssignmentRequest para el filtrado.
Si el usuario o la aplicación solo tiene permisos dentro de un catálogo o catálogos específicos, debe incluir en la consulta un filtro que especifique un paquete de acceso, como $expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea'
.
Escenarios de ejemplo para usar parámetros de consulta
- Para recuperar las solicitudes creadas después de una fecha específica, incluya
$filter=createdDateTime gt 2022-04-01T00:00:01Z
en la consulta. - Para recuperar el paquete de acceso de cada solicitud, incluya
$expand=accessPackage
en la consulta. - Para recuperar la asignación resultante, incluya
$expand=assignment
en la consulta. - Para obtener más detalles sobre el solicitante, incluya
$expand=requestor
en la consulta.
Para obtener información general, vea Parámetros de consulta OData.
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 accessPackageAssignmentRequest en el cuerpo de la respuesta.
Ejemplos
Solicitud
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests
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": "7999249e-249e-7999-9e24-99799e249979",
"requestType": "userAdd",
"state": "delivered",
"status": "Delivered",
"createdDateTime": "2019-10-25T22:55:11.623Z",
"completedDateTime": "2019-10-26T22:55:11.623Z",
"schedule": {
"@odata.type": "microsoft.graph.entitlementManagementSchedule"
}
}
]
}