Method: projects.locations.instances.list

Listet Instanzen in einem bestimmten Projekt und an einem bestimmten Standort auf

HTTP-Anfrage

:


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

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

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 als angefordert zurück. Wenn kein Wert angegeben wurde, 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 in einer bestimmten Reihenfolge sortieren Unterstützte Werte: „name“, „createTime“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht 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)

Wenn für {location} „-“ angegeben wurde, enthält die Antwort eine Liste von Instanzen von allen Standorten. Instanzen an nicht erreichbaren Standorten werden ausgelassen.
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 einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/memorystore.read-write
  • https://www.googleapis.com/auth/memorystore.read-only

IAM-Berechtigungen

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

  • memorystore.instances.list

Weitere Informationen finden Sie in der IAM-Dokumentation.