Jobs in AWS Data Exchange - AWS Data Exchange User Guide
Job propertiesAWS Regions and jobsImporting assetsExporting assetsExporting revisions

Jobs in AWS Data Exchange

AWS Data Exchange jobs are asynchronous import or export operations.

As a provider, you can create and manage your data sets that you want to publish to a product. You can download (export) or copy your assets or revisions to Amazon Simple Storage Service (Amazon S3) or a signed URL. In addition, providers can import assets from an Amazon API Gateway API or import assets from an Amazon Redshift data set.

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

To create or copy assets or copy revisions through jobs, you can use the AWS Management Console, AWS Command Line Interface (AWS CLI), your own REST application, or one of the AWS SDKs.

Jobs are deleted 90 days after they are created.

Job properties

Jobs have the following properties:

  • Job ID – An ID generated when the job is created that uniquely identifies the job.

  • Job type – The following job types are supported:

    • Import from Amazon S3

    • Import an AWS Lake Formation data permission (Preview)

    • Import from signed URL

    • Import from Amazon API Gateway API

    • Import from an AWS Data Exchange datashare for Amazon Redshift

    • Import an Amazon S3 data access

    • Export to Amazon S3

    • Export to signed URL

  • Amazon Resource Name (ARN) – A unique identifier for AWS resources.

  • Job state – The job states are WAITING, IN_PROGRESS, COMPLETED, CANCELLED, ERROR, or TIMED_OUT. When a job is created, it's in the WAITING state until the job is started.

  • Job details – Details of the operation to be performed by the job, such as export destination details or import source details.

Example job resource
{
    "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/6cEXAMPLE818f7c7a23b3d0EXAMPLE1c",
    "Id": "6cEXAMPLE818f7c7a23b3d0EXAMPLE1c",
    "State": "COMPLETED",
    "Type": "IMPORT_ASSETS_FROM_S3",
    "CreatedAt": "2019-10-11T14:12:24.640Z",
    "UpdatedAt": "2019-10-11T14:13:00.804Z",
    "Details": {
        "ImportAssetsFromS3": {
            "AssetSources": [
                {
                    "Bucket": "DOC-EXAMPLE-BUCKET",
                    "Key": "MyKey"
                }
            ],
            "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f",
            "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42"
        }
    }
}

AWS Regions and jobs

If you import or export an asset to or from an Amazon S3 bucket that is in an AWS Region that is different than the data set's Region, your AWS account is charged for the data transfer costs, according to Amazon S3 data transfer pricing policies.

If you export assets to a signed URL, your AWS account is charged for data transfer costs from Amazon S3 to the internet according to Amazon S3 pricing policies.

When your subscription to an AWS Data Exchange for Files data set ends, you retain access to any files that you already exported. Review your Data Subscription Agreement to verify if your agreement requires that you delete exported data when ending a subscription.

Importing assets

You can import assets to a revision in the following ways:

Importing assets from an S3 bucket

When you import assets from Amazon S3 to AWS Data Exchange, the AWS Identity and Access Management (IAM) permissions you use must include the ability to write to the AWS Data Exchange service S3 buckets and to read from the S3 bucket where your assets are stored. You can import from any S3 bucket that you have permission to access, regardless of ownership. For more information, see Amazon S3 permissions.

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

Importing assets from an S3 bucket (AWS SDKs)

To import assets from an Amazon S3 bucket (AWS SDKs)

  1. Create a CreateJob request of type IMPORT_ASSETS_FROM_S3.

  2. Include the following in the request:

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

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

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

Importing assets from an S3 bucket (console)

To import an asset from an S3 bucket (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the data set that has the revision you want to update.

  4. On the Revisions tab, choose Create revision to open the Create revision page.

    1. For Revision settings, provide an optional comment for your revision that describes the purpose of the revision.

    2. For Add tags – optional, add tags associated with the resource.

    3. Choose Create.

      Your new revision is created.

  5. For the Jobs section, choose Import from Amazon S3.

  6. Follow the prompts in the Import from Amazon S3 window, and then choose Import assets.

    A job is started to import your asset into your data set. After the job is finished, the State field in the Jobs section is updated to Completed.

Importing assets from a signed URL

You can use signed URLs to import assets that are not stored in Amazon S3.

Importing assets from a signed URL (AWS SDKs)

To import assets from a signed URL (AWS SDKs)

  1. Create a CreateJob request of type IMPORT_ASSET_FROM_SIGNED_URL.

  2. Include the following in the request:

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

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

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

  5. The response details include the SignedUrl that you can use to import your file.

Note

The signed URL expires one minute after it's created.

Importing assets from a signed URL (console)

To import an asset from a signed URL (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the data set that has the asset you want to update.

  4. On the Revisions tab, choose Create revision to open the Create revision page.

    1. For Revision settings, provide an optional comment for your revision that describes the purpose of the revision.

    2. For Add tags – optional, add tags associated with the resource.

    3. Choose Create.

      Your new revision is created.

  5. For the Jobs section, choose Upload.

  6. Follow the prompts in the upload window, and then choose Open.

    A job is started to import your asset into your data set. After the job is finished, the State field in the Jobs section is updated to Completed.

Importing assets from an Amazon API Gateway API

AWS Data Exchange subscribers can use their IAM credentials and AWS SDKs to call APIs from data providers. AWS Data Exchange manages access to APIs by handling authentication and subscription entitlements.

Importing API assets from an Amazon API Gateway API (AWS SDKs)

Note

Currently, the SendApiAsset operation is not supported for the following SDKs:

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

To import assets from an Amazon API Gateway API (AWS SDKs)

  1. Create a CreateJob request of type IMPORT_ASSET_FROM_API_GATEWAY_API.

  2. Include the following in the request:

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

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

  4. (Optional) Poll the GetJob operation to wait for the job to complete.

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

Importing API assets from an Amazon API Gateway API (console)

To import an asset from an Amazon API Gateway API (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the data set that has the asset you want to update.

  4. On the Revisions tab, choose Create revision to open the Create revision page.

    1. For Revision settings, provide an optional comment for your revision that describes the purpose of the revision.

    2. For Add tags – optional, add tags associated with the resource.

    3. Choose Create.

      Your new revision is created.

  5. For the API assets section, choose Add API stage.

  6. On the Add API stage page, select the Amazon API Gateway API and the Stage name from your AWS account or another account.

  7. For Document API for subscribers:

    1. Update the API name to a clear and concise name that subscribers can understand.

    2. Document the OpenAPI 3.0 specification by entering the specification in the field, importing the specification by choosing Import from .JSON file, or importing the specification by choosing Import from Amazon API Gateway.

  8. Choose Add API stage.

    A job is started to import your API assets into your data set. After the job is finished, the State field in the Jobs section is updated to Completed.

Importing assets from an AWS Data Exchange datashare for Amazon Redshift

When you import assets using AWS Data Exchange datashare for Amazon Redshift, you can begin querying, analyzing, and operationalizing third-party Amazon Redshift tables after subscribing.

Importing assets from an AWS Data Exchange datashare for Amazon Redshift (AWS SDKs)

To import assets from an AWS Data Exchange datashare for Amazon Redshift (AWS SDKs)

  1. Create a CreateJob request of type IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES.

  2. Include the following in the request:

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

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

  4. (Optional) Poll the GetJob operation to wait for the job to complete.

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

Importing assets from an AWS Data Exchange datashare for Amazon Redshift (console)

To import an asset from an ADE datashare (for Amazon Redshift console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the data set that has the asset you want to update.

  4. On the Revisions tab, choose Create revision to open the Create revision page.

    1. For Revision settings, provide an optional comment for your revision that describes the purpose of the revision.

    2. For Add tags – optional, add tags associated with the resource.

    3. Choose Create.

      Your new revision is created.

  5. For the AWS Data Exchange datashares for Amazon Redshift section, choose Add datashares.

  6. On the Add AWS Data Exchange datashare to revision page, select the datashare or datashares that you want to add.

  7. Choose Add datashare(s).

    A job is started to import your assets into your data set. After the job is finished, the State field in the Jobs section is updated to Completed.

Importing assets from AWS Lake Formation (Preview)

When you import assets from AWS Lake Formation to AWS Data Exchange, the IAM permissions that you use must include the following abilities:

  • Write to, grant, and revoke Lake Formation permissions

  • Create resource shares for tables, databases, and catalogs

  • Update, delete, associate, and disassociate resource shares for any resource share beginning with Lake Formation

For more information about required and recommended IAM permissions, see Identity and access management in AWS Data Exchange.

Importing assets from AWS Lake Formation (Preview) (AWS SDKs)

To import assets from AWS Lake Formation (Preview) (AWS SDKs)

  1. Create a CreateJob request of type Import_Assets_From_Lake_Formation_Tag_Policy.

  2. Include the following in the request:

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. Start the CreateJob request with a StartJob operation that requires the JobId.

  4. (Optional) Poll the GetJob operation to wait for the job to complete.

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

Importing assets from AWS Lake Formation (Preview) (console)

To import an asset from AWS Lake Formation (Preview) (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the data set that has the revision you want to update.

  4. On the Revisions tab, choose Create revision to open the Create revision page.

    1. For Revision settings, provide an optional comment for your revision that describes the purpose of the revision.

    2. For Add tags – optional, add tags associated with the resource.

    3. Choose Create.

      Your new revision is created.

  5. For the Lake Formation data permission section, choose Add LF-Tag.

  6. Choose the Key and Values that you want to add and choose Add LF-Tag.

    1. (Optional) Choose Preview Resource(s) to view the associated data catalog resources that you are granting permission.

  7. In Service access, select the Role to import the AWS Lake Formation resources into AWS Data Exchange.

  8. Choose Create Lake Formation data permission.

    A job is started to import your assets into your data set. After the job is finished, the State field in the Jobs section is updated to Completed.

Exporting assets

Both providers and subscribers can export assets from a published revision of a product. There are two ways you can export assets:

Exporting assets to an S3 bucket

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.

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 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 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).

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

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

Exporting assets to an S3 bucket (AWS SDKs)

To export assets to an S3 bucket (AWS SDKs)

  1. Create a CreateJob request of type EXPORT_ASSETS_TO_S3.

  2. Include the following in the request:

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

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

  4. (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.

Exporting assets to an S3 bucket as a subscriber (console)

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.

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

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

  4. In Entitled data sets, choose the data set.

  5. On the Revisions tab, choose the revision.

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

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

  8. 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 assets to an S3 bucket as a provider (console)

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.

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

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

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

  5. From the Revisions tab, select the revision.

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

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

  8. 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 assets to a signed URL

You can use signed URLs to export assets that are not stored in Amazon S3.

Exporting assets to a signed URL (AWS SDKs)

You can use signed URLs to export assets to destinations other than S3 buckets.

To export assets to a signed URL (AWS SDKs)

  1. Create a CreateJob request of type EXPORT_ASSET_TO_SIGNED_URL.

  2. Include the following in the request:

    • AssetID

    • DataSetID

    • RevisionID

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

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

  5. The response details include the SignedUrl that you can use to import your file.

Note

The signed URL expires one minute after it's created.

Exporting assets to a signed URL as a subscriber (console)

To export an asset to a signed URL as a subscriber (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

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

  4. In Entitled data sets, choose the data set.

  5. On the Revisions tab, choose the revision.

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

  7. Select Export actions and then choose Download selected assets.

    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 assets to a signed URL as a provider (console)

To export an asset to a signed URL as a provider (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the product that has the revision you want to export.

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

  5. On the Revisions tab, choose the revision.

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

  7. Select Export actions and then choose Download selected assets.

    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 revisions

Both providers and subscribers can export revisions of a data set to an S3 bucket that they have permissions to access.

AWS Data Exchange supports configurable encryption parameters when exporting revisions 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 KMS keys stored in AWS Key Management Service (SSE-KMS). For more information, see Protecting data using server-side encryption in the Amazon Simple Storage Service Developer 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).

The following video explains more about how to export assets from AWS Data Exchange (starting at 2:18).

Exporting revisions to an S3 bucket (AWS SDKs)

To export a revision to an S3 bucket (AWS SDKs)

  1. Create a CreateJob request of type EXPORT_REVISIONS_TO_S3.

  2. Include the following in the request:

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

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

  4. The newly created assets have a name property equal to the original S3 object's key. The Amazon S3 object key defaults to the key pattern ${Asset.Name}.

    You can update the assets' name property after they are created.

    For more information about key patterns, see Key patterns when exporting revisions.

Note

If you are using DataSet.Name as the dynamic reference, you must have the IAM permission dataexchange:GetDataSet. For more information, see AWS Data Exchange API permissions: actions and resources reference.

Exporting revisions to an S3 bucket as a provider (console)

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

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

  3. In Owned data sets, choose the product that has the revision you want to export.

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

  5. On the Revisions tab, choose the revision.

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

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

  8. 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 revisions to an S3 bucket as a subscriber (console)

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

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

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

  4. In Entitled data sets, choose the data set.

  5. On the Revisions tab, select the revision, and then choose Export to Amazon S3.

  6. In Export revision to Amazon S3, select a destination option, Amazon S3 bucket folder destination, configure encryption options, and then choose Export.

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

Automatically exporting revisions to an S3 bucket as a subscriber

When the provider publishes new revisions, you can select to automatically export new revisions to your Amazon S3 bucket. You can export new revisions to up to five S3 buckets. New revisions will automatically appear in the S3 buckets you have selected.

Note

To automatically export revisions to an S3 bucket of your choice, your S3 bucket must have a bucket policy with permissions set to allow AWS Data Exchange to export data into it. For more information, see Prerequisites for S3 bucket policy permissions.

Prerequisites for S3 bucket policy permissions

Before you can automatically export revisions to an S3 bucket, you must disable requester pays and your S3 bucket must have a bucket policy with permissions set to allow AWS Data Exchange to export data into it. The following procedures provide information about how to either edit your existing S3 bucket policy or create an S3 bucket policy with these permissions.

If your S3 bucket is configured for SSE-KMS encryption, the user configuring the auto-export job must have CreateGrant permission on the KMS key for AWS Data Exchange to copy the objects into your S3 bucket.

Important

To verify that the prerequisites for S3 bucket policy permissions are met, an object with the naming format _ADX-TEST-ACCOUNTID# is added to the S3 bucket during the automatic export process.

Editing an existing S3 bucket policy

If your S3 bucket has a bucket policy, complete the following procedure to allow AWS Data Exchange to export data to it.

To edit an existing S3 bucket policy

  1. Navigate to the bucket to which you want to export revisions.

  2. Select the Permissions tab, and choose Edit in the bucket policy section.

  3. Copy the following statement and paste it at the end of the statement list.

    
    {
      "Effect": "Allow",
      "Principal": {
      "Service": "dataexchange.amazonaws.com"
      },
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl"
      ],
      "Resource": "arn:aws:s3:::<BUCKET-NAME>/*",
      "Condition": {
        "StringEquals": { 
          "aws:SourceAccount": "<AWS ID>"
        }
      }
    }

  4. Replace <BUCKET-NAME> with the name of your S3 bucket and replace <AWS ID> with your AWS ID.

  5. Choose Save changes.

  6. If you want to add more buckets as a destination for your auto-export jobs, repeat the procedure, starting from Step 1.

Creating an S3 bucket policy

If your S3 bucket does not have a bucket policy, complete the following procedure to create an S3 bucket policy to allow AWS Data Exchange to export data to it.

To create an S3 bucket policy

  1. Navigate to the bucket to which you want to export revisions.

  2. Select the Permissions tab, and choose Edit in the bucket policy section.

  3. Copy the following full bucket policy and paste it into the bucket policy editor.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
      "Service": "dataexchange.amazonaws.com"
      },
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl"
      ],
      "Resource": "arn:aws:s3:::<BUCKET-NAME>/*",
      "Condition": {
        "StringEquals": { 
          "aws:SourceAccount": "<AWS ID>"
        }
      }
    }
  ]
}

  4. Replace <BUCKET-NAME> with the name of your S3 bucket and replace <AWS ID> with your AWS ID.

  5. Choose Save changes.

  6. If you want to add more buckets as a destination for your auto-export jobs, repeat the procedure, starting from Step 1.

Automatically exporting revisions to an S3 bucket as a subscriber (console)

Note

To automatically export revisions to an S3 bucket of your choice, your S3 bucket must have a bucket policy with permissions set to allow AWS Data Exchange to export data into it. For more information, see Prerequisites for S3 bucket policy permissions.

To automatically export a revision to an S3 bucket as a subscriber (console)

  1. Open your web browser and sign in to the AWS Data Exchange console.

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

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

  4. In Entitled data sets, choose the data set.

  5. On the Revisions tab, under Auto-export job destinations, choose Actions and then choose Add auto-export job destination.

  6. In Add auto-export job destination, choose either the Simple or Advanced destination option.

    1. If you choose the Simple option, select the Amazon S3 bucket folder destination from the dropdown list and the encryption options, and then choose Add bucket destination.

    2. If you choose the Advanced option, select the Amazon S3 bucket folder destination from the dropdown list, select the Key naming pattern and append it to the path.

  7. Review the Output.

  8. Set the Encryption options, review the Amazon S3 pricing, and then choose Add bucket destination.

    The Amazon S3 bucket destination appears on the Revisions tab under Auto-export job destinations.

    A job is started to automatically export your revision.

    To verify that the prerequisites for S3 bucket policy permissions are met, an object with the naming format _ADX-TEST-ACCOUNTID# is added to the S3 bucket.

    After the job is finished, the State field in the Jobs section is updated to Completed.

    To add another destination, choose Actions, and then Add auto-export job destination.

    To edit, select the destination you want to edit, choose Actions, and then Edit destination configuration.

    To delete, choose Actions, and then choose Remove auto-export job destination.

Automatically exporting revisions to an S3 bucket as a subscriber (AWS SDKs)

Note

To automatically export revisions to an S3 bucket of your choice, your S3 bucket must have a bucket policy with permissions set to allow AWS Data Exchange to export data into it. For more information, see Prerequisites for S3 bucket policy permissions.

To automatically export a revision to an S3 bucket (AWS SDKs)

  1. Create a Create_Event_Action request.

  2. Include the following in the request:

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. Modify the key pattern if necessary. The Amazon S3 object key defaults to the key pattern {Revision.CreatedAt}/{Asset.Name}.

    For more information about key patterns, see Key patterns when exporting revisions.

    To verify that the prerequisites for S3 bucket policy permissions are met, an object with the naming format _ADX-TEST-ACCOUNTID# is added to the S3 bucket.

Key patterns when exporting revisions

When you export a revision, each asset becomes an object in the S3 bucket. The names of the objects are based on a key pattern that you provide. You can use dynamic references that represent asset attributes to create a pattern for the names that are automatically generated during the export. Use the dynamic references shown in the following table.

Dynamic references Description
${Asset.Id} The Id of the asset.
${Asset.Name} The name of the asset.
${DataSet.Id} The Id of the data set being exported.
${DataSet.Name} The name of the data set being exported.
${Revision.CreatedAt} The UTC date and time the revision was created, in the following format: YYYY-MM-DDTHH:MM:SSZ. For example: 2021-10-08T16:33:19.787Z
${Revision.CreatedAt.Day} The day of the month the revision was created.
${Revision.CreatedAt.Month} The month the revision was created.
${Revision.CreatedAt.Year} The year the revision was created.
${Revision.Id} The Id of the revision being exported.

You can use these dynamic references to create the key patterns for your asset names. You must include at least one of the two Asset dynamic references, which are ${Asset.Name} and ${Asset.Id}.

For example, using ${Revision.Id}/${Asset.Name} as a key pattern results in Amazon S3 objects that use the revision Id and asset name (separated by a slash) as the object name.

If you export a revision with the Id testRevisionId that has two assets named asset1 and asset2, the assets are exported to the following locations in Amazon S3:

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

Note

Your resulting objects must have unique names. If they have the same names as existing objects in the S3 bucket, your export will overwrite existing objects. If the revision you are exporting has non-unique names (for example, two assets with the same name), the export will fail. The only dynamic reference that is unique is ${Asset.Id}.