本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 中的任務 AWS Data Exchange
<a name="jobs"></a>

AWS Data Exchange 任務是非同步匯入或匯出操作。

身為 中的資料產品提供者 AWS Data Exchange，您可以建立和管理要發佈至產品的資料集。您可以下載 （匯出） 或將您的資產或修訂複製到 Amazon Simple Storage Service (Amazon S3) 或已簽署的 URL。此外，供應商可以從 Amazon API Gateway API 匯入資產，或從 Amazon Redshift 資料集匯入資產。

身為訂閱者，您可以透過訂閱檢視和存取您有權存取的資料集。您可以使用 API 操作來下載 （匯出） 或將具備權限的資料集複製到 Amazon S3，以便與各種 AWS 分析和機器學習服務搭配使用。

若要透過任務建立或複製資產或複製修訂，您可以使用 AWS 管理主控台、 AWS Command Line Interface (AWS CLI)、您自己的 REST 應用程式或其中一個 AWS SDKs。

任務會在建立後 90 天刪除。

**Topics**
+ [任務屬性](#job-properties)
+ [AWS 區域 和 任務](#jobs-regions)
+ [將資產匯入至 AWS Data Exchange](importing-assets.md)
+ [從 匯出資產 AWS Data Exchange](exporting-assets.md)
+ [從 匯出修訂 AWS Data Exchange](exporting-revisions.md)

## 任務屬性
<a name="job-properties"></a>

任務具有下列屬性：
+ **任務 ID** – 建立可唯一識別任務的任務時產生的 ID。
+ **任務類型** – 支援下列任務類型：
  + 從 Amazon S3 匯入
  + 匯入資料許可 AWS Lake Formation （預覽）
  + 從簽章的 URL 匯入
  + 從 Amazon API Gateway API 匯入
  + 從 Amazon Redshift AWS Data Exchange 的資料共用匯入
  + 匯入 Amazon S3 資料存取
  + 匯出至 Amazon S3
  + 匯出至已簽章的 URL
+ **Amazon Resource Name (ARN)** – AWS 資源的唯一識別符。
+ **任務狀態** – 任務狀態為 `WAITING`、`IN_PROGRESS`、`ERROR`、、 `COMPLETED` `CANCELLED`或 `TIMED_OUT`。建立任務時，它會處於 `WAITING` 狀態，直到任務啟動為止。
+ **任務詳細資訊** – 任務要執行的操作詳細資訊，例如匯出目的地詳細資訊或匯入來源詳細資訊。

**Example 任務資源**  

```
{
    "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": "amzn-s3-demo-bucket",
                    "Key": "MyKey"
                }
            ],
            "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f",
            "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42"
        }
    }
}
```

## AWS 區域 和 任務
<a name="jobs-regions"></a>

如果您從與資料集區域 AWS 區域 不同的 Amazon S3 儲存貯體匯入或匯出資產，根據 Amazon S3 資料傳輸定價政策，您的 AWS 帳戶 會支付資料傳輸成本。

如果您將資產匯出到已簽章的 URL，根據 Amazon S3 定價政策，您的 AWS 帳戶 會支付從 Amazon S3 到網際網路的資料傳輸成本。 [Amazon S3 ](https://aws.amazon.com/s3/pricing/)

當您對 for Files 資料集 AWS Data Exchange 的訂閱結束時，您可以保留已匯出之任何檔案的存取權。檢閱您的資料訂閱協議，以確認您的協議是否需要您在結束訂閱時刪除匯出的資料。

# 將資產匯入至 AWS Data Exchange
<a name="importing-assets"></a>

您可以建立 AWS Data Exchange 任務，以匯入要發佈至產品的資料集。下列各節說明如何從各種位置匯入這些資產。

**Topics**
+ [從 S3 儲存貯體](importing-from-s3.md)
+ [從已簽章的 URL](importing-from-url.md)
+ [從 Amazon API Gateway API](import-API-asset.md)
+ [從 Amazon Redshift 的資料共用](import-RS-asset.md)
+ [從 AWS Lake Formation （預覽）](import-LF-asset.md)

# 從 S3 儲存貯體匯入 AWS Data Exchange 資產
<a name="importing-from-s3"></a>

當您將資產從 Amazon S3 匯入至 時 AWS Data Exchange，您使用的 AWS Identity and Access Management (IAM) 許可必須包含寫入 AWS Data Exchange 服務 S3 儲存貯體並從儲存資產的 S3 儲存貯體讀取的能力。您可以從您有權存取的任何 S3 儲存貯體匯入 ，無論所有權為何。如需詳細資訊，請參閱[Amazon S3 許可](access-control.md#additional-s3-permissions)。

您可以在單一任務中匯入最多 100 個資產。

**Topics**
+ [從 S3 儲存貯體 (AWS SDKs) 匯入資產](#import-assets-s3-prog)
+ [從 S3 儲存貯體匯入資產 （主控台）](#import-assets-via-console)

## 從 S3 儲存貯體 (AWS SDKs) 匯入資產
<a name="import-assets-s3-prog"></a>

**從 Amazon S3 儲存貯體 (AWS SDKs) 匯入資產**

1. 建立類型為 的`CreateJob`請求`IMPORT_ASSETS_FROM_S3`。

1. 在請求中包含下列項目：
   + `AssetSources`
     + `Bucket`
     + `Key`
   + `DataSetID`
   + `RevisionID`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 建立資產後更新資產的名稱屬性。

## 從 S3 儲存貯體匯入資產 （主控台）
<a name="import-assets-via-console"></a>

**從 S3 儲存貯體匯入資產 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要更新之修訂的資料集。

1. 在**修訂**索引標籤上，選擇**建立修訂**以開啟**建立修訂**頁面。

   1. 對於**修訂設定**，為您的修訂提供選用註解，以描述修訂的目的。

   1. 對於**新增標籤 – 選用**，新增與資源相關聯的標籤。

   1. 選擇**建立**。

      您的新修訂已建立。

1. 在**任務**區段中，選擇**從 Amazon S3 匯入**。

1. 遵循**從 Amazon S3 匯入**視窗中的提示，然後選擇**匯入資產**。

   任務已開始將資產匯入資料集。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從已簽章的 URL 匯入 AWS Data Exchange資產
<a name="importing-from-url"></a>

您可以使用簽章URLs 匯入未存放在 Amazon S3 中的資產。

**Topics**
+ [從已簽章的 URL (AWS SDKs) 匯入資產](#import-asset-signed-url-prog)
+ [從已簽章的 URL 匯入資產 （主控台）](#import-asset-signed-url-via-console)

## 從已簽章的 URL (AWS SDKs) 匯入資產
<a name="import-asset-signed-url-prog"></a>

**從已簽章的 URL (AWS SDKs) 匯入資產**

1. 建立類型為 的`CreateJob`請求`IMPORT_ASSET_FROM_SIGNED_URL`。

1. 在請求中包含下列項目：
   + `AssetName`
   + `DataSetID`
   + `Md5Hash`
   + `RevisionID`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 建立資產後更新資產的名稱屬性。

1. 回應詳細資訊包含可用於匯入檔案`SignedUrl`的 。

**注意**  
簽章的 URL 會在建立後一分鐘過期。

## 從已簽章的 URL 匯入資產 （主控台）
<a name="import-asset-signed-url-via-console"></a>

**從簽章的 URL 匯入資產 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要更新之資產的資料集。

1. 在**修訂**索引標籤上，選擇**建立修訂**以開啟**建立修訂**頁面。

   1. 對於**修訂設定**，請為您的修訂提供選用註解，以描述修訂的目的。

   1. 對於**新增標籤 – 選用**，新增與資源相關聯的標籤。

   1. 選擇**建立**。

      您的新修訂已建立。

1. 在**任務**區段中，選擇**上傳**。

1. 遵循上傳視窗中的提示，然後選擇**開啟**。

   任務已開始將資產匯入資料集。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從 Amazon API Gateway API 匯入 AWS Data Exchange 資產
<a name="import-API-asset"></a>

AWS Data Exchange 訂閱者可以使用其 IAM 登入資料和 AWS SDKs 從資料提供者呼叫 APIs。透過處理身分驗證和訂閱權利來 AWS Data Exchange 管理APIs 的存取。

## 從 Amazon API Gateway API (AWS SDKs) 匯入 API 資產
<a name="import-api-asset-prog"></a>

**注意**  
目前，下列 SDKs 不支援 `SendApiAsset`操作：  
適用於 .NET 的 SDK
適用於 C\$1\$1 的 AWS SDK
AWS SDK for Java 2.x

**從 Amazon API Gateway API (AWS SDKs) 匯入資產**

1. 建立類型為 的`CreateJob`請求`IMPORT_ASSET_FROM_API_GATEWAY_API`。

1. 在請求中包含下列項目：
   + `ApiID`
   + `DataSetID`
   + `ProtocolType`
   + `RevisionID`
   + `Stage`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 輪詢 `GetJob`操作以等待任務完成。

1. （選用） 建立資產後更新資產的名稱屬性。

## 從 Amazon API Gateway API 匯入 API 資產 （主控台）
<a name="import-api-asset-console"></a>

**從 Amazon API Gateway API 匯入資產 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要更新之資產的資料集。

1. 在**修訂**索引標籤上，選擇**建立修訂**以開啟**建立修訂**頁面。

   1. 對於**修訂設定**，為您的修訂提供選用註解，以描述修訂的目的。

   1. 對於**新增標籤 – 選用**，新增與資源相關聯的標籤。

   1. 選擇**建立**。

      您的新修訂版已建立。

1. 針對 **API 資產**區段，選擇**新增 API 階段**。

1. 在**新增 API 階段**頁面上，從您的 AWS 帳戶 或其他帳戶選取 **Amazon API Gateway API** 和**階段名稱**。

1. 針對**訂閱者的文件 API**：

   1. 將 **API 名稱**更新為訂閱者可以理解的清晰簡潔名稱。

   1. 在欄位中輸入規格、選擇**從 .JSON 檔案匯入來匯入規格**，或選擇**從 Amazon API Gateway** 匯入來匯入規格，以記錄 OpenAPI 3.0 規格。

1. 選擇**新增 API 階段**。

   任務已開始將 API 資產匯入資料集。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從 Amazon Redshift AWS Data Exchange 的資料共用匯入 AWS Data Exchange 資產
<a name="import-RS-asset"></a>

當您使用 Amazon Redshift AWS Data Exchange 的資料共用匯入資產時，您可以在訂閱後開始查詢、分析和操作第三方 Amazon Redshift 資料表。

## 從 Amazon Redshift (AWS SDKs) AWS Data Exchange 的資料共用匯入資產
<a name="import-RS-asset-prog"></a>

**從 Amazon Redshift (AWS SDKs) AWS Data Exchange 的資料共用匯入資產**

1. 建立類型為 的`CreateJob`請求`IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES`。

1. 在請求中包含下列項目：
   + `AssetSources`
     + `DataShareArn`
   + `DataSetID`
   + `RevisionID`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 輪詢 `GetJob`操作以等待任務完成。

1. （選用） 建立資產後更新資產的名稱屬性。

## 從 Amazon Redshift AWS Data Exchange 的資料共用匯入資產 （主控台）
<a name="import-RS-asset-console"></a>

**從 ADE 資料共用匯入資產 （適用於 Amazon Redshift 主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要更新之資產的資料集。

1. 在**修訂**索引標籤上，選擇**建立修訂**以開啟**建立修訂**頁面。

   1. 對於**修訂設定**，為您的修訂提供選用註解，以描述修訂的目的。

   1. 對於**新增標籤 – 選用**，新增與資源相關聯的標籤。

   1. 選擇**建立**。

      您的新修訂版已建立。

1. 針對 **AWS Data Exchange Amazon Redshift 的資料共用**區段，選擇**新增資料共用**。

1. 在**將 AWS Data Exchange 資料共用新增至修訂**頁面上，選取要新增的資料共用或資料共用。

1. 選擇**新增資料共用 (s)**。

   任務已開始將資產匯入資料集。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從 匯入 AWS Data Exchange 資產 AWS Lake Formation （預覽）
<a name="import-LF-asset"></a>

當您將資產從 匯入 AWS Lake Formation 至 時 AWS Data Exchange，您使用的 IAM 許可必須包含下列功能：
+ 寫入、授予和撤銷 Lake Formation 許可
+ 建立資料表、資料庫和目錄的資源共用
+ 更新、刪除、關聯和取消關聯以 **Lake Formation** 開頭的任何資源共用的資源共用

如需必要和建議 IAM 許可的詳細資訊，請參閱 [中的身分和存取管理 AWS Data Exchange](auth-access.md)。

## 從 AWS Lake Formation （預覽） 匯入資產 (AWS SDKs)
<a name="import-lf-asset-sdk"></a>

**從 AWS Lake Formation （預覽） (AWS SDKs) 匯入資產**

1. 建立類型為 的`CreateJob`請求`Import_Assets_From_Lake_Formation_Tag_Policy`。

1. 在請求中包含下列項目：
   + `AssetSources`
     + `CatalogId`
     + `Database`
       + `Expression`
         + `TagKey`
         + `TagValues`
       + `Permissions`
     + `Table`
       + `Expression`
         + `TagKey`
         + `TagValues`
       + `Permissions`
   + `RoleArn`
   + `DataSetId`
   + `RevisionId`

1. 使用需要 `StartJob`的操作啟動`CreateJob`請求`JobId`。

1. （選用） 輪詢 `GetJob`操作以等待任務完成。

1. （選用） 建立資產後更新資產的名稱屬性。

## 從 AWS Lake Formation （預覽） 匯入資產 （主控台）
<a name="import-LF-asset-console"></a>

**從 AWS Lake Formation （預覽） 匯入資產 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要更新之修訂的資料集。

1. 在**修訂**索引標籤上，選擇**建立修訂**以開啟**建立修訂**頁面。

   1. 對於**修訂設定**，請為您的修訂提供選用註解，以描述修訂的目的。

   1. 對於**新增標籤 – 選用**，新增與資源相關聯的標籤。

   1. 選擇**建立**。

      您的新修訂版已建立。

1. 針對 **Lake Formation 資料許可**區段，選擇**新增 LF 標籤**。

1. 選擇您要新增的**金鑰**和**值**，然後選擇**新增 LF 標籤**。

   1. （選用） 選擇**預覽資源 （預覽資源）** 以檢視您授予許可的相關聯資料目錄資源。

1. 在**服務存取**中，選取要匯入 AWS Lake Formation 資源**的角色** AWS Data Exchange。

1. 選擇**建立 Lake Formation 資料許可**。

   任務已開始將資產匯入資料集。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從 匯出資產 AWS Data Exchange
<a name="exporting-assets"></a>

供應商和訂閱者都可以從 中發佈的產品修訂匯出資料集 AWS Data Exchange。您可以將這些資產匯出至 S3 儲存貯體或簽章的 URL。下列各節說明如何執行此操作。

**Topics**
+ [至 S3 儲存貯體](exporting-from-s3.md)
+ [前往已簽章的 URL](Exporting-from-url.md)

# 將 AWS Data Exchange 資產匯出至 S3 儲存貯體
<a name="exporting-from-s3"></a>

當您將資產匯出至 Amazon S3 時，您使用的 IAM 許可必須包含從 AWS Data Exchange 服務 S3 儲存貯體讀取和寫入儲存資產之 S3 儲存貯體的能力。您可以匯出到您擁有存取許可的任何 S3 儲存貯體，無論所有權為何。如需詳細資訊，請參閱[Amazon S3 許可](access-control.md#additional-s3-permissions)。

AWS Data Exchange 匯出資料集至 Amazon S3 時， 支援可設定的加密參數。在匯出任務詳細資訊中，您可以指定要套用至匯出物件的 Amazon S3 伺服器端加密組態。您可以選擇搭配 Amazon S3-Managed管金鑰 (SSE-S3) 使用伺服器端加密，或使用 AWS Key Management Service (SSE-KMS) 儲存的 AWS KMS keys 伺服器端加密。如需詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》**中的[使用伺服器端加密保護資料](https://docs.aws.amazon.com//AmazonS3/latest/dev/serv-side-encryption.html)。

**重要**  
建議您在將資料匯出至 Amazon S3 時考慮 Amazon S3 安全功能。如需有關一般準則和最佳實務的資訊，請參閱《[Amazon Simple Storage Service 使用者指南》中的 Amazon S3 的安全最佳實務](https://docs.aws.amazon.com/AmazonS3/latest/dev/security-best-practices.html)。 **

**重要**  
如果提供者已根據 1996 年健康保險流通與責任法案 (HIPAA) 將產品標示為包含受保護醫療資訊 (PHI)，則您無法將產品的資料集匯出至 ， AWS 帳戶 除非此類 AWS 帳戶 資料集被指定為 HIPAA 帳戶 （如 中的 AWS 商業夥伴增補條款所定義[AWS Artifact](https://docs.aws.amazon.com/artifact/latest/ug/what-is-aws-artifact.html))。

您可以在單一任務中匯出最多 100 個資產。

**Topics**
+ [將 AWS Data Exchange 資產匯出至 S3 儲存貯體AWS SDKs)](export-assets-s3-prog.md)
+ [以訂閱者身分將 AWS Data Exchange 資產匯出至 S3 儲存貯體 （主控台）](export-asset-s3-console-sub.md)
+ [以提供者身分將 AWS Data Exchange 資產匯出至 S3 儲存貯體 （主控台）](export-asset-s3-console-prov.md)

下列影片會詳細說明如何從 匯出資產 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)


# 將 AWS Data Exchange 資產匯出至 S3 儲存貯體AWS SDKs)
<a name="export-assets-s3-prog"></a>

您可以使用 AWS SDKs，依照下列指示將 AWS Data Exchange 資產匯出至 S3 儲存貯體。

**將資產匯出至 S3 儲存貯體AWS SDKs)**

1. 建立類型為 的`CreateJob`請求`EXPORT_ASSETS_TO_S3`。

1. 在請求中包含下列項目：
   + `AssetDestinations`
     + `AssetID`
     + `Bucket`
     + `Key`
   + `DataSetID`
   + `Encryption`
     + `KmsKeyArn`
     + `Type`
   + `RevisionID`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 建立資產後更新資產的名稱屬性。

**注意**  
如需將整個修訂匯出為單一任務的詳細資訊，請參閱 [從 匯出修訂 AWS Data Exchange](exporting-revisions.md)。

# 以訂閱者身分將 AWS Data Exchange 資產匯出至 S3 儲存貯體 （主控台）
<a name="export-asset-s3-console-sub"></a>

身為 AWS Data Exchange 資料產品的訂閱者，您可以使用 AWS Data Exchange 主控台，依照下列指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體。

**以訂閱者身分將資產匯出至 S3 儲存貯體 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**我的訂閱**，選擇**授權資料**。

1. 在**授權資料**中，選擇具有您要匯出之修訂的產品。

1. 在**有權限的資料集**中，選擇資料集。

1. 在**修訂**索引標籤上，選擇修訂。

1. 從**資產**索引標籤中，選取您要匯出之資產旁的核取方塊。

1. 選取**匯出動作**，然後選擇將**選取的資產匯出至 Amazon S3**。

1. 遵循**匯出至 Amazon S3 **視窗中的提示，然後選擇**匯出**。

   任務已開始匯出您的資產。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 以提供者身分將 AWS Data Exchange 資產匯出至 S3 儲存貯體 （主控台）
<a name="export-asset-s3-console-prov"></a>

身為 AWS Data Exchange 資料產品的提供者，您可以使用 AWS Data Exchange 主控台，依照下列指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體。

**將資產匯出至 S3 儲存貯體做為提供者 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要匯出之資產的資料集。

1. 導覽至**產品**索引標籤，以確保資料集與已發佈的產品相關聯。

1. 從**修訂**索引標籤中，選取修訂。

1. 針對**匯入的資產**區段，選取資產名稱旁的核取方塊。

1. 選取**匯出動作**，然後選擇將**選取的資產匯出至 Amazon S3**。

1. 遵循**匯出至 Amazon S3 **視窗中的提示，然後選擇**匯出**。

   任務已開始匯出您的資產。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 將 AWS Data Exchange 資產匯出至已簽章的 URL
<a name="Exporting-from-url"></a>

您可以使用簽章URLs 匯出未存放在 Amazon S3 中的 AWS Data Exchange 資產。

**Topics**
+ [使用 AWS SDKs](export-asset-URL-prog.md)
+ [使用 主控台 （訂閱者）](export-asset-url-sub.md)
+ [使用主控台 （提供者）](export-asset-URL-console-pro.md)

# 將 AWS Data Exchange 資產匯出至已簽章的 URL (AWS SDKs)
<a name="export-asset-URL-prog"></a>

您可以使用 AWS SDKs 將 AWS Data Exchange 資產匯出至 S3 儲存貯體以外的目的地。

**將資產匯出至已簽章的 URL (AWS SDKs)**

1. 建立類型為 的`CreateJob`請求`EXPORT_ASSET_TO_SIGNED_URL`。

1. 在請求中包含下列項目：
   + `AssetID`
   + `DataSetID`
   + `RevisionID`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. （選用） 建立資產後更新資產的名稱屬性。

1. 回應詳細資訊包含您可以用來匯入檔案`SignedUrl`的 。

**注意**  
簽章的 URL 會在建立後一分鐘過期。

# 以訂閱者身分將資產匯出至已簽署的 URL （主控台）
<a name="export-asset-url-sub"></a>

身為 AWS Data Exchange 資料產品的訂閱者，您可以使用 AWS Data Exchange 主控台，使用以下指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體以外的目的地。

**以訂閱者身分將資產匯出至已簽章的 URL （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**我的訂閱**，選擇**授權資料**。

1. 在**授權資料**中，選擇具有您要匯出之修訂的產品。

1. 在**有權限的資料集**中，選擇資料集。

1. 在**修訂**索引標籤上，選擇修訂。

1. 從**資產**索引標籤中，選取您要匯出之資產旁的核取方塊。

1. 選取**匯出動作**，然後選擇**下載選取的資產**。

   任務已開始匯出您的資產。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 將資產匯出至已簽署的 URL 做為供應商 （主控台）
<a name="export-asset-URL-console-pro"></a>

身為 AWS Data Exchange 資料產品的提供者，您可以使用 AWS Data Exchange 主控台，使用以下指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體以外的目的地。

**將資產匯出至簽署的 URL 做為提供者 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要匯出之修訂的產品。

1. 導覽至**產品**索引標籤，以確保資料集與已發佈的產品相關聯。

1. 在**修訂**索引標籤上，選擇修訂。

1. 針對**匯入的資產**區段，選取資產名稱旁的核取方塊。

1. 選取**匯出動作**，然後選擇**下載選取的資產**。

   任務已開始匯出您的資產。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 從 匯出修訂 AWS Data Exchange
<a name="exporting-revisions"></a>

供應商和訂閱者都可以將資料集的修訂匯出到他們有權存取的 S3 儲存貯體。

AWS Data Exchange 匯出修訂版至 Amazon S3 時， 支援可設定的加密參數。在匯出任務詳細資訊中，您可以指定要套用至匯出物件的 Amazon S3 伺服器端加密組態。您可以選擇將伺服器端加密與 Amazon S3-Managed管金鑰 (SSE-S3) 搭配使用，或使用存放在 (SSE-KMS) 中的 AWS Key Management Service KMS 金鑰進行伺服器端加密。如需詳細資訊，請參閱《*Amazon Simple Storage Service 開發人員指南*》中的[使用伺服器端加密保護資料](https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html)。

**重要**  
如果提供者已根據 1996 年健康保險流通與責任法案 (HIPAA) 將產品標示為包含受保護醫療資訊 (PHI)，則除非 AWS 帳戶 將產品資料集指定為 HIPAA 帳戶 （如 中的 AWS 商業夥伴增補合約所定義[AWS Artifact](https://docs.aws.amazon.com/artifact/latest/ug/what-is-aws-artifact.html))， AWS 帳戶 否則您無法將產品的資料集匯出至 。

**Topics**
+ [匯出修訂時的金鑰模式](revision-export-keypatterns.md)
+ [使用 AWS SDKs](export-rev-s3-prog.md)
+ [使用 主控台 （訂閱者）](export-rev-s3-console-sub.md)
+ [使用 主控台 （提供者）](export-rev-s3-console-pro.md)
+ [自動匯出修訂 （訂閱者）](auto-export-rev-s3-console-sub.md)

下列影片說明如何從 AWS Data Exchange 匯出資產 （從 2：18 開始）。

[![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)


# 從 匯出資產修訂時的關鍵模式 AWS Data Exchange
<a name="revision-export-keypatterns"></a>

當您從 匯出資產修訂版時 AWS Data Exchange，每個資產都會成為 S3 儲存貯體中的物件。物件的名稱是根據您提供的金鑰模式。您可以使用代表資產屬性的動態參考，為匯出期間自動產生的名稱建立模式。使用下表所示的動態參考。


| 動態參考 | Description | 
| --- | --- | 
| \$1\$1Asset.Id\$1 | 資產的 ID。 | 
| \$1\$1Asset.Name\$1 | 資產的名稱。 | 
| \$1\$1DataSet.Id\$1 | 要匯出之資料集的 ID。 | 
| \$1\$1DataSet.Name\$1 | 要匯出的資料集名稱。 | 
| \$1\$1Revision.CreatedAt\$1 | 建立修訂的 UTC 日期和時間，格式如下：YYYY-MM-DDTHH：MM：SSZ。例如：2021-10-08T16：33：19.787Z | 
| \$1\$1Revision.CreatedAt.Day\$1 | 建立修訂的月份日期。 | 
| \$1\$1Revision.CreatedAt.Month\$1 | 修訂建立的月份。 | 
| \$1\$1Revision.CreatedAt.Year\$1 | 修訂建立的年份。 | 
| \$1\$1Revision.Id\$1 | 要匯出之修訂的 ID。 | 

您可以使用這些動態參考，為您的資產名稱建立金鑰模式。您必須包含兩個`Asset`動態參考中的至少一個，即 `${Asset.Name}`和 `${Asset.Id}`。

例如，使用 **\$1\$1Revision.Id\$1/\$1\$1Asset.Name\$1**做為金鑰模式會導致使用修訂 ID 和資產名稱 （以斜線分隔） 做為物件名稱的 Amazon S3 物件。

如果您匯出的修訂版 ID 有兩個名為 `asset1`和 `testRevisionId`的資產`asset2`，則資產會匯出至 Amazon S3 中的下列位置：
+ `<bucket>/testRevisionId/asset1`
+ `<bucket>/testRevisionId/asset2`

**注意**  
產生的物件必須具有唯一的名稱。如果它們的名稱與 S3 儲存貯體中的現有物件相同，則匯出會覆寫現有的物件。如果您要匯出的修訂版具有非唯一的名稱 （例如，兩個具有相同名稱的資產），則匯出將會失敗。唯一的動態參考是 `${Asset.Id}`。

# 匯出 AWS Data Exchange 資產修訂至 S3 儲存貯體 (AWS SDKs)
<a name="export-rev-s3-prog"></a>

您可以使用 AWS SDKs，依照下列指示將 AWS Data Exchange 資產修訂匯出至 S3 儲存貯體。

**將修訂版匯出至 S3 儲存貯體AWS SDKs)**

1. 建立類型為 的`CreateJob`請求`EXPORT_REVISIONS_TO_S3`。

1. 在請求中包含下列項目：
   + `DataSetId`
   + `Encryption`
     + `KmsKeyArn`
     + `Type`
   + `RevisionDestinations`
     + `Bucket`
     + `KeyPattern`
     + `RevisionId`

1. 使用需要步驟 1 中`JobId`傳回 `StartJob`的操作啟動`CreateJob`請求。

1. 新建立的資產具有等於原始 S3 物件金鑰的名稱屬性。Amazon S3 物件金鑰預設為金鑰模式 `${Asset.Name}`。

   您可以在資產建立後更新資產的名稱屬性。

   如需金鑰模式的詳細資訊，請參閱 [從 匯出資產修訂時的關鍵模式 AWS Data Exchange](revision-export-keypatterns.md)。

**注意**  
如果您使用 `DataSet.Name`作為動態參考，則必須具有 IAM 許可 `dataexchange:GetDataSet`。如需詳細資訊，請參閱[AWS Data Exchange API 許可：動作和資源參考](api-permissions-ref.md)。

# 以訂閱者身分將 AWS Data Exchange 資產修訂匯出至 S3 儲存貯體 （主控台）
<a name="export-rev-s3-console-sub"></a>

身為 AWS Data Exchange 資料產品的訂閱者，您可以使用 AWS Data Exchange 主控台，使用以下指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體。

**以訂閱者身分將修訂匯出至 S3 儲存貯體 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**我的訂閱**，選擇**授權資料**。

1. 在**授權資料**中，選擇具有您要匯出之修訂的產品。

1. 在**有權限的資料集**中，選擇資料集。

1. 在**修訂**索引標籤上，選取修訂，然後選擇**匯出至 Amazon S3**。

1. 在**匯出修訂至 Amazon S3** 中，選取目的地選項、Amazon S3 儲存貯體資料夾目的地、設定加密選項，然後選擇**匯出**。

   任務已開始匯出您的修訂。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 將 AWS Data Exchange 資產修訂匯出至 S3 儲存貯體做為提供者 （主控台）
<a name="export-rev-s3-console-pro"></a>

身為 AWS Data Exchange 資料產品的提供者，您可以使用 AWS Data Exchange 主控台，依照下列指示將資產匯出 AWS Data Exchange 至 S3 儲存貯體。

**將修訂匯出至 S3 儲存貯體做為提供者 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**發佈資料**，選擇**擁有的資料集**。

1. 在**擁有的資料集**中，選擇具有您要匯出之修訂的產品。

1. 導覽至**產品**索引標籤，以確保資料集與已發佈的產品相關聯。

1. 在**修訂**索引標籤上，選擇修訂。

1. 針對**匯入的資產**區段，選取資產名稱旁的核取方塊。

1. 選取**匯出動作**，然後選擇將**選取的資產匯出至 Amazon S3**。

1. 遵循**匯出至 Amazon S3 **視窗中的提示，然後選擇**匯出**。

   任務已開始匯出您的資產。任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

# 以訂閱者身分自動將 AWS Data Exchange 資產修訂匯出至 S3 儲存貯體
<a name="auto-export-rev-s3-console-sub"></a>

當供應商發佈新修訂時，您可以選擇 自動將新修訂匯出到您的 Amazon S3 儲存貯體。您可以將新修訂匯出至最多五個 S3 儲存貯體。新的修訂會自動出現在您選取的 S3 儲存貯體中。

**Topics**
+ [S3 儲存貯體政策許可的先決條件](#auto-export-rev-s3-bucket-policy-prereq)
+ [以訂閱者身分自動將修訂匯出至 S3 儲存貯體 （主控台）](#auto-export-rev-s3-console-sub-proc)
+ [以訂閱者身分自動將修訂匯出至 S3 儲存貯體 (AWS SDKs)](#auto-export-rev-s3-prog-sub)

**注意**  
若要自動將修訂匯出至您選擇的 S3 儲存貯體，您的 S3 儲存貯體必須有已設定許可的儲存貯體政策，以允許 AWS Data Exchange 將資料匯出至其中。如需詳細資訊，請參閱[S3 儲存貯體政策許可的先決條件](#auto-export-rev-s3-bucket-policy-prereq)。

## S3 儲存貯體政策許可的先決條件
<a name="auto-export-rev-s3-bucket-policy-prereq"></a>

在自動將修訂匯出至 Amazon S3 儲存貯體之前，您必須停用申請者付款，而且您的 Amazon S3 儲存貯體必須具有已設定許可的儲存貯體政策，以允許 AWS Data Exchange 將資料匯出至其中。下列程序提供如何編輯現有 S3 儲存貯體政策，或使用這些許可建立 S3 儲存貯體政策的相關資訊。

如果您的 S3 儲存貯體設定為 SSE-KMS 加密，則設定自動匯出任務的使用者必須具有 的 AWS Data Exchange KMS 金鑰`CreateGrant`許可，才能將物件複製到 S3 儲存貯體。

**重要**  
若要驗證是否符合 S3 儲存貯體政策許可的先決條件，在自動匯出程序期間，具有命名格式的物件`_ADX-TEST-ACCOUNTID#`會新增至 S3 儲存貯體。

**Topics**
+ [編輯現有的 S3 儲存貯體政策](#bucket-policy-prereq-existing-s3-bucket-policy)
+ [建立 S3 儲存貯體政策](#bucket-policy-prereq-create-s3-bucket-policy)

### 編輯現有的 S3 儲存貯體政策
<a name="bucket-policy-prereq-existing-s3-bucket-policy"></a>

如果您的 S3 儲存貯體具有儲存貯體政策，請完成下列程序，以允許 AWS Data Exchange 將資料匯出至該儲存貯體。

**編輯現有的 S3 儲存貯體政策**

1. 導覽至您要匯出修訂的儲存貯體。

1. 選取**許可**索引標籤，然後在儲存貯體政策區段中選擇**編輯**。

1. 複製下列陳述式，並將其貼到陳述式清單的結尾。

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

1. `<BUCKET-NAME>` 將 取代為您的 S3 儲存貯體名稱，並將 取代`<AWS ID>`為您的 AWS ID。

1. 選擇**儲存變更**。

1. 如果您想要新增更多儲存貯體做為自動匯出任務的目的地，請從步驟 1 開始重複此程序。

### 建立 S3 儲存貯體政策
<a name="bucket-policy-prereq-create-s3-bucket-policy"></a>

如果您的 S3 儲存貯體沒有儲存貯體政策，請完成下列程序來建立 S3 儲存貯體政策，以允許 AWS Data Exchange 將資料匯出至其中。

**建立 S3 儲存貯體政策**

1. 導覽至您要匯出修訂的儲存貯體。

1. 選取**許可**索引標籤，然後在儲存貯體政策區段中選擇**編輯**。

1. 複製下列完整儲存貯體政策，並將其貼入儲存貯體政策編輯器。

------
#### [ JSON ]

****  

   ```
   {
     "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>"
           }
         }
       }
     ]
   }
   ```

------

1. `<BUCKET-NAME>` 將 取代為您的 S3 儲存貯體名稱，並將 取代`<AWS ID>`為您的 AWS ID。

1. 選擇**儲存變更**。

1. 如果您想要新增更多儲存貯體做為自動匯出任務的目的地，請從步驟 1 開始重複此程序。

## 以訂閱者身分自動將修訂匯出至 S3 儲存貯體 （主控台）
<a name="auto-export-rev-s3-console-sub-proc"></a>

**注意**  
若要自動將修訂匯出至您選擇的 S3 儲存貯體，您的 S3 儲存貯體必須有已設定許可的儲存貯體政策，以允許 AWS Data Exchange 將資料匯出至其中。如需詳細資訊，請參閱[S3 儲存貯體政策許可的先決條件](#auto-export-rev-s3-bucket-policy-prereq)。

**以訂閱者身分自動將修訂匯出至 S3 儲存貯體 （主控台）**

1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格中，針對**我的訂閱**，選擇**授權資料**。

1. 在**授權資料**中，選擇具有您要匯出之修訂的產品。

1. 在**有權限的資料集**中，選擇資料集。

1. 在**修訂**索引標籤的**自動匯出任務目的地**下，選擇**動作**，然後選擇**新增自動匯出任務目的地**。

1. 在**新增自動匯出任務目的地**中，選擇**簡單**或**進階**目的地選項。

   1. 如果您選擇**簡易**選項，請從下拉式清單和加密選項中選取 Amazon S3 儲存貯體資料夾目的地，然後選擇**新增儲存貯體目的地**。

   1. 如果您選擇**進階**選項，請從下拉式清單中選取 Amazon S3 儲存貯體資料夾目的地，選取[金鑰命名模式](revision-export-keypatterns.md)，並將其附加至路徑。

1. 檢閱**輸出**。

1. 設定**加密選項**，檢閱 **Amazon S3 定價**，然後選擇**新增儲存貯體目的地**。

   Amazon S3 儲存貯體目的地會顯示在**自動匯出任務目的地**下的**修訂**索引標籤上。

   任務已開始自動匯出您的修訂。

   若要驗證是否符合 S3 儲存貯體政策許可的先決條件，具有命名格式的物件`_ADX-TEST-ACCOUNTID#`會新增至 S3 儲存貯體。

   任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成**。

   若要新增另一個目的地，請選擇**動作**，然後選擇**新增自動匯出任務目的地**。

   若要編輯，請選取您要編輯的目的地，選擇**動作**，然後選擇**編輯目的地組態**。

   若要刪除，請選擇**動作**，然後選擇**移除自動匯出任務目的地**。

## 以訂閱者身分自動將修訂匯出至 S3 儲存貯體 (AWS SDKs)
<a name="auto-export-rev-s3-prog-sub"></a>

**注意**  
若要自動將修訂匯出至您選擇的 S3 儲存貯體，您的 S3 儲存貯體必須有已設定許可的儲存貯體政策，以允許 AWS Data Exchange 將資料匯出至其中。如需詳細資訊，請參閱[S3 儲存貯體政策許可的先決條件](#auto-export-rev-s3-bucket-policy-prereq)。

**自動將修訂匯出至 S3 儲存貯體AWS SDKs)**

1. 建立`Create_Event_Action`請求。

1. 在請求中包含下列項目：
   + `Action`
     + `ExportRevisionToS3`
       + `Encryption`
         + `KmsKeyArn`
         + `Type`
     + `RevisionDestination`
       + `Bucket`
       + `KeyPattern`
   + `Event`
     + `RevisionPublished`
       + `DataSetId`
   + `Tags`

1. 視需要修改金鑰模式。Amazon S3 物件金鑰預設為金鑰模式 `{Revision.CreatedAt}/{Asset.Name}`。

   如需金鑰模式的詳細資訊，請參閱 [從 匯出資產修訂時的關鍵模式 AWS Data Exchange](revision-export-keypatterns.md)。

   若要驗證是否符合 S3 儲存貯體政策許可的先決條件，具有命名格式的物件`_ADX-TEST-ACCOUNTID#`會新增至 S3 儲存貯體。