取得授權部署資訊

發行項
09/11/2024

如何取得 Office 和 Dynamics 授權的部署資訊。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用應用程式加上使用者的認證來進行驗證。

REST 要求

要求的語法

方法	要求 URI
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

URI 參數

參數	類型	描述	必要
top	string	在要求中傳回的資料列數目。如果未指定，最大值和預設值為 10000。如果查詢中有更多資料列，回應主體將會包含您可以用來要求下一頁資料的下一頁連結。	No
skip	int	在查詢中要略過的資料列數目。使用此參數來瀏覽大型資料集。例如，top=10000 且 skip=0 將擷取前 10000 個資料列的資料，top=10000 且 skip=10000 將擷取下 10000 個資料列的資料，以此類推。	No
filter	string	要求的 filter 參數包含在回應中篩選資料列的一或多個陳述式。每個語句都包含與或 `ne` 運算子相關聯的 `eq` 欄位和值，而語句可以使用或 `or` 結合 `and` 。下列為一些範例 filter 參數： filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' 或 (通道 eq 'Reseller') 您可以指定下列欄位： serviceCode serviceName 通道 customerTenantId customerName productId productName	No
groupby	string	將資料彙總僅套用至指定欄位的陳述式。您可以指定下列欄位： serviceCode serviceName 通道 customerTenantId customerName productId productName 傳回的資料列將包含 groupby 參數中指定的欄位，以及下列各項： licensesDeployed licensesSold	No
processedDateTime	Datetime	您可以指定處理使用量資料的日期。預設為處理資料的最新日期	No

要求範例

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/license?filter=customerTenantId%20eq%20%27aaaabbbb-0000-cccc-1111-dddd2222eeee%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 回應

如果成功，回應本文會包含下欄欄位，其中包含所部署授權的相關資料。

欄位	類型	描述
serviceCode	string	服務程式碼
serviceName	string	服務名稱
通道	string	頻道名稱，轉銷商
customerTenantId	string	客戶的唯一識別碼
customerName	string	客戶名稱
productId	字串	產品的唯一識別碼
productName	string	產品名稱
licensesDeployed	long	已部署的授權數目
licensesSold	long	售出的授權數目
processedDateTime	Datetime	上次處理資料的日期

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 4
Date: Wed, 24 Oct 2018 22:37:18 GMT
{
  "Value": [

{
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "crm",
      "serviceName": "Microsoft Dynamics",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "54B84594-9C77-4499-8D65-5E0D5F410E78",
      "productName": "DYNAMICS AX TASK",
      "licensesDeployed": 0,
      "licensesSold": 9
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}

共用方式為