Method: projects.locations.instances.list

Elenca le istanze in una determinata località.

Richiesta HTTP

GET https://memcache.googleapis.com/v1beta2/{parent=projects/*/locations/*}/instances

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa della località dell'istanza utilizzando il formato: projects/{projectId}/locations/{locationId} dove locationId fa riferimento a una regione Google Cloud

Parametri di query

Parametri
pageSize

integer

Il numero massimo di elementi da restituire.

Se non specificato, il servizio utilizzerà un valore predefinito di 1000. Indipendentemente dal valore pageSize, la risposta può includere un elenco parziale e un chiamante deve fare affidamento solo su nextPageToken della risposta per determinare se ci sono altre istanze da sottoporre a query.

pageToken

string

Il valore nextPageToken restituito da una precedente richiesta List, se presente.

filter

string

Filtro elenco. Ad esempio, escludi tutte le istanze Memcached con il nome my-instance specificando "name != my-instance".

orderBy

string

Ordina i risultati. I valori supportati sono "name", "name desc" o "" (non ordinati).

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per instances.list.

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

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

object (Instance)

Un elenco di istanze Memcached nel progetto nella posizione specificata o in tutte le posizioni.

Se locationId nel campo principale della richiesta è "-", vengono eseguite query su tutte le regioni disponibili per il progetto e i risultati vengono aggregati.

nextPageToken

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

unreachable[]

string

Sedi che non è stato possibile raggiungere.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.