REST Resource: corpora.permissions

Recurso: permissão

O recurso de permissão concede ao usuário, grupo ou o restante do mundo acesso ao recurso da API PaLM (por exemplo, um modelo ajustado, corpus).

Um papel é um conjunto de operações permitidas que permitem aos usuários realizar ações específicas nos recursos da API PaLM. Atribua papéis para disponibilizá-los a usuários, grupos ou contas de serviço. Ao atribuir um papel, você concede as permissões contidas nele.

Há três papéis concêntricos. Cada papel é um superconjunto das operações permitidas do papel anterior:

  • o leitor pode usar o recurso (por exemplo, modelo ajustado, corpus) para inferência
  • escritor tem permissões de leitor e também pode editar e compartilhar
  • o proprietário tem permissões de escritor e também pode excluir
Representação JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Campos
name

string

Apenas saída. Identificador. O nome da permissão. Um nome exclusivo será gerado na criação. Exemplos: ajustadaModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} apenas saída.
granteeType

enum (GranteeType)

Opcional. Imutável. O tipo do beneficiário.
emailAddress

string

Opcional. Imutável. O endereço de e-mail do usuário do grupo ao qual esta permissão se refere. O campo não é definido quando o tipo de beneficiário da permissão é EVERYONE.
role

enum (Role)

Obrigatório. O papel concedido pela permissão.

GranteeType

Define os tipos do beneficiário dessa permissão.

Enums
GRANTEE_TYPE_UNSPECIFIED O valor padrão. Esse valor não é usado.
USER Representa um usuário. Quando definido, você precisa fornecer o endereço de e-mail do usuário.
GROUP Representa um grupo. Quando definido, você precisa fornecer o emailAddress para o grupo.
EVERYONE Representa o acesso para todos. Nenhuma informação extra é necessária.

Papel

Define o papel concedido pela permissão.

Enums
ROLE_UNSPECIFIED O valor padrão. Esse valor não é usado.
OWNER O proprietário pode usar, atualizar, compartilhar e excluir o recurso.
WRITER O gravador pode usar, atualizar e compartilhar o recurso.
READER O leitor pode usar o recurso.

Métodos

create

 Cria uma permissão para um recurso específico.

delete

 Exclui a permissão.

get

 Recebe informações sobre uma permissão específica.

list

 Lista as permissões para o recurso específico.

patch

 Atualiza a permissão.