Gestisci sottoscrizioni
In qualità di abbonato ad Analytics Hub, puoi eseguire le seguenti attività:
- Iscriviti a una scheda.
- Elenca le tue iscrizioni attuali in un determinato progetto.
- Eliminare un abbonamento.
In qualità di publisher di Analytics Hub, puoi eseguire le seguenti attività:
- Visualizza tutte le iscrizioni alla tua scheda.
- Revoca l'accesso a un abbonamento specifico.
Un abbonamento è una risorsa regionalizzata che risiede nel progetto del sottoscrittore. Gli abbonamenti memorizzano informazioni pertinenti sull'abbonato e rappresentano il contratto tra editore e abbonato.
Prima di iniziare
Per iniziare a utilizzare Analytics Hub, devi abilitare l'API Analytics Hub all'interno del tuo progetto Google Cloud.
Autorizzazioni obbligatorie
Per abilitare l'API Analytics Hub, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):
serviceUsage.services.get
serviceUsage.services.list
serviceUsage.services.enable
Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per abilitare l'API Analytics Hub:
roles/serviceusage.serviceUsageAdmin
Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Autorizzazioni e ruoli predefiniti.
Abilita l'API Analytics Hub
Per abilitare l'API Analytics Hub:
Console
Vai all'API Analytics Hub per il tuo progetto Google Cloud e abilitala.
gcloud
Esegui il comando gcloud services allow:
gcloud services enable analyticshub.googleapis.com
Autorizzazioni obbligatorie
Per gestire gli abbonamenti, devi disporre di uno dei seguenti ruoli di Analytics Hub:
- Ruolo Proprietario abbonamenti Analytics Hub
(
roles/analyticshub.subscriptionOwner
), che ti consente di gestire gli abbonamenti che crei.
Per saperne di più, consulta Ruoli utente di Analytics Hub.
Flusso di lavoro degli abbonati
Gli abbonati possono eseguire le seguenti azioni con le sottoscrizioni.
Iscriviti alle schede
Per iscriverti alle schede, segui i passaggi descritti in Iscriversi alle schede.
Elenco sottoscrizioni
Per elencare tutti gli abbonamenti:
API
Per visualizzare gli abbonamenti attuali in un determinato progetto, utilizza il metodo projects.locations.subscriptions.list
.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto che contiene le sottoscrizioni da elencare.LOCATION
: la località per la quale vuoi indicare gli abbonamenti esistenti.
Flusso di lavoro del publisher
Gli editori possono eseguire le seguenti azioni con gli abbonamenti. Per scoprire di più sulla gestione degli abbonamenti alle schede, consulta Gestire le schede.
Elenco sottoscrizioni
Per elencare tutti gli abbonamenti:
Console
Nella console Google Cloud, vai alla pagina Analytics Hub.
Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.
Fai clic sul nome dello scambio di dati in cui vuoi elencare le sottoscrizioni.
Fai clic sulla scheda Abbonamenti per visualizzare tutte le sottoscrizioni alle schede all'interno del Data Exchange.
API
Per elencare le sottoscrizioni alle schede in una determinata piattaforma Data Exchange, utilizza il metodo projects.locations.dataExchanges.listSubscriptions
.
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto di Data Exchange di cui vuoi elencare le sottoscrizioni da rimuovere.LOCATION
: la località di Data Exchange.DATAEXCHANGE_ID
: l'ID di Data Exchange per cui vuoi elencare gli abbonamenti.
Rimuovere una sottoscrizione
Console
Nella console Google Cloud, vai alla pagina Analytics Hub.
Viene visualizzata una pagina che elenca tutti gli scambi di dati a cui puoi accedere.
Fai clic sul nome dello scambio di dati in cui vuoi creare la scheda.
Fai clic sulla scheda Abbonamenti per visualizzare tutti gli abbonamenti allo scambio di dati.
Seleziona la casella di controllo accanto agli abbonamenti che vuoi rimuovere oppure seleziona tutti gli abbonamenti.
Fai clic su Rimuovi abbonamenti.
API
Per rimuovere un abbonamento, utilizza il metodo projects.locations.subscriptions.revoke
.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto della sottoscrizione che vuoi rimuovere.LOCATION
: la località dell'abbonamento.SUBSCRIPTION_ID
: l'ID dell'abbonamento che vuoi rimuovere.
Limitazioni
Gli abbonamenti sono soggetti alle seguenti limitazioni:
- Non viene eseguito il backfill dei set di dati collegati creati prima del 25 luglio 2023. Solo gli abbonamenti creati dopo il 25 luglio 2023 funzionano con i metodi API.
Passaggi successivi
- Consulta l'architettura di Analytics Hub
- Scopri come visualizzare e iscriversi alle schede.
- Scopri di più sui ruoli utente di Analytics Hub.
- Scopri di più sulla creazione di set di dati.
- Scopri di più sull'audit logging di Analytics Hub.