REST Resource: corpora.permissions

資源：權限

透過權限資源，使用者、群組或全世界的使用者都能存取 PaLM API 資源 (例如經過調整的模型、語料庫)。

角色是一組允許的作業，可讓使用者對 PaLM API 資源執行特定動作。如要讓使用者、群組或服務帳戶都能使用這些項目，您可以指派角色。指派角色後，就會授予該角色包含的權限。

這裡有三個同心角色每個角色都是先前角色允許作業的超集：

  • 讀取器可以使用資源 (例如經過調整的模型、語料庫) 進行推論
  • 寫入者俱有讀取者的權限，還可編輯及分享
  • 擁有者俱有寫入者的權限，另外也能刪除
JSON 表示法 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
欄位
name

string

僅供輸出。ID。權限名稱。系統會在建立時產生不重複的名稱。例如：tuneModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}。僅供輸出。
granteeType

enum (GranteeType)

選用設定。無法變更。授予對象的類型。
emailAddress

string

選用設定。無法變更。這個權限參照的群組使用者的電子郵件地址。權限授予對象類型為「EVERYONE」時，未設定欄位。
role

enum (Role)

必要欄位。這個權限授予的角色。

GranteeType

定義這項權限的授予對象類型。

列舉
GRANTEE_TYPE_UNSPECIFIED 預設值。這個值未使用。
USER 代表使用者。設定時，您必須提供使用者的電子郵件地址地址。
GROUP 代表群組。設定時，您必須提供群組電子郵件地址。
EVERYONE 代表所有人可以存取。不需要額外提供資訊。

角色

定義這項權限授予的角色。

列舉
ROLE_UNSPECIFIED 預設值。這個值未使用。
OWNER 擁有者可以使用、更新、共用及刪除資源。
WRITER 寫入者可使用、更新及分享資源。
READER 讀取者可以使用資源。

方法

create

 建立特定資源的權限。

delete

 刪除權限。

get

 取得特定權限的資訊。

list

 列出特定資源的權限。

patch

 更新權限。