Získání informací o využití licencí zákazníků
Jak získat přehledy o nasazení licencí pro konkrétního zákazníka
Poznámka
Tento scénář je nahrazen scénářem Získání informací o využití licencí.
Požadavky
Přihlašovací údaje, jak je uvedeno v ověřování Partnerského centra. Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele.
C#
Pokud chcete načíst agregovaná data o nasazení pro zadaného zákazníka, nejprve zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka a identifikujte zákazníka. Pak z vlastnosti Analytics získejte rozhraní pro operace shromažďování analýz na úrovni zákazníka. V dalším kroku načtěte rozhraní pro kolekci analýz licencí na úrovni zákazníka z vlastnosti Licence. Nakonec zavolejte metodu Usage.Get, která získá agregovaná data o využití licencí. Pokud je metoda úspěšná, získáte kolekci CustomerLicensesUsageInsights objektů.
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Usage.Get();
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI požadavku |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/analytics/licenses/usage HTTP/1.1 |
Parametr identifikátoru URI
Pomocí následujícího parametru cesty identifikujte zákazníka.
Jméno | Typ | Požadováno | Popis |
---|---|---|---|
ID zákazníka | identifikátor GUID | Ano | ID zákazníka ve formátu GUID, které identifikuje zákazníka. |
Hlavičky požadavku
Další informace najdete v tématu hlavičky REST Partnerského centra.
Text požadavku
Žádný.
Příklad požadavku
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
Důležitý
Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.
Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.
Odpověď REST
V případě úspěchu obsahuje tělo odpovědi kolekci prostředku CustomerLicensesUsageInsights, který poskytuje informace o využití licencí.
Kódy úspěšnosti a chyb odpovědi
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 pro trasování sítě. Úplný seznam viz kódy chyb rozhraní REST v Partnerském centru.
Příklad odpovědi
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"
}
}