Method: projects.locations.bareMetalClusters.list

Répertorie les clusters Bare Metal d'un projet et d'un emplacement donnés.

Requête HTTP

GET https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent du projet et de l'emplacement où les clusters sont listés. Format : "projects/{project}/locations/{location}"

Paramètres de requête

Paramètres
pageSize

integer

Taille de la page demandée. Le serveur peut renvoyer moins d'éléments que demandé. Si aucune valeur n'est spécifiée, 50 clusters au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer.
filter

string

Expression de filtrage des ressources suivant https://google.aip.dev/160. Lorsque ce champ n'est pas vide, seules les ressources dont le champ "attributes" correspond au filtre sont renvoyées.
view

enum (ClusterView)

Vue pour les clusters Bare Metal. Lorsque BASIC est spécifié, seuls le nom de ressource du cluster et l'appartenance au cluster d'administrateur sont renvoyés. La valeur par défaut/non définie CLUSTER_VIEW_UNSPECIFIED est identique à "FULL", qui renvoie tous les détails de configuration du cluster.
allowMissing

boolean

Facultatif. Si la valeur est "true", renvoie la liste des clusters Bare Metal, y compris ceux qui n'existent que dans RMS.

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 liste des clusters Bare Metal.

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

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

object (BareMetalCluster)

Liste des clusters Bare Metal.
nextPageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer. Si le jeton n'est pas vide, cela signifie que d'autres résultats sont disponibles et doivent être récupérés en répétant la requête avec le jeton de page fourni.
unreachable[]

string

Emplacements inaccessibles.

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 Authentication Overview.

ClusterView

Vue des ressources du cluster.

Énumérations
CLUSTER_VIEW_UNSPECIFIED Si la valeur n'est pas définie, la vue par défaut FULL est utilisée.
BASIC Inclut les informations de base d'une ressource de cluster, y compris le nom de la ressource de cluster et l'appartenance au cluster d'administrateur.
FULL Inclut la configuration complète de la ressource de cluster Bare Metal. Il s'agit de la valeur par défaut de la méthode ListBareMetalClustersRequest.