Gestione dei contatti per le notifiche

Molte offerte Google Cloud, come la fatturazione cloud, inviano notifiche per condividere informazioni importanti con gli utenti di Google Cloud. Per impostazione predefinita, queste notifiche vengono inviate ai membri con determinati ruoli IAM (Identity and Access Management). Con Contatti necessari, puoi personalizzare chi riceve le notifiche fornendo il tuo elenco di contatti.

Prima di iniziare

Enable the Essential Contacts API.

Enable the API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i contatti, chiedi all'amministratore di concederti i seguenti ruoli IAM per il progetto, la cartella o l'organizzazione a cui è assegnato il contatto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire i contatti. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per gestire i contatti sono necessarie le seguenti autorizzazioni:

  • Per visualizzare i contatti:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • Per modificare, eliminare e creare contatti:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontacts.contacts.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Categorie di notifica

Puoi assegnare i contatti a più categorie di notifiche. Se non aggiungi un contatto a una categoria, le notifiche in quella categoria vengono inviate al contatto di riserva, che viene selezionato in base ai ruoli IAM dei membri. Ti consigliamo di aggiungere contatti personalizzati e di non fare affidamento su quelli di riserva per assicurarti che le persone giuste ricevano notifiche per il tuo progetto, la tua cartella o la tua organizzazione.

Puoi aggiungere come contatti sia privati che gruppi. Per ridurre l'impatto delle modifiche al personale, ti consigliamo di aggiungere i gruppi come contatti e di gestire l'appartenenza a questi gruppi per determinare chi riceve le notifiche. Questa procedura contribuisce a garantire che le notifiche vengano sempre inviate ai dipendenti attivi.

Consulta la tabella seguente per informazioni sulle categorie di notifiche, sui contatti di riserva e su quelli consigliati. Se non assegni un contatto a una determinata categoria, le notifiche vengono inviate al contatto di riserva.

Categoria Descrizione Esempi Contatto di riserva Contatto consigliato
Tutti Tutte le notifiche di ogni categoria N/D N/D Persone o sistemi automatici responsabili dell'inoltro o della registrazione di un numero potenzialmente elevato di notifiche
Fatturazione Notifiche relative a fatturazione e pagamenti Aggiornamenti dei prezzi, errori e crediti Amministratore account di fatturazione (roles/billing.admin) Il personale del reparto finanziario e le persone che gestiscono il tuo rapporto finanziario con Google, incluse le persone che gestiscono i budget, la pianificazione e gli account relativi all'utilizzo di Google Cloud
Legale Notifiche relative alla conformità alle norme Azioni di applicazione forzata, conformità normativa, notifiche governative Amministratore account di fatturazione (roles/billing.admin) Avvocati, responsabili della conformità, esperti di relazioni con la pubblica amministrazione e altri professionisti correlati
Aggiornamenti di prodotto Modifiche ai prodotti Google Nuove versioni, aggiornamenti dei termini dei prodotti, deprecazioni Proprietario progetto (roles/owner) Product manager, architetti e ingegneri che possono trarre vantaggio da informazioni tempestive sulle modifiche ai prodotti e ai servizi Google
Sicurezza Notifiche relative a problemi di sicurezza/privacy Vulnerabilità, incidenti relativi ai dati e attacchi Amministratore organizzazione (roles/resourcemanager.organizationAdmin) Sicurezza IT, sicurezza operativa e altre persone il cui compito è difendere i dati della tua azienda e dei tuoi clienti e garantire la continuità aziendale
Sospensione Notifiche relative alla sospensione immediata dell'account e del progetto Conformità alla valutazione Apigee, violazioni del copyright e mining di monete Proprietario progetto (roles/owner) Le persone immediatamente responsabili del funzionamento dell'infrastruttura IT e delle applicazioni aziendali
Tecnico Eventi tecnici e altri problemi operativi Errori di configurazione del logging, aggiornamenti della prevenzione della perdita di dati e stato di Actions on Google Proprietario progetto (roles/owner) Professionisti IT, reliability engineer, amministratori, elenchi di persone di guardia e altre persone che devono essere a conoscenza di eventi tecnici e problemi attuali e imminenti per gestire meglio le risorse IT ed evitare interruzioni

Lingue supportate

In Contatti essenziali, ogni contatto ha un'impostazione della lingua preferita. I creator di notifiche possono fare riferimento a questa impostazione quando inviano notifiche.

Quando aggiungi un contatto nella console Google Cloud, la console configura automaticamente la lingua preferita del contatto in base alle impostazioni della lingua preferita del contatto. Quando aggiungi un contatto utilizzando l'API, puoi configurare manualmente la lingua preferita del contatto utilizzando un codice lingua. Questo codice lingua può fare riferimento a qualsiasi lingua supportata da Contatti necessari.

Best practice per l'assegnazione dei contatti

Puoi assegnare i contatti a livello di progetto, cartella o organizzazione.

I contatti vengono ereditati tramite la gerarchia delle risorse Google Cloud. Di conseguenza, se aggiungi un contatto a livello di organizzazione, questo riceve notifiche per l'organizzazione e per tutte le cartelle e i progetti al suo interno. Analogamente, se aggiungi un contatto a livello di cartella, questo riceverà notifiche per la cartella e per tutte le cartelle e i progetti al suo interno.

La scelta di dove assegnare i contatti dipende dalla struttura della tua organizzazione. Tuttavia, in genere consigliamo di assegnare i contatti ai seguenti livelli, in base alla categoria di notifica:

Livello consigliato Categoria di notifica
A livello di organizzazione
  • Fatturazione
  • Legale
  • Sicurezza1
A livello di cartella/progetto
  • Tutti
  • Aggiornamenti di prodotto
  • Sicurezza1
  • Sospensione
  • Assistenza tecnica2

1 Il livello a cui assegni i contatti per la sicurezza dipende dalle pratiche di sicurezza specifiche della tua organizzazione. Ad esempio, se i singoli proprietari di progetti sono responsabili della sicurezza dei propri progetti, devi assegnare i tuoi contatti per la sicurezza a livello di progetto. Tuttavia, se un gruppo per l'intera organizzazione gestisce la sicurezza per tutti i progetti, devi assegnare i tuoi contatti per la sicurezza a livello di organizzazione.

2 I contatti della categoria tecnica ricevono un numero elevato di notifiche via email. Assegna questi contatti a livello di cartella o progetto per consentirgli di elaborare il flusso di notifiche in arrivo.

Limitare i domini consentiti per i contatti

Per limitare i domini degli indirizzi email che i nuovi contatti possono avere, imposta il vincolo delle norme dell'organizzazioneconstraints/essentialcontacts.allowedContactDomains. I contatti esistenti non sono interessati da questo vincolo.

Per scoprire come impostare i vincoli dei criteri dell'organizzazione, consulta Vincoli dei criteri dell'organizzazione.

Contatti della scheda

Per elencare tutti i contatti del progetto, della cartella o dell'organizzazione, procedi nel seguente modo:

Console

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse indica il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Per elencare i contatti per categoria, seleziona Categoria. Per elencare i contatti alfabeticamente, seleziona Contatti.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Con Google Cloud CLI, puoi elencare i contatti definiti in una risorsa o tutti i contatti e i contatti ereditati per una risorsa.

    Contatti della scheda definiti in una risorsa

    Per visualizzare i contatti che sono stati definiti in un progetto, una cartella o un'organizzazione specifici, utilizza il comando gcloud essential-contacts list:

    gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"

    Sostituisci i seguenti valori:

    • RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i contatti. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, ad esempiomy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    In alternativa, se non specifichi un tipo o un ID risorsa, il riga di comando gcloud CLI i contatti per il progetto corrente.

    La risposta è simile alla seguente:

    ---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---

    Contatti della scheda e contatti ereditati

    Le risorse secondarie (cartelle e progetti) ereditano i contatti dai loro elementi principali (organizzazioni e altre cartelle). Se vuoi elencare tutti i contatti e i contatti ereditati per una risorsa, utilizza il comando gcloud essential-contacts compute:

    gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \
  --RESOURCE_TYPE="RESOURCE_ID"

    Sostituisci i seguenti valori:

    Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

    • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle categorie di notifiche per le quali vuoi calcolare i contatti. L'elenco può contenere uno dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical e notification-category-unspecified. Se scegli un valore all, vengono elencati i contatti per tutte le categorie.
    • RESOURCE_TYPE: il tipo di risorsa per cui vuoi calcolare i contatti. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un tipo di risorsa e un ID, la gcloud CLI elenca i contatti per il progetto corrente.

    La risposta elenca tutti i contatti e i contatti ereditati per la risorsa:

    ---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---
email: my-organization-contact@example.com
languageTag: en-US
name: organizations/my-organization/contacts/1
notificationCategorySubscriptions:
- ALL
---

REST

Con l'API REST Contatti necessari, puoi elencare i contatti definiti in una risorsa o tutti i contatti e i contatti ereditati per una risorsa.

Contatti della scheda definiti in una risorsa

Per visualizzare i contatti definiti in un progetto, una cartella o un'organizzazione specifici, utilizza il metodo contacts.list dell'API Contatti necessari.

Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • PAGE_SIZE: facoltativo. Il numero di contatti da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 100. Se il numero di contatti è superiore alle dimensioni della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina di risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di paginazione restituito in una risposta precedente di questo metodo. Se specificato, l'elenco dei contatti inizia dove è terminata la risposta precedente.

Richiesta: 

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Esegui questo comando: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Dopo aver inviato la richiesta, ricevi una risposta JSON simile alla seguente: 

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-contact-1@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-contact-2@example.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

Contatti della scheda e contatti ereditati

Le risorse secondarie (cartelle e progetti) ereditano i contatti dai loro elementi principali (organizzazioni e altre cartelle). Se vuoi elencare tutti i contatti e i contatti ereditati per una risorsa, utilizza il metodo contacts.compute dell'API Essential Contacts.

Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi calcolare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • NOTIFICATION_CATEGORY: le categorie di notifiche per cui vuoi calcolare i contatti. Puoi ripetere questo campo per elencare i contatti per più categorie di notifiche. NOTIFICATION_CATEGORY può essere uno dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL e NOTIFICATION_CATEGORY_UNSPECIFIED. Se scegli un valore ALL, vengono elencati i contatti per tutte le categorie.
  • PAGE_SIZE: facoltativo. Il numero di contatti da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 100. Se il numero di contatti è superiore alle dimensioni della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina di risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di paginazione restituito in una risposta precedente di questo metodo. Se specificato, l'elenco dei contatti inizia dove è terminata la risposta precedente.

Richiesta: 

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Esegui questo comando: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

La risposta elenca tutti i contatti e i contatti ereditati per la risorsa:

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-project-contact-1@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@example.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

Gestione dei singoli contatti fondamentali

Puoi aggiungere contatti, rimuoverli o assegnargli categorie di notifica nella pagina Contatti fondamentali della console Google Cloud o utilizzando l'API REST.

Aggiunta di un contatto

Per aggiungere un contatto:

Console

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse indica il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Fai clic su Aggiungi contatto.

  4. Nei campi Email e Conferma email, inserisci l'indirizzo email del contatto.

  5. Nel menu a discesa Categorie di notifica, seleziona le categorie di notifica per cui il contatto deve ricevere le comunicazioni. Per un elenco delle categorie di notifica e dei contatti consigliati, consulta Identificare i contatti in questa pagina.

  6. Fai clic su Salva.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per aggiungere un nuovo contatto, utilizza il comando gcloud essential-contacts create:

    gcloud essential-contacts create --email="EMAIL" \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE" \
    --RESOURCE_TYPE="RESOURCE_ID"

    Sostituisci i seguenti valori:

    • EMAIL: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.
    • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle categorie di notifica per cui vuoi che il contatto riceva le comunicazioni. L'elenco può contenere uno dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, technical-incidents e notification-category-unspecified. Se scegli un valore all, vengono elencati i contatti per tutte le categorie.

      Per un elenco di contatti consigliati per ogni categoria, consulta Identificazione dei contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
    • RESOURCE_TYPE: il tipo di risorsa per cui vuoi creare un contatto. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del tuo progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, ad esempio my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un tipo di risorsa e un ID, la gcloud CLI crea un contatto nel progetto corrente.

    Se il comando ha esito positivo, non viene restituita alcuna risposta.

REST

Per aggiungere un nuovo contatto, utilizza il metodo contacts.create dell'API Contatti necessari.

Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi creare un contatto. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • EMAIL: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.

  • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: le categorie di notifica per cui il contatto deve ricevere le comunicazioni. Questo valore può essere uno tra i seguenti: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Per un elenco di contatti consigliati per ogni categoria, consulta Identificazione dei contatti in questa pagina.

  • LANGUAGE: il codice lingua della lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

Richiesta: 

POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts

Corpo della richiesta: 

{
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dopo aver inviato la richiesta, ricevi una risposta JSON simile alla seguente: 

{
  "name": "projects/my-project/contacts/3",
  "email": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

Modificare un contatto

Per modificare le categorie a cui è assegnato un contatto:

Console

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse indica il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Accanto a Visualizza per, seleziona Contatto.

  4. Fai clic su accanto al contatto di cui vuoi modificare la categoria.

  5. Seleziona le categorie di notifica che ti interessano dal menu a discesa Categorie di notifica e fai clic su Salva.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per aggiornare un contatto esistente, utilizza il comando gcloud essential-contacts update:

    gcloud essential-contacts update CONTACT_ID \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE"
    --RESOURCE_TYPE="RESOURCE_ID"

    Sostituisci i seguenti valori:

    • CONTACT_ID: l'ID numerico del contatto da aggiornare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i tuoi contatti. L'ID numerico è tutto ciò che segue contacts nel nome del contatto.
    • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle nuove categorie di notifica per cui vuoi che il contatto riceva comunicazioni. Questo elenco sostituirà l'elenco esistente delle categorie di notifiche.

      L'elenco può contenere uno dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, technical-incidents e notification-category-unspecified. Se scegli un valore all, vengono elencati i contatti per tutte le categorie.

      Per un elenco di contatti consigliati per ogni categoria, consulta Identificazione dei contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
    • RESOURCE_TYPE: il tipo di risorsa su cui è definito il contatto. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del progetto, dell'organizzazione o della cartella Google Cloud in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, ad esempio my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un tipo e un ID risorsa, la gcloud CLI aggiorna il contatto con l'ID specificato nel progetto corrente. Se non esiste alcun contatto con l'ID specificato, la gcloud CLI restituisce un errore.

    Se il comando ha esito positivo, non viene restituita alcuna risposta.

REST

Per modificare le iscrizioni alle notifiche o la lingua preferita di un contatto esistente, utilizza il metodo contacts.patch dell'API Essential Contacts.

Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • CONTACT_ID: l'ID numerico del contatto da aggiornare. Per visualizzare gli ID di tutti i contatti del progetto, della cartella o dell'organizzazione, elenca i tuoi contatti. L'ID numerico è tutto ciò che seguecontacts nel nome del contatto.
  • UPDATE_MASK: facoltativo. Una maschera che descrive i campi del contatto che hai modificato. Il formato della maschera è un elenco separato da virgole di nomi completi dei campi, ad esempio:notificationCategorySubscriptions,languageTag.
  • EMAIL: l'indirizzo email del tuo contatto. Questo campo deve corrispondere all'indirizzo email associato al CONTACT_ID incluso nella richiesta.

  • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: facoltativi. Le categorie di notifica aggiornate per cui vuoi che il contatto riceva le comunicazioni. Questo valore può essere uno dei seguenti: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Per un elenco di contatti consigliati per ogni categoria, consulta Identificazione dei contatti in questa pagina.

  • LANGUAGE: il codice lingua della lingua di notifica preferita del contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

Richiesta: 

PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

Corpo della richiesta: 

{
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dopo aver inviato la richiesta, ricevi una risposta JSON simile alla seguente: 

{
  "name": "projects/my-project/contacts/2",
  "email": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

Eliminare un contatto

Per eliminare un contatto:

Console

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse indica il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Accanto a Visualizza per, seleziona Contatto.

  4. Fai clic su accanto all' indirizzo email del contatto che vuoi eliminare. Poi, nella finestra di dialogo, conferma che vuoi eliminare il contatto.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Per eliminare un contatto esistente, utilizza il comando gcloud essential-contacts delete:

    gcloud essential-contacts delete CONTACT_ID \
    --RESOURCE_TYPE="RESOURCE_ID"

    Sostituisci i seguenti valori:

    • CONTACT_ID: l'ID numerico del contatto da eliminare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i tuoi contatti. L'ID numerico è tutto ciò che segue contacts nel nome del contatto.
    • RESOURCE_TYPE: il tipo di risorsa su cui è definito il contatto. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del progetto, dell'organizzazione o della cartella Google Cloud in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, ad esempio my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un tipo di risorsa e un ID, l'gcloud CLI elimina il contatto con l'ID specificato nel progetto corrente. Se non esiste alcun contatto con l'ID specificato, la gcloud CLI restituisce un errore.

    Se il comando ha esito positivo, non viene restituita alcuna risposta.

REST

Per eliminare un contatto, utilizza il metodo contacts.delete dell'API Contatti necessari.

Prima di utilizzare i dati di richiesta riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • CONTACT_ID: l'ID numerico del contatto. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i tuoi contatti.

Richiesta: 

DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

Per inviare la richiesta, espandi una di queste opzioni:

Se la richiesta ha esito positivo, il corpo della risposta sarà vuoto.

Gestione dei contatti per categoria

Nella console Google Cloud, puoi anche gestire i contatti per categoria dalla scheda Categoria della pagina Contatti essenziali.

Per aggiungere, modificare o eliminare i contatti assegnati a una singola categoria:

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse indica il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Accanto a Visualizza per, seleziona Categoria.

  4. Fai clic su nella stessa riga della categoria di cui vuoi gestire i contatti.

  5. Gestisci i contatti assegnati alla categoria:

    • Per aggiungere un nuovo contatto, fai clic su Aggiungi contatto e segui i passaggi per aggiungere un contatto descritti in questa pagina.

    • Per modificare la categoria a cui è assegnato un contatto, fai clic su accanto al contatto di cui vuoi modificare la categoria. Quindi, seleziona le categorie di notifica che ti interessano dal menu a discesa Categorie di notifica e fai clic su Salva.

    • Per eliminare un contatto, fai clic su accanto all'indirizzo email del contatto.

Verifica delle trasmissioni via email

Puoi inviare un'email di prova ai contatti di ogni categoria per verificare se gli account email sono in grado di ricevere email da Google Cloud.

Per inviare un'email di prova ai contatti di una categoria specifica:

  1. Nella console Google Cloud, vai alla pagina Contatti essenziali.

    Vai alla pagina Contatti fondamentali

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse nella parte superiore della pagina. Il selettore di risorse mostra il progetto, la cartella o l'organizzazione per cui stai gestendo i contatti.

  3. Accanto a Visualizza per, seleziona Categoria.

  4. Fai clic su nella stessa riga della categoria a cui vuoi inviare le email di prova.

  5. Seleziona le caselle di controllo accanto ai contatti a cui vuoi inviare le email.

  6. Fai clic su Invia. Ai contatti selezionati viene inviata un'email di prova.

  7. Comunica con ogni contatto per assicurarti che abbia ricevuto un'email di prova da gcp-essential-contacts-noreply@google.com.

Gestione dei contatti con Terraform

Puoi utilizzare Terraform per gestire i contatti per le notifiche. I contatti hanno il seguente formato nel linguaggio Terraform:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

Quando crei un contatto, sostituisci i seguenti valori:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del tuo progetto, della tua organizzazione o della tua cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • EMAIL: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.
  • LANGUAGE: facoltativo. Il codice lingua della lingua di notifica preferita del contatto. Puoi includere il codice lingua di una delle lingue supportate.

  • NOTIFICATION_CATEGORIES: un array di categorie di notifica per cui il contatto deve ricevere le comunicazioni. Ad esempio, ["BILLING", "LEGAL"].

    Questo array può contenere uno qualsiasi dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Per un elenco di contatti consigliati per ogni categoria, consulta Identificazione dei contatti in questa pagina.

Per aggiungere, modificare o rimuovere un contatto, aggiungi, modifica o rimuovi una risorsa contatto nel file di configurazione Terraform.

Per ulteriori dettagli, consulta la documentazione di Terraform sui contatti necessari.

Passaggi successivi