REST Resource: corpora.permissions

Recurso: Permiso

El recurso de permiso otorga acceso de usuario, grupo o el resto del mundo al recurso de la API de PaLM (p.ej., un modelo ajustado, corpus).

Un rol es una colección de operaciones permitidas que permite a los usuarios realizar acciones específicas en los recursos de la API de PaLM. A fin de que estén disponibles para los usuarios, los grupos o las cuentas de servicio, debes asignarles roles. Cuando asignas un rol, otorgas los permisos que este contiene.

Hay tres roles concéntricos. Cada función es un superconjunto de las operaciones permitidas de la función anterior:

  • el lector puede usar el recurso (p. ej., modelo ajustado, corpus) para realizar inferencias.
  • el escritor tiene permiso de lectura y, además, puede editar y compartir contenido
  • tiene permisos de escritor y, además, puede borrar
Representación JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Campos
name

string

Solo salida. Identificador. Es el nombre del permiso. Se generará un nombre único en el momento de la creación. Ejemplos: AssuredModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Solo salida.
granteeType

enum (GranteeType)

Opcional. Inmutable. Es el tipo de beneficiario.
emailAddress

string

Opcional. Inmutable. La dirección de correo electrónico del usuario del grupo al que hace referencia este permiso. El campo no se establece cuando el tipo de beneficiario del permiso es EVERYONE.
role

enum (Role)

Obligatorio. El rol que otorga este permiso.

GranteeType

Define los tipos de beneficiario de este permiso.

Enumeradores
GRANTEE_TYPE_UNSPECIFIED Es el valor predeterminado. Este valor no se usa.
USER Representa a un usuario. Cuando se establece, debes proporcionar la dirección de correo electrónico del usuario.
GROUP Representa un grupo. Si estableces la dirección, debes proporcionar la dirección de correo electrónico del grupo.
EVERYONE Representa el acceso para todos. No se requiere información adicional.

Rol

Define el rol que otorga este permiso.

Enumeradores
ROLE_UNSPECIFIED Es el valor predeterminado. Este valor no se usa.
OWNER El propietario puede usar, actualizar, compartir y borrar el recurso.
WRITER El escritor puede usar, actualizar y compartir el recurso.
READER El lector puede usar el recurso.

Métodos

create

 Crea un permiso para un recurso específico.

delete

 Borra el permiso.

get

 Obtiene información sobre un permiso específico.

list

 Enumera los permisos para el recurso específico.

patch

 Actualiza el permiso.