AWS Data Exchange
API Reference

Welcome

Welcome to the AWS Data Exchange API Reference. AWS Data Exchange is a service that makes it easy for AWS customers to exchange data in the cloud. You can use the AWS Data Exchange APIs create, update, manage, and access file-based data set in the AWS Cloud.

As a subscriber, you can view and access the data sets that you have an entitlement to through a subscription. You can use the APIS to download or copy your entitled data sets to Amazon S3 for use across a variety of AWS analytics and machine learning services.

As a provider, you can create and manage your data sets that you would like to publish to a product. Being able to package and provide your data sets into products requires a few steps to determine eligibility.

A data set is a collection of data that can be changed or updated over time. Data sets can be updated using revisions, which represent a new version or incremental change to a data set. A revision contains one or more assets. An asset in AWS Data Exchange is a piece of data that can be stored as an Amazon S3 object. The asset can be a structured data file, an image file, or some other data file. Jobs are asynchronous import or export operations used to create or copy assets.

To learn more about these and other AWS Data Exchange concepts, including procedures, best practices, and AWS Marketplace integration, see the AWS Data Exchange User Guide.

Data Sets and Product Details

The AWS Data Exchange APIs allow you to manage and interact with data sets. You can perform product publishing and product subscription operations through the AWS Marketplace Catalog API or the AWS Data Exchange console. For more information, see the AWS Data Exchange User Guide.

Service Limits

For information about the limits for using AWS Data Exchange, see AWS Data Exchange Limits in the AWS Data Exchange User Guide.

API Access Control

You use AWS Identity and Access Management (IAM) to create IAM roles and assign policies that grant limited permissions to end users. The policies define the actions the role can take on your data sets, revisions, assets, and associated jobs in the AWS Data Exchange API. For example, you can define roles such as engineering, marketing, and pricing. A user in your organization who has been added to the engineering role might be granted permissions to import an asset from Amazon S3, but cannot finalize a revision for your data set.

For more information about AWS Data Exchange permissions, including managed policies, and a permissions reference for the AWS Data Exchange actions and resources, see Identity and Access Management in AWS Data Exchange in the AWS Data Exchange User Guide.

Endpoints and AWS Regions

The following AWS Regions are endpoints are supported for AWS Data Exchange:

  • US East (N. Virginia) – dataexchange.us-east-1.amazonaws.com

  • US East (Ohio) – dataexchange.us-east-2.amazonaws.com

  • US West (N. California) – dataexchange.us-west-1.amazonaws.com

  • US West (Oregon) – dataexchange.us-west-2.amazonaws.com

  • Asia Pacific (Tokyo) – dataexchange.ap-northeast-1.amazonaws.com

  • Asia Pacific (Seoul) – dataexchange.ap-northeast-2.amazonaws.com

  • Asia Pacific (Singapore) – dataexchange.ap-southeast-1.amazonaws.com

  • Asia Pacific (Sydney) – dataexchange.ap-southeast-2.amazonaws.com

  • Europe (Frankfurt) – dataexchange.eu-central-1.amazonaws.com

  • Europe (Ireland) – dataexchange.eu-west-1.amazonaws.com

  • Europe (London) – dataexchange.eu-west-2.amazonaws.com