Abrufen der einem Benutzer zugewiesenen Lizenzen nach Lizenzgruppe
So erhalten Sie eine Liste der vom Benutzer zugewiesenen Lizenzen für die angegebenen Lizenzgruppen.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (
customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).Eine Benutzer-ID.
Eine Liste mit mindestens einem Lizenzgruppenbezeichner.
GDAP-Rollen
Sie benötigen mindestens eine der folgenden GDAP-Rollen:
- Verzeichnis lesen
- Lizenzadministrator
- Benutzeradministrator
- Verzeichnis schreiben
C#
Um zu überprüfen, welche Lizenzen einem Benutzer aus angegebenen Lizenzgruppen zugewiesen sind, instanziieren Sie zunächst ein [List/dotnet/api/system.collections.generic.list-1) vom Typ LicenseGroupId, und fügen Sie dann die Lizenzgruppen zur Liste hinzu. Verwenden Sie dann die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID, um den Kunden zu identifizieren. Rufen Sie als Nächstes die Users.ById-Methode mit der Benutzer-ID auf, um den Benutzer zu identifizieren. Rufen Sie dann über die Eigenschaft "Licenses " eine Schnittstelle zu Benutzerlizenzvorgängen für Kunden ab. Übergeben Sie schließlich die Liste der Lizenzgruppen an die Get - oder GetAsync-Methode , um die Sammlung von Lizenzen abzurufen, die dem Benutzer zugewiesen sind.
// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// To get the group1 (Azure Active Directory (AAD)) assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group1 };
var customerUserAadAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
// To get the group2 (Minecraft) assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group2 };
var customerUserSfbAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
// To get both AAD and Minecraft assigned licenses.
List<LicenseGroupId> licenseGroupIds = new List<LicenseGroupId>(){ LicenseGroupId.Group1, LicenseGroupId.Group2 };
var customerUserBothAadAndSfbAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get(licenseGroupIds);
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses?licenseGroupIds=Group1 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses?licenseGroupIds=Group2 HTTP/1.1 |
| GET | {baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses?licenseGroupIds=Group1&licenseGroupIds=Group2 HTTP/1.1 |
URI-Parameter
Verwenden Sie die folgenden Pfad- und Abfrageparameter, um die Kunden-, Benutzer- und Lizenzgruppen zu identifizieren.
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| Kunden-ID | Zeichenfolge | Ja | Eine guid formatierte Zeichenfolge, die den Kunden identifiziert. |
| user-id | Zeichenfolge | Ja | Eine guid formatierte Zeichenfolge, die den Benutzer identifiziert. |
| licenseGroupIds | Zeichenfolge | Nein | Ein Enumerationswert, der die Lizenzgruppe der zugewiesenen Lizenzen angibt. Gültige Werte: Group1, Group2 Group1 – Diese Gruppe verfügt über alle Produkte, deren Lizenz in der Microsoft Entra-ID verwaltet werden kann. Group2 – Diese Gruppe verfügt nur über Minecraft-Produktlizenzen. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Beispiel für eine Anfrage
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/users/482e2152-4b49-48ec-b715-823365ce3d4c/licenses?licenseGroupIds=Group1&licenseGroupIds=Group2 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: a1d077e4-28b1-4578-b873-6d1a82fa1644
MS-CorrelationId: c8cb5a60-ae08-4afc-92f0-efc42adfa186
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST-Antwort
Bei erfolgreicher Ausführung enthält der Antworttext die Sammlung von Lizenzressourcen .
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-Fehlercodes.
Beispielantwort
HTTP/1.1 200 OK
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST
{
"totalCount": 2,
"items": [{
"servicePlans": [
],
"productSku": {
"id": "984df360-9a74-4647-8cf8-696749f6247a",
"name": "Minecraft Education Edition Faculty",
"skuPartNumber": "CFQ7TTC0K5DR/0002",
"licenseGroupId": "group2"
},
"attributes": {
"objectType": "License"
}
}, {
"servicePlans": [{
"displayName": "Windows Defender Advanced Threat Protection",
"serviceName": "WINDEFATP",
"id": "871d91ec-ec1a-452b-a83f-bd76c7d770ef",
"capabilityStatus": "Assigned",
"targetType": "User"
}, {
"displayName": "Windows 10 Enterprise E3",
"serviceName": "WIN10_PRO_ENT_SUB",
"id": "21b439ba-a0ca-424f-a6cc-52f954a5b111",
"capabilityStatus": "Assigned",
"targetType": "User"
}
],
"productSku": {
"id": "1e7e1070-8ccb-4aca-b470-d7cb538cb07e",
"name": "Windows 10 Enterprise E5",
"skuPartNumber": "WIN_ENT_E5",
"licenseGroupId": "group1"
},
"attributes": {
"objectType": "License"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Antwortbeispiel (keine übereinstimmenden Lizenzen gefunden)
Wenn für die angegebenen Lizenzgruppen keine übereinstimmenden Lizenzen gefunden werden können, enthält die Antwort eine leere Auflistung mit einem totalCount-Element, dessen Wert 0 ist.
HTTP/1.1 200 OK
Content-Length: 71
Content-Type: application/json; charset=utf-8
MS-CorrelationId: c8cb5a60-ae08-4afc-92f0-efc42adfa186
MS-RequestId: a1d077e4-28b1-4578-b873-6d1a82fa1644
MS-CV: q05xrhUeDUKvhrFt.0
MS-ServerId: 030020525
Date: Fri, 09 Jun 2017 22:50:11 GMT
{
"totalCount": 0,
"items": [],
"attributes": {
"objectType": "Collection"
}
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für