Permissions

Metode: TunedModels.permissions.create

Buat izin untuk resource tertentu.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Parameter jalur

parent string

Wajib. Resource induk Permission. Format: tunedModels/{tunedModel} corpora/{corpus} Formatnya berupa tunedModels/{tunedmodel}.

Isi permintaan

Isi permintaan memuat instance Permission.

Bidang
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.

Contoh permintaan

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)

Isi respons

Jika berhasil, isi respons memuat instance Permission yang baru dibuat.

Metode: TunedModels.permissions.get

Mendapatkan informasi tentang Izin tertentu.

Endpoint

dapatkan https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Parameter jalur

name string

Wajib. Nama resource izin.

Format: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Formatnya berupa tunedModels/{tunedmodel}/permissions/{permission}.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)

Isi respons

Jika berhasil, isi respons memuat instance Permission.

Metode: TunedModels.permissions.list

Mencantumkan izin untuk resource tertentu.

Endpoint

dapatkan https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Parameter jalur

parent string

Wajib. Resource induk dari izin. Format: tunedModels/{tunedModel} corpora/{corpus} Formatnya berupa tunedModels/{tunedmodel}.

Parameter kueri

pageSize integer

Opsional. Jumlah maksimum Permission untuk ditampilkan (per halaman). Layanan mungkin menampilkan lebih sedikit izin.

Jika tidak ditentukan, maksimal 10 izin akan ditampilkan. Metode ini menampilkan maksimal 1.000 izin per halaman, meskipun Anda melewati pageSize yang lebih besar.

pageToken string

Opsional. Token halaman, diterima dari panggilan permissions.list sebelumnya.

Berikan pageToken yang ditampilkan oleh satu permintaan sebagai argumen bagi permintaan berikutnya untuk mengambil halaman berikutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke permissions.list harus cocok dengan panggilan yang menyediakan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)

Isi respons

Jika berhasil, isi respons memuat instance ListPermissionsResponse.

Metode: TunedModels.permissions.patch

Memperbarui izin.

Endpoint

tambalan https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

Parameter jalur

permission.name string

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

Parameter kueri

updateMask string (FieldMask format)

Wajib. Daftar kolom yang akan diperbarui. Yang diterima: - peran (kolom Permission.role)

Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi permintaan

Isi permintaan memuat instance Permission.

Bidang
role enum (Role)

Wajib. Peran yang diberikan oleh izin ini.

Contoh permintaan

Python

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

Isi respons

Jika berhasil, isi respons memuat instance Permission.

Metode: TunedModels.permissions.delete

Menghapus izin.

Endpoint

hapus https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Parameter jalur

name string

Wajib. Nama resource izin. Format: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Formatnya berupa tunedModels/{tunedmodel}/permissions/{permission}.

Isi permintaan

Isi permintaan harus kosong.

Contoh permintaan

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()

Isi respons

Jika berhasil, isi respons akan kosong.

Metode: TunedModels.transferOwnership

Mentransfer kepemilikan model yang di-tuning. Ini satu-satunya cara untuk mengubah kepemilikan model yang di-tuning. Pemilik saat ini akan didowngrade menjadi peran penulis.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

Parameter jalur

name string

Wajib. Nama resource model yang di-tuning untuk mentransfer kepemilikan.

Format: tunedModels/my-model-id Formatnya adalah tunedModels/{tunedmodel}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Bidang
emailAddress string

Wajib. Alamat email pengguna yang menjadi tujuan transfer model yang telah disesuaikan.

Isi respons

Jika berhasil, isi respons akan kosong.

Resource REST: TunedModels.permissions

Resource: Izin

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

Peran adalah kumpulan operasi yang diizinkan yang memungkinkan pengguna melakukan tindakan spesifik pada resource PaLM API. Tetapkan peran agar tersedia bagi pengguna, grup, atau akun layanan. Saat menetapkan peran, Anda memberikan izin yang terdapat pada peran tersebut.

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

  • pembaca dapat menggunakan sumber daya (misalnya model yang disesuaikan, korpus) untuk inferensi
  • penulis memiliki izin pembaca dan juga dapat mengedit dan membagikan
  • memiliki izin penulis dan juga dapat menghapus
Bidang
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.

Representasi JSON
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Respons dari ListPermissions yang berisi daftar izin yang diberi nomor halaman.

Bidang
permissions[] object (Permission)

Izin yang ditampilkan.

nextPageToken string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya.

Jika kolom ini dihilangkan, maka tidak ada lagi halaman.

Representasi JSON
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}