Method: projects.locations.instances.list

Listet Instanzen an einem bestimmten Standort auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Instanzstandorts im Format projects/{projectId}/locations/{locationId}, wobei sich locationId auf eine GCP-Region bezieht

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl der Elemente, die zurückzugeben sind.

Wenn nicht angegeben, wird vom Dienst der Standardwert 1.000 verwendet. Unabhängig vom pageSize-Wert kann die Antwort eine unvollständige Liste enthalten und ein Aufrufer sollte sich nur auf die Antwort nextPageToken verlassen, um zu bestimmen, ob noch weitere Instanzen abzufragen sind.
pageToken

string

Der Wert nextPageToken wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.
filter

string

Listenfilter Wenn Sie beispielsweise alle Memcached-Instanzen mit dem Namen „my-instance“ ausschließen möchten, geben Sie "name != my-instance" an.
orderBy

string

Ergebnisse sortieren. Unterstützte Werte sind "name", "name desc" oder "" (nicht sortiert).

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für instances.list.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "instances": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
instances[]

object (Instance)

Eine Liste der Memcache-Instanzen im Projekt am angegebenen Standort oder an allen Standorten.

Wenn locationId im übergeordneten Feld der Anfrage „-“ ist, werden alle für das Projekt verfügbaren Regionen abgefragt und die Ergebnisse zusammengefasst.
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.