Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Migration de Custom Event Bus - Classic vers le Custom Event Bus
Custom Event Bus - Classic reste disponible et vous pouvez utiliser les deux produits côte à côte. Comme le Custom Event Bus conserve l'espace de noms `events:` IAM et le principal de `events.amazonaws.com` service, vos politiques d'identité et vos rôles de diffusion sont conservés. Ce qui change, c'est le modèle de routage.
| Bus événementiel personnalisé - Classic | Bus événementiel personnalisé |
| --- | --- |
| Une règle et l'une de ses cibles | Un abonné |
| Une règle avec cinq objectifs | Cinq abonnés dans le même bus |
| Modèle d'événement sur une règle | Un filtre d'une portée deDATA. Lorsque les producteurs publient avecPutEvents, le schéma reste inchangé. |
| Transformateur d'entrée | Un transformateur avec un type de JSONATA |
| Dead-letter file d'attente sur une cible | OnFailureConfigurationsur l'abonné |
| Politique de nouvelle tentative sur une cible | RetryPolicysur l'abonné |
| Archivage-relecture | Maintien dans le bus et position de départ de l'abonné |
| Règles rédigées par le propriétaire du bus pour chaque consommateur | Abonnés créés par les consommateurs eux-mêmes |
| events:PutEvents | events:PutEvents, ainsi que events:PutRawEvents pour les charges utiles non JSON |
Quatre fonctionnalités n'ont pas d'équivalent Custom Event Bus - Classic. Une conception migrée peut donc les utiliser sans solution de contournement : rétention sur le bus lui-même, position de départ de l'abonné, pause et reprise avec un backlog, et deuxième API de publication pour les charges utiles non JSON. Vous n'êtes pas obligé de tout déplacer : les deux bus circulent côte à côte, une règle Custom Event Bus - Classic peut cibler un bus événementiel personnalisé, et un abonné peut cibler un Custom Event Bus - Classic, ce qui vous permet de déplacer un consommateur ou un producteur à la fois. Consultez [Objectif du bus de l'événement : bus pour bus](eb-custom-bus-target-bus.md).
## Ce qui ne change pas
Les éléments suivants restent les mêmes, de sorte que les parties correspondantes de votre déploiement sont conservées telles quelles.
| Inchangé | Ce que cela signifie pour le déménagement |
| --- | --- |
| L'espace de noms des actions IAM events: et le principal du service events.amazonaws.com | Les politiques d'identité, les politiques de ressources de bus et les politiques de confiance relatives aux rôles de distribution sont réutilisées |
| Services cibles : Amazon SQS, Lambda, Amazon SNS, Kinesis, Firehose, Step Functions, API Gateway, destinations d'API, bus d'événements | Les rôles de diffusion conservent les mêmes actions cibles ; chaque cible possède un bloc de paramètres contenant les mêmes champs que son homologue classique. Consultez [Objectifs pour un abonné à Custom Event Bus](eb-custom-bus-targets.md) |
| Syntaxe des modèles d'événements, à l'exception des caractères génériques | Les modèles de règles deviennent des DATA filtres inchangés pour PutEvents le trafic. Consultez [Filtrer les événements pour un abonné](eb-custom-bus-filtering.md) |
| AWS événements de service et événements pour les partenaires SaaS | Les mêmes événements atteignent un bus d'événements personnalisé via une source d'événements. Consultez [Sources d'événements pour un bus événementiel personnalisé](eb-custom-bus-event-sources.md) |
| L'PutEventsAPI et l'enveloppe | Les producteurs modifient le point final et le client, pas la demande |
| Transformation d'entrée avec JSonata | Les expressions sont déplacées vers Transformer l'événement situé sous $events |
## Des valeurs par défaut qui diffèrent
**Important**
Un abonné retente une livraison échouée pendant 300 secondes et 5 tentatives par défaut. Un bus d'événements personnalisé - La cible classique réessaie pendant 24 heures et 185 tentatives. Si vos clients comptent sur une journée de nouvelles tentatives en cas de panne, définissez 86 400 et 185 `RetryPolicy.MaxEventAgeInSeconds` `MaxRetryAttempts` pour chaque abonné, et ajoutez une file d'attente lettre morte ; sinon, les événements qui échouent pendant plus de 5 minutes sont marqués en lettres mortes au lieu d'être livrés en retard. Consultez [Politiques relatives aux nouvelles tentatives et files d'attente](eb-custom-bus-retry.md).
Deux autres valeurs par défaut diffèrent. Un abonné transmet un lot à une fonction ou à une machine à états sous la forme d'un tableau JSON, où une règle délivrait un événement par appel ; définissez la `BatchConfiguration.MaxBatchSize` valeur 1 pour conserver un événement par appel. Et un bus conserve les événements, de sorte qu'un abonné créé à la suite d'un incident peut lire ce qu'il a oublié, alors qu'une règle créée tardivement n'a rien vu.
## Des cibles classiques sans équivalent sur mesure
Chaque type de cible Custom Event Bus - Classic qui n'a pas de cible personnalisée dans le Custom Event Bus est atteint via une cible universelle qui appelle l'action de l'API du service. Définissez `TargetArn` `arn:aws:events:::aws-sdk:{{service}}:{{apiAction}}` et intégrez la demande `Input` ; voir[Objectifs universels pour un bus événementiel personnalisé](eb-custom-bus-universal-targets.md).
| Bus événementiel personnalisé - cible classique | Action ciblée universelle |
| --- | --- |
| Tâches Amazon ECS | arn:aws:events:::aws-sdk:ecs:runTask |
| AWS Tâche par lots | arn:aws:events:::aws-sdk:batch:submitJob |
| CodeBuild projet | arn:aws:events:::aws-sdk:codebuild:startBuild |
| CodePipeline gazoduc | arn:aws:events:::aws-sdk:codepipeline:startPipelineExecution |
| Run Command de Systems Manager | arn:aws:events:::aws-sdk:ssm:sendCommand |
| Systems Manager Automation | arn:aws:events:::aws-sdk:ssm:startAutomationExecution |
| AWS Workflow Glue | arn:aws:events:::aws-sdk:glue:startWorkflowRun |
| SageMaker gazoduc | arn:aws:events:::aws-sdk:sagemaker:startPipelineExecution |
| Déclaration de l'API Redshift Data | arn:aws:events:::aws-sdk:redshiftdata:executeStatement |
| CloudWatch Logs, groupe de journaux | arn:aws:events:::aws-sdk:cloudwatchlogs:putLogEvents |
| Actions Amazon EC2 (arrêt, redémarrage, arrêt, création d'un instantané) | arn:aws:events:::aws-sdk:ec2:stopInstances, rebootInstances, terminateInstances, createSnapshot |
| Évaluation de l'inspecteur | arn:aws:events:::aws-sdk:inspector:startAssessmentRun |
Les noms des services et des actions suivent les règles de dénomination des cibles universelles ; `CreateSubscriber` rejette un nom qu'il ne reconnaît pas. Confirmez donc chacun d'entre eux lorsque vous créez l'abonné.
## Séquence de migration
Déplacez un bus à la fois, en cinq étapes, en maintenant les règles du Custom Event Bus - Classic en vigueur jusqu'à la dernière étape. Chaque étape est réversible jusqu'à ce que vous supprimiez les règles.
**Important**
Un modèle copié à partir d'une règle correspond à des événements publiés avec`PutEvents`, car cette API produit la même enveloppe que Custom Event Bus - Classic. Le même schéma ne correspond à rien sur les événements publiés avec`PutRawEvents`, car la charge utile n'est pas imbriquée sous. `detail` Consultez [Structure de l'événement : données, métadonnées et métadonnées du système](eb-custom-bus-addressing.md).
1. Créez le bus d'événements personnalisé avec la période de rétention que vous souhaitez et attendez qu'il soit dans cet état`ACTIVE`.
1. Pour chaque règle, créez un abonné pour chacune de ses cibles. Utilisez le modèle d'événement de la règle en tant que `DATA` filtre, son transformateur d'entrée en tant que `JSONATA` transformateur et son rôle cible en tant que`RoleArn`. Ajoutez une file d'attente aux lettres mortes et activez les journaux avant d'envoyer du trafic.
1. Publiez les informations de vos producteurs sur les deux bus et confirmez à chaque cible que les deux trajets proposent les mêmes événements.
1. Déplacez les producteurs vers le Custom Event Bus uniquement.
1. Désactivez les règles sur le Custom Event Bus - Classic. Supprimez-les après la fin de la fenêtre de nouvelle tentative et de votre propre période de vérification.