REST Resource: corpora.permissions

リソース: Permission

権限リソースは、PaLM API リソース（チューニング済みモデル、コーパスなど）へのアクセス権をユーザー、グループ、その他の対象に付与するものです。

ロールは許可された操作のコレクションであり、ユーザーは PaLM API リソースに対して特定の操作を行えるようになります。ユーザー、グループ、サービス アカウントが使用できるようにするには、ロールを割り当てます。ロールを割り当てると、そのロールに含まれる権限を付与します。

同心円状に 3 つのロールがあります。各ロールは、前のロールで許可される操作のスーパーセットです。

  • リーダーはリソース（チューニング済みモデル、コーパスなど）を推論に使用できる
  • ライターは閲覧権限があり、さらに編集や共有もできます
  • オーナーには書き込み権限があり、さらに
JSON 表現 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
フィールド
name

string

出力のみ。ID。権限名。作成時に一意の名前が生成されます。例: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 出力のみ。
granteeType

enum (GranteeType)

（省略可）変更不可。譲受人のタイプ。
emailAddress

string

（省略可）変更不可。この権限によって参照されるグループのユーザーのメールアドレス。権限の付与先のタイプが EVERYONE の場合、フィールドが設定されません。
role

enum (Role)

必須。この権限によって付与されるロール。

GranteeType

この権限の譲受人のタイプを定義します。

列挙型
GRANTEE_TYPE_UNSPECIFIED デフォルト値。この値は使用されません。
USER ユーザーを表します。設定する場合は、ユーザーのメールアドレスを指定する必要があります。
GROUP グループを表します。設定する場合は、グループの emailAddress を指定する必要があります。
EVERYONE すべてのユーザーへのアクセスを表します。それ以外の情報は必要ありません。

ロール

この権限によって付与されるロールを定義します。

列挙型
ROLE_UNSPECIFIED デフォルト値。この値は使用されません。
OWNER オーナーはリソースを使用、更新、共有、削除できます。
WRITER ライターはリソースを使用、更新、共有できます。
READER リーダーはリソースを使用できます。

Methods

create

 特定のリソースに対する権限を作成します。

delete

 権限を削除します。

get

 特定の権限に関する情報を取得します。

list

 特定のリソースに対する権限をリストします。

patch

 権限を更新します。