Condividi tramite

Domande frequenti su Gestione API di Azure

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 a livello funzionale, ma le modifiche di rilievo potrebbero essere apportate in risposta al feedback dei clienti. Non è consigliabile dipendere da una funzionalità disponibile in anteprima nell'ambiente di produzione.

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.

È 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 Amministratori è 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 i gruppi per gestire gli account sviluppatore in Gestione API di Azure.

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

Se il criterio che desideri aggiungere appare in grigio o attenuato nell'editor delle politiche, assicurati di essere nell'ambito corretto per quel criterio. 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 i servizi di calcolo di Azure comunemente usati per la creazione e l'hosting di API in Azure, tra cui Funzioni di Azure, App per la logica di Azure, App contenitore di Azure e App Web di Azure.

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ì.

Quali sono le dimensioni minime della subnet necessarie per la distribuzione di 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) dell'istanza di Gestione API. Ad esempio, utilizzare il 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, ad esempio https://contoso.com/sample/, viene considerato come una directory, mentre lo stesso URL senza la barra finale (https://contoso.com/sample) indica un file. Questa convenzione non è obbligatorio. Alcuni sistemi considerano questi due URL univoci, ma altri li considerano uguali. Gestione API non fa distinzione, quindi una singola operazione resource accetterà resource o resource/. Tuttavia, la distinzione potrebbe essere importante per l'host back-end. Alcuni server Web reindirizzano automaticamente un URL che non termina con una barra finale allo stesso URL che termina con una barra finale. Poiché la gestione delle API è il client del sistema di 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 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.

È possibile integrare Gestione API direttamente con le soluzioni di database di Azure?

Sì, è possibile integrare Gestione API direttamente con altri servizi di Azure senza intermediari. Ad esempio, Gestione API può integrarsi direttamente con le API REST di Azure Cosmos DB per le operazioni CRUD, eliminando la necessità di servizi intermedi come Funzioni di Azure.