Motore per suggerimenti generali relativi al ritiro di Cloud e alle modifiche che causano interruzioni

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Il motore per suggerimenti generali relativi al ritiro di Cloud e alle modifiche che causano interruzioni fornisce suggerimenti sui ritiri di Cloud e sulle modifiche che causano interruzioni. Identifica le risorse Cloud che saranno interessate dai prossimi ritiri e dalle modifiche che causano interruzioni, fornendo al contempo linee guida su come gestirle. I suggerimenti sono visualizzabili tramite Google Cloud CLI, l'API e l'esportazione in BigQuery.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non hai mai utilizzato Google Cloud, crea un account per valutare il rendimento dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Recommender API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Recommender API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Nota: devi abilitare l'API su un singolo progetto di fatturazione. Puoi quindi utilizzare lo stesso progetto di fatturazione per recuperare suggerimenti e insight per altri progetti, l'intera organizzazione o l'account di fatturazione, utilizzando il --billing-project flag.

4. Assicurati di disporre dei seguenti ruoli:

Descrizione	Ruoli
Visualizza i suggerimenti	recommender.cloudDeprecationRecommendationViewer
Visualizza e aggiorna i suggerimenti	recommender.cloudDeprecationRecommendationAdmin

Ruoli obbligatori

Questa sezione descrive i ruoli e le autorizzazioni necessarie per utilizzare il motore per suggerimenti generali relativi al ritiro di Cloud e alle modifiche che causano interruzioni.

Ruolo	Autorizzazioni incluse
roles/recommender.cloudDeprecationRecommendationViewer	recommender.cloudDeprecationGeneralInsights.get recommender.cloudDeprecationGeneralInsights.list recommender.cloudDeprecationGeneralRecommendations.get recommender.cloudDeprecationGeneralRecommendations.list
roles/recommender.cloudDeprecationRecommendationAdmin	recommender.cloudDeprecationGeneralInsights.update recommender.cloudDeprecationGeneralRecommendations.update

Per ulteriori informazioni sui ruoli e sulla concessione dell'accesso, consulta le seguenti risorse:

• Informazioni sui ruoli
• Gestione dell'accesso a progetti, cartelle e organizzazioni

Prezzi

Il motore per suggerimenti generali relativi al ritiro di Cloud e alle modifiche che causano interruzioni è offerto senza costi. Per informazioni sugli altri livelli di prezzo, consulta la pagina Prezzi del motore per suggerimenti.

Visualizzare i suggerimenti relativi al ritiro di Cloud

Puoi elencare i suggerimenti utilizzando la console, Google Cloud CLI, l'API Recommender o tramite l'esportazione in BigQuery.

Console

1. Vai ad Active Assist.

   Vai ad Active Assist

2. Imposta il campo Filtro su Recommender:google.cloud.deprecation.GeneralRecommender.

   Nota: devi disporre delle autorizzazioni IAM corrette (elencate sopra) per visualizzare i suggerimenti. Se disponi delle autorizzazioni corrette e la pagina non mostra alcun suggerimento, significa che il progetto non ha ritiri o modifiche che causano interruzioni che soddisfano i criteri per un suggerimento.

Google Cloud CLI

Questa scheda mostra i comandi per elencare i suggerimenti e gli insight con Google Cloud CLI.

• Elenco suggerimenti

  gcloud recommender recommendations list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --recommender=google.cloud.deprecation.GeneralRecommender \
    --format=yaml
  

• Elenco insight

  gcloud recommender insights list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --insight-type=google.cloud.deprecation.GeneralInsight \
    --format=yaml
  

Sostituisci quanto segue:

• BILLING_PROJECT_ID con l'ID del progetto che hai abilitato con l'API Recommender.
• PROJECT_ID con l'identificatore del tuo Google Cloud progetto.
• LOCATION con la Google Cloud località in cui si trovano le risorse associate ai suggerimenti (ad esempio, global o us-central1-a).

API

Questa scheda mostra i comandi per elencare i suggerimenti e gli insight con l'API Recommender.

• Elenco suggerimenti

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /recommenders/google.cloud.deprecation.GeneralRecommender/recommendations"
  

• Elenco insight

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /insightTypes/google.cloud.deprecation.GeneralInsight/insights"
  

Sostituisci quanto segue:

• BILLING_PROJECT_ID con l'ID del progetto che hai abilitato con l'API Recommender.
• PROJECT_ID con l'identificatore del tuo Google Cloud progetto.
• LOCATION con la Google Cloud località in cui si trovano le risorse associate ai suggerimenti (ad esempio, global o us-central1-a).

Esportazione in BigQuery

Questa scheda mostra i comandi per elencare i suggerimenti con l'esportazione in BigQuery.

I suggerimenti relativi al ritiro di Cloud sono inclusi anche in BigQuery export. Con l'esportazione in BigQuery, puoi visualizzare gli snapshot giornalieri dei suggerimenti per la tua organizzazione.

1. Segui la documentazione sull'esportazione in BigQuery per esportare i suggerimenti in BigQuery.

2. Esegui una query su tutti i suggerimenti relativi al ritiro:

   SELECT *
   FROM `<project>.<dataset>.recommendations_export`
   WHERE DATE(_PARTITIONTIME) = "<date>"
   and recommender = "google.cloud.deprecation.GeneralRecommender"
   

Sottotipi di suggerimenti disponibili

La seguente tabella descrive i sottotipi di suggerimenti disponibili e divulgabili.

Sottotipo	Ritiro o modifica che causa interruzioni?
GCE_METADATA_SERVER_HEADER_WHITESPACE	Compute Engine applicherà i controlli di formattazione delle richieste HTTP nel servizio metadati di Compute Engine in conformità con la sezione 3.2 del documento RFC 7230, in quanto l'accettazione di richieste con formattazione errata potrebbe comportare vulnerabilità alla sicurezza.

Avviso: i suggerimenti ignorati non vengono rigenerati e nasconderanno il suggerimento relativo al ritiro per l'istanza su tutte le superfici. Contrassegnalo invece come riuscito dopo aver applicato il suggerimento.

Tieni presente che questa tabella non è esaustiva e potrebbe omettere intenzionalmente ritiri o modifiche che causano interruzioni sensibili alla sicurezza.