REST Resource: corpora.permissions

Resource: Izin

Resource izin memberi pengguna, grup, atau seluruh dunia akses ke resource PaLM API (misalnya model yang disesuaikan, korpus).

Peran adalah kumpulan operasi yang diizinkan yang memungkinkan pengguna melakukan tindakan tertentu di resource PaLM API. Anda menetapkan peran untuk membuatnya tersedia bagi pengguna, grup, atau akun layanan. Saat menetapkan peran, Anda memberikan izin yang dimiliki peran tersebut.

Ada tiga peran konsentris. Setiap peran adalah superset dari operasi yang diizinkan peran sebelumnya:

  • pembaca dapat menggunakan resource (misalnya model yang di-tuning, korpus) untuk inferensi
  • penulis memiliki izin pembaca dan juga dapat mengedit serta membagikan
  • pemilik memiliki izin penulis dan juga dapat menghapus
Representasi JSON
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Kolom
name

string

Hanya output. ID. Nama izin. Nama unik akan dibuat saat pembuatan. Contoh: TunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Hanya output.

granteeType

enum (GranteeType)

Opsional. Tidak dapat diubah. Jenis penerima hibah.

emailAddress

string

Opsional. Tidak dapat diubah. Alamat email pengguna grup yang dirujuk oleh izin ini. Kolom tidak ditetapkan jika jenis penerima izin adalah SEMUA ORANG.

role

enum (Role)

Wajib. Peran yang diberikan oleh izin ini.

GranteeType

Menentukan jenis penerima izin ini.

Enum
GRANTEE_TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
USER Mewakili pengguna. Jika ditetapkan, Anda harus memberikan emailAddress untuk pengguna.
GROUP Mewakili grup. Jika ditetapkan, Anda harus memberikan emailAddress untuk grup.
EVERYONE Mewakili akses ke semua orang. Informasi tambahan tidak diperlukan.

Role

Menentukan peran yang diberikan oleh izin ini.

Enum
ROLE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
OWNER Pemilik dapat menggunakan, memperbarui, membagikan, dan menghapus fasilitas.
WRITER Penulis dapat menggunakan, memperbarui, dan membagikan resource.
READER Pembaca dapat menggunakan referensi.

Metode

create

Membuat izin ke resource tertentu.

delete

Menghapus izin.

get

Mendapatkan informasi tentang Izin tertentu.

list

Mencantumkan izin untuk resource tertentu.

patch

Memperbarui izin.