View a markdown version of this page

AWS-EnableSNSTopicDeliveryStatusLogging - AWS Systems Manager Runbook-Referenz für Automation

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.

AWS-EnableSNSTopicDeliveryStatusLogging

Beschreibung

Das AWS-EnableSNSTopicDeliveryStatusLogging Runbook konfiguriert die Protokollierung des Lieferstatus für einen Endpunkt HTTP von Amazon Data Firehose, Lambda oder Amazon Simple Queue Service (Amazon SQS). Platform application Auf diese Weise kann Amazon SNS fehlgeschlagene Warnmeldungen und einen Beispielprozentsatz erfolgreicher Warnmeldungen an Amazon protokollieren. CloudWatch Wenn die Protokollierung des Versandstatus für das Thema bereits konfiguriert ist, ersetzt das Runbook die bestehende Konfiguration durch die neuen Werte, die Sie für die Eingabeparameter angeben.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

  • EndpointType

    Typ: Zeichenfolge

    Zulässige Werte:

    • HTTP

    • Firehose

    • Lambda

    • Anwendung

    • SQS

    Beschreibung: (Erforderlich) Der Typ des Amazon SNS-Themen-Endpunkts, für den Sie Benachrichtigungen zum Übermittlungsstatus protokollieren möchten.

  • TopicArn

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ARN des Amazon SNS-Themas, für das Sie die Protokollierung des Versandstatus konfigurieren möchten.

  • SuccessFeedbackRoleArn

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Der ARN der IAM-Rolle, die Amazon SNS verwendet, um Protokolle für erfolgreiche Benachrichtigungen zu senden. CloudWatch

  • SuccessFeedbackSampleRate

    Typ: Zeichenfolge

    Gültige Werte: 0-100

    Beschreibung: (Erforderlich) Der Prozentsatz erfolgreicher Nachrichten, die für das angegebene Amazon SNS-Thema geprüft werden sollen.

  • FailureFeedbackRoleArn

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Der ARN der IAM-Rolle, die Amazon SNS verwendet, um Protokolle für Fehlerbenachrichtigungen zu senden. CloudWatch

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • iam:PassRole

  • sns:GetTopicAttributes

  • sns:SetTopicAttributes

Dokumentschritte

  • aws:executeAwsApi— Wendet den Wert für den SuccessFeedbackRoleArn Parameter auf das Amazon SNS-Thema an.

  • aws:executeAwsApi— Wendet den Wert für den SuccessFeedbackSampleRate Parameter auf das Amazon SNS-Thema an.

  • aws:executeAwsApi— Wendet den Wert für den FailureFeedbackRoleArn Parameter auf das Amazon SNS-Thema an.

  • aws:executeScript— Bestätigt, dass die Protokollierung des Versandstatus für das Amazon SNS-Thema aktiviert ist.

Ausgaben

VerifyDeliveryStatusLoggingEnabled.GetTopicAttributesResponse — Antwort aus den GetTopicAttributes API-Vorgängen.

VerifyDeliveryStatusLoggingEnabled.VerifyDeliveryStatusLoggingEnabled - Meldung, die auf die erfolgreiche Überprüfung der Protokollierung des Lieferstatus hinweist.