Creazione di un'API

Prerequisiti

Prima di poter creare un'API su API Gateway, assicurati di disporre di:

Requisiti per gli ID API

Molti dei comandi gcloud mostrati di seguito richiedono di specificare l'ID dell'API nel formato API_ID. API Gateway applica i seguenti requisiti per l'ID API:

  • Deve avere una lunghezza massima di 63 caratteri.
  • Deve contenere solo lettere minuscole, numeri o trattini.
  • Non deve iniziare con un trattino.
  • Non deve contenere un trattino basso.

Creazione di un'API

Per creare un'API:

  1. Convalida l'ID progetto restituito dal seguente comando per assicurarti che il servizio non venga creato nel progetto sbagliato.

    gcloud config list project

    Se devi modificare il progetto predefinito, esegui il comando seguente e sostituisci PROJECT_ID con l'ID del progetto Google Cloud in cui vuoi creare il servizio:

    gcloud config set project PROJECT_ID

    Se l'ID progetto contiene i due punti (:), consulta Progetti con ambito di dominio per ulteriori dettagli sulla creazione di un'API nel progetto.

  2. Visualizza la guida per il comando apis create:

    gcloud api-gateway apis create --help

  3. Esegui questo comando per creare l'API:

    gcloud api-gateway apis create API_ID --project=PROJECT_ID

    dove:

    • API_ID specifica l'ID della nuova API. Consulta i requisiti relativi agli ID API per le linee guida relative alla denominazione delle API.
    • PROJECT_ID specifica l'ID del progetto Google Cloud.

    Durante la creazione dell'API, API Gateway invia informazioni al terminale.

  4. Una volta completata l'operazione, puoi utilizzare il comando seguente per visualizzare i dettagli della nuova API:

    gcloud api-gateway apis describe API_ID --project=PROJECT_ID

    Questo comando restituisce quanto segue:

    createTime: '2020-02-29T21:52:20.297426875Z'
displayName: API_ID
managedService: MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog
name: projects/PROJECT_ID/locations/global/apis/API_ID
state: ACTIVE
updateTime: '2020-02-29T21:52:20.647923711Z'

Opzioni gcloud

Google Cloud CLI prevede molte opzioni, incluse quelle descritte nella Guida di riferimento gcloud. Inoltre, per API Gateway, puoi impostare le seguenti opzioni quando crei un'API:

  • --async: restituisci immediatamente il controllo al terminale, senza attendere il completamento dell'operazione.
  • --display-name=NAME: specifica il nome visualizzato dell'API, ovvero il nome mostrato nell'interfaccia utente. Non utilizzare spazi nel nome. Utilizza invece trattini e trattini bassi. Il valore predefinito è API_ID.
  • --labels=KEY1=VALUE1,KEY2=VALUE2,...: specifica le etichette associate alla configurazione API.
  • --managed-service: specifica un servizio gestito preesistente per l'API, ad esempio un servizio Endpoints esistente.

Progetti con ambito di dominio

Se il progetto ha come ambito il tuo dominio, l'ID progetto include il nome del dominio seguito dai due punti (:), ad esempio example.com:my-project. Devi fornire un servizio gestito valido quando crei un'API in un progetto con ambito di dominio.

Se utilizzi gcloud, fornisci il nome del servizio gestito utilizzando il flag --managed-service, come descritto in gcloud options.

Elenco delle API

Per elencare tutte le API in un progetto: 

gcloud api-gateway apis list --project=PROJECT_ID

Questo comando restituisce l'output nel formato:

NAME                                              DISPLAY_NAME  MANAGED_SERVICE                          STATE
projects/PROJECT_ID/locations/global/apis/API_ID  API_ID        MANAGED_SERVICE_NAME.apigateway.PROJECT_ID.cloud.goog  ACTIVE

Utilizza l'ID progetto e l'ID API per ottenere informazioni dettagliate sull'API:

gcloud api-gateway apis describe API_ID --project=PROJECT_ID

Aggiornamento di un'API

Dopo la creazione, puoi aggiornare le etichette e il nome visualizzato di un'API esistente. Utilizza le seguenti opzioni gcloud per aggiornare un'API esistente:

  • --display-name
  • --update-labels
  • --clear-labels
  • --remove-labels

Ad esempio:

gcloud api-gateway apis update API_ID --project=PROJECT_ID \
  --update-labels=a=1,b=2

Utilizza il seguente comando per visualizzare tutte le opzioni di aggiornamento:

gcloud api-gateway apis update --help

Eliminazione di un'API

Per eliminare un'API, devi:

  • Elimina le configurazioni API associate all'API.
  • Eliminare l'API.

Per eliminare un'API:

  1. Determina l'elenco di configurazioni API associate all'API:

    gcloud api-gateway api-configs list --api=API_ID --project=PROJECT_ID

  2. Elimina ogni configurazione API associata all'API:

    gcloud api-gateway api-configs delete CONFIG_ID --api=API_ID --project=PROJECT_ID

  3. Elimina l'API:

    gcloud api-gateway apis delete API_ID --project=PROJECT_ID

Passaggi successivi