Získání informací o nasazení licencí

Článek
09/11/2024

Jak získat informace o nasazení licencí Office a Dynamics.

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele.

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Parametry identifikátoru URI

Parametr	Typ	Popis	Povinné
top	řetězec	Počet řádků dat, které se mají v požadavku vrátit. Maximální hodnota a výchozí hodnota, pokud není zadána, je 10000. Pokud je v dotazu více řádků, text odpovědi obsahuje další odkaz, který můžete použít k vyžádání další stránky dat.	No
Přeskočit	int	Počet řádků, které se mají v dotazu přeskočit. Pomocí tohoto parametru můžete procházet rozsáhlé datové sady. Například top=10000 a skip=0 načte prvních 10 000 řádků dat, top=10000 a skip=10000 načte dalších 10 000 řádků dat atd.	No
filter	řetězec	Parametr filter požadavku obsahuje jeden nebo více příkazů, které filtrují řádky v odpovědi. Každý příkaz obsahuje pole a hodnotu, které jsou přidružené k operátorům `eq` nebo a příkazy lze kombinovat pomocí nebo `andor`.`ne` Tady je několik ukázkových parametrů filtru : filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' nebo (channel eq 'Reseller') Můžete zadat následující pole: serviceCode Název_služby Kanál customerTenantId jméno zákazníka Productid Productname	No
Groupby	řetězec	Příkaz, který použije agregaci dat pouze na zadaná pole. Můžete zadat následující pole: serviceCode Název_služby Kanál customerTenantId jméno zákazníka Productid Productname Vrácené řádky dat budou obsahovat pole zadaná v parametru groupby a následující: licensesDeployed licensesSold	No
processedDateTime	DateTime	Můžete zadat datum, od kterého se data o využití zpracují. Výchozí hodnota je poslední datum, kdy byla data zpracována.	No

Příklad požadavku

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

Odpověď REST

V případě úspěchu obsahuje text odpovědi následující pole obsahující data o nasazených licencích.

Pole	Typ	Description
serviceCode	řetězec	Kód služby
Název_služby	řetězec	Název služby
Kanál	řetězec	Název kanálu, prodejce
customerTenantId	řetězec	Jedinečný identifikátor zákazníka
jméno zákazníka	řetězec	Jméno zákazníka
productId	řetězec	Jedinečný identifikátor produktu
Productname	řetězec	Název produktu
licensesDeployed	long	Počet nasazených licencí
licensesSold	long	Počet prodaných licencí
processedDateTime	DateTime	Datum posledního zpracování dat

Kódy úspěšných odpovědí a chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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
}

Sdílet prostřednictvím