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

Il motore per suggerimenti generali relativi al ritiro e alle modifiche che causano interruzioni di Cloud ti fornisce suggerimenti relativi ai ritiri e alle modifiche che causano interruzioni di Cloud. Identifica le risorse cloud che saranno interessate da ritiri e modifiche incompatibili imminenti, 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

  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.

    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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

  5. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

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

    1. 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 necessari per utilizzare il consigliere generale per il ritiro e le modifiche che causano interruzioni di Cloud.

    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 saperne di più sui ruoli e sulla concessione dell'accesso, consulta le seguenti risorse:

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

    Visualizzare i suggerimenti per il ritiro di Cloud

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

    Console

    1. Vai all'hub dei suggerimenti.

      Vai all'hub dei suggerimenti

    2. Imposta Campo filtro su Recommender:google.cloud.deprecation.GeneralRecommender.

    Google Cloud CLI

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

    • Elenco di consigli

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

    API

    Questa scheda mostra i comandi per elencare i suggerimenti e gli 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 abilitato con l'API Recommender.
    • PROJECT_ID con l'identificatore del tuo progetto Google Cloud .
    • LOCATION con la Google Cloud posizione in cui si trovano le risorse associate ai consigli (ad esempio, globale o us-central1-a).

    Esportazione in BigQuery

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

    I suggerimenti per il ritiro di Cloud sono inclusi anche in BigQuery Export. Con l'esportazione BigQuery, puoi visualizzare snapshot giornalieri dei consigli per la tua organizzazione.

    1. Segui le istruzioni della documentazione di BigQuery Export per esportare i suggerimenti in BigQuery.

    2. Esegui una query su tutti i consigli per il 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 conformità alla sezione 3.2 del documento RFC 7230, in quanto l'accettazione di richieste formattate in modo errato potrebbe comportare vulnerabilità di sicurezza.

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