Method: projects.locations.instances.list

Elenca le istanze in un progetto e in una località specifici.

Richiesta HTTP

GET https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/instances

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. L'elemento principale da cui elencare le istanze. Formato: projects/{project}/locations/{location}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi rispetto a quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.

pageToken

string

Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.

filter

string

Facoltativo. Espressione per filtrare i risultati.

orderBy

string

Facoltativo. Ordina i risultati in base a un ordine definito. Valori supportati: "name", "createTime".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per [instances.list][]. L'elenco delle istanze nella posizione specificata.

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

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

object (Instance)

Se il valore {location} richiesto era "-", la risposta contiene un elenco di istanze di tutte le località. Le istanze in località non raggiungibili verranno omesse.

nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

unreachable[]

string

Sedi che non è stato possibile raggiungere.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM sulla risorsa parent:

  • memorystore.instances.list

Per ulteriori informazioni, consulta la documentazione di IAM.