AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Starts an import task, which allows you to import details of your on-premises environment directly into Amazon Web Services Migration Hub without having to use the Amazon Web Services Application Discovery Service (Application Discovery Service) tools such as the Amazon Web Services Application Discovery Service Agentless Collector or Application Discovery Agent. This gives you the option to perform migration assessment and planning directly from your imported data, including the ability to group your devices as applications and track their migration status.

To start an import request, do this:

  1. Download the specially formatted comma separated value (CSV) import template, which you can find here: https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv.

  2. Fill out the template with your server and application data.

  3. Upload your import file to an Amazon S3 bucket, and make a note of it's Object URL. Your import file must be in the CSV format.

  4. Use the console or the StartImportTask command with the Amazon Web Services CLI or one of the Amazon Web Services SDKs to import the records from your file.

For more information, including step-by-step procedures, see Migration Hub Import in the Amazon Web Services Application Discovery Service User Guide.

There are limits to the number of import tasks you can create (and delete) in an Amazon Web Services account. For more information, see Amazon Web Services Application Discovery Service Limits in the Amazon Web Services Application Discovery Service User Guide.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginStartImportTask and EndStartImportTask.

Namespace: Amazon.ApplicationDiscoveryService
Assembly: AWSSDK.ApplicationDiscoveryService.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<StartImportTaskResponse> StartImportTaskAsync(
         StartImportTaskRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ApplicationDiscoveryService.Model.StartImportTaskRequest

Container for the necessary parameters to execute the StartImportTask service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the StartImportTask service method, as returned by ApplicationDiscoveryService.

Exceptions

ExceptionCondition
AuthorizationErrorException The user does not have permission to perform the action. Check the IAM policy associated with this user.
HomeRegionNotSetException The home Region is not set. Set the home Region to continue.
InvalidParameterException One or more parameters are not valid. Verify the parameters and try again.
InvalidParameterValueException The value of one or more parameters are either invalid or out of range. Verify the parameter values and try again.
ResourceInUseException This issue occurs when the same clientRequestToken is used with the StartImportTask action, but with different parameters. For example, you use the same request token but have two different import URLs, you can encounter this issue. If the import tasks are meant to be different, use a different clientRequestToken, and try again.
ServerInternalErrorException The server experienced an internal error. Try again.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also