Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

describe_migration_task

MigrationHub.Client.describe_migration_task(**kwargs)

Retrieves a list of all attributes associated with a specific migration task.

See also: AWS API Documentation

Request Syntax

response = client.describe_migration_task(
    ProgressUpdateStream='string',
    MigrationTaskName='string'
)
Parameters
  • ProgressUpdateStream (string) --

    [REQUIRED]

    The name of the ProgressUpdateStream.

  • MigrationTaskName (string) --

    [REQUIRED]

    The identifier given to the MigrationTask. Do not store personal data in this field.

Return type

dict

Returns

Response Syntax

{
    'MigrationTask': {
        'ProgressUpdateStream': 'string',
        'MigrationTaskName': 'string',
        'Task': {
            'Status': 'NOT_STARTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED',
            'StatusDetail': 'string',
            'ProgressPercent': 123
        },
        'UpdateDateTime': datetime(2015, 1, 1),
        'ResourceAttributeList': [
            {
                'Type': 'IPV4_ADDRESS'|'IPV6_ADDRESS'|'MAC_ADDRESS'|'FQDN'|'VM_MANAGER_ID'|'VM_MANAGED_OBJECT_REFERENCE'|'VM_NAME'|'VM_PATH'|'BIOS_ID'|'MOTHERBOARD_SERIAL_NUMBER',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • MigrationTask (dict) --

      Object encapsulating information about the migration task.

      • ProgressUpdateStream (string) --

        A name that identifies the vendor of the migration tool being used.

      • MigrationTaskName (string) --

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

      • Task (dict) --

        Task object encapsulating task information.

        • Status (string) --

          Status of the task - Not Started, In-Progress, Complete.

        • StatusDetail (string) --

          Details of task status as notified by a migration tool. A tool might use this field to provide clarifying information about the status that is unique to that tool or that explains an error state.

        • ProgressPercent (integer) --

          Indication of the percentage completion of the task.

      • UpdateDateTime (datetime) --

        The timestamp when the task was gathered.

      • ResourceAttributeList (list) --

        Information about the resource that is being migrated. This data will be used to map the task to a resource in the Application Discovery Service repository.

        • (dict) --

          Attribute associated with a resource.

          Note the corresponding format required per type listed below:

          IPV4

          x.x.x.x

          where x is an integer in the range [0,255]

          IPV6

          y : y : y : y : y : y : y : y

          where y is a hexadecimal between 0 and FFFF. [0, FFFF]

          MAC_ADDRESS

          ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$

          FQDN

          ^[^<>{}\\\\/?,=\\p{Cntrl}]{1,256}$

          • Type (string) --

            Type of resource.

          • Value (string) --

            Value of the resource type.

Exceptions

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