Creare e gestire i pool di lettura

Questa pagina descrive come creare e gestire i pool di lettura per i carichi di lavoro di lettura di grandi dimensioni.

Prima di iniziare

  1. I pool di lettura contengono copie di un'istanza principale. Se non l'hai ancora fatto, crea un'istanza principale di Cloud SQL Enterprise Plus. Sebbene i pool di lettura supportino la connettività con IP pubblico, ai fini di questa guida, crea un'istanza principale con connettività con IP privato (PSA). Per ulteriori informazioni sulle istanze principali e sulla replica, consulta Informazioni sulla replica in Cloud SQL.
  2. Dopo aver creato l'istanza primaria, scegli una password per l'utente root ed esegui il seguente comando per impostare la password sull'istanza primaria. Salva questa password per utilizzarla in un secondo momento durante la connessione al pool di lettura.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Effettua le seguenti sostituzioni:

    • PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza primaria e il pool di lettura.
    • PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.

Crea un pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances create per creare un pool di lettura con più nodi del pool di lettura:

      gcloud beta sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza primaria associata al pool di lettura, ad esempio my-primary-instance.

REST v1

Utilizza il metodo insert della risorsa delle istanze per creare un pool di lettura con più nodi del pool di lettura. La proprietà databaseVersion deve essere uguale a quella principale.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza primaria e il pool di lettura.
  • REGION: la regione del pool di lettura, ad esempio us-east1. La regione deve essere la stessa dell'istanza principale.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
  • READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura, ad esempio my-read-pool.
  • DATABASE_VERSION: la versione del database che vuoi utilizzare. Ad esempio, MYSQL_8_0_37.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.
  • FULL_NETWORK_NAME: il percorso di rete completo in cui vuoi che risieda il pool di lettura, ad esempio projects/vpc-host-project/global/networks/my-network-name.

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

Corpo JSON della richiesta: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo insert della risorsa delle istanze per creare un pool di lettura con più nodi del pool di lettura. La proprietà databaseVersion deve essere uguale a quella principale.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui vuoi che risiedano l'istanza primaria e il pool di lettura.
  • REGION: la regione del pool di lettura, ad esempio us-east1. La regione deve essere la stessa dell'istanza principale.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: il nome dell'istanza principale.
  • READ_POOL_NAME: il nome che vuoi utilizzare per il pool di lettura, ad esempio my-read-pool.
  • DATABASE_VERSION: la versione del database che vuoi utilizzare. Ad esempio, MYSQL_8_0_37.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.
  • FULL_NETWORK_NAME: il percorso di rete completo in cui vuoi che risieda il pool di lettura, ad esempio projects/vpc-host-project/global/networks/my-network-name.

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

Corpo JSON della richiesta: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Converti una replica di lettura in un pool di lettura

Puoi convertire una replica di lettura Cloud SQL Enterprise Plus esistente in un pool di lettura specificando il numero di nodi nel pool. Durante questo processo di conversione, l'IP della replica diventerà l'IP del pool di lettura (l'endpoint di lettura), in modo che i client esistenti possano connettersi al pool senza riconfigurazione.

I nodi del pool di lettura appena creati avranno lo stesso tipo di macchina e la stessa configurazione della replica di lettura originale. La modifica di questo tipo di macchina o di questa configurazione richiede un'operazione separata. Questa operazione è supportata solo per le repliche di lettura di zona. Per convertire una replica di lettura ad alta disponibilità (HA) in un pool di lettura, devi prima convertirla in una replica di lettura zonale.

Per ulteriori informazioni, vedi Modificare la configurazione del pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances patch per convertire una replica di lettura da utilizzare con un pool di lettura:

      gcloud beta sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

Effettua le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

REST v1

Utilizza il metodo patch della risorsa delle istanze per convertire una replica di lettura in un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire, ad esempio my-read-replica.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

Corpo JSON della richiesta: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch della risorsa delle istanze per convertire una replica di lettura in un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_REPLICA_NAME: il nome della replica di lettura che vuoi convertire, ad esempio my-read-replica.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

Corpo JSON della richiesta: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Converti un pool di lettura in una replica di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances patch per convertire una replica di lettura da utilizzare con un pool di lettura:

      gcloud beta sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi convertire.

REST v1

Utilizza il metodo patch della risorsa delle istanze per convertire un pool di lettura in una replica di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "instanceType": "READ_REPLICA_INSTANCE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch della risorsa delle istanze per convertire un pool di lettura in una replica di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "instanceType": "READ_REPLICA_INSTANCE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare le informazioni sul pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances describe per descrivere il pool di lettura:

      gcloud beta sql instances describe READ_POOL_NAME

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi descrivere.

Una risposta di esempio con l'indirizzo IP e le informazioni sul nodo potrebbe essere simile alla seguente:

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST v1

Utilizza il metodo get per visualizzare i dettagli del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo get per visualizzare i dettagli del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

Aggiungere o rimuovere nodi del pool di lettura

I seguenti passaggi scalano un pool di lettura modificando il numero di nodi del pool di lettura nel pool di lettura. Si applicano alcune limitazioni operative. Per ulteriori informazioni, consulta Limitazioni del pool di lettura.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances patch per scalare il pool di lettura:

      gcloud beta sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

REST v1

Utilizza il metodo patch per aumentare o diminuire le dimensioni di un pool di lettura modificando il numero di nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch per aumentare o diminuire le dimensioni di un pool di lettura modificando il numero di nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • NODE_COUNT: il numero di nodi del pool di lettura che vuoi nel pool di lettura. Scegli un numero qualsiasi da 1 a 20.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "nodeCount": NODE_COUNT
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Modifica della configurazione del pool di lettura

I seguenti passaggi mostrano come modificare la configurazione del pool di lettura. Per informazioni più dettagliate, vedi Informazioni sulle impostazioni delle istanze e Modificare le istanze.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud beta sql instances patch per scalare verticalmente il pool di lettura, ad esempio modificando il tipo di macchina:

      gcloud beta sql instances patch READ_POOL_NAME \
      --tier=TIER

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura.
  • TIER: il tipo di macchina che vuoi applicare a ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-8.

REST v1

Utilizza il metodo patch per modificare la configurazione dei nodi del pool di lettura. Le impostazioni vengono applicate in modo uniforme a tutti i nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "settings": {
    "tier": "TIER"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo patch per modificare la configurazione dei nodi del pool di lettura. Le impostazioni vengono applicate in modo uniforme a tutti i nodi del pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • TIER: il tipo di macchina che vuoi utilizzare per ogni nodo del pool di lettura, ad esempio db-perf-optimized-N-4.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Corpo JSON della richiesta: 

{
  "settings": {
    "tier": "TIER"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Connettersi a un pool di lettura

Esistono molti modi per connettersi a un pool di lettura. I seguenti passaggi mostrano un modo, ovvero la connessione a un pool di lettura con un indirizzo IP privato creando una VM nella stessa rete VPC che funge da origine della connessione.

Per saperne di più su altri modi per configurare la connettività a un'istanza Cloud SQL, consulta Informazioni sulle connessioni Cloud SQL. I metodi di connessione in genere richiedono di ottenere prima l'indirizzo IP o il nome di connessione dell'istanza, come descritto in Visualizzare le informazioni sul pool di lettura. I pool di lettura supportano la maggior parte dei metodi di connessione disponibili per altre istanze Cloud SQL, con alcune limitazioni.

Se ti connetti utilizzando il proxy di autenticazione Cloud SQL o i connettori Cloud SQL, assicurati di eseguire l'aggiornamento all'ultima versione. Per il supporto del pool di lettura, le versioni minime richieste includono quanto segue:

  • Proxy di autenticazione Cloud SQL: v2.15.2
  • Connettore Python Cloud SQL: v1.18.0
  • Connettore Go Cloud SQL: v1.16.0
  • Connettore del nodo Cloud SQL: v1.7.0
  • Connettore Java Cloud SQL: v1.24.0

Console

Per connetterti a un pool di lettura, completa i seguenti passaggi:

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

    Si aprirà la pagina Panoramica dell'istanza. Fai clic sul nuovo pool di lettura per visualizzare i dettagli, incluso l'indirizzo IP privato. Nella sezione Connetti a questa istanza, copia e salva il Nome connessione dell'istanza. connection name è nel formato projectID:region:instanceID. Utilizzerai questo connection name in un secondo momento quando avvierai il proxy di autenticazione Cloud SQL.
  2. Crea una VM di Compute Engine.
  3. Apri due connessioni SSH nella VM di Compute Engine. Questi vengono utilizzati nei passaggi successivi per eseguire il proxy di autenticazione Cloud SQL ed eseguire il client di database.
  4. Installa il client.
  5. Installa il proxy di autenticazione Cloud SQL.
  6. Avvia il proxy di autenticazione Cloud SQL.
  7. Connettiti all'istanza Cloud SQL.

Per ulteriori informazioni, consulta Connettiti a un'istanza Cloud SQL con IP privato.

Eliminare un pool di lettura

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizzare Cloud Shell.

Utilizza il seguente comando gcloud sql instances delete per eliminare un pool di lettura:

      gcloud sql instances delete READ_POOL_NAME

Effettua le seguenti sostituzioni:

  • READ_POOL_NAME: il nome del pool di lettura che vuoi eliminare.

REST v1

Utilizza il metodo delete per eliminare un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il metodo delete per eliminare un pool di lettura.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT: il nome del progetto in cui si trova il pool di lettura.
  • READ_POOL_NAME: il nome del pool di lettura, ad esempio my-read-pool.

Metodo HTTP e URL: 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Passaggi successivi