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. # Création d'un bus Vous créez un bus avec`CreateEventBus`, par exemple`aws eventsv2 create-event-bus --name orders`. Le nom est le seul paramètre obligatoire. Lors de la création, vous pouvez également définir une description, le nombre de jours pendant lesquels le bus conserve les événements, la AWS KMS clé qui les chiffre et les balises. L'appel revient immédiatement alors que le bus est dans l'`CREATING`état ; publiez-le dans le bus ou créez-en un abonné une fois le `DescribeEventBus` rapport envoyé`ACTIVE`. ## Création d'un bus avec AWS CLI La commande suivante crée un bus nommé `orders` qui conserve les événements pendant 30 jours, les chiffre avec votre AWS KMS clé et contient une balise. ``` aws eventsv2 create-event-bus \ --name orders \ --description "Order events from the checkout service" \ --storage-configuration RetentionPeriodInDays=30 \ --encryption-configuration KmsKeyIdentifier=arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --tags team=orders ``` Le tableau suivant répertorie ce que chaque paramètre accepte. | Paramètre | Ce qu'il accepte | | --- | --- | | --name | Obligatoire. 1 à 256 caractères : lettres, chiffres, points, tirets et traits de soulignement, en commençant par une lettre ou un chiffre. Le nom doit être unique dans votre compte dans la Région ; la création d'un deuxième bus portant le même nom échoueResourceAlreadyExistsException. | | --description | Jusqu'à 512 caractères. | | --storage-configuration | RetentionPeriodInDays, de 1 à 365. Omettez-le et le bus conserve les événements pendant 1 jour. Vous pouvez modifier la période ultérieurement avecUpdateEventBus. Consultez [Choix de la durée de conservation](#eb-custom-bus-create-retention). | | --encryption-configuration | KmsKeyIdentifier: un ID de clé, un ARN de clé, un nom d'alias ou un ARN d'alias d'une clé gérée par le AWS KMS client. Omettez-le et EventBridge cryptez les événements à l'aide d'une clé personnelle AWS . Pour la politique clé et les principaux besoins, voir[Chiffrement des événements sur un bus d'événements personnalisé](eb-custom-bus-encryption.md). | | --tags | Une carte entre les clés de tag et les valeurs, par exempleteam=orders,env=prod. Pour le contrôle d'accès basé sur les balises, consultez[Actions, ressources et clés de condition pour le bus d'événements personnalisé](eb-custom-bus-access-actions.md). | La réponse renvoie l'ARN du bus, que chaque appel ultérieur sur le bus utilise. L'ARN se termine par un identifiant qui est EventBridge généré. Vous ne pouvez donc pas le construire à partir du nom. ``` { "EventBusArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef", "Name": "orders", "Description": "Order events from the checkout service", "EncryptionConfiguration": { "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" }, "StorageConfiguration": { "RetentionPeriodInDays": 30, "RetentionWindowStartTime": "2026-09-21T16:00:00+00:00" }, "State": "CREATING", "CreationTime": "2026-09-21T16:00:00+00:00" } ``` Décrivez le bus par son ARN jusqu'à ce qu'`State`il soit`ACTIVE`. ``` aws eventsv2 describe-event-bus \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef ``` Pour créer un bus avec CloudFormation instead, consultez[Création de ressources Event Bus personnalisées avec CloudFormation](eb-custom-bus-cloudformation.md). Pour les actions IAM nécessaires à la création et à la description d'un bus, consultez[Actions, ressources et clés de condition pour le bus d'événements personnalisé](eb-custom-bus-access-actions.md). ## Choix de la durée de conservation Un bus conserve tous les événements qu'il accepte pendant un certain nombre de jours`StorageConfiguration.RetentionPeriodInDays`, de 1 à 365 ; si vous l'omettez, le bus conserve les événements pendant 1 jour. La rétention est ce qui permet à un abonné de repartir d'un point dans le passé, de faire une pause et de reprendre ses activités sans perdre les événements, et de les relire après un échec. Une période plus longue coûte plus cher en termes de stockage. Vous pouvez modifier la période ultérieurement avec`UpdateEventBus`. ``` aws eventsv2 create-event-bus \ --name orders \ --storage-configuration RetentionPeriodInDays=30 ``` `DescribeEventBus`renvoie`RetentionWindowStartTime`, le point le plus ancien à partir duquel un abonné peut lire. Pour diffuser des événements conservés à un abonné, consultez[Rediffusion des événements enregistrés à un abonné](eb-custom-bus-replay.md). ## Les états des bus et ce que chacun autorise La création, la mise à jour et la suppression d'un bus sont asynchrones. Tous les États autres que `ACTIVE` refusent certaines opérations, et les trois États défaillants comportent un `StateReason` qui vous explique pourquoi. Le tableau suivant répertorie les états dans lesquels passe un bus et indique ce que vous pouvez faire dans chacun d'eux. | State | Comment le bus s'y rend | Actions possibles | | --- | --- | --- | | CREATING | CreateEventBusest retourné et le bus est en train d'être mis en place. | Décrivez et attendez. Vous ne pouvez pas publier, mettre à jour ou supprimer le bus, ni y créer un abonné ou une source d'événements. | | ACTIVE | Création ou mise à jour terminée. | Tout : publier, créer des abonnés et des sources d'événements, mettre à jour, partager, supprimer. | | CREATE\_FAILED | La création a échoué, ce qui se produit lorsque vous EventBridge ne pouvez pas utiliser la AWS KMS clé que vous avez nommée. | Supprimez le bus. Rien d'autre n'est accepté. LisezStateReason, corrigez la clé ou sa politique, puis créez à nouveau le bus. | | UPDATING | UpdateEventBusest en train de modifier la configuration de chiffrement. Les autres mises à jour ne passent pas par cet état. | Publiez et diffusez normalement. Vous ne pouvez ni mettre à jour ni supprimer le bus tant qu'il n'est pas revenu àACTIVE. | | UPDATE\_FAILED | Une mise à jour du chiffrement a échoué, encore une fois parce que la clé n'a pas EventBridge pu être utilisée. | Le bus continue de fonctionner avec sa configuration précédente. Réessayez la mise à jour une fois la cause corrigée, ou supprimez le bus. | | DELETING | DeleteEventBusretourné. | Patientez. Vous ne pouvez pas créer d'abonné ou de source d'événement sur un bus en cours de suppression. | | DELETE\_FAILED | La suppression a détecté un abonné ou une source d'événement qui n'a pas été révoqué. | Supprimez à nouveau le bus une fois que ses abonnés et ses sources d'événements ont été supprimés ou révoqués. Rien d'autre n'est accepté. | ## Supprimer un bus qui compte des abonnés `DeleteEventBus`ne réussit que lorsque chaque abonné et chaque source d'événement du bus sont supprimés ou révoqués. Un abonné créé par un autre compte compte. Vous ne pouvez pas supprimer vous-même l'abonné de ce compte, alors demandez au propriétaire de le supprimer ou révoquez-le avec `RevokeResource` ; voir[Révocation d'un abonné ou d'une source d'événement](eb-custom-bus-access-revoke.md). Si un abonné est créé entre votre vérification et la suppression, le bus atterrit `DELETE_FAILED` ; traitez avec le nouvel abonné et supprimez à nouveau. ## Restauration après l'échec d'un changement de clé Les deux états d'échec auxquels un bus en marche peut accéder depuis la AWS KMS clé. Lorsqu'une mise à jour d'une nouvelle clé échoue, réessayez `UpdateEventBus` après avoir corrigé la politique ou l'autorisation de la clé. Si la nouvelle clé elle-même est inutilisable, la nouvelle tentative peut en nommer une autre, car la clé défaillante n' EventBridge a pas été retenue. Ne désactivez pas, ne supprimez pas ou ne supprimez pas EventBridge l'accès à la clé précédente tant que le bus `ACTIVE` contenant la nouvelle clé ne s'`DescribeEventBus`affiche pas. Un bus qui perd son ancienne clé en cours de modification ne peut être réparé qu'en rétablissant cette clé, ou supprimé. Pour les autorisations clés, consultez[Chiffrement des événements sur un bus d'événements personnalisé](eb-custom-bus-encryption.md).