Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Aktualisieren einer API-Definition in Azure API Management

Importieren Sie eine Datei in Azure API Management, um eine vorhandene Definition zu aktualisieren.

Vorbereitungen

  • Sie haben Zugriff auf Azure API Manangement.
  • Sie haben Microsoft PowerShell installiert. Weitere Informationen finden Sie in der Microsoft PowerShell-Dokumentation.
  • Sie haben das Azure PowerShell-Modul installiert. Weitere Informationen finden Sie in der Microsoft Azure-Dokumentation.
  • Sie haben Ihre API-Definition exportiert.
  • Sie haben eine vorherige Version der API-Definition an Azure API Management hochgeladen.
  • Sie haben Ihre Kontextparameter als Variable festgelegt. Weitere Informationen finden Sie im Verfahren oben.

Prozedur

  1. Öffnen Sie eine Befehlszeile und geben Sie folgenden Befehl ein, um die Datei hochzuladen:
    Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -ApiId "{api-id}" -Path "{api-url-suffix}"
  2. Fügen Sie die richtigen Parameter hinzu:
    Parameter Beschreibung
    {format} Format der zu importierenden API-Definition. Mögliche Werte:
    • Swagger (empfohlen)
    • Wadl
    • Wsdl
    • OpenApi
    {yourfile} Pfad und Dateiname der exportierten API-Definition.
    {api-id} Azure API Management-ID der zu aktualisierenden API.
    {api-url-suffix} Web API-Pfad, der an das Ende der öffentlichen URL Ihrer API hinzugefügt wird.
  3. Führen Sie den Befehl aus.

Ergebnisse

Ihre API-Definition wird importiert und die neue Datei ersetzt die vorherige Version. Sie können die Aktualisierung im Azure-Portal überprüfen.

In diesem Beispiel wurde eine erste Version der API-Definition mit dem Namen Contacts API hochgeladen, die fünf Vorgänge enthielt. Dann wurde sie durch eine neue Definition mit dem Namen Contacts API V2 mit zehn Vorgängen ersetzt.

Screenshot der aktualisierten API-Definition.

Weitere Informationen zum Befehl Import-AzApiManagementApi finden Sie in der Azure-Dokumentation.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!