共用方式為


將非 VNet 插入 API 管理 實例移轉至 stv2 計算平臺

適用於:開發人員 |基本 |標準 |進階版

本文提供在外部或內部 VNet 中未插入實例時,將裝載於stv1計算平臺上stv2的 API 管理 實例移轉至平臺的步驟。 在此案例中,請使用 Azure 入口網站 或移轉至 stv2 REST API 來移轉您的實例。 瞭解您是否需要這麼做

如果您需要將裝載在平臺上的 VNnet 插入 API 管理 移轉,請參閱將 VNet 插入 API 管理 實例移轉至 stv2 平臺stv1

重要

在 2024 年 8 月 31 日前,支援裝載於stv1平臺上的 API 管理 實例。 如果您有裝載在 stv1 平臺上的實例,請在該日期之前將其移轉至 stv2 平臺,以避免服務中斷。 深入了解

警告

  • 將 APIM 執行個體移轉至新的基礎結構是長時間執行的作業。
  • 視移轉程式而定,您可能在移轉期間暫時停機,而且您可能需要在移轉之後更新網路相依性,才能連線到您的 API 管理 實例。 請據以規劃移轉。
  • 移轉至 stv2 無法復原。

移轉期間會發生什麼情況?

將 APIM 平台從 stv1 移轉至 stv2 牽涉到單獨更新基礎計算,而不會影響儲存層中保存的服務/API 組態。 對於未部署在 VNet 中的實例:

  • 您可以選擇實例的VIP位址是否會變更,或保留原始VIP位址。
  • 升級流程牽涉到建立與舊計算平行使用的新計算。
  • 入口網站中的 API 管理 狀態為 [正在更新]。
  • 如果您選擇保留VIP位址,移轉會包含將VIP從舊計算移至新計算的額外步驟,其中API將無回應。
  • Azure 會管理管理端點 DNS,並在成功移轉時立即更新為新計算。
  • 默認閘道和入口網站 DNS 會立即指向新的計算。
  • 如果您選擇讓 API 管理 實例收到新的VIP位址,則必須更新網路相依性以使用新的VIP位址。

必要條件

將實例遷移至 stv2 平臺

您可以選擇 API 管理 的虛擬IP位址是否會變更,還是保留原始VIP位址。

  • 新的虛擬IP位址 - 如果您選擇此模式,API 要求在移轉期間會保持回應。 基礎結構組態 (例如自訂網域、位置和 CA 憑證) 將會鎖定 30 分鐘。 移轉之後,您必須更新任何網路相依性 (包括 DNS、防火牆規則和 VNet),才能使用新的 VIP 位址。

  • 保留IP位址 - 如果您保留VIP位址 ,在IP位址移轉至新的基礎結構時,API要求大約15分鐘不會回應。 基礎結構組態 (例如自訂網域、位置和 CA 憑證) 將會鎖定 45 分鐘。 移轉之後不需要進一步設定。

  1. Azure 入口網站中,瀏覽至您的 API 管理執行個體。

  2. 在左側功能表中的 [設定] 底下,選取 [平台移轉]

  3. 在 [ 平台移轉 ] 頁面上,選取兩個移轉選項之一:

    • 新的虛擬IP位址。 API 管理 實例的VIP位址會自動變更。 您的服務不會停機,但在移轉之後,您必須更新任何網路相依性,包括 DNS、防火牆規則和 VNet,才能使用新的 VIP 位址。

    • 保留IP位址 - API 管理 實例的VIP位址不會變更。 您的實例最多會停機 15 分鐘。

      入口網站中 API 管理 平臺移轉的螢幕快照。

  4. 檢閱移轉程式的指引,並準備您的環境。

  5. 完成準備步驟之後,選取 [我已閱讀並了解移轉流程的影響]。選取 [移轉]

驗證移轉

若要確認移轉是否成功,當狀態變更為 [在線] 時,請檢查您 API 管理 實例的平臺版本。 成功移轉之後,此值為 stv2stv2.1

如果移轉失敗,則自動還原

如果移轉程式期間發生失敗,實例會自動還原至 stv1 平臺。 如果移轉順利完成(實例的平臺版本顯示為 stv2stv2.1 且狀態為 Online),則您無法回復至 stv1 平臺。

如需移轉失敗的說明,請連絡 Azure 支援。

如果您需要手動復原的功能,建議與原始 API 管理 實例並存部署新的stv2實例

更新網路相依性

成功移轉至新的VIP位址之後,請更新任何網路相依性,包括 DNS、防火牆規則和 VNet,以使用新的 VIP 位址。

說明與支援 

我們在這裡可協助您在服務中斷最少的情況下移轉至 stv2 平臺。

如果您有問題,請取得 Microsoft Q&A 社群專家的快速解答。 如果您具備支援計劃且需要技術協助,請提出支援要求

  1. 針對 [摘要],輸入問題的描述,例如「stv1 淘汰」。
  2. 在 [問題類型] 下方,選取 [技術]
  3. 在 [訂用帳戶] 下,選取您的訂用帳戶。
  4. 在 [服務] 底下選取 [我的服務],然後選取 [API 管理服務]
  5. 在 [資源] 底下,選取您要為其建立支援要求的 Azure 資源。
  6. 針對 [問題類型],選取 [系統管理與一般管理]
  7. 針對 [問題子類型],選取 [升級、調整或 SKU 變更]

常見問題集

  • 需要哪些資訊來選擇移轉路徑?

    • API 管理 實例的網路模式為何?
    • 是否設定自訂網域?
    • 是否涉及防火牆?
    • 上游/下游對所涉及的 IP 是否有任何已知相依性?
    • 這是多區域部署嗎?
    • 我們可以修改現有的執行個體嗎?還是需要平行設定?
    • 可以有停機時間嗎?
    • 移轉是否可以在非營業時間內完成?
  • 移轉的必要條件為何?

    針對非 VNet 插入的實例,不需要任何必要條件。 如果您在移轉時保留公用 IP 位址,這會使 APIM 執行個體在大約 15 分鐘內沒有回應。 如果您選擇 [新增虛擬IP位址] 選項,讓新IP上 API 管理可供使用,則可能不會停機。 使用 A 記錄和/或具有公用虛擬 IP 位址的網路相依性設定自訂網域的實例,會在要求新的虛擬 IP 位址時停機。

  • 移轉是否會造成停機?

    針對非 VNet 插入的實例,只有在您選擇保留原始 IP 位址時,才會停機約 15 分鐘。 不過,如果您使用新的IP位址進行移轉,且在新IP上沒有網路相依性,則不會停機。 網路相依性包括不含 CNAME 的自訂功能變數名稱、IP 允許清單、防火牆規則和 VNet。

  • 數據或組態遺失是否會在移轉期間/發生?

    stv1 移轉至 stv2 僅涉及更新計算平台,內部儲存層不會變更。 因此,在移轉流程期間,所有組態都很安全。 這包括系統指派的受控識別,如果已啟用,則會保留此身分識別。

  • 如何確認移轉已完成且成功?

    當概觀頁面中的狀態與平臺版本為 stv2stv2.1時,移轉會視為完成且成功。 同時確認對於所有必要連線,網路刀鋒視窗中的網路狀態是否顯示綠色。

  • 是否可以使用入口網站執行移轉?

    是,Azure 入口網站 中的 [平台移轉] 刀鋒視窗會引導非 VNet 插入實例的移轉。

  • 是否可以保留執行個體的 IP 位址?

    是,可以保留IP位址,但停機時間大約為15分鐘。

  • 是否有不修改現有執行個體的移轉路徑?

    是,您需要 並存移轉。 這表示您可以與目前的執行個體平行建立新的 APIM 執行個體,並將組態複製到新的執行個體。

  • 如果移轉失敗,會發生什麼事?

    如果您的 API 管理 實例未在起始移轉之後,將平臺版本stv2顯示為 或 ,stv2.1且狀態為 Online,則可能失敗。 服務會自動復原為舊的執行個體,而且不會進行任何變更。 如果您有問題(例如狀態為更新超過 2 小時),請連絡 Azure 支援。

  • 移轉期間無法使用哪些功能?

    針對非 VNet 插入的實體:

    • 如果您選擇保留原始IP位址:在IP位址移轉至新的基礎結構時,API要求大約15分鐘沒有回應。 基礎結構組態 (例如自訂網域、位置和 CA 憑證) 會鎖定 45 分鐘。
    • 如果您選擇移轉至新的IP位址:API 要求在移轉期間保持回應。 基礎結構組態 (例如自訂網域、位置和 CA 憑證) 會鎖定 30 分鐘。 移轉之後,您必須更新任何網路相依性 (包括 DNS、防火牆規則和 VNet),才能使用新的 VIP 位址。
  • 移轉需要多久的時間?

    整個移轉的預期持續時間約為 45 分鐘。 檢查是否已執行移轉的指標,是檢查實例的狀態是否回到 在線 ,而不是 更新。 如果顯示更新超過 2 小時,請連絡 Azure 支援。

  • 如有需要,是否可以復原移轉?

    如果移轉程式期間發生失敗,實例會自動回復到 stv1 平臺。 不過,在服務成功移轉之後,您無法回復到 stv1 平臺。

  • 自定義網域/私人 DNS 區域是否需要進行任何變更?

    針對非 VNet 插入的實例,如果保留 IP,則不需要變更。 如果選擇使用新的 IP,則應該更新參考 IP 的自訂網域。

  • 我的 stv1 實例會部署到多個 Azure 區域(多區域)。 如何升級至 stv2?

    對於未插入 VNet 的 API 管理,請遵循使用入口網站或 Azure CLI 的移轉步驟。 所有區域都會移至 stv2

  • 我們應該針對自我裝載網關考慮什麼?

    您不需要在自我裝載閘道中執行任何動作。 只需移轉在 Azure 中執行並受 stv1 平台淘汰所影響的 APIM 執行個體。 請注意,APIM 執行個體的組態端點可能會有新的 IP,而且應更新釘選至 IP 的任何網路限制。

  • 移轉對開發人員入口網站有何影響?

    對開發人員入口網站沒有任何影響。 如果使用自訂網域,應在移轉後使用有效的 IP 更新 DNS 記錄。 不過,如果預設網域正在使用中,則會在成功移轉時自動更新這些網域。 在移轉期間,開發人員入口網站不會停機。

  • 移轉至 stv2 後,是否會對成本產生任何影響?

    計費模型會維持 stv2 不變,且移轉期間和之後不會產生更多成本。

  • stv1 到 stv2 移轉需要哪些 RBAC 許可權?

    進行移轉的使用者/程式需要 API 管理 實例的寫入許可權。

影片