Gestione dei contatti per le notifiche

Molti servizi Google Cloud, come Cloud Billing, 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 (Gestione di identità e accessi). Con i Contatti necessari, puoi personalizzare la ricezione delle notifiche fornendo un 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 al tuo amministratore di concederti i seguenti ruoli IAM per il progetto, la cartella o l'organizzazione a cui è assegnato il contatto:

  • Per visualizzare i contatti: Visualizzatore contatti necessari (roles/essentialcontacts.viewer)
  • Per visualizzare, modificare, eliminare e creare contatti: Amministratore contatti necessari (roles/essentialcontacts.admin)

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.

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 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 ruoli personalizzati o altri ruoli predefiniti.

Categorie di notifica

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

Puoi aggiungere sia singoli utenti sia gruppi come contatti. Per ridurre l'impatto delle modifiche del personale, consigliamo di aggiungere i gruppi come contatti, quindi di gestire l'appartenenza ai gruppi per determinare chi riceve le notifiche. Questa prassi assicura 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 altra categoria N/A N/A Persone o sistemi automatici responsabili di eseguire il routing o il logging di un numero potenzialmente elevato di notifiche.
Fatturazione Notifiche relative a fatturazione e pagamento Aggiornamenti dei prezzi, errori e crediti Amministratore account di fatturazione (roles/billing.admin) Personale del reparto Finanza e persone che gestiscono il tuo rapporto finanziario con Google, incluse persone che gestiscono budget, pianificazione e account relativi all'utilizzo di Google Cloud
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à, specialisti delle pubbliche relazioni e altri professionisti correlati
Aggiornamenti dei prodotti Modifiche ai prodotti Google Nuove versioni, aggiornamenti dei termini dei prodotti, deprecazioni Proprietario del progetto (roles/owner) Product manager, architetti e ingegneri che possono trarre vantaggio da informazioni tempestive sulle modifiche apportate ai prodotti e ai servizi Google
Sicurezza Notifiche relative a problemi di sicurezza/privacy Vulnerabilità, incidenti relativi ai dati e attacchi Amministratore dell'organizzazione (roles/resourcemanager.organizationAdmin) Sicurezza IT, sicurezza delle operazioni e altre persone il cui compito è salvaguardare 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à a Apigee Assessment, violazioni del copyright e mining di monete Proprietario del progetto (roles/owner) Persone immediatamente responsabili per mantenere operativa la tua infrastruttura IT e le tue applicazioni aziendali
Abilitazione tecnica Eventi tecnici e altri problemi operativi Registrazione di errori di configurazione, aggiornamenti della Prevenzione della perdita di dati e stato di Actions on Google Proprietario del progetto (roles/owner) Professionisti IT, affidabilità, amministratori, elenchi di persone 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 di interruzione Interruzioni non pianificate, problemi di servizio N/A Professionisti IT, affidabilità, amministratori, elenchi di persone e altre persone che hanno bisogno di reagire alle interruzioni

Lingue supportate

In Contatti necessari, ogni contatto ha una lingua prescelta. Gli autori delle notifiche possono fare riferimento a questa impostazione quando inviano notifiche.

Quando aggiungi un contatto in Cloud Console, quest'ultima configura automaticamente la lingua preferita del contatto in base alle impostazioni di lingua preferite dell'autore dei contatti. Quando aggiungi un contatto utilizzando l'API, devi 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 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 dell'organizzazione. Allo stesso modo, se aggiungi un contatto a livello di cartella, riceverà notifiche per la cartella e per tutte le cartelle e i progetti 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 loro categoria di notifica:

Livello consigliato Categoria delle notifiche
Livello di organizzazione
  • Fatturazione
  • Legale
  • Sicurezza1
Livello cartella/progetto
  • Tutti
  • Aggiornamenti dei prodotti
  • Sicurezza1
  • Sospensione
  • Aspetti tecnici2

1 Il livello al quale assegni i contatti di sicurezza dipende dalle prassi di sicurezza specifiche della tua organizzazione. Ad esempio, se i singoli proprietari di un progetto sono responsabili della sicurezza per i propri progetti, assegneresti 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 delle categorie tecniche ricevono un elevato numero di notifiche email. Assegna questi contatti a livello di cartella o progetto per consentire loro di elaborare il flusso delle notifiche in arrivo.

Assegnazione di contatti per le notifiche di interruzione e interruzione

Se sei un cliente dell'Assistenza Premium, puoi assegnare i contatti per ricevere notifiche sulle interruzioni e sulle interruzioni tramite 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à durante l'assegnazione dei contatti alla sottocategoria Incidenti tecnici:

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

    • Il contatto del progetto o della cartella Incidenti tecnici.
    • Ereditari contatti dei Incidenti tecnici dall'organizzazione o dalla cartella padre.
  • Se non assegni un contatto relativo agli incidenti tecnici su un progetto o una cartella, le notifiche sulle interruzioni vengono inviate solo a:

    • Il contatto del progetto o della cartella tecnico
    • Ereditari contatti dei Incidenti tecnici dall'organizzazione o dalla cartella padre.
  • Se un contatto di un incidente tecnico non è assegnato o ereditato, le notifiche delle interruzioni non vengono inviate

Limitazione dei domini consentiti per i contatti

Per limitare i domini degli indirizzi email dei nuovi contatti, imposta il vincolo di 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, vedi 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. In Cloud Console, 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 risorse indica il progetto, la cartella o l'organizzazione per cui gestisci attualmente i contatti.

  3. Per elencare i contatti per categoria, seleziona Categoria. Per elencare i contatti in ordine alfabetico, seleziona Contatti.

gcloud

Con l'interfaccia a riga di comando di Google Cloud, puoi elencare i contatti definiti in una risorsa o elencare tutti i contatti che hanno ereditato per una risorsa.

Elenco dei contatti definiti in una risorsa

Per visualizzare i contatti 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 in cui vuoi elencare i contatti. Utilizza il valore project, folder o organization.
  • RESOURCE_ID: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni sono numerici, ad esempio 123456789012.

In alternativa, se non specifichi un tipo di risorsa o un ID, l'interfaccia a riga di comando gcloud elenca 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
---

Elenco dei contatti e contatti ereditati

Le risorse figlio (cartelle e progetti) ereditano i contatti dai loro antenati (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 dati 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 qualsiasi dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, technical-incidents e notification-category-unspecified. Se scegli un valore di all contatti, puoi aggiungere 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: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni sono numerici, ad esempio 123456789012.

Se non specifichi un tipo di risorsa e un ID, l'interfaccia a riga di comando gcloud 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 Essential Contacts, puoi elencare i contatti definiti in una risorsa o tutti i contatti e i contatti ereditati per una risorsa.

Elenco dei contatti 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 Essential Contacts.

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

  • RESOURCE_TYPE: il tipo di risorsa in cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni 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 supera le dimensioni della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina dei risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione è stato restituito in una risposta precedente da questo metodo. Se specificato, l'elenco di contatti inizia da dove termina 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 contatti ereditati

Le risorse figlio (cartelle e progetti) ereditano i contatti dai loro antenati (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 dati 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: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni 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 dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS e NOTIFICATION_CATEGORY_UNSPECIFIED. Se scegli un valore di ALL contatti, puoi aggiungere 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 supera le dimensioni della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina dei risultati successiva.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione è stato restituito in una risposta precedente da questo metodo. Se specificato, l'elenco di contatti inizia da dove termina 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 necessari

Puoi aggiungere o rimuovere i contatti oppure assegnare loro categorie di notifica nella pagina Contatti necessari di Cloud Console oppure utilizzando l'API REST.

Aggiungere un contatto

Per aggiungere un contatto:

Console

  1. In Cloud Console, 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 risorse indica il progetto, la cartella o l'organizzazione per cui gestisci attualmente 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 le quali vuoi che il contatto riceva le comunicazioni. Per un elenco delle categorie di notifiche e i contatti consigliati, vedi Identificazione dei contatti in questa pagina.

  6. Fai clic su Salva.

gcloud

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 contatto. Non puoi modificare questo campo dopo aver creato il contatto.
  • NOTIFICATION_CATEGORIES: un elenco separato da virgole delle categorie di notifiche per cui vuoi che il contatto riceva le comunicazioni. 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 un valore di all contatti, puoi aggiungere 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 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: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni sono numerici, ad esempio 123456789012.

Se non specifichi un tipo di risorsa e un ID, l'interfaccia a riga di comando gcloud 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 dati 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: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni 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 notifiche per cui vuoi che il contatto riceva le comunicazioni. Il valore può essere uno dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

    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 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 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 cambiare le categorie a cui è assegnato un contatto, procedi come segue:

Console

  1. In Cloud Console, 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 risorse indica il progetto, la cartella o l'organizzazione per cui gestisci attualmente i contatti.

  3. Accanto a Visualizza per, seleziona Contatto.

  4. Fai clic su accanto al contatto per il quale vuoi modificare la categoria.

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

gcloud

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 che vuoi aggiornare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è tutto quello 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 le comunicazioni. Questo elenco sostituirà l'elenco esistente delle categorie di notifica.

    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 un valore di all contatti, puoi aggiungere 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 del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

  • RESOURCE_TYPE: il 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 di cartelle e organizzazioni sono numerici, ad esempio 123456789012.

Se non specifichi un tipo di risorsa e un ID, l'interfaccia a riga di comando gcloud aggiorna il contatto con l'ID specificato nel progetto attuale. Se non esiste alcun contatto con l'ID specificato, l'interfaccia a riga di comando gcloud 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 seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni 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 contatti. L'ID numerico è tutto quello che segue contacts nel nome del contatto.
  • UPDATE_MASK: facoltativo. Una maschera che descrive quali campi del contatto sono cambiati. Il formato della maschera è un elenco separato da virgole di nomi di campi completi, ad esempio: notificationCategorySubscriptions,languageTag.
  • EMAIL: l'indirizzo email del contatto. Questo campo deve corrispondere all'indirizzo email associato all'elemento CONTACT_ID che includi nella richiesta.
  • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: facoltativo. Le categorie di notifiche aggiornate in base alle quali 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 ogni categoria, consulta la sezione Identificare i 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 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"
}

Eliminare un contatto

Per eliminare un contatto, procedi come segue:

Console

  1. In Cloud Console, 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 risorse indica il progetto, la cartella o l'organizzazione per cui gestisci attualmente i contatti.

  3. Accanto a Visualizza per, seleziona Contatto.

  4. Fai clic sul pulsante accanto all'indirizzo email del contatto che vuoi eliminare. Quindi, nella finestra di dialogo, conferma di voler eliminare il contatto.

gcloud

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 che vuoi eliminare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione, elenca i contatti. L'ID numerico è tutto quello che segue contacts nel nome del contatto.
  • RESOURCE_TYPE: il 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 di cartelle e organizzazioni sono numerici, ad esempio 123456789012.

Se non specifichi un tipo di risorsa e un ID, l'interfaccia a riga di comando gcloud elimina il contatto con l'ID specificato nel progetto attuale. Se non esiste alcun contatto con l'ID specificato, l'interfaccia a riga di comando gcloud 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 dati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni sono numerici, ad esempio 123456789012.
  • CONTACT_ID: l'ID numerico del tuo contatto. Per visualizzare gli ID di tutti i contatti del progetto, della cartella o dell'organizzazione, elenca i 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

In Cloud Console, puoi 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. In Cloud Console, 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 risorse indica il progetto, la cartella o l'organizzazione per cui gestisci attualmente 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, quindi segui i passaggi per aggiungere un contatto descritto in questa pagina.
    • Per cambiare 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 nel menu a discesa Categorie di notifica e fai clic su Salva.

    • Per eliminare un contatto, fai clic sull'icona accanto all'indirizzo email di quel contatto.

Verifica delle trasmissioni email

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. In Cloud Console, 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 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 inviare le email di test.

  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 di aver ricevuto un'email di prova da gcp-essential-contacts-noreply@google.com.

Gestione dei 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" {
  provider = google-beta
  parent = "<var>RESOURCE_TYPE</var>/<var>RESOURCE_ID</var>"
  email = "<var>EMAIL</var>"
  language_tag = "<var>LANGUAGE</var>"
  notification_category_subscriptions = <var>NOTIFICATION_CATEGORIES</var>
}

Quando crei un contatto, sostituisci i seguenti valori:

  • RESOURCE_TYPE: il tipo di risorsa in cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: ID, organizzazione o progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID di cartelle e organizzazioni 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 di notifica preferita del contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
  • NOTIFICATION_CATEGORIES: array di categorie per le notifiche 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 ogni categoria, consulta la sezione Identificare i contatti in questa pagina.

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

Per maggiori dettagli, consulta la documentazione di Contatti Essentials di Terraform.

Passaggi successivi