本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 中發佈新產品 AWS Data Exchange
您可以在 AWS Data Exchange 上使用多個 AWS 工具和主控台發佈產品。
在 [AWS Marketplace 管理入口網站](https://console.aws.amazon.com/marketplace)中或透過程式設計方式 AWS Marketplace Catalog API，您可以：
+ 建立和管理 產品。
+ 建立和管理優惠。
+ 驗證訂閱請求。
在 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)中，您可以建立和管理資料集。
下列主題說明 AWS Data Exchange 使用 AWS Data Exchange 主控台在 上發佈新產品的程序。
**Topics**
+ [在 中發佈 AWS Data Exchange 包含以檔案為基礎的資料的產品](publish-data-product.md)
+ [在 中發佈 AWS Data Exchange 包含 APIs的產品](publish-API-product.md)
+ [在 中發佈 AWS Data Exchange 包含 Amazon Redshift 資料集的產品](publish-Redshift-product.md)
+ [在 中發佈 AWS Data Exchange 包含 Amazon S3 資料存取的產品](publish-s3-data-access-product.md)
+ [在 中發佈 AWS Data Exchange 包含 AWS Lake Formation 資料許可資料集的產品 （預覽）](publish-LF-data-product.md)
# 在 中發佈 AWS Data Exchange 包含以檔案為基礎的資料的產品
下列主題說明 AWS Data Exchange 使用 AWS Data Exchange 主控台在 中建立資料集和發佈新產品的程序， AWS Data Exchange 其中包含以檔案為基礎的資料。程序包含下列步驟：
**Topics**
+ [步驟 1：建立資產](#create-assets)
+ [步驟 2：建立資料集](#create-dataset)
+ [步驟 3：建立修訂](#create-revision)
+ [步驟 4：將資產匯入修訂](#import-assets)
+ [步驟 5：發佈新產品](#publish-products)
+ [步驟 6：（選用） 複製產品](#copy-product)
## 步驟 1：建立資產
資產是其中*的資料* AWS Data Exchange。如需詳細資訊，請參閱[資產](data-sets.md#assets)。
建立和發佈新的檔案型資料產品之前，您必須：
1. 建立您的檔案。
AWS Data Exchange 支援所有檔案類型。
1. 將檔案儲存為 Amazon Simple Storage Service (Amazon S3) 或本機電腦上的物件。
如需在 Amazon S3 中存放檔案的詳細資訊，請參閱《[Amazon S3 使用者指南](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)》。
## 步驟 2：建立資料集
中的資料集 AWS Data Exchange 是動態的，並使用修訂進行版本控制，每個修訂至少包含一個資產。如需詳細資訊，請參閱[中的資料 AWS Data Exchange](data-sets.md)。
**建立資料集**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 在左側導覽窗格的**發佈資料**下，選擇**擁有的資料集**。
1. 在**擁有的資料集**中，選擇**建立資料集**以開啟**資料集建立步驟**精靈。
1. 在**選取資料集類型**中，選擇****檔案****。
1. 在**定義資料集**中，輸入資料集**的名稱**和**描述**。如需詳細資訊，請參閱[資料集最佳實務](data-sets.md#data-set-best-practices)。
1. （選用） 在**新增標籤下 – 選用**，新增標籤。
1. 選擇 **Create data set (建立資料集)**。
## 步驟 3：建立修訂
在下列程序中，您會在 AWS Data Exchange 主控台中建立資料集之後建立修訂。如需詳細資訊，請參閱[修訂](data-sets.md#revisions)。
**建立修訂**
1. 在**資料集詳細資訊頁面的資料集概觀**區段中：
1. （選用） 選擇**編輯名稱**以編輯資料集的相關資訊。
1. （選用） 選擇**刪除**以刪除資料集。
1. 在**修訂**區段中，選擇**建立修訂**。
1. 在**定義修訂**下，為您的修訂提供選用註解，以描述修訂的目的。
1. （選用） 在**新增標籤下 – 選用**，新增與資源相關聯的標籤。
1. 選擇**建立修訂**。
1. 檢閱、編輯或刪除上一個步驟的變更。
## 步驟 4：將資產匯入修訂
在下列程序中，您會匯入資料資產，然後在 AWS Data Exchange 主控台中完成修訂。如需詳細資訊，請參閱[資產](data-sets.md#assets)。
**將資產匯入修訂**
1. 在資料集詳細資訊頁面**的任務**區段下，選擇**從 Amazon S3 匯入**或**上傳** （從您的電腦上傳），取決於目前存放資料集的資料資產。
1. 根據您的選擇，遵循提示。任務已開始將資產匯入資料集。
1. 任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成。**
1. 如果您要新增更多資料，請重複步驟 1。
1. 在**修訂概觀**中，檢閱您的修訂及其資產。
1. 選擇**完成修訂**。
您已成功完成資料集的修訂。
您可以在將修訂新增至產品之前編輯或刪除修訂。
**Topics**
+ [編輯修訂](#edit-revision)
+ [刪除修訂](#delete-revision)
### 編輯修訂
**在您完成修訂之後編輯修訂**
1. 在**修訂概觀**中，選擇**取消最終化**。
您看到修訂不再處於最終狀態的訊息。
1. 若要編輯修訂，請從**修訂概觀**中，選擇**動作**、**編輯**。
1. 進行變更，然後選擇**更新**。
1. 檢閱您的變更，然後選擇**完成**。
### 刪除修訂
**在完成修訂之後刪除修訂**
1. 在**修訂概觀**中，選擇**刪除**。
1. **Delete** 在**刪除修訂**對話方塊中輸入 ，然後選擇**刪除**。
**警告**
這會刪除修訂版及其所有資產。這個操作無法復原。
## 步驟 5：發佈新產品
建立至少一個資料集並使用資產完成修訂後，您就可以將該資料集發佈為產品的一部分。如需詳細資訊，請參閱 [中的產品最佳實務 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/product-details.html)。請確定您擁有產品和優惠的所有必要詳細資訊。
**建立新的產品清單**
1. 登入您的賣方 AWS 帳戶並前往 [AWS Marketplace 管理入口網站](https://console.aws.amazon.com/marketplace)。
1. 在頂端選單中，前往**產品**，然後選擇**資料產品**。
1. 選擇**建立資料產品**。
1. 若要開始使用資料產品，您將透過設定產品名稱、為組織新增選用資源標籤，以及產生產品 ID 來啟動列出程序。產品 ID 用於追蹤產品的整個生命週期。
1. 在**產品名稱**下，輸入要向買方顯示在產品清單頁面頂端和搜尋結果中的唯一產品名稱。
1. （選用） 在**標籤**下，輸入您要與產品建立關聯的任何標籤。如需詳細資訊，請參閱[標記 AWS 資源](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。
1. 在**產品 ID 和程式碼**下，選擇**產生產品 ID 和程式碼**。
1. 選擇**繼續前往產品詳細資訊**。您將開始新增詳細產品資訊的程序。
**提供產品資訊**
在 AWS Marketplace 中列出您的資料產品時，提供完整且準確的產品資訊至關重要。使用**提供產品資訊**步驟來擷取產品的基本詳細資訊，例如產品類別和支援資訊。
1. 輸入您產品的相關資訊。如需詳細資訊，請參閱[AWS Data Exchange 產品詳細資訊](https://docs.aws.amazon.com/data-exchange/latest/userguide/prod-details-over.html)。
1. 選擇**下一步**以移至下一個步驟。
**新增資料集**
1. 選擇資料集所在的 AWS 區域。
1. 在**擁有的資料集**區段中，選取您要新增之資料集旁的核取方塊。您選擇的資料集必須具有最終修訂。無法新增沒有最終修訂的資料集。
1. 前往**新增的資料集**以檢閱您的選擇。
1. 您可以檢閱資料集**的名稱**、資料集的**類型**，以及資料集**上次更新**時的時間戳記。
1. 前往**修訂存取規則設定**，選擇您要為包含在此產品中的資料集設定的修訂存取規則。如需詳細資訊，請參閱 [中的修訂存取規則 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/best-practices-revisions.html)。
1. （選用） 在**資料字典**區段中，選取資料集，然後選擇**新增字典**。
1. 選擇**上傳資料字典**以上傳新的資料字典。
您可以選擇一個 .csv 格式的資料字典，大小上限為 1 MB。
1. 從您的電腦選擇儲存的資料字典，然後選擇**開啟**。您的資料字典必須符合 AWS Data Exchange 資料字典範本。如果您沒有要上傳的已儲存資料字典，您可以在 AWS Data Exchange 主控台中選擇**空白資料字典範本**連結或**範例資料字典**連結。如需詳細資訊，請參閱 [中的資料字典 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/data-dictionaries-pro.html)。
1. （選用） 在**資料範例**下，選擇**新增範例**，然後選取您要提供範例的資料集。
1. 選取**上傳資料範例**，然後從您的電腦選取資料集範例，然後選擇**開啟**。
1. （選用） 輸入每個範例的說明，這些範例會顯示在產品詳細資訊頁面上。
1. 選擇**新增範例**。您最多可以上傳 10 個大小上限為 50 MB 的範例。.csv 格式的範例可以預覽。如需詳細資訊，請參閱 [中的範例資料 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/samples-pro.html)。
1. 在**修訂存取規則設定**區段中，選擇您要為包含在此產品中的資料集設定的修訂存取規則。如需詳細資訊，請參閱 [中的修訂存取規則 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/best-practices-revisions.html)。
1. 在**資料敏感資訊設定**區段中，選擇您產品的**敏感資訊**組態，然後選擇**下一步**。如需詳細資訊，請參閱 [中的敏感資訊類別 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/sensitive-information.html)。
**設定允許清單**
提交產品之前，您需要指定哪些 AWS 帳戶可以存取它。此選用步驟可控制產品的初始可見性，限制存取您自己的 帳戶，以及您新增至允許清單的任何特別授權 AWS 帳戶。
1. 輸入您要存取產品的 AWS 帳戶 IDs。
1. 選擇**提交**以提交您的產品。您的產品將具有**有限可見**性狀態，而且只有建立產品 AWS 的帳戶和其他允許清單 AWS 的帳戶才能看見。您可以在產品清單處於**有限可見**性狀態時檢視和測試產品清單。
如需狀態的詳細資訊，請參閱 [中的產品可見 AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/product-visibility.html)性。
## 步驟 6：（選用） 複製產品
建立第一個產品之後，您可以複製其詳細資訊和公開優惠來建立新的產品。
**注意**
您可以複製公有、私有、已發佈或未發佈的產品。不會複製與產品相關聯的自訂優惠，但會複製公開優惠。
**複製產品**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇您要複製的產品旁的按鈕。
1. 選取**動作**下拉式清單，然後選擇**建立複本**。
1. 根據您在步驟 3 中選擇的產品，繼續進行**發佈新的產品**工作流程，其中包含已填入的詳細資訊。如需詳細資訊，請參閱[步驟 5：發佈新產品](#publish-products)。
# 在 中發佈 AWS Data Exchange 包含 APIs的產品
下列主題說明建立 REST API 資料集和發佈包含 APIs 的新產品的程序 AWS Data Exchange。您可以使用 AWS Data Exchange 主控台或 來完成程序 AWS Command Line Interface。
設定 Amazon API Gateway REST API 之後，您可以在 中建立新的 API 資料集 AWS Data Exchange。然後，您可以建立修訂，並新增 API 資產。
建立和發佈 API 資產可讓訂閱者向 AWS Data Exchange 端點提出請求，以透過 代理至您的 API Gateway API。然後，您可以將此資料集新增至產品並新增定價。然後，訂閱者可以檢視您的產品，並在 目錄和 AWS Data Exchange 目錄中訂閱產品 AWS Marketplace 。
AWS Data Exchange 提供 功能，包括修訂存取規則、私有產品、私有優惠和訂閱驗證。
您只能選擇以合約為基礎的定價、計量成本定價 （其中合約定價為 0 美元），或計量和合約定價的組合。
您可以選擇標準計量成本，也可以指定自訂計量成本。有三種類型的標準計量成本可用：
+ 每個 API 請求
+ 每個成功的 API 請求
+ 以位元組為單位傳輸的每單位資料
**注意**
計量成本適用於產品中的所有 API 資料集。因此，如果您想要為不同 API 資料集的相同維度收取不同的價格，建議您在不同產品中建立這些資料集。
程序包含下列步驟：
**Topics**
+ [先決條件](#publish-api-prereq)
+ [步驟 1：更新 API 資源政策](#update-API-resource-policy)
+ [步驟 2：建立 API 資料集](#create-api-data-set)
+ [步驟 3：建立修訂](#create-api-revision)
+ [步驟 4：將 API 資產新增至修訂](#add-api-asset)
+ [步驟 5：發佈包含 APIs新產品](#publish-api-data-product)
+ [步驟 6：（選用） 複製產品](#copy-api-product)
## 先決條件
您必須先符合下列先決條件，才能發佈包含 APIs 的產品：
+ 您必須先註冊 AWS 並建立管理使用者 AWS Data Exchange，才能使用任何 AWS 服務，包括 。如需詳細資訊，請參閱*《AWS IAM Identity Center 使用者指南》*中的[「入門」](https://docs.aws.amazon.com//singlesignon/latest/userguide/getting-started.html)。
+ 若要在 上建立產品 AWS Data Exchange，您必須將 註冊 AWS 帳戶 為 AWS Marketplace 賣方。使用此帳戶建立您的資料集。具有 API Gateway 資源的帳戶不需要位於建立資料集的相同帳戶中。
+ 您的 REST API 必須位於具有 整合的 Amazon API Gateway 上，該整合使用適當的請求和回應模型來存取您的資料，例如 Amazon DynamoDB 或 AWS Lambda。如需詳細資訊，請參閱《Amazon [API Gateway 開發人員指南》中的在 API Gateway 中開發](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-develop.html) REST API 和[使用 REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-rest-api.html)。 *Amazon API Gateway *
**注意**
僅支援公有 API Gateway APIs。
+ 您的 API Gateway REST API 必須能夠驗證和授權來自 AWS Data Exchange 服務主體的呼叫。從 AWS Data Exchange 到 API 的每個請求都使用簽章第 4 版 (SigV4) 通訊協定，該通訊協定使用 AWS Data Exchange 登入資料簽署。 AWS Data Exchange 適用於自訂網域和網域金鑰映射。
**注意**
AWS Data Exchange 不支援 Amazon Cognito、未授權和 AWS Lambda 授權方。
+ 如果您的 API Gateway REST API 使用自訂身分系統進行身分驗證和授權，請將其設定為使用 IAM 身分驗證，並匯入描述 API 的 OpenAPI 結構描述。 AWS Data Exchange 會使用自己的服務登入資料叫用您的 API Gateway REST API，並包含訂閱者資訊，例如帳戶 ID。
+ 您的 API Gateway REST API 負責與您的後端整合。若要執行此操作，請執行以下其中一項操作：
+ 將長期身分驗證字符連接到透過後端可驗證的 API Gateway REST API 提出的每個請求。
+ 使用 API Gateway 叫用可產生登入資料和叫用 API 的 Lambda 函數。
根據 API [整合請求規格調用您的 API](#api-request-spec)。
如需詳細資訊，請參閱下列主題：
**Topics**
+ [API 資料集安全性](#api-data-set-security)
+ [API 整合請求規格](#api-request-spec)
+ [標頭轉送](#header-forwarding)
### API 資料集安全性
AWS Data Exchange 使用 Transport Layer Security (TLS) 1.2 加密端對端的流量。所有中繼資料都會靜態加密。 AWS Data Exchange 不會儲存訂閱者請求或來自後端的回應。我們只會擷取帳單所需的計量中繼資料。
### API 整合請求規格
上的 API 會依原樣從客戶請求 AWS Data Exchange 傳遞所有標頭 ( 中列出的標頭除外[標頭轉送](#header-forwarding))、內文、http 方法、路徑和查詢字串，並附加下列標頭。
```
// These headers help prevent Confused Deputy attacks. They enable the SourceAccount
// and SourceArn variables in IAM policies.
'x-amz-source-account': ACCOUNT_ID,
'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`,
// These headers identify the API Asset in Data Exchange.
'x-amzn-dataexchange-asset-id': ASSET_ID,
'x-amzn-dataexchange-data-set-id': DATA_SET_ID,
'x-amzn-dataexchange-revision-id': REVISION_ID,
// This header identifies the Data Exchange Product.
'x-amzn-dataexchange-product-id': PRODUCT_ID,
// This header identifies the caller of Data Exchange. It will contain subscriber
// information.
'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID,
// Providers can attach custom metadata in the form of key/value pairs
// to a particular subscription. We will send these key/value pairs as stringified
// JSON.
'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,
```
### 標頭轉送
AWS Data Exchange 在轉送到供應商後端之前， 會移除任何與身分驗證或命名空間相關的標頭。具體而言， AWS Data Exchange 會移除：
+ `Authentication` 標頭
+ 任何開頭為 的標頭 `x-amz`
`host` 標頭會被覆寫為代理的結果。
## 步驟 1：更新 API 資源政策
如果您有符合[先決條件](#publish-api-prereq)的 Amazon API Gateway REST API，則必須更新您的 API 資源政策，以在訂閱者提出請求以取得 API 的結構描述時授予 AWS Data Exchange 叫用 API 的能力。
**更新您的 API 資源政策**
1. 將下列政策新增至 API 的資源政策：
```
{
"Effect": "Allow",
"Principal": {"Service": "dataexchange.amazonaws.com"},
"Action": "execute-api:Invoke",
"Resource": "*",
"Condition": {"StringEquals": {"aws:SourceAccount": ""}}
}
```
1. `account-id` 將 取代為將建立 API 資料集的帳戶。
具有 API Gateway 資源的帳戶不需要位於建立資料集的相同帳戶中。
此政策會將這些許可限制在 AWS Data Exchange 服務主體進行的呼叫，並要求只有您的帳戶才能授權 AWS Data Exchange 與您的 API 整合。
**注意**
如果您有明確拒絕 AWS Data Exchange 執行此調用的資源政策，您必須移除或限制此拒絕。
您現在可以[建立 API 資料集](#create-api-data-set)。
## 步驟 2：建立 API 資料集
中的資料集 AWS Data Exchange 是動態的，並使用修訂進行版本控制，每個修訂至少包含一個資產。如需詳細資訊，請參閱[中的資料 AWS Data Exchange](data-sets.md)。
您可以使用 AWS Data Exchange 主控台或 AWS Command Line Interface 來建立 API 資料集：
+ [建立 API 資料集 （主控台）](#create-api-ds-console)
+ [建立 API 資料集 (AWS CLI)](#create-api-ds-cli)
### 建立 API 資料集 （主控台）
**建立 API 資料集 （主控台）**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 在左側導覽窗格的**我的資料**下，選擇**擁有的資料集**。
1. 在**擁有的資料集**中，選擇**建立資料集**以開啟**資料集建立步驟**精靈。
1. 在**選取資料集類型**中，選擇 **Amazon API Gateway API**。
1. 在**定義資料集**中，輸入資料集**的名稱**和**描述**。如需詳細資訊，請參閱[資料集最佳實務](data-sets.md#data-set-best-practices)。
1. （選用） 在**新增標籤下 – 選用**，新增標籤。
1. 選擇**建立**。
您現在已準備好建立修訂。
### 建立 API 資料集 (AWS CLI)
**建立 API 資料集 (CLI)**
1. 使用 `create-data-set`命令來建立 API 資料集：
```
$ AWS dataexchange create-data-set \
--asset-type API_GATEWAY_API \
--description 'Data Set Description' \
--name 'Data Set Name'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID",
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:16:46.349000+00:00",
"Description": "Data Set Description",
"Id": "$DATA_SET_ID",
"Name": "Data Set Name",
"Origin": "OWNED",
"UpdatedAt": "2021-09-11T00:16:46.349000+00:00"
}
```
1. 請注意 的新資產類型`API_GATEWAY_API`。
您現在已準備好建立修訂。
## 步驟 3：建立修訂
在下列程序中，您會在建立資料集之後建立修訂。如需詳細資訊，請參閱[修訂](data-sets.md#revisions)。
您可以使用 AWS Data Exchange 主控台或 AWS Command Line Interface 來建立修訂：
+ [建立修訂 （主控台）](#create-api-revision-console)
+ [建立修訂 (AWS CLI)](#create-api-revision-cli)
### 建立修訂 （主控台）
**建立修訂 （主控台）**
1. 在**資料集詳細資訊頁面的資料集概觀**區段中：
1. （選用） 選擇**編輯名稱**以編輯資料集的相關資訊。
1. （選用） 選擇**刪除**以刪除資料集。
1. 在**修訂**區段中，選擇**建立修訂**。
1. 在**定義修訂**下，為您的修訂提供選用註解，以描述修訂的目的。
1. （選用） 在**新增標籤下 – 選用**，新增與資源相關聯的標籤。
1. 選擇**建立修訂**。
1. 檢閱、編輯或刪除上一個步驟的變更。
您現在可以將 [API 資產新增至修訂版](#add-api-asset)。
### 建立修訂 (AWS CLI)
**建立修訂 (AWS CLI)**
1. 使用 `create-revision`命令來建立修訂：
```
$ AWS dataexchange create-revision \
--data-set-id $DATA_SET_ID \
--comment 'First Atlas Revision'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "First Atlas Revision",
"CreatedAt": "2021-09-11T00:18:49.160000+00:00",
"DataSetId": "$DATA_SET_ID",
"Finalized": false,
"Id": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:18:49.160000+00:00"
}
```
1. [將 API 資產新增至修訂版](#add-api-asset)。
**注意**
您需要知道要匯入的 API Gateway REST API 的 ID 以及階段。
## 步驟 4：將 API 資產新增至修訂
API 資產包含訂閱者呼叫 API 所需的資訊。如需詳細資訊，請參閱[資產](data-sets.md#assets)。
在下列程序中，您會匯入資料資產，然後完成修訂。
您可以使用 AWS Data Exchange 主控台或 AWS CLI 將資產新增至修訂：
+ [將 API 資產新增至修訂 （主控台）](#add-api-assets)
+ [將 API 資產新增至修訂版 (AWS CLI)](#add-api-assets-cli)
### 將 API 資產新增至修訂 （主控台）
**將資產新增至修訂版 （主控台）**
1. 在資料集詳細資訊頁面的 **API 資產**區段下，選擇**新增 API 階段**。
1. 在**選取 API 階段**下，針對 **Amazon API Gateway API**，在輸入方塊中輸入 API，或從下拉式清單中選擇下列其中一項：
+ **另一個 API AWS 帳戶** – 這是您已獲得存取許可的跨帳戶 API。
+ **在此 AWS 帳戶** – 這是 中的 API AWS 帳戶。
1. 如果您在**另一個 中選擇 API AWS 帳戶**，請在輸入方塊中輸入 API ID 和 API **階段名稱**。
1. 如果您選擇**在此選項 AWS 帳戶**中，從下拉式清單中選擇 API **階段名稱**
**注意**
您可以選擇建立新 API 階段，****並遵循**在 Amazon API Gateway 上建立新 API 模態中的步驟來建立新的 API** 階段。建立新階段後，請重複步驟 2。
1. 在**進階組態 - 選用**下，您可以選擇**連接現有的 Amazon API Gateway 用量計劃**，以使用現有用量計劃中定義的限流和配額限制，然後輸入 **API 金鑰**。
1. 在**訂閱者的文件 API** 下，提供訂閱者訂閱產品後將看到之 API 的詳細資訊。
1. 針對 **API 名稱**，輸入訂閱者可用來識別 API 資產的名稱。
**注意**
如果選取**了 AWS 帳戶**，則會自動填入 **API 名稱**，您可以視需要加以修改。
如果選取**了另一個 API AWS 帳戶**，則 **API 名稱**會填入預設名稱，您應該將其修改為 ，以便訂閱者可以輕鬆了解其內容。
1. 對於 **OpenAPI 3.0 規格**，請執行下列其中一項操作：
1. 輸入或複製並貼上 OpenAPI 3.0 規格檔案。
1. 選擇**從 .JSON 檔案匯入**，然後從本機電腦選取要匯入的 .json 檔案。
匯入的規格會出現在方塊中。
1. 選擇**從 Amazon API Gateway 匯入**，然後選擇要匯入的規格。
匯入的規格會出現在方塊中。
1. 對於**其他文件 - 選用**，輸入任何有助於訂閱者了解 API 的其他資訊。支援 Markdown。
**注意**
在將此資產新增至修訂版之後，您無法編輯 OpenAPI 規格和其他文件。
如果您想要更新此資訊，而且修訂尚未完成，您可以取代資產。
如果您想要更新此資訊，且修訂已完成，您可以使用更新的資產建立新的修訂。
1. 選擇**新增 API 階段**。
任務開始將資產 （在此案例中為 API) 匯入資料集。
**注意**
如果您在 Amazon API Gateway 上沒有 API，系統會提示您建立一個 API。
1. 任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成。**
1. 如果您要新增更多 APIs，請重複步驟 2。
1. 在**修訂概觀**下，檢閱您的修訂及其資產。
1. 選擇**完成**。
您已成功完成資料集的修訂。
您可以在[將修訂](#edit-api-revision)新增至產品之前[編輯或刪除修訂](#delete-api-revision)。
您現在可以[發佈新的 API 資料產品](#publish-api-data-product)。
### 將 API 資產新增至修訂版 (AWS CLI)
您可以執行 `IMPORT_ASSET_FROM_API_GATEWAY_API`任務來新增 API 資產。
**若要將 API 資產新增至修訂版 (AWS CLI)：**
1. 使用 `create-job`命令將 API 資產新增至修訂：
```
$ AWS dataexchange create-job \
--type IMPORT_ASSET_FROM_API_GATEWAY_API \
--details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
}
},
"Id": "$JOB_ID",
"State": "WAITING",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:19.875000+00:00"
}
$ AWS dataexchange start-job --job-id $JOB_ID
$ AWS dataexchange get-job --job-id $JOB_ID
{
"Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
"ApiEndpoint": "string",
"ApiKey": "string",
"ApiName": "string",
"ApiDescription": "string",
"ApiSpecificationDownloadUrl": "string",
"ApiSpecificationDownloadUrlExpiresAt": "string"
}
},
"Id": "$JOB_ID",
"State": "COMPLETED",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:52.538000+00:00"
}
```
1. 使用 `list-revision-assets`命令來確認新資產是否已正確建立：
```
$ AWS dataexchange list-revision-assets \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID
{
"Assets": [
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID",
"AssetDetails": {
"ApiGatewayApiAsset": {
"ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE",
"ApiId": "$API_ID",
"ProtocolType": "REST",
"Stage": "$API_STAGE"
}
},
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:38:52.457000+00:00",
"DataSetId": "$DATA_SET_ID",
"Id": "$ASSET_ID",
"Name": "$ASSET_ID/$API_STAGE",
"RevisionId": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:38:52.457000+00:00"
}
]
}
```
您現在可以[發佈 API 資料產品](#publish-api-data-product)。
### 編輯修訂
**在您完成修訂之後編輯修訂**
1. 在**修訂概觀**上，選擇**取消最終化**。
您看到修訂不再處於最終狀態的訊息。
1. 若要編輯修訂，請從**修訂概觀**中，選擇**動作**、**編輯**。
1. 進行變更，然後選擇**更新**。
1. 檢閱您的變更，然後選擇**完成**。
### 刪除修訂
**在完成修訂之後刪除修訂**
1. 在**修訂概觀**上，選擇**刪除**。
1. **Delete** 在**刪除修訂**對話方塊中輸入 ，然後選擇**刪除**。
**警告**
這會刪除修訂版及其所有資產。這個操作無法復原。
## 步驟 5：發佈包含 APIs新產品
建立至少一個資料集並使用資產完成修訂後，您就可以將該資料集發佈為產品的一部分。如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。請確定您擁有產品和優惠的所有必要詳細資訊。
您可以使用 AWS Data Exchange 主控台或 AWS Marketplace 目錄 API 來發佈包含 APIs新產品。如需如何使用 AWS Marketplace 目錄 API 發佈新產品的詳細資訊，請參閱 [AWS Data Exchange 搭配 AWS Marketplace 目錄 API 使用](appendices.md)。
+ [發佈包含 APIs新產品 （主控台）](#publish-api-product-console)
### 發佈包含 APIs新產品 （主控台）
**發佈包含 APIs新產品**
1. 在[AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)的左側導覽窗格中，於**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇**發佈新產品**以開啟**發佈新產品**精靈。
1. 在**產品可見性**中：
1. 選擇您產品**的產品可見性選項**為**公**有或**私有**。
可見性設為**公開**的所有 AWS Data Exchange 產品都需要公開優惠。
如需詳細資訊，請參閱[中的產品可見性 AWS Data Exchange](product-visibility.md)。
1. 選擇您產品的**敏感資訊**組態。
如需詳細資訊，請參閱[中的敏感資訊類別 AWS Data Exchange](sensitive-information.md)。
1. 選擇**下一步**。
1. 在**新增資料**中：
1. 在**擁有的資料集**下，選取您要新增的資料集旁的核取方塊，然後選擇**新增已選取**。
**注意**
您選擇的資料集必須具有最終修訂。不會新增沒有最終修訂的資料集。
1. 前往**選取的資料集**以檢閱您的選擇。
您可以檢閱資料集**的名稱**、資料集的**類型**，以及資料集**上次更新**時的時間戳記。
1. 前往**選取修訂存取規則**，然後選擇您要為包含在此產品中的資料集設定的修訂存取規則。
如需詳細資訊，請參閱[中的修訂存取規則 AWS Data Exchange](best-practices-revisions.md)。
1. 選擇**下一步**。
1. 在**定義產品**中：
1. 在**產品概觀**下，輸入產品的相關資訊，包括**產品名稱**、**產品標誌**、**支援聯絡資訊**和**產品類別**。
如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。
1. （選用） 在**資料字典和範例下 – 選用**，選擇資料集名稱旁的選項按鈕，然後選擇**編輯**，以選擇資料集。
1. 在**編輯**對話方塊中，選擇**上傳**以上傳新的資料字典。
您可以選擇一個 .csv 格式的資料字典，大小上限為 1 MB。
1. 從您的電腦選擇儲存的資料字典，然後選擇**開啟**。
資料字典 .csv 檔案會出現在**編輯**對話方塊中。
**注意**
您的資料字典必須符合 AWS Data Exchange 資料字典範本。如果您沒有要上傳的已儲存資料字典，您可以在 主控台中選擇**空白資料字典範本**連結或**範例資料字典**連結 AWS Data Exchange 。
1. 選擇**資料字典預覽**以預覽資料字典。
1. 在**範例 - 選用**下，選擇**上傳範例**，從您的電腦選擇範例，然後選擇**開啟**。
這些範例會出現在**編輯**對話方塊中。
**注意**
您最多可以上傳 10 個大小上限為 50 MB 的範例。.csv 格式的範例可以預覽。
1. 輸入每個範例的說明，這些範例會顯示在產品詳細資訊頁面上。
1. 選擇**儲存**。
1. 在**產品定義**下，輸入產品的**簡短描述**和**長描述**。
如果您想要使用範本做為詳細描述，請選取**套用範本**，選擇您的範本類型，然後以您的特定產品詳細資訊填入範本。
1. 選擇**下一步**。
1. 在**新增公開**優惠 （適用於公開優惠） 或**新增自訂優惠** （適用於私有優惠） 中設定您的優惠：
可見性設為**公開**的所有 AWS Data Exchange 產品都需要公開優惠。
1. 僅適用於私有優惠：
1. 選擇列出的其中一個**優惠類型**：**私有優惠**、**續約私有優惠**或**自攜訂閱 (BYOS)**。
1. 在**訂閱者帳戶資訊**區段中，新增至少一個您要延長優惠的訂閱者帳戶。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 對於**計量成本 - 選用**，請選擇**新增**。
1. 對於**新增計量成本**，請從類型清單中選取 API 呼叫的成本**類型**：
+ **每個 API 請求**
+ **每個成功的 API 請求**
+ **以位元組為單位傳輸的每單位資料**
+ **新的自訂計量成本**
1. 輸入或更新**成本顯示名稱**，這會顯示在訂閱者的發票上。
1. 如果您使用的是**預先定義的計量成本**，金鑰****會自動產生、無法編輯，而且不需要在回應標頭中傳回。
1. 如果您要建立新的**自訂計量成本**，請輸入**金鑰**，這是 API 回應標頭中計量成本的識別符 （最多 15 個字元）。
此**金鑰**應作為`x-amz-dataexchange-metering`回應標頭的一部分傳回。
**Example 自訂金鑰**
如果您有名為 的自訂金鑰**VertexCount**和另一個名為 的自訂金鑰**EdgeCount**，則「x-amz-dataexchange-metering」回應標頭的值可能是 ，`VertexCount=3,EdgeCount=10`或者您可以傳回兩個單獨的標頭行：
`x-amz-dataexchange-metering: VertextCount=3`
`x-amz-dataexchange-metering: EdgeCount=10`
1. 以價格/單位輸入**訂閱者收取的每單位價格**。
1. （選用） 輸入要在**計量成本計算器**中顯示成本範例的單位數量。
1. （選用） 輸入顯示在產品詳細資訊頁面上的計量成本的簡短**描述**。
1. 選擇**新增**。
1. （選用） 重複 以新增額外的計量成本。
計量成本的順序會顯示在產品詳細資訊頁面上。您無法重新排序它們。
**注意**
建立優惠之後，您可以編輯計量成本的價格和描述。如需詳細資訊，請參閱[在 中更新產品和優惠詳細資訊 AWS Data Exchange](update-product-details.md)。
1. 僅針對私有優惠，選擇訂閱者必須接受優惠的**優惠過期日期**。
1. 選擇您的**稅務設定**、**資料訂閱協議 (DSA)** 和**退款政策**。
1. （選用） 對於公開優惠，請設定**訂閱驗證**，這可讓您控制誰可以訂閱此產品。如需詳細資訊，請參閱[中的提供者訂閱驗證 AWS Data Exchange](subscription-verification-pro.md)。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
1. 在**檢閱與發佈**區段中，檢閱您的產品資訊。
1. 展開**產品頁面預覽**，查看產品頁面在發佈後的外觀。
1. （選用） 選擇任何區段中的**編輯**按鈕來編輯該區段。
1. 如果您確定要讓產品和公開優惠可供所有人使用，請選擇**發佈**。
您現在已完成使用公開優惠發佈資料產品的手動部分。 會 AWS Data Exchange 準備和發佈您的產品。
在**產品概觀**頁面上，您的產品狀態為**等待核准**，然後在發佈後變更為**已發佈**。
## 步驟 6：（選用） 複製產品
建立第一個產品之後，您可以複製其詳細資訊和公開優惠來建立新的產品。
**注意**
您可以複製公有、私有、已發佈或未發佈的產品。不會複製與產品相關聯的自訂優惠，但會複製公開優惠。
**複製產品**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇您要複製之產品旁邊的按鈕。
1. 選取**動作**下拉式清單，然後選擇**建立複本**。
1. 根據您在步驟 3 中選擇的產品，繼續進行**發佈新的產品**工作流程，其中包含已填入的詳細資訊。如需詳細資訊，請參閱[步驟 5：發佈新產品](publish-data-product.md#publish-products)。
# 在 中發佈 AWS Data Exchange 包含 Amazon Redshift 資料集的產品
Amazon Redshift 資料集包含 Amazon Redshift AWS Data Exchange 的資料共用。當客戶訂閱包含資料共用的產品時，會授予他們對資料提供者新增至資料共用之資料表、檢視、結構描述和使用者定義函數的唯讀存取權。
身為資料提供者，您可以在叢集中 AWS Data Exchange 為 Amazon Redshift 資料共用建立 。然後，您可以將 新增至資料共用您希望訂閱者存取的結構描述、資料表、檢視和使用者定義函數。然後，您可以將資料共用匯入 AWS Data Exchange、建立資料集、將其新增至產品，以及發佈產品。訂閱者會在訂閱時獲得資料共用的存取權。
在 Amazon Redshift 中設定 Amazon Redshift 資料共用之後，您可以在其中建立新的 Amazon Redshift 資料集 AWS Data Exchange。然後，您可以建立修訂，並新增 Amazon Redshift 資料共用資產。這可讓對 AWS Data Exchange 端點的請求透過 代理至您的 Amazon Redshift 資料共用。然後，您可以將此資料集新增至產品並新增定價。然後，潛在的訂閱者可以檢視您的產品，並在 AWS Data Exchange 目錄中訂閱它。
下列主題說明使用 AWS Data Exchange 主控台建立 Amazon Redshift 資料集並使用 Amazon Redshift 資料集發佈新產品的程序。程序包含下列步驟：
**Topics**
+ [步驟 1：建立 Amazon Redshift 資料共用資產](#create-RS-asset)
+ [步驟 2：建立 Amazon Redshift 資料集](#create-RS-data-set)
+ [步驟 3：建立修訂](#create-RS-revision)
+ [步驟 4：將 Amazon Redshift 資料共用資產新增至修訂](#add-RS-assets)
+ [步驟 5：發佈包含 Amazon Redshift 資料集的新產品](#publish-RS-product)
+ [步驟 6：（選用） 複製產品](#copy-RS-product)
## 步驟 1：建立 Amazon Redshift 資料共用資產
資產是其中的資料 AWS Data Exchange。如需詳細資訊，請參閱[資產](data-sets.md#assets)。
**建立 Amazon Redshift 資料共用資產**
1. 在 Amazon Redshift 叢集中建立資料共用。
如需如何建立資料共用的詳細資訊，請參閱《[Amazon Redshift 資料庫開發人員指南](https://docs.aws.amazon.com/redshift/latest/dg/welcome.html)》中的以*生產者身分使用 AWS Data Exchange 資料共用*。
**注意**
我們建議您將資料共用設定為可公開存取。如果沒有，具有可公開存取叢集的客戶將無法使用您的資料。
1. [步驟 2：建立 Amazon Redshift 資料集](#create-RS-data-set).
## 步驟 2：建立 Amazon Redshift 資料集
Amazon Redshift 資料集包含 Amazon Redshift AWS Data Exchange 的資料共用。如需詳細資訊，請參閱[Amazon Redshift 資料集](data-sets.md#RS-data-set-type)。
**建立 Amazon Redshift 資料集**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 在左側導覽窗格的**發佈資料**下，選擇**擁有的資料集**。
1. 在**擁有的資料集**中，選擇**建立資料集**以開啟**資料集建立步驟**精靈。
1. 在**選取資料集類型**中，選擇 **Amazon Redshift 資料共用**。
1. 在**定義資料集**中，輸入資料集**的名稱**和**描述**。如需詳細資訊，請參閱[資料集最佳實務](data-sets.md#data-set-best-practices)。
1. 在**新增標籤 - 選用**下，新增標籤。
1. 選擇**建立**。
## 步驟 3：建立修訂
在下列程序中，您會在 AWS Data Exchange 主控台中建立資料集之後建立修訂。如需詳細資訊，請參閱[修訂](data-sets.md#revisions)。
**建立修訂**
1. 在**資料集詳細資訊頁面的資料集概觀**區段中：
1. （選用） 選擇**編輯名稱**以編輯資料集的相關資訊。
1. （選用） 選擇**刪除**以刪除資料集。
1. 在**修訂**區段中，選擇**建立修訂**。
1. 在**定義修訂**下，為您的修訂提供選用註解，以描述修訂的目的。
1. 在**新增標籤 - 選用**下，新增與資源相關聯的標籤。
1. 選擇**建立**。
1. 檢閱、編輯或刪除上一個步驟的變更。
## 步驟 4：將 Amazon Redshift 資料共用資產新增至修訂
在下列程序中，您將 Amazon Redshift 資料共用資產新增至修訂，然後在 AWS Data Exchange 主控台中完成修訂。如需詳細資訊，請參閱[資產](data-sets.md#assets)。
**將資產新增至修訂**
1. 在資料集詳細資訊頁面的 **AWS Data Exchange Amazon Redshift 資料共用**區段下，選擇**新增資料共用**。
1. 在 **AWS Data Exchange Amazon Redshift 的資料共用**下，選取資料共用，然後選擇**新增資料共用 (s)**。
**注意**
您最多可以將 20 個資料共用新增至修訂。
任務已開始將資產匯入修訂版本。
1. 任務完成後，**任務**區段中的**狀態**欄位會更新為**已完成。**
1. 如果您要新增更多資料，請重複步驟 1。
1. 在**修訂概觀**下，檢閱您的修訂及其資產。
1. 選擇**完成**。
您已成功完成資料集的修訂。
您可以在將修訂新增至產品之前編輯[編輯修訂](publish-data-product.md#edit-revision)或刪除修訂。 [刪除修訂](publish-data-product.md#delete-revision)
## 步驟 5：發佈包含 Amazon Redshift 資料集的新產品
建立至少一個資料集並使用資產完成修訂後，您就可以使用 Amazon Redshift 資料集發佈產品。如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。請確定您擁有產品和優惠的所有必要詳細資訊。
**發佈包含 Amazon Redshift 資料集的新產品**
1. 在[AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)的左側導覽窗格中，於**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇**發佈新產品**以開啟**發佈新產品**精靈。
1. 在**產品可見**性區段中，選擇您產品**的產品可見性選項**和**敏感資訊**組態，然後選擇**下一步**。如需詳細資訊，請參閱[中的產品可見性 AWS Data Exchange](product-visibility.md)及[中的敏感資訊類別 AWS Data Exchange](sensitive-information.md)。
1. 在**新增資料**區段**的擁有的資料集**下，選取您要新增之資料集旁的核取方塊，然後選擇**新增已選取**。
**注意**
您選擇的資料集必須具有最終修訂。不會新增沒有最終修訂的資料集。
1. 前往**選取的資料集**以檢閱您的選擇。
您可以檢閱資料集**的名稱**、資料集的**類型**，以及資料集**上次更新**時的時間戳記。
1. 前往**選取修訂存取規則**，選擇要為包含在此產品中的資料集設定的修訂存取規則，然後選擇**下一步**。
如需詳細資訊，請參閱[中的修訂存取規則 AWS Data Exchange](best-practices-revisions.md)。
1. 在**定義產品**區段**的產品概觀**下，輸入產品的相關資訊，包括**產品名稱**、**產品標誌**、**支援聯絡資訊**和**產品類別**。
如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。
1. （選用） 在**定義產品**區段中，在**資料字典和範例下 – 選用**，選擇資料集名稱旁的選項按鈕，然後選擇**編輯**，以選擇資料集。
如需詳細資訊，請參閱[中的資料字典 AWS Data Exchange](data-dictionaries-pro.md)及[中的範例資料 AWS Data Exchange](samples-pro.md)。
1. 在**編輯**對話方塊的**上傳資料字典**下，選擇**新增檔案**以上傳新的資料字典。
您可以選擇一個 .csv 格式的資料字典，大小上限為 1 MB。
1. 從您的電腦選擇儲存的資料字典，然後選擇**開啟**。
資料字典 .csv 檔案會出現在**編輯**對話方塊中。
**注意**
您的資料字典必須符合 AWS Data Exchange 資料字典範本。如果您沒有要上傳的已儲存資料字典，您可以在 AWS Data Exchange 主控台中選擇**空白資料字典範本**連結或**範例資料字典**連結。
1. 選擇**資料字典預覽**以預覽。
1. 在**範例 - 選用**下，選擇**上傳範例**，從您的電腦選擇範例，然後選擇**開啟**。
這些範例會出現在**編輯**對話方塊中。
**注意**
您最多可以上傳 10 個大小上限為 50 MB 的範例。.csv 格式的範例可以預覽。
1. 輸入每個範例的說明，這些範例會顯示在產品詳細資訊頁面上。
1. 選擇**儲存**。
1. 在**產品定義**下，輸入產品的**簡短描述**和**長描述**。
如果您想要使用範本做為詳細描述，請選取**套用範本**，選擇您的範本類型，然後以您的特定產品詳細資訊填寫範本。
1. 選擇**下一步**。
1. 設定您的優惠。
+ 如果您要建立公開優惠，請在**新增公開優惠**區段中設定您的優惠。可見性設為**公開**的所有 AWS Data Exchange 產品都需要公開優惠。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. （選用） 設定**訂閱驗證**，可讓您控制誰可以訂閱此產品。如需詳細資訊，請參閱[中的提供者訂閱驗證 AWS Data Exchange](subscription-verification-pro.md)。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
+ 如果您要建立私有優惠，請在**新增自訂優惠區段中設定優惠**詳細資訊。
1. 在**訂閱者帳戶資訊**區段中，新增至少一個您要延長優惠的訂閱者帳戶。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇訂閱者必須接受優惠的優惠**過期日期**。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
1. 在**檢閱與發佈**區段中，檢閱您的產品資訊，然後展開**產品頁面預覽**，以查看發佈後的外觀。
1. 如果您確定要讓產品和公開優惠可供所有人使用，請選擇**發佈**。
您現在已完成使用公開優惠發佈資料產品的手動部分。 會 AWS Data Exchange 準備和發佈您的產品。在**產品概觀**頁面上，您的產品狀態為**等待核准**，然後在發佈後變更為**已發佈**。
## 步驟 6：（選用） 複製產品
建立第一個產品之後，您可以複製其詳細資訊和公開優惠來建立新的產品。
**注意**
您可以複製公有、私有、已發佈或未發佈的產品。不會複製與產品相關聯的自訂優惠，但會複製公開優惠。
**複製產品**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇您要複製之產品旁邊的按鈕。
1. 選取**動作**下拉式清單，然後選擇**建立複本**。
1. 根據您在步驟 3 中選擇的產品，繼續進行**發佈產品**工作流程，其中包含已填入的詳細資訊。如需詳細資訊，請參閱[步驟 5：發佈新產品](publish-data-product.md#publish-products)。
# 在 中發佈 AWS Data Exchange 包含 Amazon S3 資料存取的產品
使用 AWS Data Exchange for Amazon S3，供應商可以直接存取 Amazon S3 儲存貯體或特定字首和 Amazon S3 物件。供應商也會使用 AWS Data Exchange 自動管理訂閱、權利、帳單和付款。
身為資料提供者，您可以直接存取整個 Amazon S3 儲存貯體或特定字首和 Amazon S3 物件，而無需建立或管理複本。這些共用的 Amazon S3 物件可以使用存放在 AWS Key Management Service (AWS KMS) 或 AWS 受管金鑰 (SSE-S3) 中的客戶受管金鑰進行伺服器端加密。如需監控 KMS 金鑰和了解加密內容的詳細資訊，請參閱 [Amazon S3 資料存取的金鑰管理](key-management.md)。當客戶訂閱您的資料產品時， AWS Data Exchange 會自動佈建 Amazon S3 存取點，並代表您更新其資源政策，以授予訂閱者唯讀存取權。訂閱者可以在使用 Amazon S3 儲存貯體名稱存取 Amazon S3 中資料的位置使用 Amazon S3 存取點別名。
當訂閱結束時，訂閱者的許可會被撤銷。如果您選擇提早結束與訂閱者的協議，請聯絡 [AWS 支援](https://console.aws.amazon.com/support/home#/case/create%3FissueType=customer-service)。您可以在資料訂閱協議 (DSA) 中新增訂閱條款。
您必須先符合下列先決條件，才能發佈包含 Amazon S3 資料存取的產品：
**先決條件**
+ 確認託管資料的 Amazon S3 儲存貯體已使用開啟**停用 ACLs**的 Amazon S3 儲存貯體擁有者強制執行設定進行設定。如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[控制物件的擁有權和停用儲存貯體ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)。
+ 您的共用物件必須位於 Amazon S3 標準儲存類別中，或使用 S3 Intelligent Tiering 進行管理，訂閱者才能成功存取它們。如果訂閱者位於其他儲存類別中，或者您已使用 Deep Archive 啟用智慧型分層，您的訂閱者將會收到錯誤，因為他們沒有 的許可`RestoreObject`。
+ 確認託管資料的 Amazon S3 儲存貯體已停用加密，或使用存放在 () 中的 AWS Key Management Service Amazon S3 受管金鑰 (SSE-S3) 或客戶受管金鑰進行加密AWS KMS。
+ 如果您使用客戶受管金鑰，您必須具備下列項目：
1. KMS 金鑰`kms:CreateGrant`上 的 IAM 許可。您可以透過金鑰政策、IAM 登入資料或 KMS 金鑰上的 AWS KMS 授予來存取這些許可。如需金鑰管理和了解 AWS Data Exchange AWS 如何使用 KMS 授權的詳細資訊，請參閱 [建立 AWS KMS 授予](key-management.md#create-kms-grants)。
若要提供存取權，請新增權限至您的使用者、群組或角色：
+ 中的使用者和群組 AWS IAM Identity Center：
建立權限合集。請按照《*AWS IAM Identity Center 使用者指南*》中的[建立權限合集](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html)說明進行操作。
+ 透過身分提供者在 IAM 中管理的使用者：
建立聯合身分的角色。遵循《*IAM 使用者指南*》的[為第三方身分提供者 (聯合) 建立角色](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html)中的指示。
+ IAM 使用者：
+ 建立您的使用者可擔任的角色。請按照《*IAM 使用者指南*》的[為 IAM 使用者建立角色](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html)中的指示。
+ (不建議) 將政策直接附加至使用者，或將使用者新增至使用者群組。請遵循《*IAM 使用者指南*》的[新增許可到使用者 (主控台)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) 中的指示。
如果使用者想要與 AWS 外部互動，則需要程式設計存取 AWS 管理主控台。授予程式設計存取權的方式取決於正在存取的使用者類型 AWS。
若要授予使用者程式設計存取權，請選擇下列其中一個選項。
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/data-exchange/latest/userguide/publish-s3-data-access-product.html)
以下是 JSON 政策範例，示範如何將 新增至 KMS 金鑰的金鑰政策。
```
{
"Sid": "AllowCreateGrantPermission",
"Effect": "Allow",
"Principal": {
"AWS": ""
},
"Action": "kms:CreateGrant",
"Resource": "*"
}
```
下列政策顯示所使用 IAM 身分新增的範例政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Sid": "AllowCreateGrantPermission",
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
]
}
]
}
```
------
**注意**
如果透過先前步驟取得 KMS 金鑰的`kms:CreateGrant`許可，則也允許跨帳戶 KMS 金鑰。如果另一個帳戶擁有金鑰，您必須擁有金鑰政策和 IAM 憑證的許可，如上述範例所述。
1. 請務必使用 KMS 金鑰，使用 Amazon S3 儲存貯體金鑰功能加密 Amazon S3 儲存貯體中的現有和新物件。如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[設定 S3 儲存貯體金鑰](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-key.html#configure-bucket-key)。
+ 對於新增至 Amazon S3 儲存貯體的新物件，您可以預設設定 Amazon S3 儲存貯體金鑰加密。如果現有物件已使用 Amazon S3bucket金鑰功能加密，則必須遷移這些物件，才能使用 Amazon S3 儲存貯體金鑰進行加密。
若要為現有物件啟用 Amazon S3 儲存貯體金鑰，請使用 `copy`操作。如需詳細資訊，請參閱[使用批次操作在物件層級設定 Amazon S3 儲存貯體金鑰](https://docs.aws.amazon.com/AmazonS3/latest/userguide/configuring-bucket-key-object.html)。
+ AWS 不支援 或 AWS 擁有的金鑰 受管 KMS 金鑰。您可以從不支援的加密機制遷移到目前支援的加密機制。如需詳細資訊，請參閱 AWS Storage Blog [中的變更 Amazon S3 加密](https://aws.amazon.com/blogs/storage/changing-your-amazon-s3-encryption-from-s3-managed-encryption-sse-s3-to-aws-key-management-service-sse-kms/)。
1. 將託管資料的 Amazon S3 儲存貯體設定為信任 AWS Data Exchange 擁有的存取點。您必須更新這些 Amazon S3 儲存貯體政策，以授予 AWS Data Exchange 建立 Amazon S3 存取點的許可，並代表您授予或移除訂閱者的存取權。如果缺少政策陳述式，您必須編輯儲存貯體政策，才能將 Amazon S3 位置新增至資料集。
以下所示為政策範例。`` 將 取代為適當的值。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::BucketName",
"arn:aws:s3:::/*"
],
"Condition": {
"StringEquals": {
"s3:DataAccessPointAccount": [
"337040091392",
"504002150500",
"366362662752",
"330489627928",
"291973504423",
"461002523379",
"036905324694",
"540564263739",
"675969394711",
"108584782536",
"844053218156"
]
}
}
}
]
}
```
------
您可以透過 將資料共用委派 AWS Data Exchange 給整個 Amazon S3 儲存貯體。不過，您可以將委派範圍限定為您要在資料集中共用之儲存貯體的特定字首和物件。以下是範圍政策的範例。`"mybucket/folder1/*"` 使用您自己的資訊取代 ``和 。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DelegateToAdxGetObjectsInFolder1",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::mybucket/folder1/*"
],
"Condition": {
"StringEquals": {
"s3:DataAccessPointAccount": [
"337040091392",
"504002150500",
"366362662752",
"330489627928",
"291973504423",
"461002523379",
"036905324694",
"540564263739",
"675969394711",
"108584782536",
"844053218156"
]
}
}
},
{
"Sid": "DelegateToAdxListObjectsInFolder1",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::mybucket",
"Condition": {
"StringLike": {
"s3:prefix": [
"folder1/*"
]
},
"StringEquals": {
"s3:DataAccessPointAccount": [
"337040091392",
"504002150500",
"366362662752",
"330489627928",
"291973504423",
"461002523379",
"036905324694",
"540564263739",
"675969394711",
"108584782536",
"844053218156"
]
}
}
}
]
}
```
------
同樣地，若要僅限制對單一檔案的存取，供應商可以使用下列政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DelegateToAdxGetMyFile",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::mybucket/folder1/myfile"
],
"Condition": {
"StringEquals": {
"s3:DataAccessPointAccount": [
"337040091392",
"504002150500",
"366362662752",
"330489627928",
"291973504423",
"461002523379",
"036905324694",
"540564263739",
"675969394711",
"108584782536",
"844053218156"
]
}
}
}
]
}
```
------
下列主題說明使用 AWS Data Exchange 主控台建立 Amazon S3 資料集並使用 Amazon S3 資料集發佈新產品的程序。程序包含下列步驟：
**Topics**
+ [步驟 1：建立 Amazon S3 資料集](#create-S3-data-set)
+ [步驟 2：設定 Amazon S3 資料存取](#configure-s3-data-access-product)
+ [步驟 3：檢閱並完成資料集](#review-finalize-s3-data-set-product)
+ [步驟 4：將 Amazon S3 資料集新增至 AWS Data Exchange 產品](#add-s3-data-set-to-existing-product)
+ [步驟 5：發佈包含 Amazon S3 存取權的新產品](#publish-s3-product)
+ [步驟 6：（選用） 複製產品](#copy-s3-product)
## 步驟 1：建立 Amazon S3 資料集
**建立 Amazon S3 資料集**
1. 在左側導覽窗格的**發佈資料**下，選擇**擁有的資料集**。
1. 在左側導覽窗格的**發佈資料**下，選擇**擁有的資料集**。
1. 在**擁有的資料集**中，選擇**建立資料集**以開啟**資料集建立步驟**精靈。
1. 在**選取資料集類型**中，選擇 **Amazon S3 資料存取**。
1. 在**定義資料集**中，輸入資料集**的名稱**和**描述**。如需詳細資訊，請參閱[資料集最佳實務](data-sets.md#data-set-best-practices)。
1. （選用） 在**新增標籤下 – 選用**，新增標籤。
1. 選擇**建立資料集**並繼續。
## 步驟 2：設定 Amazon S3 資料存取
選擇您要提供給訂閱者的 Amazon S3 儲存貯體或 Amazon S3 儲存貯體位置。您可以選取整個 Amazon S3 儲存貯體，或在 Amazon S3 儲存貯體中指定最多五個字首或物件。若要新增更多 Amazon S3 儲存貯體，您必須建立另一個 Amazon S3 資料共用。
**設定共用的 Amazon S3 資料存取**
1. 在**設定 Amazon S3 資料存取**頁面上，選取**選擇 Amazon S3 位置**。
1. 在**選擇 Amazon S3 位置**中，在搜尋列輸入您的 Amazon S3 儲存貯體名稱，或選取您的 Amazon S3 儲存貯體、字首或 Amazon S3 檔案，然後選擇**新增已選取**。然後，選擇**新增位置**。
**注意**
我們建議選擇儲存大部分物件和字首的頂層資料夾，以便提供者不需要重新設定要共用的字首或物件。
1. 在**組態詳細資訊**中，選擇您的**申請者付款**組態。您有兩個選項：
+ **啟用申請者付款 ***（建議）* – 申請者將支付 Amazon S3 儲存貯體中的所有請求和轉移。我們建議您使用此選項，因為它有助於防止訂閱者請求和轉移的意外成本。
+ **停用申請者付款** – 您需要為 Amazon S3 儲存貯體中的訂閱者請求和轉移付費。
如需**申請者付款**的詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*[》中的申請者付款儲存貯體中的物件](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ObjectsinRequesterPaysBuckets.html)。
1. 選取最符合您需求的**儲存貯體政策**。選擇**一般**，以針對整個 Amazon S3 儲存貯體使用一個儲存貯體政策。這是一次性組態，未來共用字首或物件不需要額外的組態。選擇**特定**以使用特定於所選 Amazon S3 位置的儲存貯體政策。您共用的 Amazon S3 儲存貯體需要儲存貯體政策，才能成功建立 Amazon S3 資料存取資料集，且無法啟用 ACLs。
1. 若要停用 ACLs，請導覽至您的儲存貯體許可，並將**物件擁有權**設定為**強制執行的儲存貯體擁有者**。
1. 若要新增儲存貯體政策，請將儲存貯體陳述式複製到剪貼簿。在 Amazon S3 主控台的 **Amazon S3 許可**索引標籤中，選擇**儲存貯體政策**區段中的**編輯**、將儲存貯體政策貼入陳述式，以及**儲存變更**。
1. 如果 Amazon S3 儲存貯體包含使用 AWS KMS 客戶受管金鑰加密的物件，您必須與 共用所有這類 KMS 金鑰 AWS Data Exchange。如需使用 KMS 金鑰加密 Amazon S3 儲存貯體中物件時所需先決條件的相關資訊，請參閱 [在 中發佈 AWS Data Exchange 包含 Amazon S3 資料存取的產品](#publish-s3-data-access-product)。若要與 共用這些 KMS 金鑰 AWS Data Exchange，請執行下列動作：
1. 在**設定 Amazon S3 資料存取**頁面的客戶**受管 KMS 金鑰**中，選取**從 中選擇 AWS KMS keys**或**輸入 AWS KMS key ARN**，然後選取**AWS KMS keys**所有目前用來加密 Amazon S3 共用位置的 。 AWS Data Exchange 使用這些 KMS 金鑰為訂閱者建立存取共用位置的授予。如需詳細資訊，請參閱 [中的授與 AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/grants.html)。
**注意**
AWS KMS 每個 KMS 金鑰有 50，000 個授予的限制，包括預先存在的授予。
1. 檢閱您的 Amazon S3 位置、選取的 KMS 金鑰和組態詳細資訊，然後選擇**儲存並繼續**。
## 步驟 3：檢閱並完成資料集
檢閱並完成您新建立的資料集。如果您想要建立和新增另一個 Amazon S3 資料存取權，以共用對其他 Amazon S3 儲存貯體、字首、物件的存取權，請選擇**新增另一個 Amazon S3 資料存取權**。
**注意**
當需要共用託管在與在初始 Amazon S3 資料存取中先前選取的不同 Amazon S3 儲存貯體中的資料存取權時，我們建議這樣做。
如果您想要在發佈之前進行變更，您可以選擇儲存草稿，將資料集**儲存為草稿**。然後，選擇**完成資料集**以將其新增至您的產品。
## 步驟 4：將 Amazon S3 資料集新增至 AWS Data Exchange 產品
在下列程序中，您可以將資料集新增至新的或現有的 AWS Data Exchange 產品。
**將資料集新增至新的或現有的 AWS 資料交換產品**
1. 在**擁有的資料集**頁面的**資料集概觀**下，您可以從資料集**編輯名稱**、**刪除**或建立產品。 ****
1. 完成產品建立，指定產品描述、使用案例、中繼資料、定價，以及條款與條件。
1. 完成時**檢閱並發佈**產品。
**注意**
當客戶訂閱您的產品時，客戶會收到使用代表您建立的 Amazon S3 存取點讀取和使用資料的存取許可。
## 步驟 5：發佈包含 Amazon S3 存取權的新產品
建立至少一個資料集並使用資產完成修訂後，您可以發佈具有 Amazon S3 資料存取權的產品。如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。請確定您擁有產品和優惠的所有必要詳細資訊。
**注意**
除非已更改 Amazon S3 位置且訂閱者無法存取這些物件，否則您在更新共用 Amazon S3 物件時不需要建立新的修訂。
**發佈包含 Amazon S3 存取權的新產品**
1. 在[AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)的左側導覽窗格中，於**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇**發佈新產品**以開啟**發佈新產品**精靈。
1. 在**產品可見**性區段中，選擇您產品**的產品可見性選項**和**敏感資訊**組態，然後選擇**下一步**。如需詳細資訊，請參閱[中的產品可見性 AWS Data Exchange](product-visibility.md)及[中的敏感資訊類別 AWS Data Exchange](sensitive-information.md)。
1. 在**新增資料**區段**的擁有的資料集**下，選取您要新增的資料集旁的核取方塊，然後選擇**新增已選取**。
**注意**
您選擇的資料集必須具有最終修訂。不會新增沒有最終修訂的資料集。
1. 前往**選取的資料集**以檢閱您的選擇。
您可以檢閱資料集**的名稱**、資料集的**類型**，以及資料集**上次更新**時的時間戳記。
1. 前往**選取修訂存取規則**，選擇要為包含在此產品中的資料集設定的修訂存取規則，然後選擇**下一步**。
如需詳細資訊，請參閱[中的修訂存取規則 AWS Data Exchange](best-practices-revisions.md)。
1. 在**定義產品**區段**的產品概觀**下，輸入產品的相關資訊，包括**產品名稱**、**產品標誌**、**支援聯絡資訊**和**產品類別**。
如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。
1. （選用） 在**定義產品**區段中，在**資料字典和範例下 – 選用**，選擇資料集名稱旁的選項按鈕，然後選擇**編輯**，以選擇資料集。
如需詳細資訊，請參閱[中的資料字典 AWS Data Exchange](data-dictionaries-pro.md)及[中的範例資料 AWS Data Exchange](samples-pro.md)。
1. 在**編輯**對話方塊的**上傳資料字典**下，選擇**新增檔案**以上傳新的資料字典。
您可以選擇一個 .csv 格式的資料字典，大小上限為 1 MB。
1. 從您的電腦選擇儲存的資料字典，然後選擇**開啟**。
資料字典 .csv 檔案會出現在**編輯**對話方塊中。
**注意**
您的資料字典必須符合 AWS Data Exchange 資料字典範本。如果您沒有要上傳的已儲存資料字典，您可以在 AWS Data Exchange 主控台中選擇**空白資料字典範本**連結或**範例資料字典**連結。
1. 選擇**資料字典預覽**以預覽資料字典。
1. 在**範例 - 選用**下，選擇**上傳範例**，從您的電腦選擇範例，然後選擇**開啟**。
這些範例會出現在**編輯**對話方塊中。
**注意**
您最多可以上傳 10 個大小上限為 50 MB 的範例。.csv 格式的範例可以預覽。
1. 輸入每個範例的說明，這些範例會顯示在產品詳細資訊頁面上。
1. 選擇**儲存**。
1. 在**產品定義**下，輸入產品的**簡短描述**和**長描述**。
如果您想要使用範本進行詳細描述，請選取**套用範本**，選擇您的範本類型，然後在範本中提供您的特定產品詳細資訊。
1. 選擇**下一步**。
1. 設定您的優惠。
+ 如果您要建立公開優惠，請在**新增公開優惠**區段中設定您的優惠。可見性設為**公開**的所有 AWS Data Exchange 產品都需要公開優惠。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. （選用） 設定**訂閱驗證**以控制誰可以訂閱此產品。如需詳細資訊，請參閱[中的提供者訂閱驗證 AWS Data Exchange](subscription-verification-pro.md)。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
+ 如果您要建立私有優惠，請在**新增自訂優惠區段中設定優惠**詳細資訊。
1. 在**訂閱者帳戶資訊**區段中，新增至少一個您要延長優惠的訂閱者帳戶。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇訂閱者必須接受優惠的優惠**過期日期**。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
1. 在**檢閱與發佈**區段中，檢閱您的產品資訊，然後展開**產品頁面預覽**，以查看發佈後的外觀。
1. 如果您確定要讓產品和公開優惠可供所有人使用，請選擇**發佈**。
您現在已完成使用公開優惠發佈資料產品的手動部分。 會 AWS Data Exchange 準備和發佈您的產品。在**產品概觀**頁面上，您的產品狀態為**等待核准**。產品**發佈**後，狀態會變更為已發佈。
## 步驟 6：（選用） 複製產品
建立第一個產品之後，您可以複製其詳細資訊和公開優惠來建立新的產品。
**注意**
您可以複製公有、私有、已發佈或未發佈的產品。與產品相關聯的自訂優惠無法複製，但可以複製公有優惠。
**複製產品**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇您要複製之產品旁邊的選項。
1. 選取**動作**下拉式清單，然後選擇**建立複本**。
1. 根據您在步驟 3 中選擇的產品，繼續進行**發佈產品**工作流程，其中包含已填入的詳細資訊。如需詳細資訊，請參閱[步驟 5：發佈新產品](publish-data-product.md#publish-products)。
# 在 中發佈 AWS Data Exchange 包含 AWS Lake Formation 資料許可資料集的產品 （預覽）
如果您有興趣在此預覽期間發佈包含 AWS Lake Formation 資料許可資料集的產品，請聯絡 [AWS 支援](https://console.aws.amazon.com/support/home#/case/create%3FissueType=customer-service)。
AWS Lake Formation 資料許可資料集包含一組 LF 標籤和由 管理之資料的許可 AWS Lake Formation。當客戶訂閱包含 Lake Formation 資料許可的產品時，會授予他們唯讀存取權，以存取與新增至資料集的 LF 標籤相關聯的資料庫、資料表和資料欄。
身為資料提供者，首先在 中建立 LF 標籤， AWS Lake Formation 並將這些標籤與要提供給訂閱者的資料建立關聯。如需在 Lake Formation 中標記資源的詳細資訊，請參閱《 *AWS Lake Formation 開發人員指南*》中的 [Lake Formation 標籤型存取控制](https://docs.aws.amazon.com/lake-formation/latest/dg/tag-based-access-control.html)。然後，將這些 LF 標籤和一組資料許可匯入 AWS Data Exchange 做為資產。在訂閱時，訂閱者會獲得與這些 LF 標籤相關聯的資料的存取權。
下列主題說明發佈包含 AWS Lake Formation 資料許可的產品的程序。程序包含下列步驟：
**Topics**
+ [步驟 1：建立 AWS Lake Formation 資料集 （預覽）](#create-LF-data-set)
+ [步驟 2：建立 AWS Lake Formation 資料許可 （預覽）](#create-LF-data-permission)
+ [步驟 3：檢閱並完成](#review-and-finalize-LF)
+ [步驟 5：（選用） 建立修訂](#create-revision-LF)
+ [步驟 6：發佈包含 AWS Lake Formation 資料集的新產品 （預覽）](#publish-LF-product)
+ [發佈 AWS Lake Formation 資料許可資料集時的考量 （預覽）](#considerations-LF-data-product)
## 步驟 1：建立 AWS Lake Formation 資料集 （預覽）
**建立 AWS Lake Formation 資料集**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 在**擁有的資料集**中，選擇**建立資料集**以開啟**資料集建立步驟**精靈。
1. 在**選取資料集類型**中，選擇**AWS Lake Formation 資料許可**。
1. 在**定義資料集**中，輸入資料集**的名稱**和**描述**。如需詳細資訊，請參閱[資料集最佳實務](data-sets.md#data-set-best-practices)。
1. 在**新增標籤 - 選用**下，選擇**新增標籤**。
1. 選擇**建立資料集**並繼續。
## 步驟 2：建立 AWS Lake Formation 資料許可 （預覽）
AWS Data Exchange 使用 LF 標籤授予資料許可。選擇與您要共用之資料相關聯的 LF 標籤，以授予訂閱者對資料的許可。
**建立 AWS Lake Formation 資料許可**
1. 在**建立 Lake Formation 資料許可**頁面上，選擇**新增 LF 標籤**。
1. 輸入**金鑰**並選擇您的 LF 標籤**值**。
1. 選擇**預覽資源 （預覽資源）** 以檢視如何解譯 LF 標籤。
1. 在**預覽資源 （預覽資源）** 中，選取您的**關聯資料目錄資源 （預覽資源）**。
**注意**
請務必撤銷下列資源的`IAMAllowedPrincipals`群組。如需詳細資訊，請參閱《[IAM 使用者指南》中的撤銷 IAM 角色臨時安全登入](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_revoke-sessions.html)資料。 **
1. 在下面的對話方塊中檢閱 LF-Tag 表達式的解釋，以及與資料集相關聯的**許可**。
1. 針對**服務存取**，選取您現有的服務角色， AWS Data Exchange 允許 代表您擔任角色，以及存取、授予和撤銷 Lake Formation 資料許可的權限。然後選擇**建立 Lake Formation 資料許可**。如需為 建立角色的詳細資訊 AWS 服務，請參閱[建立角色以將許可委派給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。
1. 在**定義產品**區段**的產品概觀**下，輸入產品的相關資訊，包括**產品名稱**、**產品標誌**、**支援聯絡資訊**和**產品類別**。
如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。
1. （選用） 在**定義產品**區段中，在**資料字典和範例下 – 選用**，選擇資料集名稱旁的選項按鈕，然後選擇**編輯**，以選擇資料集。
如需詳細資訊，請參閱[中的資料字典 AWS Data Exchange](data-dictionaries-pro.md)及[中的範例資料 AWS Data Exchange](samples-pro.md)。
1. 在**編輯**對話方塊的**上傳資料字典**下，選擇**新增檔案**以上傳新的資料字典。
您可以選擇一個 .csv 格式的資料字典，大小上限為 1 MB。
1. 從您的電腦選擇儲存的資料字典，然後選擇**開啟**。
資料字典 .csv 檔案會出現在**編輯**對話方塊中。
**注意**
您的資料字典必須符合 AWS Data Exchange 資料字典範本。如果您沒有要上傳的已儲存資料字典，您可以在 AWS Data Exchange 主控台中選擇**空白資料字典範本**連結或**範例資料字典**連結。
1. 選擇**資料字典預覽**以預覽資料字典。
1. 在**範例 - 選用**下，選擇**上傳範例**，從您的電腦選擇範例，然後選擇**開啟**。
這些範例會出現在**編輯**對話方塊中。
**注意**
您最多可以上傳 10 個大小上限為 50 MB 的範例。.csv 格式的範例可以預覽。
1. 輸入每個範例的說明，這些範例會顯示在產品詳細資訊頁面上。
1. 選擇**儲存**。
1. 在**產品定義**下，輸入產品的**簡短描述**和**長描述**。
如果您想要使用範本進行詳細描述，請選取**套用範本**，選擇您的範本類型，然後在範本中提供您的特定產品詳細資訊。
1. 選擇**下一步**。
1. 設定您的優惠。
+ 如果您要建立公開優惠，請在**新增公開優惠**區段中設定您的優惠。可見性設為**公開**的所有 AWS Data Exchange 產品都需要公開優惠。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. （選用） 設定**訂閱驗證**以控制誰可以訂閱此產品。如需詳細資訊，請參閱[中的提供者訂閱驗證 AWS Data Exchange](subscription-verification-pro.md)。
1. 選擇您的**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
+ 如果您要建立私有優惠，請在**新增自訂優惠區段中設定優惠**詳細資訊。
1. 在**訂閱者帳戶資訊**區段中，新增至少一個您要延長優惠的訂閱者帳戶。
1. 選擇訂閱的**定價和存取持續時間**選項。
1. 選擇訂閱者必須接受優惠的優惠**過期日期**。
1. 選擇您的美國銷售稅設定、資料訂閱協議 (DSA) 和退款政策。
1. 選擇**優惠自動續約**選項。如需詳細資訊，請參閱[為 AWS Data Exchange 產品建立優惠](prepare-offers.md)。
1. 選擇**下一步**。
1. 在**檢閱與發佈**區段中，檢閱您的產品資訊，然後展開**產品頁面預覽**，以查看發佈後的外觀。
1. 如果您確定要讓產品和公開優惠可供所有人使用，請選擇**發佈**。
您現在已完成使用公開優惠發佈資料產品的手動部分。 會 AWS Data Exchange 準備和發佈您的產品。在**產品概觀**頁面上，您的產品狀態為**等待核准**。產品**發佈**後，狀態會變更為已發佈。
## 步驟 3：檢閱並完成
建立 AWS Lake Formation 資料許可 （預覽） 之後，您可以**檢閱**和**完成**資料集。
**若要檢閱和完成**
1. 檢閱**步驟 1 **中的**資料集詳細資訊**和**標籤**的準確性。
1. 檢閱您的 **LF-Tag 表達式 (s)**、**新增另一個 Lake Formation 資料許可** （選用）、**關聯的資料目錄資源**和任務詳細資訊。
**注意**
任務會在建立後 90 天刪除。
1. 選擇**完成**。
## 步驟 5：（選用） 建立修訂
**建立修訂**
1. 從**擁有的資料集**區段中，選擇您要為其新增修訂的資料集。
1. 選擇**修訂**索引標籤。
1. 在**修訂**區段中，選擇**建立修訂**。
1. 在**修訂 Lake Formation 資料許可**頁面上，選擇**新增 LF 標籤**。
1. 檢閱**資料庫**和**資料表****的許可**。
1. 在**服務存取**中，選取現有的服務角色，然後選擇**建立 Lake Formation 資料許可**。
## 步驟 6：發佈包含 AWS Lake Formation 資料集的新產品 （預覽）
建立至少一個資料集並使用資產完成修訂後，您就可以發佈具有 AWS Lake Formation 資料集的產品。如需詳細資訊，請參閱[中的產品最佳實務 AWS Data Exchange](product-details.md)。請確定您擁有產品的所有必要詳細資訊。
**發佈包含 AWS Lake Formation 資料集的新產品 （預覽）**
1. 開啟您的 Web 瀏覽器並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。
1. 從左側導覽窗格的**發佈資料**下，選擇**產品**。
1. 從**產品**中，選擇**發佈新產品**以開啟**發佈新產品**精靈。
1. 在**產品可見**性區段中，選擇您產品**的產品可見性選項**和**敏感資訊**組態，然後選擇**下一步**。如需詳細資訊，請參閱[中的產品可見性 AWS Data Exchange](product-visibility.md)及[中的敏感資訊類別 AWS Data Exchange](sensitive-information.md)。
1. 在**新增資料**區段**的擁有的資料集**下，選取您要新增的資料集旁的核取方塊，然後選擇**新增已選取**。
**注意**
您選擇的資料集必須具有最終修訂。不會新增沒有最終修訂的資料集。
1. 前往**選取的資料集**以檢閱您的選擇。
您可以檢閱資料集**的名稱**、資料集的**類型**，以及資料集**上次更新**時的時間戳記。
1. 前往**選取修訂存取規則**，選擇您要為包含在此產品中的資料集設定的修訂存取規則，然後選擇**下一步**。
如需詳細資訊，請參閱[中的修訂存取規則 AWS Data Exchange](best-practices-revisions.md)。
## 發佈 AWS Lake Formation 資料許可資料集時的考量 （預覽）
為了確保最佳的訂閱者體驗，我們強烈建議您不要對產品包含 AWS Data Exchange 的 Lake Formation 資料集 （預覽版） 的任何許可進行任何下列修改，且該資料集具有該產品的作用中訂閱者。
+ 我們建議您不要在包含 AWS Lake Formation 資料集的已發佈產品 AWS Data Exchange 中刪除或修改傳遞給 的 IAM 角色。如果您刪除或修改這類 IAM 角色，會發生下列問題：
+ AWS 帳戶 有權存取 Lake Formation 資料許可的 可能會無限期保留存取權。
+ AWS 帳戶 訂閱您的產品，但尚未收到 Lake Formation 資料許可的存取權，將無法接收存取權。
AWS Data Exchange 不會對您刪除或修改的任何 IAM 角色負責。
+ 我們建議您不要從包含資料集的已發佈產品 AWS Data Exchange 中傳遞至 的 IAM 角色撤銷授予 AWS Lake Formation 的資料 AWS Lake Formation 許可。如果您撤銷這類 IAM 角色授予的資料許可，會發生下列問題：
+ AWS 帳戶 有權存取 Lake Formation 資料許可的 可能會無限期保留存取權。
+ AWS 帳戶 訂閱您的產品，但尚未收到 Lake Formation 資料許可的存取權，將無法接收存取權。
+ 我們建議您不要將 AWS 帳戶 具有作用中訂閱的 授予 AWS Lake Formation 的資料許可撤銷至包含 AWS Lake Formation 資料集的已發佈產品。如果您撤銷 AWS 帳戶 已訂閱產品的已授予資料許可，這些帳戶將失去存取權，導致客戶體驗不佳。
+ 我們建議您在發佈包含 AWS Lake Formation 資料集的產品時，將 中的跨帳戶版本 AWS Glue Data Catalog 設定為第 3 版。如果您在發佈包含 AWS Lake Formation 資料集的產品時降級 Data Lake Catalog 的跨帳戶版本， AWS 帳戶 訂閱您產品但尚未收到 Lake Formation 資料許可的 可能無法存取資料。