Usare le API definition di Swagger con le Azure Function

di Cristian Civera, in Azure Web Site,

Le Azure Function fanno parte di quella categoria di servizi cosiddetti server less perché mirano a farci concentrare sulle operazioni, sul loro codice e di dimenticarci del fatto che esso viene eseguito da uno o più macchine.

Esse ci permettono di definire delle funzioni, spesso sono esposte con endpoint HTTP per poter essere richiamate dall'esterno. Di recente è stata introdotta la possibilità di esporre la definizione di questi endpoint attraverso Swagger, una specificata basata su YAML che ci permette di descrivere quali sono le operazioni HTTP da noi esposte, i verbi e i parametri supportati.

Per farlo dobbiamo recarci sul portale, sulla radice delle nostre function app e selezionare la scheda API definition. In essa possiamo decidere se usare uno Swagger esterno o ottenere la definizione dalle nostre funzioni, come nell'immagine seguente.

Se scegliamo Function possiamo poi premere il pulsante Generate API definition template e avere una definizione auto generata, come nell'immagine.

Questa generazione non è completa e tocca noi mettere mano allo YAML per descrivere correttamente i metadati. Di tutto questo però viene fatto l'host ed esposto attraverso l'indirizzo che troviamo a destra nel riquadro API definition URL, pronto per essere passato allo sviluppatore che deve farne uso.

Commenti

Visualizza/aggiungi commenti

| Condividi su: Twitter, Facebook, LinkedIn

Per inserire un commento, devi avere un account.

Fai il login e torna a questa pagina, oppure registrati alla nostra community.

Approfondimenti

I più letti di oggi