Method: projects.locations.instances.list

Listet Instanzen in einem angegebenen Projekt und an einem angegebenen Standort auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element, aus dem Instanzen aufgelistet werden sollen. Format: projects/{projekt}/locations/{location}

Suchparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente zurück, als angefordert. Wenn kein Wert angegeben ist, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
filter

string

Optional. Ausdruck zum Filtern von Ergebnissen.
orderBy

string

Optional. Ergebnisse nach einer bestimmten Reihenfolge sortieren. Unterstützte Werte: „name“, „createTime“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für [instances.list][]. Die Liste der Instanzen am angegebenen Standort.

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

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

object (Instance)

Wenn der angeforderte {location} „-“ war Die Antwort enthält eine Liste der Instanzen aus allen Standorten. Instanzen an nicht erreichbaren Standorten werden nicht berücksichtigt.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • memorystore.instances.list

Weitere Informationen finden Sie in der IAM-Dokumentation.