Gebruiksgegevens van klantlicenties ophalen
Inzicht krijgen in de implementatie van licenties voor een specifieke klant.
Notitie
Dit scenario wordt vervangen door gebruiksgegevens voor licenties ophalen.
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met app+gebruikersreferenties.
C#
Als u geaggregeerde gegevens over de implementatie voor een opgegeven klant wilt ophalen, roept u eerst de methode IAggregatePartner.Customers.ById aan met de klant-id om de klant te identificeren. Haal vervolgens een interface op voor analyseverzamelingsbewerkingen op klantniveau vanuit de eigenschap Analytics. Haal vervolgens een interface op voor de analyseverzameling licenties op klantniveau uit de eigenschap Licenties. Roep tot slot de methode Usage.Get aan om de geaggregeerde gegevens over het gebruik van licenties op te halen. Als de methode slaagt, krijgt u een verzameling CustomerLicensesUsageInsights-objecten.
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Usage.Get();
REST-aanvraag
Aanvraagsyntaxis
Methode | Aanvraag-URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/analytics/licenses/usage HTTP/1.1 |
URI-parameter
Gebruik de volgende padparameter om de klant te identificeren.
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
klant-id | guid | Ja | Een door DE GUID opgemaakte klant-id die de klant identificeert. |
Aanvraagheaders
Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
Geen.
Aanvraagvoorbeeld
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: ae3b8c36-348b-46bc-9a60-398f973153ff
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Belangrijk
Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.
Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.
REST-antwoord
Als dit lukt, bevat de antwoordtekst een verzameling CustomerLicensesUsageInsights-resources die informatie bieden over het gebruik van licenties.
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.
Responsvoorbeeld
HTTP/1.1 200 OK
Content-Length: 1726
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ae3b8c36-348b-46bc-9a60-398f973153ff
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"
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor