Delen via

Buitengebruikstelling van API-versies (juni 2024)

  • Artikel

VAN TOEPASSING OP: Verbruik | Ontwikkelaar | Basic | Standaard | Premium

Azure API Management maakt gebruik van Azure Resource Manager (ARM) om je API Management-exemplaren te configureren. De API-versie is ingesloten in je gebruik van sjablonen die je infrastructuur beschrijven, hulpprogramma's die worden gebruikt om de service te configureren en programma's die je schrijft om je Azure API Management-services te beheren.

Vanaf 1 juni 2024 worden alle API-versies voor de Azure API Management-service vóór 2021-08-01 buiten gebruik gesteld (uitgeschakeld). De eerder meegedeelde pensioendatum was 30 september 2023. Op elk gewenst moment na 1 juni 2024 kunnen API-aanroepen met een API-versie vóór 2021-08-01 zonder verdere kennisgeving mislukken. U kunt uw API Management-services niet meer maken of beheren met bestaande sjablonen, hulpprogramma's, scripts en programma's met behulp van een buiten gebruik gestelde API-versie totdat ze zijn bijgewerkt om API-versie 2021-08-01 of hoger te gebruiken. Bewerkingen in het gegevensvlak (zoals het mediateren van API-aanvragen in de gateway) worden niet beïnvloed door deze update, inclusief na 1 juni 2024.

Wordt mijn service hierdoor beïnvloed?

Hoewel uw service niet wordt beïnvloed door deze wijziging, wordt een hulpprogramma, script of programma dat gebruikmaakt van Azure Resource Manager (zoals de Azure CLI, Azure PowerShell, Azure API Management DevOps Resource Kit of Terraform) om te communiceren met de API Management-service en wordt een API Management API-versie aangeroepen vóór 2021-08-01 door deze wijziging. Nadat een API-versie buiten gebruik is gesteld, kunt u geen betrokken hulpprogramma's meer uitvoeren, tenzij u de hulpprogramma's bijwerkt.

Wat is de deadline voor de wijziging?

De betrokken API-versies worden vanaf 1 juni 2024 geleidelijk buiten gebruik gesteld.

Nadat een API-versie buiten gebruik is gesteld, blijven uw services actief als u uw betrokken hulpprogramma's, scripts en programma's liever niet bijwerkt. U kunt echter geen API's toevoegen of verwijderen, API-beleid wijzigen of uw API Management-service op een andere manier configureren met betrokken hulpprogramma's.

Vereiste actie

Werk uw hulpprogramma's, scripts en programma's bij met behulp van de details in de volgende sectie.

U wordt ook aangeraden de minimale API-versie in uw API Management-exemplaar in te stellen.

Uw hulpprogramma's, scripts en programma's bijwerken

  • ARM-, Bicep- of Terraform-sjablonen : werk de sjabloon bij voor het gebruik van API-versie 2021-08-01 of hoger.

  • Azure CLI : voer deze uit az version om uw versie te controleren. Als u versie 2.42.0 of hoger gebruikt, is er geen actie vereist. Gebruik de az upgrade opdracht om de Azure CLI zo nodig te upgraden. Zie De Azure CLI bijwerken voor meer informatie.

  • Azure PowerShell : voer deze uit Get-Module -ListAvailable -Name Az om uw versie te controleren. Als u versie 8.1.0 of hoger gebruikt, is er geen actie vereist. Gebruik Update-Module -Name Az -Repository PSGallery deze optie om de module indien nodig bij te werken. Zie De Azure Az PowerShell-module installeren voor meer informatie.

  • Andere hulpprogramma's : gebruik de volgende versies (of hoger):

    • API Management DevOps Resource Kit: 1.0.0
    • Terraform azurerm-provider: 3.0.0

  • Azure SDK's: werk de Azure API Management SDK's bij naar de nieuwste versies of ten minste de volgende versies:

    • .NET: v1.1.0
    • Go: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Instelling voor minimale API-versie bijwerken in uw API Management-exemplaar

U wordt aangeraden de minimale API-versie in te stellen voor uw API Management-exemplaar met behulp van Azure Portal of met behulp van de REST API of andere hulpprogramma's. Met deze instelling worden API-aanroepen van besturingsvlak naar uw exemplaar beperkt tot een API-versie die gelijk is aan of hoger is dan deze waarde. Door deze waarde in te stellen op 2021-08-01, kunt u de impact van de buitengebruikstelling van de API-versie op uw hulpprogramma's beoordelen.

De minimale API-versie instellen in de portal:

  1. Blader in Azure Portal naar uw API Management-exemplaar.
  2. Selecteer in het linkermenu onder Implementatie en infrastructuur de optie Management-API.
  3. Selecteer het tabblad Beheer-API-instellingen .
  4. Selecteer Ja onder Minimum-API-versie afdwingen. De minimale API-versie wordt weergegeven.
  5. Selecteer Opslaan.

Belangrijk

Als de minimale API-versie in de portal grijs wordt weergegeven, kunt u de instelling alleen programmatisch bijwerken, bijvoorbeeld met behulp van de REST API of de opdracht az apim update in de Azure CLI.

Meer informatie

Gerelateerde inhoud

Bekijk alle aanstaande belangrijke wijzigingen en functie-buitengebruikstelling.