MigrationHubOrchestrator / Client / get_workflow_step

get_workflow_step

MigrationHubOrchestrator.Client.get_workflow_step(**kwargs)

Get a step in the migration workflow.

See also: AWS API Documentation

Request Syntax

response = client.get_workflow_step(
    workflowId='string',
    stepGroupId='string',
    id='string'
)

Parameters:

• workflowId (string) –

  [REQUIRED]

  The ID of the migration workflow.

• stepGroupId (string) –

  [REQUIRED]

  The ID of the step group.

• id (string) –

  [REQUIRED]

  The ID of the step.

Return type:

dict

Returns:

Response Syntax

{
    'name': 'string',
    'stepGroupId': 'string',
    'workflowId': 'string',
    'stepId': 'string',
    'description': 'string',
    'stepActionType': 'MANUAL'|'AUTOMATED',
    'owner': 'AWS_MANAGED'|'CUSTOM',
    'workflowStepAutomationConfiguration': {
        'scriptLocationS3Bucket': 'string',
        'scriptLocationS3Key': {
            'linux': 'string',
            'windows': 'string'
        },
        'command': {
            'linux': 'string',
            'windows': 'string'
        },
        'runEnvironment': 'AWS'|'ONPREMISE',
        'targetType': 'SINGLE'|'ALL'|'NONE'
    },
    'stepTarget': [
        'string',
    ],
    'outputs': [
        {
            'name': 'string',
            'dataType': 'STRING'|'INTEGER'|'STRINGLIST'|'STRINGMAP',
            'required': True|False,
            'value': {
                'integerValue': 123,
                'stringValue': 'string',
                'listOfStringValue': [
                    'string',
                ]
            }
        },
    ],
    'previous': [
        'string',
    ],
    'next': [
        'string',
    ],
    'status': 'AWAITING_DEPENDENCIES'|'SKIPPED'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'USER_ATTENTION_REQUIRED',
    'statusMessage': 'string',
    'scriptOutputLocation': 'string',
    'creationTime': datetime(2015, 1, 1),
    'lastStartTime': datetime(2015, 1, 1),
    'endTime': datetime(2015, 1, 1),
    'noOfSrvCompleted': 123,
    'noOfSrvFailed': 123,
    'totalNoOfSrv': 123
}

Response Structure

• (dict) –

  • name (string) –

    The name of the step.

  • stepGroupId (string) –

    The ID of the step group.

  • workflowId (string) –

    The ID of the migration workflow.

  • stepId (string) –

    The ID of the step.

  • description (string) –

    The description of the step.

  • stepActionType (string) –

    The action type of the step. You must run and update the status of a manual step for the workflow to continue after the completion of the step.

  • owner (string) –

    The owner of the step.

  • workflowStepAutomationConfiguration (dict) –

    The custom script to run tests on source or target environments.

    • scriptLocationS3Bucket (string) –

      The Amazon S3 bucket where the script is located.

    • scriptLocationS3Key (dict) –

      The Amazon S3 key for the script location.

      • linux (string) –

        The script location for Linux.

      • windows (string) –

        The script location for Windows.

    • command (dict) –

      The command required to run the script.

      • linux (string) –

        Command for Linux.

      • windows (string) –

        Command for Windows.

    • runEnvironment (string) –

      The source or target environment.

    • targetType (string) –

      The servers on which to run the script.

  • stepTarget (list) –

    The servers on which a step will be run.

    • (string) –

  • outputs (list) –

    The outputs of the step.

    • (dict) –

      The output of a step.

      • name (string) –

        The name of the step.

      • dataType (string) –

        The data type of the output.

      • required (boolean) –

        Determine if an output is required from a step.

      • value (dict) –

        The value of the output.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: integerValue, stringValue, listOfStringValue. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • integerValue (integer) –

          The integer value.

        • stringValue (string) –

          The string value.

        • listOfStringValue (list) –

          The list of string value.

          • (string) –

  • previous (list) –

    The previous step.

    • (string) –

  • next (list) –

    The next step.

    • (string) –

  • status (string) –

    The status of the step.

  • statusMessage (string) –

    The status message of the migration workflow.

  • scriptOutputLocation (string) –

    The output location of the script.

  • creationTime (datetime) –

    The time at which the step was created.

  • lastStartTime (datetime) –

    The time at which the workflow was last started.

  • endTime (datetime) –

    The time at which the step ended.

  • noOfSrvCompleted (integer) –

    The number of servers that have been migrated.

  • noOfSrvFailed (integer) –

    The number of servers that have failed to migrate.

  • totalNoOfSrv (integer) –

    The total number of servers that have been migrated.

Exceptions

• MigrationHubOrchestrator.Client.exceptions.ThrottlingException

• MigrationHubOrchestrator.Client.exceptions.AccessDeniedException

• MigrationHubOrchestrator.Client.exceptions.InternalServerException

• MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException