Ottenere un elenco delle licenze disponibili
Questo articolo descrive come ottenere un elenco di licenze disponibili per gli utenti del cliente specificato.
Gli esempi seguenti restituiscono le licenze disponibili da group1, il gruppo di licenze predefinito che rappresenta le licenze gestite dall'ID Microsoft Entra. Per ottenere licenze disponibili per un gruppo di licenze specificato, vedere Ottenere un elenco delle licenze disponibili per gruppo di licenze.
Prerequisiti
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (
customer-tenant-id
). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id
).
Ruoli GDAP
Sono necessari almeno uno dei ruoli GDAP seguenti:
- Ruolo con autorizzazioni di lettura della directory
- Lettore globale
- Amministratore utenti
- Amministratore licenze
C#
Per recuperare l'elenco delle licenze disponibili dal gruppo di licenze predefinito agli utenti di un cliente:
Usare il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente.
Ottenere il valore della proprietà SubscribedSkus per recuperare un'interfaccia per le operazioni di raccolta sku sottoscritte dal cliente.
Chiamare il metodo Get o GetAsync per recuperare l'elenco di licenze.
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
var customerUserSubscribedSkus = partnerOperations.Customers.ById(selectedCustomerId).SubscribedSkus.Get();
Per un esempio, vedere quanto segue:
- Esempio: App di test della console
- Progetto: Esempi di SDK del Centro per i partner
- Classe: GetCustomerSubscrittoSkus.cs
Richiesta REST
Sintassi della richiesta
Metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/subscribedskus HTTP/1.1 |
Parametro URI
Usare il parametro di percorso seguente per identificare il cliente.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
customer-id | stringa | Sì | Stringa con formato GUID che identifica il cliente. |
Intestazioni delle richieste
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Corpo della richiesta
Nessuno.
Esempio di richiesta
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscribedskus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 53308f82-1bf7-44e2-8dda-4517e4688bd4
MS-CorrelationId: 95660db2-7425-4021-babe-a26ddbcb0187
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Risposta REST
In caso di esito positivo, il corpo della risposta contiene una raccolta di risorse SubscribedSku .
Codici di errore e di esito della risposta
Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per un elenco completo, vedere Codici di errore REST del Centro per i partner.
Risposta di esempio
HTTP/1.1 200 OK
Content-Length: 4859
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 95660db2-7425-4021-babe-a26ddbcb0187
MS-RequestId: 53308f82-1bf7-44e2-8dda-4517e4688bd4
MS-CV: 7BQ0jitzXUCLwRM6.0
MS-ServerId: 020021921
Date: Fri, 09 Jun 2017 17:50:46 GMT
{
"totalCount": 2,
"items": [{
"availableUnits": 4,
"activeUnits": 5,
"consumedUnits": 1,
"suspendedUnits": 0,
"totalUnits": 5,
"warningUnits": 0,
"productSku": {
"id": "efccb6f7-5641-4e0e-bd10-b4976e1bf68e",
"name": "Enterprise Mobility + Security E3",
"skuPartNumber": "EMS",
"targetType": "User",
"licenseGroupId": "group1"
},
"servicePlans": [{
"displayName": "Azure Information Protection Premium P1",
"serviceName": "RMS_S_PREMIUM",
"id": "6c57d4b6-3b23-47a5-9bc9-69f17b4947b3",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Microsoft Intune A Direct",
"serviceName": "INTUNE_A",
"id": "c1ec4a95-1f05-45b3-a911-aa3fa01094f5",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Microsoft Azure Active Directory Rights",
"serviceName": "RMS_S_ENTERPRISE",
"id": "bea4c11e-220a-4e6d-8eb8-8ea15d019f90",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Azure Active Directory Premium P1",
"serviceName": "AAD_PREMIUM",
"id": "41781fb2-bc02-4b7c-bd55-b576c07bb09d",
"capabilityStatus": "Enabled",
"targetType": "User"
}, {
"displayName": "Microsoft Azure Multifactor Authentication",
"serviceName": "MFA_PREMIUM",
"id": "8a256a2b-b617-496d-b51b-e76466e88db0",
"capabilityStatus": "Enabled",
"targetType": "User"
}
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}, {
"availableUnits": 0,
"activeUnits": 1,
"consumedUnits": 1,
"suspendedUnits": 0,
"totalUnits": 1,
"warningUnits": 0,
"productSku": {
"id": "f8a1db68-be16-40ed-86d5-cb42ce701560",
"name": "Power BI Pro",
"skuPartNumber": "POWER_BI_PRO",
"targetType": "User",
"licenseGroupId": "group1"
},
"servicePlans": [{
"displayName": "Exchange Foundation",
"serviceName": "EXCHANGE_S_FOUNDATION",
"id": "113feb6c-3fe4-4440-bddc-54d774bf0318",
"capabilityStatus": "Enabled",
"targetType": "Tenant"
}, {
"displayName": "Power BI Pro",
"serviceName": "BI_AZURE_P2",
"id": "70d33638-9c74-4d01-bfd3-562de28bd4ba",
"capabilityStatus": "Enabled",
"targetType": "User"
}
],
"capabilityStatus": "Enabled",
"attributes": {
"objectType": "SubscribedSku"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per