Listar licenseDetails
Namespace: microsoft.graph
Obtenha uma lista de objetos licenseDetails para utilizadores empresariais. Esta API devolve detalhes para licenças atribuídas diretamente e as atribuídas transitivamente através de associações em grupos licenciados.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | LicenseAssignment.Read.All | Directory.Read.All, Directory.ReadWrite.All, User.Read, User.Read.All, User.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | User.Read | Indisponível. |
Aplicativo | Sem suporte. | Sem suporte. |
Importante
Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída ao utilizador com sessão iniciada uma função de Microsoft Entra suportada ou uma função personalizada com a permissão de microsoft.directory/users/licenseDetails/read
função. As seguintes funções com menos privilégios são suportadas para esta operação:
- Convidado
- Leitores de Diretórios
- Escritores de diretório
- Administrador de Licenças
- Administrador do usuário
Solicitação HTTP
GET /me/licenseDetails
GET /users/{id}/licenseDetails
Parâmetros de consulta opcionais
Este método suporta o $select
parâmetro de consulta. Para obter informações gerais, acesse Parâmetros de consulta OData.
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, este método devolve um 200 OK
código de resposta e uma coleção de objetos licenseDetails no corpo da resposta.
Exemplo
Solicitação
GET https://graph.microsoft.com/v1.0/me/licenseDetails
Resposta
Observação: o objeto de resposta exibido aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('48d31887-5fad-4d73-a9f5-3c356e68a038')/licenseDetails",
"value": [
{
"id": "3RnS3Gi8m0u_C0ozp5a-NWAn38eBLPdOtXhbU5K1cd8",
"skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df",
"skuPartNumber": "ENTERPRISEPREMIUM",
"servicePlans": [
{
"servicePlanId": "cd31b152-6326-4d1b-ae1b-997b625182e6",
"servicePlanName": "MIP_S_Exchange",
"provisioningStatus": "PendingProvisioning",
"appliesTo": "User"
},
{
"servicePlanId": "8e0c0a52-6a6c-4d40-8370-dd62790dcd70",
"servicePlanName": "THREAT_INTELLIGENCE",
"provisioningStatus": "Success",
"appliesTo": "User"
},
{
"servicePlanId": "9c0dab89-a30c-4117-86e7-97bda240acd2",
"servicePlanName": "POWERAPPS_O365_P3",
"provisioningStatus": "Success",
"appliesTo": "User"
},
{
"servicePlanId": "8c098270-9dd4-4350-9b30-ba4703f3b36b",
"servicePlanName": "ADALLOM_S_O365",
"provisioningStatus": "Success",
"appliesTo": "User"
},
{
"servicePlanId": "5dbe027f-2339-4123-9542-606e4d348a72",
"servicePlanName": "SHAREPOINTENTERPRISE",
"provisioningStatus": "Success",
"appliesTo": "User"
}
]
},
{
"id": "3RnS3Gi8m0u_C0ozp5a-Ne0iVHIF4g5Aqwo4mdijmMo",
"skuId": "725422ed-e205-400e-ab0a-3899d8a398ca",
"skuPartNumber": "SCHOOL_DATA_SYNC_P2",
"servicePlans": [
{
"servicePlanId": "113feb6c-3fe4-4440-bddc-54d774bf0318",
"servicePlanName": "EXCHANGE_S_FOUNDATION",
"provisioningStatus": "Success",
"appliesTo": "Company"
},
{
"servicePlanId": "500b6a2a-7a50-4f40-b5f9-160e5b8c2f48",
"servicePlanName": "SCHOOL_DATA_SYNC_P2",
"provisioningStatus": "Success",
"appliesTo": "User"
}
]
}
]
}