Method: projects.locations.userStores.userLicenses.list

Apresenta as licenças de utilizador.

Pedido HTTP

GET https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/userStores/*}/userLicenses

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso [UserStore][] principal, formato: projects/{project}/locations/{location}/userStores/{userStoreId}.

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. Tamanho da página solicitado. O servidor pode devolver menos itens do que o pedido. Se não for especificado, a predefinição é 10. O valor máximo é 50. Os valores superiores a 50 são convertidos para 50.

Se este campo for negativo, é devolvido um erro INVALID_ARGUMENT.

pageToken

string

Opcional. Um token de página, recebido de uma chamada userLicenses.list anterior. Faculte este valor para obter a página seguinte.

Quando paginar, todos os outros parâmetros fornecidos a userLicenses.list têm de corresponder à chamada que forneceu o token da página.

filter

string

Opcional. Filtro para o pedido da lista.

Campos suportados:

  • licenseAssignmentState

Exemplos:

  • licenseAssignmentState = ASSIGNED para listar as licenças de utilizador atribuídas.
  • licenseAssignmentState = NO_LICENSE para listar os utilizadores sem licença.
  • licenseAssignmentState = NO_LICENSE_ATTEMPTED_LOGIN para listar os utilizadores que tentaram iniciar sessão, mas não têm uma licença atribuída.
  • licenseAssignmentState != NO_LICENSE_ATTEMPTED_LOGIN para filtrar os utilizadores que tentaram iniciar sessão, mas não têm uma licença atribuída.

Corpo do pedido

O corpo do pedido tem de estar vazio.

Corpo da resposta

Mensagem de resposta para UserLicenseService.ListUserLicenses.

Se for bem-sucedido, o corpo da resposta contém dados com a seguinte estrutura:

Representação JSON
{
  "userLicenses": [
    {
      object (UserLicense)
    }
  ],
  "nextPageToken": string
}
Campos
userLicenses[]

object (UserLicense)

Todos os UserLicenses do cliente.

nextPageToken

string

Um token que pode ser enviado como pageToken para obter a página seguinte. Se este campo for omitido, não existem páginas subsequentes.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso parent:

  • discoveryengine.userStores.listUserLicenses

Para mais informações, consulte a documentação do IAM.