Ottenere le licenze assegnate a un utente all'interno di un account cliente
Questo articolo descrive come ottenere un elenco di licenze assegnate a un utente all'interno di un account cliente.
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
).Identificatore utente.
Ruoli GDAP
Sono necessari almeno uno dei ruoli GDAP seguenti:
- Ruolo con autorizzazioni di lettura della directory
- Amministratore licenze
- Amministratore utenti
- Ruolo con autorizzazioni di scrittura nella directory
C#
Per verificare quali licenze vengono assegnate a un utente dal gruppo di licenze group1 predefinito, usare prima di tutto il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente. Chiamare quindi il metodo Users.ById con l'ID utente per identificare l'utente. Ottenere quindi un'interfaccia per le operazioni di licenza utente del cliente dalla proprietà Licenses . Chiamare infine il metodo Get o GetAsync per recuperare la raccolta di licenze assegnate all'utente.
// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
var customerUserAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get();
Esempio: App di test della console. Progetto: Classe di esempi sdk del Centro per i partner: CustomerUserAssignedLicenses.cs
Richiesta REST
Sintassi della richiesta
metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses HTTP/1.1 |
Parametro URI
Usare i parametri di percorso seguenti per identificare il cliente e l'utente.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
customer-id | string | Sì | Stringa con formato GUID che identifica il cliente. |
user-id | string | Sì | Stringa con formattazione GUID che identifica l'utente. |
Intestazioni delle richieste
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Testo della richiesta
Nessuno.
Esempio di richiesta
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/users/482e2152-4b49-48ec-b715-823365ce3d4c/licenses HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Risposta REST
In caso di esito positivo, il corpo della risposta contiene la raccolta di risorse license .
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 l'elenco completo, vedere Codici di errore del Centro per i partner.
Risposta di esempio
HTTP/1.1 200 OK
Content-Length: 3883
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 813f15b3-eb18-4709-b2f3-668d62babf91
MS-RequestId: 68e50b00-e1ff-422a-a293-158617463d41
MS-CV: WYkHYMfWTUajFosK.0
MS-ServerId: 020021921
Date: Fri, 09 Jun 2017 00:29:24 GMT
{
"totalCount": 1,
"items": [{
"servicePlans": [{
"displayName": "Azure Information Protection Premium P1",
"serviceName": "RMS_S_PREMIUM",
"id": "6c57d4b6-3b23-47a5-9bc9-69f17b4947b3",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Microsoft Intune A Direct",
"serviceName": "INTUNE_A",
"id": "c1ec4a95-1f05-45b3-a911-aa3fa01094f5",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Microsoft Azure Active Directory Rights",
"serviceName": "RMS_S_ENTERPRISE",
"id": "bea4c11e-220a-4e6d-8eb8-8ea15d019f90",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Azure Active Directory Premium P1",
"serviceName": "AAD_PREMIUM",
"id": "41781fb2-bc02-4b7c-bd55-b576c07bb09d",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Microsoft Azure Multifactor Authentication",
"serviceName": "MFA_PREMIUM",
"id": "8a256a2b-b617-496d-b51b-e76466e88db0",
"capabilityStatus": "Assigned",
"targetType": "User"
}
],
"productSku": {
"id": "efccb6f7-5641-4e0e-bd10-b4976e1bf68e",
"name": "Enterprise Mobility + Security E3",
"skuPartNumber": "EMS",
"licenseGroupId": "group1"
},
"attributes": {
"objectType": "License"
}
}
],
"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