SDK for PHP 3.x

Client: Aws\CleanRoomsML\CleanRoomsMLClient
Service ID: cleanroomsml
Version: 2023-09-06

This page describes the parameters and results for the operations of the AWS Clean Rooms ML (2023-09-06), and shows how to use the Aws\CleanRoomsML\CleanRoomsMLClient object to call the described operations. This documentation is specific to the 2023-09-06 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

CancelTrainedModel ( array $params = [] )
Submits a request to cancel the trained model job.
CancelTrainedModelInferenceJob ( array $params = [] )
Submits a request to cancel a trained model inference job.
CreateAudienceModel ( array $params = [] )
Defines the information necessary to create an audience model.
CreateConfiguredAudienceModel ( array $params = [] )
Defines the information necessary to create a configured audience model.
CreateConfiguredModelAlgorithm ( array $params = [] )
Creates a configured model algorithm using a container image stored in an ECR repository.
CreateConfiguredModelAlgorithmAssociation ( array $params = [] )
Associates a configured model algorithm to a collaboration for use by any member of the collaboration.
CreateMLInputChannel ( array $params = [] )
Provides the information to create an ML input channel.
CreateTrainedModel ( array $params = [] )
Creates a trained model from an associated configured model algorithm using data from any member of the collaboration.
CreateTrainingDataset ( array $params = [] )
Defines the information necessary to create a training dataset.
DeleteAudienceGenerationJob ( array $params = [] )
Deletes the specified audience generation job, and removes all data associated with the job.
DeleteAudienceModel ( array $params = [] )
Specifies an audience model that you want to delete.
DeleteConfiguredAudienceModel ( array $params = [] )
Deletes the specified configured audience model.
DeleteConfiguredAudienceModelPolicy ( array $params = [] )
Deletes the specified configured audience model policy.
DeleteConfiguredModelAlgorithm ( array $params = [] )
Deletes a configured model algorithm.
DeleteConfiguredModelAlgorithmAssociation ( array $params = [] )
Deletes a configured model algorithm association.
DeleteMLConfiguration ( array $params = [] )
Deletes a ML modeling configuration.
DeleteMLInputChannelData ( array $params = [] )
Provides the information necessary to delete an ML input channel.
DeleteTrainedModelOutput ( array $params = [] )
Deletes the output of a trained model.
DeleteTrainingDataset ( array $params = [] )
Specifies a training dataset that you want to delete.
GetAudienceGenerationJob ( array $params = [] )
Returns information about an audience generation job.
GetAudienceModel ( array $params = [] )
Returns information about an audience model
GetCollaborationConfiguredModelAlgorithmAssociation ( array $params = [] )
Returns information about the configured model algorithm association in a collaboration.
GetCollaborationMLInputChannel ( array $params = [] )
Returns information about a specific ML input channel in a collaboration.
GetCollaborationTrainedModel ( array $params = [] )
Returns information about a trained model in a collaboration.
GetConfiguredAudienceModel ( array $params = [] )
Returns information about a specified configured audience model.
GetConfiguredAudienceModelPolicy ( array $params = [] )
Returns information about a configured audience model policy.
GetConfiguredModelAlgorithm ( array $params = [] )
Returns information about a configured model algorithm.
GetConfiguredModelAlgorithmAssociation ( array $params = [] )
Returns information about a configured model algorithm association.
GetMLConfiguration ( array $params = [] )
Returns information about a specific ML configuration.
GetMLInputChannel ( array $params = [] )
Returns information about an ML input channel.
GetTrainedModel ( array $params = [] )
Returns information about a trained model.
GetTrainedModelInferenceJob ( array $params = [] )
Returns information about a trained model inference job.
GetTrainingDataset ( array $params = [] )
Returns information about a training dataset.
ListAudienceExportJobs ( array $params = [] )
Returns a list of the audience export jobs.
ListAudienceGenerationJobs ( array $params = [] )
Returns a list of audience generation jobs.
ListAudienceModels ( array $params = [] )
Returns a list of audience models.
ListCollaborationConfiguredModelAlgorithmAssociations ( array $params = [] )
Returns a list of the configured model algorithm associations in a collaboration.
ListCollaborationMLInputChannels ( array $params = [] )
Returns a list of the ML input channels in a collaboration.
ListCollaborationTrainedModelExportJobs ( array $params = [] )
Returns a list of the export jobs for a trained model in a collaboration.
ListCollaborationTrainedModelInferenceJobs ( array $params = [] )
Returns a list of trained model inference jobs in a specified collaboration.
ListCollaborationTrainedModels ( array $params = [] )
Returns a list of the trained models in a collaboration.
ListConfiguredAudienceModels ( array $params = [] )
Returns a list of the configured audience models.
ListConfiguredModelAlgorithmAssociations ( array $params = [] )
Returns a list of configured model algorithm associations.
ListConfiguredModelAlgorithms ( array $params = [] )
Returns a list of configured model algorithms.
ListMLInputChannels ( array $params = [] )
Returns a list of ML input channels.
ListTagsForResource ( array $params = [] )
Returns a list of tags for a provided resource.
ListTrainedModelInferenceJobs ( array $params = [] )
Returns a list of trained model inference jobs that match the request parameters.
ListTrainedModels ( array $params = [] )
Returns a list of trained models.
ListTrainingDatasets ( array $params = [] )
Returns a list of training datasets.
PutConfiguredAudienceModelPolicy ( array $params = [] )
Create or update the resource policy for a configured audience model.
PutMLConfiguration ( array $params = [] )
Assigns information about an ML configuration.
StartAudienceExportJob ( array $params = [] )
Export an audience of a specified size after you have generated an audience.
StartAudienceGenerationJob ( array $params = [] )
Information necessary to start the audience generation job.
StartTrainedModelExportJob ( array $params = [] )
Provides the information necessary to start a trained model export job.
StartTrainedModelInferenceJob ( array $params = [] )
Defines the information necessary to begin a trained model inference job.
TagResource ( array $params = [] )
Adds metadata tags to a specified resource.
UntagResource ( array $params = [] )
Removes metadata tags from a specified resource.
UpdateConfiguredAudienceModel ( array $params = [] )
Provides the information necessary to update a configured audience model.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListAudienceExportJobs
ListAudienceGenerationJobs
ListAudienceModels
ListCollaborationConfiguredModelAlgorithmAssociations
ListCollaborationMLInputChannels
ListCollaborationTrainedModelExportJobs
ListCollaborationTrainedModelInferenceJobs
ListCollaborationTrainedModels
ListConfiguredAudienceModels
ListConfiguredModelAlgorithmAssociations
ListConfiguredModelAlgorithms
ListMLInputChannels
ListTrainedModelInferenceJobs
ListTrainedModels
ListTrainingDatasets

Operations

CancelTrainedModel

$result = $client->cancelTrainedModel([/* ... */]);
$promise = $client->cancelTrainedModelAsync([/* ... */]);

Submits a request to cancel the trained model job.

Parameter Syntax

$result = $client->cancelTrainedModel([
    'membershipIdentifier' => '<string>', // REQUIRED
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the trained model job that you want to cancel.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model job that you want to cancel.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

CancelTrainedModelInferenceJob

$result = $client->cancelTrainedModelInferenceJob([/* ... */]);
$promise = $client->cancelTrainedModelInferenceJobAsync([/* ... */]);

Submits a request to cancel a trained model inference job.

Parameter Syntax

$result = $client->cancelTrainedModelInferenceJob([
    'membershipIdentifier' => '<string>', // REQUIRED
    'trainedModelInferenceJobArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the trained model inference job that you want to cancel.

trainedModelInferenceJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model inference job that you want to cancel.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

CreateAudienceModel

$result = $client->createAudienceModel([/* ... */]);
$promise = $client->createAudienceModelAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->createAudienceModel([
    'description' => '<string>',
    'kmsKeyArn' => '<string>',
    'name' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
    'trainingDataEndTime' => <integer || string || DateTime>,
    'trainingDataStartTime' => <integer || string || DateTime>,
    'trainingDatasetArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
description
Type: string

The description of the audience model.

kmsKeyArn
Type: string

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.

name
Required: Yes
Type: string

The name of the audience model resource.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

trainingDataEndTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end date and time of the training window.

trainingDataStartTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The start date and time of the training window.

trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset for this audience model.

Result Syntax

[
    'audienceModelArn' => '<string>',
]

Result Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateConfiguredAudienceModel

$result = $client->createConfiguredAudienceModel([/* ... */]);
$promise = $client->createConfiguredAudienceModelAsync([/* ... */]);

Defines the information necessary to create a configured audience model.

Parameter Syntax

$result = $client->createConfiguredAudienceModel([
    'audienceModelArn' => '<string>', // REQUIRED
    'audienceSizeConfig' => [
        'audienceSizeBins' => [<integer>, ...], // REQUIRED
        'audienceSizeType' => 'ABSOLUTE|PERCENTAGE', // REQUIRED
    ],
    'childResourceTagOnCreatePolicy' => 'FROM_PARENT_RESOURCE|NONE',
    'description' => '<string>',
    'minMatchingSeedSize' => <integer>,
    'name' => '<string>', // REQUIRED
    'outputConfig' => [ // REQUIRED
        'destination' => [ // REQUIRED
            's3Destination' => [ // REQUIRED
                's3Uri' => '<string>', // REQUIRED
            ],
        ],
        'roleArn' => '<string>', // REQUIRED
    ],
    'sharedAudienceMetrics' => ['<string>', ...], // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model to use for the configured audience model.

audienceSizeConfig
Type: AudienceSizeConfig structure

Configure the list of output sizes of audiences that can be created using this configured audience model. A request to StartAudienceGenerationJob that uses this configured audience model must have an audienceSize selected from this list. You can use the ABSOLUTE AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use the Percentage AudienceSize to configure sizes in the range 1-100 percent.

childResourceTagOnCreatePolicy
Type: string

Configure how the service tags audience generation jobs created using this configured audience model. If you specify NONE, the tags from the StartAudienceGenerationJob request determine the tags of the audience generation job. If you specify FROM_PARENT_RESOURCE, the audience generation job inherits the tags from the configured audience model, by default. Tags in the StartAudienceGenerationJob will override the default.

When the client is in a different account than the configured audience model, the tags from the client are never applied to a resource in the caller's account.

description
Type: string

The description of the configured audience model.

minMatchingSeedSize
Type: int

The minimum number of users from the seed audience that must match with users in the training data of the audience model. The default value is 500.

name
Required: Yes
Type: string

The name of the configured audience model.

outputConfig
Required: Yes
Type: ConfiguredAudienceModelOutputConfig structure

Configure the Amazon S3 location and IAM Role for audiences created using this configured audience model. Each audience will have a unique location. The IAM Role must have s3:PutObject permission on the destination Amazon S3 location. If the destination is protected with Amazon S3 KMS-SSE, then the Role must also have the required KMS permissions.

sharedAudienceMetrics
Required: Yes
Type: Array of strings

Whether audience metrics are shared.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

Result Syntax

[
    'configuredAudienceModelArn' => '<string>',
]

Result Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateConfiguredModelAlgorithm

$result = $client->createConfiguredModelAlgorithm([/* ... */]);
$promise = $client->createConfiguredModelAlgorithmAsync([/* ... */]);

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

Parameter Syntax

$result = $client->createConfiguredModelAlgorithm([
    'description' => '<string>',
    'inferenceContainerConfig' => [
        'imageUri' => '<string>', // REQUIRED
    ],
    'kmsKeyArn' => '<string>',
    'name' => '<string>', // REQUIRED
    'roleArn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
    'trainingContainerConfig' => [
        'arguments' => ['<string>', ...],
        'entrypoint' => ['<string>', ...],
        'imageUri' => '<string>', // REQUIRED
        'metricDefinitions' => [
            [
                'name' => '<string>', // REQUIRED
                'regex' => '<string>', // REQUIRED
            ],
            // ...
        ],
    ],
]);

Parameter Details

Members
description
Type: string

The description of the configured model algorithm.

inferenceContainerConfig
Type: InferenceContainerConfig structure

Configuration information for the inference container that is used when you run an inference job on a configured model algorithm.

kmsKeyArn
Type: string

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

name
Required: Yes
Type: string

The name of the configured model algorithm.

roleArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the role that is used to access the repository.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

trainingContainerConfig
Type: ContainerConfig structure

Configuration information for the training container, including entrypoints and arguments.

Result Syntax

[
    'configuredModelAlgorithmArn' => '<string>',
]

Result Details

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateConfiguredModelAlgorithmAssociation

$result = $client->createConfiguredModelAlgorithmAssociation([/* ... */]);
$promise = $client->createConfiguredModelAlgorithmAssociationAsync([/* ... */]);

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

Parameter Syntax

$result = $client->createConfiguredModelAlgorithmAssociation([
    'configuredModelAlgorithmArn' => '<string>', // REQUIRED
    'description' => '<string>',
    'membershipIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'privacyConfiguration' => [
        'policies' => [ // REQUIRED
            'trainedModelExports' => [
                'filesToExport' => ['<string>', ...], // REQUIRED
                'maxSize' => [ // REQUIRED
                    'unit' => 'GB', // REQUIRED
                    'value' => <float>, // REQUIRED
                ],
            ],
            'trainedModelInferenceJobs' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...], // REQUIRED
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'maxOutputSize' => [
                    'unit' => 'GB', // REQUIRED
                    'value' => <float>, // REQUIRED
                ],
            ],
            'trainedModels' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...], // REQUIRED
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'containerMetrics' => [
                    'noiseLevel' => 'HIGH|MEDIUM|LOW|NONE', // REQUIRED
                ],
            ],
        ],
    ],
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that you want to associate.

description
Type: string

The description of the configured model algorithm association.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member who is associating this configured model algorithm.

name
Required: Yes
Type: string

The name of the configured model algorithm association.

privacyConfiguration
Type: PrivacyConfiguration structure

Specifies the privacy configuration information for the configured model algorithm association. This information includes the maximum data size that can be exported.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

Result Syntax

[
    'configuredModelAlgorithmAssociationArn' => '<string>',
]

Result Details

Members
configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateMLInputChannel

$result = $client->createMLInputChannel([/* ... */]);
$promise = $client->createMLInputChannelAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->createMLInputChannel([
    'configuredModelAlgorithmAssociations' => ['<string>', ...], // REQUIRED
    'description' => '<string>',
    'inputChannel' => [ // REQUIRED
        'dataSource' => [ // REQUIRED
            'protectedQueryInputParameters' => [
                'computeConfiguration' => [
                    'worker' => [
                        'number' => <integer>,
                        'type' => 'CR.1X|CR.4X',
                    ],
                ],
                'sqlParameters' => [ // REQUIRED
                    'analysisTemplateArn' => '<string>',
                    'parameters' => ['<string>', ...],
                    'queryString' => '<string>',
                ],
            ],
        ],
        'roleArn' => '<string>', // REQUIRED
    ],
    'kmsKeyArn' => '<string>',
    'membershipIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'retentionInDays' => <integer>, // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
configuredModelAlgorithmAssociations
Required: Yes
Type: Array of strings

The associated configured model algorithms that are necessary to create this ML input channel.

description
Type: string

The description of the ML input channel.

inputChannel
Required: Yes
Type: InputChannel structure

The input data that is used to create this ML input channel.

kmsKeyArn
Type: string

The Amazon Resource Name (ARN) of the KMS key that is used to access the input channel.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that is creating the ML input channel.

name
Required: Yes
Type: string

The name of the ML input channel.

retentionInDays
Required: Yes
Type: int

The number of days that the data in the ML input channel is retained.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

Result Syntax

[
    'mlInputChannelArn' => '<string>',
]

Result Details

Members
mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateTrainedModel

$result = $client->createTrainedModel([/* ... */]);
$promise = $client->createTrainedModelAsync([/* ... */]);

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

Parameter Syntax

$result = $client->createTrainedModel([
    'configuredModelAlgorithmAssociationArn' => '<string>', // REQUIRED
    'dataChannels' => [ // REQUIRED
        [
            'channelName' => '<string>', // REQUIRED
            'mlInputChannelArn' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'description' => '<string>',
    'environment' => ['<string>', ...],
    'hyperparameters' => ['<string>', ...],
    'kmsKeyArn' => '<string>',
    'membershipIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'resourceConfig' => [ // REQUIRED
        'instanceCount' => <integer>,
        'instanceType' => 'ml.m4.xlarge|ml.m4.2xlarge|ml.m4.4xlarge|ml.m4.10xlarge|ml.m4.16xlarge|ml.g4dn.xlarge|ml.g4dn.2xlarge|ml.g4dn.4xlarge|ml.g4dn.8xlarge|ml.g4dn.12xlarge|ml.g4dn.16xlarge|ml.m5.large|ml.m5.xlarge|ml.m5.2xlarge|ml.m5.4xlarge|ml.m5.12xlarge|ml.m5.24xlarge|ml.c4.xlarge|ml.c4.2xlarge|ml.c4.4xlarge|ml.c4.8xlarge|ml.p2.xlarge|ml.p2.8xlarge|ml.p2.16xlarge|ml.p3.2xlarge|ml.p3.8xlarge|ml.p3.16xlarge|ml.p3dn.24xlarge|ml.p4d.24xlarge|ml.p4de.24xlarge|ml.p5.48xlarge|ml.c5.xlarge|ml.c5.2xlarge|ml.c5.4xlarge|ml.c5.9xlarge|ml.c5.18xlarge|ml.c5n.xlarge|ml.c5n.2xlarge|ml.c5n.4xlarge|ml.c5n.9xlarge|ml.c5n.18xlarge|ml.g5.xlarge|ml.g5.2xlarge|ml.g5.4xlarge|ml.g5.8xlarge|ml.g5.16xlarge|ml.g5.12xlarge|ml.g5.24xlarge|ml.g5.48xlarge|ml.trn1.2xlarge|ml.trn1.32xlarge|ml.trn1n.32xlarge|ml.m6i.large|ml.m6i.xlarge|ml.m6i.2xlarge|ml.m6i.4xlarge|ml.m6i.8xlarge|ml.m6i.12xlarge|ml.m6i.16xlarge|ml.m6i.24xlarge|ml.m6i.32xlarge|ml.c6i.xlarge|ml.c6i.2xlarge|ml.c6i.8xlarge|ml.c6i.4xlarge|ml.c6i.12xlarge|ml.c6i.16xlarge|ml.c6i.24xlarge|ml.c6i.32xlarge|ml.r5d.large|ml.r5d.xlarge|ml.r5d.2xlarge|ml.r5d.4xlarge|ml.r5d.8xlarge|ml.r5d.12xlarge|ml.r5d.16xlarge|ml.r5d.24xlarge|ml.t3.medium|ml.t3.large|ml.t3.xlarge|ml.t3.2xlarge|ml.r5.large|ml.r5.xlarge|ml.r5.2xlarge|ml.r5.4xlarge|ml.r5.8xlarge|ml.r5.12xlarge|ml.r5.16xlarge|ml.r5.24xlarge', // REQUIRED
        'volumeSizeInGB' => <integer>, // REQUIRED
    ],
    'stoppingCondition' => [
        'maxRuntimeInSeconds' => <integer>,
    ],
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The associated configured model algorithm used to train this model.

dataChannels
Required: Yes
Type: Array of ModelTrainingDataChannel structures

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

description
Type: string

The description of the trained model.

environment
Type: Associative array of custom strings keys (EnvironmentKeyString) to strings

The environment variables to set in the Docker container.

hyperparameters
Type: Associative array of custom strings keys (HyperParametersKeyString) to strings

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

kmsKeyArn
Type: string

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.

membershipIdentifier
Required: Yes
Type: string

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

name
Required: Yes
Type: string

The name of the trained model.

resourceConfig
Required: Yes
Type: ResourceConfig structure

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

stoppingCondition
Type: StoppingCondition structure

The criteria that is used to stop model training.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

Result Syntax

[
    'trainedModelArn' => '<string>',
]

Result Details

Members
trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

CreateTrainingDataset

$result = $client->createTrainingDataset([/* ... */]);
$promise = $client->createTrainingDatasetAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->createTrainingDataset([
    'description' => '<string>',
    'name' => '<string>', // REQUIRED
    'roleArn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
    'trainingData' => [ // REQUIRED
        [
            'inputConfig' => [ // REQUIRED
                'dataSource' => [ // REQUIRED
                    'glueDataSource' => [ // REQUIRED
                        'catalogId' => '<string>',
                        'databaseName' => '<string>', // REQUIRED
                        'tableName' => '<string>', // REQUIRED
                    ],
                ],
                'schema' => [ // REQUIRED
                    [
                        'columnName' => '<string>', // REQUIRED
                        'columnTypes' => ['<string>', ...], // REQUIRED
                    ],
                    // ...
                ],
            ],
            'type' => 'INTERACTIONS', // REQUIRED
        ],
        // ...
    ],
]);

Parameter Details

Members
description
Type: string

The description of the training dataset.

name
Required: Yes
Type: string

The name of the training dataset. This name must be unique in your account and region.

roleArn
Required: Yes
Type: string

The ARN of the IAM role that Clean Rooms ML can assume to read the data referred to in the dataSource field of each dataset.

Passing a role across AWS accounts is not allowed. If you pass a role that isn't in your account, you get an AccessDeniedException error.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

trainingData
Required: Yes
Type: Array of Dataset structures

An array of information that lists the Dataset objects, which specifies the dataset type and details on its location and schema. You must provide a role that has read access to these tables.

Result Syntax

[
    'trainingDatasetArn' => '<string>',
]

Result Details

Members
trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset resource.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

DeleteAudienceGenerationJob

$result = $client->deleteAudienceGenerationJob([/* ... */]);
$promise = $client->deleteAudienceGenerationJobAsync([/* ... */]);

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

Parameter Syntax

$result = $client->deleteAudienceGenerationJob([
    'audienceGenerationJobArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteAudienceModel

$result = $client->deleteAudienceModel([/* ... */]);
$promise = $client->deleteAudienceModelAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->deleteAudienceModel([
    'audienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteConfiguredAudienceModel

$result = $client->deleteConfiguredAudienceModel([/* ... */]);
$promise = $client->deleteConfiguredAudienceModelAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->deleteConfiguredAudienceModel([
    'configuredAudienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteConfiguredAudienceModelPolicy

$result = $client->deleteConfiguredAudienceModelPolicy([/* ... */]);
$promise = $client->deleteConfiguredAudienceModelPolicyAsync([/* ... */]);

Deletes the specified configured audience model policy.

Parameter Syntax

$result = $client->deleteConfiguredAudienceModelPolicy([
    'configuredAudienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model policy that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteConfiguredModelAlgorithm

$result = $client->deleteConfiguredModelAlgorithm([/* ... */]);
$promise = $client->deleteConfiguredModelAlgorithmAsync([/* ... */]);

Deletes a configured model algorithm.

Parameter Syntax

$result = $client->deleteConfiguredModelAlgorithm([
    'configuredModelAlgorithmArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteConfiguredModelAlgorithmAssociation

$result = $client->deleteConfiguredModelAlgorithmAssociation([/* ... */]);
$promise = $client->deleteConfiguredModelAlgorithmAssociationAsync([/* ... */]);

Deletes a configured model algorithm association.

Parameter Syntax

$result = $client->deleteConfiguredModelAlgorithmAssociation([
    'configuredModelAlgorithmAssociationArn' => '<string>', // REQUIRED
    'membershipIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that you want to delete.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that is deleting the configured model algorithm association.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteMLConfiguration

$result = $client->deleteMLConfiguration([/* ... */]);
$promise = $client->deleteMLConfigurationAsync([/* ... */]);

Deletes a ML modeling configuration.

Parameter Syntax

$result = $client->deleteMLConfiguration([
    'membershipIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the of the member that is deleting the ML modeling configuration.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteMLInputChannelData

$result = $client->deleteMLInputChannelData([/* ... */]);
$promise = $client->deleteMLInputChannelDataAsync([/* ... */]);

Provides the information necessary to delete an ML input channel.

Parameter Syntax

$result = $client->deleteMLInputChannelData([
    'membershipIdentifier' => '<string>', // REQUIRED
    'mlInputChannelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel you want to delete.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteTrainedModelOutput

$result = $client->deleteTrainedModelOutput([/* ... */]);
$promise = $client->deleteTrainedModelOutputAsync([/* ... */]);

Deletes the output of a trained model.

Parameter Syntax

$result = $client->deleteTrainedModelOutput([
    'membershipIdentifier' => '<string>', // REQUIRED
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that is deleting the trained model output.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model whose output you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

DeleteTrainingDataset

$result = $client->deleteTrainingDataset([/* ... */]);
$promise = $client->deleteTrainingDatasetAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->deleteTrainingDataset([
    'trainingDatasetArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset that you want to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetAudienceGenerationJob

$result = $client->getAudienceGenerationJob([/* ... */]);
$promise = $client->getAudienceGenerationJobAsync([/* ... */]);

Returns information about an audience generation job.

Parameter Syntax

$result = $client->getAudienceGenerationJob([
    'audienceGenerationJobArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job that you are interested in.

Result Syntax

[
    'audienceGenerationJobArn' => '<string>',
    'collaborationId' => '<string>',
    'configuredAudienceModelArn' => '<string>',
    'createTime' => <DateTime>,
    'description' => '<string>',
    'includeSeedInOutput' => true || false,
    'metrics' => [
        'recallMetric' => <float>,
        'relevanceMetrics' => [
            [
                'audienceSize' => [
                    'type' => 'ABSOLUTE|PERCENTAGE',
                    'value' => <integer>,
                ],
                'score' => <float>,
            ],
            // ...
        ],
    ],
    'name' => '<string>',
    'protectedQueryIdentifier' => '<string>',
    'seedAudience' => [
        'dataSource' => [
            's3Uri' => '<string>',
        ],
        'roleArn' => '<string>',
        'sqlComputeConfiguration' => [
            'worker' => [
                'number' => <integer>,
                'type' => 'CR.1X|CR.4X',
            ],
        ],
        'sqlParameters' => [
            'analysisTemplateArn' => '<string>',
            'parameters' => ['<string>', ...],
            'queryString' => '<string>',
        ],
    ],
    'startedBy' => '<string>',
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'tags' => ['<string>', ...],
    'updateTime' => <DateTime>,
]

Result Details

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job.

collaborationId
Type: string

The identifier of the collaboration that this audience generation job is associated with.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model used for this audience generation job.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the audience generation job was created.

description
Type: string

The description of the audience generation job.

includeSeedInOutput
Type: boolean

Configure whether the seed users are included in the output audience. By default, Clean Rooms ML removes seed users from the output audience. If you specify TRUE, the seed users will appear first in the output. Clean Rooms ML does not explicitly reveal whether a user was in the seed, but the recipient of the audience will know that the first minimumSeedSize count of users are from the seed.

metrics
Type: AudienceQualityMetrics structure

The relevance scores for different audience sizes and the recall score of the generated audience.

name
Required: Yes
Type: string

The name of the audience generation job.

protectedQueryIdentifier
Type: string

The unique identifier of the protected query for this audience generation job.

seedAudience

The seed audience that was used for this audience generation job. This field will be null if the account calling the API is the account that started this audience generation job.

startedBy
Type: string

The AWS account that started this audience generation job.

status
Required: Yes
Type: string

The status of the audience generation job.

statusDetails
Type: StatusDetails structure

Details about the status of the audience generation job.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags that are associated to this audience generation job.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the audience generation job was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetAudienceModel

$result = $client->getAudienceModel([/* ... */]);
$promise = $client->getAudienceModelAsync([/* ... */]);

Returns information about an audience model

Parameter Syntax

$result = $client->getAudienceModel([
    'audienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model that you are interested in.

Result Syntax

[
    'audienceModelArn' => '<string>',
    'createTime' => <DateTime>,
    'description' => '<string>',
    'kmsKeyArn' => '<string>',
    'name' => '<string>',
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'tags' => ['<string>', ...],
    'trainingDataEndTime' => <DateTime>,
    'trainingDataStartTime' => <DateTime>,
    'trainingDatasetArn' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the audience model was created.

description
Type: string

The description of the audience model.

kmsKeyArn
Type: string

The KMS key ARN used for the audience model.

name
Required: Yes
Type: string

The name of the audience model.

status
Required: Yes
Type: string

The status of the audience model.

statusDetails
Type: StatusDetails structure

Details about the status of the audience model.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags that are assigned to the audience model.

trainingDataEndTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The end date specified for the training window.

trainingDataStartTime
Type: timestamp (string|DateTime or anything parsable by strtotime)

The start date specified for the training window.

trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset that was used for this audience model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the audience model was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetCollaborationConfiguredModelAlgorithmAssociation

$result = $client->getCollaborationConfiguredModelAlgorithmAssociation([/* ... */]);
$promise = $client->getCollaborationConfiguredModelAlgorithmAssociationAsync([/* ... */]);

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

Parameter Syntax

$result = $client->getCollaborationConfiguredModelAlgorithmAssociation([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'configuredModelAlgorithmAssociationArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID for the collaboration that contains the configured model algorithm association that you want to return information about.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that you want to return information about.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmArn' => '<string>',
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'createTime' => <DateTime>,
    'creatorAccountId' => '<string>',
    'description' => '<string>',
    'membershipIdentifier' => '<string>',
    'name' => '<string>',
    'privacyConfiguration' => [
        'policies' => [
            'trainedModelExports' => [
                'filesToExport' => ['<string>', ...],
                'maxSize' => [
                    'unit' => 'GB',
                    'value' => <float>,
                ],
            ],
            'trainedModelInferenceJobs' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...],
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'maxOutputSize' => [
                    'unit' => 'GB',
                    'value' => <float>,
                ],
            ],
            'trainedModels' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...],
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'containerMetrics' => [
                    'noiseLevel' => 'HIGH|MEDIUM|LOW|NONE',
                ],
            ],
        ],
    ],
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the configured model algorithm association.

configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm association was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member that created the configured model algorithm association.

description
Type: string

The description of the configured model algorithm association.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm association.

name
Required: Yes
Type: string

The name of the configured model algorithm association.

privacyConfiguration
Type: PrivacyConfiguration structure

Information about the privacy configuration for a configured model algorithm association.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm association was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetCollaborationMLInputChannel

$result = $client->getCollaborationMLInputChannel([/* ... */]);
$promise = $client->getCollaborationMLInputChannelAsync([/* ... */]);

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

Parameter Syntax

$result = $client->getCollaborationMLInputChannel([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'mlInputChannelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channel that you want to get.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel that you want to get.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmAssociations' => ['<string>', ...],
    'createTime' => <DateTime>,
    'creatorAccountId' => '<string>',
    'description' => '<string>',
    'membershipIdentifier' => '<string>',
    'mlInputChannelArn' => '<string>',
    'name' => '<string>',
    'numberOfRecords' => <integer>,
    'retentionInDays' => <integer>,
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channel.

configuredModelAlgorithmAssociations
Required: Yes
Type: Array of strings

The configured model algorithm associations that were used to create the ML input channel.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the ML input channel was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member who created the ML input channel.

description
Type: string

The description of the ML input channel.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel.

name
Required: Yes
Type: string

The name of the ML input channel.

numberOfRecords
Type: long (int|float)

The number of records in the ML input channel.

retentionInDays
Required: Yes
Type: int

The number of days to retain the data for the ML input channel.

status
Required: Yes
Type: string

The status of the ML input channel.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the ML input channel was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetCollaborationTrainedModel

$result = $client->getCollaborationTrainedModel([/* ... */]);
$promise = $client->getCollaborationTrainedModelAsync([/* ... */]);

Returns information about a trained model in a collaboration.

Parameter Syntax

$result = $client->getCollaborationTrainedModel([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID that contains the trained model that you want to return information about.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that you want to return information about.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'createTime' => <DateTime>,
    'creatorAccountId' => '<string>',
    'description' => '<string>',
    'logsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'logsStatusDetails' => '<string>',
    'membershipIdentifier' => '<string>',
    'metricsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'metricsStatusDetails' => '<string>',
    'name' => '<string>',
    'resourceConfig' => [
        'instanceCount' => <integer>,
        'instanceType' => 'ml.m4.xlarge|ml.m4.2xlarge|ml.m4.4xlarge|ml.m4.10xlarge|ml.m4.16xlarge|ml.g4dn.xlarge|ml.g4dn.2xlarge|ml.g4dn.4xlarge|ml.g4dn.8xlarge|ml.g4dn.12xlarge|ml.g4dn.16xlarge|ml.m5.large|ml.m5.xlarge|ml.m5.2xlarge|ml.m5.4xlarge|ml.m5.12xlarge|ml.m5.24xlarge|ml.c4.xlarge|ml.c4.2xlarge|ml.c4.4xlarge|ml.c4.8xlarge|ml.p2.xlarge|ml.p2.8xlarge|ml.p2.16xlarge|ml.p3.2xlarge|ml.p3.8xlarge|ml.p3.16xlarge|ml.p3dn.24xlarge|ml.p4d.24xlarge|ml.p4de.24xlarge|ml.p5.48xlarge|ml.c5.xlarge|ml.c5.2xlarge|ml.c5.4xlarge|ml.c5.9xlarge|ml.c5.18xlarge|ml.c5n.xlarge|ml.c5n.2xlarge|ml.c5n.4xlarge|ml.c5n.9xlarge|ml.c5n.18xlarge|ml.g5.xlarge|ml.g5.2xlarge|ml.g5.4xlarge|ml.g5.8xlarge|ml.g5.16xlarge|ml.g5.12xlarge|ml.g5.24xlarge|ml.g5.48xlarge|ml.trn1.2xlarge|ml.trn1.32xlarge|ml.trn1n.32xlarge|ml.m6i.large|ml.m6i.xlarge|ml.m6i.2xlarge|ml.m6i.4xlarge|ml.m6i.8xlarge|ml.m6i.12xlarge|ml.m6i.16xlarge|ml.m6i.24xlarge|ml.m6i.32xlarge|ml.c6i.xlarge|ml.c6i.2xlarge|ml.c6i.8xlarge|ml.c6i.4xlarge|ml.c6i.12xlarge|ml.c6i.16xlarge|ml.c6i.24xlarge|ml.c6i.32xlarge|ml.r5d.large|ml.r5d.xlarge|ml.r5d.2xlarge|ml.r5d.4xlarge|ml.r5d.8xlarge|ml.r5d.12xlarge|ml.r5d.16xlarge|ml.r5d.24xlarge|ml.t3.medium|ml.t3.large|ml.t3.xlarge|ml.t3.2xlarge|ml.r5.large|ml.r5.xlarge|ml.r5.2xlarge|ml.r5.4xlarge|ml.r5.8xlarge|ml.r5.12xlarge|ml.r5.16xlarge|ml.r5.24xlarge',
        'volumeSizeInGB' => <integer>,
    ],
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'stoppingCondition' => [
        'maxRuntimeInSeconds' => <integer>,
    ],
    'trainedModelArn' => '<string>',
    'trainingContainerImageDigest' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that was used to create this trained model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member that created the trained model.

description
Type: string

The description of the trained model.

logsStatus
Type: string

Status information for the logs.

logsStatusDetails
Type: string

Details about the status information for the logs.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model.

metricsStatus
Type: string

The status of the model metrics.

metricsStatusDetails
Type: string

Details about the status information for the model metrics.

name
Required: Yes
Type: string

The name of the trained model.

resourceConfig
Type: ResourceConfig structure

The EC2 resource configuration that was used to train this model.

status
Required: Yes
Type: string

The status of the trained model.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

stoppingCondition
Type: StoppingCondition structure

The stopping condition that determined when model training ended.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model.

trainingContainerImageDigest
Type: string

Information about the training container image.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetConfiguredAudienceModel

$result = $client->getConfiguredAudienceModel([/* ... */]);
$promise = $client->getConfiguredAudienceModelAsync([/* ... */]);

Returns information about a specified configured audience model.

Parameter Syntax

$result = $client->getConfiguredAudienceModel([
    'configuredAudienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that you are interested in.

Result Syntax

[
    'audienceModelArn' => '<string>',
    'audienceSizeConfig' => [
        'audienceSizeBins' => [<integer>, ...],
        'audienceSizeType' => 'ABSOLUTE|PERCENTAGE',
    ],
    'childResourceTagOnCreatePolicy' => 'FROM_PARENT_RESOURCE|NONE',
    'configuredAudienceModelArn' => '<string>',
    'createTime' => <DateTime>,
    'description' => '<string>',
    'minMatchingSeedSize' => <integer>,
    'name' => '<string>',
    'outputConfig' => [
        'destination' => [
            's3Destination' => [
                's3Uri' => '<string>',
            ],
        ],
        'roleArn' => '<string>',
    ],
    'sharedAudienceMetrics' => ['<string>', ...],
    'status' => 'ACTIVE',
    'tags' => ['<string>', ...],
    'updateTime' => <DateTime>,
]

Result Details

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model used for this configured audience model.

audienceSizeConfig
Type: AudienceSizeConfig structure

The list of output sizes of audiences that can be created using this configured audience model. A request to StartAudienceGenerationJob that uses this configured audience model must have an audienceSize selected from this list. You can use the ABSOLUTE AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use the Percentage AudienceSize to configure sizes in the range 1-100 percent.

childResourceTagOnCreatePolicy
Type: string

Provides the childResourceTagOnCreatePolicy that was used for this configured audience model.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured audience model was created.

description
Type: string

The description of the configured audience model.

minMatchingSeedSize
Type: int

The minimum number of users from the seed audience that must match with users in the training data of the audience model.

name
Required: Yes
Type: string

The name of the configured audience model.

outputConfig
Required: Yes
Type: ConfiguredAudienceModelOutputConfig structure

The output configuration of the configured audience model

sharedAudienceMetrics
Required: Yes
Type: Array of strings

Whether audience metrics are shared.

status
Required: Yes
Type: string

The status of the configured audience model.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags that are associated to this configured audience model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured audience model was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetConfiguredAudienceModelPolicy

$result = $client->getConfiguredAudienceModelPolicy([/* ... */]);
$promise = $client->getConfiguredAudienceModelPolicyAsync([/* ... */]);

Returns information about a configured audience model policy.

Parameter Syntax

$result = $client->getConfiguredAudienceModelPolicy([
    'configuredAudienceModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that you are interested in.

Result Syntax

[
    'configuredAudienceModelArn' => '<string>',
    'configuredAudienceModelPolicy' => '<string>',
    'policyHash' => '<string>',
]

Result Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model.

configuredAudienceModelPolicy
Required: Yes
Type: string

The configured audience model policy. This is a JSON IAM resource policy.

policyHash
Required: Yes
Type: string

A cryptographic hash of the contents of the policy used to prevent unexpected concurrent modification of the policy.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetConfiguredModelAlgorithm

$result = $client->getConfiguredModelAlgorithm([/* ... */]);
$promise = $client->getConfiguredModelAlgorithmAsync([/* ... */]);

Returns information about a configured model algorithm.

Parameter Syntax

$result = $client->getConfiguredModelAlgorithm([
    'configuredModelAlgorithmArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that you want to return information about.

Result Syntax

[
    'configuredModelAlgorithmArn' => '<string>',
    'createTime' => <DateTime>,
    'description' => '<string>',
    'inferenceContainerConfig' => [
        'imageUri' => '<string>',
    ],
    'kmsKeyArn' => '<string>',
    'name' => '<string>',
    'roleArn' => '<string>',
    'tags' => ['<string>', ...],
    'trainingContainerConfig' => [
        'arguments' => ['<string>', ...],
        'entrypoint' => ['<string>', ...],
        'imageUri' => '<string>',
        'metricDefinitions' => [
            [
                'name' => '<string>',
                'regex' => '<string>',
            ],
            // ...
        ],
    ],
    'updateTime' => <DateTime>,
]

Result Details

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm was created.

description
Type: string

The description of the configured model algorithm.

inferenceContainerConfig
Type: InferenceContainerConfig structure

Configuration information for the inference container.

kmsKeyArn
Type: string

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

name
Required: Yes
Type: string

The name of the configured model algorithm.

roleArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the service role that was used to create the configured model algorithm.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The optional metadata that you applied 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.

trainingContainerConfig
Type: ContainerConfig structure

The configuration information of the training container for the configured model algorithm.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetConfiguredModelAlgorithmAssociation

$result = $client->getConfiguredModelAlgorithmAssociation([/* ... */]);
$promise = $client->getConfiguredModelAlgorithmAssociationAsync([/* ... */]);

Returns information about a configured model algorithm association.

Parameter Syntax

$result = $client->getConfiguredModelAlgorithmAssociation([
    'configuredModelAlgorithmAssociationArn' => '<string>', // REQUIRED
    'membershipIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that you want to return information about.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm association.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmArn' => '<string>',
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'createTime' => <DateTime>,
    'description' => '<string>',
    'membershipIdentifier' => '<string>',
    'name' => '<string>',
    'privacyConfiguration' => [
        'policies' => [
            'trainedModelExports' => [
                'filesToExport' => ['<string>', ...],
                'maxSize' => [
                    'unit' => 'GB',
                    'value' => <float>,
                ],
            ],
            'trainedModelInferenceJobs' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...],
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'maxOutputSize' => [
                    'unit' => 'GB',
                    'value' => <float>,
                ],
            ],
            'trainedModels' => [
                'containerLogs' => [
                    [
                        'allowedAccountIds' => ['<string>', ...],
                        'filterPattern' => '<string>',
                    ],
                    // ...
                ],
                'containerMetrics' => [
                    'noiseLevel' => 'HIGH|MEDIUM|LOW|NONE',
                ],
            ],
        ],
    ],
    'tags' => ['<string>', ...],
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the configured model algorithm association.

configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that was associated to the collaboration.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm association was created.

description
Type: string

The description of the configured model algorithm association.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm association.

name
Required: Yes
Type: string

The name of the configured model algorithm association.

privacyConfiguration
Type: PrivacyConfiguration structure

The privacy configuration information for the configured model algorithm association.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The optional metadata that you applied 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.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm association was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetMLConfiguration

$result = $client->getMLConfiguration([/* ... */]);
$promise = $client->getMLConfigurationAsync([/* ... */]);

Returns information about a specific ML configuration.

Parameter Syntax

$result = $client->getMLConfiguration([
    'membershipIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that owns the ML configuration you want to return information about.

Result Syntax

[
    'createTime' => <DateTime>,
    'defaultOutputLocation' => [
        'destination' => [
            's3Destination' => [
                's3Uri' => '<string>',
            ],
        ],
        'roleArn' => '<string>',
    ],
    'membershipIdentifier' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the ML configuration was created.

defaultOutputLocation
Required: Yes
Type: MLOutputConfiguration structure

The Amazon S3 location where ML model output is stored.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that owns the ML configuration you requested.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the ML configuration was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetMLInputChannel

$result = $client->getMLInputChannel([/* ... */]);
$promise = $client->getMLInputChannelAsync([/* ... */]);

Returns information about an ML input channel.

Parameter Syntax

$result = $client->getMLInputChannel([
    'membershipIdentifier' => '<string>', // REQUIRED
    'mlInputChannelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel that you want to get.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel that you want to get.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmAssociations' => ['<string>', ...],
    'createTime' => <DateTime>,
    'description' => '<string>',
    'inputChannel' => [
        'dataSource' => [
            'protectedQueryInputParameters' => [
                'computeConfiguration' => [
                    'worker' => [
                        'number' => <integer>,
                        'type' => 'CR.1X|CR.4X',
                    ],
                ],
                'sqlParameters' => [
                    'analysisTemplateArn' => '<string>',
                    'parameters' => ['<string>', ...],
                    'queryString' => '<string>',
                ],
            ],
        ],
        'roleArn' => '<string>',
    ],
    'kmsKeyArn' => '<string>',
    'membershipIdentifier' => '<string>',
    'mlInputChannelArn' => '<string>',
    'name' => '<string>',
    'numberOfFiles' => <float>,
    'numberOfRecords' => <integer>,
    'protectedQueryIdentifier' => '<string>',
    'retentionInDays' => <integer>,
    'sizeInGb' => <float>,
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'tags' => ['<string>', ...],
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channel.

configuredModelAlgorithmAssociations
Required: Yes
Type: Array of strings

The configured model algorithm associations that were used to create the ML input channel.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the ML input channel was created.

description
Type: string

The description of the ML input channel.

inputChannel
Required: Yes
Type: InputChannel structure

The input channel that was used to create the ML input channel.

kmsKeyArn
Type: string

The Amazon Resource Name (ARN) of the KMS key that was used to create the ML input channel.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel.

name
Required: Yes
Type: string

The name of the ML input channel.

numberOfFiles
Type: double

The number of files in the ML input channel.

numberOfRecords
Type: long (int|float)

The number of records in the ML input channel.

protectedQueryIdentifier
Type: string

The ID of the protected query that was used to create the ML input channel.

retentionInDays
Required: Yes
Type: int

The number of days to keep the data in the ML input channel.

sizeInGb
Type: double

The size, in GB, of the ML input channel.

status
Required: Yes
Type: string

The status of the ML input channel.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The optional metadata that you applied 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.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the ML input channel was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetTrainedModel

$result = $client->getTrainedModel([/* ... */]);
$promise = $client->getTrainedModelAsync([/* ... */]);

Returns information about a trained model.

Parameter Syntax

$result = $client->getTrainedModel([
    'membershipIdentifier' => '<string>', // REQUIRED
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model that you are interested in.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that you are interested in.

Result Syntax

[
    'collaborationIdentifier' => '<string>',
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'createTime' => <DateTime>,
    'dataChannels' => [
        [
            'channelName' => '<string>',
            'mlInputChannelArn' => '<string>',
        ],
        // ...
    ],
    'description' => '<string>',
    'environment' => ['<string>', ...],
    'hyperparameters' => ['<string>', ...],
    'kmsKeyArn' => '<string>',
    'logsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'logsStatusDetails' => '<string>',
    'membershipIdentifier' => '<string>',
    'metricsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'metricsStatusDetails' => '<string>',
    'name' => '<string>',
    'resourceConfig' => [
        'instanceCount' => <integer>,
        'instanceType' => 'ml.m4.xlarge|ml.m4.2xlarge|ml.m4.4xlarge|ml.m4.10xlarge|ml.m4.16xlarge|ml.g4dn.xlarge|ml.g4dn.2xlarge|ml.g4dn.4xlarge|ml.g4dn.8xlarge|ml.g4dn.12xlarge|ml.g4dn.16xlarge|ml.m5.large|ml.m5.xlarge|ml.m5.2xlarge|ml.m5.4xlarge|ml.m5.12xlarge|ml.m5.24xlarge|ml.c4.xlarge|ml.c4.2xlarge|ml.c4.4xlarge|ml.c4.8xlarge|ml.p2.xlarge|ml.p2.8xlarge|ml.p2.16xlarge|ml.p3.2xlarge|ml.p3.8xlarge|ml.p3.16xlarge|ml.p3dn.24xlarge|ml.p4d.24xlarge|ml.p4de.24xlarge|ml.p5.48xlarge|ml.c5.xlarge|ml.c5.2xlarge|ml.c5.4xlarge|ml.c5.9xlarge|ml.c5.18xlarge|ml.c5n.xlarge|ml.c5n.2xlarge|ml.c5n.4xlarge|ml.c5n.9xlarge|ml.c5n.18xlarge|ml.g5.xlarge|ml.g5.2xlarge|ml.g5.4xlarge|ml.g5.8xlarge|ml.g5.16xlarge|ml.g5.12xlarge|ml.g5.24xlarge|ml.g5.48xlarge|ml.trn1.2xlarge|ml.trn1.32xlarge|ml.trn1n.32xlarge|ml.m6i.large|ml.m6i.xlarge|ml.m6i.2xlarge|ml.m6i.4xlarge|ml.m6i.8xlarge|ml.m6i.12xlarge|ml.m6i.16xlarge|ml.m6i.24xlarge|ml.m6i.32xlarge|ml.c6i.xlarge|ml.c6i.2xlarge|ml.c6i.8xlarge|ml.c6i.4xlarge|ml.c6i.12xlarge|ml.c6i.16xlarge|ml.c6i.24xlarge|ml.c6i.32xlarge|ml.r5d.large|ml.r5d.xlarge|ml.r5d.2xlarge|ml.r5d.4xlarge|ml.r5d.8xlarge|ml.r5d.12xlarge|ml.r5d.16xlarge|ml.r5d.24xlarge|ml.t3.medium|ml.t3.large|ml.t3.xlarge|ml.t3.2xlarge|ml.r5.large|ml.r5.xlarge|ml.r5.2xlarge|ml.r5.4xlarge|ml.r5.8xlarge|ml.r5.12xlarge|ml.r5.16xlarge|ml.r5.24xlarge',
        'volumeSizeInGB' => <integer>,
    ],
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'stoppingCondition' => [
        'maxRuntimeInSeconds' => <integer>,
    ],
    'tags' => ['<string>', ...],
    'trainedModelArn' => '<string>',
    'trainingContainerImageDigest' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that was used to create the trained model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model was created.

dataChannels
Required: Yes
Type: Array of ModelTrainingDataChannel structures

The data channels that were used for the trained model.

description
Type: string

The description of the trained model.

environment
Type: Associative array of custom strings keys (EnvironmentKeyString) to strings

The EC2 environment that was used to create the trained model.

hyperparameters
Type: Associative array of custom strings keys (HyperParametersKeyString) to strings

The hyperparameters that were used to create the trained model.

kmsKeyArn
Type: string

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 associated data.

logsStatus
Type: string

The logs status for the trained model.

logsStatusDetails
Type: string

Details about the logs status for the trained model.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model.

metricsStatus
Type: string

The status of the model metrics.

metricsStatusDetails
Type: string

Details about the metrics status for the trained model.

name
Required: Yes
Type: string

The name of the trained model.

resourceConfig
Type: ResourceConfig structure

The EC2 resource configuration that was used to create the trained model.

status
Required: Yes
Type: string

The status of the trained model.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

stoppingCondition
Type: StoppingCondition structure

The stopping condition that was used to terminate model training.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The optional metadata that you applied 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.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model.

trainingContainerImageDigest
Type: string

Information about the training image container.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetTrainedModelInferenceJob

$result = $client->getTrainedModelInferenceJob([/* ... */]);
$promise = $client->getTrainedModelInferenceJobAsync([/* ... */]);

Returns information about a trained model inference job.

Parameter Syntax

$result = $client->getTrainedModelInferenceJob([
    'membershipIdentifier' => '<string>', // REQUIRED
    'trainedModelInferenceJobArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
membershipIdentifier
Required: Yes
Type: string

Provides the membership ID of the membership that contains the trained model inference job that you are interested in.

trainedModelInferenceJobArn
Required: Yes
Type: string

Provides the Amazon Resource Name (ARN) of the trained model inference job that you are interested in.

Result Syntax

[
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'containerExecutionParameters' => [
        'maxPayloadInMB' => <integer>,
    ],
    'createTime' => <DateTime>,
    'dataSource' => [
        'mlInputChannelArn' => '<string>',
    ],
    'description' => '<string>',
    'environment' => ['<string>', ...],
    'inferenceContainerImageDigest' => '<string>',
    'kmsKeyArn' => '<string>',
    'logsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'logsStatusDetails' => '<string>',
    'membershipIdentifier' => '<string>',
    'metricsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
    'metricsStatusDetails' => '<string>',
    'name' => '<string>',
    'outputConfiguration' => [
        'accept' => '<string>',
        'members' => [
            [
                'accountId' => '<string>',
            ],
            // ...
        ],
    ],
    'resourceConfig' => [
        'instanceCount' => <integer>,
        'instanceType' => 'ml.r7i.48xlarge|ml.r6i.16xlarge|ml.m6i.xlarge|ml.m5.4xlarge|ml.p2.xlarge|ml.m4.16xlarge|ml.r7i.16xlarge|ml.m7i.xlarge|ml.m6i.12xlarge|ml.r7i.8xlarge|ml.r7i.large|ml.m7i.12xlarge|ml.m6i.24xlarge|ml.m7i.24xlarge|ml.r6i.8xlarge|ml.r6i.large|ml.g5.2xlarge|ml.m5.large|ml.p3.16xlarge|ml.m7i.48xlarge|ml.m6i.16xlarge|ml.p2.16xlarge|ml.g5.4xlarge|ml.m7i.16xlarge|ml.c4.2xlarge|ml.c5.2xlarge|ml.c6i.32xlarge|ml.c4.4xlarge|ml.g5.8xlarge|ml.c6i.xlarge|ml.c5.4xlarge|ml.g4dn.xlarge|ml.c7i.xlarge|ml.c6i.12xlarge|ml.g4dn.12xlarge|ml.c7i.12xlarge|ml.c6i.24xlarge|ml.g4dn.2xlarge|ml.c7i.24xlarge|ml.c7i.2xlarge|ml.c4.8xlarge|ml.c6i.2xlarge|ml.g4dn.4xlarge|ml.c7i.48xlarge|ml.c7i.4xlarge|ml.c6i.16xlarge|ml.c5.9xlarge|ml.g4dn.16xlarge|ml.c7i.16xlarge|ml.c6i.4xlarge|ml.c5.xlarge|ml.c4.xlarge|ml.g4dn.8xlarge|ml.c7i.8xlarge|ml.c7i.large|ml.g5.xlarge|ml.c6i.8xlarge|ml.c6i.large|ml.g5.12xlarge|ml.g5.24xlarge|ml.m7i.2xlarge|ml.c5.18xlarge|ml.g5.48xlarge|ml.m6i.2xlarge|ml.g5.16xlarge|ml.m7i.4xlarge|ml.p3.2xlarge|ml.r6i.32xlarge|ml.m6i.4xlarge|ml.m5.xlarge|ml.m4.10xlarge|ml.r6i.xlarge|ml.m5.12xlarge|ml.m4.xlarge|ml.r7i.2xlarge|ml.r7i.xlarge|ml.r6i.12xlarge|ml.m5.24xlarge|ml.r7i.12xlarge|ml.m7i.8xlarge|ml.m7i.large|ml.r6i.24xlarge|ml.r6i.2xlarge|ml.m4.2xlarge|ml.r7i.24xlarge|ml.r7i.4xlarge|ml.m6i.8xlarge|ml.m6i.large|ml.m5.2xlarge|ml.p2.8xlarge|ml.r6i.4xlarge|ml.m6i.32xlarge|ml.p3.8xlarge|ml.m4.4xlarge',
    ],
    'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED|INACTIVE',
    'statusDetails' => [
        'message' => '<string>',
        'statusCode' => '<string>',
    ],
    'tags' => ['<string>', ...],
    'trainedModelArn' => '<string>',
    'trainedModelInferenceJobArn' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
configuredModelAlgorithmAssociationArn
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that was used for the trained model inference job.

containerExecutionParameters

The execution parameters for the model inference job container.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model inference job was created.

dataSource
Required: Yes
Type: ModelInferenceDataSource structure

The data source that was used for the trained model inference job.

description
Type: string

The description of the trained model inference job.

environment
Type: Associative array of custom strings keys (InferenceEnvironmentMapKeyString) to strings

The environment variables to set in the Docker container.

inferenceContainerImageDigest
Type: string

Information about the training container image.

kmsKeyArn
Type: string

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

logsStatus
Type: string

The logs status for the trained model inference job.

logsStatusDetails
Type: string

Details about the logs status for the trained model inference job.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the trained model inference job.

metricsStatus
Type: string

The metrics status for the trained model inference job.

metricsStatusDetails
Type: string

Details about the metrics status for the trained model inference job.

name
Required: Yes
Type: string

The name of the trained model inference job.

outputConfiguration
Required: Yes
Type: InferenceOutputConfiguration structure

The output configuration information for the trained model inference job.

resourceConfig
Required: Yes
Type: InferenceResourceConfig structure

The resource configuration information for the trained model inference job.

status
Required: Yes
Type: string

The status of the trained model inference job.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The optional metadata that you applied 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.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) for the trained model that was used for the trained model inference job.

trainedModelInferenceJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model inference job.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model inference job was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

GetTrainingDataset

$result = $client->getTrainingDataset([/* ... */]);
$promise = $client->getTrainingDatasetAsync([/* ... */]);

Returns information about a training dataset.

Parameter Syntax

$result = $client->getTrainingDataset([
    'trainingDatasetArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset that you are interested in.

Result Syntax

[
    'createTime' => <DateTime>,
    'description' => '<string>',
    'name' => '<string>',
    'roleArn' => '<string>',
    'status' => 'ACTIVE',
    'tags' => ['<string>', ...],
    'trainingData' => [
        [
            'inputConfig' => [
                'dataSource' => [
                    'glueDataSource' => [
                        'catalogId' => '<string>',
                        'databaseName' => '<string>',
                        'tableName' => '<string>',
                    ],
                ],
                'schema' => [
                    [
                        'columnName' => '<string>',
                        'columnTypes' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'type' => 'INTERACTIONS',
        ],
        // ...
    ],
    'trainingDatasetArn' => '<string>',
    'updateTime' => <DateTime>,
]

Result Details

Members
createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the training dataset was created.

description
Type: string

The description of the training dataset.

name
Required: Yes
Type: string

The name of the training dataset.

roleArn
Required: Yes
Type: string

The IAM role used to read the training data.

status
Required: Yes
Type: string

The status of the training dataset.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags that are assigned to this training dataset.

trainingData
Required: Yes
Type: Array of Dataset structures

Metadata about the requested training data.

trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the training dataset was updated.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ListAudienceExportJobs

$result = $client->listAudienceExportJobs([/* ... */]);
$promise = $client->listAudienceExportJobsAsync([/* ... */]);

Returns a list of the audience export jobs.

Parameter Syntax

$result = $client->listAudienceExportJobs([
    'audienceGenerationJobArn' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
audienceGenerationJobArn
Type: string

The Amazon Resource Name (ARN) of the audience generation job that you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'audienceExportJobs' => [
        [
            'audienceGenerationJobArn' => '<string>',
            'audienceSize' => [
                'type' => 'ABSOLUTE|PERCENTAGE',
                'value' => <integer>,
            ],
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'outputLocation' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE',
            'statusDetails' => [
                'message' => '<string>',
                'statusCode' => '<string>',
            ],
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
audienceExportJobs
Required: Yes
Type: Array of AudienceExportJobSummary structures

The audience export jobs that match the request.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListAudienceGenerationJobs

$result = $client->listAudienceGenerationJobs([/* ... */]);
$promise = $client->listAudienceGenerationJobsAsync([/* ... */]);

Returns a list of audience generation jobs.

Parameter Syntax

$result = $client->listAudienceGenerationJobs([
    'collaborationId' => '<string>',
    'configuredAudienceModelArn' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
collaborationId
Type: string

The identifier of the collaboration that contains the audience generation jobs that you are interested in.

configuredAudienceModelArn
Type: string

The Amazon Resource Name (ARN) of the configured audience model that was used for the audience generation jobs that you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'audienceGenerationJobs' => [
        [
            'audienceGenerationJobArn' => '<string>',
            'collaborationId' => '<string>',
            'configuredAudienceModelArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'startedBy' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
audienceGenerationJobs
Required: Yes
Type: Array of AudienceGenerationJobSummary structures

The audience generation jobs that match the request.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListAudienceModels

$result = $client->listAudienceModels([/* ... */]);
$promise = $client->listAudienceModelsAsync([/* ... */]);

Returns a list of audience models.

Parameter Syntax

$result = $client->listAudienceModels([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'audienceModels' => [
        [
            'audienceModelArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED',
            'trainingDatasetArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
audienceModels
Required: Yes
Type: Array of AudienceModelSummary structures

The audience models that match the request.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListCollaborationConfiguredModelAlgorithmAssociations

$result = $client->listCollaborationConfiguredModelAlgorithmAssociations([/* ... */]);
$promise = $client->listCollaborationConfiguredModelAlgorithmAssociationsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listCollaborationConfiguredModelAlgorithmAssociations([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the configured model algorithm associations that you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'collaborationConfiguredModelAlgorithmAssociations' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmArn' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'creatorAccountId' => '<string>',
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'name' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
collaborationConfiguredModelAlgorithmAssociations
Required: Yes
Type: Array of CollaborationConfiguredModelAlgorithmAssociationSummary structures

The configured model algorithm associations that belong to this collaboration.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListCollaborationMLInputChannels

$result = $client->listCollaborationMLInputChannels([/* ... */]);
$promise = $client->listCollaborationMLInputChannelsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listCollaborationMLInputChannels([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channels that you want to list.

maxResults
Type: int

The maximum number of results to return.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'collaborationMLInputChannelsList' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociations' => ['<string>', ...],
            'createTime' => <DateTime>,
            'creatorAccountId' => '<string>',
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'mlInputChannelArn' => '<string>',
            'name' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
collaborationMLInputChannelsList
Required: Yes
Type: Array of CollaborationMLInputChannelSummary structures

The list of ML input channels that you wanted.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListCollaborationTrainedModelExportJobs

$result = $client->listCollaborationTrainedModelExportJobs([/* ... */]);
$promise = $client->listCollaborationTrainedModelExportJobsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listCollaborationTrainedModelExportJobs([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model export jobs that you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that was used to create the export jobs that you are interested in.

Result Syntax

[
    'collaborationTrainedModelExportJobs' => [
        [
            'collaborationIdentifier' => '<string>',
            'createTime' => <DateTime>,
            'creatorAccountId' => '<string>',
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'name' => '<string>',
            'outputConfiguration' => [
                'members' => [
                    [
                        'accountId' => '<string>',
                    ],
                    // ...
                ],
            ],
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE',
            'statusDetails' => [
                'message' => '<string>',
                'statusCode' => '<string>',
            ],
            'trainedModelArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
collaborationTrainedModelExportJobs
Required: Yes
Type: Array of CollaborationTrainedModelExportJobSummary structures

The exports jobs that exist for the requested trained model in the requested collaboration.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListCollaborationTrainedModelInferenceJobs

$result = $client->listCollaborationTrainedModelInferenceJobs([/* ... */]);
$promise = $client->listCollaborationTrainedModelInferenceJobsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listCollaborationTrainedModelInferenceJobs([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'trainedModelArn' => '<string>',
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model inference jobs that you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

trainedModelArn
Type: string

The Amazon Resource Name (ARN) of the trained model that was used to create the trained model inference jobs that you are interested in.

Result Syntax

[
    'collaborationTrainedModelInferenceJobs' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'creatorAccountId' => '<string>',
            'description' => '<string>',
            'logsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
            'logsStatusDetails' => '<string>',
            'membershipIdentifier' => '<string>',
            'metricsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
            'metricsStatusDetails' => '<string>',
            'name' => '<string>',
            'outputConfiguration' => [
                'accept' => '<string>',
                'members' => [
                    [
                        'accountId' => '<string>',
                    ],
                    // ...
                ],
            ],
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED|INACTIVE',
            'trainedModelArn' => '<string>',
            'trainedModelInferenceJobArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
collaborationTrainedModelInferenceJobs
Required: Yes
Type: Array of CollaborationTrainedModelInferenceJobSummary structures

The trained model inference jobs that you are interested in.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListCollaborationTrainedModels

$result = $client->listCollaborationTrainedModels([/* ... */]);
$promise = $client->listCollaborationTrainedModelsAsync([/* ... */]);

Returns a list of the trained models in a collaboration.

Parameter Syntax

$result = $client->listCollaborationTrainedModels([
    'collaborationIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained models you are interested in.

maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'collaborationTrainedModels' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'creatorAccountId' => '<string>',
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'name' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED',
            'trainedModelArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
collaborationTrainedModels
Required: Yes
Type: Array of CollaborationTrainedModelSummary structures

The trained models in the collaboration that you requested.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListConfiguredAudienceModels

$result = $client->listConfiguredAudienceModels([/* ... */]);
$promise = $client->listConfiguredAudienceModelsAsync([/* ... */]);

Returns a list of the configured audience models.

Parameter Syntax

$result = $client->listConfiguredAudienceModels([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'configuredAudienceModels' => [
        [
            'audienceModelArn' => '<string>',
            'configuredAudienceModelArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'outputConfig' => [
                'destination' => [
                    's3Destination' => [
                        's3Uri' => '<string>',
                    ],
                ],
                'roleArn' => '<string>',
            ],
            'status' => 'ACTIVE',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
configuredAudienceModels
Required: Yes
Type: Array of ConfiguredAudienceModelSummary structures

The configured audience models.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListConfiguredModelAlgorithmAssociations

$result = $client->listConfiguredModelAlgorithmAssociations([/* ... */]);
$promise = $client->listConfiguredModelAlgorithmAssociationsAsync([/* ... */]);

Returns a list of configured model algorithm associations.

Parameter Syntax

$result = $client->listConfiguredModelAlgorithmAssociations([
    'maxResults' => <integer>,
    'membershipIdentifier' => '<string>', // REQUIRED
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm associations you are interested in.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'configuredModelAlgorithmAssociations' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmArn' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'name' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
configuredModelAlgorithmAssociations
Required: Yes
Type: Array of ConfiguredModelAlgorithmAssociationSummary structures

The list of configured model algorithm associations.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListConfiguredModelAlgorithms

$result = $client->listConfiguredModelAlgorithms([/* ... */]);
$promise = $client->listConfiguredModelAlgorithmsAsync([/* ... */]);

Returns a list of configured model algorithms.

Parameter Syntax

$result = $client->listConfiguredModelAlgorithms([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'configuredModelAlgorithms' => [
        [
            'configuredModelAlgorithmArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
configuredModelAlgorithms
Required: Yes
Type: Array of ConfiguredModelAlgorithmSummary structures

The list of configured model algorithms.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListMLInputChannels

$result = $client->listMLInputChannels([/* ... */]);
$promise = $client->listMLInputChannelsAsync([/* ... */]);

Returns a list of ML input channels.

Parameter Syntax

$result = $client->listMLInputChannels([
    'maxResults' => <integer>,
    'membershipIdentifier' => '<string>', // REQUIRED
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of ML input channels to return.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channels that you want to list.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'mlInputChannelsList' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociations' => ['<string>', ...],
            'createTime' => <DateTime>,
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'mlInputChannelArn' => '<string>',
            'name' => '<string>',
            'protectedQueryIdentifier' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
mlInputChannelsList
Required: Yes
Type: Array of MLInputChannelSummary structures

The list of ML input channels that you wanted.

nextToken
Type: string

The token value used to access the next page of results.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListTagsForResource

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Returns a list of tags for a provided resource.

Parameter Syntax

$result = $client->listTagsForResource([
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource that you are interested in.

Result Syntax

[
    'tags' => ['<string>', ...],
]

Result Details

Members
tags
Required: Yes
Type: Associative array of custom strings keys (TagKey) to strings

The tags that are associated with the resource.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ListTrainedModelInferenceJobs

$result = $client->listTrainedModelInferenceJobs([/* ... */]);
$promise = $client->listTrainedModelInferenceJobsAsync([/* ... */]);

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

Parameter Syntax

$result = $client->listTrainedModelInferenceJobs([
    'maxResults' => <integer>,
    'membershipIdentifier' => '<string>', // REQUIRED
    'nextToken' => '<string>',
    'trainedModelArn' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

membershipIdentifier
Required: Yes
Type: string

The membership

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

trainedModelArn
Type: string

The Amazon Resource Name (ARN) of a trained model that was used to create the trained model inference jobs that you are interested in.

Result Syntax

[
    'nextToken' => '<string>',
    'trainedModelInferenceJobs' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'logsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
            'logsStatusDetails' => '<string>',
            'membershipIdentifier' => '<string>',
            'metricsStatus' => 'PUBLISH_SUCCEEDED|PUBLISH_FAILED',
            'metricsStatusDetails' => '<string>',
            'name' => '<string>',
            'outputConfiguration' => [
                'accept' => '<string>',
                'members' => [
                    [
                        'accountId' => '<string>',
                    ],
                    // ...
                ],
            ],
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED|INACTIVE',
            'trainedModelArn' => '<string>',
            'trainedModelInferenceJobArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The token value used to access the next page of results.

trainedModelInferenceJobs
Required: Yes
Type: Array of TrainedModelInferenceJobSummary structures

Returns the requested trained model inference jobs.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListTrainedModels

$result = $client->listTrainedModels([/* ... */]);
$promise = $client->listTrainedModelsAsync([/* ... */]);

Returns a list of trained models.

Parameter Syntax

$result = $client->listTrainedModels([
    'maxResults' => <integer>,
    'membershipIdentifier' => '<string>', // REQUIRED
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained models you are interested in.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'nextToken' => '<string>',
    'trainedModels' => [
        [
            'collaborationIdentifier' => '<string>',
            'configuredModelAlgorithmAssociationArn' => '<string>',
            'createTime' => <DateTime>,
            'description' => '<string>',
            'membershipIdentifier' => '<string>',
            'name' => '<string>',
            'status' => 'CREATE_PENDING|CREATE_IN_PROGRESS|CREATE_FAILED|ACTIVE|DELETE_PENDING|DELETE_IN_PROGRESS|DELETE_FAILED|INACTIVE|CANCEL_PENDING|CANCEL_IN_PROGRESS|CANCEL_FAILED',
            'trainedModelArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The token value used to access the next page of results.

trainedModels
Required: Yes
Type: Array of TrainedModelSummary structures

The list of trained models.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ListTrainingDatasets

$result = $client->listTrainingDatasets([/* ... */]);
$promise = $client->listTrainingDatasetsAsync([/* ... */]);

Returns a list of training datasets.

Parameter Syntax

$result = $client->listTrainingDatasets([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum size of the results that is returned per call.

nextToken
Type: string

The token value retrieved from a previous call to access the next page of results.

Result Syntax

[
    'nextToken' => '<string>',
    'trainingDatasets' => [
        [
            'createTime' => <DateTime>,
            'description' => '<string>',
            'name' => '<string>',
            'status' => 'ACTIVE',
            'trainingDatasetArn' => '<string>',
            'updateTime' => <DateTime>,
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The token value used to access the next page of results.

trainingDatasets
Required: Yes
Type: Array of TrainingDatasetSummary structures

The training datasets that match the request.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

PutConfiguredAudienceModelPolicy

$result = $client->putConfiguredAudienceModelPolicy([/* ... */]);
$promise = $client->putConfiguredAudienceModelPolicyAsync([/* ... */]);

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

Parameter Syntax

$result = $client->putConfiguredAudienceModelPolicy([
    'configuredAudienceModelArn' => '<string>', // REQUIRED
    'configuredAudienceModelPolicy' => '<string>', // REQUIRED
    'policyExistenceCondition' => 'POLICY_MUST_EXIST|POLICY_MUST_NOT_EXIST',
    'previousPolicyHash' => '<string>',
]);

Parameter Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that the resource policy will govern.

configuredAudienceModelPolicy
Required: Yes
Type: string

The IAM resource policy.

policyExistenceCondition
Type: string

Use this to prevent unexpected concurrent modification of the policy.

previousPolicyHash
Type: string

A cryptographic hash of the contents of the policy used to prevent unexpected concurrent modification of the policy.

Result Syntax

[
    'configuredAudienceModelPolicy' => '<string>',
    'policyHash' => '<string>',
]

Result Details

Members
configuredAudienceModelPolicy
Required: Yes
Type: string

The IAM resource policy.

policyHash
Required: Yes
Type: string

A cryptographic hash of the contents of the policy used to prevent unexpected concurrent modification of the policy.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

PutMLConfiguration

$result = $client->putMLConfiguration([/* ... */]);
$promise = $client->putMLConfigurationAsync([/* ... */]);

Assigns information about an ML configuration.

Parameter Syntax

$result = $client->putMLConfiguration([
    'defaultOutputLocation' => [ // REQUIRED
        'destination' => [
            's3Destination' => [ // REQUIRED
                's3Uri' => '<string>', // REQUIRED
            ],
        ],
        'roleArn' => '<string>', // REQUIRED
    ],
    'membershipIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Members
defaultOutputLocation
Required: Yes
Type: MLOutputConfiguration structure

The default Amazon S3 location where ML output is stored for the specified member.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that is being configured.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

StartAudienceExportJob

$result = $client->startAudienceExportJob([/* ... */]);
$promise = $client->startAudienceExportJobAsync([/* ... */]);

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

Parameter Syntax

$result = $client->startAudienceExportJob([
    'audienceGenerationJobArn' => '<string>', // REQUIRED
    'audienceSize' => [ // REQUIRED
        'type' => 'ABSOLUTE|PERCENTAGE', // REQUIRED
        'value' => <integer>, // REQUIRED
    ],
    'description' => '<string>',
    'name' => '<string>', // REQUIRED
]);

Parameter Details

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job that you want to export.

audienceSize
Required: Yes
Type: AudienceSize structure

The size of the generated audience. Must match one of the sizes in the configured audience model.

description
Type: string

The description of the audience export job.

name
Required: Yes
Type: string

The name of the audience export job.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

StartAudienceGenerationJob

$result = $client->startAudienceGenerationJob([/* ... */]);
$promise = $client->startAudienceGenerationJobAsync([/* ... */]);

Information necessary to start the audience generation job.

Parameter Syntax

$result = $client->startAudienceGenerationJob([
    'collaborationId' => '<string>',
    'configuredAudienceModelArn' => '<string>', // REQUIRED
    'description' => '<string>',
    'includeSeedInOutput' => true || false,
    'name' => '<string>', // REQUIRED
    'seedAudience' => [ // REQUIRED
        'dataSource' => [
            's3Uri' => '<string>', // REQUIRED
        ],
        'roleArn' => '<string>', // REQUIRED
        'sqlComputeConfiguration' => [
            'worker' => [
                'number' => <integer>,
                'type' => 'CR.1X|CR.4X',
            ],
        ],
        'sqlParameters' => [
            'analysisTemplateArn' => '<string>',
            'parameters' => ['<string>', ...],
            'queryString' => '<string>',
        ],
    ],
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
collaborationId
Type: string

The identifier of the collaboration that contains the audience generation job.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that is used for this audience generation job.

description
Type: string

The description of the audience generation job.

includeSeedInOutput
Type: boolean

Whether the seed audience is included in the audience generation output.

name
Required: Yes
Type: string

The name of the audience generation job.

seedAudience
Required: Yes
Type: AudienceGenerationJobDataSource structure

The seed audience that is used to generate the audience.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

Result Syntax

[
    'audienceGenerationJobArn' => '<string>',
]

Result Details

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

StartTrainedModelExportJob

$result = $client->startTrainedModelExportJob([/* ... */]);
$promise = $client->startTrainedModelExportJobAsync([/* ... */]);

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

Parameter Syntax

$result = $client->startTrainedModelExportJob([
    'description' => '<string>',
    'membershipIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'outputConfiguration' => [ // REQUIRED
        'members' => [ // REQUIRED
            [
                'accountId' => '<string>', // REQUIRED
            ],
            // ...
        ],
    ],
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
description
Type: string

The description of the trained model export job.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that is receiving the exported trained model artifacts.

name
Required: Yes
Type: string

The name of the trained model export job.

outputConfiguration
Required: Yes
Type: TrainedModelExportOutputConfiguration structure

The output configuration information for the trained model export job.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that you want to export.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

StartTrainedModelInferenceJob

$result = $client->startTrainedModelInferenceJob([/* ... */]);
$promise = $client->startTrainedModelInferenceJobAsync([/* ... */]);

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

Parameter Syntax

$result = $client->startTrainedModelInferenceJob([
    'configuredModelAlgorithmAssociationArn' => '<string>',
    'containerExecutionParameters' => [
        'maxPayloadInMB' => <integer>,
    ],
    'dataSource' => [ // REQUIRED
        'mlInputChannelArn' => '<string>', // REQUIRED
    ],
    'description' => '<string>',
    'environment' => ['<string>', ...],
    'kmsKeyArn' => '<string>',
    'membershipIdentifier' => '<string>', // REQUIRED
    'name' => '<string>', // REQUIRED
    'outputConfiguration' => [ // REQUIRED
        'accept' => '<string>',
        'members' => [ // REQUIRED
            [
                'accountId' => '<string>', // REQUIRED
            ],
            // ...
        ],
    ],
    'resourceConfig' => [ // REQUIRED
        'instanceCount' => <integer>,
        'instanceType' => 'ml.r7i.48xlarge|ml.r6i.16xlarge|ml.m6i.xlarge|ml.m5.4xlarge|ml.p2.xlarge|ml.m4.16xlarge|ml.r7i.16xlarge|ml.m7i.xlarge|ml.m6i.12xlarge|ml.r7i.8xlarge|ml.r7i.large|ml.m7i.12xlarge|ml.m6i.24xlarge|ml.m7i.24xlarge|ml.r6i.8xlarge|ml.r6i.large|ml.g5.2xlarge|ml.m5.large|ml.p3.16xlarge|ml.m7i.48xlarge|ml.m6i.16xlarge|ml.p2.16xlarge|ml.g5.4xlarge|ml.m7i.16xlarge|ml.c4.2xlarge|ml.c5.2xlarge|ml.c6i.32xlarge|ml.c4.4xlarge|ml.g5.8xlarge|ml.c6i.xlarge|ml.c5.4xlarge|ml.g4dn.xlarge|ml.c7i.xlarge|ml.c6i.12xlarge|ml.g4dn.12xlarge|ml.c7i.12xlarge|ml.c6i.24xlarge|ml.g4dn.2xlarge|ml.c7i.24xlarge|ml.c7i.2xlarge|ml.c4.8xlarge|ml.c6i.2xlarge|ml.g4dn.4xlarge|ml.c7i.48xlarge|ml.c7i.4xlarge|ml.c6i.16xlarge|ml.c5.9xlarge|ml.g4dn.16xlarge|ml.c7i.16xlarge|ml.c6i.4xlarge|ml.c5.xlarge|ml.c4.xlarge|ml.g4dn.8xlarge|ml.c7i.8xlarge|ml.c7i.large|ml.g5.xlarge|ml.c6i.8xlarge|ml.c6i.large|ml.g5.12xlarge|ml.g5.24xlarge|ml.m7i.2xlarge|ml.c5.18xlarge|ml.g5.48xlarge|ml.m6i.2xlarge|ml.g5.16xlarge|ml.m7i.4xlarge|ml.p3.2xlarge|ml.r6i.32xlarge|ml.m6i.4xlarge|ml.m5.xlarge|ml.m4.10xlarge|ml.r6i.xlarge|ml.m5.12xlarge|ml.m4.xlarge|ml.r7i.2xlarge|ml.r7i.xlarge|ml.r6i.12xlarge|ml.m5.24xlarge|ml.r7i.12xlarge|ml.m7i.8xlarge|ml.m7i.large|ml.r6i.24xlarge|ml.r6i.2xlarge|ml.m4.2xlarge|ml.r7i.24xlarge|ml.r7i.4xlarge|ml.m6i.8xlarge|ml.m6i.large|ml.m5.2xlarge|ml.p2.8xlarge|ml.r6i.4xlarge|ml.m6i.32xlarge|ml.p3.8xlarge|ml.m4.4xlarge', // REQUIRED
    ],
    'tags' => ['<string>', ...],
    'trainedModelArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
configuredModelAlgorithmAssociationArn
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that is used for this trained model inference job.

containerExecutionParameters

The execution parameters for the container.

dataSource
Required: Yes
Type: ModelInferenceDataSource structure

Defines the data source that is used for the trained model inference job.

description
Type: string

The description of the trained model inference job.

environment
Type: Associative array of custom strings keys (InferenceEnvironmentMapKeyString) to strings

The environment variables to set in the Docker container.

kmsKeyArn
Type: string

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

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the trained model inference job.

name
Required: Yes
Type: string

The name of the trained model inference job.

outputConfiguration
Required: Yes
Type: InferenceOutputConfiguration structure

Defines the output configuration information for the trained model inference job.

resourceConfig
Required: Yes
Type: InferenceResourceConfig structure

Defines the resource configuration for the trained model inference job.

tags
Type: Associative array of custom strings keys (TagKey) to strings

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.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that is used for this trained model inference job.

Result Syntax

[
    'trainedModelInferenceJobArn' => '<string>',
]

Result Details

Members
trainedModelInferenceJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model inference job.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

ServiceQuotaExceededException:

You have exceeded your service quota.

TagResource

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Adds metadata tags to a specified resource.

Parameter Syntax

$result = $client->tagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource that you want to assign tags.

tags
Required: Yes
Type: Associative array of custom strings keys (TagKey) to strings

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 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.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

UntagResource

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes metadata tags from a specified resource.

Parameter Syntax

$result = $client->untagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource that you want to remove tags from.

tagKeys
Required: Yes
Type: Array of strings

The key values of tags that you want to remove.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

UpdateConfiguredAudienceModel

$result = $client->updateConfiguredAudienceModel([/* ... */]);
$promise = $client->updateConfiguredAudienceModelAsync([/* ... */]);

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.

Parameter Syntax

$result = $client->updateConfiguredAudienceModel([
    'audienceModelArn' => '<string>',
    'audienceSizeConfig' => [
        'audienceSizeBins' => [<integer>, ...], // REQUIRED
        'audienceSizeType' => 'ABSOLUTE|PERCENTAGE', // REQUIRED
    ],
    'configuredAudienceModelArn' => '<string>', // REQUIRED
    'description' => '<string>',
    'minMatchingSeedSize' => <integer>,
    'outputConfig' => [
        'destination' => [ // REQUIRED
            's3Destination' => [ // REQUIRED
                's3Uri' => '<string>', // REQUIRED
            ],
        ],
        'roleArn' => '<string>', // REQUIRED
    ],
    'sharedAudienceMetrics' => ['<string>', ...],
]);

Parameter Details

Members
audienceModelArn
Type: string

The Amazon Resource Name (ARN) of the new audience model that you want to use.

audienceSizeConfig
Type: AudienceSizeConfig structure

The new audience size configuration.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that you want to update.

description
Type: string

The new description of the configured audience model.

minMatchingSeedSize
Type: int

The minimum number of users from the seed audience that must match with users in the training data of the audience model.

outputConfig

The new output configuration.

sharedAudienceMetrics
Type: Array of strings

The new value for whether to share audience metrics.

Result Syntax

[
    'configuredAudienceModelArn' => '<string>',
]

Result Details

Members
configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that was updated.

Errors

ConflictException:

You can't complete this action because another resource depends on this resource.

ValidationException:

The request parameters for this request are incorrect.

AccessDeniedException:

You do not have sufficient access to perform this action.

ResourceNotFoundException:

The resource you are requesting does not exist.

Shapes

AccessDeniedException

Description

You do not have sufficient access to perform this action.

Members
message
Required: Yes
Type: string

AudienceDestination

Description

Defines the Amazon S3 bucket where the configured audience is stored.

Members
s3Destination
Required: Yes
Type: S3ConfigMap structure

The Amazon S3 bucket and path for the configured audience.

AudienceExportJobSummary

Description

Provides information about the audience export job.

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job that was exported.

audienceSize
Required: Yes
Type: AudienceSize structure

The size of the generated audience. Must match one of the sizes in the configured audience model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the audience export job was created.

description
Type: string

The description of the audience export job.

name
Required: Yes
Type: string

The name of the audience export job.

outputLocation
Type: string

The Amazon S3 bucket where the audience export is stored.

status
Required: Yes
Type: string

The status of the audience export job.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the audience export job was updated.

AudienceGenerationJobDataSource

Description

Defines the Amazon S3 bucket where the seed audience for the generating audience is stored.

Members
dataSource
Type: S3ConfigMap structure

Defines the Amazon S3 bucket where the seed audience for the generating audience is stored. A valid data source is a JSON line file in the following format:

{"user_id": "111111"}

{"user_id": "222222"}

...

roleArn
Required: Yes
Type: string

The ARN of the IAM role that can read the Amazon S3 bucket where the seed audience is stored.

sqlComputeConfiguration
Type: ComputeConfiguration structure

Provides configuration information for the instances that will perform the compute work.

sqlParameters
Type: ProtectedQuerySQLParameters structure

The protected SQL query parameters.

AudienceGenerationJobSummary

Description

Provides information about the configured audience generation job.

Members
audienceGenerationJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience generation job.

collaborationId
Type: string

The identifier of the collaboration that contains this audience generation job.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that was used for this audience generation job.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the audience generation job was created.

description
Type: string

The description of the audience generation job.

name
Required: Yes
Type: string

The name of the audience generation job.

startedBy
Type: string

The AWS Account that submitted the job.

status
Required: Yes
Type: string

The status of the audience generation job.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the audience generation job was updated.

AudienceModelSummary

Description

Information about the audience model.

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the audience model was created.

description
Type: string

The description of the audience model.

name
Required: Yes
Type: string

The name of the audience model.

status
Required: Yes
Type: string

The status of the audience model.

trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset that was used for the audience model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the audience model was updated.

AudienceQualityMetrics

Description

Metrics that describe the quality of the generated audience.

Members
recallMetric
Type: double

The recall score of the generated audience. Recall is the percentage of the most similar users (by default, the most similar 20%) from a sample of the training data that are included in the seed audience by the audience generation job. Values range from 0-1, larger values indicate a better audience. A recall value approximately equal to the maximum bin size indicates that the audience model is equivalent to random selection.

relevanceMetrics
Required: Yes
Type: Array of RelevanceMetric structures

The relevance scores of the generated audience.

AudienceSize

Description

The size of the generated audience. Must match one of the sizes in the configured audience model.

Members
type
Required: Yes
Type: string

Whether the audience size is defined in absolute terms or as a percentage. You can use the ABSOLUTE AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use the Percentage AudienceSize to configure sizes in the range 1-100 percent.

value
Required: Yes
Type: int

Specify an audience size value.

AudienceSizeConfig

Description

Returns the relevance scores at these audience sizes when used in the GetAudienceGenerationJob for a specified audience generation job and configured audience model.

Specifies the list of allowed audienceSize values when used in the StartAudienceExportJob for an audience generation job. You can use the ABSOLUTE AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use the Percentage AudienceSize to configure sizes in the range 1-100 percent.

Members
audienceSizeBins
Required: Yes
Type: Array of ints

An array of the different audience output sizes.

audienceSizeType
Required: Yes
Type: string

Whether the audience output sizes are defined as an absolute number or a percentage.

CollaborationConfiguredModelAlgorithmAssociationSummary

Description

Provides summary information about a configured model algorithm in a collaboration.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the configured model algorithm association.

configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that is associated to the collaboration.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm association was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member that created the configured model algorithm association.

description
Type: string

The description of the configured model algorithm association.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm association.

name
Required: Yes
Type: string

The name of the configured model algorithm association.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm association was updated.

CollaborationMLInputChannelSummary

Description

Provides summary information about an ML input channel in a collaboration.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channel.

configuredModelAlgorithmAssociations
Required: Yes
Type: Array of strings

The associated configured model algorithms used to create the ML input channel.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the ML input channel was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member who created the ML input channel.

description
Type: string

The description of the ML input channel.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel.

name
Required: Yes
Type: string

The name of the ML input channel.

status
Required: Yes
Type: string

The status of the ML input channel.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the ML input channel was updated.

CollaborationTrainedModelExportJobSummary

Description

Provides summary information about a trained model export job in a collaboration.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model export job.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model export job was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member that created the trained model.

description
Type: string

The description of the trained model.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model export job.

name
Required: Yes
Type: string

The name of the trained model export job.

outputConfiguration
Required: Yes
Type: TrainedModelExportOutputConfiguration structure

Information about the output of the trained model export job.

status
Required: Yes
Type: string

The status of the trained model.

statusDetails
Type: StatusDetails structure

Details about the status of a resource.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that is being exported.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model export job was updated.

CollaborationTrainedModelInferenceJobSummary

Description

Provides summary information about a trained model inference job in a collaboration.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model inference job.

configuredModelAlgorithmAssociationArn
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that is used for the trained model inference job.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model inference job was created.

creatorAccountId
Required: Yes
Type: string

The account ID that created the trained model inference job.

description
Type: string

The description of the trained model inference job.

logsStatus
Type: string

The trained model inference job logs status.

logsStatusDetails
Type: string

Details about the logs status for the trained model inference job.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the trained model inference job.

metricsStatus
Type: string

the trained model inference job metrics status.

metricsStatusDetails
Type: string

Details about the metrics status for trained model inference job.

name
Required: Yes
Type: string

The name of the trained model inference job.

outputConfiguration
Required: Yes
Type: InferenceOutputConfiguration structure

Returns output configuration information for the trained model inference job.

status
Required: Yes
Type: string

The status of the trained model inference job.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that is used for the trained model inference job.

trainedModelInferenceJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model inference job.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model inference job was updated.

CollaborationTrainedModelSummary

Description

Provides summary information about a trained model in a collaboration.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that is used for this trained model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model was created.

creatorAccountId
Required: Yes
Type: string

The account ID of the member that created the trained model.

description
Type: string

The description of the trained model.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model.

name
Required: Yes
Type: string

The name of the trained model.

status
Required: Yes
Type: string

The status of the trained model.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model was updated.

ColumnSchema

Description

Metadata for a column.

Members
columnName
Required: Yes
Type: string

The name of a column.

columnTypes
Required: Yes
Type: Array of strings

The data type of column.

ComputeConfiguration

Description

Provides configuration information for the instances that will perform the compute work.

Members
worker
Type: WorkerComputeConfiguration structure

The worker instances that will perform the compute work.

ConfiguredAudienceModelOutputConfig

Description

Configuration information necessary for the configure audience model output.

Members
destination
Required: Yes
Type: AudienceDestination structure

Defines the Amazon S3 bucket where the configured audience is stored.

roleArn
Required: Yes
Type: string

The ARN of the IAM role that can write the Amazon S3 bucket.

ConfiguredAudienceModelSummary

Description

Information about the configured audience model.

Members
audienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the audience model that was used to create the configured audience model.

configuredAudienceModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured audience model that you are interested in.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured audience model was created.

description
Type: string

The description of the configured audience model.

name
Required: Yes
Type: string

The name of the configured audience model.

outputConfig
Required: Yes
Type: ConfiguredAudienceModelOutputConfig structure

The output configuration of the configured audience model.

status
Required: Yes
Type: string

The status of the configured audience model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured audience model was updated.

ConfiguredModelAlgorithmAssociationSummary

Description

Provides summary information about the configured model algorithm association.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the configured model algorithm association.

configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm that is being associated.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm association was created.

description
Type: string

The description of the configured model algorithm association.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the configured model algorithm association.

name
Required: Yes
Type: string

The name of the configured model algorithm association.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm association was updated.

ConfiguredModelAlgorithmSummary

Description

Provides summary information about a configured model algorithm.

Members
configuredModelAlgorithmArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the configured model algorithm was created.

description
Type: string

The description of the configured model algorithm.

name
Required: Yes
Type: string

The name of the configured model algorithm.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the configured model algorithm was updated.

ConflictException

Description

You can't complete this action because another resource depends on this resource.

Members
message
Required: Yes
Type: string

ContainerConfig

Description

Provides configuration information for the dockerized container where the model algorithm is stored.

Members
arguments
Type: Array of strings

The arguments for a container used to run a training job. See How Amazon SageMaker Runs Your Training Image for additional information. For more information, see How Sagemaker runs your training image.

entrypoint
Type: Array of strings

The entrypoint script for a Docker container used to run a training job. This script takes precedence over the default train processing instructions. See How Amazon SageMaker Runs Your Training Image for additional information. For more information, see How Sagemaker runs your training image.

imageUri
Required: Yes
Type: string

The registry path of the docker image that contains the algorithm. Clean Rooms ML supports both registry/repository[:tag] and registry/repositry[@digest] image path formats. For more information about using images in Clean Rooms ML, see the Sagemaker API reference.

metricDefinitions
Type: Array of MetricDefinition structures

A list of metric definition objects. Each object specifies the metric name and regular expressions used to parse algorithm logs. Amazon Web Services Clean Rooms ML publishes each metric to all members' Amazon CloudWatch using IAM role configured in PutMLConfiguration.

DataSource

Description

Defines information about the Glue data source that contains the training data.

Members
glueDataSource
Required: Yes
Type: GlueDataSource structure

A GlueDataSource object that defines the catalog ID, database name, and table name for the training data.

Dataset

Description

Defines where the training dataset is located, what type of data it contains, and how to access the data.

Members
inputConfig
Required: Yes
Type: DatasetInputConfig structure

A DatasetInputConfig object that defines the data source and schema mapping.

type
Required: Yes
Type: string

What type of information is found in the dataset.

DatasetInputConfig

Description

Defines the Glue data source and schema mapping information.

Members
dataSource
Required: Yes
Type: DataSource structure

A DataSource object that specifies the Glue data source for the training data.

schema
Required: Yes
Type: Array of ColumnSchema structures

The schema information for the training data.

Destination

Description

The Amazon S3 location where the exported model artifacts are stored.

Members
s3Destination
Required: Yes
Type: S3ConfigMap structure

Provides information about an Amazon S3 bucket and path.

GlueDataSource

Description

Defines the Glue data source that contains the training data.

Members
catalogId
Type: string

The Glue catalog that contains the training data.

databaseName
Required: Yes
Type: string

The Glue database that contains the training data.

tableName
Required: Yes
Type: string

The Glue table that contains the training data.

InferenceContainerConfig

Description

Provides configuration information for the inference container.

Members
imageUri
Required: Yes
Type: string

The registry path of the docker image that contains the inference algorithm. Clean Rooms ML supports both registry/repository[:tag] and registry/repositry[@digest] image path formats. For more information about using images in Clean Rooms ML, see the Sagemaker API reference.

InferenceContainerExecutionParameters

Description

Provides execution parameters for the inference container.

Members
maxPayloadInMB
Type: int

The maximum size of the inference container payload, specified in MB.

InferenceOutputConfiguration

Description

Configuration information about how the inference output is stored.

Members
accept
Type: string

The MIME type used to specify the output data.

members
Required: Yes
Type: Array of InferenceReceiverMember structures

Defines the members that can receive inference output.

InferenceReceiverMember

Description

Defines who will receive inference results.

Members
accountId
Required: Yes
Type: string

The account ID of the member that can receive inference results.

InferenceResourceConfig

Description

Defines the resources used to perform model inference.

Members
instanceCount
Type: int

The number of instances to use.

instanceType
Required: Yes
Type: string

The type of instance that is used to perform model inference.

InputChannel

Description

Provides information about the data source that is used to create an ML input channel.

Members
dataSource
Required: Yes
Type: InputChannelDataSource structure

The data source that is used to create the ML input channel.

roleArn
Required: Yes
Type: string

The ARN of the IAM role that Clean Rooms ML can assume to read the data referred to in the dataSource field the input channel.

Passing a role across AWS accounts is not allowed. If you pass a role that isn't in your account, you get an AccessDeniedException error.

InputChannelDataSource

Description

Provides the data source that is used to define an input channel.

Members
protectedQueryInputParameters

Provides information necessary to perform the protected query.

LogsConfigurationPolicy

Description

Provides the information necessary for a user to access the logs.

Members
allowedAccountIds
Required: Yes
Type: Array of strings

A list of account IDs that are allowed to access the logs.

filterPattern
Type: string

A regular expression pattern that is used to parse the logs and return information that matches the pattern.

MLInputChannelSummary

Description

Provides summary information about the ML input channel.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the ML input channel.

configuredModelAlgorithmAssociations
Required: Yes
Type: Array of strings

The associated configured model algorithms used to create the ML input channel.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the ML input channel was created.

description
Type: string

The description of the ML input channel.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the ML input channel.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel.

name
Required: Yes
Type: string

The name of the ML input channel.

protectedQueryIdentifier
Type: string

The ID of the protected query that was used to create the ML input channel.

status
Required: Yes
Type: string

The status of the ML input channel.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the ML input channel was updated.

MLOutputConfiguration

Description

Configuration information about how the exported model artifacts are stored.

Members
destination
Type: Destination structure

The Amazon S3 location where exported model artifacts are stored.

roleArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the service access role that is used to store the model artifacts.

MetricDefinition

Description

Information about the model metric that is reported for a trained model.

Members
name
Required: Yes
Type: string

The name of the model metric.

regex
Required: Yes
Type: string

The regular expression statement that defines how the model metric is reported.

MetricsConfigurationPolicy

Description

Provides the configuration policy for metrics generation.

Members
noiseLevel
Required: Yes
Type: string

The noise level for the generated metrics.

ModelInferenceDataSource

Description

Defines information about the data source used for model inference.

Members
mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel for this model inference data source.

ModelTrainingDataChannel

Description

Information about the model training data channel. A training data channel is a named data source that the training algorithms can consume.

Members
channelName
Required: Yes
Type: string

The name of the training data channel.

mlInputChannelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the ML input channel for this model training data channel.

PrivacyConfiguration

Description

Information about the privacy configuration for a configured model algorithm association.

Members
policies
Required: Yes
Type: PrivacyConfigurationPolicies structure

The privacy configuration policies for a configured model algorithm association.

PrivacyConfigurationPolicies

Description

Information about the privacy configuration policies for a configured model algorithm association.

Members
trainedModelExports

Specifies who will receive the trained model export.

trainedModelInferenceJobs

Specifies who will receive the trained model inference jobs.

trainedModels

Specifies who will receive the trained models.

ProtectedQueryInputParameters

Description

Provides information necessary to perform the protected query.

Members
computeConfiguration
Type: ComputeConfiguration structure

Provides configuration information for the workers that will perform the protected query.

sqlParameters
Required: Yes
Type: ProtectedQuerySQLParameters structure

The parameters for the SQL type Protected Query.

ProtectedQuerySQLParameters

Description

The parameters for the SQL type Protected Query.

Members
analysisTemplateArn
Type: string

The Amazon Resource Name (ARN) associated with the analysis template within a collaboration.

parameters
Type: Associative array of custom strings keys (ParameterKey) to strings

The protected query SQL parameters.

queryString
Type: string

The query string to be submitted.

RelevanceMetric

Description

The relevance score of a generated audience.

Members
audienceSize
Required: Yes
Type: AudienceSize structure

The size of the generated audience. Must match one of the sizes in the configured audience model.

score
Type: double

The relevance score of the generated audience.

ResourceConfig

Description

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

Members
instanceCount
Type: int

The number of resources that are used to train the model.

instanceType
Required: Yes
Type: string

The instance type that is used to train the model.

volumeSizeInGB
Required: Yes
Type: int

The maximum size of the instance that is used to train the model.

ResourceNotFoundException

Description

The resource you are requesting does not exist.

Members
message
Required: Yes
Type: string

S3ConfigMap

Description

Provides information about an Amazon S3 bucket and path.

Members
s3Uri
Required: Yes
Type: string

The Amazon S3 location URI.

ServiceQuotaExceededException

Description

You have exceeded your service quota.

Members
message
Required: Yes
Type: string

StatusDetails

Description

Details about the status of a resource.

Members
message
Type: string

The error message that was returned. The message is intended for human consumption and can change at any time. Use the statusCode for programmatic error handling.

statusCode
Type: string

The status code that was returned. The status code is intended for programmatic error handling. Clean Rooms ML will not change the status code for existing error conditions.

StoppingCondition

Description

The criteria used to stop model training.

Members
maxRuntimeInSeconds
Type: int

The maximum amount of time, in seconds, that model training can run before it is terminated.

TrainedModelExportOutputConfiguration

Description

Information about the output of the trained model export job.

Members
members
Required: Yes
Type: Array of TrainedModelExportReceiverMember structures

The members that will received the exported trained model output.

TrainedModelExportReceiverMember

Description

Provides information about the member who will receive trained model exports.

Members
accountId
Required: Yes
Type: string

The account ID of the member who will receive trained model exports.

TrainedModelExportsConfigurationPolicy

Description

Information about how the trained model exports are configured.

Members
filesToExport
Required: Yes
Type: Array of strings

The files that are exported during the trained model export job.

maxSize
Required: Yes
Type: TrainedModelExportsMaxSize structure

The maximum size of the data that can be exported.

TrainedModelExportsMaxSize

Description

The maximum size of the trained model metrics that can be exported. If the trained model metrics dataset is larger than this value, it will not be exported.

Members
unit
Required: Yes
Type: string

The unit of measurement for the data size.

value
Required: Yes
Type: double

The maximum size of the dataset to export.

TrainedModelInferenceJobSummary

Description

Provides information about the trained model inference job.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model inference job.

configuredModelAlgorithmAssociationArn
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that is used for the trained model inference job.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model inference job was created.

description
Type: string

The description of the trained model inference job.

logsStatus
Type: string

The log status of the trained model inference job.

logsStatusDetails
Type: string

Details about the log status for the trained model inference job.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the membership that contains the trained model inference job.

metricsStatus
Type: string

The metric status of the trained model inference job.

metricsStatusDetails
Type: string

Details about the metrics status for the trained model inference job.

name
Required: Yes
Type: string

The name of the trained model inference job.

outputConfiguration
Required: Yes
Type: InferenceOutputConfiguration structure

The output configuration information of the trained model job.

status
Required: Yes
Type: string

The status of the trained model inference job.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model that is used for the trained model inference job.

trainedModelInferenceJobArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model inference job.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model inference job was updated.

TrainedModelInferenceJobsConfigurationPolicy

Description

Provides configuration information for the trained model inference job.

Members
containerLogs
Type: Array of LogsConfigurationPolicy structures

The logs container for the trained model inference job.

maxOutputSize

The maximum allowed size of the output of the trained model inference job.

TrainedModelInferenceMaxOutputSize

Description

Information about the maximum output size for a trained model inference job.

Members
unit
Required: Yes
Type: string

The measurement unit to use.

value
Required: Yes
Type: double

The maximum output size value.

TrainedModelSummary

Description

Summary information about the trained model.

Members
collaborationIdentifier
Required: Yes
Type: string

The collaboration ID of the collaboration that contains the trained model.

configuredModelAlgorithmAssociationArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the configured model algorithm association that was used to create this trained model.

createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the trained model was created.

description
Type: string

The description of the trained model.

membershipIdentifier
Required: Yes
Type: string

The membership ID of the member that created the trained model.

name
Required: Yes
Type: string

The name of the trained model.

status
Required: Yes
Type: string

The status of the trained model.

trainedModelArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the trained model.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the trained model was updated.

TrainedModelsConfigurationPolicy

Description

The configuration policy for the trained models.

Members
containerLogs
Type: Array of LogsConfigurationPolicy structures

The container for the logs of the trained model.

containerMetrics
Type: MetricsConfigurationPolicy structure

The container for the metrics of the trained model.

TrainingDatasetSummary

Description

Provides information about the training dataset.

Members
createTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time at which the training dataset was created.

description
Type: string

The description of the training dataset.

name
Required: Yes
Type: string

The name of the training dataset.

status
Required: Yes
Type: string

The status of the training dataset.

trainingDatasetArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the training dataset.

updateTime
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The most recent time at which the training dataset was updated.

ValidationException

Description

The request parameters for this request are incorrect.

Members
message
Required: Yes
Type: string

WorkerComputeConfiguration

Description

Configuration information about the compute workers that perform the transform job.

Members
number
Type: int

The number of compute workers that are used.

type
Type: string

The instance type of the compute workers that are used.