Amazon EventBridge events - AWS Data Exchange User Guide

Amazon EventBridge events

AWS Data Exchange is integrated with Amazon EventBridge, formerly called Amazon CloudWatch Events. EventBridge is an event bus service that you can use to connect your applications with data from a variety of sources. For more information, see the Amazon EventBridge User Guide.

As a subscriber with an active subscription to a product, you receive an event from AWS Data Exchange every time the provider publishes new revisions or adds new data sets to an existing product. The event contains the DataSetId and the list of RevisionIds that have been published.

Providers can send notifications corresponding to data updates, data delays, schema changes, and deprecations. Providers have the option to include comments and expected actions for subscribers to follow. Subscribers receive these notifications as events in Amazon EventBridge, which they can use to build automated workflows or deliver human-readable notifications to emails and chat programs using AWS User Notifications.

Data product related events are emitted in the AWS Region where the provider published the data set. You must set up EventBridge rules that use these events in the same AWS Region or see Sending and receiving Amazon EventBridge events between AWS Regions for more options.

This topic provides detailed information about each event listed in the following table. The table includes events received by a subscriber when a provider adds a data set to a product, adds a revision to a product, revokes a revision to a product, or removes access to a product.

Actions Event received by subscriber Related topic
Adds a file-based data set to a product and publishes it Data Sets Published To Product Events for adding file-based data sets
Adds an Amazon S3 data access data set to a product and publishes it Amazon S3 Data Access Data Sets Published To Product Events for adding Amazon S3 data access data sets
Adds an AWS Lake Formation data permission data set and publishes it AWS Lake Formation Data Permission Data Set Published To Product Events for adding AWS Lake Formation data permission data sets (Preview)
Adds an Amazon Redshift data set to a product and publishes it Redshift Data Shares Data Sets Published To Product Events for adding Amazon Redshift datashare data sets
Adds an Amazon API Gateway data set to a product and publishes it API Gateway API Data Sets Published To Product Events for adding Amazon API Gateway API data sets
Adds a file-based data set revision to a product and publishes it Revision Published To Data Set Events for adding revisions
Adds an Amazon S3 data access data set revision to a product and publishes it Revision Published to Amazon S3 Data Access Data Set Events for adding Amazon S3 data access data set revisions
Adds an AWS Lake Formation data permission data set revision to a product and publishes it Revision Published To Lake Formation Data Permission Data Set Events for adding AWS Lake Formation data permission data set revisions (Preview)
Adds an Amazon Redshift datashare data set revision to a product and publishes it Revision Published To Redshift Data Shares Data Set Events for adding Amazon Redshift datashare data set revisions
Adds an Amazon API Gateway data set revision to a product and publishes it Revision Published To API Gateway API Data Set Events for adding Amazon API Gateway API data set revisions
Revokes revision to a product Revision Revoked Events for revoking revisions
Takes an action on their Amazon Redshift resources that might remove access from a subscriber Action Performed On Redshift Data Share By Provider Events for an action performed on an Amazon Redshift resource
Takes an action on their Amazon Redshift resources that removes access from a subscriber Redshift Data Share Access Lost Events for losing access to an Amazon Redshift datashare
Sends a notification for a data update Data Updated in Data Set Events for a provider-generated notification of a data update
Sends a notification for a schema change Schema Change Planned for Data Set Events for a provider-generated notification of a schema change
Sends a notification for a data delay Data Set Update Delayed Events for a provider-generated notification of a data delay
Sends a notification for a data deprecation Deprecation Planned for Data Set Events for a provider-generated notification of a data deprecation
Auto-export job completed Auto-export Job Completed Events for an auto-export job completed
Auto-export job failed Auto-export Job Failed Events for an auto-export job failed
Note

AWS Data Exchange emits events on a best effort basis. For more information about event delivery, see Events from AWS services.

Events for adding file-based data sets

When a provider adds file-based data sets to a product and publishes it, the subscriber receives an event with the following detail type: Data Sets Published To Product.

The following is an example event body for an added file-based data set.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Data Sets Published To Product", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id" : "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon S3 data access data sets

When a provider adds an Amazon S3 data access data set to a product and publishes it, the subscriber receives an event with the following detail type: Amazon S3 Data Access Data Sets Published To Product.

The following is an example event body for an added Amazon S3 data access data set.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "S3 Data Access Data Set(s) Published to Product", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [{ "Id": "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id": "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id": "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding AWS Lake Formation data permission data sets (Preview)

When a provider adds an AWS Lake Formation data permission data set to a product and publishes it, the subscriber receives an event with the following detail type: Lake Formation Data Permission Data Sets Published To Product. (Preview)

The following is an example event body for adding an AWS Lake Formation data permission data set. (Preview)

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Lake Formation Data Permission Data Sets Published To Product", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [ { "Id": "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id": "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id": "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon Redshift datashare data sets

When a provider adds an Amazon Redshift datashare data set to a product and publishes it, the subscriber receives an event with the following detail type: Redshift Data Shares Data Sets Published To Product.

The following is an example event body for an added Amazon Redshift datashare data set.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Redshift Data Shares Data Sets Published To Product", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id" : "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon API Gateway API data sets

When a provider adds an Amazon API Gateway API data set to a product and publishes it, the subscriber receives an event with the following detail type: Amazon API Gateway Data Sets Published To Product.

The following is an example event body for an added Amazon API Gateway API data set.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "API Gateway API Data Sets Published To Product", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id" : "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding revisions

When a provider adds a data set to a product and publishes it, the subscriber receives an event with the following detail type: Revision Published To Data Set.

The following is an example event body for an added revision.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Published To Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T04:16:28Z", "region": "us-east-1", "resources": [ "aae4c2cdEXAMPLE54f9369dEXAMPLE66" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [ { "Id" : "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" } ], "DataSets": [ { "Id" : "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon S3 data access data set revisions

When a provider adds an Amazon S3 data access data set revision to a product and publishes it, the subscriber receives an event with the following detail type: Revision Published To Amazon S3 Data Access Data Set.

The following is an example event body for an added Amazon S3 data access data set revision.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Published to S3 Data Access Data Set(s)", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T04:16:28Z", "region": "us-east-1", "resources": [ "aae4c2cdEXAMPLE54f9369dEXAMPLE66" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [ { "Id" : "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" } ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding AWS Lake Formation data permission data set revisions (Preview)

When a provider adds an AWS Lake Formation data permission data set revision to a product and publishes it, the subscriber receives an event with the following detail type: Revision Published to Lake Formation Data Permission Data Set (Preview).

The following is an example event body for a revision added to an AWS Lake Formation data permission data set. (Preview)

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Published to Lake Formation Data Permission Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [ { "Id": "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id": "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id": "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon Redshift datashare data set revisions

When a provider adds an Amazon Redshift datashare data set revision to a product and publishes it, the subscriber receives an event with the following detail type: Revision Published To Redshift Data Shares Data Set.

The following is an example event body for an added Amazon Redshift datashare data set revision.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Published To Redshift Data Shares Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "aae4c2cdEXAMPLE54f9369dEXAMPLE66" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [ { "Id" : "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" } ], "DataSets": [ { "Id" : "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for adding Amazon API Gateway API data set revisions

When a provider adds an Amazon API Gateway API data set revision to a product and publishes it, the subscriber receives an event with the following detail type: Revision Published To API Gateway Data Set.

The following is an example event body for an added Amazon API Gateway API data set revision.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Published To API Gateway API Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "aae4c2cdEXAMPLE54f9369dEXAMPLE66" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [ { "Id" : "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" } ], "DataSets": [ { "Id" : "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

The following table describes the API Gateway API data set revision error codes.

Error code Message Description
CLUSTER_DELETED The datashare is unavailable because the provider deleted their cluster. Please contact the provider for more information. This message is sent when the datashare is no longer available because the provider deleted the cluster containing the datashare.
CLUSTER_ENCRYPTION_DISABLED The datashare is unavailable because the provider disabled encryption on their cluster. Please contact the provider for more information. This message is sent when the datashare is no longer available because the provider disabled encryption on their cluster. To use a datashare, both the provider and the subscriber must have encryption enabled.
DATASHARE_DELETED The datashare is unavailable because the provider deleted the datashare. Please contact the provider for more information. This message is sent when the datashare is no longer available because the provider deleted it. The provider must create a new datashare so that you can regain access to the data.
DATASHARE_DEAUTHORIZED The datashare is unavailable because the provider deauthorized the datashare. Please contact the provider for more information. This message is sent when the datashare is no longer available because the provider deauthorized the datashare. The provider must create a new datashare so that you can regain access to the data.
DATASHARE_PUBLIC_CONSUMER_BLOCKED You cannot access a non-publicly accessible datashare from a publicly accessible cluster. You must turn off public accessibility on your cluster to access this datashare. Please contact your provider for more information.

This message is sent when a provider sets the Publicly accessible option to Disable on the cluster that contains their datashare. If the subscriber's cluster has the Publicly accessible option set to Disable, it will not affect their ability to access the datashare. For the subscriber to access the datashare, either the subscriber must set the Publicly accessible option to Disable on their cluster, or the provider must set the Publicly accessible option to Enable on their cluster.

Disable on the cluster that contains their datashare. If the subscriber's cluster has the Publicly accessible option set to Disable, it will not affect their ability to access the datashare. For the subscriber to access the datashare, either the subscriber must set the Publicly accessible option to Disable on their cluster, or the provider must set the Publicly accessible option to Enable on their cluster.

Events for revoking revisions

When a provider revokes a revision to a product and publishes it, the subscriber receives an event with the following detail type: Revision Revoked.

The following is an example event body for a revoked revision.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Revision Revoked", "source": "aws.dataexchange", "account": "123456789012", "time": "2022-02-17T21:25:06Z", "region": "us-east-1", "resources": [ "aae4c2cdEXAMPLE54f9369dEXAMPLE66" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "RevocationComment": "example revocation comment", "Revisions": [ { "Id" : "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" } ], "DataSets": [ { "Id" : "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } }

Events for an action performed on an Amazon Redshift resource

When a provider takes an action on their Amazon Redshift resources that might remove access from a subscriber, the subscriber receives an event with the following detail type: Action Performed On Redshift Data Share By Provider.

For example, if a provider changes the data share's public accessibility setting from true to false, the subscriber receives an event.

The following is an example event body for an action performed on an Amazon Redshift resource.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Action Performed On Redshift Data Share By Provider", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "arn:aws:redshift:us-east-1:098765432123:datashare:01234567-2590-7654-1234-f57ea0081234/test_data_share" ], "detail": { "Message": "This is an example message which explains why you may have lost access.", "AssociatedProducts": [ { "ProductId": "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8" ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "Name": "Product_Hello_World" } } ] } }

Events for losing access to an Amazon Redshift datashare

When a provider takes an action on their Amazon Redshift resources that removes access from a subscriber, the subscriber receives an event with the following detail type: Redshift Data Share Access Lost.

For example, if a provider deletes an Amazon Redshift datashare or deletes a cluster, the subscriber receives an event.

The following is an example event body for losing access to an Amazon Redshift datashare.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Redshift Data Share Access Lost", "source": "aws.dataexchange", "account": "123456789012", "time": "2021-12-15T18:24:04Z", "region": "us-east-1", "resources": [ "arn:aws:redshift:us-east-1:098765432123:datashare:01234567-2590-7654-1234-f57ea0081234/test_data_share" ], "detail": { "Message": "This is an example message which explains why you may have lost access.", "AssociatedProducts": [ { "ProductId": "aae4c2cdEXAMPLE54f9369dEXAMPLE66", "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8" ], "DataSets": [ { "Id" : "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" } ], "Product": { "Id" : "prod-uEXAMPLEabc1d", "Name": "Product_Hello_World" } } ] } }

Events for an auto-export job completed

After an auto-export job moves all the data in a newly published File data set revision to the subscriber's chosen Amazon S3 bucket, the subscriber receives an Auto-export Job Completed event.

The following is an example event body for an auto-export job completed.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Auto-export Job Completed", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [{ "Id": "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" }], "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", ], "DataSets": [{ "Id": "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, ], "Product": { "Id": "prod-uEXAMPLEabc1d", } } }

Events for an auto-export job failed

When an auto-export job fails, the subscriber receives an Auto-export Job Failed event.

The following is an example event body for an Auto-export Job Failed.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Auto-Export job failed", "source": "aws.dataexchange", "account": "123456789012", "time": "2020-07-29T18:24:04Z", "region": "us-east-1", "resources": [ "prod-uEXAMPLEabc1d" ], "detail": { "RevisionIds": [ "3afc623EXAMPLE099e6fcc8EXAMPLEe7" ], "Revisions": [{ "Id": "3afc623EXAMPLE099e6fcc8EXAMPLEe7", "Comment": "Revision_Comment_One" }], "DataSetIds": [ "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "5bgd734EXAMPLE100f7gdd9EXAMPLEe9" ], "DataSets": [{ "Id": "4afc623EXAMPLE099e6fcc8EXAMPLEe8", "Name": "Data_Set_Hello_World_One" }, { "Id": "5bgd734EXAMPLE100f7gdd9EXAMPLEe9", "Name": "Data_Set_Hello_World_Two" } ], "Product": { "Id": "prod-uEXAMPLEabc1d", } } }

Events for a provider-generated notification of a data update

When a provider sends a notification for a data update, the subscriber receives an event with the following detail type: Data Updated in Data Set.

The following is an example event body for a notification when a provider sends a notification for a data update.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Data Updated in Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2023-08-21T10:29:48Z", "region": "us-east-1", "resources": [ "arn:aws:dataexchange:us-east-1::data-sets/b5538f9f45e4613d448eb9eEXAMPLEc6" ], "detail": { "DataSet": { "Id": "b5538f9f45e4613d448eb9eEXAMPLEc6", "Name": "Example Data Set", "AssetType": "S3_DATA_ACCESS" }, "Product": { "Id": "prod-7ip6EXAMPLEhs", "Name": "Example Data Product", "ProviderContact": "no-reply@marketplace.aws" }, "Notification": { "Comment": "This is a test DATA_UPDATE notification.", "Type": "DATA_UPDATE", "Details": { "DataUpdate": { "DataUpdatedAt": "2023-07-12T00:00:00Z" } }, "Scope": { "S3DataAccesses": [{ "KeyPrefixes": [ "KeyPrefix" ], "Keys": [ "KeyA", "KeyB" ] }] } } } }

Events for a provider-generated notification of a schema change

When a provider sends a notification for a schema change, the subscriber receives an event with the following detail type: Schema Change Planned for Data Set.

The following is an example event body for a notification when a provider sends a schema change notification.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Schema Change Planned for Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2023-08-21T10:29:48Z", "region": "us-east-1", "resources": [ "arn:aws:dataexchange:us-east-1::data-sets/b5538f9f45e4613d448eb9eEXAMPLEc6" ], "detail": { "DataSet": { "Id": "b5538f9f45e4613d448eb9eEXAMPLEc6", "Name": "Example Data Set", "AssetType": "S3_DATA_ACCESS" }, "Product": { "Id": "prod-7ip6EXAMPLEhs", "Name": "Example Data Product", "ProviderContact": "no-reply@marketplace.aws" }, "Notification": { "Comment": "This is a test SCHEMA_CHANGE notification.", "Type": "SCHEMA_CHANGE", "Details": { "SchemaChange": { "Changes": [{ "Type": "ADD", "Description": "This object is being added to the bucket or a field is being added to the object.", "Name": "KeyA" }, { "Type": "REMOVE", "Description": "This object is being removed from the bucket or a field is being removed from the object.", "Name": "KeyB" }, { "Type": "MODIFY", "Description": "The usage or meaning of this key prefix is changing or something is changing about every file under this key prefix.", "Name": "KeyPrefix" } ], "SchemaChangeAt": "2023-09-08T13:46:01Z" } }, "Scope": { "S3DataAccesses": [{ "KeyPrefixes": [ "KeyPrefix" ], "Keys": [ "KeyA", "KeyB" ] }] } } } }

Events for a provider-generated notification of a data delay

When a provider sends a notification for a data delay, the subscriber receives an event with the following detail type: Data Set Update Delayed.

The following is an example event body for a notification when a provider sends a data delay notification.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Data Set Update Delayed", "source": "aws.dataexchange", "account": "123456789012", "time": "2023-08-21T10:29:48Z", "region": "us-east-1", "resources": [ "arn:aws:dataexchange:us-east-1::data-sets/b5538f9f45e4613d448eb9eEXAMPLEc6" ], "detail": { "DataSet": { "Id": "b5538f9f45e4613d448eb9eEXAMPLEc6", "Name": "Example Data Set", "AssetType": "S3_DATA_ACCESS" }, "Product": { "Id": "prod-7ip6EXAMPLEhs", "Name": "Example Data Product", "ProviderContact": "no-reply@marketplace.aws" }, "Notification": { "Comment": "This is a test DATA_DELAY notification.", "Type": "DATA_DELAY", "Scope": { "S3DataAccesses": [{ "KeyPrefixes": [ "KeyPrefix" ], "Keys": [ "KeyA", "KeyB" ] }] } } } }

Events for a provider-generated notification of a data deprecation

When a provider sends a notification for a data deprecation, the subscriber receives an event with the following detail type: Deprecation Planned for Data Set.

The following is an example event body for a notification when a provider sends a notification of a data deprecation.

{ "version": "0", "id": "dc529cb6-2e23-4c5f-d020-EXAMPLE92231", "detail-type": "Deprecation Planned for Data Set", "source": "aws.dataexchange", "account": "123456789012", "time": "2023-08-21T10:29:48Z", "region": "us-east-1", "resources": [ "arn:aws:dataexchange:us-east-1::data-sets/b5538f9f45e4613d448eb9eEXAMPLEc6" ], "detail": { "DataSet": { "Id": "b5538f9f45e4613d448eb9eEXAMPLEc6", "Name": "Example Data Set", "AssetType": "S3_DATA_ACCESS" }, "Product": { "Id": "prod-7ip6EXAMPLEhs", "Name": "Example Data Product", "ProviderContact": "no-reply@marketplace.aws" }, "Notification": { "Comment": "This is a test DEPRECATION notification.", "Type": "DEPRECATION", "Details": { "Deprecation": { "DeprecationAt": "2023-09-08T13:46:01Z" } }, "Scope": { "S3DataAccesses": [{ "KeyPrefixes": [ "KeyPrefix" ], "Keys": [ "KeyA", "KeyB" ] }] } } } }