Kontakte für Benachrichtigungen verwalten

Bei vielen Google Cloud-Angeboten wie Cloud Billing werden Benachrichtigungen gesendet, um wichtige Informationen an Google Cloud-Nutzer weiterzugeben. 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

Bitten Sie Ihren Administrator, Ihnen für das Projekt, den Ordner oder die Organisation, dem bzw. der der Kontakt zugewiesen ist, die folgenden IAM-Rollen zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Verwalten von Kontakten benötigen:

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

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

Erforderliche Berechtigungen

Zum Verwalten von Kontakten sind die folgenden Berechtigungen erforderlich:

  • So rufen Sie Kontakte auf:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • So bearbeiten, löschen und erstellen Sie Kontakte:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontcts.contacts.update

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

Benachrichtigungskategorien

Sie können Kontakte mehreren Benachrichtigungskategorien zuweisen. Wenn Sie einer Kategorie keinen Kontakt hinzufügen, werden Benachrichtigungen in dieser Kategorie an den Fallback-Kontakt gesendet, der anhand der IAM-Rollen Ihrer Mitglieder ausgewählt wird. Wir empfehlen, benutzerdefinierte Kontakte hinzuzufügen und sich nicht auf Fallback-Kontakte zu verlassen, damit die richtigen Personen Benachrichtigungen für Ihr Projekt, Ihren Ordner oder Ihre Organisation erhalten.

Sie können sowohl Einzelpersonen als auch Gruppen als Kontakte hinzufügen. Um die Auswirkungen von Personaländerungen zu reduzieren, empfehlen wir, Gruppen als Kontakte hinzuzufügen und dann die Mitgliedschaft dieser Gruppen zu verwalten, um zu bestimmen, wer Benachrichtigungen erhält. Mit dieser Vorgehensweise wird sichergestellt, dass Benachrichtigungen immer an aktive Mitarbeiter gesendet werden.

In der folgenden Tabelle finden Sie Informationen zu Benachrichtigungskategorien, Fallback-Kontakten und empfohlenen Kontakten. Wenn Sie einer bestimmten Kategorie keinen Kontakt zuweisen, 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 das Routing oder Logging einer potenziell großen Anzahl von Benachrichtigungen zuständig sind
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
Rechtliches 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
Technologie 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-Experten, Reliability Engineers, Administratoren, Bereitschaftslisten und andere Personen, die über aktuelle und bevorstehende technische Ereignisse und Probleme informiert werden müssen, um Ihre IT-Assets besser verwalten und Unterbrechungen zu vermeiden
Technische Vorfälle Für Premium-Support-Kunden eine Unterkategorie der Kategorie „Technisch“ für Ausfallbenachrichtigungen Ungeplante Ausfälle, Dienstprobleme – IT-Experten, Reliability Engineers, Administratoren, Bereitschaftslisten und andere Personen, die auf Ausfälle reagieren müssen

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 du in der Google Cloud Console einen Kontakt hinzufügst, wird in der Google Cloud Console automatisch die bevorzugte Sprache des Kontakts basierend auf den bevorzugten Spracheinstellungen des Erstellers konfiguriert. 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.

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
  • Sicherheit1
Ordner-/Projektebene
  • Alle
  • Produktaktualisierungen
  • Sicherheit1
  • Sperrung
  • Technisch2

1 Auf welcher Ebene Sie Sicherheitskontakte zuweisen, hängt von den spezifischen Sicherheitspraktiken Ihrer Organisation ab. Wenn beispielsweise einzelne Projektinhaber für die Sicherheit ihrer eigenen Projekte verantwortlich sind, weisen Sie Ihre Sicherheitskontakte auf Projektebene zu. Wenn jedoch eine organisationsweite Gruppe die Sicherheit für alle Projekte verwaltet, weisen Sie Ihre Sicherheitskontakte auf Organisationsebene zu.

2 Kontakte der technischen Kategorie erhalten eine große Anzahl von E-Mail-Benachrichtigungen. Weisen Sie diese Kontakte auf Ordner- oder Projektebene zu, damit sie eingehende Benachrichtigungen verarbeiten können.

Kontakte für Benachrichtigungen zu Ausfällen und Unterbrechungen zuweisen

Als Premium-Support-Kunde können Sie in der Unterkategorie „Technische Vorfälle“ Kontakte zuweisen, die Ausfall- und Störungsbenachrichtigungen erhalten sollen. So können Sie wichtige Ausfallbenachrichtigungen an Kontakte lenken, die sich auf Ausfälle konzentrieren müssen, ohne von anderen technischen Benachrichtigungen abgelenkt zu werden.

Damit Benachrichtigungen an die entsprechenden Kontakte gesendet werden, sollten Sie beim Zuweisen von Kontakten der Unterkategorie „Technische Vorfälle“ folgendes Verhalten bei der Übernahme beachten:

  • Wenn Sie in einem Projekt oder Ordner einen Kontakt für technische Vorfälle zuweisen, werden Ausfallbenachrichtigungen nur an folgende Adressen gesendet:

    • Der Ansprechpartner für das Projekt oder den Ordner Technische Vorfälle
    • Übernommene Kontakte für Technische Vorfälle von der übergeordneten Organisation oder dem übergeordneten Ordner

  • Wenn Sie in einem Projekt oder Ordner keinen Kontakt für technische Vorfälle zuweisen, werden Ausfallbenachrichtigungen nur an folgende Adressen gesendet:

    • Technischer Ansprechpartner für das Projekt oder den Ordner
    • Übernommene Kontakte für Technische Vorfälle von der übergeordneten Organisation oder dem übergeordneten Ordner

  • Wenn kein Kontakt für einen technischen Vorfall zugewiesen oder übernommen wurde und kein technischer Kontakt zugewiesen ist, werden keine Ausfallbenachrichtigungen gesendet.

Zulässige Domains für Kontakte einschränken

Wenn Sie die Domains von E-Mail-Adressen einschränken möchten, die neue Kontakte haben können, legen Sie die Einschränkung der Organisationsrichtlinie constraints/essentialcontacts.allowedContactDomains fest. Bestehende 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

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl sehen Sie, für welches Projekt, welchen Ordner oder welche Organisation Sie derzeit Kontakte verwalten.

  3. Um die Kontakte nach Kategorie aufzulisten, wählen Sie Kategorie aus. Wählen Sie Kontakte aus, um die Kontakte alphabetisch aufzulisten.

gcloud

  1. 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.

  2. Mit der Google Cloud CLI können Sie entweder die in einer Ressource definierten Kontakte oder alle Kontakte und übernommenen Kontakte für eine Ressource auflisten.

    Für eine Ressource definierte Kontakte auflisten

    Verwenden Sie den Befehl gcloud essential-contacts list, um die Kontakte aufzurufen, die in einem bestimmten Projekt, Ordner oder einer Organisation definiert wurden:

    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, listet die gcloud CLI 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 übernommenen Kontakte für eine Ressource auflisten möchten, verwenden Sie den Befehl gcloud essential-contacts compute:

    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, technical-incidents und notification-category-unspecified. Wenn Sie den Wert all auswählen, werden Kontakte für alle Kategorien aufgelistet.
    • 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, listet die gcloud CLI 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 für eine Ressource definierten Kontakte oder alle Kontakte und übernommenen Kontakte für eine Ressource auflisten.

Für eine Ressource definierte Kontakte auflisten

Verwenden Sie die Methode contacts.list der Essential Contacts API, um die Kontakte aufzurufen, die für ein bestimmtes Projekt, einen Ordner oder eine Organisation definiert wurden.

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 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?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. NOTIFICATION_CATEGORY kann einen der folgenden Werte haben: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS und NOTIFICATION_CATEGORY_UNSPECIFIED. Wenn Sie den Wert ALL auswählen, werden Kontakte für alle Kategorien aufgelistet.
  • 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

Auf der Seite Wichtige Kontakte in der Google Cloud Console oder über die REST API können Sie Kontakte hinzufügen oder entfernen oder ihnen Benachrichtigungskategorien zuweisen.

Kontakte hinzufügen

So fügen Sie einen Kontakt hinzu:

Console

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl sehen Sie, für welches Projekt, welchen Ordner oder welche Organisation Sie derzeit Kontakte verwalten.

  3. Klicken Sie auf Kontakt hinzufügen.

  4. Geben Sie die E-Mail-Adresse des Kontakts in die Felder E-Mail und E-Mail bestätigen ein.

  5. 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.

  6. Klicken Sie auf Speichern.

gcloud

  1. 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.

  2. Verwenden Sie den Befehl gcloud required-contacts create, um einen neuen Kontakt hinzuzufügen:

    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 dieses Feld nach dem Erstellen des Kontakts nicht mehr ändern.
    • NOTIFICATION_CATEGORIES: Eine durch Kommas getrennte Liste der Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Die Liste kann einen der folgenden Werte enthalten: all, billing, legal, product-updates, security, suspension, technical, technische Vorfälle und notification-category-unspecified. Wenn Sie den Wert all auswählen, werden Kontakte für alle Kategorien aufgelistet.

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

    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache deines Kontakts. Sie können den Sprachcode jeder der unterstützten Sprachen angeben.
    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie einen Kontakt erstellen möchten. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: Ihre 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, erstellt die gcloud CLI 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, für den Sie einen Kontakt erstellen 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.

  • 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, TECHNICAL, TECHNICAL_INCIDENTS.

    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:

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

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl sehen Sie, für welches Projekt, welchen Ordner oder welche Organisation Sie derzeit Kontakte verwalten.

  3. Wählen Sie neben Anzeigen nach die Option Kontakt aus.

  4. Klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf .

  5. Wählen Sie die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.

gcloud

  1. 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.

  2. Um einen vorhandenen Kontakt zu aktualisieren, verwenden Sie den Befehl gcloud Essentials update:

    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 aktualisieren möchten. Listen Sie Ihre Kontakte auf, um die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation zu sehen. Die numerische ID ist der gesamte Teil des Kontaktnamens, der auf contacts folgt.
    • NOTIFICATION_CATEGORIES: Eine durch Kommas getrennte Liste der neuen Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Diese Liste ersetzt die vorhandene Liste der Benachrichtigungskategorien.

      Die Liste kann einen der folgenden Werte enthalten: all, billing, legal, product-updates, security, suspension, technical, technische Vorfälle und notification-category-unspecified. Wenn Sie den Wert all auswählen, werden Kontakte für alle Kategorien aufgelistet.

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

    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache deines Kontakts. Sie können den Sprachcode jeder der unterstützten Sprachen angeben.
    • RESOURCE_TYPE: Der Ressourcentyp, für den der Kontakt definiert ist. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: ID des Google Cloud-Projekts, der Organisation oder des Ordners, in dem der Kontakt definiert ist. 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, aktualisiert die gcloud CLI den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID vorhanden ist, 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 aktualisieren möchten. Listen Sie Ihre Kontakte auf, um die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation zu sehen. Die numerische ID ist der gesamte Teil des Kontaktnamens, der auf contacts folgt.
  • 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, TECHNICAL, TECHNICAL_INCIDENTS.

    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:

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

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl sehen Sie, für welches Projekt, welchen Ordner oder welche Organisation Sie derzeit Kontakte verwalten.

  3. Wählen Sie neben Anzeigen nach die Option Kontakt aus.

  4. Klicken Sie neben der E-Mail-Adresse des Kontakts, den Sie löschen möchten, auf . Bestätigen Sie dann im Dialogfeld, dass Sie den Kontakt löschen möchten.

gcloud

  1. 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.

  2. Um einen vorhandenen Kontakt zu löschen, verwenden Sie den Befehl 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 löschen möchten. Listen Sie Ihre Kontakte auf, um die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation zu sehen. Die numerische ID ist der gesamte Teil des Kontaktnamens, der auf contacts folgt.
    • RESOURCE_TYPE: Der Ressourcentyp, für den der Kontakt definiert ist. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: ID des Google Cloud-Projekts, der Organisation oder des Ordners, in dem der Kontakt definiert ist. 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, löscht die gcloud CLI den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID vorhanden ist, 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:

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. Rufen Sie dazu auf der Seite Wichtige Kontakte den Tab Kategorie auf.

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

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl sehen Sie, für welches Projekt, welchen Ordner oder welche Organisation Sie derzeit Kontakte verwalten.

  3. Wählen Sie neben Anzeigen nach die Option Kategorie aus.

  4. Klicken Sie in der Zeile, in der Sie die Kontakte verwalten möchten, auf .

  5. 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.

    • Wenn Sie einen Kontakt löschen möchten, klicken Sie neben der E-Mail-Adresse des Kontakts auf .

E-Mail-Übertragungen überprüfen

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

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

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

    Zur Seite „Wichtige Kontakte“

  2. Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl oben auf der Seite angezeigt wird. In der Ressourcenauswahl wird das Projekt, der Ordner oder die Organisation angezeigt, für die Sie derzeit Kontakte verwalten.

  3. Wählen Sie neben Anzeigen nach die Option Kategorie aus.

  4. Klicken Sie in der Zeile mit der Kategorie, an deren Kontakte Sie Test-E-Mails senden möchten, auf .

  5. Aktivieren Sie die Kontrollkästchen neben den Kontakten, an die Sie E-Mails senden möchten.

  6. Klicken Sie auf Senden. An die ausgewählten Kontakte wird eine Test-E-Mail gesendet.

  7. Kommunizieren Sie mit jedem Kontakt, um sicherzustellen, dass dieser eine Test-E-Mail von gcp-essential-contacts-noreply@google.com erhalten hat.

Kontakte mit Terraform verwalten

Mit Terraform können Sie Ihre Benachrichtigungskontakte verwalten. Kontakte haben in der Terraform-Sprache das folgende Format:

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 jeder der unterstützten Sprachen angeben.

  • NOTIFICATION_CATEGORIES: ein Array der Benachrichtigungskategorien, 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, TECHNICAL, TECHNICAL_INCIDENTS.

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

Wenn Sie einen Kontakt hinzufügen, ändern oder entfernen möchten, fügen Sie eine Kontaktressource in Ihrer Terraform-Konfigurationsdatei hinzu.

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

Nächste Schritte