轉換新的商務訂用帳戶

發行項
03/07/2025

適用於：Microsoft 夥伴中心 | 由 21Vianet 營運的合作夥伴中心 | 美國政府專用的 Microsoft 雲端合作夥伴中心

適當的角色

管理代理人

這些方法同時支持傳統和新商務來源訂用帳戶。

注意

授權型服務的新商務體驗包含許多新功能，可供所有雲端解決方案提供者（CSP）使用。如需詳細資訊，請參閱新的商務體驗概覽。

用來將客戶的新商務訂用帳戶升級至目標訂用帳戶，或將 NCE 試用版轉換為付費訂閱。若要轉換訂用帳戶，必須提出兩個 API 要求。首先 GET 符合條件的轉換，以取得可供升級的 SKU。然後 POST 轉換 以執行轉換。

取得轉換資格

返回針對指定客戶、訂閱和請求類型的合格轉換清單。還會返回目標訂用帳戶的升級資格。轉換資格可能包括處於 EndofSaleWithConversions 狀態的促銷優惠。

必要條件

憑證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的 ID，可以在合作夥伴中心中選擇 [客戶] 工作區，然後從客戶清單中選取該客戶，再選擇 [帳戶]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 帳戶。 Microsoft ID 與客戶 ID (customer-tenant-id) 相同。
最初訂閱的訂閱識別碼。

GDAP 角色

您至少需要下列其中一個 GDAP 角色：

目錄讀取器
全球閱讀器

注意

雖然此 API 適用於舊版和 NCE，但 GDAP 僅適用於舊版。

REST 要求

要求語法

方法	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibility？eligibilityType={immediate， scheduled} HTTP/1.1

URI 參數

使用下列查詢參數傳回符合條件的轉換。

名稱	類型	必要	描述
customer-tenant-id	guid	Y	對應至客戶租戶的 GUID。
subscription-id	guid	Y	對應於初始訂閱的 GUID。
資格類型	string	否	描述何時要執行轉換;可以立即或排程。預設值為 `Immediate`。

請求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

請求主體

無

要求範例

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType=immediate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST 回應

如果成功，這個方法會傳回回應本文中指定訂用帳戶的合格轉換清單。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及更多偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱錯誤代碼。

資格錯誤

錯誤描述和意義。

錯誤描述	意義
無法轉換訂用帳戶 - 來源訂用帳戶未作用中。	原始子狀態非作用中
無法轉換訂用帳戶 - 尚未布建來源訂用帳戶。	原始子履行狀態未成功
轉換類型不相容 - 需要 Azure AD 訂用帳戶對應。	呼叫 GetSubscriptionUpgradeConflicts 時，LegacyCannotConvertSubscriptionId 錯誤
轉換類型不相容 - 授權轉移的訂用帳戶衝突。	如果任何 Microsoft Entra 服務的訂用帳戶標識碼來自不同的訂用帳戶，請將其新增至衝突清單（包括舊版或新式購買流程中的購買）

訂用帳戶資格錯誤

如果目的地訂用帳戶不符合升級資格，則會傳回下列其中一個原因。

如果來源訂用帳戶是試用版，或資格類型指定為 Scheduled，則會傳回空白清單。您只能立即（也稱為「中期」）轉換到現有訂閱，而不能進行排程變更。

錯誤描述	錯誤碼
訂閱未啟用。	訂閱未生效 = 1
訂閱在取消期限內。	SubscriptionInCancellationWindow = 2
訂用帳戶期限比來源訂用帳戶的期限持續時間短。	訂閱期限短於來源期限 = 3
訂閱期限結束日期在來源訂閱的期限結束日期之前。	訂閱期限結束日期早於來源訂閱的期限結束日期。 = 4

回應範例

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
  "totalCount": 2,
  "items": [
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0KZCR:0001:CFQ7TTC0K71H",
      "title": "Microsoft 365 E5 Test Sku Title",
      "description": "Microsoft 365 E5 Test Sku Description",
      "quantity": 1,
      "subscriptionEligibilities": [
        {
          "isEligible": false,
          "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1M",
          "subscriptionBillingCycle": "monthly",
          "errors": [
            {
              "code": 3,
              "description": "The subscription's term duration is shorter than the source subscription's term duration."
            }
          ]
        },
        {
          "isEligible": true,
          "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
          "subscriptionFriendlyName": "Microsoft 365 Business Premium",
          "subscriptionTermDuration": "P1Y",
          "subscriptionBillingCycle": "monthly",
          "errors": []
        }
      ],
      "eligibilities": [
        {
          "isEligible": true,
          "transitionType": "transition_only",
          "errors": []
        },
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    },
    {
      "operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
      "catalogItemId": "CFQ7TTC0L4M3:0001:CFQ7TTC0K78T",
      "title": "Business Premium Test Sku Title",
      "description": "Business Premium Test Sku Description",
      "quantity": 1,
      "eligibilities": [
        {
          "isEligible": false,
          "transitionType": "transition_with_license_transfer",
          "errors": [
            {
              "code": 3,
              "description": "Subscription cannot be transitioned because there are conflicting services."
            }
          ]
        }
      ],
      "attributes": {
        "objectType": "TransitionEligibility"
      }
    }
  ],
  "attributes": {
    "objectType": "Collection"
  }
}

過渡後

張貼指定客戶和訂用帳戶的轉換要求。傳回轉換及其初始狀態。

必要條件

憑證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的 ID，您可以在合作夥伴中心中選取客戶工作區，然後在客戶清單中選擇客戶，接著選擇帳戶。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft ID。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
初始訂閱的 ID。

GDAP 角色

您至少需要下列其中一個 GDAP 角色：

注意

雖然此 API 適用於舊版和 NCE，但 GDAP 僅適用於舊版。

REST 要求

要求語法

方法	要求 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1

URI 參數

使用下列查詢參數來執行轉換。

名稱	類型	必要	描述
customer-tenant-id	guid	Y	對應客戶租戶的 GUID。
subscription-id	guid	Y	與初始訂用帳戶對應的 GUID。

請求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

請求主體

下表描述要求本文中的 Transition 屬性。

屬性	類型	必要	描述
fromCatalogItemId	字串	不	您要轉移的目錄項目。
來源訂閱ID	字串	不行	您要轉換的訂用帳戶識別碼。
至目錄項目ID	字串	Yes	您要切換到的目錄項目。
toSubscriptionId	字串	不	您要切換至的訂閱識別碼。
數量	整數	Yes	要轉換的授權數目。
任期時長	字串	否	指定訂閱的期限。
billingCycle	字串	不	指定訂用帳戶的計費週期。
過渡類型	字串	Yes	轉換類型。可能的值 - `transition_only`、`transition_with_license_transfer`。

要求範例

POST https://api.partnercenter.microsoft.com/v1/customers/{customerId}/subscriptions/{subscriptionId}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
}

REST 回應

如果成功，此方法將返回具有初始狀態的「Transition」資源。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗，以及更多偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
    "fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
    "toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
    "toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
    "quantity": 2,
    "termDuration": "P1M",
    "billingCycle": "Monthly",
    "transitionType": "transition_only"
    "Events": [
        {
            "name": "Conversion",
            "status": "Started ",
            "timestamp": "2021-01-08T18:01:14.7488618Z",
            "attributes":
            {
                "objectType": "TransitionEvent"
            }
        }
    ],
    "attributes":
    {
        "objectType": "Transition" 
    }
}

共用方式為

轉換新的商務訂用帳戶

取得轉換資格

必要條件

GDAP 角色

REST 要求

要求語法

URI 參數

請求標頭

請求主體

要求範例

REST 回應

回應成功和錯誤碼

資格錯誤

訂用帳戶資格錯誤

回應範例

過渡後

必要條件

GDAP 角色

REST 要求

要求語法

URI 參數

請求標頭

請求主體

要求範例

REST 回應

回應成功和錯誤碼

回應範例

意見反應

其他資源