Method: projects.locations.memberships.list

Lista Assinaturas em um determinado projeto e local.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O pai (projeto e local) em que as assinaturas serão listadas. Especificado no formato projects/*/locations/*. projects/*/locations/- lista assinaturas em todas as regiões.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • gkehub.memberships.list

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. Ao solicitar uma "página" de recursos, pageSize especifica o número de recursos a serem retornados. Se não for especificado ou definido como 0, todos os recursos serão retornados.

pageToken

string

Opcional. Token retornado pela chamada anterior para memberships.list, que especifica a posição na lista de onde continuar listando os recursos.

filter

string

Opcional. Lista as assinaturas que correspondem à expressão de filtro, seguindo a sintaxe descrita em https://google.aip.dev/160.

Por exemplo:

  • O nome é bar no projeto foo-proj e o local global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Assinaturas com um rótulo chamado foo:
  labels.foo:*
  • Assinaturas com um rótulo chamado foo, cujo valor é bar:
  labels.foo = bar
  • Assinaturas no estado CRIANDO:
  state = CREATING
orderBy

string

Opcional. Um ou mais campos para comparar e usar para ordenar a saída. Acesse https://google.aip.dev/132#ordering.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para o método GkeHubMembershipService.ListMemberships.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "resources": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
resources[]

object (Membership)

Lista de assinaturas correspondentes.

nextPageToken

string

Um token para solicitar a próxima página de recursos do método memberships.list. O valor de uma string vazia significa que não há mais recursos a serem retornados.

unreachable[]

string

Lista de locais que não puderam ser alcançados ao buscar esta lista.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.