Configurazione dell'accesso completo

In questa pagina vengono descritti i passaggi di base necessari per configurare l'ambiente locale per sperimentare l'API Timeseries Insights utilizzando il comando curl.

Questa è una guida per configurare un progetto con il ruolo Proprietario set di dati insight serie temporali (roles/timeseriesinsights.datasetsOwner), che consente di creare ed eliminare set di dati.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
2. Installa Google Cloud CLI.

3. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

4. Crea o seleziona un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   • Crea un progetto Google Cloud:

     gcloud projects create PROJECT_ID

     Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

   • Seleziona il progetto Google Cloud che hai creato:

     gcloud config set project PROJECT_ID

     Sostituisci PROJECT_ID con il nome del tuo progetto Google Cloud.

5. Attiva l'API Timeseries Insights.

   gcloud services enable timeseriesinsights.googleapis.com

6. Configura l'autenticazione:

   1. Crea l'account di servizio:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Sostituisci SERVICE_ACCOUNT_NAME con un nome per l'account di servizio.

   2. Concedi il ruolo IAM roles/timeseriesinsights.datasetsOwner all'account di servizio:

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/timeseriesinsights.datasetsOwner

      Sostituisci quanto segue:

      • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
      • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio
      Nota: il flag --role influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.

   3. Concedi al tuo Account Google un ruolo che ti consente di creare token di accesso per l'account di servizio:

      gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com --member="user:USER_EMAIL" --role=roles/iam.serviceAccountTokenCreator

      Sostituisci quanto segue:

      • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
      • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio
      • USER_EMAIL: l'indirizzo email del tuo Account Google
7. Installa Google Cloud CLI.

8. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

9. Crea o seleziona un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   • Crea un progetto Google Cloud:

     gcloud projects create PROJECT_ID

     Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

   • Seleziona il progetto Google Cloud che hai creato:

     gcloud config set project PROJECT_ID

     Sostituisci PROJECT_ID con il nome del tuo progetto Google Cloud.

10. Attiva l'API Timeseries Insights.

    gcloud services enable timeseriesinsights.googleapis.com

11. Configura l'autenticazione:

    1. Crea l'account di servizio:

       gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

       Sostituisci SERVICE_ACCOUNT_NAME con un nome per l'account di servizio.

    2. Concedi il ruolo IAM roles/timeseriesinsights.datasetsOwner all'account di servizio:

       gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/timeseriesinsights.datasetsOwner

       Sostituisci quanto segue:

       • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
       • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio
       Nota: il flag --role influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.

    3. Concedi al tuo Account Google un ruolo che ti consente di creare token di accesso per l'account di servizio:

       gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com --member="user:USER_EMAIL" --role=roles/iam.serviceAccountTokenCreator

       Sostituisci quanto segue:

       • SERVICE_ACCOUNT_NAME: il nome dell'account di servizio.
       • PROJECT_ID: l'ID progetto in cui hai creato l'account di servizio
       • USER_EMAIL: l'indirizzo email del tuo Account Google

Testa con curl

1. Definisci un pratico alias shell per chiamare le API REST di Google:

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)" -H "Content-Type: application/json"'
   

2. Imposta una variabile di ambiente PROJECT_ID con l'identificatore del progetto:

   PROJECT_ID="my-project-id"
   

3. Elenca le API e i servizi abilitati in questo progetto:

   gcurl "https://timeseriesinsights.googleapis.com/v1/projects/${PROJECT_ID}/datasets"
   

   Se non vedi alcun errore, significa che la configurazione è stata eseguita correttamente.

Passaggi successivi

Segui il tutorial per scoprire di più sull'API.