Method: projects.locations.instances.list

Elenca le istanze in una determinata località.

Richiesta HTTP

GET https://memcache.googleapis.com/v1/{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 nel formato projects/{projectId}/locations/{locationId}, dove locationId si riferisce a una regione Google Cloud

I parametri di ricerca

Parametri
pageSize

integer

Il numero massimo di articoli da restituire.

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

pageToken

string

Il valore nextPageToken restituito da un'eventuale richiesta di elenco precedente.

filter

string

Filtro elenco. Ad esempio, escludi tutte le istanze Memcached il cui 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
{
  "instances": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
instances[]

object (Instance)

Un elenco di istanze Memcached nel progetto nella località specificata o in tutte le località.

Se il locationId nel campo padre della richiesta è "-", viene eseguita una 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

Località 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.