---
title: "GET /collaborations/{collaborationIdentifier}/trained-models/{trainedModelArn}"
method: GET
path: "/collaborations/{collaborationIdentifier}/trained-models/{trainedModelArn}"
---

# GET /collaborations/{collaborationIdentifier}/trained-models/{trainedModelArn}

`GET /collaborations/{collaborationIdentifier}/trained-models/{trainedModelArn}`

Returns information about a trained model in a collaboration.

## Path parameters

- `trainedModelArn` string, required
- `collaborationIdentifier` string, required

## Query parameters

- `versionIdentifier` string

## Response `200`

Success

- GetCollaborationTrainedModelResponse
  - `membershipIdentifier` string, required — The membership ID of the member that created the trained model.
  - `collaborationIdentifier` string, required — The collaboration ID of the collaboration that contains the trained model.
  - `trainedModelArn` string, required — The Amazon Resource Name (ARN) of the trained model.
  - `versionIdentifier` string — The version identifier of the trained model. This unique identifier distinguishes this version from other versions of the same trained model.
  - `incrementalTrainingDataChannels` IncrementalTrainingDataChannelOutput[] — Information about the incremental training data channels used to create this version of the trained model. This includes details about the base model that was used for incremental training and the channel configuration.
    - `channelName` string, required — The name of the incremental training data channel that was used.
    - `versionIdentifier` string — The version identifier of the trained model that was used for incremental training.
    - `modelName` string, required — The name of the base trained model that was used for incremental training.
  - `name` string, required — The name of the trained model.
  - `description` string — The description of the trained model.
  - `status` 'CREATE_PENDING' | 'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'ACTIVE' | 'DELETE_PENDING' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED' | 'INACTIVE' | 'CANCEL_PENDING' | 'CANCEL_IN_PROGRESS' | 'CANCEL_FAILED', required — The status of the trained model.
  - `statusDetails` StatusDetails — Details about the status of a resource.
    - `statusCode` 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.
    - `message` string — The error message that was returned. The message is intended for human consumption and can change at any time. Use the <code>statusCode</code> for programmatic error handling.
  - `configuredModelAlgorithmAssociationArn` string, required — The Amazon Resource Name (ARN) of the configured model algorithm association that was used to create this trained model.
  - `resourceConfig` object — The EC2 resource configuration that was used to train this model.
    - `instanceCount` integer — The number of resources that are used to train the model.
    - `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.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' | 'ml.c7i.large' | 'ml.c7i.xlarge' | 'ml.c7i.2xlarge' | 'ml.c7i.4xlarge' | 'ml.c7i.8xlarge' | 'ml.c7i.12xlarge' | 'ml.c7i.16xlarge' | 'ml.c7i.24xlarge' | 'ml.c7i.48xlarge' | 'ml.m7i.large' | 'ml.m7i.xlarge' | 'ml.m7i.2xlarge' | 'ml.m7i.4xlarge' | 'ml.m7i.8xlarge' | 'ml.m7i.12xlarge' | 'ml.m7i.16xlarge' | 'ml.m7i.24xlarge' | 'ml.m7i.48xlarge' | 'ml.r7i.large' | 'ml.r7i.xlarge' | 'ml.r7i.2xlarge' | 'ml.r7i.4xlarge' | 'ml.r7i.8xlarge' | 'ml.r7i.12xlarge' | 'ml.r7i.16xlarge' | 'ml.r7i.24xlarge' | 'ml.r7i.48xlarge' | 'ml.g6.xlarge' | 'ml.g6.2xlarge' | 'ml.g6.4xlarge' | 'ml.g6.8xlarge' | 'ml.g6.12xlarge' | 'ml.g6.16xlarge' | 'ml.g6.24xlarge' | 'ml.g6.48xlarge' | 'ml.g6e.xlarge' | 'ml.g6e.2xlarge' | 'ml.g6e.4xlarge' | 'ml.g6e.8xlarge' | 'ml.g6e.12xlarge' | 'ml.g6e.16xlarge' | 'ml.g6e.24xlarge' | 'ml.g6e.48xlarge' | 'ml.p5en.48xlarge' | 'ml.p3.2xlarge' | 'ml.p3.8xlarge' | 'ml.p3.16xlarge' | 'ml.p3dn.24xlarge', required — The instance type that is used to train the model.
    - `volumeSizeInGB` integer, required — The volume size of the instance that is used to train the model. Please see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-store-volumes.html">EC2 volume limit</a> for volume size limitations on different instance types.
  - `trainingInputMode` 'File' | 'FastFile' | 'Pipe' — The input mode that was used for accessing the training data when this trained model was created. This indicates how the training data was made available to the training algorithm.
  - `stoppingCondition` object — The stopping condition that determined when model training ended.
    - `maxRuntimeInSeconds` integer — The maximum amount of time, in seconds, that model training can run before it is terminated.
  - `metricsStatus` 'PUBLISH_SUCCEEDED' | 'PUBLISH_FAILED' — The status of the model metrics.
  - `metricsStatusDetails` string — Details about the status information for the model metrics.
  - `logsStatus` 'PUBLISH_SUCCEEDED' | 'PUBLISH_FAILED' — Status information for the logs.
  - `logsStatusDetails` string — Details about the status information for the logs.
  - `trainingContainerImageDigest` string — Information about the training container image.
  - `mlModelTrainingPayerAccountId` string — The account ID of the member that is responsible for paying for model training costs.
  - `createTime` string, date-time, required — The time at which the trained model was created.
  - `updateTime` string, date-time, required — The most recent time at which the trained model was updated.
  - `creatorAccountId` string, required — The account ID of the member that created the trained model.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/cleanroomsml.md) · [All operations](https://skmtc.net/aws/apis/cleanroomsml/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cleanroomsml/versions/d3bb6d6eaa9a/schema)