CreateDatasetGroup - Amazon Personalize
請求語法請求參數回應語法回應元素錯誤另請參閱

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

CreateDatasetGroup

建立空的資料集群組。資料集群組是 Amazon Personalize 資源的容器。資料集群組最多可包含三個資料集，每種資料集各一個：

  • 項目互動

  • 項目

  • 使用者

  • 動作

  • 動作互動

資料集群組可以是網域資料集群組，您可以在其中指定網域，並使用預先設定的資源，例如推薦者，或是自訂資料集群組，您可以在其中使用自訂資源，例如解決方案版本的解決方案，以行銷活動部署。如果您從網域資料集群組開始，您仍然可以新增自訂資源，例如使用自訂使用案例配方訓練並搭配行銷活動部署的解決方案和解決方案版本。

資料集群組可以處於下列其中一種狀態：

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

  • 刪除擱置中

若要取得資料集群組的狀態，請呼叫 DescribeDatasetGroup。如果狀態顯示為 CREATE FAILED，回應會包含failureReason金鑰，說明建立失敗的原因。

注意

您必須等到資料集群組status的 成為 ，ACTIVE再將資料集新增至群組。

您可以指定 AWS Key Management Service (KMS) 金鑰來加密 群組中的資料集。如果您指定 KMS 金鑰，您還 AWS Identity and Access Management 必須包含具有存取金鑰許可的 (IAM) 角色。

請求中需要資料集群組 ARN APIs
相關 API

請求語法

{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

請求參數

請求接受採用 JSON 格式的下列資料。

domain

資料集群組的網域。指定要建立網域資料集群組的網域。您指定的網域會決定資料集的預設結構描述，以及可供推薦者的使用案例。如果您未指定網域，則可以使用行銷活動部署的解決方案版本來建立自訂資料集群組。

類型：字串

有效值:ECOMMERCE | VIDEO_ON_DEMAND

必要：否

kmsKeyArn

用來加密資料集的 a(KMS) 金鑰的 Amazon Resource Name AWS Key Management Service (ARN)。

類型：字串

長度限制：長度上限為 2048。

模式：arn:aws.*:kms:.*:[0-9]{12}:key/.*

必要：否

name

新資料集群組的名稱。

類型：字串

長度限制：長度下限為 1。長度上限為 63。

模式：^[a-zA-Z0-9][a-zA-Z0-9\-_]*

必要：是

roleArn

具有存取 AWS Identity and Access Management (KMS) 金鑰許可的 AWS Key Management Service (IAM) 角色 ARN。只有在同時指定 KMS 金鑰時，提供 IAM 角色才有效。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

必要：否

tags

要套用至資料集群組的標籤清單。

類型：Tag 物件陣列

陣列成員：項目數下限為 0。項目數上限為 200。

必要：否

回應語法

{
   "datasetGroupArn": "string",
   "domain": "string"
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

datasetGroupArn

新資料集群組的 Amazon Resource Name (ARN)。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):personalize:.*:.*:.+

domain

新網域資料集群組的網域。

類型：字串

有效值:ECOMMERCE | VIDEO_ON_DEMAND

錯誤

InvalidInputException

提供欄位或參數的有效值。

HTTP 狀態碼：400

LimitExceededException

已超過每秒請求數的限制。

HTTP 狀態碼：400

ResourceAlreadyExistsException

指定的資源已存在。

HTTP 狀態碼：400

TooManyTagsException

您已超過可套用至此資源的標籤數量上限。

HTTP 狀態碼：400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：