Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
No Gerenciamento de Direitos do Microsoft Entra, recupere uma lista de objetos accessPackageAssignment filtrados no usuário conectado.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | EntitlementMgmt-SubjectAccess.ReadWrite | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
GET /identityGovernance/entitlementManagement/accessPackageAssignments/filterByCurrentUser(on='parameterValue')
Parâmetros de função
A tabela a seguir mostra os parâmetros que podem ser usados com esta função.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| on | accessPackageAssignmentFilterByCurrentUserOptions | A lista de opções de usuário atuais que podem ser usadas para filtrar na lista de atribuições de pacote de acesso. Os valores possíveis são: target, createdBy. |
targeté usado para obter osaccessPackageAssignmentobjetos em que o usuário conectado é o destino. A lista resultante inclui todas as atribuições, atuais e expiradas, para o chamador em todos os catálogos e pacotes de acesso.createdByé usado para obter osaccessPackageAssignmentobjetos criados pelo usuário conectado. A lista resultante inclui todas as atribuições que o chamador criou para si mesmo ou em nome de outras pessoas, como no caso de atribuição direta do administrador, em todos os catálogos e pacotes de acesso.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um código de 200 OK resposta e uma coleção accessPackageAssignment no corpo da resposta.
Quando um conjunto de resultados se estende por várias páginas, o Microsoft Graph retorna essa página com uma @odata.nextLink propriedade na resposta que contém uma URL para a próxima página de resultados. Se essa propriedade estiver presente, continue fazendo mais solicitações com a @odata.nextLink URL em cada resposta, até que todos os resultados sejam retornados. Para obter mais informações, consulte paginação de dados do Microsoft Graph em seu aplicativo.
Exemplos
O exemplo a seguir obtém o status das atribuições de pacote de acesso direcionadas ao usuário conectado.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/filterByCurrentUser(on='target')
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.accessPackageAssignment",
"id": "5521fb4f-6a6c-410a-9191-461a65fd39d4",
"catalogId": "34cfe9a8-88bc-4c82-b3d8-6b77d7035c33",
"accessPackageId": "ca6992f8-e413-49a1-9619-c9819f4f73e0",
"assignmentPolicyId": "7c6e6874-789e-4f11-b351-cc7b5883deef",
"targetId": "2cb14f51-0108-41d8-89da-cd0e05e2c988",
"assignmentStatus": "Delivered",
"assignmentState": "Delivered",
"isExtended": false,
"expiredDateTime": null,
"schedule": {
"startDateTime": "2021-01-19T20:02:36.013Z",
"recurrence": null,
"expiration": {
"endDateTime": "2022-01-19T20:02:36.013Z",
"duration": null,
"type": "afterDateTime"
}
}
}
]
}