驗證訂用帳戶以便移轉
適用于:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
如何驗證要移轉至新商務體驗的訂用帳戶
必要條件
認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 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 | string | Yes | 識別客戶的 GUID 格式字串。 |
termDuration | string | No | 移轉時可以變更字詞持續時間。 |
billingCycle | string | No | 移轉時可以變更計費週期。 |
purchaseFullTerm | bool | No | 移轉後,可以在 NCE 中啟動新的字詞。 |
數量 | int | No | 您可以在移轉時增加或減少訂用帳戶的授權數量。 |
customTermEndDate | Datetime | No | 結束日期可以設定為與現有的非trial OnlineServicesNCE 訂用帳戶或行事曆月份一致。 如需對齊訂用帳戶結束日期的詳細資訊,請參閱這裡: 在合作夥伴中心對齊訂用帳戶結束日期 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
下表描述 要求本文中的訂 用帳戶屬性。
屬性 | 型別 | 必填 | 描述 |
---|---|---|---|
currentSubscriptionId | string | 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"
}
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: