Method: projects.locations.instances.list

Elenca ogni DatabaseInstance associata al progetto padre specificato.

Gli elementi dell'elenco vengono restituiti senza un ordine particolare, ma costituiranno una visualizzazione coerente delle istanze del database quando vengono effettuate richieste aggiuntive con un pageToken .

L'elenco risultante contiene istanze in qualsiasi STATE .

I risultati dell'elenco potrebbero risultare obsoleti per alcuni secondi.

Utilizza instances.get per letture coerenti.

Richiesta HTTP

GET https://firebasedatabase.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri
parent

string

Il progetto principale per il quale elencare le istanze del database, nel formato: projects/{project-number}/locations/{location-id}

Per elencare tutte le sedi, utilizza un genitore nel formato: projects/{project-number}/locations/-

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa parent specificata:

  • firebasedatabase.instances.list

Parametri di query

Parametri
pageToken

string

Token restituito da una chiamata precedente a instances.list che indica dove riprendere l'elenco nell'insieme di istanze del database.

pageSize

integer

Il numero massimo di istanze di database da restituire nella risposta.

Il server può restituirne meno a sua discrezione. Se non viene specificato alcun valore (o viene specificato un valore troppo grande), il server imporrà il proprio limite.

showDeleted

boolean

Indicare che devono essere restituite anche le istanze database nello stato DELETED .

Richiedi corpo

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

La risposta dal metodo instances.list .

Rappresentazione JSON
{
  "instances": [
    {
      object (DatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Campi
instances[]

object ( DatabaseInstance )

Elenco di ogni DatabaseInstance presente nel progetto Firebase principale.

nextPageToken

string

Se l'elenco dei risultati è troppo grande per essere contenuto in una singola risposta, viene restituito un token. Se la stringa è vuota, questa risposta è l'ultima pagina dei risultati.

Questo token può essere utilizzato in una chiamata successiva a instances.list per trovare il gruppo successivo di istanze del database.

I token di pagina hanno vita breve e non devono essere persistenti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/firebase.readonly

Per ulteriori informazioni, vedere la panoramica sull'autenticazione .