製品の一覧を取得する (国/地域別)
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
次のメソッドを使用して、特定の国/地域で利用可能な製品のコレクションを取得できます。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
国/地域。
C#
製品の一覧を取得するには:
IAggregatePartner.Products コレクションを使用して、ByCountry() メソッドを使用して国/地域を選択します。
ByTargetView() メソッドを使用してカタログ ビューを選択します。
(省略可能) ByReservationScope() メソッドを使用して予約スコープを選択します。
(省略可能) ByTargetSegment() メソッドを使用してターゲット セグメントを選択します。
Get() または GetAsync() メソッドを呼び出してコレクションを返します。
IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();
// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();
// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();
Java
Partner Center Java SDK を使用して、パートナー センターのリソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
製品の一覧を取得するには:
IAggregatePartner.getProducts 関数を使用して、byCountry()関数を使用して国を選択します。
byTargetView()関数を使用してカタログ ビューを選択します。
(省略可能) byTargetSegment() 関数を使用してターゲット セグメントを選択します。
get()関数を呼び出してコレクションを返します。
// IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();
PowerShell
Partner Center PowerShell モジュールを使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
製品の一覧を取得するには:
Get-PartnerProduct コマンドを実行します。
Catalog パラメーターを指定して、カタログを選択します。
(省略可能) Segment パラメーターを指定して、ターゲット セグメントを選択します。
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/products?country={country}>targetView={targetView}>targetSegment={targetSegment} HTTP/1.1 |
URI パラメーター
次のパスとクエリ パラメーターを使用して、製品の一覧を取得します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
country | string | はい | 国/地域 ID。 |
targetView | string | はい | カタログのターゲット ビューを識別します。 サポートされている値は次のとおりです。 すべての Azure 項目を含む Azure AzureReservations。すべての Azure 予約項目が含まれます すべての仮想マシン (VM) 予約項目を含む AzureReservationsVM すべての SQL 予約項目を含む AzureReservationsSQL すべての Cosmos データベース予約項目を含む AzureReservationsCosmosDb Microsoft Azure サブスクリプション (MS-AZR-0145P) と Azure プランの項目を含む MicrosoftAzure OnlineServices。従来のライセンスベースのサービスや新しいコマース ライセンスベースのサービスなど、すべてのオンライン サービス項目が含まれます。 ソフトウェア。すべてのソフトウェア項目が含まれます。 SoftwareSUSELinux。 SoftwarePerpetual。 SoftwareSubscriptions。すべてのソフトウェア サブスクリプション項目が含まれます SpecializedOffers。一部のパートナーが利用できる特殊なオファーが含まれています MarketplaceSaaS。独立系ソフトウェア ベンダー (ISV) によって公開されたすべてのコマーシャル マーケットプレース オファーが含まれます |
targetSegment | string | いいえ | ターゲット セグメントを識別します。 さまざまな対象ユーザーのビュー。 サポートされている値は次のとおりです。 コマーシャル education government 非 営利 |
reservationScope | string | いいえ | Azure Reservations の製品の一覧を照会する場合は、 reservationScope=AzurePlan を指定して、Azure プランに適用可能な製品の一覧を取得します。 このパラメーターを除外して、Microsoft Azure (MS-AZR-0145P) サブスクリプションに適用される Azure 予約の製品の一覧を取得します。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし。
要求の例
国別の製品
次の例に従って、Microsoft Azure (MS-AZR-0145P) サブスクリプションと Azure プランの国別の製品の一覧を取得します。
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Azure VM の予約 (Azure プラン)
次の例に従って、Azure プランに適用される Azure VM 予約の国別の製品の一覧を取得します。
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Microsoft Azure (MS-AZR-0145P) サブスクリプションの Azure VM 予約
次の例に従って、Microsoft Azure (MS-AZR-0145P) サブスクリプションに適用される Azure VM 予約の国別の製品の一覧を取得します。
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
新しいコマース ライセンス ベースのサービス
Note
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
次の例に従って、新しいコマース エクスペリエンスのテクニカル プレビューの一部として、新しいコマース ライセンス ベースのサービスの国別の製品の一覧を取得します。 新しいコマース ライセンス ベースのサービスは、 OnlineServicesNCE の ID 値と displayNames 値によって識別されます。 以下の応答の例を参照してください。
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
REST 応答
成功した場合、応答本文には Product リソースのコレクションが含まれます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、 Partner Center のエラー コードを参照してください。
このメソッドは、次のエラー コードを返します。
HTTP 状態コード | エラー コード | 説明 |
---|---|---|
403 | 400030 | 要求された targetSegment へのアクセスは許可されません。 |
403 | 400036 | 要求された targetView へのアクセスは許可されていません。 |
Azure VM 予約の応答の例 (Azure プラン)
{
"totalCount": 19,
"items": [
{
"id": "DZH318Z0BQ3Q",
"title": "Virtual Machines DSv2 Series",
"description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
"productType": {
"id": "Azure",
"displayName": "Azure",
"subType": {
"id": "VirtualMachines",
"displayName": "VirtualMachines"
}
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft",
"links": {
"skus": {
"uri": "/products/DZH318Z0BQ3Q/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3Q?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=Azure",
"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"
}
}