Method: projects.locations.memberships.list

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

HTTP-Anfrage

GET https://gkehub.googleapis.com/v1alpha/{parent=projects/*/locations/*}/memberships

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Mitgliedschaften aufgelistet werden. Wird im Format projects/*/locations/* angegeben. projects/*/locations/- listet die Mitgliedschaften in allen Regionen auf.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.memberships.list

Suchparameter

Parameter
pageSize

integer

Optional. Beim Anfordern einer "Seite" mit Ressourcen gibt pageSize die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.
pageToken

string

Optional. Token, das vom vorherigen Aufruf an memberships.list zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.
filter

string

Optional. Listet Mitgliedschaften auf, die dem Filterausdruck entsprechen. Dabei wird die unter https://google.aip.dev/160 beschriebene Syntax beachtet.

Beispiele:

  • Der Name lautet bar im Projekt foo-proj und am Standort global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Mitgliedschaften mit dem Label foo:
  labels.foo:*
  • Mitgliedschaften mit dem Label foo, dessen Wert bar ist:
  labels.foo = bar
  • Mitgliedschaften mit dem Status CREATING:
  state = CREATING
orderBy

string

Optional. Ein oder mehrere Felder, die verglichen und zum Sortieren der Ausgabe verwendet werden sollen. Siehe https://google.aip.dev/132#ordering.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für die Methode GkeHub.ListMemberships.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

object (Membership)

Die Liste der übereinstimmenden Mitgliedschaften.
nextPageToken

string

Ein Token, mit dem die nächste Seite von Ressourcen von der Methode memberships.list angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.
unreachable[]

string

Liste der Standorte, die beim Abrufen dieser Liste 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.