Controllo dell'accesso con IAM

AI Platform Prediction utilizza Identity and Access Management (IAM) per gestire l'accesso alle risorse. Per concedere l'accesso a una risorsa, assegna uno o più ruoli a un utente, un gruppo o un account di servizio.

Esistono tre tipi di ruoli IAM che possono essere utilizzati in AI Platform Prediction:

  • I ruoli di base (Proprietario, Visualizzatore ed Editor) sono comuni a tutti i servizi Google Cloud.

  • I ruoli di previsione di AI Platform predefiniti offrono un controllo granulare degli accessi alle risorse di AI Platform Prediction a livello di progetto e modello.

  • I ruoli personalizzati consentono di scegliere un insieme specifico di autorizzazioni, creare un ruolo personale con quelle autorizzazioni e concedere il ruolo agli utenti della tua organizzazione.

Questa guida si concentra sui ruoli predefiniti di AI Platform Prediction, sul loro utilizzo tipico e sulle autorizzazioni associate.

La guida è incentrata sui ruoli e sulle autorizzazioni necessari per accedere alle risorse di AI Platform Prediction. Per saperne di più sulle autorizzazioni di cui dispongono queste risorse per accedere ad altre risorse Google Cloud, scopri di più sull'account di servizio gestito da Google e sugli account di servizio personalizzati di AI Platform.

Ruoli di base

I ruoli IAM legacy di AI Platform Prediction si basano sui ruoli di base comuni a tutti i servizi Google Cloud: Proprietario, Visualizzatore ed Editor.

Il ruolo legacy Editor del progetto equivale al ruolo Amministratore previsione AI Platform.

Il ruolo Visualizzatore del progetto precedente concede le stesse autorizzazioni del ruolo Visualizzatore AI Platform Prediction, più l'accesso per inviare richieste di previsione online. Il vantaggio dell'utilizzo del ruolo Visualizzatore previsione AI Platform è che l'utente ottiene l'accesso di sola lettura alle risorse AI Platform Prediction.

Ruoli predefiniti

I ruoli predefiniti concedono una serie di autorizzazioni correlate. AI Platform Prediction offre ruoli predefiniti per il progetto e anche per singoli modelli, job e operazioni.

Per visualizzare un elenco completo delle autorizzazioni per ciascun ruolo, fai clic sul nome del ruolo.

Ruoli progetto

I ruoli Amministratore, Sviluppatore e Visualizzatore di AI Platform Prediction concedono diversi livelli di accesso alle risorse a livello di progetto.

Per aggiungere, aggiornare o rimuovere questi ruoli nel progetto AI Platform Prediction, consulta la documentazione su come concedere, modificare e revocare l'accesso.

Titolo del ruolo Nome ruolo Funzionalità
Amministratore previsioni AI Platform

roles/ml.admin

Controllo completo del progetto AI Platform Prediction e dei relativi job, operazioni, modelli e versioni.

Nota: il ruolo di base Editor del progetto equivale a roles/ml.admin.

Sviluppatore AI Platform Prediction

roles/ml.developer

Crea job di addestramento e previsione, modelli e versioni e invia richieste di previsione online.

Visualizzatore previsioni AI Platform

roles/ml.viewer

Accesso in sola lettura alle risorse di AI Platform Prediction.

Ruoli modello

I ruoli Proprietario modello di previsione di AI Platform e Utente modello concedono autorizzazioni diverse a una determinata risorsa del modello.

Puoi condividere i modelli con privati o servizi assegnando loro il ruolo Utente modello.

Titolo del ruolo Nome ruolo Funzionalità
Proprietario modello di previsione AI Platform

roles/ml.modelOwner

Accesso completo al modello e alle relative versioni. Questo ruolo viene concesso automaticamente all'utente che crea il modello.

Utente modello di previsione AI Platform

roles/ml.modelUser

Autorizzazioni per leggere il modello e le relative versioni e utilizzarle per la previsione. L'assegnazione di questo ruolo semplifica la condivisione di modelli specifici.

Ruoli operativi e job

Analogamente al ruolo Proprietario modello, esistono ruoli di proprietario a livello di job e risorsa operativa che vengono assegnati automaticamente all'utente che crea il job o l'operazione. Questi ruoli consentono all'utente il controllo completo di qualsiasi prestazione o operazione che crea. Per ulteriori informazioni, consulta le autorizzazioni per i ruoli di job e operazioni.

Autorizzazioni e ruoli

Fai riferimento a questa sezione per un elenco completo delle autorizzazioni concesse con ciascun ruolo predefinito di AI Platform Prediction. Se questi ruoli predefiniti non soddisfano le tue esigenze, utilizza questa sezione come riferimento per la creazione di ruoli personalizzati.

Ruolo amministratore

Nome del ruolo Description Autorizzazioni
roles/ml.admin Amministratore AI Platform Prediction

Accesso completo al progetto AI Platform Prediction e ai relativi job, operazioni, modelli e versioni.

Nota:la migrazione a questo ruolo dal ruolo di base Editor del progetto è abbastanza semplice. Se in precedenza hai utilizzato il ruolo Editor di base assegnato a livello di progetto, puoi utilizzare questo ruolo roles/ml.admin per concedere esattamente lo stesso insieme di autorizzazioni all'utente.

  • resourcemanager.projects.get
  • ml.projects.getConfig
  • ml.jobs.create
  • ml.jobs.list
  • ml.jobs.get
  • ml.jobs.getIamPolicy
  • ml.jobs.setIamPolicy
  • ml.jobs.cancel
  • ml.operations.list
  • ml.operations.get
  • ml.operations.cancel
  • ml.models.create
  • ml.models.list
  • ml.models.get
  • ml.models.setIamPolicy
  • ml.models.getIamPolicy
  • ml.models.predict
  • ml.models.delete
  • ml.models.update
  • ml.versions.create
  • ml.versions.list
  • ml.versions.get
  • ml.versions.predict
  • ml.versions.delete

Ruolo sviluppatore

Nome del ruolo Description Autorizzazioni
roles/ml.developer

Accesso per creare job, modelli e versioni di addestramento e previsione e per inviare richieste di previsione online.

Nota: uno sviluppatore riceve le autorizzazioni ml.jobs.cancel e ml.jobs.update per tutti i job che crea, poiché la creazione di un job gli concede automaticamente il ruolo Proprietario job di previsione AI Platform.

Suggerimento: concedi allo sviluppatore l'accesso di sola lettura ai AI Platform Prediction Platform per finalità di risoluzione dei problemi.

  • resourcemanager.projects.get
  • ml.projects.getConfig
  • ml.jobs.create
  • ml.jobs.list
  • ml.jobs.get
  • ml.jobs.getIamPolicy
  • ml.operations.list
  • ml.operations.get
  • ml.models.create
  • ml.models.list
  • ml.models.get
  • ml.models.getIamPolicy
  • ml.models.predict
  • ml.versions.list
  • ml.versions.get
  • ml.versions.predict

Ruolo Visualizzatore

Nome del ruolo Description Autorizzazioni
roles/ml.viewer

Accesso in sola lettura alle risorse di AI Platform Prediction su un determinato progetto.

Nota: il ruolo Visualizzatore del progetto precedente concede a un utente le stesse autorizzazioni del ruolo roles/ml.viewer, più l'accesso per inviare richieste di previsione online.

  • resourcemanager.projects.get
  • ml.projects.getConfig
  • ml.jobs.list
  • ml.jobs.get
  • ml.operations.list
  • ml.operations.get
  • ml.models.list
  • ml.models.get
  • ml.versions.list
  • ml.versions.get

Ruolo Proprietario modello

Nome del ruolo Description Autorizzazioni
roles/ml.modelOwner Accesso completo al modello e alle relative versioni. Questo ruolo viene concesso automaticamente all'utente che crea il modello.
  • ml.models.get
  • ml.models.setIamPolicy
  • ml.models.getIamPolicy
  • ml.models.predict
  • ml.models.delete
  • ml.models.update
  • ml.versions.create
  • ml.versions.list
  • ml.versions.get
  • ml.versions.predict
  • ml.versions.delete

Ruolo Utente modello

Nome del ruolo Description Autorizzazioni
roles/ml.modelUser Autorizzazioni per leggere il modello e le relative versioni e per utilizzarli per la previsione.
  • ml.models.get
  • ml.models.predict
  • ml.versions.list
  • ml.versions.get
  • ml.versions.predict

Ruolo Proprietario job

Nome del ruolo Description Autorizzazioni
roles/ml.jobOwner

Accesso completo a tutte le autorizzazioni per una determinata risorsa job. Il ruolo Proprietario job viene concesso automaticamente all'utente che crea il job.

Ad esempio, un utente con il ruolo di sviluppatore AI Platform Prediction per un progetto può creare job, elencare tutti i job e ottenere tutti i job di un determinato progetto. Lo sviluppatore ha accesso per annullare solo i job che ha creato.

  • ml.jobs.get
  • ml.jobs.getIamPolicy
  • ml.jobs.cancel

Ruolo di proprietario dell'operazione

Nome del ruolo Description Autorizzazioni
roles/ml.operationOwner

Accesso completo a tutte le autorizzazioni per una determinata risorsa dell'operazione. Il ruolo di proprietario dell'operazione viene concesso all'utente automaticamente per qualsiasi operazione che l'utente crea indirettamente durante la creazione di una versione o di un modello, in modo che l'utente possa sempre ottenere e annullare le proprie operazioni.

  • ml.operations.get
  • ml.operations.cancel

Autorizzazioni necessarie per la previsione

Per praticità, questa tabella riepiloga le autorizzazioni specifiche necessarie per l'addestramento e la previsione:

Attività Autorizzazioni obbligatorie
Previsione batch
  • ml.jobs.create
  • ml.models.predict*
  • ml.versions.predict*

Nota: puoi creare un job di previsione batch senza una versione di cui è stato eseguito il deployment specificando la località di un modello salvato in Cloud Storage. Questo tipo di job di previsione batch richiede solo l'autorizzazione ml.jobs.create.

Per creare un job di previsione batch che utilizza una versione di cui è stato eseguito il deployment, hai bisogno anche di ml.models.predict o ml.versions.predict, ma non di entrambi.

Previsione online
  • ml.models.predict
  • ml.versions.predict

Autorizzazioni richieste per i metodi

Per praticità, questa sezione elenca le autorizzazioni necessarie per chiamare ciascun metodo in AI Platform Prediction:

Metodo Autorizzazioni richieste
projects.getConfig ml.projects.getConfig
projects.jobs.cancel ml.jobs.cancel
projects.jobs.create ml.jobs.create

Nota: per creare un job di previsione batch che utilizza una versione di cui è stato eseguito il deployment, avrai bisogno anche di ml.models.predict o ml.versions.predict, ma non di entrambi.

projects.jobs.get ml.jobs.get
projects.jobs.list ml.jobs.list
projects.models.create ml.models.create
projects.models.delete ml.models.delete
projects.models.get ml.models.get
projects.models.list ml.models.list
projects.models.versions.create ml.versions.create
projects.models.versions.delete ml.versions.delete
projects.models.versions.get ml.versions.get
projects.models.versions.list ml.versions.list
projects.models.versions.setDefault ml.models.update
projects.operations.cancel ml.operations.cancel
projects.operations.get ml.operations.get
projects.operations.list ml.operations.list

Autorizzazioni richieste per lo spazio di archiviazione

Quando esegui il deployment del modello addestrato su AI Platform Prediction per ottenere previsioni, carichi i file del modello salvato in Cloud Storage. All'interno del bucket Cloud Storage, i file del modello sono oggetti. Devi assicurarti che il tuo account di servizio AI Platform Prediction possa accedere ai file per il modello addestrato nel bucket Cloud Storage.

Concedi al tuo account di servizio AI Platform Prediction un ruolo IAM di Cloud Storage che includa almeno le seguenti autorizzazioni:

Autorizzazioni obbligatorie Spiegazione
storage.buckets.list Consente al tuo progetto AI Platform Prediction di trovare i file modello nel tuo bucket Cloud Storage.
storage.objects.get Consente al progetto AI Platform Prediction di leggere i file del modello nel bucket Cloud Storage.

Consulta come configurare le autorizzazioni di Cloud Storage per AI Platform Prediction.

Passaggi successivi