REST Resource: corpora.permissions

资源：权限

权限资源可向用户、群组或世界各地的其他人授予对 PaLM API 资源（例如经调整的模型、语料库）的访问权限。

角色是允许对 PaLM API 资源执行特定操作的允许操作集合。如需将其提供给用户、群组或服务帐号，您可以分配角色。分配某个角色时，您授予了该角色所包含的权限。

有三种同心角色。每个角色都是上一个角色允许的操作的超集：

  • 读取器可以使用相应资源（例如经调整的模型、语料库）进行推理
  • 作者拥有读者权限，还可以编辑和分享
  • 所有者拥有写入者权限，还可以删除
JSON 表示法 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
字段
name

string

仅供输出。标识符。权限名称。创建时将生成唯一名称。示例：tuneModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 仅输出。
granteeType

enum (GranteeType)

可选。不可变。受助人的类型。
emailAddress

string

可选。不可变。此权限所引用的群组用户的电子邮件地址。如果权限的被授权者类型为“EVERYONE”，则不会设置此字段。
role

enum (Role)

必需。此权限授予的角色。

GranteeType

定义此权限的被授予者的类型。

枚举
GRANTEE_TYPE_UNSPECIFIED 默认值。此值未使用。
USER 表示用户。设置后，您必须为用户提供 emailAddress。
GROUP 表示群组。设置后，您必须提供群组的 emailAddress。
EVERYONE 表示对所有人的访问权限。无需提供额外信息。

角色

定义此权限所授予的角色。

枚举
ROLE_UNSPECIFIED 默认值。此值未使用。
OWNER 所有者可以使用、更新、共享和删除资源。
WRITER 写入者可以使用、更新和共享资源。
READER 读取者可以使用资源。

方法

create

 创建对特定资源的权限。

delete

 删除权限。

get

 获取有关特定权限的信息。

list

 列出特定资源的权限。

patch

 更新权限。