Pobieranie informacji dotyczących wdrażania licencji

Artykuł
09/11/2024

Jak uzyskać informacje o wdrożeniu licencji pakietu Office i usługi Dynamics.

Wymagania wstępne

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

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Nagłówki żądań

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

Parametry identyfikatora URI

Parametr	Typ	Opis	Wymagane
top (pierwsze)	ciąg	Liczba wierszy danych do zwrócenia w żądaniu. Wartość maksymalna i wartość domyślna, jeśli nie zostanie określona, to 10000. Jeśli w zapytaniu znajduje się więcej wierszy, treść odpowiedzi zawiera następny link, którego można użyć do żądania następnej strony danych.	Nie
Pomiń	int	Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru do stronicowania za pośrednictwem dużych zestawów danych. Na przykład top=10000 i skip=0 pobiera pierwsze 10000 wierszy danych, top=10000 i skip=10000 pobiera kolejne 10000 wierszy danych itd.	Nie
filter	ciąg	Parametr filtru żądania zawiera co najmniej jedną instrukcję, która filtruje wiersze w odpowiedzi. Każda instrukcja zawiera pole i wartość skojarzoną z operatorami `eq` lub `ne` , a instrukcje można łączyć przy użyciu polecenia `and` lub `or`. Oto kilka przykładowych parametrów filtru : filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' lub (channel eq 'Reseller') Możesz określić następujące pola: serviceCode Servicename Kanał customerTenantId Customername Productid Productname	Nie
Groupby	ciąg	Instrukcja, która stosuje agregację danych tylko do określonych pól. Możesz określić następujące pola: serviceCode Servicename Kanał customerTenantId Customername Productid Productname Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby i następujące: licenseDeployed licensesSold	Nie
processedDateTime	DateTime	Można określić datę przetwarzania danych użycia. Wartość domyślna do najnowszej daty przetworzenia danych	Nie

Przykład żądania

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/license?filter=customerTenantId%20eq%20%27aaaabbbb-0000-cccc-1111-dddd2222eeee%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera następujące pola zawierające dane dotyczące wdrożonych licencji.

Pole	Typ	Opis
serviceCode	ciąg	Kod usługi
Servicename	ciąg	Nazwa usługi
Kanał	ciąg	Nazwa kanału, odsprzedawca
customerTenantId	ciąg	Unikatowy identyfikator klienta
Customername	ciąg	Nazwa klienta
productId	ciąg	Unikatowy identyfikator produktu
Productname	ciąg	Nazwa produktu
licenseDeployed	długi	Liczba wdrożonych licencji
licensesSold	długi	Liczba sprzedanych licencji
processedDateTime	DateTime	Data ostatniego przetworzenia danych

Kody powodzenia odpowiedzi i błędów

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ę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 4
Date: Wed, 24 Oct 2018 22:37:18 GMT
{
  "Value": [

{
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "crm",
      "serviceName": "Microsoft Dynamics",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "54B84594-9C77-4499-8D65-5E0D5F410E78",
      "productName": "DYNAMICS AX TASK",
      "licensesDeployed": 0,
      "licensesSold": 9
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}

Udostępnij za pośrednictwem