S3-Speicher | Ereignisbenachrichtigung hinzufügen - AMS Advanced Change Typ-Referenz

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.

S3-Speicher | Ereignisbenachrichtigung hinzufügen

Fügen Sie dem angegebenen S3-Bucket über direkte API-Aufrufe eine Ereignisbenachrichtigung hinzu. Der S3-Bucket kann eigenständig sein oder zu einem CloudFormation Stack gehören. Beachten Sie bei Buckets in CloudFormation Stacks, dass es zu einer Stack-Drift kommen kann, wenn der Bucket über CFN-Ingestion bereitgestellt wurde.

Vollständige Klassifizierung: Verwaltung | Erweiterte Stack-Komponenten | S3-Speicher | Ereignisbenachrichtigung hinzufügen

Typdetails ändern

Typ-ID ändern

ct-0o4zi9bzg74lp

Aktuelle Version

1,0

Erwartete Ausführungsdauer

10 Minuten

AWS-Zulassung

Erforderlich

Zustimmung durch den Kunden

Nicht erforderlich

Ausführungsmodus

Automatisiert

Zusätzliche Informationen

Fügen Sie eine Ereignisbenachrichtigung zu einem Amazon S3 S3-Bucket hinzu

Im Folgenden finden Sie einen Screenshot dieses Änderungstyps in der AMS-Konsole:

Beispiel für diesen Änderungstyp in der Konsole.

So funktioniert es:

  1. Navigieren Sie zur Seite „RFC erstellen“: Klicken Sie im linken Navigationsbereich der AMS-Konsole, um die RFCs Listenseite RFCszu öffnen, und klicken Sie dann auf RFC erstellen.

  2. Wählen Sie in der Standardansicht „Änderungstypen durchsuchen“ einen beliebten Änderungstyp (CT) oder wählen Sie in der Ansicht „Nach Kategorie auswählen“ einen CT aus.

    • Nach Änderungstyp suchen: Sie können im Bereich Schnellerstellung auf ein beliebtes CT klicken, um sofort die Seite RFC ausführen zu öffnen. Beachten Sie, dass Sie mit Quick Create keine ältere CT-Version auswählen können.

      Verwenden Sie zum Sortieren CTs den Bereich Alle Änderungstypen in der Karten - oder Tabellenansicht. Wählen Sie in einer der Ansichten einen CT aus und klicken Sie dann auf RFC erstellen, um die Seite RFC ausführen zu öffnen. Falls zutreffend, wird neben der Schaltfläche „RFC erstellen“ die Option Mit älterer Version erstellen angezeigt.

    • Nach Kategorie auswählen: Wählen Sie eine Kategorie, eine Unterkategorie, einen Artikel und einen Vorgang aus. Daraufhin wird das Feld mit den CT-Details geöffnet. Dort können Sie gegebenenfalls die Option „Mit älterer Version erstellen“ auswählen. Klicken Sie auf RFC erstellen, um die Seite RFC ausführen zu öffnen.

  3. Öffnen Sie auf der Seite RFC ausführen den Bereich CT-Name, um das Feld mit den CT-Details zu sehen. Ein Betreff ist erforderlich (dieser wird für Sie ausgefüllt, wenn Sie Ihr CT in der Ansicht „Änderungstypen durchsuchen“ auswählen). Öffnen Sie den Bereich Zusätzliche Konfiguration, um Informationen zum RFC hinzuzufügen.

    Verwenden Sie im Bereich Ausführungskonfiguration die verfügbaren Dropdownlisten oder geben Sie Werte für die erforderlichen Parameter ein. Um optionale Ausführungsparameter zu konfigurieren, öffnen Sie den Bereich Zusätzliche Konfiguration.

  4. Wenn Sie fertig sind, klicken Sie auf Ausführen. Wenn keine Fehler vorliegen, wird die Seite mit dem RFC erfolgreich erstellt mit den übermittelten RFC-Details und der ersten Run-Ausgabe angezeigt.

  5. Öffnen Sie den Bereich Run-Parameter, um die von Ihnen eingereichten Konfigurationen zu sehen. Aktualisieren Sie die Seite, um den RFC-Ausführungsstatus zu aktualisieren. Brechen Sie optional den RFC ab oder erstellen Sie eine Kopie davon mit den Optionen oben auf der Seite.

So funktioniert es:

  1. Verwenden Sie entweder Inline Create (Sie geben einen create-rfc Befehl mit allen RFC- und Ausführungsparametern aus) oder Template Create (Sie erstellen zwei JSON-Dateien, eine für die RFC-Parameter und eine für die Ausführungsparameter) und geben Sie den create-rfc Befehl mit den beiden Dateien als Eingabe aus. Beide Methoden werden hier beschrieben.

  2. Reichen Sie den aws amscm submit-rfc --rfc-id ID Befehl RFC: mit der zurückgegebenen RFC-ID ein.

    Überwachen Sie den RFC: -Befehl. aws amscm get-rfc --rfc-id ID

Verwenden Sie diesen Befehl, um die Version des Änderungstyps zu überprüfen:

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
Anmerkung

Sie können alle CreateRfc Parameter mit jedem RFC verwenden, unabhängig davon, ob sie Teil des Schemas für den Änderungstyp sind oder nicht. Um beispielsweise Benachrichtigungen zu erhalten, wenn sich der RFC-Status ändert, fügen Sie diese Zeile dem RFC-Parameter-Teil der Anfrage hinzu (nicht den Ausführungsparametern). --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" Eine Liste aller CreateRfc Parameter finden Sie in der AMS Change Management API-Referenz.

INLINE-ERSTELLUNG:

Geben Sie den Befehl create RFC mit den direkt angegebenen Ausführungsparametern aus (vermeiden Sie Anführungszeichen, wenn Sie die Ausführungsparameter inline angeben), und senden Sie dann die zurückgegebene RFC-ID. Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

aws amscm create-rfc --change-type-id "ct-0o4zi9bzg74lp" --change-type-version "1.0" --title "Add event notification" --execution-parameters "{ \"DocumentName\": \"AWSManagedServices-AddBucketEventNotification\", \"Region\": \"us-east-1\", \"Parameters\": { \"BucketName\": \"bucketname\", \"EventName\": \"eventname\", \"Prefix\": \"foo\", \"Suffix\": \".bar\", \"EventTypes\": [ \"s3:ObjectCreated:Post\", \"s3:ObjectCreated:Put\" ], \"DestinationARN\": \"arn:aws:lambda:us-east-1:123456789012:function:functionname\" } }"

VORLAGE ERSTELLEN:

  1. Gibt das JSON-Schema der Ausführungsparameter für diesen Änderungstyp in eine Datei aus. In diesem Beispiel wird sie AddEventNotification S3Params.json genannt.

    aws amscm get-change-type-version --change-type-id "ct-220bdb8blaixf" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > AddEventNotificationS3Params.json
  2. Ändern und speichern Sie die S3Params-Datei. AddEventNotification Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

    { "DocumentName": "AWSManagedServices-AddBucketEventNotification", "Region": "us-east-1", "Parameters": { "BucketName": "bucketname", "EventName": "eventname", "Prefix": "foo", "Suffix": ".bar", "EventTypes": [ "s3:ObjectCreated:Post", "s3:ObjectCreated:Put" ], "DestinationARN": "arn:aws:lambda:us-east-1:123456789012:function:functionname" } }
  3. Geben Sie die RFC-Vorlagen-JSON-Datei in eine Datei mit dem Namen AddEventNotification s3rfc.json aus:

    aws amscm create-rfc --generate-cli-skeleton > AddEventNotificationS3Rfc.json
  4. Ändern und speichern Sie die Datei AddS3 .json. LifecycleConfigRfc Sie können den Inhalt beispielsweise durch etwas Ähnliches ersetzen:

    { "ChangeTypeVersion": "1.0", "ChangeTypeId": "ct-0o4zi9bzg74lp", "Title": "Add Event Notification" }
  5. Erstellen Sie den RFC und geben Sie die AddEventNotification S3RFC-Datei und die S3Params-Datei an: AddEventNotification

    aws amscm create-rfc --cli-input-json file://AddEventNotificationS3Rfc.json --execution-parameters file://AddEventNotificationS3Params.json

    Sie erhalten die ID des neuen RFC in der Antwort und können sie verwenden, um den RFC zu senden und zu überwachen. Bis Sie ihn abschicken, verbleibt der RFC im Bearbeitungszustand und startet nicht.

Eingabeparameter für die Ausführung

Ausführliche Informationen zu den Eingabeparametern der Ausführung finden Sie unterSchema für den Änderungstyp ct-0o4zi9bzg74lp.

Beispiel: Erforderliche Parameter

{ "DocumentName": "AWSManagedServices-AddBucketEventNotification", "Region": "us-east-1", "Parameters": { "BucketName": "s3-notification-test", "EventName": "TestEvent", "EventTypes": [ "s3:ObjectCreated:*", "s3:ObjectCreated:Put" ], "DestinationARN": "arn:aws:lambda:us-east-1:123456789012:function:testfunction" } }

Beispiel: Alle Parameter

{ "DocumentName": "AWSManagedServices-AddBucketEventNotification", "Region": "us-east-1", "Parameters": { "BucketName": "s3-notification-test", "EventName": "TestEvent", "EventTypes": [ "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:ObjectRestore:Delete", "s3:ReducedRedundancyLostObject", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:Replication:OperationNotTracked", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete", "s3:ObjectAcl:Put" ], "DestinationARN": "arn:aws:lambda:us-east-1:123456789012:function:testfunction", "Prefix": "testprefix", "Suffix": ".jpg" } }