AWS Clean Rooms ML 2023-09-06
- 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
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
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 theABSOLUTE
AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use thePercentage
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 specifyFROM_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
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
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
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
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
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
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
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
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
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
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 firstminimumSeedSize
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
-
- Type: AudienceGenerationJobDataSource structure
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 theABSOLUTE
AudienceSize to configure out audience sizes using the count of identifiers in the output. You can use thePercentage
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
-
- Type: InferenceContainerExecutionParameters structure
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
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
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
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
-
- Type: InferenceContainerExecutionParameters structure
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
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
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
-
- Type: ConfiguredAudienceModelOutputConfig structure
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 thePercentage
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]
andregistry/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]
andregistry/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
-
- Type: ProtectedQueryInputParameters structure
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
-
- Type: TrainedModelExportsConfigurationPolicy structure
Specifies who will receive the trained model export.
- trainedModelInferenceJobs
-
- Type: TrainedModelInferenceJobsConfigurationPolicy structure
Specifies who will receive the trained model inference jobs.
- trainedModels
-
- Type: TrainedModelsConfigurationPolicy structure
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
-
- Type: TrainedModelInferenceMaxOutputSize structure
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.