Diese Seite wurde von der Cloud Translation API übersetzt.

Kontakte für Benachrichtigungen verwalten

Bei vielen Google Cloud-Angeboten wie Cloud Billing werden Benachrichtigungen wichtige Informationen mit Google Cloud-Nutzern zu teilen. Standardmäßig werden diese Benachrichtigungen an Mitglieder mit bestimmten IAM-Rollen (Identity and Access Management) gesendet. Mit „Wichtige Kontakte“ können Sie anpassen, wer Benachrichtigungen erhält. Stellen Sie dazu eine eigene Liste von Kontakten bereit.

Hinweise

Essential Contacts API aktivieren.

Aktivieren Sie die API

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Verwalten von Kontakten benötigen, bitten Sie Ihren Administrator, Ihnen folgenden IAM-Rollen auf Projekt, Ordner oder Organisation, dem bzw. der der Kontakt zugewiesen ist :

So rufen Sie Kontakte auf: Betrachter wichtiger Kontakte (roles/essentialcontacts.viewer)
So können Sie Kontakte anzeigen, bearbeiten, löschen und erstellen: Administrator wichtiger Kontakte (roles/essentialcontacts.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierten Rollen enthalten Berechtigungen zum Verwalten von Kontakten Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Kontakte zu verwalten:

So rufen Sie Kontakte auf: <ph type="x-smartling-placeholder">
- essentialcontacts.contacts.get
- essentialcontacts.contacts.list
So bearbeiten, löschen und erstellen Sie Kontakte: <ph type="x-smartling-placeholder">
- essentialcontacts.contacts.create
- essentialcontacts.contacts.delete
- essentialcontcts.contacts.update

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Benachrichtigungskategorien

Sie können Kontakte mehreren Benachrichtigungskategorien zuweisen. Wenn Sie kein an eine Kategorie wenden, werden Benachrichtigungen an den Fallback-Kontakt gesendet, das basierend auf den IAM-Rollen Wir empfehlen, benutzerdefinierte Kontakte hinzufügen und sich nicht auf Fallback-Kontakte verlassen, erhalten die richtigen Personen Benachrichtigungen für Ihr Projekt, Ihren Ordner oder Unternehmen.

Sie können sowohl Einzelpersonen als auch Gruppen als Kontakte hinzufügen. Um die Auswirkungen von Personaländerungen haben, empfehlen wir, Gruppen als Kontakte hinzuzufügen und dann die Mitgliedschaft dieser Gruppen festzulegen, um zu bestimmen, wer Benachrichtigungen erhält. Dieses trägt dazu bei, dass Benachrichtigungen immer an aktive Mitarbeitende gehen.

In der folgenden Tabelle finden Sie Informationen zu Benachrichtigungskategorien, Fallback-Kontakte und empfohlene Kontakte. Wenn Sie einem Kontakt werden Benachrichtigungen an den Fallback-Kontakt gesendet.

Kategorie	Beschreibung	Beispiele	Fallback-Kontakt	Empfohlener Kontakt
Alle	Alle Benachrichtigungen aus jeder anderen Kategorie	–	–	Personen oder automatisierte Systeme, die für die Routenplanung oder Protokollieren einer potenziell großen Anzahl von Benachrichtigungen
Abrechnung	Abrechnungs- und Zahlungsbenachrichtigungen	Preisaktualisierungen, Fehler und Gutschriften	Rechnungskontoadministrator (`roles/billing.admin`)	Mitarbeiter der Finanzabteilung und Personen, die Ihre finanzielle Beziehung zu Google verwalten, einschließlich Personen, die Budgets, Planungen und Konten im Zusammenhang mit der Nutzung der Google Cloud verwalten
Recht	Benachrichtigungen zur Einhaltung rechtlicher Vorgaben	Erzwingungsmaßnahmen, gesetzliche Vorschriften, behördliche Bekanntmachungen	Rechnungskontoadministrator (`roles/billing.admin`)	Rechtsberatung, Compliance-Manager, Experten in Regierungsfragen und andere Fachleute
Produktupdates	Änderungen an Google-Produkten	Neue Versionen, Aktualisierungen der Produktbedingungen, Einstellungen	Projektinhaber (`roles/owner`)	Produktmanager, Architekten und Entwickler, die von zeitnahen Informationen über Änderungen an Google-Produkten und -Diensten profitieren können
Sicherheit	Benachrichtigungen zu Sicherheits-/Datenschutzproblemen	Sicherheitslücken, Datenvorfälle und Angriffe	Administrator der Organisation (`roles/resourcemanager.organizationAdmin`)	IT-Sicherheit, Betriebssicherheit und andere Personen, deren Aufgabe es ist, Ihre Unternehmens- und Kundendaten zu schützen und die Geschäftskontinuität zu gewährleisten
Sperrung	Benachrichtigungen zur sofortigen Sperrung von Konten und Projekten	Apigee-Bewertungscompliance, Urheberrechtsverletzungen und Mining von Münzen	Projektinhaber (`roles/owner`)	Personen, die unmittelbar dafür verantwortlich sind, dass Ihre IT-Infrastruktur und Geschäftsanwendungen funktionsfähig sind
Technisch	Technische Veranstaltungen und andere betriebliche Probleme	Konfigurationsfehler für Logging, Updates zum Schutz vor Datenverlust und Status von Actions on Google	Projektinhaber (`roles/owner`)	IT-Fachleute, Reliability Engineers, Administratoren, Bereitschaftslisten und andere Personen, die über aktuelle und anstehende technische Ereignisse informiert werden müssen und Probleme, um IT-Assets besser zu verwalten und Störungen zu vermeiden

Unterstützte Sprachen

Unter „Wichtige Kontakte“ hat jeder Kontakt eine bevorzugte Spracheinstellung. Ersteller von Benachrichtigungen können diese Einstellung beim Senden von Benachrichtigungen verwenden.

Wenn Sie einen Kontakt in der Google Cloud Console hinzufügen, konfiguriert automatisch die bevorzugte Sprache des Kontakts, des Creators Einstellungen für die bevorzugte Sprache. Wenn Sie einen Kontakt über die API hinzufügen, konfigurieren Sie die bevorzugte Sprache des Kontakts mit einem Sprachcode manuell. Der Sprachcode kann sich auf alle Sprachen beziehen, die von „Wichtige Kontakte“ unterstützt werden.

Unterstützte Sprachen

Sprache	Sprachcode
Afrikaans	af
Albanisch	sq
Amharisch	am
Arabisch	ar
Arabisch (Ägypten)	ar-EG
Armenisch	hy
Aserbaidschanisch	az
Baskisch	eu
Belarussisch	be
Bengalisch	bn
Bosnisch	bs
Bulgarisch	bg
Burmesisch	my
Katalanisch	ca
Chinesisch	zh
Chinesisch (Hongkong)	zh-HK
Chinesisch (Taiwan)	zh-TW
Kroatisch	hr
Tschechisch	cs
Dänisch	da
Niederländisch	nl
Englisch	en
Englisch (Australien)	en-AU
Englisch (Vereinigtes Königreich)	en-GB
Englisch (USA)	en-US
Estnisch	et
Filipino	fil
Finnisch	fi
Französisch	fr
Französisch (Kanada)	fr-CA
Galicisch	gl
Deutsch	de
Georgisch	ka
Griechisch	el
Gujarati	gu
Hebräisch	iw
Hindi	hi
Ungarisch	hu
Isländisch	ist
Indonesisch	id
Irisch	ga
Italienisch	it
Japanisch	ja
Javanisch	jv
Kannada	kn
Kasachisch	kk
Khmer	km
Koreanisch	ko
Kirgisisch	ky
Laotisch	lo
Lettisch	lv
Litauisch	lt
Mazedonisch	mk
Malaiisch	ms
Malajaman	ml
Marathi	mr
Mongolisch	mn
Nepalesisch	ne
Norwegisch	no
Paschtunisch	ps
Persisch	fa
Polnisch	pl
Portugiesisch	pt
Portugiesisch (Brasilien)	pt-BR
Portugiesisch (Portugal)	pt-PT
Panjabi	pa
Rumänisch	ro
Russisch	ru
Serbisch	sr
Sindhi	sd
Singhalesisch	si
Slowakisch	sk
Slowenisch	sl
Somali	so
Spanisch	es
Spanisch (Lateinamerika)	es-419
Swahili	sw
Schwedisch	sv
Tamilisch	ta
Telugu	te
Thai	th
Türkisch	tr
Turkmenisch	tk
Ukrainisch	uk
Urdu	ur
Usbekisch	uz
Vietnamesisch	vi
Walisisch	cy
Zulu	zu

Best Practices für das Zuweisen von Kontakten

Sie können Kontakte auf Projekt-, Ordner- oder Organisationsebene zuweisen.

Kontakte werden über die Google Cloud-Ressourcenhierarchie übernommen. Wenn Sie also einen Kontakt auf Organisationsebene hinzufügen, erhält er Benachrichtigungen für die Organisation und für alle Ordner und Projekte in der Organisation. Wenn Sie einen Kontakt auf Ordnerebene hinzufügen, erhält er Benachrichtigungen für den entsprechenden Ordner und für alle Ordner und Projekte in diesem Ordner.

Wo Sie Kontakte zuweisen, hängt von der Struktur Ihres Unternehmens ab. Wir empfehlen in der Regel, Kontakte je nach Benachrichtigungskategorie auf folgenden Ebenen zuzuweisen:

Empfohlene Ebene	Benachrichtigungskategorie
Organisationsebene	Abrechnung Rechtsabteilung Sicherheit¹
Ordner-/Projektebene	Alle Produktaktualisierungen Sicherheit¹ Sperrung Technisch²

¹ Auf welcher Ebene Sie Sicherheitskontakte zuweisen, hängt von Ihren Sicherheitspraktiken des Unternehmens. Wenn beispielsweise einzelne Projekte für die Sicherheit ihrer eigenen Projekte verantwortlich ist, auf Projektebene eingerichtet haben. Wenn eine organisationsweite Gruppe die Sicherheit für alle Projekte verwaltet, weisen Sie Ihre Sicherheitskontakte unter auf Organisationsebene.

² Kontakte der Kategorie „Technisch“ erhalten sehr viele E-Mails Benachrichtigungen. Weisen Sie diese Kontakte auf Ordner- oder Projektebene zu, um um eingehende Benachrichtigungen zu verarbeiten.

Zulässige Domains für Kontakte einschränken

Um die Domains von E-Mail-Adressen einzuschränken, die neue Kontakte haben können, lege die Einschränkung der Organisationsrichtlinie constraints/essentialcontacts.allowedContactDomains Vorhanden Kontakte sind von dieser Einschränkung nicht betroffen.

Informationen zum Festlegen von Einschränkungen für Organisationsrichtlinien finden Sie unter Einschränkungen für Organisationsrichtlinien:

Kontakte auflisten

So listen Sie alle Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auf:

Console

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie, Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Um die Kontakte nach Kategorie aufzulisten, wählen Sie Kategorie aus. Wählen Sie Kontakte aus, um die Kontakte alphabetisch aufzulisten.
Hinweis: Wenn Sie Kontakte für eine untergeordnete Ressource (Ordner oder Projekt) aufrufen, die Kontakte von ihren Ancestors (Organisationen oder andere Ordner) übernimmt, sehen Sie die übernommenen Kontakte für alle Ancestors, für die Sie die Berechtigung zum Anzeigen der Kontakte haben.
Hinweis: Wenn Sie Kontakte für eine Organisation oder einen Ordner aufrufen, sehen Sie keine Kontakte für ihre untergeordneten Ressourcen.

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Mit der Google Cloud CLI können Sie entweder die Kontakte auflisten, die in oder alle Kontakte und übernommenen Kontakte für eine Ressource auflisten.
Für eine Ressource definierte Kontakte auflisten

So rufen Sie die Kontakte auf, die in einem bestimmten Projekt, Ordner oder Organisation, verwenden Sie die gcloud essential-contacts list Befehl:
```
gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"
```
Ersetzen Sie die folgenden Werte:
- RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert project, folder oder organization.
- RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
Wenn Sie keinen Ressourcentyp und keine ID angeben, Die gcloud CLI listet Kontakte für das aktuelle Projekt auf.

Die Antwort ähnelt dem folgenden Beispiel.
```
---
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
---
```
Kontakte und übernommene Kontakte auflisten

Untergeordnete Ressourcen (Ordner und Projekte) übernehmen Kontakte von ihren Ancestors (Organisationen und anderen Ordnern). Wenn Sie alle Kontakte und für eine Ressource übernommene Kontakte, verwenden Sie gcloud essential-contacts compute-Befehl:

Hinweis: Es werden nur Kontakte angezeigt, die vom Ancestor einer Ressource übernommen wurden, wenn Sie Kontakte für den Ancestor anzeigen können. Dafür benötigen Sie eine Rolle Den Ancestor, der die erforderlichen Berechtigungen enthält, z. B. als Rolle „Betrachter wichtiger Kontakte“ (roles/essentialcontacts.viewer).
```
gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \
  --RESOURCE_TYPE="RESOURCE_ID"
```
.
Ersetzen Sie die folgenden Werte:

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:
- NOTIFICATION_CATEGORIES: eine durch Kommas getrennte Liste der Kategorien von Benachrichtigungen, für die Sie Kontakte berechnen möchten. Die Liste kann einen der folgenden Werte enthalten: all, billing, legal, product-updates, security, suspension, technical, und notification-category-unspecified. Wert von all Listen auswählen Kontakte für alle Kategorien.
- RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte berechnen möchten. Verwenden Sie den Wert project, folder oder organization.
- RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
Wenn Sie keinen Ressourcentyp und keine ID angeben, gibt die gcloud CLI listet Kontakte für das aktuelle Projekt auf.

In der Antwort werden alle Kontakte und übernommenen Kontakte für die Ressource aufgelistet:
```
---
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

Mit der Essential Contacts REST API können Sie entweder die Kontakte auflisten, für eine Ressource definiert oder alle Kontakte und übernommenen Kontakte für eine .

Für eine Ressource definierte Kontakte auflisten

So rufen Sie die Kontakte auf, die in einem bestimmten Projekt, Ordner oder Organisation, verwenden Sie die Essential Contacts API contacts.list .

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
PAGE_SIZE: Optional. Die Anzahl der Kontakte, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 100. Wenn die Anzahl der Kontakte die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
NEXT_PAGE_TOKEN: Optional. Das Paginierungstoken, das in einer früheren Antwort von dieser Methode zurückgegeben wurde. Wenn angegeben, beginnt die Liste der Kontakte an der Stelle, an der die vorherige Antwort beendet wurde.

Anfrage:

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

Nach dem Senden der Anfrage erhalten Sie eine JSON-Antwort ähnlich der folgenden:

{
  "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"
    }
  ]
}

Kontakte und übernommene Kontakte auflisten

Untergeordnete Ressourcen (Ordner und Projekte) übernehmen Kontakte von ihren Ancestors (Organisationen und anderen Ordnern). Wenn Sie alle Kontakte und übernommenen Kontakte für eine Ressource auflisten möchten, verwenden Sie die Methode contacts.compute der Essential Contacts API.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte berechnen möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
NOTIFICATION_CATEGORY: Die Benachrichtigungskategorien, für die Kontakte berechnet werden sollen. Sie können dieses Feld wiederholen, um Kontakte für mehrere Benachrichtigungskategorien aufzulisten. Die NOTIFICATION_CATEGORY kann Folgendes sein: Werte: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL und NOTIFICATION_CATEGORY_UNSPECIFIED. Wert von ALL Listen auswählen Kontakte für alle Kategorien.
PAGE_SIZE: Optional. Die Anzahl der Kontakte, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 100. Wenn die Anzahl der Kontakte die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
NEXT_PAGE_TOKEN: Optional. Das Paginierungstoken, das in einer früheren Antwort von dieser Methode zurückgegeben wurde. Wenn angegeben, beginnt die Liste der Kontakte an der Stelle, an der die vorherige Antwort beendet wurde.

Anfrage:

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

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)

Führen Sie folgenden Befehl aus:

$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

In der Antwort werden alle Kontakte und übernommenen Kontakte für die Ressource aufgelistet:

{
  "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"
    }
  ]
}

Einzelne wichtige Kontakte verwalten

Du kannst Kontakte hinzufügen, entfernen oder ihnen Benachrichtigungskategorien zuweisen auf der Seite Wichtige Kontakte in der Google Cloud Console oder über der REST API.

Kontakte hinzufügen

So fügen Sie einen Kontakt hinzu:

Console

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie, Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Klicken Sie auf Kontakt hinzufügen.
Geben Sie die E-Mail-Adresse des Kontakts in die Felder E-Mail und E-Mail bestätigen ein.
Wählen Sie im Drop-down-Menü Benachrichtigungskategorien die Benachrichtigungskategorien aus, für die der Kontakt Benachrichtigungen erhalten soll. Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie auf dieser Seite unter Kontakte identifizieren.
Klicken Sie auf Speichern.

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Verwenden Sie zum Hinzufügen eines neuen Kontakts die gcloud required-contacts create:
```
gcloud essential-contacts create --email="EMAIL" \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE" \
    --RESOURCE_TYPE="RESOURCE_ID"
```
Ersetzen Sie die folgenden Werte:
- EMAIL: Die E-Mail-Adresse Ihres Kontakts. Sie können nicht ändern Sie dieses Feld, nachdem Sie den Kontakt erstellt haben.
- NOTIFICATION_CATEGORIES: eine durch Kommas getrennte Liste der Die Benachrichtigungskategorien, die der Kontakt erhalten soll für die Kommunikation. Die Liste kann einen der folgenden Werte enthalten: all, billing, legal, product-updates security, suspension, technical technische Vorfälle und notification-category-unspecified. Wert von all Listen auswählen Kontakte für alle Kategorien.
  Eine Liste empfohlener Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren
- LANGUAGE: der Sprachcode für die Sprache deines Kontakts bevorzugte Benachrichtigungssprache. Sie können den Sprachcode einer der folgenden Sprachen angeben: den unterstützten Sprachen.
- RESOURCE_TYPE: Der Ressourcentyp, den Sie verwenden möchten einen Kontakt erstellen. Verwenden Sie den Wert project, folder oder organization
- RESOURCE_ID: Ihr Google Cloud-Projekt Organisations- oder Ordner-ID. Projekt-IDs sind alphanumerische Strings wie my-project Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
Wenn Sie keinen Ressourcentyp und keine ID angeben, gibt die gcloud CLI erstellt einen Kontakt im aktuellen Projekt.

Wenn der Befehl erfolgreich ausgeführt wurde, wird keine Antwort zurückgegeben.

REST

Verwenden Sie zum Hinzufügen eines neuen Kontakts die Methode contacts.create der Essential Contacts API.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, den Sie verwenden möchten einen Kontakt erstellen. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
EMAIL: Die E-Mail-Adresse Ihres Kontakts. Sie können dieses Feld nicht mehr ändern, nachdem Sie den Kontakt erstellt haben.
NOTIFICATION_CATEGORY_1 und NOTIFICATION_CATEGORY_2: Die Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Folgende Werte sind möglich: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION und TECHNICAL.

Eine Liste der empfohlenen Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren auf dieser Seite.
LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache Ihres Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

Anfrage:

POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts

Anfragetext:

{
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts" | Select-Object -Expand Content

Nach dem Senden der Anfrage erhalten Sie eine JSON-Antwort ähnlich der folgenden:

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

Kontakt ändern

So ändern Sie die Kategorien, denen ein Kontakt zugewiesen ist:

Console

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie, Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kontakt aus.
Klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf .
Wählen Sie die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Verwenden Sie zum Aktualisieren eines vorhandenen Kontakts die Methode gcloud required-contacts. update verwenden:
```
gcloud essential-contacts update CONTACT_ID \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE"
    --RESOURCE_TYPE="RESOURCE_ID"
```
Ersetzen Sie die folgenden Werte:
- CONTACT_ID: Die numerische ID des Kontakts, den Sie verknüpfen möchten. aktualisieren. Um die IDs aller Kontakte in Ihrem Projekt, Ihrem Ordner oder Organisation: Listen Sie Ihre Kontakte auf. Die numerische ID entspricht allem, contacts im Namen des Kontakts.
- NOTIFICATION_CATEGORIES: eine durch Kommas getrennte Liste der die neuen Benachrichtigungskategorien, die der Kontakt erhalten soll, für die Kommunikation. Diese Liste ersetzt die bestehende Liste der Benachrichtigungen. Kategorien.
  Die Liste kann einen der folgenden Werte enthalten: all, billing, legal, product-updates, security, suspension, technical, technische Vorfälle und notification-category-unspecified. Wert von all Listen auswählen Kontakte für alle Kategorien.
  
  Eine Liste empfohlener Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren
- LANGUAGE: der Sprachcode für die Sprache deines Kontakts bevorzugte Benachrichtigungssprache. Sie können den Sprachcode einer der folgenden Sprachen angeben: den unterstützten Sprachen.
- RESOURCE_TYPE: Der Ressourcentyp des Kontakts definiert haben. Verwenden Sie den Wert project, folder oder organization.
- RESOURCE_ID: Die ID des Google Cloud-Projekts. Organisation oder Ordner, in dem der Kontakt definiert ist. Projekt-IDs sind alphanumerische Strings wie my-project. Ordner- und Organisations-IDs sind numerisch, wie 123456789012.
Wenn Sie keinen Ressourcentyp und keine ID angeben, gibt die gcloud CLI aktualisiert den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID existiert, gibt die gcloud CLI einen Fehler zurück.

Wenn der Befehl erfolgreich ausgeführt wurde, wird keine Antwort zurückgegeben.

REST

Verwenden Sie die Methode contacts.patch der Essential Contacts API, um die Benachrichtigungsabos oder die bevorzugte Sprache eines vorhandenen Kontakts zu ändern.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
CONTACT_ID: Die numerische ID des Kontakts, den Sie verknüpfen möchten. aktualisieren. Um die IDs aller Kontakte in Ihrem Projekt, Ihrem Ordner oder Organisation: Listen Sie Ihre Kontakte auf. Die numerische ID entspricht allem, contacts im Namen des Kontakts.
UPDATE_MASK: Optional. Eine Maske, die angibt, welche Felder des Kontakts Sie geändert haben. Das Format für die Maske ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: notificationCategorySubscriptions,languageTag.
EMAIL: Die E-Mail-Adresse Ihres Kontakts. Dieses Feld muss mit der E-Mail-Adresse übereinstimmen, die mit der Anfrage in CONTACT_ID verknüpft ist.
NOTIFICATION_CATEGORY_1 und NOTIFICATION_CATEGORY_2: Optional. Die aktualisierten Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Folgende Werte sind möglich: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION und TECHNICAL.

Eine Liste der empfohlenen Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren auf dieser Seite.
LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache des Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

Anfrage:

PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

Anfragetext:

{
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"" | Select-Object -Expand Content

Nach dem Senden der Anfrage erhalten Sie eine JSON-Antwort ähnlich der folgenden:

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

Kontakt löschen

So löschen Sie einen Kontakt:

Console

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie, Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kontakt aus.
neben dem E-Mail-Adresse des Kontakts, den Sie löschen möchten. Bestätigen Sie dann im Dialogfeld den Sie löschen möchten.

gcloud

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Um einen Kontakt zu löschen, verwenden Sie den gcloud required-contacts delete:
```
gcloud essential-contacts delete CONTACT_ID \
    --RESOURCE_TYPE="RESOURCE_ID"
```
Ersetzen Sie die folgenden Werte:
- CONTACT_ID: Die numerische ID des Kontakts, den Sie verknüpfen möchten. Löschen. Um die IDs aller Kontakte in Ihrem Projekt, Ihrem Ordner oder Organisation: Listen Sie Ihre Kontakte auf. Die numerische ID entspricht allem, contacts im Namen des Kontakts.
- RESOURCE_TYPE: Der Ressourcentyp des Kontakts definiert haben. Verwenden Sie den Wert project, folder oder organization.
- RESOURCE_ID: Die ID des Google Cloud-Projekts. Organisation oder Ordner, in dem der Kontakt definiert ist. Projekt-IDs sind alphanumerische Strings wie my-project. Ordner- und Organisations-IDs sind numerisch, wie 123456789012.
Wenn Sie keinen Ressourcentyp und keine ID angeben, gibt die gcloud CLI Löscht den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID existiert, gibt die gcloud CLI einen Fehler zurück.

Wenn der Befehl erfolgreich ausgeführt wurde, wird keine Antwort zurückgegeben.

REST

Verwenden Sie die Methode contacts.delete der App „Wichtige Kontakte“, um einen Kontakt zu löschen.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
CONTACT_ID: Die numerische ID Ihres Kontakts. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auflisten möchten, listen Sie Ihre Kontakte auf.

Anfrage:

DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, ist der Antworttext leer.

Kontakte nach Kategorie verwalten

In der Google Cloud Console können Sie Kontakte auch nach Kategorie verwalten, indem Sie Öffnen Sie auf der Seite Wichtige Kontakte den Tab Kategorie.

Führen Sie folgende Schritte aus, um die einer einzelnen Kategorie zugewiesenen Kontakte hinzuzufügen, zu ändern oder zu löschen:

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie, Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kategorie aus.
Klicken Sie in der Zeile, in der Sie die Kontakte verwalten möchten, auf .
So verwalten Sie die Kontakte, die der Kategorie zugewiesen sind:
- Klicken Sie zum Hinzufügen eines neuen Kontakts auf Kontakt hinzufügen und folgen Sie den Schritten zum Hinzufügen eines Kontakts, die auf dieser Seite beschrieben werden.
- Zum Ändern der Kategorie, der ein Kontakt zugewiesen ist, klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf . Wählen Sie dann die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.
  
  Hinweis: Die E-Mail-Adresse eines Kontakts kann nicht geändert werden. Sie können eine E-Mail-Adresse ändern. Fügen Sie dazu einen neuen Kontakt mit der aktualisierten E-Mail-Adresse hinzu und löschen Sie den alten Kontakt.
- Wenn Sie einen Kontakt löschen möchten, klicken Sie neben der E-Mail-Adresse des Kontakts auf .

E-Mail-Übertragungen prüfen

Sie können eine Test-E-Mail an Kontakte in jeder Kategorie senden, um zu prüfen, ob die E-Mail-Konten können E-Mails von Google Cloud empfangen werden.

So senden Sie eine Test-E-Mail an Kontakte in einer bestimmten Kategorie:

Rufen Sie in der Google Cloud Console die Seite Wichtige Kontakte auf.

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ordners oder Ihrer Organisation im Ressourcenauswahl oben auf der Seite. In der Ressourcenauswahl sehen Sie Projekt, Ordner oder Organisation, für das bzw. die Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kategorie aus.
in derselben Zeile als Kategorie, an deren Kontakte Sie Test-E-Mails senden möchten.
Aktivieren Sie die Kontrollkästchen neben den Kontakten, an die Sie E-Mails senden möchten.
Klicken Sie auf Senden. An die ausgewählten Kontakte wird eine Test-E-Mail gesendet.

Hinweis :Sie können alle 24 Stunden maximal eine Test-E-Mail an jeden Kontakt senden. pro Kategorie und Ressource.
Kommunizieren Sie mit jedem Kontakt, um sicherzustellen, dass dieser eine Test-E-Mail von gcp-essential-contacts-noreply@google.com.

Kontakte mit Terraform verwalten

Mit Terraform können Sie Ihre Benachrichtigungskontakte verwalten. Kontakte haben die im folgenden Format in der Terraform-Sprache:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

Ersetzen Sie beim Erstellen eines Kontakts die folgenden Werte:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
EMAIL: Die E-Mail-Adresse Ihres Kontakts. Sie können dieses Feld nicht mehr ändern, nachdem Sie den Kontakt erstellt haben.
LANGUAGE: Optional. Der Sprachcode für die bevorzugte Benachrichtigungssprache des Kontakts. Sie können den Sprachcode aller unterstützten Sprachen.
NOTIFICATION_CATEGORIES: ein Array der Benachrichtigung Kategorien, für die der Kontakt Benachrichtigungen erhalten soll. Beispiel: ["BILLING", "LEGAL"]

Dieses Array kann einen der folgenden Werte enthalten: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION und TECHNICAL.

Eine Liste der empfohlenen Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren auf dieser Seite.

Kontaktressourcen hinzufügen, ändern oder entfernen und Kontaktressource hinzufügen, ändern oder entfernen in der Terraform-Konfigurationsdatei.

Weitere Informationen finden Sie in der Dokumentation zu wichtigen Terraform-Kontakten

Nächste Schritte

Weitere Informationen zum Verknüpfen einer Domain mit einem Projekt zu Verifizierungszwecken.
Weitere Informationen zum Verwalten Ihrer Benachrichtigungseinstellungen.