REST Resource: corpora.permissions

Ressource: Berechtigung

Die Berechtigungsressource ermöglicht Nutzern, Gruppen oder dem Rest der Welt Zugriff auf die PaLM API-Ressource (z.B. ein abgestimmtes Modell oder Korpus).

Eine Rolle ist eine Sammlung zulässiger Vorgänge, mit denen Nutzer bestimmte Aktionen für PaLM API-Ressourcen ausführen können. Um sie für Nutzer, Gruppen oder Dienstkonten verfügbar zu machen, weisen Sie Rollen zu. Wenn Sie eine Rolle zuweisen, gewähren Sie Berechtigungen, die in der Rolle enthalten sind.

Es gibt drei konzentrische Rollen. Jede Rolle ist eine Obermenge der zulässigen Vorgänge der vorherigen Rolle:

  • Leser können die Ressource (z. B. abgestimmtes Modell, Korpus) für Inferenzen verwenden.
  • Der Autor hat Leseberechtigungen und kann zusätzlich das Dokument bearbeiten und freigeben
  • Der Eigentümer hat die Berechtigungen des Autors und kann zusätzlich Folgendes löschen:
JSON-Darstellung 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Felder
name

string

Nur Ausgabe Kennung. Der Name der Berechtigung. Beim Erstellen wird ein eindeutiger Name generiert. Beispiele: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Nur Ausgabe.
granteeType

enum (GranteeType)

Optional. Nicht veränderbar. Typ des Empfängers einer Förderung
emailAddress

string

Optional. Nicht veränderbar. Die E-Mail-Adresse des Nutzers der Gruppe, auf die sich diese Berechtigung bezieht. Das Feld ist nicht festgelegt, wenn der Empfängertyp der Berechtigung EVERYONE ist.
role

enum (Role)

Erforderlich. Die durch diese Berechtigung gewährte Rolle.

GranteeType

Definiert die Typen des Empfängers dieser Berechtigung.

Enums
GRANTEE_TYPE_UNSPECIFIED Der Standardwert. Dieser Wert wird nicht verwendet.
USER Stellt einen Nutzer dar. Wenn dies festgelegt ist, müssen Sie die E-Mail-Adresse für den Nutzer angeben.
GROUP Stellt eine Gruppe dar. Wenn festgelegt, müssen Sie die E-Mail-Adresse für die Gruppe angeben.
EVERYONE Stellt Zugriff für alle dar. Es sind keine zusätzlichen Informationen erforderlich.

Rolle

Definiert die durch diese Berechtigung gewährte Rolle.

Enums
ROLE_UNSPECIFIED Der Standardwert. Dieser Wert wird nicht verwendet.
OWNER Der Inhaber kann die Ressource verwenden, aktualisieren, freigeben und löschen.
WRITER Der Autor kann die Ressource verwenden, aktualisieren und freigeben.
READER Reader kann die Ressource verwenden.

Methoden

create

 Erstellen Sie eine Berechtigung für eine bestimmte Ressource.

delete

 Löscht die Berechtigung.

get

 Ruft Informationen zu einer bestimmten Berechtigung ab.

list

 Listet Berechtigungen für die bestimmte Ressource auf.

patch

 Aktualisiert die Berechtigung.