Uzyskiwanie informacji o użyciu licencji klienta

Artykuł
03/08/2025

Jak uzyskać szczegółowe informacje dotyczące wdrażania licencji dla określonego klienta.

Notatka

Ten scenariusz jest zastępowany przez Uzyskiwanie informacji o użyciu licencji.

Warunki wstępne

Poświadczenia zgodnie z opisem w Centrum partnerskiego uwierzytelniania. Ten scenariusz obsługuje uwierzytelnianie przy użyciu poświadczeń aplikacji i użytkownika.

C#

Aby pobrać zagregowane dane dotyczące wdrożenia określonego klienta, najpierw wywołaj metodę IAggregatePartner.Customers.ById z identyfikatorem klienta, aby zidentyfikować klienta. Następnie pobierz interfejs do operacji zbierania danych analitycznych na poziomie klienta z parametru Analytics. Następnie pobierz interfejs do zbioru analizy licencji na poziomie klienta z właściwości licencji. Na koniec wywołaj metodę Usage.Get, aby uzyskać zagregowane dane dotyczące użycia licencji. Jeśli metoda zakończy się pomyślnie, otrzymasz kolekcję obiektów CustomerLicensesUsageInsights.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Usage.Get();

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/customers/{customer-id}/analytics/licenses/usage HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru ścieżki, aby zidentyfikować klienta.

Nazwa	Typ	Wymagane	Opis
identyfikator klienta	guid	Tak	Identyfikator klienta w formacie GUID, który identyfikuje klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST w Centrum partnerskim.

Treść żądania

Żaden.

Przykład żądania

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/analytics/licenses/usage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f657d2a8-9ed6-41b4-abfc-3cf4abebd62f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Ważny

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z witryny GitHub, a także plik README , który zawiera przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST centrum partnerskiego.

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera kolekcję CustomerLicensesUsageInsights zasobów, które zawierają informacje o użyciu licencji.

Kody statusu powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, sprawdź Kody błędów Centrum partnerskiego REST.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 1726
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f657d2a8-9ed6-41b4-abfc-3cf4abebd62f
MS-CV: 0mufM0K1kEOoR7oI.0
MS-ServerId: 030020525
Date: Wed, 15 Mar 2017 01:19:58 GMT

{
    "totalCount": 5,
    "items": [{
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "SharePoint",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "OFFICE 365 BUSINESS ESSENTIALS",
            "licensesActive": 0,
            "licensesQualified": 1,
            "usagePercent": 0.0,
            "workloadName": "Skype For Business",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE (PLAN 1)",
            "licensesActive": 0,
            "licensesQualified": 5,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }, {
            "customerName": "DT DEMO CSP CUSTOMER 005",
            "productName": "EXCHANGE ONLINE ARCHIVING FOR EXCHANGE ONLINE",
            "licensesActive": 0,
            "licensesQualified": 2,
            "usagePercent": 0.0,
            "workloadName": "Exchange",
            "processedDateTime": "2017-03-09T00:00:00+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "CustomerLicensesUsageInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Udostępnij za pośrednictwem