EventBridge Leitet Beispiele mit AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

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 Pipe Demo_Pipe mit SQS als Quelle und CloudWatch Log Group als Ziel für die Pipe erstellt.

aws pipes create-pipe \
    --name Demo_Pipe \
    --desired-state RUNNING \
    --role-arn arn:aws:iam::123456789012:role/service-role/Amazon_EventBridge_Pipe_Demo_Pipe_28b3aa4f \
    --source arn:aws:sqs:us-east-1:123456789012:Demo_Queue \
    --target arn: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 CreatePipein 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, die Demo_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 DeletePipein 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 Pipe Demo_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 DescribePipein 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 ListPipesin 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, die Demo_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.

Das folgende Codebeispiel zeigt die Verwendungstart-pipe.

AWS CLI

Um eine bestehende Pipe zu starten

Im folgenden start-pipe Beispiel wird eine Pipe gestartet, die Demo_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 StartPipein 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, die Demo_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 StopPipein 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 \
    --tags stack=Production

Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie TagResourcein 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üssels stack 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 \
    --tags stack

Weitere Informationen finden Sie unter Amazon EventBridge Pipes-Konzepte im EventBridge Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UntagResourcein 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, die Demo_Pipe durch Hinzufügen eines CloudWatch Log-Konfigurationsparameters benannt wird. 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-state RUNNING \
    --log-configuration CloudwatchLogsLogDestination={LogGroupArn=arn:aws:logs:us-east-1:123456789012:log-group:/aws/vendedlogs/pipes/Demo_Pipe},Level=TRACE \
    --role-arn arn: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 UpdatePipein der AWS CLI Befehlsreferenz.