Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples
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.
EventBridge Leitet Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with EventBridge Pipes Aktionen ausführen und allgemeine Szenarien implementieren.
Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarios anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.
Themen
Aktionen
Das folgende Codebeispiel zeigt die Verwendungcreate-pipe
.
- AWS CLI
-
Um eine Pipe zu erstellen
Im folgenden
create-pipe
Beispiel wird eine PipeDemo_Pipe
mit SQS als Quelle und CloudWatch Log Group als Ziel für die Pipe erstellt.aws pipes create-pipe \ --name
Demo_Pipe
\ --desired-stateRUNNING
\ --role-arnarn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f
\ --sourcearn:aws:sqs:us-east-1:123456789012:Demo_Queue
\ --targetarn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "CREATING", "CreationTime": "2024-10-08T12:33:59-05:00", "LastModifiedTime": "2024-10-08T12:33:59.684839-05:00" }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie CreatePipe
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungdelete-pipe
.
- AWS CLI
-
Um eine bestehende Pipe zu löschen
Im folgenden
delete-pipe
Beispiel wird eine Pipe gelöscht, dieDemo_Pipe
im angegebenen Konto benannt ist.aws pipes delete-pipe \ --name
Demo_Pipe
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "STOPPED", "CurrentState": "DELETING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T11:57:22-05:00" }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie DeletePipe
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungdescribe-pipe
.
- AWS CLI
-
Um Informationen über eine Pipe abzurufen
Im folgenden
describe-pipe
Beispiel werden Informationen über die PipeDemo_Pipe
im angegebenen Konto angezeigt.aws pipes describe-pipe \ --name
Demo_Pipe
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "RUNNING", "StateReason": "User initiated", "Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue", "SourceParameters": { "SqsQueueParameters": { "BatchSize": 1 } }, "EnrichmentParameters": {}, "Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup", "TargetParameters": {}, "RoleArn": "arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f", "Tags": {}, "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:23:47-05:00", "LogConfiguration": { "CloudwatchLogsLogDestination": { "LogGroupArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe" }, "Level": "ERROR" } }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie DescribePipe
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendunglist-pipes
.
- AWS CLI
-
Um eine Liste von Pipes abzurufen
Das folgende
list-pipes
Beispiel zeigt alle Pipes im angegebenen Konto.aws pipes list-pipes
Ausgabe:
{ "Pipes": [ { "Name": "Demo_Pipe", "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "RUNNING", "StateReason": "User initiated", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:23:47-05:00", "Source": "arn:aws:sqs:us-east-1:123456789012:Demo_Queue", "Target": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/pipes/Demo_LogGroup" } ] }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie ListPipes
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource
.
- AWS CLI
-
Um die Beschriftungen aufzulisten, die einer vorhandenen Pipe zugeordnet sind
Im folgenden
list-tags-for-resource
Beispiel werden alle Tags aufgeführt, die einer Pipe zugeordnet sind, dieDemo_Pipe
im angegebenen Konto benannt ist.aws pipes list-tags-for-resource \ --resource-arn
arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
Ausgabe:
{ "tags": { "stack": "Production", "team": "DevOps" } }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie ListTagsForResource
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungstart-pipe
.
- AWS CLI
-
Um eine bestehende Pipe zu starten
Im folgenden
start-pipe
Beispiel wird eine Pipe gestartet, dieDemo_Pipe
im angegebenen Konto benannt ist.aws pipes start-pipe \ --name
Demo_Pipe
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "STARTING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T10:17:24-05:00" }
Weitere Informationen finden Sie unter Starten oder Stoppen einer EventBridge Amazon-Pipe im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie StartPipe
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungstop-pipe
.
- AWS CLI
-
Um eine bestehende Pipe zu stoppen
Im folgenden
stop-pipe
Beispiel wird eine Pipe gestoppt, dieDemo_Pipe
im angegebenen Konto benannt ist.aws pipes stop-pipe \ --name
Demo_Pipe
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "STOPPED", "CurrentState": "STOPPING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T09:29:49-05:00" }
Weitere Informationen finden Sie unter Starten oder Stoppen einer EventBridge Amazon-Pipe im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie StopPipe
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungtag-resource
.
- AWS CLI
-
Um eine bestehende Leitung zu kennzeichnen
Das folgende
tag-resource
Beispiel kennzeichnet eine Pipe mit dem NamenDemo_Pipe
. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.aws pipes tag-resource \ --resource-arn
arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
\ --tagsstack=Production
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie TagResource
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendunguntag-resource
.
- AWS CLI
-
Um ein Tag aus einer vorhandenen Pipe zu entfernen
Im folgenden
untag-resource
Beispiel wird ein Tag mit dem Namen des Schlüsselsstack
aus der Pipe entferntDemo_Pipe
. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.aws pipes untag-resource \ --resource-arn
arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
\ --tagsstack
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie UntagResource
in der AWS CLI Befehlsreferenz.
-
Das folgende Codebeispiel zeigt die Verwendungupdate-pipe
.
- AWS CLI
-
Um eine bestehende Pipe zu aktualisieren
Im folgenden
update-pipe
Beispiel wird die Pipe aktualisiert, dieDemo_Pipe
durch Hinzufügen eines CloudWatch Log-Konfigurationsparameters benannt wurde. Achten Sie darauf, die Ausführungsrolle der Pipe so zu aktualisieren, dass sie über die richtigen Berechtigungen für das Protokollziel verfügt.aws pipes update-pipe \ --name
Demo_Pipe
\ --desired-stateRUNNING
\ --log-configurationCloudwatchLogsLogDestination={LogGroupArn=arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe},Level=TRACE
\ --role-arnarn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f
Ausgabe:
{ "Arn": "arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe", "Name": "Demo_Pipe", "DesiredState": "RUNNING", "CurrentState": "UPDATING", "CreationTime": "2024-10-08T09:29:10-05:00", "LastModifiedTime": "2024-10-08T11:35:48-05:00" }
Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.
-
Einzelheiten zur API finden Sie UpdatePipe
in der AWS CLI Befehlsreferenz.
-