Gestione dei contatti per le notifiche

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire i contatti. Per visualizzare le autorizzazioni necessarie, 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
    • essentialcontcts.contacts.update

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Categorie di notifica

È possibile assegnare i contatti a diverse 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 notifiche relative al progetto, alla cartella o all'organizzazione vengano inviate alle persone corrette.

Puoi aggiungere singoli utenti e gruppi come contatti. Per ridurre l'impatto delle modifiche al personale, consigliamo di aggiungere gruppi come contatti e di gestire la loro appartenenza per determinare chi riceve le notifiche. Questa pratica aiuta a garantire che le notifiche vengano inviate sempre 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 del routing o del logging di un numero potenzialmente elevato di notifiche
Fatturazione Notifiche di fatturazione e pagamento Aggiornamenti dei prezzi, errori e crediti Amministratore account di fatturazione (roles/billing.admin) Personale del reparto finanziario e persone che gestiscono le relazioni finanziarie con Google, incluse quelle che gestiscono budget, pianificazione e account correlati all'utilizzo di Google Cloud
Team legale Notifiche di conformità legale Azioni di applicazione forzata, conformità normativa, notifiche governative Amministratore account di fatturazione (roles/billing.admin) Consulenti legali, responsabili della conformità, esperti di relazioni con il governo e altri professionisti correlati
Aggiornamenti dei prodotti 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) la sicurezza IT, la sicurezza operativa e altre persone che si occupano di salvaguardare i dati della tua azienda e dei tuoi clienti e garantire la continuità aziendale.
Suspension Notifiche relative alla sospensione immediata dell'account e del progetto Conformità della valutazione di Apigee, violazioni del copyright e coin mining Proprietario progetto (roles/owner) Persone immediatamente responsabili del funzionamento dell'infrastruttura IT e delle applicazioni aziendali
Abilitazione tecnica Eventi tecnici e altri problemi operativi Logging degli errori di configurazione, aggiornamenti sulla prevenzione della perdita di dati e stato di Actions on Google Proprietario progetto (roles/owner) Professionisti IT, Reliability Engineer, amministratori, elenchi disponibili e altre persone che devono essere a conoscenza di eventi e problemi tecnici attuali e futuri per gestire meglio i tuoi asset IT ed evitare interruzioni
Incidenti tecnici Per i clienti dell'Assistenza Premium, una sottocategoria della categoria Tecnica per le notifiche delle interruzioni Interruzioni non pianificate, problemi di servizio N/A Professionisti IT, Reliability Engineer, amministratori, elenchi disponibili e altre persone che devono reagire alle interruzioni del servizio

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

Quando aggiungi un contatto nella console Google Cloud, la console Google Cloud configura automaticamente la lingua preferita del contatto in base alle impostazioni della lingua preferita dell'autore del contatto. Quando aggiungi un contatto tramite l'API, configuri manualmente la sua lingua preferita utilizzando un codice lingua. che può fare riferimento a uno qualsiasi dei linguaggi supportati da Contatti necessari.

Best practice per l'assegnazione dei contatti

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

I contatti vengono ereditati dalla 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 tutti i progetti nell'organizzazione. Allo stesso modo, se aggiungi un contatto a livello di cartella, questo riceverà notifiche per la cartella e per tutti i progetti e le cartelle al suo interno.

La scelta di 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
Livello organizzazione
  • Fatturazione
  • Team legale
  • Sicurezza1
A livello di cartella/progetto
  • Tutti
  • Aggiornamenti dei prodotti
  • Sicurezza1
  • Suspension
  • Tecnico2

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 contatti di sicurezza a livello di progetto. Tuttavia, se un gruppo a livello di organizzazione gestisce la sicurezza per tutti i progetti, assegneresti i contatti per la sicurezza 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 loro di elaborare il flusso di notifiche in arrivo.

Assegnazione di contatti per notifiche di interruzione e interruzione

Se sei un cliente dell'Assistenza Premium, puoi assegnare i contatti a ricevere notifiche relative a interruzioni e interruzioni tramite la sottocategoria Incidenti tecnici. In questo modo puoi indirizzare notifiche di interruzioni ad alto impatto ai contatti che devono concentrarsi sulle interruzioni, senza distrarti da 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 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 Incidenti tecnici ereditati dall'organizzazione o dalla cartella padre

  • Se non assegni un contatto per 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 Incidenti tecnici ereditati dall'organizzazione o dalla cartella padre

  • Se un contatto per incidenti tecnici non viene assegnato o ereditato e non è assegnato alcun contatto tecnico, le notifiche delle interruzioni 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, procedi nel seguente modo:

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 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 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 oppure tutti i contatti e i contatti ereditati per una risorsa.

    Elenco dei contatti definiti su una risorsa

    Per visualizzare i contatti definiti su 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    In alternativa, se non specifichi un tipo di risorsa o un ID, gcloud CLI elenca 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 di contatti e contatti ereditati

    Le risorse figlio (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 uno qualsiasi dei dati della richiesta riportati di seguito, effettua le seguenti sostituzioni:

    • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle categorie di notifiche per cui vuoi calcolare i contatti. 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 di 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

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

    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 oppure tutti i contatti e i contatti ereditati per una risorsa.

Elenco dei contatti definiti su una risorsa

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

Prima di utilizzare uno qualsiasi dei dati della 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come 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 è maggiore delle dimensioni della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione è stato restituito in una risposta precedente da 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"
    }
  ]
}

Elenco di contatti e contatti ereditati

Le risorse figlio (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 uno qualsiasi dei dati della 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come 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 un valore di 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 è maggiore delle dimensioni della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione è stato restituito in una risposta precedente da 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 essenziali

Puoi aggiungere contatti, rimuoverli o assegnare categorie di notifica per loro nella pagina Contatti necessari nella 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 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, 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 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 i 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, consulta la sezione Identificare i contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua di notifica preferita dal 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

    Se non specifichi un tipo di risorsa e un ID, 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 uno qualsiasi dei dati della 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • EMAIL: l'indirizzo email del contatto. Non puoi modificare questo campo dopo aver creato il contatto.

  • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: le categorie di notifica per cui vuoi che il contatto riceva 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 ciascuna categoria, consulta la sezione Identificazione dei contatti in questa pagina.

  • LANGUAGE: il codice lingua della lingua preferita per le notifiche dal tuo contatto. Puoi includere il codice lingua di una qualsiasi 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"
}

Modifica di un contatto

Per modificare le categorie a cui è assegnato un contatto, procedi nel seguente modo:

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 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 desiderate nel 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 da aggiornare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è la parte che segue 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 i 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, consulta la sezione Identificare i contatti in questa pagina.

    • LANGUAGE: il codice lingua della lingua di notifica preferita dal tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
    • RESOURCE_TYPE: il tipo di risorsa per 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 tipo di risorsa e un ID, gcloud CLI aggiorna il contatto con l'ID specificato nel progetto attuale. Se non esiste alcun contatto 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 uno qualsiasi dei dati della 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-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 nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è la parte che segue contacts 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 contatto. Questo campo deve corrispondere all'indirizzo email associato al 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 ciascuna categoria, consulta la sezione Identificazione dei contatti in questa pagina.

  • LANGUAGE: il codice della lingua preferita per le notifiche dal contatto. Puoi includere il codice lingua di una qualsiasi 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"
}

Eliminazione di un contatto

Per eliminare un contatto, procedi nel seguente modo:

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 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 da eliminare. Quindi, nella finestra di dialogo, conferma che vuoi 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-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 contatti. L'ID numerico è la parte che segue contacts nel nome del contatto.
    • RESOURCE_TYPE: il tipo di risorsa per 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 tipo di risorsa e un ID, gcloud CLI elimina il contatto con l'ID specificato nel progetto attuale. Se non esiste alcun contatto 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 uno qualsiasi dei dati della 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come 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 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 accedendo alla scheda Categoria nella pagina Contatti necessari.

Per aggiungere, modificare o eliminare i contatti assegnati a una singola categoria, procedi nel seguente modo:

  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 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, quindi segui la procedura per aggiungere un contatto descritta in questa pagina.

    • Per modificare la categoria a cui è assegnato un contatto, fai clic su accanto al contatto di cui vuoi modificare la categoria. Poi, seleziona le categorie di notifica desiderate 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 in corso...

Puoi inviare un'email di prova ai contatti di ogni categoria per verificare se gli account email possono 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 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 dei contatti a cui vuoi recapitare le email di prova.

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

  6. Fai clic su Invia. Viene inviata un'email di prova ai contatti selezionati.

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

Gestire i contatti con Terraform

Puoi utilizzare Terraform per gestire i contatti delle 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 progetto, dell'organizzazione o della cartella Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • EMAIL: l'indirizzo email del 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 una qualsiasi delle lingue supportate.

  • NOTIFICATION_CATEGORIES: un array delle categorie di notifica per cui vuoi che il contatto riceva 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 ciascuna categoria, consulta la sezione Identificazione dei contatti in questa pagina.

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

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

Passaggi successivi