Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bermigrasi dari Bus Acara Kustom - Klasik ke Bus Acara Kustom
Bus Acara Kustom - Klasik tetap tersedia, dan Anda dapat menjalankan kedua produk secara berdampingan. Karena Bus Acara Kustom menyimpan namespace `events:` IAM dan prinsipal `events.amazonaws.com` layanan, kebijakan identitas dan peran pengiriman Anda terbawa. Apa yang berubah adalah model routing.
| Bus Acara Kustom - Klasik | Bus Acara Kustom |
| --- | --- |
| Aturan dan salah satu targetnya | Satu pelanggan |
| Aturan dengan lima target | Lima pelanggan di bus yang sama |
| Pola acara pada aturan | Filter dengan ruang lingkupDATA. Ketika produsen mempublikasikan denganPutEvents, polanya tidak berubah. |
| Transformator masukan | Sebuah transformator dengan jenis JSONATA |
| Dead-letter antrian pada target | OnFailureConfigurationpada pelanggan |
| Kebijakan coba ulang pada target | RetryPolicypada pelanggan |
| Arsip dan putar ulang | Retensi di bus dan posisi awal pelanggan |
| Aturan yang ditulis oleh pemilik bus untuk setiap konsumen | Pelanggan yang dibuat oleh konsumen sendiri |
| events:PutEvents | events:PutEvents, ditambah events:PutRawEvents untuk muatan non-JSON |
Empat kemampuan tidak memiliki Bus Peristiwa Kustom - Setara Klasik, sehingga desain yang dimigrasi dapat menggunakannya tanpa solusi: retensi pada bus itu sendiri, posisi awal pelanggan, jeda dan melanjutkan dengan backlog, dan API publikasi kedua untuk muatan non-JSON. Anda tidak harus memindahkan semuanya: dua bus berjalan berdampingan, aturan Bus Acara Kustom - Klasik dapat menargetkan Bus Acara Kustom, dan pelanggan dapat menargetkan Bus Acara Kustom - Klasik, sehingga Anda dapat memindahkan satu konsumen atau satu produsen pada satu waktu. Lihat [Target bus acara: bus ke bus](eb-custom-bus-target-bus.md).
## Apa yang tidak berubah
Berikut ini tetap sama, sehingga bagian yang sesuai dari penerapan Anda terbawa sebagaimana adanya.
| Tidak berubah | Apa artinya untuk pindah |
| --- | --- |
| Namespace tindakan IAM events: dan prinsipal layanan events.amazonaws.com | Kebijakan identitas, kebijakan sumber daya bus, dan kebijakan kepercayaan peran pengiriman digunakan kembali |
| Layanan target: Amazon SQS, Lambda, Amazon SNS, Kinesis, Firehose, Fungsi Langkah, Gerbang API, tujuan API, bus acara | Peran pengiriman mempertahankan tindakan target yang sama; setiap target memiliki blok parameter dengan bidang yang sama dengan rekan Klasiknya. Lihat [Target untuk pelanggan Bus Acara Kustom](eb-custom-bus-targets.md) |
| Sintaks pola peristiwa, kecuali wildcard | Pola aturan menjadi DATA filter yang tidak berubah untuk PutEvents lalu lintas. Lihat [Memfilter acara untuk pelanggan](eb-custom-bus-filtering.md) |
| AWS acara layanan dan acara mitra SaaS | Peristiwa yang sama mencapai Bus Acara Kustom melalui sumber acara. Lihat [Sumber acara untuk Bus Acara Kustom](eb-custom-bus-event-sources.md) |
| PutEventsAPI dan amplop | Produsen mengubah titik akhir dan klien, bukan permintaan |
| Transformasi input dengan JSONata | Ekspresi pindah ke Transformer dengan acara di bawah $events |
## Default yang berbeda
**penting**
Pelanggan mencoba kembali pengiriman yang gagal selama 300 detik dan 5 upaya secara default. Bus Acara Kustom - Percobaan ulang target klasik selama 24 jam dan 185 upaya. Jika konsumen Anda bergantung pada satu hari percobaan ulang selama pemadaman, setel `RetryPolicy.MaxEventAgeInSeconds` ke 86.400 dan 185 `MaxRetryAttempts` untuk setiap pelanggan, dan lampirkan antrian surat mati; jika tidak, peristiwa yang gagal selama lebih dari 5 menit akan mati daripada terlambat dikirim. Lihat [Kebijakan coba ulang dan antrian surat mati](eb-custom-bus-retry.md).
Dua default lagi berbeda. Pelanggan mengirimkan batch ke fungsi atau mesin status sebagai array JSON, di mana aturan mengirimkan satu peristiwa per pemanggilan; diatur `BatchConfiguration.MaxBatchSize` ke 1 untuk menyimpan satu peristiwa per panggilan. Dan bus menyimpan acara, sehingga pelanggan yang dibuat setelah insiden dapat membaca apa yang dilewatkan, di mana aturan yang dibuat terlambat tidak melihat apa-apa.
## Target klasik tanpa padanan yang dipesan lebih dahulu
Setiap Bus Acara Kustom - Jenis target Klasik yang tidak memiliki target khusus pada Bus Acara Kustom dicapai melalui target universal yang memanggil tindakan API layanan. Set `TargetArn` el ke `arn:aws:events:::aws-sdk:{{service}}:{{apiAction}}` dan buat permintaan di`Input`; lihat[Target universal untuk Bus Acara Kustom](eb-custom-bus-universal-targets.md).
| Bus Acara Kustom - Target klasik | Tindakan target universal |
| --- | --- |
| Tugas Amazon ECS | arn:aws:events:::aws-sdk:ecs:runTask |
| AWS Pekerjaan batch | arn:aws:events:::aws-sdk:batch:submitJob |
| CodeBuild proyek | arn:aws:events:::aws-sdk:codebuild:startBuild |
| CodePipeline pipa | arn:aws:events:::aws-sdk:codepipeline:startPipelineExecution |
| Run Command Systems Manager | arn:aws:events:::aws-sdk:ssm:sendCommand |
| Otomatisasi Systems Manager | arn:aws:events:::aws-sdk:ssm:startAutomationExecution |
| AWS Alur kerja lem | arn:aws:events:::aws-sdk:glue:startWorkflowRun |
| SageMaker pipa | arn:aws:events:::aws-sdk:sagemaker:startPipelineExecution |
| Pernyataan API Data Redshift | arn:aws:events:::aws-sdk:redshiftdata:executeStatement |
| CloudWatch Grup log log | arn:aws:events:::aws-sdk:cloudwatchlogs:putLogEvents |
| Tindakan Amazon EC2 (berhenti, reboot, akhiri, buat snapshot) | arn:aws:events:::aws-sdk:ec2:stopInstances, rebootInstances, terminateInstances, createSnapshot |
| Penilaian inspektur | arn:aws:events:::aws-sdk:inspector:startAssessmentRun |
Nama layanan dan tindakan mengikuti aturan penamaan target universal; `CreateSubscriber` menolak nama yang tidak dikenali, jadi konfirmasikan masing-masing saat Anda membuat pelanggan.
## Urutan migrasi
Pindahkan satu bus pada satu waktu, dalam lima langkah, menjaga agar Custom Event Bus - Aturan Klasik berjalan hingga langkah terakhir. Setiap langkah dapat dibalik sampai Anda menghapus aturan.
**penting**
Pola yang disalin dari aturan cocok dengan peristiwa yang diterbitkan dengan`PutEvents`, karena API tersebut menghasilkan amplop yang sama dengan Bus Peristiwa Kustom - Klasik. Pola yang sama tidak cocok dengan apa pun pada acara yang diterbitkan`PutRawEvents`, karena muatan tidak bersarang di bawah. `detail` Lihat [Struktur acara: data, metadata, dan metadata sistem](eb-custom-bus-addressing.md).
1. Buat Bus Acara Kustom dengan periode retensi yang Anda inginkan, dan tunggu hingga statusnya menjadi`ACTIVE`.
1. Untuk setiap aturan, buat satu pelanggan untuk setiap targetnya. Gunakan pola peristiwa aturan sebagai `DATA` filter, transformator inputnya sebagai `JSONATA` transformator, dan peran targetnya sebagai`RoleArn`. Lampirkan antrian huruf mati dan aktifkan log sebelum Anda mengirim lalu lintas.
1. Publikasikan ke kedua bus dari produsen Anda, dan konfirmasikan pada setiap target bahwa kedua jalur memberikan acara yang sama.
1. Pindahkan produsen ke Bus Acara Kustom saja.
1. Nonaktifkan aturan pada Bus Acara Kustom - Klasik. Hapus setelah jendela coba lagi dan periode verifikasi Anda sendiri telah berlalu.