Utilizzare i set di dati di Storage Insights

Questa pagina mostra come creare e gestire i set di dati Storage Insights e le configurazioni dei set di dati. 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 ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e gestire i 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 Attivazione e disattivazione dei 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

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

    Vai a Storage Insights

  2. Fai clic su Configura set di dati.

  3. 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.

  4. 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 dei progetti, consulta Trovare il nome, il numero e l'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*.

  5. Fai clic su Continua.

  6. Nella sezione Seleziona periodo di conservazione, seleziona un periodo di conservazione per i dati nel set di dati.

  7. 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.

  8. 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ò accedere e scrivere solo nel set di dati generato dalla particolare configurazione del set di dati.
    • Account di servizio con ambito progetto: questo agente di servizio può accedere e scrivere set di dati generati da tutte le configurazioni dei set di dati nel progetto.

    Una volta creato il service agent, devi concedergli le autorizzazioni richieste. Per ulteriori informazioni su questi service agent, consulta le proprietà di configurazione del set di dati.

  9. Fai clic su Configura. Potrebbero essere necessarie fino a 48 ore prima che tu possa visualizzare il primo caricamento dei dati nei set di dati collegati dopo aver configurato il set di dati.

Riga di comando

  1. Per creare una configurazione del set di dati, esegui il comando gcloud alpha storage insights dataset-configs create con i flag richiesti:

    gcloud alpha storage insights dataset-configs create DATASET_CONFIG_ID \
  --location=LOCATION \
  --organization=SOURCE_ORG_NUMBER \
  --retention-period-days=RETENTION_PERIOD_DAYS \
  (SCOPE_FLAG)

    Dove:

    • DATASET_CONFIG_ID è il nome che vuoi assegnare alla configurazione del set di dati. I nomi vengono utilizzati come identificatore delle configurazioni del set di dati e sono modificabili. Il nome può contenere fino a 128 caratteri tra cui lettere, numeri e trattini bassi.

    • LOCATION è la posizione in cui verranno archiviati la configurazione e il set di dati.

    • SOURCE_ORG_NUMBER è l'ID dell'organizzazione a cui appartengono i progetti di origine. Per scoprire come trovare l'ID organizzazione, vedi Ottenere l'ID risorsa dell'organizzazione.

    • RETENTION_PERIOD_DAYS è il periodo di conservazione per i dati nel set di dati.

    • SCOPE_FLAG è uno dei seguenti flag che definiscono l'ambito dei dati da raccogliere:

      • --enable-organization-scope: consente al set di dati di raccogliere insight da tutti i bucket dell'intera organizzazione.
      • --source-folders=[SOURCE_FOLDER_NUMBERS,...]: Specifica un elenco di numeri di cartella da includere nel set di dati. Per scoprire come trovare un numero di cartella, consulta Elenco di tutti i progetti e le cartelle nella gerarchia.
      • --source-folders-file=FILE_PATH: Specifica più numeri di cartella caricando un file CSV in un bucket.
      • --source-projects=[SOURCE_PROJECT_NUMBERS,...]: Specifica un elenco di numeri di progetto da includere nel set di dati. Ad esempio, 464036093014. Per scoprire come trovare il numero del progetto, consulta Trovare il nome, il numero e l'ID del progetto.
      • --source-projects-file=FILE_PATH: Specifica più numeri di progetto caricando un file CSV in un bucket.

    (Facoltativo) Puoi utilizzare flag aggiuntivi per configurare 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.

    • Utilizza --organization=ORGANIZATION_ID con l'ID risorsa dell'organizzazione a cui appartengono i progetti di origine. La configurazione del set di dati esclude i progetti di origine al di fuori della località specificata. Per scoprire come trovare l'ID organizzazione, vedi Recuperare l'ID risorsa dell'organizzazione. Se non specificato, il valore predefinito è l'ID organizzazione del progetto di origine.

    Il seguente esempio crea una configurazione del set di dati denominata my-dataset nella regione us-central1, per l'organizzazione con ID 123456789, con un periodo di conservazione di 30 giorni e un ambito limitato ai progetti 987654321 e 123123123:

    gcloud alpha storage insights dataset-configs create my-dataset \
  --location=us-central1 \
  --organization=123456789 \
  --retention-period-days=30 \
  --source-projects=987654321,123123123

API REST

API JSON

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

  2. Crea un file JSON contenente le seguenti informazioni:

    {
  "sourceProjects": {
    "project_numbers": ["PROJECT_NUMBERS", ...]
  },
  "retentionPeriodDays": "RETENTION_PERIOD_DAYS",
  "identity": {
    "type": "IDENTITY_TYPE"
  }
}

    Sostituisci:

    • PROJECT_NUMBERS con i numeri dei progetti che vuoi includere nel set di dati. Puoi specificare uno o più progetti. I progetti devono essere specificati come 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 il campo 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.

  3. 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 trasmettere 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 Risolvere i problemi relativi ai set di dati.

Concedi le autorizzazioni richieste al service agent

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 console Google Cloud 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.

Per collegare un set di dati a BigQuery:

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

    Vai a Storage Insights

  2. Fai clic sul nome della configurazione del set di dati che ha generato il set di dati che vuoi collegare.

  3. Nella sezione Set di dati collegato a BigQuery, fai clic su Collega set di dati per collegare il tuo set di dati.

  1. Per collegare un set di dati a BigQuery, esegui il comando gcloud alpha storage insights dataset-configs create-link:

    gcloud alpha 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_ID e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:

    gcloud alpha 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, vedi Creazione e gestione dei 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.

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

  2. 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.

  3. 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 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:

  1. 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 progetto.

  2. 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.

  3. Puoi eseguire query su tabelle e viste nei set di dati collegati nello stesso modo in cui esegui query su qualsiasi altra tabella BigQuery.

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:

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

    Vai a Storage Insights

  2. Fai clic sul nome della configurazione del set di dati che ha generato il set di dati che vuoi scollegare.

  3. Nella sezione Set di dati collegato a BigQuery, fai clic su Scollega set di dati per scollegare il set di dati.

  1. Per scollegare il set di dati, esegui il comando gcloud alpha storage insights dataset-configs delete-link:

    gcloud alpha 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_ID e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:

    gcloud alpha 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, vedi Creazione e gestione dei 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.

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

  2. 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.

  3. 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 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

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

    Vai a Storage Insights

  2. 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

  1. Per descrivere una configurazione del set di dati, esegui il comando gcloud alpha storage insights dataset-configs describe:

    gcloud alpha storage insights dataset-configs describe DATASET_CONFIG_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_ID e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:

    gcloud alpha 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, vedi Creazione e gestione dei 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

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

  2. 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

  1. 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

  1. Per elencare le configurazioni del set di dati in un progetto, esegui il comando gcloud alpha storage insights dataset-configs list:

    gcloud alpha 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 dei nomi delle chiavi dei campi delle risorse in base ai quali ordinare. Ad esempio, --sort-by=DATASET_CONFIG_ID.

API REST

API JSON

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

  2. 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

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

    Vai a Storage Insights

  2. Fai clic sul nome della configurazione del set di dati da aggiornare.

  3. Nella scheda Configurazione del set di dati visualizzata, fai clic su Modifica per aggiornare i campi.

Riga di comando

  1. Per aggiornare la configurazione di un set di dati, esegui il comando gcloud alpha storage insights dataset-configs update:

    gcloud alpha 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.

    • Utilizza --organization=ORGANIZATION_ID per specificare l'ID organizzazione del progetto di origine. Se non specificato, il valore predefinito è l'ID organizzazione del progetto di origine.

API REST

API JSON

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

  2. 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. Se non specificato, il valore predefinito è l'ID organizzazione del progetto 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.

  3. 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

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

    Vai a Storage Insights

  2. Fai clic sul nome della configurazione del set di dati che vuoi eliminare.

  3. Fai clic su Elimina .

Riga di comando

  1. Per eliminare una configurazione del set di dati, esegui il comando gcloud alpha storage insights dataset-configs delete:

    gcloud alpha storage insights dataset-configs delete DATASET_CONFIG_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_ID e LOCATION, puoi specificare un percorso di configurazione completo del set di dati. Ad esempio:

    gcloud alpha storage insights dataset-configs delete projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

API REST

API JSON

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

  2. 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.

Passaggi successivi