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 personalizzato.
Prima di iniziare
Attiva Essential Contacts 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 visualizzare i contatti:
Visualizzatore contatti necessari (
roles/essentialcontacts.viewer
) -
Per visualizzare, modificare, eliminare e creare contatti:
Amministratore contatti necessari (
roles/essentialcontacts.admin
)
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 governative e altri professionisti correlati |
Aggiornamenti di prodotto | Modifiche ai prodotti Google | Nuove versioni, aggiornamenti dei termini dei prodotti, deprecazioni | Proprietario progetto (roles/owner ) |
Product manager, 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 della tua azienda e dei tuoi 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 sono 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 |
Lingue supportate
In Contatti necessari, ogni contatto ha un'impostazione della 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 |
|
A livello di cartella/progetto |
|
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.
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
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Per elencare i contatti in base alla categoria, seleziona Categoria. Per elencare i contatti in ordine alfabetico, seleziona Contatti.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
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 valoreproject
,folder
oppureorganization
.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 esempio123456789012
.
In alternativa, se non specifichi un tipo di risorsa o un ID, L'interfaccia alla gcloud CLI i contatti per il progetto corrente.
La risposta è simile alla seguente:
--- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/1 notificationCategorySubscriptions: - ALL --- email: [email protected] 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
, enotification-category-unspecified
. Scelta del valore diall
elenchi in corso... contatti per tutte le categorie.RESOURCE_TYPE
: il tipo di risorsa che vuoi calcolare i contatti. Utilizza il valoreproject
,folder
oppureorganization
.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 esempio123456789012
.
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: [email protected] languageTag: en-US name: projects/my-projects/contacts/1 notificationCategorySubscriptions: - ALL --- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/2 notificationCategorySubscriptions: - BILLING --- email: [email protected] 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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.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": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en-US" }, { "name": "projects/my-projects/contacts/2", "email": "[email protected]", "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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.NOTIFICATION_CATEGORY
: le categorie di notifiche per le quali vuoi calcolare i contatti. Puoi ripetere per elencare i contatti per più categorie di notifica. LaNOTIFICATION_CATEGORY
può essere uno dei seguenti valori:ALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
,TECHNICAL
, eNOTIFICATION_CATEGORY_UNSPECIFIED
. Scelta del valore diALL
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": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en-US" }, { "name": "projects/my-projects/contacts/2", "email": "[email protected]", "notificationCategorySubscriptions": [ "BILLING" ], "languageTag": "en-US" }, { "name": "organizations/my-organization/contacts/1", "email": "[email protected]", "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
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Fai clic su
Aggiungi contatto.Nei campi Email e Conferma email, inserisci l'indirizzo email del contatto.
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.
Fai clic su Salva.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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 enotification-category-unspecified
. Scelta del valore diall
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 valoreproject
,folder
oppureorganization
.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 esempio123456789012
.
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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.EMAIL
: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.NOTIFICATION_CATEGORY_1
eNOTIFICATION_CATEGORY_2
: le categorie di notifica vuoi che il contatto riceva le comunicazioni. Questo valore può essere qualsiasi diALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
,TECHNICAL
.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": "[email protected]", "notificationCategorySubscriptions": [ "SUSPENSION", "TECHNICAL" ], "languageTag": "en" }
Modifica di un contatto
Per modificare le categorie a cui è assegnato un contatto, effettuare le seguenti operazioni:
Console
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Accanto a Visualizza per, seleziona Contatto.
Fai clic su .
accanto a contatto di cui desideri modificare la categoria.Seleziona le categorie di notifica che desideri dalla Notifica categorie e fai clic su Salva.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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 seguecontacts
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 enotification-category-unspecified
. Scelta del valore diall
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 valoreproject
,folder
oorganization
.RESOURCE_ID
: l'ID del progetto Google Cloud. un'organizzazione o una cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, comemy-project
. Gli ID cartella e organizzazione sono numerico, ad esempio123456789012
.
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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.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 seguecontacts
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
eNOTIFICATION_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
eTECHNICAL
.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": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en" }
Eliminazione di un contatto
Per eliminare un contatto:
Console
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Accanto a Visualizza per, seleziona Contatto.
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
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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 seguecontacts
nel nome del contatto.RESOURCE_TYPE
: il tipo di risorsa a cui appartiene il contatto definita su. Utilizza il valoreproject
,folder
oorganization
.RESOURCE_ID
: l'ID del progetto Google Cloud. un'organizzazione o una cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, comemy-project
. Gli ID cartella e organizzazione sono numerico, ad esempio123456789012
.
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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.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: segui questi passaggi:
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Accanto a Visualizza per, seleziona Categoria.
Fai clic su .
nella stessa riga come categoria di cui vuoi gestire i contatti.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:
Nella console Google Cloud, vai alla pagina Contatti necessari.
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.
Accanto a Visualizza per, seleziona Categoria.
Fai clic su .
nella stessa riga della categoria a cui vuoi inviare le email di prova.Seleziona le caselle di controllo accanto ai contatti a cui desideri inviare le email.
Fai clic su Invia. Un'email di prova viene inviata ai contatti selezionati.
Comunica con ogni contatto per assicurarti che abbia ricevuto un'email di prova [email protected].
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 valoreprojects
,folders
oppureorganizations
.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 esempio123456789012
.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
eTECHNICAL
.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
- Scopri come associare un dominio a un progetto per ai fini della verifica.
- Scopri come gestire le preferenze di notifica.