CreateDatasetGroup (smaws-clients.Smaws_Client_Personalize.CreateDatasetGroup)

Module Smaws_Client_Personalize.CreateDatasetGroup

Creates an empty dataset group. A dataset group is a container for Amazon Personalize resources. A dataset group can contain at most three datasets, one for each type of dataset:

Item interactions

Items

Users

Actions

Action interactions

A dataset group can be a Domain dataset group, where you specify a domain and use pre-configured resources like recommenders, or a Custom dataset group, where you use custom resources, such as a solution with a solution version, that you deploy with a campaign. If you start with a Domain dataset group, you can still add custom resources such as solutions and solution versions trained with recipes for custom use cases and deployed with campaigns.

A dataset group can be in one of the following states:

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

DELETE PENDING

To get the status of the dataset group, call DescribeDatasetGroup. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the creation failed.

You must wait until the status of the dataset group is ACTIVE before adding a dataset to the group.

You can specify an Key Management Service (KMS) key to encrypt the datasets in the group. If you specify a KMS key, you must also include an Identity and Access Management (IAM) role that has permission to access the key.

APIs that require a dataset group ARN in the request

Related APIs

val error_to_string : 
  [ Smaws_Lib.Protocols.AwsJson.error
  | `InvalidInputException of Types.invalid_input_exception
  | `LimitExceededException of Types.limit_exceeded_exception
  | `ResourceAlreadyExistsException of Types.resource_already_exists_exception
  | `TooManyTagsException of Types.too_many_tags_exception ] ->
  string

val request : 
  'http_type Smaws_Lib.Context.t ->
  Types.create_dataset_group_request ->
  (Types.create_dataset_group_response,
    [> Smaws_Lib.Protocols.AwsJson.error
    | `InvalidInputException of Types.invalid_input_exception
    | `LimitExceededException of Types.limit_exceeded_exception
    | `ResourceAlreadyExistsException of
      Types.resource_already_exists_exception
    | `TooManyTagsException of Types.too_many_tags_exception ])
    Stdlib.result

val request_with_metadata : 
  'http_type Smaws_Lib.Context.t ->
  Types.create_dataset_group_request ->
  (Types.create_dataset_group_response Smaws_Lib.Response.t,
    [> Smaws_Lib.Protocols.AwsJson.error
    | `InvalidInputException of Types.invalid_input_exception
    | `LimitExceededException of Types.limit_exceeded_exception
    | `ResourceAlreadyExistsException of
      Types.resource_already_exists_exception
    | `TooManyTagsException of Types.too_many_tags_exception ]
    * Smaws_Lib.Response.metadata)
    Stdlib.result