资源:权限
权限资源可向用户、群组或世界各地的其他人授予对 PaLM API 资源(例如经调整的模型、语料库)的访问权限。
角色是允许对 PaLM API 资源执行特定操作的允许操作集合。如需将其提供给用户、群组或服务帐号,您可以分配角色。分配某个角色时,您授予了该角色所包含的权限。
有三种同心角色。每个角色都是上一个角色允许的操作的超集:
- 读取器可以使用相应资源(例如经调整的模型、语料库)进行推理
- 作者拥有读者权限,还可以编辑和分享
- 所有者拥有写入者权限,还可以删除
JSON 表示法 |
---|
{ "name": string, "granteeType": enum ( |
字段 | |
---|---|
name |
仅供输出。标识符。权限名称。创建时将生成唯一名称。示例:tuneModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 仅输出。 |
granteeType |
可选。不可变。受助人的类型。 |
emailAddress |
可选。不可变。此权限所引用的群组用户的电子邮件地址。如果权限的被授权者类型为“EVERYONE”,则不会设置此字段。 |
role |
必需。此权限授予的角色。 |
GranteeType
定义此权限的被授予者的类型。
枚举 | |
---|---|
GRANTEE_TYPE_UNSPECIFIED |
默认值。此值未使用。 |
USER |
表示用户。设置后,您必须为用户提供 emailAddress。 |
GROUP |
表示群组。设置后,您必须提供群组的 emailAddress。 |
EVERYONE |
表示对所有人的访问权限。无需提供额外信息。 |
角色
定义此权限所授予的角色。
枚举 | |
---|---|
ROLE_UNSPECIFIED |
默认值。此值未使用。 |
OWNER |
所有者可以使用、更新、共享和删除资源。 |
WRITER |
写入者可以使用、更新和共享资源。 |
READER |
读取者可以使用资源。 |
方法 |
|
---|---|
|
创建对特定资源的权限。 |
|
删除权限。 |
|
获取有关特定权限的信息。 |
|
列出特定资源的权限。 |
|
更新权限。 |