Hämta information om kundlicensdistribution
Så här hämtar du information om licensdistribution för en specifik kund.
Anteckning
Det här scenariot ersätts av hämta licensdistributionsinformation.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med app+användarautentiseringsuppgifter.
C#
Om du vill hämta aggregerade data vid distribution för en angiven kund anropar du först metoden IAggregatePartner.Customers.ById med kund-ID:t för att identifiera kunden. Hämta sedan ett gränssnitt för analysinsamlingsåtgärder på kundnivå från egenskapen Analytics . Hämta sedan ett gränssnitt till analyssamlingen för licenser på kundnivå från egenskapen Licenser . Anropa slutligen metoden Deployment.Get för att hämta aggregerade data om licensdistributionen. Om metoden lyckas får du en samling CustomerLicensesDeploymentInsights-objekt .
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Deployment.Get();
REST-begäran
Begärandesyntax
Metod | URI för förfrågan |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/analytics/licenses/deployment HTTP/1.1 |
URI-parameter
Använd följande sökvägsparameter för att identifiera kunden.
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
kund-ID | guid | Yes | Ett GUID-formaterat kund-ID som identifierar kunden. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Inga.
Exempel på begäran
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: ae3b8c36-348b-46bc-9a60-398f973153ff
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST-svar
Om det lyckas innehåller svarstexten en samling CustomerLicensesDeploymentInsights-resurser som ger information om de distribuerade licenserna.
Lyckade svar och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.
Exempel på svar
HTTP/1.1 200 OK
Content-Length: 1012
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
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"
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för