Získání informací o využití licencí pro zákazníky
Jak získat přehledy o nasazení licencí pro konkrétního zákazníka
Poznámka
Tento scénář je nadhodnocený získáním informací o využití licencí.
Požadavky
Přihlašovací údaje popsané v ověřování v Partnerském centru 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 bude metoda úspěšná, získáte kolekci objektů CustomerLicensesUsage Přehledy.
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Usage.Get();
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI žádosti |
---|---|
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žaduje se | Popis |
---|---|---|---|
ID zákazníka | guid | Ano | IDENTIFIKÁTOR GUID naformátovaný id zákazníka, které identifikuje zákazníka. |
Záhlaví žádosti
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. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.
Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.
Odpověď REST
V případě úspěchu obsahuje text odpovědi kolekci CustomerLicensesUsage Přehledy prostředky, které poskytují 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 najdete v tématu Kódy chyb 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"
}
}