REST Resource: corpora.permissions

Zasób: Permission

Zasób uprawnień przyznaje użytkownikowi, grupie lub reszty świata dostęp do zasobu interfejsu PaLM API (np. dostrojonego modelu, korpusu).

Rola to zbiór dozwolonych operacji, który pozwala użytkownikom wykonywać określone działania na zasobach interfejsu PaLM API. Aby udostępnić je użytkownikom, grupom lub kontom usługi, należy przypisać role. Przypisując rolę, przyznajesz jej uprawnienia.

Są 3 koncentryczne role. Każda rola to nadzbiór dozwolonych operacji dla poprzedniej roli:

  • czytelnik może używać zasobu (np. dostrojonego modelu, korpusu) do wnioskowania
  • autor ma uprawnienia czytelnika i dodatkowo może edytować oraz udostępniać
  • właściciel ma uprawnienia do zapisu i dodatkowo może usuwać
Zapis JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa uprawnienia. Podczas tworzenia zostanie wygenerowana unikalna nazwa. Przykłady: formattedModels/{tunedModel}/permissions/{permission} korpusy/{corpus}/permissions/{permission} Tylko dane wyjściowe.
granteeType

enum (GranteeType)

Opcjonalnie. Niezmienne. Typ obdarowanego.
emailAddress

string

Opcjonalnie. Niezmienne. Adres e-mail użytkownika grupy, do której odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ uprawnienia to WSZYSTKO.
role

enum (Role)

To pole jest wymagane. Rola przypisana przez to uprawnienie.

GranteeType

Określa typy osób, którym przyznano to uprawnienie.

Wartości w polu enum
GRANTEE_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
USER Reprezentuje użytkownika. Gdy jest skonfigurowana, musisz podać adres e-mail użytkownika.
GROUP Reprezentuje grupę. Gdy go ustawisz, musisz podać adres e-mail grupy.
EVERYONE Reprezentuje dostęp dla wszystkich. Nie są wymagane żadne dodatkowe informacje.

Rola

Określa rolę przypisaną przez to uprawnienie.

Wartości w polu enum
ROLE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
OWNER Właściciel może używać, aktualizować, udostępniać i usuwać zasoby.
WRITER Zapisujący może korzystać z zasobu, aktualizować go i udostępniać.
READER Czytelnik może korzystać z tego zasobu.

Metody

create

 Utwórz uprawnienie do określonego zasobu.

delete

 Usuwa uprawnienie.

get

 Pobiera informacje o konkretnych uprawnieniach.

list

 Wyświetla listę uprawnień do określonego zasobu.

patch

 Aktualizuje uprawnienia.