Method: projects.locations.instances.list

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

Richiesta HTTP


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

Gli URL utilizzano 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 di 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.

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 la {location} richiesta era "-", la risposta contiene un elenco di istanze di tutte le località. Le istanze nelle 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

Località non raggiungibili.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/memorystore.read-write
  • https://www.googleapis.com/auth/memorystore.read-only

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • memorystore.instances.list

Per saperne di più, consulta la documentazione di IAM.