製品の一覧を取得する (国/地域別)

[アーティクル]
09/27/2024

適用対象: パートナーセンター | 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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

新しいコマースライセンスベースのサービス

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: aaaa0000-bb11-2222-33cc-444444dddddd

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

{
  "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"
  }
}

次の方法で共有

製品の一覧を取得する (国/地域別)

前提条件

C#

Java

PowerShell

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

国別の製品

Azure VM の予約 (Azure プラン)

Microsoft Azure (MS-AZR-0145P) サブスクリプションの Azure VM 予約

新しいコマースライセンスベースのサービス

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマースライセンスベースのサービスの応答例

フィードバック

その他のリソース

次の方法で共有

製品の一覧を取得する (国/地域別)

前提条件

C#

Java

PowerShell

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

国別の製品

Azure VM の予約 (Azure プラン)

Microsoft Azure (MS-AZR-0145P) サブスクリプションの Azure VM 予約

新しいコマース ライセンス ベースのサービス

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマース ライセンス ベースのサービスの応答例

フィードバック

その他のリソース

新しいコマースライセンスベースのサービス

新しいコマースライセンスベースのサービスの応答例