View Source AWS.CleanRoomsML (aws-elixir v1.0.4)

Welcome to the Amazon Web Services Clean Rooms ML API Reference.

Amazon Web Services Clean Rooms ML provides a privacy-enhancing method for two parties to identify similar users in their data without the need to share their data with each other. The first party brings the training data to Clean Rooms so that they can create and configure an audience model (lookalike model) and associate it with a collaboration. The second party then brings their seed data to Clean Rooms and generates an audience (lookalike segment) that resembles the training data.

To learn more about Amazon Web Services Clean Rooms ML concepts, procedures, and best practices, see the Clean Rooms User Guide.

To learn more about SQL commands, functions, and conditions supported in Clean Rooms, see the Clean Rooms SQL Reference.

Link to this section Summary

Functions

Defines the information necessary to create an audience model.

Defines the information necessary to create a configured audience model.

Creates a configured model algorithm using a container image stored in an ECR repository.

Associates a configured model algorithm to a collaboration for use by any member of the collaboration.

Provides the information to create an ML input channel.

Creates a trained model from an associated configured model algorithm using data from any member of the collaboration.

Defines the information necessary to create a training dataset.

Deletes the specified audience generation job, and removes all data associated with the job.

Specifies an audience model that you want to delete.

Specifies a training dataset that you want to delete.

Returns information about an audience generation job.

Returns information about an audience model

Returns information about a specific ML input channel in a collaboration.

Returns information about a specified configured audience model.

Returns information about a configured audience model policy.

Returns information about a configured model algorithm.

Returns information about a specific ML configuration.

Returns information about a training dataset.

Returns a list of tags for a provided resource.

Create or update the resource policy for a configured audience model.

Assigns information about an ML configuration.

Export an audience of a specified size after you have generated an audience.

Information necessary to start the audience generation job.

Provides the information necessary to start a trained model export job.

Defines the information necessary to begin a trained model inference job.

Adds metadata tags to a specified resource.

Removes metadata tags from a specified resource.

Provides the information necessary to update a configured audience model.

Link to this section Functions

Link to this function

cancel_trained_model(client, membership_identifier, trained_model_arn, input, options \\ [])

View Source

Submits a request to cancel the trained model job.

Link to this function

cancel_trained_model_inference_job(client, membership_identifier, trained_model_inference_job_arn, input, options \\ [])

View Source

Submits a request to cancel a trained model inference job.

Link to this function

create_audience_model(client, input, options \\ [])

View Source

Defines the information necessary to create an audience model.

An audience model is a machine learning model that Clean Rooms ML trains to measure similarity between users. Clean Rooms ML manages training and storing the audience model. The audience model can be used in multiple calls to the StartAudienceGenerationJob API.

Link to this function

create_configured_audience_model(client, input, options \\ [])

View Source

Defines the information necessary to create a configured audience model.

Link to this function

create_configured_model_algorithm(client, input, options \\ [])

View Source

Creates a configured model algorithm using a container image stored in an ECR repository.

Link to this function

create_configured_model_algorithm_association(client, membership_identifier, input, options \\ [])

View Source

Associates a configured model algorithm to a collaboration for use by any member of the collaboration.

Link to this function

create_ml_input_channel(client, membership_identifier, input, options \\ [])

View Source

Provides the information to create an ML input channel.

An ML input channel is the result of a query that can be used for ML modeling.

Link to this function

create_trained_model(client, membership_identifier, input, options \\ [])

View Source

Creates a trained model from an associated configured model algorithm using data from any member of the collaboration.

Link to this function

create_training_dataset(client, input, options \\ [])

View Source

Defines the information necessary to create a training dataset.

In Clean Rooms ML, the TrainingDataset is metadata that points to a Glue table, which is read only during AudienceModel creation.

Link to this function

delete_audience_generation_job(client, audience_generation_job_arn, input, options \\ [])

View Source

Deletes the specified audience generation job, and removes all data associated with the job.

Link to this function

delete_audience_model(client, audience_model_arn, input, options \\ [])

View Source

Specifies an audience model that you want to delete.

You can't delete an audience model if there are any configured audience models that depend on the audience model.

Link to this function

delete_configured_audience_model(client, configured_audience_model_arn, input, options \\ [])

View Source

Deletes the specified configured audience model.

You can't delete a configured audience model if there are any lookalike models that use the configured audience model. If you delete a configured audience model, it will be removed from any collaborations that it is associated to.

Link to this function

delete_configured_audience_model_policy(client, configured_audience_model_arn, input, options \\ [])

View Source

Deletes the specified configured audience model policy.

Link to this function

delete_configured_model_algorithm(client, configured_model_algorithm_arn, input, options \\ [])

View Source

Deletes a configured model algorithm.

Link to this function

delete_configured_model_algorithm_association(client, configured_model_algorithm_association_arn, membership_identifier, input, options \\ [])

View Source

Deletes a configured model algorithm association.

Link to this function

delete_ml_configuration(client, membership_identifier, input, options \\ [])

View Source

Deletes a ML modeling configuration.

Link to this function

delete_ml_input_channel_data(client, membership_identifier, ml_input_channel_arn, input, options \\ [])

View Source

Provides the information necessary to delete an ML input channel.

Link to this function

delete_trained_model_output(client, membership_identifier, trained_model_arn, input, options \\ [])

View Source

Deletes the output of a trained model.

Link to this function

delete_training_dataset(client, training_dataset_arn, input, options \\ [])

View Source

Specifies a training dataset that you want to delete.

You can't delete a training dataset if there are any audience models that depend on the training dataset. In Clean Rooms ML, the TrainingDataset is metadata that points to a Glue table, which is read only during AudienceModel creation. This action deletes the metadata.

Link to this function

get_audience_generation_job(client, audience_generation_job_arn, options \\ [])

View Source

Returns information about an audience generation job.

Link to this function

get_audience_model(client, audience_model_arn, options \\ [])

View Source

Returns information about an audience model

Link to this function

get_collaboration_configured_model_algorithm_association(client, collaboration_identifier, configured_model_algorithm_association_arn, options \\ [])

View Source

Returns information about the configured model algorithm association in a collaboration.

Link to this function

get_collaboration_ml_input_channel(client, collaboration_identifier, ml_input_channel_arn, options \\ [])

View Source

Returns information about a specific ML input channel in a collaboration.

Link to this function

get_collaboration_trained_model(client, collaboration_identifier, trained_model_arn, options \\ [])

View Source

Returns information about a trained model in a collaboration.

Link to this function

get_configured_audience_model(client, configured_audience_model_arn, options \\ [])

View Source

Returns information about a specified configured audience model.

Link to this function

get_configured_audience_model_policy(client, configured_audience_model_arn, options \\ [])

View Source

Returns information about a configured audience model policy.

Link to this function

get_configured_model_algorithm(client, configured_model_algorithm_arn, options \\ [])

View Source

Returns information about a configured model algorithm.

Link to this function

get_configured_model_algorithm_association(client, configured_model_algorithm_association_arn, membership_identifier, options \\ [])

View Source

Returns information about a configured model algorithm association.

Link to this function

get_ml_configuration(client, membership_identifier, options \\ [])

View Source

Returns information about a specific ML configuration.

Link to this function

get_ml_input_channel(client, membership_identifier, ml_input_channel_arn, options \\ [])

View Source

Returns information about an ML input channel.

Link to this function

get_trained_model(client, membership_identifier, trained_model_arn, options \\ [])

View Source

Returns information about a trained model.

Link to this function

get_trained_model_inference_job(client, membership_identifier, trained_model_inference_job_arn, options \\ [])

View Source

Returns information about a trained model inference job.

Link to this function

get_training_dataset(client, training_dataset_arn, options \\ [])

View Source

Returns information about a training dataset.

Link to this function

list_audience_export_jobs(client, audience_generation_job_arn \\ nil, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the audience export jobs.

Link to this function

list_audience_generation_jobs(client, collaboration_id \\ nil, configured_audience_model_arn \\ nil, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of audience generation jobs.

Link to this function

list_audience_models(client, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of audience models.

Link to this function

list_collaboration_configured_model_algorithm_associations(client, collaboration_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the configured model algorithm associations in a collaboration.

Link to this function

list_collaboration_ml_input_channels(client, collaboration_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the ML input channels in a collaboration.

Link to this function

list_collaboration_trained_model_export_jobs(client, collaboration_identifier, trained_model_arn, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the export jobs for a trained model in a collaboration.

Link to this function

list_collaboration_trained_model_inference_jobs(client, collaboration_identifier, max_results \\ nil, next_token \\ nil, trained_model_arn \\ nil, options \\ [])

View Source

Returns a list of trained model inference jobs in a specified collaboration.

Link to this function

list_collaboration_trained_models(client, collaboration_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the trained models in a collaboration.

Link to this function

list_configured_audience_models(client, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of the configured audience models.

Link to this function

list_configured_model_algorithm_associations(client, membership_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of configured model algorithm associations.

Link to this function

list_configured_model_algorithms(client, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of configured model algorithms.

Link to this function

list_ml_input_channels(client, membership_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of ML input channels.

Link to this function

list_tags_for_resource(client, resource_arn, options \\ [])

View Source

Returns a list of tags for a provided resource.

Link to this function

list_trained_model_inference_jobs(client, membership_identifier, max_results \\ nil, next_token \\ nil, trained_model_arn \\ nil, options \\ [])

View Source

Returns a list of trained model inference jobs that match the request parameters.

Link to this function

list_trained_models(client, membership_identifier, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of trained models.

Link to this function

list_training_datasets(client, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a list of training datasets.

Link to this function

put_configured_audience_model_policy(client, configured_audience_model_arn, input, options \\ [])

View Source

Create or update the resource policy for a configured audience model.

Link to this function

put_ml_configuration(client, membership_identifier, input, options \\ [])

View Source

Assigns information about an ML configuration.

Link to this function

start_audience_export_job(client, input, options \\ [])

View Source

Export an audience of a specified size after you have generated an audience.

Link to this function

start_audience_generation_job(client, input, options \\ [])

View Source

Information necessary to start the audience generation job.

Link to this function

start_trained_model_export_job(client, membership_identifier, trained_model_arn, input, options \\ [])

View Source

Provides the information necessary to start a trained model export job.

Link to this function

start_trained_model_inference_job(client, membership_identifier, input, options \\ [])

View Source

Defines the information necessary to begin a trained model inference job.

Link to this function

tag_resource(client, resource_arn, input, options \\ [])

View Source

Adds metadata tags to a specified resource.

Link to this function

untag_resource(client, resource_arn, input, options \\ [])

View Source

Removes metadata tags from a specified resource.

Link to this function

update_configured_audience_model(client, configured_audience_model_arn, input, options \\ [])

View Source

Provides the information necessary to update a configured audience model.

Updates that impact audience generation jobs take effect when a new job starts, but do not impact currently running jobs.