# ReplicationTaskAssessmentRun
<a name="API_ReplicationTaskAssessmentRun"></a>

Provides information that describes a premigration assessment run that you have started using the `StartReplicationTaskAssessmentRun` operation.

Some of the information appears based on other operations that can return the `ReplicationTaskAssessmentRun` object.

## Contents
<a name="API_ReplicationTaskAssessmentRun_Contents"></a>

 ** AssessmentProgress **   <a name="DMS-Type-ReplicationTaskAssessmentRun-AssessmentProgress"></a>
Indication of the completion progress for the individual assessments specified to run.  
Type: [ReplicationTaskAssessmentRunProgress](API_ReplicationTaskAssessmentRunProgress.md) object  
Required: No

 ** AssessmentRunName **   <a name="DMS-Type-ReplicationTaskAssessmentRun-AssessmentRunName"></a>
Unique name of the assessment run.  
Type: String  
Required: No

 ** IsLatestTaskAssessmentRun **   <a name="DMS-Type-ReplicationTaskAssessmentRun-IsLatestTaskAssessmentRun"></a>
Indicates that the following PreflightAssessmentRun is the latest for the ReplicationTask. The status is either true or false.  
Type: Boolean  
Required: No

 ** LastFailureMessage **   <a name="DMS-Type-ReplicationTaskAssessmentRun-LastFailureMessage"></a>
Last message generated by an individual assessment failure.  
Type: String  
Required: No

 ** ReplicationTaskArn **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ReplicationTaskArn"></a>
ARN of the migration task associated with this premigration assessment run.  
Type: String  
Required: No

 ** ReplicationTaskAssessmentRunArn **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ReplicationTaskAssessmentRunArn"></a>
Amazon Resource Name (ARN) of this assessment run.  
Type: String  
Required: No

 ** ReplicationTaskAssessmentRunCreationDate **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ReplicationTaskAssessmentRunCreationDate"></a>
Date on which the assessment run was created using the `StartReplicationTaskAssessmentRun` operation.  
Type: Timestamp  
Required: No

 ** ResultEncryptionMode **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ResultEncryptionMode"></a>
Encryption mode used to encrypt the assessment run results.  
Type: String  
Required: No

 ** ResultKmsKeyArn **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ResultKmsKeyArn"></a>
ARN of the AWS KMS encryption key used to encrypt the assessment run results.  
Type: String  
Required: No

 ** ResultLocationBucket **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ResultLocationBucket"></a>
Amazon S3 bucket where AWS DMS stores the results of this assessment run.  
Type: String  
Required: No

 ** ResultLocationFolder **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ResultLocationFolder"></a>
Folder in an Amazon S3 bucket where AWS DMS stores the results of this assessment run.  
Type: String  
Required: No

 ** ResultStatistic **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ResultStatistic"></a>
 Result statistics for a completed assessment run, showing aggregated statistics of IndividualAssessments for how many assessments were passed, failed, or encountered issues such as errors or warnings.   
Type: [ReplicationTaskAssessmentRunResultStatistic](API_ReplicationTaskAssessmentRunResultStatistic.md) object  
Required: No

 ** ServiceAccessRoleArn **   <a name="DMS-Type-ReplicationTaskAssessmentRun-ServiceAccessRoleArn"></a>
ARN of the service role used to start the assessment run using the `StartReplicationTaskAssessmentRun` operation. The role must allow the `iam:PassRole` action.  
Type: String  
Required: No

 ** Status **   <a name="DMS-Type-ReplicationTaskAssessmentRun-Status"></a>
Assessment run status.   
This status can have one of the following values:  
+  `"cancelling"` – The assessment run was canceled by the `CancelReplicationTaskAssessmentRun` operation.
+  `"deleting"` – The assessment run was deleted by the `DeleteReplicationTaskAssessmentRun` operation.
+  `"failed"` – At least one individual assessment completed with a `failed` status.
+  `"error-provisioning"` – An internal error occurred while resources were provisioned (during `provisioning` status).
+  `"error-executing"` – An internal error occurred while individual assessments ran (during `running` status).
+  `"invalid state"` – The assessment run is in an unknown state.
+  `"passed"` – All individual assessments have completed, and none has a `failed` status.
+  `"provisioning"` – Resources required to run individual assessments are being provisioned.
+  `"running"` – Individual assessments are being run.
+  `"starting"` – The assessment run is starting, but resources are not yet being provisioned for individual assessments.
+  `"warning"` – At least one individual assessment completed with a `warning` status or all individual assessments were skipped (completed with a `skipped` status).
Type: String  
Required: No

## See Also
<a name="API_ReplicationTaskAssessmentRun_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/dms-2016-01-01/ReplicationTaskAssessmentRun) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/dms-2016-01-01/ReplicationTaskAssessmentRun) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/dms-2016-01-01/ReplicationTaskAssessmentRun)