Motore per suggerimenti generali relativi al ritiro e alle modifiche che provocano un errore

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Il motore per suggerimenti generali relativi al ritiro di Cloud e alle modifiche che provocano un errore ti fornisce una e fornisce consigli sul ritiro e l'interruzione delle modifiche di Cloud. Identifica Risorse cloud che saranno interessate da imminenti deprecazioni e interruzioni modifiche, fornendo al contempo linee guida su come gestirle. I consigli sono visualizzabili tramite Google Cloud CLI, l'API e BigQuery Export.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Recommender API.

   Enable the API

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Recommender API.

   Enable the API

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

4. Assicurati di disporre dei seguenti ruoli:

Descrizione	Ruoli
Visualizza i suggerimenti	recommender.cloudDeprecationRecommendationViewer
Visualizzare e aggiornare i consigli	recommender.cloudDeprecationRecommendationAdmin

Ruoli obbligatori

Questa sezione descrive i ruoli e le autorizzazioni necessarie per utilizzare il suggeritore generale relativo al ritiro e alle modifiche che provocano un errore.

Ruolo	Autorizzazioni incluse
ruoli/recommendationer.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 quanto segue:

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

Prezzi

Il motore per suggerimenti generali relativi al ritiro e alle modifiche che provocano un errore non è disponibile ricarica. Per informazioni su altri livelli di prezzo, consulta Prezzi del motore per suggerimenti.

Visualizzare i consigli relativi al ritiro del cloud

Puoi elencare i consigli utilizzando la console, Google Cloud CLI, l'API Recommender o l'esportazione di BigQuery.

Console

1. Vai all'hub dei suggerimenti.

   Vai all'hub dei suggerimenti

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

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

Google Cloud CLI

Questa scheda mostra i comandi per elencare consigli e approfondimenti con Google Cloud CLI.

• Consigli per gli elenchi

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

• Elenco approfondimenti

  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 attivato con l'API Recommender.
• PROJECT_ID con l'identificatore del tuo progetto Google Cloud.
• LOCATION con la località Google Cloud in cui le risorse associati ai consigli (ad esempio, globale o us-central1-a).

API

Questa scheda mostra i comandi per elencare consigli e approfondimenti 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 approfondimenti

  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 attivato con l'API Recommender.
• PROJECT_ID con l'identificatore del tuo progetto Google Cloud.
• LOCATION con la posizione Google Cloud in cui si trovano le risorse associate ai consigli (ad esempio, global o us-central1-a).

Esportazione in BigQuery

Questa scheda mostra i comandi per elencare i consigli con l'esportazione di BigQuery.

I suggerimenti sul ritiro di Cloud sono inclusi anche Esportazione in BigQuery. Con BigQuery Export, puoi visualizzare istantanee giornaliere dei consigli per la tua organizzazione.

1. Segui la documentazione di BigQuery Export per esportare i suggerimenti in BigQuery.

2. Esegui una query su tutti i suggerimenti sul ritiro:

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

Sottotipi di consigli disponibili

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

Sottotipo	Ritiro o modifica che provoca un errore?
GCE_METADATA_SERVER_HEADER_WHITESPACE	Compute Engine applicherà i controlli di formattazione delle richieste HTTP nel servizio di metadati di Compute Engine in modo da allinearsi alla sezione 3.2 del documento RFC 7230, poiché l'accettazione di richieste con formattazione errata potrebbe comportare vulnerabilità di sicurezza.

Avviso: i consigli ignorati non vengono rigenerati e nasconderanno il di ritiro dell'istanza su tutte le piattaforme. Contrassegnalalo come riuscito dopo aver applicato il consiglio.

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