共用方式為

將非 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 管理 實例的平臺版本。 成功移轉之後，此值為 stv2 或 stv2.1。

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

如果移轉程式期間發生失敗，實例會自動還原至 stv1 平臺。 如果移轉順利完成（實例的平臺版本顯示為 stv2 或 stv2.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 僅涉及更新計算平台，內部儲存層不會變更。 因此，在移轉流程期間，所有組態都很安全。 這包括系統指派的受控識別，如果已啟用，則會保留此身分識別。

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

    當概觀頁面中的狀態與平臺版本為 stv2 或 stv2.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 管理 實例的寫入許可權。

影片

相關內容