為客戶建立產品升級實體

發行項
10/01/2024

您可以使用 ProductUpgradeRequest 資源建立產品升級實體，將客戶升級至指定的產品系列（例如 Azure 方案 ）。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用應用程式加上使用者的認證來進行驗證。搭配合作夥伴中心 API 使用 App+使用者驗證時，請遵循安全的應用程式模型。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，您可以在合作夥伴中心中選取 [客戶 ] 工作區，然後從客戶清單中查看客戶，然後 從 [帳戶 ]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 識別碼 。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
您想要升級客戶的產品系列。

C#

若要將客戶升級至 Azure 方案：

建立 ProductUpgradesRequest 物件，並將客戶識別碼和「Azure」指定為產品系列。
使用 IAggregatePartner.ProductUpgrades 集合。
呼叫 Create 方法並傳入 ProductUpgradesRequest 物件，這會傳回 位置標頭 字串。
從可用來查詢升級狀態的位置標頭字串擷取 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
POST	{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"
}

重要

自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。您可以從 GitHub 下載 SDK 版本，以及包含實用資訊的讀我檔案。

鼓勵合作夥伴繼續使用合作夥伴中心 REST API 。

REST 回應

如果成功，回應會包含位置標頭，其中包含可用來擷取產品升級狀態的 URI。儲存此 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

共用方式為