Ügyféllicencek üzembehelyezési adatainak lekérése

Licencek üzembehelyezési megállapításainak lekérése egy adott ügyfélhez.

Megjegyzés

Ezt a forgatókönyvet felülírja a Licencek üzembehelyezési információinak lekérése.

Előfeltételek

Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az App+Felhasználói hitelesítő adatokkal való hitelesítést.

C#

Egy adott ügyfél üzembe helyezésével kapcsolatos összesített adatok lekéréséhez először hívja meg az IAggregatePartner.Customers.ById metódust az ügyfél-azonosítóval az ügyfél azonosításához. Ezután szerezzen be egy felületet az ügyfélszintű elemzési gyűjtési műveletekhez az Analytics tulajdonságból. Ezután kérjen le egy felületet az ügyfélszintű licencek elemzési gyűjteményéhez a Licencek tulajdonságból. Végül hívja meg a Deployment.Get metódust a licencek üzembe helyezésének összesített adatainak lekéréséhez. Ha a metódus sikeres, a CustomerLicensesDeploymentInsights objektumokat fogja megkapni.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Deployment.Get();

REST-kérelem

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customer-id}/analytics/licenses/deployment HTTP/1.1

URI-paraméter

Az ügyfél azonosításához használja az alábbi elérésiút-paramétert.

Név	Típus	Kötelező	Leírás
ügyfél-azonosító	guid	Yes	Az ügyfelet azonosító GUID formátumú ügyfél-azonosító.

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

Nincsenek.

Példa kérésre

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

REST-válasz

Ha sikerült, a válasz törzse a CustomerLicensesDeploymentInsights-erőforrások gyűjteményét tartalmazza, amelyek információt nyújtanak az üzembe helyezett licencekről.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont REST-hibakódjai című témakörben találja.

Példa válaszra

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"
    }
}