Získání informací o nasazení 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 nadřazený získáním informací o nasazení licencí.
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.
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 k identifikaci zákazníka. Pak z vlastnosti Analytics získejte rozhraní pro operace shromažďování analýz na úrovni zákazníka. Dále načtěte rozhraní pro kolekci analýz licencí na úrovni zákazníka z vlastnosti Licence . Nakonec zavolejte metodu Deployment.Get , abyste získali agregovaná data o nasazení licencí. Pokud metoda proběhne úspěšně, získáte kolekci objektů CustomerLicensesDeploymentInsights .
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Deployment.Get();
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI žádosti |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/analytics/licenses/deployment HTTP/1.1 |
Parametr identifikátoru URI
K identifikaci zákazníka použijte následující parametr path.
Název | Typ | Vyžadováno | Popis |
---|---|---|---|
customer-ID | guid | Yes | Identifikátor GUID ve formátu customer-ID, 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/deployment HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b01b8759-4dbe-4605-adb7-e5839a796c33
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 kolekci prostředků CustomerLicensesDeploymentInsights , které poskytují informace o nasazených licencích.
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: 1012
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: b01b8759-4dbe-4605-adb7-e5839a796c33
MS-CV: deEp2Wy6DUitMCYA.0
MS-ServerId: 102030524
Date: Wed, 15 Mar 2017 01:19:18 GMT
{
"totalCount": 3,
"items": [{
"customerName": "DT DEMO CSP CUSTOMER 005",
"productName": "OFFICE 365 BUSINESS ESSENTIALS",
"licensesDeployed": 0,
"deploymentPercent": 0.0,
"licensesSold": 1,
"processedDateTime": "2017-03-14T03:25:16.36+00:00",
"serviceName": "o365",
"channel": "reseller",
"attributes": {
"objectType": "CustomerLicensesDeploymentInsights"
}
}, {
"customerName": "DT DEMO CSP CUSTOMER 005",
"productName": "EXCHANGE ONLINE (PLAN 1)",
"licensesDeployed": 0,
"deploymentPercent": 0.0,
"licensesSold": 5,
"processedDateTime": "2017-03-14T03:25:16.36+00:00",
"serviceName": "o365",
"channel": "reseller",
"attributes": {
"objectType": "CustomerLicensesDeploymentInsights"
}
}, {
"customerName": "DT DEMO CSP CUSTOMER 005",
"productName": "EXCHANGE ONLINE ARCHIVING FOR EXCHANGE ONLINE",
"licensesDeployed": 0,
"deploymentPercent": 0.0,
"licensesSold": 2,
"processedDateTime": "2017-03-14T03:25:16.36+00:00",
"serviceName": "o365",
"channel": "reseller",
"attributes": {
"objectType": "CustomerLicensesDeploymentInsights"
}
}
],
"attributes": {
"objectType": "Collection"
}
}