Method: projects.locations.instances.list

Listet Instanzen an einem bestimmten Ort 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

Abfrageparameter

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 Wert pageSize kann die Antwort eine unvollständige Liste enthalten und ein Aufrufer sollte sich nur auf das nextPageToken der Antwort verlassen, um festzustellen, ob weitere Instanzen abgefragt werden müssen.
pageToken

string

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

string

Listenfilter. Schließen Sie beispielsweise alle Memcached-Instanzen mit dem Namen „my-instance“ aus, indem Sie "name != my-instance" angeben.
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.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender 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 in der Authentifizierungsübersicht.