Modifica

Domande frequenti su Gestione API di Azure

  • Domande frequenti

Ottenere le risposte alle domande comuni su Gestione API di Azure.

Che cosa significa se una funzionalità è in anteprima?

Quando una funzionalità è in anteprima, significa che si stanno raccogliendo attivamente commenti e suggerimenti dagli utenti sulla funzionalità. Una funzionalità in anteprima è completa dal punto di vista funzionale, ma è possibile che venga apportata una modifica di rilievo in risposta ai commenti e suggerimenti dei clienti. È consigliabile non far dipendere l'ambiente di produzione da una funzionalità in anteprima.

Come è possibile ottenere informazioni sugli aggiornamenti e sulle modifiche apportate a Gestione API?

Sottoscrivere gli annunci di aggiornamento pubblicati in queste posizioni:

Come è possibile proteggere la connessione tra il gateway di Gestione API e i servizi back-end?

Sono disponibili diverse opzioni per proteggere la connessione tra il gateway di Gestione API e i servizi back-end, tra cui:

Come si copia l'istanza del servizio Gestione API in una nuova istanza?

Sono disponibili diverse opzioni, tra cui:

  • Usare la funzionalità di backup e ripristino in Gestione API.
  • Creare la propria funzionalità di backup e ripristino usando l'API REST di Gestione API per salvare e ripristinare le entità dall'istanza del servizio desiderata.
  • Scaricare la configurazione del servizio usando Git e quindi caricarla in una nuova istanza.

È possibile spostare un'istanza di Gestione API da una sottoscrizione a un'altra?

Sì. Per informazioni, vedere Move resources to a new resource group or subscription (Spostare le risorse in un nuovo gruppo di risorse o in una nuova sottoscrizione).

È possibile gestire l'istanza di Gestione API a livello di codice?

Sì, è possibile gestire Gestione API a livello di codice usando un'ampia gamma di strumenti, tra cui:

Come si aggiunge un utente al gruppo di amministratori?

Il gruppo Amministrazione istrators è un gruppo di sistema non modificabile che include gli amministratori delle sottoscrizioni di Azure. Non è possibile aggiungere un utente a questo gruppo. Per altre informazioni, vedere Come creare e usare gruppi per gestire account di sviluppatori in Gestione API di Azure.

Perché il criterio da aggiungere non è disponibile nell'editor dei criteri?

Se il criterio che si vuole aggiungere è in grigio o ombreggiato nell'editor dei criteri, assicurarsi che l'ambito del criterio sia corretto. Ogni istruzione di criterio è progettata per essere usata in ambiti e sezioni dei criteri specifici. Per esaminare le sezioni e gli ambiti dei criteri per un criterio, vedere la sezione Utilizzo dei criteri nel riferimento ai criteri.

Come si configurano più ambienti in una sola API?

Per configurare più ambienti, ad esempio un ambiente di test e un ambiente di produzione, in una sola API, esistono due opzioni. È possibile:

  • Ospitare API diverse nella stessa istanza di Gestione API.
  • Ospitare le stesse API in istanze diverse.

Gestione API supporta solo i back-end dell'API REST?

Gestione API supporta API REST e pass-through alle API SOAP, WebSockete GraphQL. Gestione API supporta anche API GraphQL sintetiche.

Gestione API si integra anche con le offerte di calcolo di Azure comunemente usate per la compilazione e l'hosting di API in Azure, tra cui Funzioni, App per la logica, App contenitore e App Web.

Esistono delle restrizioni all'importazione dell'API?

Vedere Restrizioni di importazione API e problemi noti per i formati OpenAPI (Swagger), WSDL e WADL.

È possibile usare CI/CD per lo sviluppo di API?

Sì. Per altre informazioni, vedere Usare DevOps e CI/CD per pubblicare le API.

Per indicazioni sull'architettura, vedere Acceleratore di zona di destinazione di Gestione API di Azure.

Quale metodo di routing usa Gestione API nelle distribuzioni in più posizioni geografiche?

Gestione API usa il metodo di routing del traffico delle prestazioni (latenza più bassa) nelle distribuzioni in più posizioni geografiche. Per altre informazioni, vedere Distribuire un'istanza di Gestione API di Azure in più aree di Azure.

Gestione API funziona con ExpressRoute?

Sì.

Qual è la dimensione minima necessaria della subnet quando si distribuisce Gestione API in una rete virtuale?

Le dimensioni minime della subnet necessarie per distribuire Gestione API sono /29. Altre informazioni sull'uso di Gestione API nelle reti virtuali.

Gestione API fornisce un web application firewall (WAF)?

Anche se Gestione API non include un componente WAF, è consigliabile distribuire un WAF upstream (davanti) all'istanza di Gestione API. Ad esempio, usare gateway applicazione di Azure o Frontdoor di Azure.

Quali sono le differenze tra il gateway gestito e il gateway self-hosted?

Per informazioni, vedere Gateway API in Gestione API e panoramica del gateway self-hosted.

In che modo Gestione API gestisce le barre finali quando si chiamano i servizi back-end?

Storicamente e per convenzione un URL che termina con una barra finale viene considerato come una directory, ad esempio https://contoso.com/sample/, mentre lo stesso URL senza la barra finale https://contoso.com/sample indicherà un file. Questo non è obbligatorio; alcuni sistemi considerano questi due URL univoci, altri li considerano uguali. Gestione API non fa distinzione, quindi una singola operazione resource accetterà resource o resource/. Tuttavia, la distinzione può essere importante per l'host back-end. Alcuni server Web reindirizzeranno automaticamente un URL che non termina con una barra finale, allo stesso URL che termina con una barra finale. Poiché Gestione API è il client al back-end (server), un reindirizzamento automatico non è sempre auspicabile. Se necessario, creare un criterio di riscrittura URL per assicurarsi che una barra finale venga sempre aggiunta alla chiamata back-end in uscita.

È possibile modificare il nome di un'API di Gestione API?

No, non è possibile modificare il nome (o l'ID) di un'API in Gestione API di Azure dopo averlo creato. Tuttavia, è possibile modificare il nome visualizzato.

Quando si clona un'API, la nuova istanza viene creata con un valore generato dal sistema per il nome, che non è possibile modificare. Per specificare un nome per l'API, creare manualmente una nuova API e importare la definizione dell'API. Per altre informazioni, vedere Importare un'API.