# Managing AWS Supply Chain events using Amazon EventBridge
Using EventBridge, you can automate other services to respond to the execution status changes of a Step Functions Standard Workflow.
Amazon EventBridge is a serverless service that uses events to connect application components together, making it easier for you to build scalable event-driven applications. Event-driven architecture is a style of building loosely-coupled software systems that work together by emitting and responding to events. Events represent a change in a resource or environment.
Here's how it works:
As with many AWS services, AWS Supply Chain generates and sends events to the EventBridge default event bus. (The default event bus is automatically provisioned in every AWS account.) An event bus is a router that receives events and delivers them to zero or more destinations, or *targets*. Rules you specify for the event bus evaluate events as they arrive. Each rule checks whether an event matches the rule's *event pattern*. If the event does match, the event bus sends the event to the specified target(s).
![\[AWS services send events to the EventBridge default event bus. If the event matches a rule's event pattern, EventBridge sends the event to the targets specified for that rule.\]](http://docs.aws.amazon.com/aws-supply-chain/latest/adminguide/images/eventbridge-integration-how-it-works.png)
**Topics**
+ [AWS Supply Chain events](#supported-events)
+ [Delivering AWS Supply Chain events using EventBridge rules](#eventbridge-using-events-rules)
+ [AWS Supply Chain events detail reference](events-detail-reference.md)
## AWS Supply Chain events
AWS Supply Chain sends the following events to the default EventBridge event bus automatically. Events that match a rule's event pattern are delivered to the specified targets on a [ basis](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level). Events might be delivered out of order.
For more information, see [EventBridge events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) in the *Amazon EventBridge User Guide.*
| Event detail type | Description |
| --- | --- |
| [AWS Supply Chain Data Integration Status Change](events-detail-reference.md#event-detail-event-name-1-no-caps-or-spaces) | Displays the status for each ingested file into AWS Supply Chain. |
## Delivering AWS Supply Chain events using EventBridge rules
To have the EventBridge default event bus send AWS Supply Chain events to a target, you must create a rule. Each rule contains an event pattern, which EventBridge matches against each event received on the event bus. If the event data matches the specified event pattern, EventBridge delivers that event to the rule's target(s).
For comprehensive instructions on creating event bus rules, see [Creating rules that react to events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) in the *EventBridge User Guide*.
### Creating event pattern that match AWS Supply Chain events
Each event pattern is a JSON object that contains:
+ A `source` attribute that identifies the service sending the event. For AWS Supply Chain events, the source is `aws.supplychain`.
+ (Optional): A `detail-type` attribute that contains an array of the event types to match.
+ (Optional): A `detail` attribute containing any other event data on which to match.
For example, the following event pattern matches against all `AWS Supply Chain Data Integration Status Change` events from AWS Supply Chain:
```
{
"source": ["aws.supplychain"],
"detail-type": ["AWS Supply Chain Data Integration Status Change"]
}
```
For more information on writing event patterns, see [Event patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) in the *EventBridge User Guide*.
# AWS Supply Chain events detail reference
All events from AWS services have a common set of fields containing metadata about the event, such as the AWS service that is the source of the event, the time the event was generated, the account and region in which the event took place, and others. For definitions of these general fields, see [Event structure reference](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) in the *Amazon EventBridge User Guide*.
In addition, each event has a `detail` field that contains data specific to that particular event. The reference below defines the detail fields for the various AWS Supply Chain events.
When using EventBridge to select and manage AWS Supply Chain events, it's useful to keep the following in mind:
+ The `source` field for all events from AWS Supply Chain is set to `aws.supplychain`.
+ The `detail-type` field specifies the event type.
For example, `AWS Supply Chain Data Integration Status Change`.
+ The `detail` field contains the data that is specific to that particular event.
For information on constructing event patterns that enable rules to match AWS Supply Chain events, see [Event patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) in the *Amazon EventBridge User Guide*.
For more information on events and how EventBridge processes them, see [Amazon EventBridge events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) in the *Amazon EventBridge User Guide*.
## AWS Supply Chain Data Integration Status Change
Below is an example for the `AWS Supply Chain Data Integration Status Change event` event.
```
{
"version": "0",
"id": "instanceID",
"detail-type": "AWS Supply Chain Data Integration Status Change",
"source": "aws.supplychain",
"account": "acccountID",
"time": "2024-03-30T12:26:13Z",
"region": "us-east-1",
"resources": [],
"detail": {
"version": "1.0",
"instanceId": "instanceID",
"flowArn": "arn:aws:scn:region:acccountID:instance/instanceID/data-integration-flows/flowname",
"flowExecutionId": "flowExecutionId",
"status": "IN_PROGRESS",
"startTime": "2024-03-30T12:26:13Z",
"endTime": "",
"message": "",
"sourceType": "S3",
"sourceInfo": {
"s3Source": {
"bucketName": "aws-supply-chain-data-instanceID",
"key": "flowname"
}
}
}
}
```
`endTime` is only available when the *status* is failure or success.