パートナー ライセンスのデプロイ情報を取得する
パートナー ライセンスの展開情報を集計して、すべての顧客を含める方法。
注意
このシナリオは、 ライセンスのデプロイ情報を取得することで過大評価されます。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証がサポートされます。
C#
ライセンスのデプロイに関する集計データを取得するには、まず IAggregatePartner.Analytics プロパティからパートナー レベルの分析収集操作へのインターフェイスを取得します。 次に、 Licenses プロパティからパートナー レベルのライセンス分析コレクションへのインターフェイスを取得します。 最後に、 Deployment.Get メソッドを呼び出して、ライセンスのデプロイに関する集計データを取得します。 メソッドが成功すると、 PartnerLicensesDeploymentInsights オブジェクトのコレクションが取得されます。
// IAggregatePartner partnerOperations;
var partnerLicensesDeploymentAnalytics = partnerOperations.Analytics.Licenses.Deployment.Get();
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/analytics/licenses/deployment HTTP/1.1 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
なし。
要求の例
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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST 応答
成功した場合、応答本文には、デプロイされたライセンスに関する情報を提供する PartnerLicensesDeploymentInsights リソースのコレクションが含まれます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す 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: 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"
}
}