Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare i set di dati di Storage Insights

Questa pagina mostra come creare e gestire i set di dati e le configurazioni dei set di dati di Storage Insights. Scopri di più sui set di dati di Storage Insights.

Prima di iniziare

Prima di iniziare a creare e gestire set di dati e configurazioni dei set di dati, segui le istruzioni riportate nelle sottosezioni successive.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per creare e gestire i set di dati, chiedi all'amministratore di concederti i seguenti ruoli IAM nei progetti di origine:

Per creare, gestire e visualizzare le configurazioni dei set di dati: Storage Insights Admin (roles/storageinsights.admin)
Per visualizzare, collegare e scollegare i set di dati:
- Storage Insights Analyst (roles/storageinsights.analyst)
- BigQuery Admin (roles/bigquery.admin)
Per eliminare i set di dati collegati: Amministratore BigQuery (roles/bigquery.admin)
Per visualizzare ed eseguire query sui set di dati in BigQuery:
- Storage Insights Viewer (roles/storageinsights.viewer)
- Utente job BigQuery (roles/bigquery.jobUser)
- Visualizzatore dati BigQuery (roles/bigquery.dataViewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e gestire set di dati. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare e gestire set di dati sono necessarie le seguenti autorizzazioni:

Crea la configurazione del set di dati: storageinsights.datasetConfigs.create
Visualizza la configurazione del set di dati:
- storageinsights.datasetConfigs.get
- storageinsights.datasetConfigs.list
Gestisci la configurazione del set di dati:
- storageinsights.datasetConfigs.update
- storageinsights.datasetConfigs.delete
Link al set di dati BigQuery: storageinsights.datasetConfigs.linkDataset
Scollega dal set di dati BigQuery: storageinsights.datasetConfigs.unlinkDataset
Esegui query sui set di dati collegati a BigQuery: bigquery.jobs.create or bigquery.jobs.*

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Abilita l'API Storage Insights

Console

Abilita l'API storageinsights.googleapis.com

Riga di comando

Per abilitare l'API Storage Insights nel tuo progetto attuale, esegui questo comando:

gcloud services enable storageinsights.googleapis.com

Per maggiori dettagli sull'attivazione dei servizi per un progetto Google Cloud , vedi Attivare e disattivare i servizi.

Configura Storage Intelligence

Assicurati che Storage Intelligence sia configurato nel progetto, nella cartella o nell'organizzazione che vuoi analizzare con i set di dati.

Crea una configurazione del set di dati

Per creare una configurazione del set di dati e generare un set di dati, segui questi passaggi. Per ulteriori informazioni sui campi che puoi specificare durante la creazione della configurazione del set di dati, consulta Proprietà di configurazione del set di dati.

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic su Configura set di dati.
Nella sezione Dai un nome al set di dati, inserisci un nome per il set di dati. (Facoltativo) Inserisci una descrizione per il set di dati.
Nella sezione Definisci ambito del set di dati, segui questi passaggi:
- Seleziona una delle seguenti opzioni:
  - Per ottenere i metadati di archiviazione per tutti i progetti dell'organizzazione corrente, seleziona Includi l'organizzazione.
  - Per ottenere i metadati di archiviazione per tutti i progetti nelle cartelle selezionate, seleziona Includi cartelle(organizzazione secondaria/reparti). Per informazioni su come ottenere gli ID cartella, consulta Visualizzazione o elenco di cartelle e progetti. Per aggiungere cartelle:
    1. Nel campo Cartella 1, inserisci l'ID cartella.
    2. (Facoltativo) Per aggiungere più ID cartella, fai clic su + Aggiungi un'altra cartella.
  - Per ottenere i metadati di archiviazione per i progetti selezionati, seleziona Includi progetti specificando i numeri di progetto. Per scoprire come trovare i numeri di progetto, consulta Trovare nome, numero e ID del progetto. Per aggiungere progetti:
    1. Nel campo Progetto 1, inserisci il numero di progetto.
    2. (Facoltativo) Per aggiungere più numeri di progetto, fai clic su + Aggiungi un altro progetto.
  - Per aggiungere progetti o cartelle collettivamente, seleziona Carica un elenco di progetti /cartelle tramite un file CSV. Il file CSV deve contenere i numeri di progetto o gli ID cartella che vuoi includere nel set di dati.
- Specifica se vuoi includere automaticamente i bucket futuri nella risorsa selezionata.
- (Facoltativo) Per specificare i filtri sui bucket in base alle regioni e ai prefissi dei bucket, espandi la sezione Filtri (facoltativo). I filtri vengono applicati in modo additivo ai bucket.
  
  Puoi includere o escludere i bucket da regioni specifiche. Ad esempio, puoi escludere i bucket che si trovano nelle regioni me-central1 e me-central2. Puoi anche includere o escludere i bucket in base al prefisso. Ad esempio, se vuoi escludere i bucket che iniziano con my-bucket, inserisci il prefisso my-bucket*.
Fai clic su Continua.
Nella sezione Seleziona periodo di conservazione, seleziona un periodo di conservazione per i dati nel set di dati.
Nella sezione Seleziona la località in cui archiviare il set di dati configurato, seleziona una località in cui archiviare il set di dati e la relativa configurazione.
Nella sezione Seleziona account di servizio account, seleziona un tipo di service agent per il tuo set di dati. Questo service agent viene creato per tuo conto quando crei la configurazione del set di dati. Puoi selezionare uno dei seguenti agenti di servizio:
- Service account con ambito a livello di configurazione: questo agente di servizio può solo accedere e scrivere nel set di dati generato dalla particolare configurazione del set di dati.
- Account di servizio con ambito progetto: questo service agent può accedere e scrivere set di dati generati da tutte le configurazioni dei set di dati nel progetto.
Una volta creato l'agente di servizio, devi concedergli le autorizzazioni richieste. Per ulteriori informazioni su questi service agent, consulta le proprietà di configurazione del set di dati.
Fai clic su Configura. Potrebbero essere necessarie fino a 48 ore prima di poter visualizzare il primo caricamento dei dati nei set di dati collegati dopo aver configurato il set di dati.

Riga di comando

Per creare una configurazione del set di dati, esegui il comando gcloud storage insights dataset-configs create con i flag richiesti:
```
gcloud storage insights dataset-configs create DATASET_CONFG_ID \
  --source-projects=SOURCE_PROJECT_NUMBERS \
  --location=LOCATION \
  --retention-period-days=RETENTION_PERIOD_DAYS \
  --organization=ORGANIZATION_ID
```
Sostituisci:
- DATASET_CONFIG_ID con il nome che vuoi assegnare alla configurazione del set di dati. I nomi vengono utilizzati come identificatore delle configurazioni dei set di dati e sono modificabili. Il nome può contenere fino a 128 caratteri tra cui lettere, numeri e trattini bassi.
- SOURCE_PROJECT_NUMBERS con i numeri dei progetti da includere nel set di dati. Ad esempio: 464036093014. Puoi specificare uno o più progetti. Per scoprire come trovare il numero del progetto, consulta Trovare il nome, il numero e l'ID del progetto.
  
  In alternativa all'utilizzo del flag --source-projects, puoi utilizzare il flag --source-projects-file=FILE_PATH, che ti consente di specificare più numeri di progetto contemporaneamente caricando un file contenente i numeri di progetto. Il file deve essere in formato CSV e caricato in Cloud Storage.
- LOCATION con la posizione in cui verranno archiviati la configurazione e il set di dati.
- RETENTION_PERIOD_DAYS con il periodo di conservazione per i dati nel set di dati.
- ORGANIZATION_ID con l'ID risorsa dell'organizzazione a cui appartengono i progetti di origine. I progetti di origine al di fuori della posizione specificata vengono esclusi dalla configurazione del set di dati. Per scoprire come trovare l'ID della tua organizzazione, vedi Ottenere l'ID risorsa dell'organizzazione.
Se vuoi, puoi utilizzare flag aggiuntivi per configurare con precisione il set di dati:
- Utilizza --include-buckets=BUCKET_NAMES_OR_REGEX per includere bucket specifici in base al nome o all'espressione regolare. Se viene utilizzato questo flag, non è possibile utilizzare --exclude-buckets.
- Utilizza --exclude-buckets=BUCKET_NAMES_OR_REGEX per escludere bucket specifici in base al nome o all'espressione regolare. Se viene utilizzato questo flag, non è possibile utilizzare --include-buckets.
- Utilizza --project=DESTINATION_PROJECT_ID per specificare un progetto da utilizzare per archiviare la configurazione del set di dati e il set di dati generato. Se questo flag non viene utilizzato, il progetto di destinazione sarà il tuo progetto attivo. Per saperne di più sugli ID progetto, consulta la pagina Creare e gestire progetti.
- Utilizza --auto-add-new-buckets per includere automaticamente tutti i bucket che verranno aggiunti ai progetti di origine in futuro.
- Utilizza --skip-verification per ignorare i controlli e gli errori della procedura di verifica, che include i controlli delle autorizzazioni IAM richieste. Se utilizzati, alcuni o tutti i bucket potrebbero essere esclusi dal set di dati.
- Utilizza --identity=IDENTITY_TYPE per specificare il tipo di service agent creato insieme alla configurazione del set di dati. I valori sono IDENTITY_TYPE_PER_CONFIG o IDENTITY_TYPE_PER_PROJECT. Se non specificato, il valore predefinito è IDENTITY_TYPE_PER_CONFIG.
- Utilizza --description=DESCRIPTION per scrivere una descrizione della configurazione del set di dati.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le seguenti informazioni:
```
{
  "organizationNumber": "ORGANIZATION_ID",
  "sourceProjects": {
    "project_numbers": ["PROJECT_NUMBERS", ...]
  },
  "retentionPeriodDays": "RETENTION_PERIOD_DAYS",
  "identity": {
    "type": "IDENTITY_TYPE"
  }
}
```
Sostituisci:
- ORGANIZATION_ID con l'ID risorsa dell' organizzazione a cui appartengono i progetti di origine. Per scoprire come trovare l'ID organizzazione, vedi Ottenere l'ID risorsa dell'organizzazione.
- PROJECT_NUMBERS con i numeri dei progetti da includere nel set di dati. Puoi specificare uno o più progetti. I progetti devono essere specificati come un elenco di stringhe.
  
  In alternativa, puoi aggiungere un'organizzazione o una o più cartelle contenenti bucket e oggetti per i quali vuoi aggiornare i metadati. Per includere cartelle o organizzazioni, utilizza rispettivamente i campi sourceFolders o organizationScope. Per ulteriori informazioni, consulta il riferimento DatasetConfig.
- RETENTION_PERIOD_DAYS con il numero di giorni di dati da acquisire nello snapshot del set di dati. Ad esempio, 90.
- IDENTITY_TYPE con il tipo di service account che viene creato insieme alla configurazione del set di dati. I valori sono IDENTITY_TYPE_PER_CONFIG o IDENTITY_TYPE_PER_PROJECT.
Per creare la configurazione del set di dati, utilizza cURL per chiamare l'API JSON con una richiesta Create DatasetConfig:
```
curl -X POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs?datasetConfigId=DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json"
```
Sostituisci:
- JSON_FILE_NAME con il percorso del file JSON che hai creato nel passaggio precedente. In alternativa, puoi passare un'istanza di DatasetConfig nel corpo della richiesta.
- PROJECT_ID con l'ID del progetto a cui apparterranno la configurazione e il set di dati.
- LOCATION con la posizione in cui risiederanno il set di dati e la relativa configurazione. Ad esempio us-central1.
- DATASET_CONFIG_ID con il nome che vuoi assegnare alla configurazione del set di dati. I nomi vengono utilizzati come identificatore delle configurazioni dei set di dati e non sono immutabili. Il nome può contenere fino a 128 caratteri tra cui lettere, numeri e trattini bassi. Il nome deve iniziare con una lettera.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Per risolvere i problemi di elaborazione degli snapshot registrati in error_attributes_view, consulta Errori del set di dati Storage Insights.

Concedi le autorizzazioni richieste all'agente di servizio

Google Cloud crea un agente di servizio con ambito a livello di configurazione o progetto per tuo conto quando crei una configurazione del set di dati. L'agente di servizio segue il formato di denominazione service-PROJECT_NUMBER@gcp-sa-storageinsights.iam.gserviceaccount.com e viene visualizzato nella pagina IAM della Google Cloud console quando selezioni la casella di controllo Includi concessioni di ruoli fornite da Google. Puoi anche trovare il nome dell'agente di servizio visualizzando la risorsa DatasetConfig utilizzando l'API JSON.

Per consentire a Storage Insights di generare e scrivere set di dati, chiedi all'amministratore di concedere all'agente di servizio il ruolo Storage Insights Collector Service (roles/storage.insightsCollectorService) nell'organizzazione che contiene i progetti di origine. Questo ruolo deve essere concesso a ogni agente di servizio con ambito di configurazione creato per ogni configurazione del set di dati da cui vuoi estrarre i dati. Se utilizzi un agente di servizio con ambito progetto, questo ruolo deve essere concesso una sola volta affinché l'agente di servizio possa leggere e scrivere set di dati per tutte le configurazioni dei set di dati all'interno del progetto.

Per istruzioni sulla concessione dei ruoli nei progetti, consulta Gestire l'accesso.

Collegare un set di dati

Per collegare un set di dati a BigQuery:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic sul nome della configurazione del set di dati che ha generato il set di dati che vuoi collegare.
Nella sezione Set di dati collegato a BigQuery, fai clic su Collega set di dati per collegare il tuo set di dati.

Riga di comando

Per collegare un set di dati a BigQuery, esegui il comando gcloud storage insights dataset-configs create-link:
```
gcloud storage insights dataset-configs create-link DATASET_CONFIG_ID --location=LOCATION
```
Sostituisci:
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi collegare.
- LOCATION con la posizione del tuo set di dati. Ad esempio: us-central1.
In alternativa alla specifica di DATASET_CONFIG_NAME e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:
```
gcloud storage insights dataset-configs create-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID_
```
Sostituisci:
- DESTINATION_PROJECT_ID con l'ID del progetto che contiene la configurazione del set di dati. Per saperne di più sugli ID progetto, consulta la pagina Creare e gestire progetti.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi collegare.
- LOCATION con la posizione del tuo set di dati e la configurazione del set di dati. Ad esempio: us-central1.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le seguenti informazioni:

{
  "name": "DATASET_NAME"
}

Sostituisci:

DATASET_NAME con il nome del set di dati da collegare. Ad esempio, my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2.

Utilizza cURL per chiamare l'API JSON con una richiesta linkDataset DatasetConfig:
```
curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:linkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- JSON_FILE_NAME con il percorso del file JSON che hai creato nel passaggio precedente.
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione in cui risiedono il set di dati e la configurazione del set di dati. Ad esempio us-central1.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi collegare.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Visualizzare ed eseguire query sui set di dati collegati

Per visualizzare ed eseguire query sui set di dati collegati:

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights

Viene visualizzato un elenco delle configurazioni del set di dati create nel tuo progetto.
Fai clic sul set di dati collegato a BigQuery della configurazione del set di dati che vuoi visualizzare.

Il set di dati collegato a BigQuery viene visualizzato nella console Google Cloud . Per informazioni sullo schema del set di dati dei metadati, consulta Schema del set di dati dei metadati.
Puoi eseguire query su tabelle e viste nei set di dati collegati nello stesso modo in cui esegui query su qualsiasi altra tabella BigQuery.

Scollegare un set di dati

Per impedire la pubblicazione della configurazione del set di dati nel set di dati BigQuery, scollega il set di dati. Per scollegare un set di dati, completa i seguenti passaggi:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic sul nome della configurazione del set di dati che ha generato il set di dati che vuoi scollegare.
Nella sezione Set di dati collegato a BigQuery, fai clic su Scollega set di dati per scollegare il set di dati.

Riga di comando

Per scollegare il set di dati, esegui il comando gcloud storage insights dataset-configs delete-link:
```
gcloud storage insights dataset-configs delete-link DATASET_CONFIG_ID --location=LOCATION
```
Sostituisci:
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi scollegare.
- LOCATION con la posizione del tuo set di dati e la configurazione del set di dati. Ad esempio: us-central1.
In alternativa alla specifica di DATASET_CONFIG_NAME e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:
```
gcloud storage insights dataset-configs delete-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```
Sostituisci:
- DESTINATION_PROJECT_ID con l'ID del progetto che contiene la configurazione del set di dati. Per saperne di più sugli ID progetto, consulta la pagina Creare e gestire progetti.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi scollegare.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le seguenti informazioni:

{
  "name": "DATASET_NAME"
}

Sostituisci:

DATASET_NAME con il nome del set di dati che vuoi scollegare. Ad esempio, my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2.

Utilizza cURL per chiamare l'API JSON con una richiesta unlinkDataset DatasetConfig:
```
curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:unlinkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- JSON_FILE_NAME con il percorso del file JSON che hai creato nel passaggio precedente.
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi scollegare.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Visualizzare una configurazione del set di dati

Per visualizzare la configurazione di un set di dati, completa i seguenti passaggi:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic sul nome della configurazione del set di dati che vuoi visualizzare.

Vengono visualizzati i dettagli di configurazione del set di dati.

Riga di comando

Per descrivere una configurazione del set di dati, esegui il comando gcloud storage insights dataset-configs describe:
```
gcloud storage insights dataset-configs describe DATASET_CONFG_ID \
  --location=LOCATION
```
Sostituisci:
- DATASET_CONFIG_ID con il nome della configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati.
In alternativa alla specifica di DATASET_CONFIG_NAME e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:
```
gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```
Sostituisci:
- DESTINATION_PROJECT_ID con l'ID del progetto che contiene la configurazione del set di dati. Per saperne di più sugli ID progetto, consulta la pagina Creare e gestire progetti.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che ha generato il set di dati che vuoi visualizzare.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'API JSON con una richiesta Get DatasetConfig:
```
curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Elenca le configurazioni del set di dati

Per elencare le configurazioni del set di dati in un progetto, completa i seguenti passaggi:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights

Viene visualizzato l'elenco delle configurazioni del set di dati.

Riga di comando

Per elencare le configurazioni del set di dati in un progetto, esegui il comando gcloud storage insights dataset-configs list:
```
gcloud storage insights dataset-configs list --location=LOCATION
```
Sostituisci:
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
Puoi utilizzare i seguenti flag facoltativi per specificare il comportamento della chiamata di elenco:
- Utilizza --page-size per specificare il numero massimo di risultati da restituire per pagina.
- Utilizza --filter=FILTER per filtrare i risultati. Per maggiori informazioni su come utilizzare il flag --filter, esegui gcloud topic filters e consulta la documentazione.
- Utilizza --sort-by=SORT_BY_VALUE per specificare un elenco separato da virgole di nomi di chiavi di campi delle risorse in base ai quali ordinare. Ad esempio, --sort-by=DATASET_CONFIG_NAME.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'API JSON con una richiesta Get DatasetConfig:
```
curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Aggiornare una configurazione del set di dati

Per aggiornare la configurazione di un set di dati:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic sul nome della configurazione del set di dati da aggiornare.
Nella scheda Configurazione del set di dati visualizzata, fai clic su Modifica per aggiornare i campi.

Riga di comando

Per aggiornare una configurazione del set di dati, esegui il comando gcloud storage insights dataset-configs update:
```
gcloud storage insights dataset-configs update DATASET_CONFG_ID \
  --location=LOCATION
```
Sostituisci:
- DATASET_CONFIG_ID con il nome della configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati.
Utilizza i seguenti flag per aggiornare le proprietà della configurazione del set di dati:
- Utilizza --skip-verification per ignorare i controlli e gli errori della procedura di verifica, che include i controlli delle autorizzazioni IAM richieste. Se utilizzati, alcuni o tutti i bucket potrebbero essere esclusi dal set di dati.
- Utilizza --retention-period-days=DAYS per specificare il numero mobile di giorni di dati da acquisire nello snapshot del set di dati. Ad esempio, 90.
- Utilizza --description=DESCRIPTION per scrivere una descrizione della configurazione del set di dati.

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Crea un file JSON contenente le seguenti informazioni facoltative:
```
{
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": "PROJECT_NUMBERS"
  },
  "retention_period_days": RETENTION_PERIOD"
}
```
Sostituisci:
- ORGANIZATION_ID con l'ID risorsa dell' organizzazione a cui appartengono i progetti di origine.
- PROJECT_NUMBERS con i numeri di progetto che vuoi includere nel set di dati. Puoi specificare uno o più progetti. I progetti devono essere specificati in un formato di elenco.
- RETENTION_PERIOD con il numero mobile di giorni di dati da acquisire nello snapshot del set di dati. Ad esempio, 90.
Per aggiornare la configurazione del set di dati, utilizza cURL per chiamare l'API JSON con una richiesta Patch DatasetConfig:
```
curl -X PATCH --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID?updateMask=RETENTION_PERIOD" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- JSON_FILE_NAME con il percorso del file JSON che hai creato nel passaggio precedente.
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che vuoi aggiornare.
- RETENTION_PERIOD con il numero mobile di giorni di dati da acquisire nello snapshot del set di dati. Ad esempio, 90.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Eliminare una configurazione del set di dati

Per eliminare una configurazione del set di dati:

Console

Nella console Google Cloud , vai alla pagina Storage Insights di Cloud Storage.

Vai a Storage Insights
Fai clic sul nome della configurazione del set di dati che vuoi eliminare.
Fai clic su Elimina .

Riga di comando

Per eliminare una configurazione del set di dati, esegui il comando gcloud storage insights dataset-configs delete:
```
gcloud storage insights dataset-configs delete DATASET_CONFG_ID \
  --location=LOCATION
```
Sostituisci:
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che vuoi eliminare.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
Utilizza i seguenti flag per aggiornare le proprietà della configurazione del set di dati:
- Utilizza --auto-delete-link per scollegare il set di dati generato dalla configurazione del set di dati che vuoi eliminare. Devi scollegare un set di dati prima di poter eliminare la configurazione del set di dati che lo ha generato.
- Utilizza --retention-period-days=DAYS per specificare il numero di giorni di dati da acquisire nello snapshot del set di dati. Ad esempio, 90.
In alternativa alla specifica di DATASET_CONFIG_NAME e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:
```
gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```

API REST

API JSON

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'API JSON con una richiesta Delete DatasetConfig:
```
curl -X DELETE \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Sostituisci:
- PROJECT_ID con l'ID del progetto a cui appartiene la configurazione del set di dati.
- LOCATION con la posizione del set di dati e la configurazione del set di dati. Ad esempio: us-central1.
- DATASET_CONFIG_ID con il nome della configurazione del set di dati che vuoi eliminare.
- ACCESS_TOKEN con il token di accesso che hai generato quando hai installato e inizializzato Google Cloud CLI.

Utilizzare i set di dati di Storage Insights Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Ottenere i ruoli richiesti

Autorizzazioni obbligatorie

Abilita l'API Storage Insights

Console

Riga di comando

Configura Storage Intelligence

Crea una configurazione del set di dati

Console

Riga di comando

API REST

API JSON

Concedi le autorizzazioni richieste all'agente di servizio

Collegare un set di dati

Console

Riga di comando

API REST

API JSON

Visualizzare ed eseguire query sui set di dati collegati

Scollegare un set di dati

Console

Riga di comando

API REST

API JSON

Visualizzare una configurazione del set di dati

Console

Riga di comando

API REST

API JSON

Elenca le configurazioni del set di dati

Console

Riga di comando

API REST

API JSON

Aggiornare una configurazione del set di dati

Console

Riga di comando

API REST

API JSON

Eliminare una configurazione del set di dati

Console

Riga di comando

API REST

API JSON

Passaggi successivi

Utilizzare i set di dati di Storage Insights