Problemi noti e limitazioni dell'importazione dell'API

Informazioni sull'elenco

Mentre viene compiuto ogni sforzo per garantire che l'importazione dell'API in Gestione API di Azure sia la più semplice e priva di problemi possibile, talvolta si impongono limitazioni o si identificano problemi che dovranno essere risolti per poter eseguire correttamente l'importazione. L'articolo illustra questi aspetti, organizzati in base al formato di importazione dell'API.

Aprire l'API/Swagger

In generale, se si ricevono errori durante l'importazione del documento Open API, assicurarsi che sia stato convalidato: usare la finestra di progettazione nel nuovo portale di Azure (Progettazione - Front End - Aprire l'editor della specifica API) o usare uno strumento di terze parti come Swagger Editor.

  • Nome host è necessario un attributo per il nome host.
  • Percorso base è necessario un attributo per il percorso base.
  • Schemi è necessaria una matrice di schemi.

WSDL

I file WSDL vengono usati per generare le API SOAP pass-through o come back-end dell'API SOAP-REST.

  • WSDL:Import: le API che usano questo attributo non sono attualmente supportate. I clienti devono unire gli elementi importati in un solo documento.
  • Messaggi con più parti: non sono attualmente supportati.
  • I servizi SOAP wsHttpBinding di WCF creati con Windows Communication Foundation devono usare basicHttpBinding in quanto wsHttpBinding non è supportato.
  • MTOM: i servizi che usano MTOM potrebbero funzionare. Al momento il supporto ufficiale non è previsto.
  • Non sono supportati i tipi ricorsivi che sono definiti in modo ricorsivo, ad esempio che fanno riferimento a una matrice di se stessi.

WADL

Attualmente non sono noti problemi di importazione del formato WADL.