imports

Creates, updates, deletes, gets or lists an imports resource.

Overview

Name	imports
Type	Resource
Id	aws.mgn.imports

Fields

The following fields are returned by SELECT queries:

list_imports

Name	Datatype	Description
arn	string	ImportTask arn.
creation_date_time	string	Import task creation datetime. (pattern: <code>[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](.[0-9]+)?Z</code>)
end_date_time	string	Import task end datetime. (pattern: <code>[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](.[0-9]+)?Z</code>)
import_id	string	Import task id. (pattern: <code>import-[0-9a-zA-Z]{17}</code>)
progress_percentage	number (float)	Import task progress percentage.
s_3_bucket_source	object	Import task s3 bucket source.
status	string	Import task status. (PENDING, STARTED, FAILED, SUCCEEDED)
summary	object	Import task summary.
tags	object	Import task tags.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_imports	select	region		List imports.
start_import_file_enrichment	exec	region, s3BucketSource, s3BucketTarget		Starts an import file enrichment job to process and enrich network migration import files with additional metadata and IP assignment strategies.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

list_imports

List imports.

SELECT
arn,
creation_date_time,
end_date_time,
import_id,
progress_percentage,
s_3_bucket_source,
status,
summary,
tags
FROM aws.mgn.imports
WHERE region = '{{ region }}' -- required
;

Lifecycle Methods

start_import_file_enrichment

Starts an import file enrichment job to process and enrich network migration import files with additional metadata and IP assignment strategies.

EXEC aws.mgn.imports.start_import_file_enrichment 
@region='{{ region }}' --required 
@@json=
'{
"clientToken": "{{ clientToken }}", 
"s3BucketSource": "{{ s3BucketSource }}", 
"s3BucketTarget": "{{ s3BucketTarget }}", 
"ipAssignmentStrategy": "{{ ipAssignmentStrategy }}"
}'
;