Skip to content

CreateTrainedModelRequest

Source code in docs_src/capo_cleanroomsml/types/create_trained_model_request.py
class CreateTrainedModelRequest(TypedDict, closed=True):
    membership_identifier: "capo_cleanroomsml.types.uuid.UUID"
    """<p>The membership ID of the member that is creating the trained model.</p>"""
    name: "capo_cleanroomsml.types.name_string.NameString"
    """<p>The name of the trained model.</p>"""
    configured_model_algorithm_association_arn: "capo_cleanroomsml.types.configured_model_algorithm_association_arn.ConfiguredModelAlgorithmAssociationArn"
    """<p>The associated configured model algorithm used to train this model.</p>"""
    hyperparameters: NotRequired[
        "capo_cleanroomsml.types.hyper_parameters.HyperParameters"
    ]
    """<p>Algorithm-specific parameters that influence the quality of the model. You set hyperparameters before you start the learning process.</p>"""
    environment: NotRequired["capo_cleanroomsml.types.environment.Environment"]
    """<p>The environment variables to set in the Docker container.</p>"""
    resource_config: "capo_cleanroomsml.types.resource_config.ResourceConfig"
    """<p>Information about the EC2 resources that are used to train this model.</p>"""
    stopping_condition: NotRequired[
        "capo_cleanroomsml.types.stopping_condition.StoppingCondition"
    ]
    """<p>The criteria that is used to stop model training.</p>"""
    incremental_training_data_channels: NotRequired[
        "capo_cleanroomsml.types.incremental_training_data_channels.IncrementalTrainingDataChannels"
    ]
    """<p>Specifies the incremental training data channels for the trained model. </p> <p>Incremental training allows you to create a new trained model with updates without retraining from scratch. You can specify up to one incremental training data channel that references a previously trained model and its version.</p> <p>Limit: Maximum of 20 channels total (including both <code>incrementalTrainingDataChannels</code> and <code>dataChannels</code>).</p>"""
    data_channels: (
        "capo_cleanroomsml.types.model_training_data_channels.ModelTrainingDataChannels"
    )
    """<p>Defines the data channels that are used as input for the trained model request.</p> <p>Limit: Maximum of 20 channels total (including both <code>dataChannels</code> and <code>incrementalTrainingDataChannels</code>).</p>"""
    training_input_mode: "capo_cleanroomsml.types.training_input_mode.TrainingInputMode"
    """<p>The input mode for accessing the training data. This parameter determines how the training data is made available to the training algorithm. Valid values are:</p> <ul> <li> <p> <code>File</code> - The training data is downloaded to the training instance and made available as files.</p> </li> <li> <p> <code>FastFile</code> - The training data is streamed directly from Amazon S3 to the training algorithm, providing faster access for large datasets.</p> </li> <li> <p> <code>Pipe</code> - The training data is streamed to the training algorithm using named pipes, which can improve performance for certain algorithms.</p> </li> </ul>"""
    description: NotRequired[
        "capo_cleanroomsml.types.resource_description.ResourceDescription"
    ]
    """<p>The description of the trained model.</p>"""
    kms_key_arn: NotRequired["capo_cleanroomsml.types.kms_key_arn.KmsKeyArn"]
    """<p>The Amazon Resource Name (ARN) of the KMS key. This key is used to encrypt and decrypt customer-owned data in the trained ML model and the associated data.</p>"""
    tags: NotRequired["capo_cleanroomsml.types.tag_map.TagMap"]
    """<p>The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.</p> <p>The following basic restrictions apply to tags:</p> <ul> <li> <p>Maximum number of tags per resource - 50.</p> </li> <li> <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p> </li> <li> <p>Maximum key length - 128 Unicode characters in UTF-8.</p> </li> <li> <p>Maximum value length - 256 Unicode characters in UTF-8.</p> </li> <li> <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p> </li> <li> <p>Tag keys and values are case sensitive.</p> </li> <li> <p>Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.</p> </li> </ul>"""
    ml_model_training_payer_account_id: NotRequired[
        "capo_cleanroomsml.types.account_id.AccountId"
    ]
    """<p>The account ID of the member that is responsible for paying for model training costs.</p>"""

configured_model_algorithm_association_arn instance-attribute

configured_model_algorithm_association_arn: ConfiguredModelAlgorithmAssociationArn

The associated configured model algorithm used to train this model.

data_channels instance-attribute

Defines the data channels that are used as input for the trained model request.

Limit: Maximum of 20 channels total (including both dataChannels and incrementalTrainingDataChannels).

description instance-attribute

description: NotRequired[ResourceDescription]

The description of the trained model.

environment instance-attribute

environment: NotRequired[Environment]

The environment variables to set in the Docker container.

hyperparameters instance-attribute

hyperparameters: NotRequired[HyperParameters]

Algorithm-specific parameters that influence the quality of the model. You set hyperparameters before you start the learning process.

incremental_training_data_channels instance-attribute

incremental_training_data_channels: NotRequired[IncrementalTrainingDataChannels]

Specifies the incremental training data channels for the trained model.

Incremental training allows you to create a new trained model with updates without retraining from scratch. You can specify up to one incremental training data channel that references a previously trained model and its version.

Limit: Maximum of 20 channels total (including both incrementalTrainingDataChannels and dataChannels).

kms_key_arn instance-attribute

kms_key_arn: NotRequired[KmsKeyArn]

The Amazon Resource Name (ARN) of the KMS key. This key is used to encrypt and decrypt customer-owned data in the trained ML model and the associated data.

membership_identifier instance-attribute

membership_identifier: UUID

The membership ID of the member that is creating the trained model.

ml_model_training_payer_account_id instance-attribute

ml_model_training_payer_account_id: NotRequired[AccountId]

The account ID of the member that is responsible for paying for model training costs.

name instance-attribute

name: NameString

The name of the trained model.

resource_config instance-attribute

resource_config: ResourceConfig

Information about the EC2 resources that are used to train this model.

stopping_condition instance-attribute

stopping_condition: NotRequired[StoppingCondition]

The criteria that is used to stop model training.

tags instance-attribute

tags: NotRequired[TagMap]

The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50.

  • For each resource, each tag key must be unique, and each tag key can have only one value.

  • Maximum key length - 128 Unicode characters in UTF-8.

  • Maximum value length - 256 Unicode characters in UTF-8.

  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

  • Tag keys and values are case sensitive.

  • Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.

training_input_mode instance-attribute

training_input_mode: TrainingInputMode

The input mode for accessing the training data. This parameter determines how the training data is made available to the training algorithm. Valid values are:

  • File - The training data is downloaded to the training instance and made available as files.

  • FastFile - The training data is streamed directly from Amazon S3 to the training algorithm, providing faster access for large datasets.

  • Pipe - The training data is streamed to the training algorithm using named pipes, which can improve performance for certain algorithms.