Method: projects.locations.features.list

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Features aufgelistet werden. Wird im Format projects/*/locations/* angegeben.

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

  • gkehub.features.list

Suchparameter

Parameter
pageSize

integer

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

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

filter

string

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

Beispiele:

  • Feature mit dem Namen „servicemesh“ im Projekt „foo-proj“:
  name = "projects/foo-proj/locations/global/features/servicemesh"
  • Features mit einem Label namens foo:
  labels.foo:*
  • Features mit einem Label namens foo, dessen Wert bar ist:
  labels.foo = bar
orderBy

string

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.ListFeatures.

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

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

object (Feature)

Die Liste der übereinstimmenden Features

nextPageToken

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode features.list angefordert wird. Der Wert eines leeren Strings bedeutet, dass es keine weiteren Ressourcen gibt, die zurückgegeben werden können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.