Listar subscribedSkus
Namespace: microsoft.graph
Obtenha a lista de assinaturas comerciais que uma organização adquiriu. Para obter o mapeamento de nomes de licenças conforme apresentado no centro de administração do Microsoft Entra ou no centro de administração do Microsoft 365 relativamente às respetivas propriedades skuId e skuPartNumber do Microsoft Graph, consulte Nomes de produtos e identificadores do plano de serviço para licenciamento.
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) | Organization.Read.All | Directory.Read.All, Directory.ReadWrite.All, Organization.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | Organization.Read.All | Directory.Read.All, Directory.ReadWrite.All, Organization.ReadWrite.All |
Solicitação HTTP
GET /subscribedSkus
Parâmetros de consulta opcionais
Este método suporta apenas o $select
parâmetro de consulta OData para ajudar a personalizar a resposta. Ele não oferece suporte $filter
.
Observação
Esta API tem um problema conhecido relacionado com o $search
parâmetro .
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 bem-sucedido, este método retorna um código de resposta 200 OK
e uma coleção de objetos subscribedSku no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/subscribedSkus
Resposta
O exemplo a seguir mostra a 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#subscribedSkus",
"value": [
{
"accountName": "Sample account One",
"accountId": "f97aeefc-af85-414d-8ae4-b457f90efc40",
"appliesTo": "User",
"capabilityStatus": "Enabled",
"consumedUnits": 14,
"id": "48a80680-7326-48cd-9935-b556b81d3a4e_c7df2760-2c81-4ef7-b578-5b5392b571df",
"prepaidUnits": {
"enabled": 25,
"lockedOut": 0,
"suspended": 0,
"warning": 0
},
"servicePlans": [
{
"servicePlanId": "8c098270-9dd4-4350-9b30-ba4703f3b36b",
"servicePlanName": "ADALLOM_S_O365",
"provisioningStatus": "Success",
"appliesTo": "Company"
}
],
"skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df",
"skuPartNumber": "ENTERPRISEPREMIUM",
"subscriptionIds": ["43d26afe-cb98-48b9-acc4-ae3ef2ac6c51"]
},
{
"accountName": "Sample account Two",
"accountId": "ee045480-0260-4c1e-b946-55842502229c",
"appliesTo": "User",
"capabilityStatus": "Suspended",
"consumedUnits": 14,
"id": "48a80680-7326-48cd-9935-b556b81d3a4e_d17b27af-3f49-4822-99f9-56a661538792",
"prepaidUnits": {
"enabled": 0,
"lockedOut": 0,
"suspended": 25,
"warning": 0
},
"servicePlans": [
{
"servicePlanId": "f9646fb2-e3b2-4309-95de-dc4833737456",
"servicePlanName": "CRMSTANDARD",
"provisioningStatus": "Disabled",
"appliesTo": "User"
}
],
"skuId": "d17b27af-3f49-4822-99f9-56a661538792",
"skuPartNumber": "CRMSTANDARD",
"subscriptionIds": ["15c301e0-c769-4f12-bab1-1e8519a7a6f1"]
}
]
}