驗證訂用帳戶以便移轉

發行項
10/28/2024

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

如何驗證要移轉至新商務體驗的訂用帳戶

必要條件

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

速率限制

驗證移轉 API 限制是 5 分鐘內每個合作夥伴-客戶組合 450 個呼叫。如需速率限制和節流的詳細資訊，請參閱 API 節流指引。

REST 要求

要求語法

方法	要求 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI 參數

下表列出驗證訂用帳戶以進行移轉的必要查詢參數。

名稱	類型	必要	描述
customer-tenant-id	字串	Yes	識別客戶的 GUID 格式字串。
termDuration	字串	No	移轉時可以變更字詞持續時間。
billingCycle	字串	No	移轉時可以變更計費週期。
purchaseFullTerm	bool	No	移轉后，可以在NCE中啟動新的字詞。
數量	int	No	您可以在移轉時增加或減少訂用帳戶的授權數量。
customTermEndDate	Datetime	No	結束日期可以設定為與現有的非trial OnlineServicesNCE 訂用帳戶或行事曆月份一致。如需對齊訂用帳戶結束日期的詳細資訊，請參閱這裡：在合作夥伴中心對齊訂用帳戶結束日期

要求標頭

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

要求本文

下表描述要求本文中的訂用帳戶屬性。

屬性	型別	必要	描述
currentSubscriptionId	字串	Yes	訂用帳戶標識碼，指出哪些訂用帳戶需要移轉驗證。

要求範例

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST 回應

如果成功，這個方法會在回應本文中傳回「isEligible」布爾值，指出目前的訂用帳戶是否符合移轉至新商務的資格。請注意，驗證移轉 API 不提供新商務中訂用帳戶促銷資格的相關信息。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態代碼，指出成功或失敗和額外偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

共用方式為