Problemi noti e limitazioni dell'importazione dell'APIAPI import restrictions and known issues

Informazioni sull'elencoAbout this list

Quando si importa un'API è possibile riscontrare delle restrizioni o identificare dei problemi che è necessario correggere per completare l'importazione.When importing an API, you might come across some restrictions or identify issues that need to be rectified before you can successfully import. L'articolo illustra questi aspetti, organizzati in base al formato di importazione dell'API.This article documents these, organized by the import format of the API.

Aprire l'API/Swagger Open API/Swagger

Se si ricevono errori durante l'importazione del documento Open API, assicurarsi che sia stato convalidato: usare la finestra di progettazione nel portale di Azure (Progettazione - Front End - Aprire l'editor della specifica API) o usare uno strumento di terze parti come Swagger Editor.If you are receiving errors importing your Open API document, ensure you have validated it - either using the designer in the Azure portal (Design - Front End - Open API Specification Editor), or with a third-party tool such as Swagger Editor.

  • Nome host Gestione API richiede un attributo per il nome host.Host Name APIM requires a host name attribute.
  • Percorso base Gestione API richiede un attributo per il percorso base.Base Path APIM requires a base path attribute.
  • Schemi Gestione API richiede una matrice di schemi.Schemes APIM requires a scheme array.

WSDL WSDL

I file WSDL vengono usati per generare le API SOAP pass-through o come back-end dell'API SOAP-REST.WSDL files are used to generate SOAP Pass-through APIs or serve as the backend of a SOAP-to-REST API.

  • WSDL:Import: le API che usano questo attributo non sono attualmente supportate da Gestione API.WSDL:Import - Currently, APIM does not support APIs using this attribute. I clienti devono unire gli elementi importati in un solo documento.Customers should merge the imported elements into one document.
  • Messaggi con più parti: questo tipo di messaggi non è attualmente supportato da Gestione API.Messages with multiple parts Currently, APIM does not support these types of messages.
  • I servizi SOAP wsHttpBinding di WCF creati con Windows Communication Foundation devono usare basicHttpBinding in quanto wsHttpBinding non è supportato.WCF wsHttpBinding SOAP services created with Windows Communication Foundation should use basicHttpBinding - wsHttpBinding is not supported.
  • MTOM: i servizi che usano MTOM potrebbero funzionare.MTOM Services using MTOM may work. Al momento il supporto ufficiale non è previsto.Official support is not offered at this time.
  • Gestione API non supporta i tipi ricorsivi che sono definiti in modo ricorsivo, ad esempio che fanno riferimento a una matrice di se stessi.Recursion types that are defined recursively (for example, refer to an array of themselves) are not supported by APIM.

WADL WADL

Attualmente non sono noti problemi di importazione del formato WADL.Currently, there are no known WADL import issues.