Gestione dei contatti per le notifiche

Molte offerte di Google Cloud, come la fatturazione Cloud, inviano notifiche ai condividere informazioni importanti con gli utenti di Google Cloud. Per impostazione predefinita, Le 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 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 le autorizzazioni necessarie per gestire i contatti. Per vedere le autorizzazioni esatte obbligatorie, 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 ruoli personalizzati e 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 indirizzate al contatto di riserva, che viene selezionato in base alle i ruoli IAM. I nostri suggerimenti l'aggiunta di contatti personalizzati, senza fare affidamento su contatti di riserva, per garantire le persone corrette riceveranno le notifiche per il tuo progetto, la tua cartella dell'organizzazione.

Puoi aggiungere singoli e gruppi come contatti. Per ridurre l'impatto modifiche al personale, consigliamo di aggiungere gruppi come contatti, quindi di gestire i membri di questi gruppi per determinare chi riceverà le notifiche. Questo aiuta ad assicurare che le notifiche vengano sempre inviate ai dipendenti attivi.

Consulta la tabella seguente per scoprire di più sulle categorie di notifica. contatti di riserva e contatti consigliati. Se non si assegna un contatto a un categoria, le notifiche vengono inviate al contatto di riserva.

Categoria Descrizione Esempi Contatto di riserva Contatto consigliato
Tutti Tutte le notifiche di ogni categoria N/D N/D Persone o sistemi automatici responsabili dell'indirizzamento o registrare 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) Il personale del dipartimento finanziario e le persone che gestiscono le finanze rapporti con Google, tra cui chi gestisce i 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à, esperti delle relazioni con gli enti governativi 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, architect e engineer che possono trarre vantaggio da informazioni tempestive sulle modifiche ai prodotti e 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 che svolgono questo compito è salvaguardare i dati dell'azienda e dei clienti e garantire che continuità
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) Le persone immediatamente responsabili di mantenere la tua infrastruttura IT e di applicazioni aziendali operative
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, Reliability Engineer, amministratori, elenchi disponibili e altre persone che hanno bisogno di conoscere eventi tecnici attuali e imminenti per gestire meglio le tue risorse 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/D professionisti IT, Reliability Engineer, amministratori, elenchi disponibili e altre persone che devono 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, configura automaticamente la lingua preferita del contatto in base al contatto del creator impostazioni della lingua preferita. Quando aggiungi un contatto utilizzando l'API, configuri manualmente il lingua preferita usando un codice lingua. Il codice lingua può fare riferimento a uno qualsiasi le lingue supportate 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 risorsa Google Cloud della gerarchia. Come Se aggiungi un contatto a livello di organizzazione, quest'ultimo riceverà per l'organizzazione e per tutte le cartelle e i progetti dell'organizzazione. Analogamente, se aggiungi un contatto a livello di cartella, ricevere notifiche per la cartella e per tutte le cartelle e i progetti in .

La destinazione dell'assegnazione dei contatti dipende dalla struttura del tuo dell'organizzazione. Tuttavia, in genere consigliamo di assegnare i contatti seguenti livelli, in base alla categoria di notifica:

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

1 Il livello a cui assegni i contatti per la sicurezza dipende dalle le prassi di sicurezza specifiche di un'organizzazione. Ad esempio, se un singolo progetto sono responsabili della sicurezza dei propri progetti, assegneresti contatti per la sicurezza a livello di progetto. Tuttavia, se un gruppo a livello di organizzazione gestisce la sicurezza di tutti i progetti, assegneresti i tuoi contatti per la sicurezza a livello di organizzazione.

2 I contatti della categoria tecnica ricevono un numero elevato di email notifiche. Assegna questi contatti a livello di cartella o progetto per abilitarli per 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 i contatti che riceveranno l'interruzione del servizio e le notifiche di interruzione tramite la sottocategoria Incidenti tecnici. Questo ti consente di indirizzare notifiche di interruzione ad alto impatto ai contatti che devono per concentrarsi sulle interruzioni, senza la distrazione di altre notifiche tecniche.

Per assicurarti che le notifiche vengano inviate ai contatti appropriati, mantieni il seguente comportamento di ereditarietà quando si assegnano contatti al team Sottocategoria Incidenti:

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

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

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

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

  • Se un contatto per un incidente tecnico non viene assegnato o ereditato contatto assegnato, 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 dei criteri dell'organizzazione constraints/essentialcontacts.allowedContactDomains. Esistente contatti non sono interessati da questo vincolo.

Per scoprire come impostare 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 nella 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 una risorsa o elencare tutti i contatti e i contatti ereditati per una risorsa.

    Elenco dei contatti definiti su una risorsa

    Per visualizzare i contatti definiti in un progetto, una cartella o una cartella specifici organizzazione, utilizza la gcloud essential-contacts list :

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

    Sostituisci i seguenti valori:

    • RESOURCE_TYPE: il tipo di risorsa che vuoi elencare i contatti. Utilizza il valore project, folder oppure organization.
    • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

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

    La risposta è simile alla seguente:

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

    Elenco dei contatti e dei contatti ereditati

    Le risorse secondarie (cartelle e progetti) ereditano i contatti dai rispettivi predecessori (organizzazioni e altre cartelle). Se vuoi visualizzare un elenco di tutti i contatti contatti ereditati per una risorsa, utilizza 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 di categorie di notifiche per le quali vuoi calcolare i contatti. Elenco può contenere uno qualsiasi dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, technical-incidents e notification-category-unspecified. Scelta del valore di all elenchi in corso... contatti per tutte le categorie.
    • RESOURCE_TYPE: il tipo di risorsa che vuoi calcolare i contatti. Utilizza il valore project, folder oppure organization.
    • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

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

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

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

REST

Con l'API REST Essential Contacts, puoi elencare i contatti che sono definiti su una risorsa o elenca tutti i contatti e i contatti ereditati per risorsa.

Elenco dei contatti definiti su una risorsa

Per visualizzare i contatti definiti in un progetto, una cartella o una cartella specifici dell'organizzazione, utilizza la classe contacts.list dell'API Essential Contacts .

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

  • RESOURCE_TYPE: il tipo di risorsa che vuoi elencare i contatti. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, 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 contatti è maggiore della dimensione della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione in una risposta precedente di questo metodo. Se specificato, l'elenco contatti iniziano 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 rispettivi predecessori (organizzazioni e altre cartelle). Se vuoi visualizzare un elenco di tutti i contatti contatti ereditati per una risorsa, utilizza contacts.compute.

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

  • RESOURCE_TYPE: il tipo di risorsa che vuoi calcolare i contatti. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • NOTIFICATION_CATEGORY: le categorie di notifiche per le quali vuoi calcolare i contatti. Puoi ripetere per elencare i contatti per più categorie di notifica. La NOTIFICATION_CATEGORY può essere uno dei seguenti valori: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS e NOTIFICATION_CATEGORY_UNSPECIFIED. Scelta del valore di ALL elenchi in corso... 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 contatti è maggiore della dimensione della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il token di impaginazione in una risposta precedente di questo metodo. Se specificato, l'elenco contatti iniziano 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 alla 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 nella 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 la categorie di notifica in cui desideri che il contatto riceva le comunicazioni . Per un elenco di categorie di notifica e 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 di le categorie di notifica che il contatto deve ricevere. per 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. Scelta del valore di all elenchi in corso... contatti per tutte le categorie.

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

    • LANGUAGE: il codice lingua del contatto lingua preferita per le notifiche. Puoi includere il codice lingua di uno qualsiasi le lingue supportate.
    • RESOURCE_TYPE: il tipo di risorsa che vuoi creare un contatto. Utilizza il valore project, folder oppure organization.
    • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, 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 corrente.

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

REST

Per aggiungere un nuovo contatto, utilizza l'API Essential Contacts contacts.create.

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

  • RESOURCE_TYPE: il tipo di risorsa che vuoi creare un contatto. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, 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 vuoi che il contatto riceva le comunicazioni. Questo valore può essere qualsiasi di ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL TECHNICAL_INCIDENTS.

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

  • LANGUAGE: il codice lingua del contatto lingua preferita per le notifiche. Puoi includere il codice lingua di uno qualsiasi le 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 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 nella 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 a contatto di cui desideri modificare la categoria.

  5. Seleziona le categorie di notifica che desideri dalla Notifica categorie 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 gcloud Essentials-contacts comando 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 aggiornamento. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o organizzazione, elenca i tuoi contatti. L'ID numerico è la parte che segue contacts nel nome del contatto.
    • NOTIFICATION_CATEGORIES: un elenco separato da virgole di le nuove categorie di notifica che il contatto deve ricevere per le comunicazioni. Questo elenco sostituirà l'elenco esistente di notifiche categorie.

      L'elenco può contenere uno qualsiasi dei seguenti valori: all, billing, legal, product-updates, security, suspension, technical, incidenti-tecnici e notification-category-unspecified. Scelta del valore di all elenchi in corso... contatti per tutte le categorie.

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

    • LANGUAGE: il codice lingua del contatto lingua preferita per le notifiche. Puoi includere il codice lingua di uno qualsiasi le lingue supportate.
    • RESOURCE_TYPE: il tipo di risorsa a cui appartiene il contatto definita su. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del progetto Google Cloud. un'organizzazione o una cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerico, ad esempio 123456789012.

    Se non specifichi un ID e un tipo di risorsa, gcloud CLI aggiorna il contatto con l'ID specificato nel progetto corrente. Se non ci sono contatti con l'ID specificato esiste, 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 modello esistente usa l'API contacts.patch dell'API Essential Contacts .

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

  • RESOURCE_TYPE: il tipo di risorsa che vuoi elencare i contatti. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • CONTACT_ID: l'ID numerico del contatto che vuoi aggiornamento. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o organizzazione, elenca i tuoi contatti. L'ID numerico è la parte che segue contacts nel nome del contatto.
  • UPDATE_MASK: facoltativo. Una maschera che descrive quali campi del contatto che hai modificato. Il formato della maschera è separato da virgole elenco di nomi completi dei campi, ad esempio: notificationCategorySubscriptions,languageTag.
  • EMAIL: l'indirizzo email del tuo contatto. Questo campo deve corrispondere all'indirizzo email associato a CONTACT_ID che che includi nella richiesta.

  • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: facoltativo. La versione aggiornata categorie di notifica in cui desideri 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 di contatti consigliati per ogni categoria, vedi Identificazione dei contatti in questa pagina.

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

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 nella 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 a indirizzo email del contatto che vuoi eliminare. Quindi, nella finestra di dialogo, conferma in cui desideri 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 che vuoi eliminare. Per visualizzare gli ID di tutti i contatti nel progetto, nella cartella o organizzazione, elenca i tuoi contatti. L'ID numerico è la parte che segue contacts nel nome del contatto.
    • RESOURCE_TYPE: il tipo di risorsa a cui appartiene il contatto definita su. Utilizza il valore project, folder o organization.
    • RESOURCE_ID: l'ID del progetto Google Cloud. un'organizzazione o una cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerico, ad esempio 123456789012.

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

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

REST

Per eliminare un contatto, utilizza l'API Essential Contacts contacts.delete.

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

  • RESOURCE_TYPE: il tipo di risorsa che vuoi elencare i contatti. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • CONTACT_ID: l'ID numerico del contatto. Per vedere gli ID di tutti i contatti nel progetto, nella cartella o nell'organizzazione elencare 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 andando 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 scheda Essenziale pagina dei contatti

  2. Assicurati che il nome del progetto, della cartella o dell'organizzazione sia visualizzato nella 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 come 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 aggiungi un contatto descritto in questa pagina.

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

    • Per eliminare un contatto, fai clic su 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 il gli account email possano 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 scheda Essenziale pagina dei contatti

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

  3. Accanto a Visualizza per, seleziona Categoria.

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

  5. Seleziona le caselle di controllo accanto ai contatti a cui 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 gcp-essential-contacts-noreply@google.com.

Gestione dei contatti con Terraform

Puoi utilizzare Terraform per gestire i contatti di notifica. I contatti hanno seguente in 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 che vuoi elencare i contatti. Utilizza il valore projects, folders oppure organizations.
  • RESOURCE_ID: il tuo progetto Google Cloud, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, 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 per lingua preferita per le notifiche del contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

  • NOTIFICATION_CATEGORIES: un array della notifica categorie per cui il contatto deve ricevere 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 di contatti consigliati per ogni categoria, vedi Identificazione dei contatti in questa pagina.

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

Per ulteriori dettagli, consulta Documentazione di Terraform Essential Contacts.

Passaggi successivi