Modificare un'API

  • Articolo

SI APPLICA A: Tutti i livelli di Gestione API

I passaggi di questa esercitazione illustrano come usare Gestione API per modificare un'API.

  • È possibile aggiungere, rinominare o eliminare operazioni nel portale di Azure.
  • È possibile modificare lo swagger dell'API.

Prerequisiti

Passare all'istanza di Gestione API

  1. Nel portale di Azure cercare e selezionare Servizi Gestione API.

    Selezionare Servizi Gestione API

  2. Nella pagina Servizi Gestione API selezionare l'istanza di Gestione API.

    Selezionare l'istanza di Gestione API

Modificare un'operazione

Screenshot che evidenzia il processo di modifica di un'API in Gestione API.

  1. Fare clic sulla scheda API.
  2. Selezionare una delle API importate in precedenza.
  3. Selezionare la scheda Progettazione.
  4. Selezionare un'operazione che si vuole modificare.
  5. Per rinominare l'operazione, selezionare la matita nella finestra Front-end.

Aggiornare lo swagger

È possibile aggiornare l'API back-end dal portale di Azure tramite la procedura seguente:

  1. Selezionare Tutte le operazioni.

  2. Fare clic sulla matita nella finestra Front-end.

    Screenshot che evidenzia l'icona della matita nella finestra Front-end.

    Verrà visualizzato lo swagger dell'API.

    Modificare un'API

  3. Aggiornare lo swagger.

  4. Premere Salva.

Attenzione

Se si modifica una revisione non corrente di un'API, non è possibile modificare le proprietà seguenti:

  • Nome
  • Tipo
  • Descrizione
  • Sottoscrizione obbligatoria
  • Versione dell'API
  • Descrizione della versione API
  • Percorso
  • Protocolli

Se le modifiche apportate comportano la variazione di una delle suddette proprietà di una revisione non corrente, verrà visualizzato il messaggio di errore Can't change property for non-current revision.

Passaggi successivi

Esempi di criteri di Gestione APITrasformare e proteggere un'API pubblicata