Method: projects.locations.memberships.list

Répertorie les appartenances d'un projet et d'un emplacement donnés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Membership seront répertoriées. Spécifié au format projects/*/locations/*. projects/*/locations/- répertorie les ressources Membership dans toutes les régions.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.list

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Lorsque vous demandez une "page" de ressources, pageSize spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

pageToken

string

Facultatif. Jeton renvoyé par l'appel précédent à memberships.list qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

filter

string

Facultatif. Répertorie les ressources Membership qui correspondent à l'expression de filtre, en suivant la syntaxe décrite sur https://google.aip.dev/160.

Exemples :

  • Le nom est bar dans le projet foo-proj et l'emplacement global :
  name = "projects/foo-proj/locations/global/membership/bar"
  • Ressources Membership dont le libellé est foo :
  labels.foo:*
  • Ressources Membership associées au libellé foo dont la valeur est bar :
  labels.foo = bar
  • Ressources Membership à l'état CREATING :
  state = CREATING
orderBy

string

Facultatif. Un ou plusieurs champs à comparer et à utiliser pour trier la sortie. Consultez la page https://google.aip.dev/132#ordering.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour la méthode GkeHubMembershipService.ListMemberships.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "resources": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
resources[]

object (Membership)

Liste des ressources Membership correspondantes.

nextPageToken

string

Jeton permettant de demander la page de ressources suivante à la méthode memberships.list. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

unreachable[]

string

Liste des zones géographiques inaccessibles lors de la récupération de cette liste.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.