次の方法で共有

顧客の製品アップグレード エンティティを作成する

ProductUpgradeRequest リソースを使用して、顧客を特定の製品ファミリ (Azure プランなど) にアップグレードする製品アップグレード エンティティを作成できます。

[前提条件]

  • パートナー センター認証で説明されている資格証明。 このシナリオでは、App+User 資格情報を使用した認証がサポートされています。 パートナー センター API でアプリ + ユーザー認証を使用する場合は、 セキュリティで保護されたアプリ モデル に従ってください。

  • 顧客 ID です (customer-tenant-id)。 顧客の ID がわからない場合は、パートナー センターで [顧客] ワークスペースを選び、顧客一覧から顧客を選び、[アカウント] を選んで調べることができます。 顧客の [アカウント] ページで、[顧客アカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

  • 顧客をアップグレードする製品ファミリ。

C#

お客様を Azure プランにアップグレードするには:

  1. ProductUpgradesRequest オブジェクトを作成し、顧客識別子と製品ファミリとして "Azure" を指定します。

  2. IAggregatePartner.ProductUpgrades コレクションを使用します。

  3. Create メソッドを呼び出し、ProductUpgradesRequest オブジェクトを渡して、場所のヘッダー文字列を返します。

  4. アップグレード ステータスのクエリに使用できる location ヘッダー文字列から upgrade-id を抽出します。

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

REST 要求

リクエスト構文

メソッド URI リクエスト
投稿 {baseURL}/v1/productupgrades HTTP/1.1

要求ヘッダー

詳細については、「パートナー センター REST ヘッダー」を参照してください。

リクエストの本文

要求本文には 、ProductUpgradeRequest リソースが含まれている必要があります。

要求の例

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Von Bedeutung

2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 有用な情報を含む readme ファイルと共に、GitHub から SDK リリースをダウンロードできます。

パートナーは、引き続き パートナー センター REST API を使用することをお勧めします。

REST 応答

成功した場合、応答には、製品のアップグレード状態を取得するために使用できる URI を持つ Location ヘッダーが含まれます。 この URI は、他の関連する REST API で使用するために保存してください。

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

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラー コード 参照してください。

応答の例

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT
  • Last updated on