如何取得特定客戶的授權部署見解。
注意
取得授權使用資訊取代了此情境。
先決條件
合作夥伴中心驗證中所述的憑證。 此案例支援使用App+User認證進行驗證。
C#
若要擷取指定客戶的部署匯總數據，請先使用客戶標識符來呼叫 IAggregatePartner.Customers.ById 方法來識別客戶。 然後，從 Analytics 屬性獲取與客戶層級分析收集作業相關的介面。 接下來，從 Licenses 屬性擷取客戶層級授權分析集合的介面。 最後，呼叫 Usage.Get 方法來取得授權使用量的匯總數據。 如果方法成功，您將取得 CustomerLicensesUsageInsights 物件的集合。
// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;
var customerLicensesDeploymentAnalytics = partnerOperations.Customers.ById(customerIdToRetrieve).Analytics.Licenses.Usage.Get();
REST 要求
請求語法
| 方法 | 要求 URI |
|---|---|
| 取得 | {baseURL}/v1/customers/{customer-id}/analytics/licenses/usage HTTP/1.1 |
URI 參數
使用下列路徑參數來識別客戶。
| 名字 | 類型 | 必填 | 描述 |
|---|---|---|---|
| 客戶編號 | guid | 是的 | 識別客戶的 GUID 格式客戶識別碼。 |
要求標頭
請求主體
沒有。
要求範例
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
重要
自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。 您可以從 GitHub下載 SDK 版本，以及包含實用資訊的 自述檔。
鼓勵合作夥伴繼續使用 合作夥伴中心 REST API。
REST 回應
如果成功，回應本文會包含 CustomerLicensesUsageInsights 資源，以提供授權使用情況的相關資訊。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱 合作夥伴中心 REST 錯誤碼。
回應範例
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"
}
}