Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Arbeiten mit Benachrichtigungsregelzielen
Ein Benachrichtigungsregelziel ist ein Ziel, das definiert, wohin Benachrichtigungen gesendet werden sollen, wenn die Ereignisbedingungen einer Benachrichtigungsregel erfüllt sind. Sie können zwischen Amazon SNS SNS-Themen und AWS Chatbot-Clients wählen, die für Slack- oder Microsoft Teams-Kanäle konfiguriert sind. Sie können beim Erstellen einer Benachrichtigungsregel ein Amazon-SNS-Thema als Ziel erstellen (empfohlen). Sie können auch ein vorhandenes Amazon SNS SNS-Thema in derselben AWS Region wie die Benachrichtigungsregel auswählen, müssen es jedoch mit der erforderlichen Richtlinie konfigurieren. Wenn Sie einen AWS Chatbot-Client als Ziel verwenden möchten, müssen Sie diesen Client zuerst in AWS Chatbot erstellen.
Wenn Sie die Reichweite von Benachrichtigungen vergrößern möchten, können Sie die Integration zwischen Benachrichtigungen und AWS Chatbot manuell konfigurieren, sodass Benachrichtigungen an Amazon Chime-Chatrooms gesendet werden. Anschließend können Sie das für diesen AWS Chatbot-Client konfigurierte Amazon SNS SNS-Thema als Ziel für die Benachrichtigungsregel auswählen. Weitere Informationen finden Sie unter [Um Benachrichtigungen mit AWS Chatbot und Amazon Chime zu integrieren](notifications-chatbot.md#notifications-chatbot-chime).
Sie können die Developer Tools-Konsole oder die verwenden, um AWS CLI Benachrichtigungsziele zu verwalten. [Sie können die Konsole oder die verwenden, AWS CLI um Amazon SNS SNS-Themen und AWS Chatbot-Clients als Ziele zu erstellen und zu konfigurieren.](concepts.md#targets) Sie können auch die Integration zwischen den Amazon SNS SNS-Themen, die Sie als Ziele konfigurieren, und AWS Chatbot konfigurieren. Dies ermöglicht es Ihnen, Benachrichtigungen an Amazon-Chime-Chatrooms zu senden. Weitere Informationen finden Sie unter [Konfiguration der Integration zwischen Benachrichtigungen und AWS Chatbot](notifications-chatbot.md).
**Topics**
+ [Erstellen oder Konfigurieren eines Benachrichtigungsregelziels](notification-target-create.md)
+ [Anzeigen von Benachrichtigungsregelzielen](notification-target-view.md)
+ [Hinzufügen oder Entfernen eines Ziels für eine Benachrichtigungsregel](notification-target-change-rule.md)
+ [Löschen eines Benachrichtigungsregelziels](notification-target-delete.md)
# Erstellen oder Konfigurieren eines Benachrichtigungsregelziels
Ziele für Benachrichtigungsregeln sind Amazon SNS SNS-Themen oder AWS Chatbot-Clients, die für Slack- oder Microsoft Teams-Kanäle konfiguriert sind.
Ein AWS Chatbot-Client muss erstellt werden, bevor Sie einen Kunden als Ziel auswählen können. Wenn Sie einen AWS Chatbot-Client als Ziel für eine Benachrichtigungsregel auswählen, wird für diesen AWS Chatbot-Client ein Amazon SNS SNS-Thema mit allen Richtlinien konfiguriert, die für das Senden von Benachrichtigungen an den Slack- oder Microsoft Teams-Kanal erforderlich sind. Sie müssen keine vorhandenen Amazon-SNS-Themen für den AWS -Chatbot-Client konfigurieren.
Sie können in der Entwicklertools-Konsole beim Erstellen einer Benachrichtigungsregel auch Amazon-SNS-Benachrichtigungsregelziele erstellen. Die Richtlinie, die das Senden von Benachrichtigungen an dieses Thema ermöglicht, wird für Sie angewendet. Dies ist die einfachste Möglichkeit, ein Ziel für eine Benachrichtigungsregel zu erstellen. Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](notification-rule-create.md).
Wenn Sie ein vorhandenes Amazon-SNS-Thema verwenden, müssen Sie es mit einer Zugriffsrichtlinie konfigurieren, die es der Ressource ermöglicht, Benachrichtigungen an dieses Thema zu senden. Ein Beispiel finden Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md).
**Anmerkung**
Wenn Sie ein vorhandenes Amazon-SNS-Thema verwenden möchten, anstatt ein neues zu erstellen, wählen Sie unter **Targets (Ziele)**, dessen ARN aus. Stellen Sie sicher, dass das Thema über die entsprechende Zugriffsrichtlinie verfügt und Abonnentenliste nur die Benutzer enthält, denen Informationen zur Ressource angezeigt werden dürfen. Wenn es sich bei dem Amazon SNS-Thema um ein Thema handelt, das vor dem 5. November 2019 für CodeCommit Benachrichtigungen verwendet wurde, enthält es eine Richtlinie, die es ermöglicht, dort CodeCommit zu veröffentlichen, die andere Berechtigungen enthält als die, die für AWS CodeStar Benachrichtigungen erforderlich sind. Das Verwenden dieser Themen wird nicht empfohlen. Wenn Sie eine für dieses Erlebnis erstellte Richtlinie verwenden möchten, müssen Sie zusätzlich zu der bereits vorhandenen Richtlinie die erforderliche Richtlinie für AWS CodeStar Benachrichtigungen hinzufügen. Weitere Informationen erhalten Sie unter [Konfigurieren von Amazon-SNS-Themen für Benachrichtigungen](set-up-sns.md) und [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
Wenn Sie die Reichweite von Benachrichtigungen vergrößern möchten, können Sie die Integration zwischen Benachrichtigungen und AWS Chatbot manuell konfigurieren, sodass Benachrichtigungen an Amazon Chime-Chatrooms gesendet werden. Weitere Informationen erhalten Sie unter [Ziele](concepts.md#targets) und [Um Benachrichtigungen mit AWS Chatbot und Amazon Chime zu integrieren](notifications-chatbot.md#notifications-chatbot-chime).
# Ein vorhandenes Amazon-SNS-Thema zur Verwendung als Benachrichtigungsregelziel konfigurieren (Konsole)
1. Melden Sie sich bei [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home) an AWS-Managementkonsole und öffnen Sie die Amazon SNS SNS-Konsole.
1. Wählen Sie in der Navigationsleiste **Topics** aus. Wählen Sie das Thema und anschließend **Edit (Bearbeiten)** aus.
1. Klappen Sie **Access policy (Zugriffsrichtlinie)** aus und wählen Sie danach **Advanced (Erweitert)** aus.
1. Geben Sie im JSON-Editor die folgende Anweisung für die Richtlinie ein. Geben Sie den Themen-ARN AWS-Region, die AWS-Konto ID und den Themennamen an.
```
{
"Sid": "AWSCodeStarNotifications_publish",
"Effect": "Allow",
"Principal": {
"Service": [
"codestar-notifications.amazonaws.com"
]
},
"Action": "SNS:Publish",
"Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules"
}
```
Die Richtlinienanweisung sollte so aussehen.
```
{
"Version": "2008-10-17",
"Id": "__default_policy_ID",
"Statement": [
{
"Sid": "__default_statement_ID",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"SNS:GetTopicAttributes",
"SNS:SetTopicAttributes",
"SNS:AddPermission",
"SNS:RemovePermission",
"SNS:DeleteTopic",
"SNS:Subscribe",
"SNS:ListSubscriptionsByTopic",
"SNS:Publish"
],
"Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules",
"Condition": {
"StringEquals": {
"AWS:SourceOwner": "123456789012"
}
}
},
{
"Sid": "AWSCodeStarNotifications_publish",
"Effect": "Allow",
"Principal": {
"Service": [
"codestar-notifications.amazonaws.com"
]
},
"Action": "SNS:Publish",
"Resource": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyTopicForNotificationRules"
}
]
}
```
1. Wählen Sie **Änderungen speichern ** aus.
1. Überprüfen Sie unter **Subscriptions (Abonnements)** die Liste der Abonnenten für das Thema. Fügen Sie Abonnenten entsprechend diesem Benachrichtigungsregelziel hinzu, bearbeiten oder löschen Sie sie. Stellen Sie sicher, dass die Abonnentenliste nur die Benutzer enthält, die Informationen über die Ressource anzeigen dürfen. Weitere Informationen finden Sie unter [Grundlagen zu Benachrichtigungsinhalten und -sicherheit](security.md#security-notifications).
# Um einen AWS Chatbot-Client mit Slack zu erstellen, der als Ziel verwendet werden kann
1. Folgen Sie den Anweisungen unter [Einrichten von AWS Chatbot mit Slack](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html#slack-client-setup) im *AWS -Chatbot-Administratorhandbuch*. Berücksichtigen Sie dabei die folgenden Optionen für eine optimale Integration mit Benachrichtigungen:
+ Wenn Sie eine IAM-Rolle erstellen, sollten Sie einen Rollennamen auswählen, der die Identifizierung des Zwecks dieser Rolle erleichtert (z. B. **AWSCodeStarNotifications-Chatbot-Slack-Role**). Dies kann Ihnen helfen, den Zweck der Rolle in der Zukunft zu identifizieren.
+ Bei **SNS-Themen** musst du weder ein Thema noch eine Region auswählen. AWS Wenn Sie den AWS Chatbot-Client als [Ziel](concepts.md#targets) wählen, wird im Rahmen der Erstellung der Benachrichtigungsregeln ein Amazon SNS SNS-Thema mit allen erforderlichen Berechtigungen für den AWS Chatbot-Client erstellt und konfiguriert.
1. Schließen Sie den Client-Erstellungsprozess ab. Dieser Client steht Ihnen dann zur Verfügung, wenn Sie Benachrichtigungsregeln erstellen. Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](notification-rule-create.md).
**Anmerkung**
Entfernen Sie das Amazon SNS SNS-Thema nicht aus dem AWS Chatbot-Client, nachdem es für Sie konfiguriert wurde. Andernfalls wird verhindert, dass Benachrichtigungen an Slack gesendet werden.
# Um einen AWS Chatbot-Client mit Microsoft Teams zu erstellen, der als Ziel verwendet werden kann
1. Folgen Sie den Anweisungen unter [Einrichten von AWS Chatbot mit Microsoft Teams](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) im *AWS -Chatbot-Administratorhandbuch*. Berücksichtigen Sie dabei die folgenden Optionen für eine optimale Integration mit Benachrichtigungen:
+ Wenn Sie eine IAM-Rolle erstellen, sollten Sie einen Rollennamen auswählen, der die Identifizierung des Zwecks dieser Rolle erleichtert (z. B. **AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role**). Dies kann Ihnen helfen, den Zweck der Rolle in der Zukunft zu identifizieren.
+ Bei **SNS-Themen** müssen Sie weder ein Thema noch eine Region auswählen. AWS Wenn Sie den AWS Chatbot-Client als [Ziel](concepts.md#targets) wählen, wird im Rahmen der Erstellung der Benachrichtigungsregeln ein Amazon SNS SNS-Thema mit allen erforderlichen Berechtigungen für den AWS Chatbot-Client erstellt und konfiguriert.
1. Schließen Sie den Client-Erstellungsprozess ab. Dieser Client steht Ihnen dann zur Verfügung, wenn Sie Benachrichtigungsregeln erstellen. Weitere Informationen finden Sie unter [Erstellen einer Benachrichtigungsregel](notification-rule-create.md).
**Anmerkung**
Entfernen Sie das Amazon SNS SNS-Thema nicht aus dem AWS Chatbot-Client, nachdem es für Sie konfiguriert wurde. Andernfalls wird verhindert, dass Benachrichtigungen an Microsoft Teams gesendet werden.
# Anzeigen von Benachrichtigungsregelzielen
Sie können die Developer Tools-Konsole und nicht die Amazon SNS SNS-Konsole verwenden, um alle Benachrichtigungsregelziele für alle Ressourcen in einer AWS Region anzuzeigen. Sie können auch die Details zu einem Benachrichtigungsregelziel anzeigen.
# So zeigen Sie Benachrichtigungsregelziele an (Konsole):
1. Öffnen Sie die AWS Developer Tools-Konsole unter [https://console.aws.amazon.com/codesuite/Einstellungen/Benachrichtigungen](https://console.aws.amazon.com/codesuite/settings/notifications/).
1. Erweitern Sie in der Navigationsleiste **Settings (Einstellungen)**, und wählen Sie dann **Notification rules (Benachrichtigungsregeln)** aus.
1. Sehen Sie sich unter **Ziele für Benachrichtigungsregeln** die Liste der Ziele an, die von den Benachrichtigungsregeln in Ihrem Land verwendet werden, AWS-Konto in AWS-Region dem Sie gerade angemeldet sind. Verwenden Sie den Selektor, um die AWS-Region zu ändern. Wenn der Zielstatus als **Unreachable (Nicht erreichbar)**, angezeigt wird, müssen Sie möglicherweise nach der Ursache dafür suchen. Weitere Informationen finden Sie unter [Fehlerbehebung](troubleshooting.md).
# So zeigen Sie eine Liste der Benachrichtigungsregelziele an (AWS CLI):
1. Führen Sie in einem Terminal oder bei einer Eingabeaufforderung den **list-targets**-Befehl aus, um eine Liste aller Benachrichtigungsregelziele für die angegebene AWS -Region anzuzeigen:
```
aws codestar-notifications list-targets --region us-east-2
```
1. Bei Erfolg gibt dieser Befehl die ID und den ARN für jede Benachrichtigungsregel in der AWS Region zurück, ähnlich wie im Folgenden:
```
{
"Targets": [
{
"TargetAddress": "arn:aws:sns:us-east-2:123456789012:MySNSTopicForNotificationRules",
"TargetType": "SNS",
"TargetStatus": "ACTIVE"
},
{
"TargetAddress": "arn:aws:chatbot::123456789012:chat-configuration/slack-channel/MySlackChannelClientForMyDevTeam",
"TargetStatus": "ACTIVE",
"TargetType": "AWSChatbotSlack"
},
{
"TargetAddress": "arn:aws:sns:us-east-2:123456789012:MySNSTopicForNotificationsAboutMyDemoRepo",
"TargetType": "SNS",
"TargetStatus": "ACTIVE"
}
]
}
```
# Hinzufügen oder Entfernen eines Ziels für eine Benachrichtigungsregel
Sie können eine Benachrichtigungsregel bearbeiten, um das Ziel bzw. die Ziele zu ändern, an das/die Benachrichtigungen gesendet werden. Sie können die Developer Tools-Konsole oder die verwenden AWS CLI , um die Ziele einer Benachrichtigungsregel zu ändern.
# So ändern Sie die Ziele für eine Benachrichtigungsregel (Konsole):
1. Öffnen Sie die AWS Developer Tools-Konsole unter [https://console.aws.amazon.com/codesuite/Einstellungen/Benachrichtigungen](https://console.aws.amazon.com/codesuite/settings/notifications/).
1. Erweitern Sie in der Navigationsleiste **Settings (Einstellungen)**, und wählen Sie dann **Notification rules (Benachrichtigungsregeln)** aus.
1. Sehen Sie sich unter **Benachrichtigungsregeln** die Liste der Regeln an, die für Ihre Ressourcen in Ihrem AWS Konto konfiguriert sind, in AWS-Region dem Sie derzeit angemeldet sind. Verwenden Sie den Selektor, um die AWS-Region zu ändern.
1. Wählen Sie die Regel und anschließend **Edit (Bearbeiten)** aus.
1. Führen Sie unter **Targets (Ziele)** einen der folgenden Schritte aus:
+ Um ein weiteres Ziel hinzuzufügen, wählen Sie **Ziel hinzufügen** und wählen Sie dann das Amazon SNS SNS-Thema oder den AWS Chatbot- (Slack) - oder AWS Chatbot- (Microsoft Teams) -Client aus, den Sie aus der Liste hinzufügen möchten. Sie können auch **Create SNS topic (SNS-Thema erstellen)** auswählen, um ein Thema zu erstellen und als Ziel hinzuzufügen. Eine Benachrichtigungsregel kann bis zu 10 Ziele haben.
+ Um ein Ziel zu entfernen, wählen Sie **Remove target (Ziel entfernen)** neben dem Ziel aus, das Sie entfernen möchten.
1. Wählen Sie **Submit (Absenden)** aus.
# So fügen Sie einer Benachrichtigungsregel ein Ziel hinzu (AWS CLI):
1. Führen Sie in einem Terminal oder einer Eingabeaufforderung den **subscribe**-Befehl aus, um ein Ziel hinzuzufügen. Mit dem folgenden Befehl wird beispielsweise ein Amazon-SNS-Thema als Ziel für eine Benachrichtigungsregel hinzugefügt.
```
aws codestar-notifications subscribe --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic
```
1. Bei Erfolg gibt der Befehl den ARN der aktualisierten Benachrichtigungsregel zurück, ähnlich wie nachfolgend gezeigt:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
# So entfernen Sie ein Ziel aus einer Benachrichtigungsregel (AWS CLI):
1. Führen Sie in einem Terminal oder einer Eingabeaufforderung den **unsubscribe**-Befehl aus, um ein Ziel zu entfernen. Mit dem folgenden Befehl wird beispielsweise ein Amazon-SNS-Thema als Ziel für eine Benachrichtigungsregel entfernt.
```
aws codestar-notifications unsubscribe --arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE --target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic
```
1. Bei Erfolg gibt der Befehl den ARN der aktualisierten Benachrichtigungsregel und Informationen über das entfernte Ziel zurück, ähnlich wie nachfolgend gezeigt:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
```
## Weitere Informationen finden Sie auch unter
+ [Bearbeiten einer Benachrichtigungsregel](notification-rule-edit.md)
+ [Aktivieren oder Deaktivieren von Benachrichtigungen für eine Benachrichtigungsregel](notification-rule-enable-disable.md)
# Löschen eines Benachrichtigungsregelziels
Sie können ein Ziel löschen, wenn es nicht mehr benötigt wird. Für eine Ressource können nur zehn (10) Benachrichtigungsregelziele konfiguriert werden. Das Löschen nicht benötigter Ziele kann daher helfen, Platz für andere Ziele zu schaffen, die Sie dieser Benachrichtigungsregel hinzufügen möchten.
**Anmerkung**
Durch das Löschen eines Benachrichtigungsregelziels wird das Ziel aus allen Benachrichtigungsregeln entfernt, die für die Verwendung als Ziel konfiguriert sind. Das Ziel selbst wird jedoch nicht gelöscht.
# So löschen Sie ein Benachrichtigungsregelziel (Konsole):
1. Öffnen Sie die AWS Developer Tools-Konsole unter [https://console.aws.amazon.com/codesuite/Einstellungen/Benachrichtigungen](https://console.aws.amazon.com/codesuite/settings/notifications/).
1. Erweitern Sie in der Navigationsleiste **Settings (Einstellungen)**, und wählen Sie dann **Notification rules (Benachrichtigungsregeln)** aus.
1. Sehen Sie sich unter **Ziele für Benachrichtigungsregeln** die Liste der Ziele an, die für Ihre Ressourcen in Ihrem AWS Konto konfiguriert sind, in AWS-Region dem Sie derzeit angemeldet sind. Verwenden Sie den Selektor, um die AWS-Region zu ändern.
1. Wählen Sie das Benachrichtigungsregelziel und anschließend **Delete (Löschen)** aus.
1. Geben Sie **delete** ein und wählen Sie dann **Delete (Löschen)** aus.
# So löschen Sie ein Benachrichtigungsregelziel (AWS CLI):
1. Führen Sie in einem Terminal oder einer Eingabeaufforderung den Befehl **delete-target** aus. und geben Sie dabei den ARN des Ziels an. Mit dem folgenden Befehl wird beispielsweise ein Ziel gelöscht, das ein Amazon-SNS-Thema verwendet.
```
aws codestar-notifications delete-target --target-address arn:aws:sns:us-east-1:123456789012:MyNotificationTopic
```
1. Wenn der Befehl erfolgreich ist, wird nichts zurückgegeben. Bei einem Fehlschlag gibt der Befehl einen Fehler zurück. Der häufigste Fehler besteht darin, dass das Thema Ziel für eine oder mehrere Benachrichtigungsregeln ist.
```
An error occurred (ValidationException) when calling the DeleteTarget operation: Unsubscribe target before deleting.
```
Sie können den `--force-unsubscribe-all`-Parameter verwenden, um das Ziel aus allen Benachrichtigungsregeln zu entfernen, die für die Verwendung dieses Ziels als Ziel konfiguriert sind, und dann das Ziel löschen.
```
aws codestar-notifications delete-target --target-address arn:aws:sns:us-east-1:123456789012:MyNotificationTopic --force-unsubscribe-all
```