AddDataSets - AWS Data Exchange 使用者指南
教學課程：將新資料集新增至已發佈的資料產品 AddDataSets 例外

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

AddDataSets

注意

透過型錄 API 變更集新增的資料集類型AddDataSets預設為產品的發佈方法。

若要將資料集新增至AWS Data Exchange產品，請啟動類型的變更集AddDataSets。為此，您可以使用StartChangeSet API 操作並指定變更類型、產品識別碼、產品類型以及包括資料集 Amazon 資源名稱 (ARN) 在內的詳細資料。

教學課程：將新資料集新增至已發佈的資料產品

本教學課程將逐步引導您完成將新AWS Data Exchange資料集新增至已發佈產品的詳細步驟。本教學課程包含下列高階步驟。

IAM 許可

在開始之前，您需要AWS Identity and Access Management (IAM) 許可才能使用AWS Marketplace目錄 API。這些許可是使用所需之許可之外的許可AWS Data Exchange。

  1. 將瀏覽器導覽至 IAM 主控台，然後使用AWS 帳戶可管理 IAM 許可的登入。

  2. 從左側導覽窗格中選擇政策。

  3. 選擇 Create policy (建立政策)。

  4. 選擇 [JSON] 索引標籤，並提供下列權限。這可提供AWS Marketplace目錄 API 的完整存取權。您可以根據使用案例來限制適用於存取。

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:CancelChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet",
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeChangeSet",
        "dataexchange:PublishDataSet"
      ],
      "Resource": "*"
    }
  ]
}

  5. 選擇 Next:Review (下一步：檢閱)。

  6. 為政策提供名稱 (例如，CatalogAPIFullAccess)，然後選擇 Create policy (建立政策)。

  7. 使用 IAM 主控台，選擇 IAM 主控台所建立的使用者、群組或角色。

存取AWS Marketplace目錄 API

若要存取AWS Marketplace目錄 API，請使用下列 HTTP 用戶端端點。

catalog.marketplace.us-east-1.amazonaws.com

從AWS Data Exchange主控台取得產品 ID

在您可以使用目AWS Marketplace錄 API 發佈新資料集之前，請先從AWS Data Exchange主控台取得產品 ID。導覽至「產品儀表板」，然後複製您要為其發佈資料集的產品 ID。您也可以使用目AWS Marketplace錄 API 來尋找您的產品 ID，並搭配DataProduct@1.0實體類型使用ListEntities動作。

啟動變更請求

啟動變更請求以在測試產品中新增資料集

  1. 依照中的指示複製您取得的實體 ID從AWS Data Exchange主控台取得產品 ID。

  2. 使用AddDataSets變更類型提出StartChangeSet請求。

注意

如需在AWS Marketplace目錄 API 中使用變更集的相關資訊，請參閱使用變更集。如需使用實體之識別元的詳細資訊，請參閱 Iid (識別碼)。

請求示例

https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet

範例請求主體

{
    "Catalog": "AWSMarketplace",
    "ChangeSetName": "Adding Data Set to my test Data Product",
    "ChangeSet": [
        {
            "ChangeType": "AddDataSets",
            "Entity": {
                "Identifier": "entity-id@1",
                "Type": "DataProduct@1.0"
            },
            "Details": "{ \"DataSets\": [ { \"Arn\": \"data-set-arn\" } ] }"
        }
    ]
}

回應範例

{
  "ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}

檢查您變更集的狀態

使用StartChangeSet API 作業啟動變更請求之後，您可以使用此DescribeChangeSet作業來檢查其狀態。提供StartChangeSet API 回應中傳回的變更集 ID。

請求示例

https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh

範例請求主體

{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}

回應範例

{
    "ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
    "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh",
    "ChangeSetName": "Adding Data Set to my test Data Product",
    "StartTime": "2018-09-20T19:45:03.115+0000",
    "EndTime": "2018-09-20T19:48:12.517+0000",
    "Status": "SUCCEEDED",
    "FailureDescription": null,
    "ChangeSet": [
        {
            "ChangeType": "AddDataSets",
            "Entity": {
                "Type": "DataProduct@1.0",
                "Identifier": "entity-id@1"
            },
            "ErrorList": []
        }
    ]
}

AddDataSets 例外

當您搭配使用AWS Marketplace目錄 API 時，可能會發生下列例外狀況AWS Data Exchange：

找不到数据

當找不到要求的資料集時，就會發生這種情況。若要解決此問題，請確定資料集 ARN 中沒有錯字，而且您AWS 帳戶擁有資料集，然後再試一次。

無效輸入

由於輸入無效，因此無法處理請求。若要解決此問題，請確定要求中沒有錯字，且產品未超過允許的資料集數目上限。

已發佈資料

當資料集先前已新增至產品時，就會發生這種情況。

資料集 _ 複製提供

當在請求中多次提供相同的數據集時，就會發生這種情況。