Gestione dei contatti per le notifiche

Molte offerte di 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

Attiva Essential Contacts API.

Abilita l'API

Ruoli obbligatori

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

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
    • essentialcontcts.contacts.update

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

Categorie di notifica

È possibile assegnare i contatti a diverse categorie di notifica. Se non aggiungi un contatto a una categoria, le notifiche di quella categoria vengono inviate al contatto di riserva, che viene selezionato in base ai ruoli IAM dei membri. Ti consigliamo di aggiungere contatti personalizzati, anziché fare affidamento su contatti di riserva, per assicurarti che le persone corrette ricevano le notifiche per il tuo progetto, la tua cartella o la tua organizzazione.

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

Consulta la seguente tabella per informazioni su categorie di notifiche, contatti di riserva e contatti 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/A N/A Persone o sistemi automatici responsabili dell'indirizzamento o della registrazione di un numero potenzialmente elevato di notifiche
Fatturazione Notifiche di fatturazione e pagamenti Aggiornamenti di prezzo, errori e crediti Amministratore account di fatturazione (roles/billing.admin) Personale del dipartimento finanziario e persone che gestiscono i rapporti finanziari con Google, incluse le persone che gestiscono budget, pianificazione e account relativi all'utilizzo di Google Cloud
Informazioni legali Notifiche di conformità legale Azioni di applicazione forzata, conformità normativa, notifiche governative Amministratore account di fatturazione (roles/billing.admin) Consulenti legali, responsabili della conformità, specialisti delle relazioni governative 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 è salvaguardare i dati dell'azienda e dei clienti e garantire la continuità aziendale
Sospensione Notifiche relative alla sospensione immediata dell'account e del progetto Conformità alla valutazione di Apigee, violazioni del copyright e coin mining Proprietario progetto (roles/owner) Persone immediatamente responsabili di mantenere attive e in esecuzione l'infrastruttura IT e le applicazioni aziendali
Tecnico Eventi tecnici e altri problemi operativi Logging degli errori di configurazione, aggiornamenti della prevenzione della perdita di dati e stato di Actions on Google Proprietario progetto (roles/owner) Professionisti IT, tecnici dell'affidabilità, amministratori, elenchi disponibili e altre persone che devono essere a conoscenza di eventi e problemi tecnici attuali e imminenti per gestire meglio i tuoi asset IT ed evitare interruzioni
Incidenti tecnici Per i clienti dell'Assistenza Premium, una sottocategoria della categoria Tecnico per le notifiche di interruzione Interruzioni non pianificate, problemi di servizio N/A Professionisti IT, tecnici dell'affidabilità, amministratori, elenchi disponibili e altre persone che hanno bisogno di reagire alle interruzioni

Lingue supportate

In Contatti necessari, ogni contatto ha un'impostazione di lingua preferita. Gli autori delle notifiche possono fare riferimento a questa impostazione durante l'invio di notifiche.

Quando aggiungi un contatto nella console Google Cloud, quest'ultima configura automaticamente la lingua preferita del contatto in base alle impostazioni della lingua preferita del creatore del contatto. Quando aggiungi un contatto utilizzando l'API, configuri 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 di Google Cloud. Di conseguenza, se aggiungi un contatto a livello di organizzazione, quest'ultimo riceverà notifiche per l'organizzazione e per tutte le cartelle e i progetti nell'organizzazione. Analogamente, se aggiungi un contatto a livello di cartella, quest'ultimo riceverà notifiche per la cartella e per tutte le cartelle e i progetti al suo interno.

La destinazione dell'assegnazione dei 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
Livello di organizzazione
  • Fatturazione
  • Informazioni legali
  • Sicurezza1
A livello di cartella/progetto
  • Tutti
  • Aggiornamenti di prodotto
  • Sicurezza1
  • Sospensione
  • Tecnico2

1 Il livello al quale assegni i contatti per la sicurezza dipende dalle prassi 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 a livello di organizzazione gestisce la sicurezza per tutti i progetti, i contatti per la sicurezza verranno assegnati a livello di organizzazione.

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

Assegnazione di contatti per le notifiche di interruzione e interruzione del servizio

Se sei un cliente con Assistenza Premium, puoi assegnare contatti che ricevano notifiche su interruzioni e interruzioni mediante la sottocategoria Incidenti tecnici. In questo modo puoi indirizzare le notifiche di interruzione ad alto impatto ai contatti che devono concentrarsi sulle interruzioni, senza la distrazione di altre notifiche tecniche.

Per assicurarti che le notifiche vengano inviate ai contatti appropriati, tieni presente il seguente comportamento di ereditarietà quando assegni i contatti alla sottocategoria Incidenti tecnici:

  • Se assegni un contatto per gli incidenti tecnici su un progetto o una cartella, le notifiche di interruzione vengono inviate solo a:

    • Il contatto Incidenti tecnici del progetto o della cartella
    • Contatti ereditati per Incidenti tecnici dall'organizzazione o dalla cartella padre

  • Se non assegni un contatto per gli incidenti tecnici su un progetto o una cartella, le notifiche di interruzione vengono inviate solo a:

    • Il contatto tecnico del progetto o della cartella
    • Contatti ereditati per Incidenti tecnici dall'organizzazione o dalla cartella padre

  • Se un contatto di incidente tecnico non viene assegnato o ereditato e non viene assegnato alcun contatto tecnico, le notifiche di interruzione non vengono inviate

Limitazione dei domini consentiti per i contatti

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

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

Elenco contatti

Per elencare tutti i contatti nel progetto, nella cartella o nell'organizzazione:

Console

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

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle 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 in base alla categoria, seleziona Categoria. Per elencare i contatti in ordine alfabetico, seleziona Contatti.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

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

    Elenco dei contatti definiti su 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, 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.

    In alternativa, se non specifichi un tipo o un ID di risorsa, l'interfaccia alla gcloud CLI i contatti per il progetto attuale.

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

    Elenco dei contatti e dei contatti ereditati

    Le risorse secondarie (cartelle e progetti) ereditano i contatti dai predecessori (organizzazioni e altre cartelle). Se vuoi elencare tutti i contatti e quelli 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 seguenti dati della richiesta, 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 qualsiasi dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, technical-incidents e notification-category-unspecified. Se scegli il 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, 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 ID e un tipo di risorsa, l'interfaccia alla gcloud CLI 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 Essential Contacts, puoi elencare i contatti definiti in una risorsa o tutti i contatti e i contatti ereditati di una risorsa.

Elenco dei contatti definiti su una risorsa

Per visualizzare i contatti che sono stati definiti in un progetto, una cartella o un'organizzazione specifici, utilizza il metodo contacts.list dell'API Essential Contacts.

Prima di utilizzare i seguenti dati della richiesta, 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, 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.
  • PAGE_SIZE: facoltativo. Il numero di contatti da includere nella risposta. Il valore predefinito è 50, mentre il valore massimo è 100. Se il numero di contatti è superiore alla dimensione della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina dei risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione restituito in una risposta precedente di questo metodo. Se specificato, l'elenco dei contatti inizia da 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 delle seguenti 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, riceverai 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"
    }
  ]
}

Elenco dei contatti e dei contatti ereditati

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

Prima di utilizzare i seguenti dati della richiesta, 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, 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.
  • NOTIFICATION_CATEGORY: le categorie di notifiche per cui vuoi calcolare i contatti. Puoi ripetere questo campo per elencare i contatti per più categorie di notifica. NOTIFICATION_CATEGORY può essere uno qualsiasi dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS e NOTIFICATION_CATEGORY_UNSPECIFIED. Se scegli il 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, mentre il valore massimo è 100. Se il numero di contatti è superiore alla dimensione della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina dei risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione restituito in una risposta precedente di questo metodo. Se specificato, l'elenco dei contatti inizia da 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 delle seguenti 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 essenziali

Puoi aggiungere contatti, rimuoverli o assegnare loro categorie di notifica nella pagina Contatti necessari della console Google Cloud oppure utilizzando l'API REST.

Aggiunta di un contatto

Per aggiungere un contatto:

Console

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

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle 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, vedi Identificazione dei contatti in questa pagina.

  6. Fai clic su Salva.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Per aggiungere un nuovo contatto, utilizza il comando gcloud Essentials-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 il contatto deve ricevere le comunicazioni. L'elenco può contenere uno qualsiasi dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, incidenti tecnici e notification-category-unspecified. Se scegli il valore all, vengono elencati i contatti per tutte le categorie.

      Per un elenco dei contatti consigliati per ogni categoria, vedi Identificare i contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua preferita per le notifiche del tuo contatto. Puoi includere il codice lingua di qualsiasi lingua supportata.
    • RESOURCE_TYPE: il tipo di risorsa per cui vuoi creare un contatto. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: ID progetto, organizzazione o 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 ID e un tipo di risorsa, gcloud CLI crea un contatto nel progetto attuale.

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

REST

Per aggiungere un nuovo contatto, utilizza il metodo contacts.create dell'API Essential Contacts.

Prima di utilizzare i seguenti dati della richiesta, 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, 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.
  • 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 qualsiasi dei seguenti: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

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

  • LANGUAGE: il codice lingua della lingua preferita per le notifiche del contatto. Puoi includere il codice lingua di qualsiasi lingua supportata.

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 delle seguenti opzioni:

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

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

Modifica di un contatto

Per modificare le categorie a cui è assegnato un contatto, effettuare le seguenti operazioni:

Console

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

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle 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 vuoi dal menu a discesa Categorie di notifica e fai clic su Salva.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Per aggiornare un contatto esistente, utilizza il comando gcloud Essentials-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 che vuoi aggiornare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è quello che compare dopo contacts nel nome del contatto.
    • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle nuove categorie di notifica per cui il contatto deve ricevere le comunicazioni. Questo elenco sostituirà l'elenco esistente di categorie di notifica.

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

      Per un elenco dei contatti consigliati per ogni categoria, vedi Identificare i contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua preferita per le notifiche del tuo contatto. Puoi includere il codice lingua di qualsiasi lingua supportata.
    • RESOURCE_TYPE: tipo di risorsa in 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, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un ID e un tipo di risorsa, gcloud CLI aggiorna il contatto con l'ID specificato nel progetto attuale. Se non esistono contatti con l'ID specificato, 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 seguenti dati della richiesta, 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, 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.
  • CONTACT_ID: l'ID numerico del contatto che vuoi aggiornare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i tuoi contatti. L'ID numerico è quello che segue contacts nel nome del contatto.
  • UPDATE_MASK: facoltativo. Una maschera che descrive quali campi del contatto sono stati modificati. 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 all'elemento CONTACT_ID che includi nella richiesta.

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

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

  • LANGUAGE: il codice lingua della lingua preferita per le notifiche del contatto. Puoi includere il codice lingua di qualsiasi lingua supportata.

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 delle seguenti opzioni:

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

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

Eliminazione di un contatto

Per eliminare un contatto:

Console

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

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle 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. Quindi, nella finestra di dialogo, conferma di voler eliminare il contatto.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Per eliminare un contatto esistente, utilizza il comando gcloud Essentials delete:

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

    Sostituisci i seguenti valori:

    • CONTACT_ID: l'ID numerico del contatto che vuoi eliminare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è quello che compare dopo contacts nel nome del contatto.
    • RESOURCE_TYPE: tipo di risorsa in 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, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un ID e un tipo di risorsa, gcloud CLI elimina il contatto con l'ID specificato nel progetto attuale. Se non esistono contatti con l'ID specificato, 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 Essential Contacts.

Prima di utilizzare i seguenti dati della richiesta, 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, 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.
  • 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 delle seguenti 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 accedendo alla scheda Categoria nella pagina Contatti necessari.

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

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

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle 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. Gestire i contatti assegnati alla categoria:

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

    • Per cambiare la categoria a cui è assegnato un contatto, fai clic su accanto al contatto di cui modificare la categoria. Poi, 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 email

Puoi inviare un'email di prova ai contatti di ciascuna 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 necessari.

    Vai alla pagina Contatti necessari

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nel selettore delle risorse nella parte superiore della pagina. Il selettore di risorse visualizza 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 inviare le email di prova.

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

  6. Fai clic su Invia. Un'email di prova viene inviata ai contatti selezionati.

  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 di notifica. 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, 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.
  • EMAIL: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.
  • LANGUAGE: facoltativo. Il codice lingua della lingua preferita per le notifiche del contatto. Puoi includere il codice lingua di qualsiasi lingua supportata.

  • NOTIFICATION_CATEGORIES: un array delle 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, TECHNICAL_INCIDENTS.

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

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

Per maggiori dettagli, consulta la documentazione relativa ai contatti necessari di Terraform.

Passaggi successivi