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.

OpenAPI/Swagger OpenAPI/Swagger

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

  • È supportato solo il formato JSON per OpenAPI.Only JSON format for OpenAPI is supported.
  • I parametri obbligatori per percorso e query devono avere nomi univoci.Required parameters across both path and query must have unique names. In OpenAPI un nome di parametro deve essere univoco solo entro la posizione, ad esempio il percorso, la query o l'intestazione.(In OpenAPI a parameter name only needs to be unique within a location, e.g. path, query, header. In Gestione API, invece, le operazioni possono essere discriminate da parametri sia di percorso che di query (cosa che OpenAPI non supporta).However, in API Management we allow operations to be discriminated by both path and query parameters (which OpenAPI does not support). Pertanto è necessario che i nomi dei parametri siano univoci all'interno dell'intero modello di URL.Therefore we require parameter names to be unique within the entire URL template.)
  • Gli schemi a cui viene fatto riferimento tramite le proprietà $ref non possono contenere altre proprietà $ref.Schemas referenced using $ref properties can't contain other $ref properties.
  • I puntatori $ref non possono fare riferimento a file esterni.$ref pointers can't reference external files.
  • x-ms-paths e x-servers sono le uniche estensioni supportate.x-ms-paths and x-servers are the only supported extensions.
  • Le estensioni personalizzate vengono ignorate in fase di importazione e non vengono salvate o mantenute per l'esportazione.Custom extensions are ignored on import and are not saved or preserved for export.

Importante

Vedere questo documento per informazioni importanti e suggerimenti correlati all'importazione OpenAPI.See this document for important information and tips related to OpenAPI import.

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.

  • Associazioni SOAP: solo le associazioni SOAP con stile di codifica "document" e "literal" sono supportate.SOAP bindings -Only SOAP bindings of style ”document” and “literal” encoding are supported. Non è disponibile il supporto per lo stile di codifica SOAP "rpc".There is no support for “rpc” style or SOAP-Encoding.
  • WSDL:Import: questo attributo non è supportato.WSDL:Import - This attribute is not supported. I clienti devono unire le importazioni in un solo documento.Customers should merge the imports into one document.
  • Messaggi con più parti: questo tipo di messaggi non è supportato.Messages with multiple parts - These types of messages are not supported.
  • wsHttpBinding di WCF: i servizi SOAP 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.
  • Ricorsione: i tipi definiti in modo ricorsivo, che, ad esempio, fanno riferimento a una matrice di se stessi, non sono supportati da APIM.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.