製品の一覧を取得する (顧客別)
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
次のメソッドを使用して、既存の顧客の製品のコレクションを取得できます。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
顧客 ID です (
customer-tenant-id)。 顧客の ID がわからない場合は、パートナー センターで [顧客] ワークスペースを選び、顧客一覧から顧客を選び、[アカウント] を選んで調べることができます。 お客様のアカウント ページで、[顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。
REST 要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| POST | {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1 |
要求 URI のパラメーター
| 名前 | タイプ | Required | 説明 |
|---|---|---|---|
| customer-tenant-id | GUID | はい | この値は、顧客を指定できるようにする識別子である、GUID 形式の customer-tenant-id です。 |
| targetView | string | はい | カタログのターゲット ビューを識別します。 サポートされている値は次のとおりです。 すべての Azure 項目を含む Azure AzureReservations。すべての Azure 予約項目が含まれます すべての仮想マシン (VM) 予約項目を含む AzureReservationsVM すべての SQL 予約項目を含む AzureReservationsSQL すべての Cosmos データベース予約項目を含む AzureReservationsCosmosDb Microsoft Azure サブスクリプション (MS-AZR-0145P) と Azure プランの項目を含む MicrosoftAzure OnlineServices。すべてのオンライン サービス 項目が含まれます。 この targetView には、コマーシャル マーケットプレース、従来のライセンス ベースのサービス、および新しいコマース ライセンス ベースのサービスが含まれます ソフトウェア。すべてのソフトウェア項目が含まれます。 SoftwareSUSELinux。 SoftwarePerpetual。 SoftwareSubscriptions。すべてのソフトウェア サブスクリプション項目が含まれます SpecializedOffers。一部のパートナーが利用できる特殊なオファーが含まれています |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし。
要求の例
特定の顧客が利用できる Azure 使用量ベースの製品の一覧を要求します。 Microsoft Azure (MS-AZR-0145P) と Azure プランの両方の製品は、パブリック クラウドのお客様に対して返されます。
GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 83643f5e-5dfd-4375-88ed-054412460dc8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
新しいコマース ライセンス ベースのサービス
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
次の例に従って、新しいコマース エクスペリエンスのテクニカル プレビューの一部として、新しいコマース ライセンス ベースのサービスの国/地域別の製品の一覧を取得します。 新しいコマース ライセンス ベースのサービスは、 OnlineServicesNCE の ID 値と displayNames 値によって識別されます。 以下の応答の例を参照してください。
GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
REST 応答
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、 Partner Center のエラー コードを参照してください。
このメソッドは、次のエラー コードを返します。
| HTTP 状態コード | エラー コード | 説明 |
|---|---|---|
| 403 | 400036 | 要求された targetView へのアクセスは許可されません。 |
Microsoft Azure と Azure プランの応答の例
HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cccc2222-dd33-4444-55ee-666666ffffff
MS-RequestId: ae7288e2-2673-4ad4-8c12-7aad818d5949
{
"totalCount": 2,
"items": [
{
"id": "MS-AZR-0145P",
"productId": "9DEA7946-EC2C-441E-9FFD-E3B275F7E838",
"title": "Microsoft Azure",
"description": "Azure Cloud Solution Provider offer for Partner and Resellers",
"minimumQuantity": 1,
"maximumQuantity": 1,
"isTrial": false,
"supportedBillingCycles": [
"monthly"
],
"purchasePrerequisites": [
"MicrosoftCloudAgreement"
],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"billingType": "usage",
"category": "Enterprise",
"isAddon": false,
"prerequisiteSkus": [],
"rank": 1413,
"hasAddOns": false,
"isAutoRenewable": false,
"upgradeTargetOffers": null,
"conversionTargetOffers": [],
"unitType": "Usage-based",
"limitUnitOfMeasure": "None",
"limit": 0,
"reselleeQualifications": [],
"resellerQualifications": []
},
"links": {
"availabilities": {
"uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P/availabilities?country=US&targetSegment=Commercial",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P?country=US",
"method": "GET",
"headers": []
}
}
},
{
"id": "0001",
"productId": "DZH318Z0BPS6",
"title": "Microsoft Azure plan",
"description": "Microsoft Azure plan (MS-AZR-0017G)",
"minimumQuantity": 1,
"maximumQuantity": 1,
"isTrial": false,
"supportedBillingCycles": [
"one_time"
],
"purchasePrerequisites": [
"MicrosoftCustomerAgreement"
],
"inventoryVariables": [],
"provisioningVariables": [],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"pilotProgram": "modernazurepilot"
},
"links": {
"availabilities": {
"uri": "/products/DZH318Z0BPS6/skus/0001/availabilities?country=US&targetSegment=Commercial",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BPS6/skus/0001?country=US",
"method": "GET",
"headers": []
}
}
}
],
"links": {
"self": {
"uri": "/customers/e2a0c0f3-0f74-4d1c-808c-dfa511481913/products/all/skus?targetView=MicrosoftAzure&targetSegment=Commercial",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
新しいコマース ライセンス ベースのサービスの応答例
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
{
"totalCount": 19,
"items": [{
"id": "CFQ7TTC0LH18",
"title": "Microsoft 365 Business Basic",
"description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft Corporation",
"links": {
"skus": {
"uri": "/products/CFQ7TTC0LH18/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=OnlineServices",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}