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
Contoh kode berikut menunjukkan kepada Anda bagaimana 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
### `create-pipe`
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`
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`
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`
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`
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`
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`
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`
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`
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`
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*.