list_migration_tasks

list_migration_tasks(**kwargs)

Lists all, or filtered by resource name, migration tasks associated with the user account making this call. This API has the following traits:

  • Can show a summary list of the most recent migration tasks.
  • Can show a summary list of migration tasks associated with a given discovered resource.
  • Lists migration tasks in a paginated interface.

See also: AWS API Documentation

Request Syntax

response = client.list_migration_tasks(
    NextToken='string',
    MaxResults=123,
    ResourceName='string'
)
Parameters
  • NextToken (string) -- If a NextToken was returned by a previous call, there are more results available. To retrieve the next page of results, make the call again using the returned token in NextToken .
  • MaxResults (integer) -- Value to specify how many results are returned per page.
  • ResourceName (string) -- Filter migration tasks by discovered resource name.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'MigrationTaskSummaryList': [
        {
            'ProgressUpdateStream': 'string',
            'MigrationTaskName': 'string',
            'Status': 'NOT_STARTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED',
            'ProgressPercent': 123,
            'StatusDetail': 'string',
            'UpdateDateTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      If there are more migration tasks than the max result, return the next token to be passed to the next call as a bookmark of where to start from.

    • MigrationTaskSummaryList (list) --

      Lists the migration task's summary which includes: MigrationTaskName , ProgressPercent , ProgressUpdateStream , Status , and the UpdateDateTime for each task.

      • (dict) --

        MigrationTaskSummary includes MigrationTaskName , ProgressPercent , ProgressUpdateStream , Status , and UpdateDateTime for each task.

        • ProgressUpdateStream (string) --

          An AWS resource used for access control. It should uniquely identify the migration tool as it is used for all updates made by the tool.

        • MigrationTaskName (string) --

          Unique identifier that references the migration task. Do not store personal data in this field.

        • Status (string) --

          Status of the task.

        • ProgressPercent (integer) --

          Indication of the percentage completion of the task.

        • StatusDetail (string) --

          Detail information of what is being done within the overall status state.

        • UpdateDateTime (datetime) --

          The timestamp when the task was gathered.

Exceptions

  • MigrationHub.Client.exceptions.AccessDeniedException
  • MigrationHub.Client.exceptions.ThrottlingException
  • MigrationHub.Client.exceptions.InternalServerError
  • MigrationHub.Client.exceptions.ServiceUnavailableException
  • MigrationHub.Client.exceptions.InvalidInputException
  • MigrationHub.Client.exceptions.PolicyErrorException
  • MigrationHub.Client.exceptions.ResourceNotFoundException
  • MigrationHub.Client.exceptions.HomeRegionNotSetException