Licencek lekérése egy felhasználóhoz egy ügyfélfiókon belül

A felhasználókhoz hozzárendelt licencek listájának lekérése egy ügyfélfiókon belül. Az itt látható példák a Microsoft Entra ID által felügyelt licenceket képviselő alapértelmezett licenccsoport, az 1. csoporthoz rendelt licenceket ad vissza. Ha licenceket szeretne hozzárendelni a megadott licenccsoportokhoz, olvassa el a felhasználóhoz hozzárendelt licencek lekérése licenccsoportonként című témakört.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

• Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

• Egy felhasználói azonosító.

C#

Annak ellenőrzéséhez, hogy mely licencek vannak hozzárendelve egy felhasználóhoz az alapértelmezett 1. csoport licenccsoportból, először használja az IAggregatePartner.Customers.ById metódust az ügyfél azonosítójával az ügyfél azonosításához. Ezután hívja meg a Users.ById metódust a felhasználó azonosítójával a felhasználó azonosításához. Ezután szerezze be az ügyfélfelhasználói licencműveletek felületét a Licencek tulajdonságból. Végül hívja meg a Get vagy a GetAsync metódust a felhasználóhoz rendelt licencek gyűjteményének lekéréséhez.

// string selectedCustomerUserId;
// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var customerUserAssignedLicenses = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Licenses.Get();

Példa: Konzoltesztelő alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: CustomerUserAssignedLicenses.cs

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customer-id}/users/{user-id}/licenses HTTP/1.1

URI-paraméter

Az ügyfél és a felhasználó azonosításához használja az alábbi elérésiút-paramétereket.

Név	Típus	Kötelező	Leírás
ügyfél-azonosító	sztring	Igen	Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
felhasználó-azonosító	sztring	Igen	A felhasználót azonosító GUID formátumú sztring.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

Nincs.

Példa kérése

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

REST-válasz

Ha sikeres, a válasz törzse tartalmazza a licencerőforrások gyűjteményét.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont hibakódjaiban találja.

Példa válaszra

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"
    }
}