

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# EventBridge Pipa contoh menggunakan AWS CLI
<a name="cli_pipes_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface With EventBridge Pipes.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

**Topics**
+ [Tindakan](#actions)

## Tindakan
<a name="actions"></a>

### `create-pipe`
<a name="pipes_CreatePipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`create-pipe`.

**AWS CLI**  
**Untuk membuat pipa**  
`create-pipe`Contoh berikut membuat Pipe bernama `Demo_Pipe` dengan SQS sebagai sumber dan CloudWatch Log Group sebagai target untuk Pipa.  

```
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
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [CreatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/create-pipe.html)di *Referensi AWS CLI Perintah*. 

### `delete-pipe`
<a name="pipes_DeletePipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-pipe`.

**AWS CLI**  
**Untuk menghapus pipa yang ada**  
`delete-pipe`Contoh berikut menghapus Pipe bernama `Demo_Pipe` dalam akun yang ditentukan.  

```
aws pipes delete-pipe \
    --name Demo_Pipe
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [DeletePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/delete-pipe.html)di *Referensi AWS CLI Perintah*. 

### `describe-pipe`
<a name="pipes_DescribePipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`describe-pipe`.

**AWS CLI**  
**Untuk mengambil informasi tentang Pipa**  
`describe-pipe`Contoh berikut menampilkan informasi tentang Pipa `Demo_Pipe` di akun yang ditentukan.  

```
aws pipes describe-pipe \
    --name Demo_Pipe
```
Output:  

```
{
    "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"
    }
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [DescribePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/describe-pipe.html)di *Referensi AWS CLI Perintah*. 

### `list-pipes`
<a name="pipes_ListPipes_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-pipes`.

**AWS CLI**  
**Untuk mengambil daftar Pipa**  
`list-pipes`Contoh berikut menunjukkan semua pipa di akun yang ditentukan.  

```
aws pipes list-pipes
```
Output:  

```
{
    "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"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [ListPipes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-pipes.html)di *Referensi AWS CLI Perintah*. 

### `list-tags-for-resource`
<a name="pipes_ListTagsForResource_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-resource`.

**AWS CLI**  
**Untuk daftar tag yang terkait dengan pipa yang ada**  
`list-tags-for-resource`Contoh berikut mencantumkan semua tag yang terkait dengan pipa bernama `Demo_Pipe` di akun yang ditentukan.  

```
aws pipes list-tags-for-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe
```
Output:  

```
{
    "tags": {
        "stack": "Production",
        "team": "DevOps"
    }
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/list-tags-for-resource.html)di *Referensi AWS CLI Perintah*. 

### `start-pipe`
<a name="pipes_StartPipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`start-pipe`.

**AWS CLI**  
**Untuk memulai pipa yang ada**  
`start-pipe`Contoh berikut memulai Pipa bernama `Demo_Pipe` dalam akun yang ditentukan.  

```
aws pipes start-pipe \
    --name Demo_Pipe
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [Memulai atau menghentikan EventBridge pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [StartPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/start-pipe.html)di *Referensi AWS CLI Perintah*. 

### `stop-pipe`
<a name="pipes_StopPipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`stop-pipe`.

**AWS CLI**  
**Untuk menghentikan pipa yang ada**  
`stop-pipe`Contoh berikut menghentikan Pipa bernama `Demo_Pipe` dalam akun yang ditentukan.  

```
aws pipes stop-pipe \
    --name Demo_Pipe
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [Memulai atau menghentikan EventBridge pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-start-stop.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [StopPipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/stop-pipe.html)di *Referensi AWS CLI Perintah*. 

### `tag-resource`
<a name="pipes_TagResource_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`tag-resource`.

**AWS CLI**  
**Untuk Menandai pipa yang ada**  
`tag-resource`Contoh berikut menandai Pipa bernama`Demo_Pipe`. Jika perintah berhasil, tidak ada output yang akan ditampilkan.  

```
aws pipes tag-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
    --tags stack=Production
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/tag-resource.html)di *Referensi AWS CLI Perintah*. 

### `untag-resource`
<a name="pipes_UntagResource_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`untag-resource`.

**AWS CLI**  
**Untuk menghapus Tag dari pipa yang ada**  
`untag-resource`Contoh berikut menghapus tag dengan kunci `stack` dari Pipe bernama`Demo_Pipe`. Jika perintah berhasil, tidak ada output yang akan ditampilkan.  

```
aws pipes untag-resource \
    --resource-arn arn:aws:pipes:us-east-1:123456789012:pipe/Demo_Pipe \
    --tags stack
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/untag-resource.html)di *Referensi AWS CLI Perintah*. 

### `update-pipe`
<a name="pipes_UpdatePipe_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`update-pipe`.

**AWS CLI**  
**Untuk memperbarui pipa yang ada**  
`update-pipe`Contoh berikut memperbarui Pipa bernama `Demo_Pipe` dengan menambahkan parameter konfigurasi CloudWatch Log, enure untuk memperbarui peran eksekusi pipa sehingga memiliki izin yang benar untuk tujuan Log.  

```
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
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [konsep EventBridge Pipa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/pipes-concepts.html) *di Panduan EventBridge Pengguna Amazon*.  
+  Untuk detail API, lihat [UpdatePipe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pipes/update-pipe.html)di *Referensi AWS CLI Perintah*. 