パートナー ライセンスのデプロイ情報を取得するGet partner licenses deployment information

適用対象Applies To

  • パートナー センターPartner Center

すべての顧客を含むように、集計されたパートナーライセンスの展開情報を取得する方法。How to get partner licenses deployment information aggregated to include all customers.

注意

このシナリオは、 ライセンスの取得の展開情報によって置き換えられます。This scenario is superceded by Get licenses deployment information.

前提条件Prerequisites

パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. このシナリオでは、アプリとユーザーの資格情報を使用した認証がサポートされます。This scenario supports authentication with App+User credentials.

C#C#

ライセンスの展開の集計データを取得するには、まず、 iaggregatepartner.customers プロパティからパートナーレベルの分析コレクション操作へのインターフェイスを取得します。To retrieve aggregated data on licenses deployment, first get an interface to partner level analytics collection operations from the IAggregatePartner.Analytics property. 次に、[ ライセンス ] プロパティから、パートナーレベルのライセンス分析コレクションへのインターフェイスを取得します。Then retrieve an interface to the partner level licenses analytics collection from the Licenses property. 最後に、 deployment. get メソッドを呼び出して、ライセンスのデプロイ時に集計データを取得します。Finally, call the Deployment.Get method to get the aggregated data on licenses deployment. メソッドが成功した場合は、 PartnerLicensesDeploymentInsights オブジェクトのコレクションが取得されます。If the method succeeds you'll get a collection of PartnerLicensesDeploymentInsights objects.

// IAggregatePartner partnerOperations;

var partnerLicensesDeploymentAnalytics = partnerOperations.Analytics.Licenses.Deployment.Get();

REST 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL}/v1/analytics/licenses/deployment HTTP/1.1{baseURL}/v1/analytics/licenses/deployment HTTP/1.1

要求ヘッダーRequest headers

詳細については、「パートナー センター REST ヘッダー」を参照してください。For more information, see Partner Center REST headers.

[要求本文]Request body

[なし] :None.

要求の例Request example

GET https://api.partnercenter.microsoft.com/v1/analytics/licenses/deployment HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 応答REST response

成功した場合、応答本文には、デプロイされたライセンスに関する情報を提供する PartnerLicensesDeploymentInsights リソースのコレクションが含まれます。If successful, the response body contains a collection of PartnerLicensesDeploymentInsights resources that provide information about the licenses deployed.

応答の成功とエラーのコードResponse success and error codes

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。Each response comes with an HTTP status code that indicates success or failure and additional debugging information. このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。Use a network trace tool to read this code, error type, and additional parameters. 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。For the full list, see Partner Center REST error codes.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6492b9d6-5629-429b-934c-040b1946e760
MS-RequestId: 25b6edd5-1f53-456b-b48c-c64f60ec2dda
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 102030524
Date: Tue, 14 Mar 2017 17:55:01 GMT

{
    "totalCount": 2,
    "items": [{
            "proratedDeploymentPercent": 0.0,
            "licensesSold": 343,
            "processedDateTime": "2017-03-10T00:00:00+00:00",
            "serviceName": "crm",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }, {
            "proratedDeploymentPercent": 1.0,
            "licensesSold": 4464,
            "processedDateTime": "2017-03-14T03:25:16.36+00:00",
            "serviceName": "o365",
            "channel": "reseller",
            "attributes": {
                "objectType": "PartnerLicensesDeploymentInsights"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}