REST Resource: corpora.permissions

Risorsa: autorizzazione

La risorsa di autorizzazione concede a utenti, gruppi o al resto del mondo l'accesso alla risorsa dell'API PaLM (ad es. un modello ottimizzato o il corpus).

Un ruolo è una raccolta di operazioni consentite che consente agli utenti di eseguire azioni specifiche sulle risorse dell'API PaLM. Per renderli disponibili a utenti, gruppi o account di servizio, devi assegnare i ruoli. Quando assegni un ruolo, concedi le autorizzazioni incluse nel ruolo.

Esistono tre ruoli concentrici. Ogni ruolo è un soprainsieme delle operazioni consentite del ruolo precedente:

  • lettore può usare la risorsa (ad es. modello ottimizzato, corpus) per l'inferenza
  • l'autore dispone delle autorizzazioni del lettore e può inoltre modificare e condividere
  • proprietario dispone delle autorizzazioni di autore e può inoltre eliminare
Rappresentazione JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Campi
name

string

Solo output. Identificatore. Il nome dell'autorizzazione. Al momento della creazione, verrà generato un nome univoco. Esempi: TuneModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Solo output.
granteeType

enum (GranteeType)

Campo facoltativo. Immutabile. Il tipo di beneficiario.
emailAddress

string

Campo facoltativo. Immutabile. L'indirizzo email dell'utente del gruppo a cui fa riferimento questa autorizzazione. Il campo non è impostato quando il tipo di beneficiario dell'autorizzazione è TUTTI.
role

enum (Role)

Obbligatorio. Il ruolo concesso da questa autorizzazione.

GranteeType

Definisce i tipi di beneficiari di questa autorizzazione.

Enum
GRANTEE_TYPE_UNSPECIFIED Il valore predefinito. Questo valore non è utilizzato.
USER Rappresenta un utente. Se impostato, devi fornire emailAddress per l'utente.
GROUP Rappresenta un gruppo. Se impostato, devi fornire emailAddress per il gruppo.
EVERYONE Rappresenta l'accesso per tutti. Non sono necessarie ulteriori informazioni.

Ruolo

Definisce il ruolo concesso da questa autorizzazione.

Enum
ROLE_UNSPECIFIED Il valore predefinito. Questo valore non è utilizzato.
OWNER Il proprietario può utilizzare, aggiornare, condividere ed eliminare la risorsa.
WRITER Lo scrittore può utilizzare, aggiornare e condividere la risorsa.
READER Il lettore può utilizzare la risorsa.

Metodi

create

 Crea un'autorizzazione per una risorsa specifica.

delete

 Elimina l'autorizzazione.

get

 Recupera le informazioni su un'autorizzazione specifica.

list

 Elenca le autorizzazioni per la risorsa specifica.

patch

 Aggiorna l'autorizzazione.