REST Resource: corpora.permissions

Ressource: Permission

La ressource d'autorisation accorde à l'utilisateur, au groupe ou au reste du monde l'accès à la ressource de l'API PaLM (par exemple, un modèle réglé ou un corpus).

Un rôle est un ensemble d'opérations autorisées qui permet aux utilisateurs d'effectuer des actions spécifiques sur les ressources de l'API PaLM. Pour les rendre disponibles pour les utilisateurs, les groupes ou les comptes de service, vous devez leur attribuer des rôles. Lorsque vous attribuez un rôle, vous lui accordez les autorisations qu'il contient.

Il y a trois rôles concentriques. Chaque rôle correspond à un sur-ensemble des opérations autorisées du rôle précédent:

  • Le lecteur peut utiliser la ressource (par exemple, modèle réglé, corpus) pour l'inférence
  • rédacteur dispose des autorisations de lecture et peut également modifier et partager
  • propriétaire dispose des autorisations de rédacteur et peut aussi supprimer
Représentation JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de l'autorisation. Un nom unique sera généré à la création. Exemples: TuneModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Résultat uniquement.
granteeType

enum (GranteeType)

Facultatif. Immuable. Type du bénéficiaire.
emailAddress

string

Facultatif. Immuable. Adresse e-mail de l'utilisateur du groupe auquel cette autorisation fait référence. Le champ n'est pas défini lorsque le type de bénéficiaire de l'autorisation est EVERYONE.
role

enum (Role)

Obligatoire. Rôle accordé par cette autorisation.

GranteeType

Définit les types du bénéficiaire de cette autorisation.

Enums
GRANTEE_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
USER Représente un utilisateur. Lorsque cette option est définie, vous devez indiquer "emailAddress" pour l'utilisateur.
GROUP Représente un groupe. Lorsque cette option est définie, vous devez indiquer "emailAddress" pour le groupe.
EVERYONE Représente l'accès à tout le monde. Aucune information supplémentaire n'est requise.

Rôle

Définit le rôle accordé par cette autorisation.

Enums
ROLE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
OWNER Le propriétaire peut utiliser, mettre à jour, partager et supprimer la ressource.
WRITER Le rédacteur peut utiliser, mettre à jour et partager la ressource.
READER Le lecteur peut utiliser la ressource.

Méthodes

create

 Créez une autorisation pour une ressource spécifique.

delete

 Supprime l'autorisation.

get

 Récupère des informations sur une autorisation spécifique.

list

 Répertorie les autorisations pour la ressource spécifique.

patch

 Met à jour l'autorisation.