Method: projects.locations.memberships.list

Enumera membresías en una ubicación y un proyecto determinados.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior (proyecto y ubicación) en el que se mostrarán las membresías. Especificado en el formato projects/*/locations/*. projects/*/locations/- enumera las membresías en todas las regiones.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • gkehub.memberships.list

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Cuando se solicita una “página” de recursos, pageSize especifica la cantidad de recursos que se mostrarán. Si no se especifica o se establece en 0, se mostrarán todos los recursos.
pageToken

string

Opcional. Token que se muestra en la llamada anterior a memberships.list, que especifica la posición en la lista desde la que se debe continuar enumerando los recursos.
filter

string

Opcional. Listas que coinciden con la expresión de filtro, según la sintaxis descrita en https://google.aip.dev/160.

Ejemplos:

  • El nombre es bar en el proyecto foo-proj y la ubicación global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Membresías que tienen una etiqueta llamada foo:
  labels.foo:*
  • Membresías que tienen una etiqueta llamada foo cuyo valor es bar:
  labels.foo = bar
  • Membresías en el estado CREATING:
  state = CREATING
orderBy

string

Opcional. Se comparan y usan uno o más campos para ordenar el resultado. Consulta https://google.aip.dev/132#ordering.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para el método GkeHubMembershipService.ListMemberships.

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

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

object (Membership)

La lista de membresías que coinciden.
nextPageToken

string

Un token para solicitar la página siguiente de recursos del método memberships.list. El valor de una cadena vacía significa que no hay más recursos para mostrar.
unreachable[]

string

Lista de ubicaciones a las que no se pudo acceder cuando se recuperaba esta lista.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.