Method: projects.locations.bareMetalAdminClusters.list

Enumera los clústeres de administrador de metal desnudo en una ubicación y un proyecto determinados.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el elemento superior del proyecto y la ubicación en los que se enumeran los clústeres. Formato: "projects/{project}/locations/{location}"

Parámetros de consulta

Parámetros
pageSize

integer

Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los solicitados. Si no se especifica, se devolverán, como máximo, 50 clústeres. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.

pageToken

string

Es un token que identifica una página de resultados que debe devolver el servidor.

view

enum (ClusterView)

Es la vista de los clústeres de administrador de Bare Metal. Cuando se especifica BASIC, solo se devuelven el nombre del recurso del clúster de administrador y la membresía. El valor predeterminado o no establecido CLUSTER_VIEW_UNSPECIFIED es el mismo que "FULL", que devuelve los detalles completos de la configuración del clúster de administrador.

allowMissing

boolean

Opcional. Si es verdadero, devuelve la lista de clústeres de administrador de Bare Metal, incluidos los que solo existen en RMS.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para enumerar los clústeres de administrador de Bare Metal.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "bareMetalAdminClusters": [
    {
      object (BareMetalAdminCluster)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
bareMetalAdminClusters[]

object (BareMetalAdminCluster)

Es la lista del clúster de administrador de Bare Metal.

nextPageToken

string

Es un token que identifica una página de resultados que debe devolver el servidor. Si el token no está vacío, significa que hay más resultados disponibles y que se deben recuperar repitiendo la solicitud con el token de página proporcionado.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Authentication Overview.

ClusterView

Es una vista para los recursos del clúster de administrador.

Enums
CLUSTER_VIEW_UNSPECIFIED Si no se establece el valor, se usa la vista predeterminada FULL.
BASIC Incluye información básica de un recurso de clúster de administrador, como el nombre y la membresía del recurso.
FULL Incluye la configuración completa del recurso del clúster de administrador de metal desnudo. Este es el valor predeterminado para el método ListBareMetalAdminClustersRequest.