Request Syntax Request Parameters Response Syntax Response Elements Errors Examples See Also

DescribeApplicableIndividualAssessments

Provides a list of individual assessments that you can specify for a new premigration assessment run, given one or more parameters.

If you specify an existing migration task, this operation provides the default individual assessments you can specify for that task. Otherwise, the specified parameters model elements of a possible migration task on which to base a premigration assessment run.

To use these migration task modeling parameters, you must specify an existing replication instance, a source database engine, a target database engine, and a migration type. This combination of parameters potentially limits the default individual assessments available for an assessment run created for a corresponding migration task.

If you specify no parameters, this operation provides a list of all possible individual assessments that you can specify for an assessment run. If you specify any one of the task modeling parameters, you must specify all of them or the operation cannot provide a list of individual assessments. The only parameter that you can specify alone is for an existing migration task. The specified task definition then determines the default list of individual assessments that you can specify in an assessment run for the task.

Request Syntax


{
   "Marker": "string",
   "MaxRecords": number,
   "MigrationType": "string",
   "ReplicationInstanceArn": "string",
   "ReplicationTaskArn": "string",
   "SourceEngineName": "string",
   "TargetEngineName": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

Marker

Optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

Required: No

MaxRecords

Maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Type: Integer

Required: No

MigrationType

Name of the migration type that each provided individual assessment must support.

Type: String

Valid Values: full-load | cdc | full-load-and-cdc

Required: No

ReplicationInstanceArn

ARN of a replication instance on which you want to base the default list of individual assessments.

Type: String

Required: No

ReplicationTaskArn

Amazon Resource Name (ARN) of a migration task on which you want to base the default list of individual assessments.

Type: String

Required: No

SourceEngineName

Name of a database engine that the specified replication instance supports as a source.

Type: String

Required: No

TargetEngineName

Name of a database engine that the specified replication instance supports as a target.

Type: String

Required: No

Response Syntax


{
   "IndividualAssessmentNames": [ "string" ],
   "Marker": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

IndividualAssessmentNames

List of names for the individual assessments supported by the premigration assessment run that you start based on the specified request parameters. For more information on the available individual assessments, including compatibility with different migration task configurations, see Working with premigration assessment runs in the Amazon Database Migration Service User Guide.

Type: Array of strings

Marker

Pagination token returned for you to pass to a subsequent request. If you pass this token as the Marker value in a subsequent request, the response includes only records beyond the marker, up to the value specified in the request by MaxRecords.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedFault

Amazon DMS was denied access to the endpoint. Check that the role is correctly configured.

HTTP Status Code: 400

InvalidResourceStateFault

The resource is in a state that prevents it from being used for database migration.

HTTP Status Code: 400

ResourceNotFoundFault

The resource could not be found.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of DescribeApplicableIndividualAssessments.

Sample Request



POST / HTTP/1.1
Host: dms.<region>.<domain>
x-amz-Date: <Date>
Authorization: AWS4-HMAC-SHA256
Credential=<Credential>,
SignedHeaders=contenttype;date;host;user-
agent;x-amz-date;x-amz-target;x-amzn-
requestid,Signature=<Signature>
User-Agent: <UserAgentString>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive
X-Amz-Target: AmazonDMSv20160101.DescribeApplicableIndividualAssessments
{
  "SourceEngineName": "oracle",
  "TargetEngineName": "postgres",
  "MigrationType": "full-load",
  "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789023:rep:LPIXGJNGKAMDWSAESJNDNECHHZMKBS5OG3H5RVB"
}

Sample Response



HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Date: <Date>
{
  "IndividualAssessmentNames": [
    "full-lob-not-nullable-at-target",
    "table-with-lob-but-without-primary-key-or-unique-constraint",
    "unsupported-data-types-in-source"
  ]
}