

# Exporting AWS Data Exchange assets to an S3 bucket
<a name="exporting-from-s3"></a>

When you export assets to Amazon S3, the IAM permissions you use must include the ability to read from the AWS Data Exchange service S3 buckets and to write to the S3 bucket where your assets are stored. You can export to any S3 bucket you have permission to access, regardless of ownership. For more information, see [Amazon S3 permissions](access-control.md#additional-s3-permissions).

AWS Data Exchange supports configurable encryption parameters when exporting data sets to Amazon S3. In your export job details, you can specify the Amazon S3 server-side encryption configuration that you want to apply to the exported objects. You can choose to use server-side encryption with Amazon S3-Managed Keys (SSE-S3) or server-side encryption with AWS KMS keys stored in AWS Key Management Service (SSE-KMS). For more information, see [Protecting data using server-side encryption](https://docs.aws.amazon.com//AmazonS3/latest/dev/serv-side-encryption.html) in the *Amazon Simple Storage Service User Guide*. 

**Important**  
We recommend that you consider Amazon S3 security features when exporting data to Amazon S3. For information about general guidelines and best practices, see [Security best practices for Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/security-best-practices.html) in the *Amazon Simple Storage Service User Guide*.

**Important**  
If the provider has marked a product as containing protected health information (PHI) subject to the Health Insurance Portability and Accountability Act of 1996 (HIPAA), you may not export the product's data sets into your AWS account unless such AWS account is designated as a HIPAA account (as defined in the AWS Business Associate Addendum found in [AWS Artifact](https://docs.aws.amazon.com/artifact/latest/ug/what-is-aws-artifact.html)).

You can export up to 100 assets in a single job.

**Topics**
+ [Exporting AWS Data Exchange assets to an S3 bucket (AWS SDKs)](export-assets-s3-prog.md)
+ [Exporting AWS Data Exchange assets to an S3 bucket as a subscriber (console)](export-asset-s3-console-sub.md)
+ [Exporting AWS Data Exchange assets to an S3 bucket as a provider (console)](export-asset-s3-console-prov.md)

The following video explains more about how to export assets from AWS Data Exchange.

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/VpIdwc3zLlo/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/VpIdwc3zLlo)


# Exporting AWS Data Exchange assets to an S3 bucket (AWS SDKs)
<a name="export-assets-s3-prog"></a>

You can use the AWS SDKs to export AWS Data Exchange assets to an S3 bucket using the following instructions.

**To export assets to an S3 bucket (AWS SDKs)**

1. Create a `CreateJob` request of type `EXPORT_ASSETS_TO_S3`.

1. Include the following in the request:
   + `AssetDestinations`
     + `AssetID`
     + `Bucket`
     + `Key`
   + `DataSetID`
   + `Encryption`
     + `KmsKeyArn`
     + `Type`
   + `RevisionID`

1. Start the `CreateJob` request with a `StartJob` operation that requires the `JobId` returned in step 1.

1. (Optional) Update the assets' name property after they are created.

**Note**  
For information about exporting an entire revision as a single job, see [Exporting revisions from AWS Data Exchange](exporting-revisions.md).

# Exporting AWS Data Exchange assets to an S3 bucket as a subscriber (console)
<a name="export-asset-s3-console-sub"></a>

As a subscriber to AWS Data Exchange data products, you can use the AWS Data Exchange console to export AWS Data Exchange assets to an S3 bucket using the following instructions.

**To export an asset to an S3 bucket as a subscriber (console)**

1. Open your web browser and sign in to the [AWS Data Exchange console](https://console.aws.amazon.com/dataexchange).

1. In the left side navigation pane, for **My subscriptions**, choose **Entitled data**.

1. In **Entitled data**, choose the product that has the revision you want to export.

1. In **Entitled data sets**, choose the data set.

1. On the **Revisions** tab, choose the revision.

1. From the **Assets** tab, select the check box next to the assets that you want to export.

1. Select **Export actions** and then choose **Export selected assets to Amazon S3**.

1. Follow the prompts in the **Export to Amazon S3** window and then choose **Export**. 

   A job is started to export your asset. After the job is finished, the **State** field in the **Jobs** section is updated to **Completed**.

# Exporting AWS Data Exchange assets to an S3 bucket as a provider (console)
<a name="export-asset-s3-console-prov"></a>

As a provider of AWS Data Exchange data products, you can use the AWS Data Exchange console to export AWS Data Exchange assets to an S3 bucket using the following instructions.

**To export an asset to an S3 bucket as a provider (console)**

1. Open your web browser and sign in to the [AWS Data Exchange console](https://console.aws.amazon.com/dataexchange).

1. In the left side navigation pane, for **Publish data**, choose **Owned data sets**.

1. In **Owned data sets**, choose the data set that has the asset you want to export.

1. Navigate to the **Products** tab to make sure that the data set is associated with a published product.

1. From the **Revisions** tab, select the revision.

1. For the **Imported assets** section, select the check box next to the asset name.

1. Select **Export actions** and then choose **Export selected assets to Amazon S3**.

1. Follow the prompts in the **Export to Amazon S3** window and then choose **Export**. 

   A job is started to export your asset. After the job is finished, the **State** field in the **Jobs** section is updated to **Completed**.