Megosztás a következőn keresztül:

API-verzió kivonása (2024. június)

  • Cikk

A következőkre vonatkozik: Felhasználás | Fejlesztő | Alapszintű | Standard | Prémium

Az Azure API Management az Azure Resource Manager (ARM) használatával konfigurálja az API Management-példányokat. Az API-verzió be van építve az infrastruktúra leírására használt sablonokba, a szolgáltatás konfigurálásához használt eszközökbe, és az Azure API Management-szolgáltatások kezeléséhez írt programokba.

2024. június 1-től az Azure API Management szolgáltatás 2021.08.01. előtti összes API-verziója megszűnik (le van tiltva). A korábban bejelentett nyugdíjazási dátum 2023. szeptember 30. volt. 2024. június 1-jén bármikor előfordulhat, hogy a 2021-08-01 előtti API-verziót használó API-hívások további értesítés nélkül meghiúsulnak. Az API Management-szolgáltatásokat már nem hozhatja létre vagy kezelheti meglévő sablonokkal, eszközökkel, szkriptekkel és programokkal egy visszavont API-verzióval, amíg nem frissülnek az API 2021-08-01-es vagy újabb verziójára. Az adatsík-műveleteket (például az API-kérések átjáróban történő közvetítését) ez a frissítés nem érinti, beleértve a 2024. június 1-jei állapotot is.

Ez hatással van a szolgáltatásomra?

Bár a szolgáltatásra ez a változás nem vonatkozik, minden olyan eszköz, szkript vagy program, amely az Azure Resource Managert (például az Azure CLI-t, az Azure PowerShellt, az Azure API Management DevOps Resource Kitet vagy a Terraformot) használja az API Management szolgáltatással való interakcióhoz, és a 2021.08. 01. előtti API Management API-verziót hívja meg, ez a változás érinti. Az API-verzió kivonása után az érintett eszközök nem futtathatók sikeresen, hacsak nem frissíti az eszközöket.

Mi a változás határideje?

Az érintett API-verziók 2024. június 1-től fokozatosan megszűnnek.

Az API-verzió kivonása után, ha nem szeretné frissíteni az érintett eszközöket, szkripteket és programokat, a szolgáltatások továbbra is futni fognak. Azonban nem fog tudni API-kat hozzáadni vagy eltávolítani, MÓDOSÍTANI az API-szabályzatot, vagy más módon konfigurálni az API Management szolgáltatást az érintett eszközökkel.

Szükséges művelet

Frissítse eszközeit, szkripteit és programjait a következő szakaszban található részletekkel.

Azt is javasoljuk, hogy állítsa be a Minimális API-verziót az API Management-példányban.

Eszközök, szkriptek és programok frissítése

  • ARM-, Bicep- vagy Terraform-sablonok – Frissítse a sablont az API 2021-08-01-es vagy újabb verziójának használatára.

  • Azure CLI – Futtatás az version a verzió ellenőrzéséhez. Ha a 2.42.0-s vagy újabb verziót futtatja, nincs szükség műveletre. Ha szükséges, frissítse az az upgrade Azure CLI-t a paranccsal. További információ: Az Azure CLI frissítése.

  • Azure PowerShell – Futtatás Get-Module -ListAvailable -Name Az a verzió ellenőrzéséhez. Ha a 8.1.0-s vagy újabb verziót futtatja, nincs szükség műveletre. Szükség esetén a modul frissítésére használható Update-Module -Name Az -Repository PSGallery . További információ: Az Azure Az PowerShell-modul telepítése.

  • Egyéb eszközök – Használja a következő verziókat (vagy újabb verziókat):

    • API Management DevOps Resource Kit: 1.0.0
    • Terraform azurerm-szolgáltató: 3.0.0

  • Azure SDK-k – Frissítse az Azure API Management SDK-kat a legújabb verziókra, vagy legalább a következő verziókra:

    • .NET: 1.1.0-s verzió
    • Ugrás: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-béta3

Az API Management-példány minimális API-verzióbeállításának frissítése

Javasoljuk, hogy állítsa be az API Management-példány minimális API-verzióját az Azure Portal vagy a REST API vagy más eszközök használatával. Ez a beállítás korlátozza a vezérlősík API-hívásait a példánynak az ennél az értéknél egyenlő vagy újabb API-verzióra. Ha ezt az értéket 2021-08-01 értékre állítja, felmérheti az API-verzió kivonásának hatását az eszközhasználatra.

A minimális API-verzió beállítása a portálon:

  1. Az Azure Portalon keresse meg az API Management-példányt.
  2. A bal oldali menü Üzembe helyezés + infrastruktúra területén válassza a Felügyeleti API-t.
  3. Válassza a Felügyeleti API beállításai lapot.
  4. A Minimális API-verzió kényszerítése csoportban válassza az Igen lehetőséget. Megjelenik a Minimális API-verzió .
  5. Válassza a Mentés parancsot.

Fontos

Ha a portál minimális API-verziója szürkítve jelenik meg, csak programozott módon frissítheti a beállítást, például a REST API vagy az az apim update parancs használatával az Azure CLI-ben.

További információ

Kapcsolódó tartalom

Tekintse meg az összes közelgő kompatibilitástörő változást és a funkció kivonását.