轉換新的商務訂用帳戶

發行項
09/25/2024

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

適當的角色

系統管理代理人

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

注意

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

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

取得轉換資格

傳回指定客戶、訂用帳戶和要求類型的合格轉換清單。也會傳回目的地訂用帳戶升級資格。轉換資格可能包括處於 EndofSaleWithConversions 狀態的供應專案。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的標識碼，您可以在合作夥伴中心中選取 [客戶] 工作區，然後從客戶清單中查看客戶，然後從 [帳戶]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找Microsoft標識碼。 Microsoft 識別碼與客戶識別碼 (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。
eligibilityType	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 狀態代碼，指出成功或失敗，以及更多偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱錯誤碼。

資格錯誤

錯誤描述和意義。

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

訂用帳戶資格錯誤

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

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

錯誤描述	錯誤碼
訂用帳戶未使用中。	SubscriptionNotActive = 1
訂用帳戶位於取消期間內。	SubscriptionInCancellationWindow = 2
訂用帳戶期限比來源訂用帳戶的期限持續時間短。	SubscriptionTermDurationShorterThanSourceTermDuration = 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)。如果您不知道客戶的標識碼，您可以在合作夥伴中心中選取 [客戶] 工作區，然後從客戶清單中查看客戶，然後從 [帳戶]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找Microsoft標識碼。 Microsoft 識別碼與客戶識別碼 (customer-tenant-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	字串	No	您要轉換的目錄專案。
fromSubscriptionId	字串	No	您要轉換的訂用帳戶識別碼。
toCatalogItemId	字串	Yes	您要轉換的目錄專案。
toSubscriptionId	字串	No	您要轉換的訂用帳戶識別碼。
數量	整數	Yes	要轉換的授權數目。
termDuration	字串	No	指定訂閱的期限。
billingCycle	字串	No	指定訂用帳戶的計費週期。
transitionType	字串	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 回應

如果成功，這個方法會傳回具有其初始狀態的轉換資源。

回應成功和錯誤碼

回應範例

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 回應

回應成功和錯誤碼

回應範例

意見反應

其他資源