A low-level client representing AWS Migration Hub Orchestrator
This API reference provides descriptions, syntax, and other details about each of the actions and data types for AWS Migration Hub Orchestrator. he topic for each action shows the API request parameters and the response. Alternatively, you can use one of the AWS SDKs to access an API that is tailored to the programming language or platform that you’re using.
client = session.create_client('migrationhuborchestrator')
These are the available methods:
Check if an operation can be paginated.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
True
if the operation can be paginated,
False
otherwise.
Closes underlying endpoint connections.
Create a workflow to orchestrate your migrations.
See also: AWS API Documentation
Request Syntax
response = client.create_workflow(
name='string',
description='string',
templateId='string',
applicationConfigurationId='string',
inputParameters={
'string': {
'integerValue': 123,
'stringValue': 'string',
'listOfStringsValue': [
'string',
],
'mapOfStringValue': {
'string': 'string'
}
}
},
stepTargets=[
'string',
],
tags={
'string': 'string'
}
)
name (string) –
[REQUIRED]
The name of the migration workflow.
description (string) – The description of the migration workflow.
templateId (string) –
[REQUIRED]
The ID of the template.
applicationConfigurationId (string) –
[REQUIRED]
The configuration ID of the application configured in Application Discovery Service.
inputParameters (dict) –
[REQUIRED]
The input parameters required to create a migration workflow.
(string) –
(dict) –
A map of key value pairs that is generated when you create a migration workflow. The key value pairs will differ based on your selection of the template.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: integerValue
, stringValue
, listOfStringsValue
, mapOfStringValue
.
integerValue (integer) –
The value of the integer.
stringValue (string) –
String value.
listOfStringsValue (list) –
List of string values.
(string) –
mapOfStringValue (dict) –
Map of string values.
(string) –
(string) –
stepTargets (list) –
The servers on which a step will be run.
(string) –
tags (dict) –
The tags to add on a migration workflow.
(string) –
(string) –
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'name': 'string',
'description': 'string',
'templateId': 'string',
'adsApplicationConfigurationId': 'string',
'workflowInputs': {
'string': {
'integerValue': 123,
'stringValue': 'string',
'listOfStringsValue': [
'string',
],
'mapOfStringValue': {
'string': 'string'
}
}
},
'stepTargets': [
'string',
],
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'creationTime': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
name (string) –
The name of the migration workflow.
description (string) –
The description of the migration workflow.
templateId (string) –
The ID of the template.
adsApplicationConfigurationId (string) –
The configuration ID of the application configured in Application Discovery Service.
workflowInputs (dict) –
The inputs for creating a migration workflow.
(string) –
(dict) –
A map of key value pairs that is generated when you create a migration workflow. The key value pairs will differ based on your selection of the template.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set: integerValue
, stringValue
, listOfStringsValue
, mapOfStringValue
. 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 value of the integer.
stringValue (string) –
String value.
listOfStringsValue (list) –
List of string values.
(string) –
mapOfStringValue (dict) –
Map of string values.
(string) –
(string) –
stepTargets (list) –
The servers on which a step will be run.
(string) –
status (string) –
The status of the migration workflow.
creationTime (datetime) –
The time at which the migration workflow was created.
tags (dict) –
The tags to add on a migration workflow.
(string) –
(string) –
Exceptions
Create a step in the migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.create_workflow_step(
name='string',
stepGroupId='string',
workflowId='string',
stepActionType='MANUAL'|'AUTOMATED',
description='string',
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',
]
)
name (string) –
[REQUIRED]
The name of the step.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
stepActionType (string) –
[REQUIRED]
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.
description (string) – The description 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 key value pairs added for the expected output.
(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 can be set: integerValue
, stringValue
, listOfStringValue
.
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) –
dict
Response Syntax
{
'id': 'string',
'stepGroupId': 'string',
'workflowId': 'string',
'name': 'string'
}
Response Structure
(dict) –
id (string) –
The ID of the step.
stepGroupId (string) –
The ID of the step group.
workflowId (string) –
The ID of the migration workflow.
name (string) –
The name of the step.
Exceptions
Create a step group in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.create_workflow_step_group(
workflowId='string',
name='string',
description='string',
next=[
'string',
],
previous=[
'string',
]
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow that will contain the step group.
name (string) –
[REQUIRED]
The name of the step group.
description (string) – The description of the step group.
next (list) –
The next step group.
(string) –
previous (list) –
The previous step group.
(string) –
dict
Response Syntax
{
'workflowId': 'string',
'name': 'string',
'id': 'string',
'description': 'string',
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'next': [
'string',
],
'previous': [
'string',
],
'creationTime': datetime(2015, 1, 1)
}
Response Structure
(dict) –
workflowId (string) –
The ID of the migration workflow that contains the step group.
name (string) –
The name of the step group.
id (string) –
The ID of the step group.
description (string) –
The description of the step group.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
next (list) –
The next step group.
(string) –
previous (list) –
The previous step group.
(string) –
creationTime (datetime) –
The time at which the step group is created.
Exceptions
Delete a migration workflow. You must pause a running workflow in Migration Hub Orchestrator console to delete it.
See also: AWS API Documentation
Request Syntax
response = client.delete_workflow(
id='string'
)
id (string) –
[REQUIRED]
The ID of the migration workflow you want to delete.
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED'
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
status (string) –
The status of the migration workflow.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Delete a step in a migration workflow. Pause the workflow to delete a running step.
See also: AWS API Documentation
Request Syntax
response = client.delete_workflow_step(
id='string',
stepGroupId='string',
workflowId='string'
)
id (string) –
[REQUIRED]
The ID of the step you want to delete.
stepGroupId (string) –
[REQUIRED]
The ID of the step group that contains the step you want to delete.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Delete a step group in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.delete_workflow_step_group(
workflowId='string',
id='string'
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
id (string) –
[REQUIRED]
The ID of the step group you want to delete.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Create a paginator for an operation.
operation_name (string) – The operation name. This is the same name
as the method name on the client. For example, if the
method name is create_foo
, and you’d normally invoke the
operation as client.create_foo(**kwargs)
, if the
create_foo
operation can be paginated, you can use the
call client.get_paginator("create_foo")
.
OperationNotPageableError – Raised if the operation is not
pageable. You can use the client.can_paginate
method to
check if an operation is pageable.
L{botocore.paginate.Paginator}
A paginator object.
Get the template you want to use for creating a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.get_template(
id='string'
)
id (string) –
[REQUIRED]
The ID of the template.
dict
Response Syntax
{
'id': 'string',
'name': 'string',
'description': 'string',
'inputs': [
{
'inputName': 'string',
'dataType': 'STRING'|'INTEGER'|'STRINGLIST'|'STRINGMAP',
'required': True|False
},
],
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'status': 'CREATED',
'creationTime': datetime(2015, 1, 1)
}
Response Structure
(dict) –
id (string) –
The ID of the template.
name (string) –
The name of the template.
description (string) –
The time at which the template was last created.
inputs (list) –
The inputs provided for the creation of the migration workflow.
(dict) –
The input parameters of a template.
inputName (string) –
The name of the template.
dataType (string) –
The data type of the template input.
required (boolean) –
Determine if an input is required from the template.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
status (string) –
The status of the template.
creationTime (datetime) –
The time at which the template was last created.
Exceptions
Get a specific step in a template.
See also: AWS API Documentation
Request Syntax
response = client.get_template_step(
id='string',
templateId='string',
stepGroupId='string'
)
id (string) –
[REQUIRED]
The ID of the step.
templateId (string) –
[REQUIRED]
The ID of the template.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
dict
Response Syntax
{
'id': 'string',
'stepGroupId': 'string',
'templateId': 'string',
'name': 'string',
'description': 'string',
'stepActionType': 'MANUAL'|'AUTOMATED',
'creationTime': 'string',
'previous': [
'string',
],
'next': [
'string',
],
'outputs': [
{
'name': 'string',
'dataType': 'STRING'|'INTEGER'|'STRINGLIST'|'STRINGMAP',
'required': True|False
},
],
'stepAutomationConfiguration': {
'scriptLocationS3Bucket': 'string',
'scriptLocationS3Key': {
'linux': 'string',
'windows': 'string'
},
'command': {
'linux': 'string',
'windows': 'string'
},
'runEnvironment': 'AWS'|'ONPREMISE',
'targetType': 'SINGLE'|'ALL'|'NONE'
}
}
Response Structure
(dict) –
id (string) –
The ID of the step.
stepGroupId (string) –
The ID of the step group.
templateId (string) –
The ID of the template.
name (string) –
The name 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.
creationTime (string) –
The time at which the step was created.
previous (list) –
The previous step.
(string) –
next (list) –
The next step.
(string) –
outputs (list) –
The outputs of the step.
(dict) –
The output of the step.
name (string) –
The name of the step.
dataType (string) –
The data type of the step output.
required (boolean) –
Determine if an output is required from a step.
stepAutomationConfiguration (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 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.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Get a step group in a template.
See also: AWS API Documentation
Request Syntax
response = client.get_template_step_group(
templateId='string',
id='string'
)
templateId (string) –
[REQUIRED]
The ID of the template.
id (string) –
[REQUIRED]
The ID of the step group.
dict
Response Syntax
{
'templateId': 'string',
'id': 'string',
'name': 'string',
'description': 'string',
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'PAUSING'|'USER_ATTENTION_REQUIRED',
'creationTime': datetime(2015, 1, 1),
'lastModifiedTime': datetime(2015, 1, 1),
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'previous': [
'string',
],
'next': [
'string',
]
}
Response Structure
(dict) –
templateId (string) –
The ID of the template.
id (string) –
The ID of the step group.
name (string) –
The name of the step group.
description (string) –
The description of the step group.
status (string) –
The status of the step group.
creationTime (datetime) –
The time at which the step group was created.
lastModifiedTime (datetime) –
The time at which the step group was last modified.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Returns an object that can wait for some condition.
waiter_name (str) – The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
The specified waiter object.
botocore.waiter.Waiter
Get migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.get_workflow(
id='string'
)
id (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'name': 'string',
'description': 'string',
'templateId': 'string',
'adsApplicationConfigurationId': 'string',
'adsApplicationName': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'statusMessage': 'string',
'creationTime': datetime(2015, 1, 1),
'lastStartTime': datetime(2015, 1, 1),
'lastStopTime': datetime(2015, 1, 1),
'lastModifiedTime': datetime(2015, 1, 1),
'endTime': datetime(2015, 1, 1),
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'totalSteps': 123,
'completedSteps': 123,
'workflowInputs': {
'string': {
'integerValue': 123,
'stringValue': 'string',
'listOfStringsValue': [
'string',
],
'mapOfStringValue': {
'string': 'string'
}
}
},
'tags': {
'string': 'string'
},
'workflowBucket': 'string'
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
name (string) –
The name of the migration workflow.
description (string) –
The description of the migration workflow.
templateId (string) –
The ID of the template.
adsApplicationConfigurationId (string) –
The configuration ID of the application configured in Application Discovery Service.
adsApplicationName (string) –
The name of the application configured in Application Discovery Service.
status (string) –
The status of the migration workflow.
statusMessage (string) –
The status message of the migration workflow.
creationTime (datetime) –
The time at which the migration workflow was created.
lastStartTime (datetime) –
The time at which the migration workflow was last started.
lastStopTime (datetime) –
The time at which the migration workflow was last stopped.
lastModifiedTime (datetime) –
The time at which the migration workflow was last modified.
endTime (datetime) –
The time at which the migration workflow ended.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
totalSteps (integer) –
The total number of steps in the migration workflow.
completedSteps (integer) –
Get a list of completed steps in the migration workflow.
workflowInputs (dict) –
The inputs required for creating the migration workflow.
(string) –
(dict) –
A map of key value pairs that is generated when you create a migration workflow. The key value pairs will differ based on your selection of the template.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set: integerValue
, stringValue
, listOfStringsValue
, mapOfStringValue
. 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 value of the integer.
stringValue (string) –
String value.
listOfStringsValue (list) –
List of string values.
(string) –
mapOfStringValue (dict) –
Map of string values.
(string) –
(string) –
tags (dict) –
The tags added to the migration workflow.
(string) –
(string) –
workflowBucket (string) –
The Amazon S3 bucket where the migration logs are stored.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
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'
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
stepGroupId (string) –
[REQUIRED]
desThe ID of the step group.
id (string) –
[REQUIRED]
The ID of the step.
dict
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'|'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
Get the step group of a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.get_workflow_step_group(
id='string',
workflowId='string'
)
id (string) –
[REQUIRED]
The ID of the step group.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{
'id': 'string',
'workflowId': 'string',
'name': 'string',
'description': 'string',
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'PAUSING'|'USER_ATTENTION_REQUIRED',
'owner': 'AWS_MANAGED'|'CUSTOM',
'creationTime': datetime(2015, 1, 1),
'lastModifiedTime': datetime(2015, 1, 1),
'endTime': datetime(2015, 1, 1),
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'previous': [
'string',
],
'next': [
'string',
]
}
Response Structure
(dict) –
id (string) –
The ID of the step group.
workflowId (string) –
The ID of the migration workflow.
name (string) –
The name of the step group.
description (string) –
The description of the step group.
status (string) –
The status of the step group.
owner (string) –
The owner of the step group.
creationTime (datetime) –
The time at which the step group was created.
lastModifiedTime (datetime) –
The time at which the step group was last modified.
endTime (datetime) –
The time at which the step group ended.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
List AWS Migration Hub Orchestrator plugins.
See also: AWS API Documentation
Request Syntax
response = client.list_plugins(
maxResults=123,
nextToken='string'
)
maxResults (integer) – The maximum number of plugins that can be returned.
nextToken (string) – The pagination token.
dict
Response Syntax
{
'nextToken': 'string',
'plugins': [
{
'pluginId': 'string',
'hostname': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'ipAddress': 'string',
'version': 'string',
'registeredTime': 'string'
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
plugins (list) –
Migration Hub Orchestrator plugins.
(dict) –
The summary of the Migration Hub Orchestrator plugin.
pluginId (string) –
The ID of the plugin.
hostname (string) –
The name of the host.
status (string) –
The status of the plugin.
ipAddress (string) –
The IP address at which the plugin is located.
version (string) –
The version of the plugin.
registeredTime (string) –
The time at which the plugin was registered.
Exceptions
List the tags added to a resource.
See also: AWS API Documentation
Request Syntax
response = client.list_tags_for_resource(
resourceArn='string'
)
resourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource.
dict
Response Syntax
{
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
tags (dict) –
The tags added to a resource.
(string) –
(string) –
Exceptions
List the step groups in a template.
See also: AWS API Documentation
Request Syntax
response = client.list_template_step_groups(
maxResults=123,
nextToken='string',
templateId='string'
)
maxResults (integer) – The maximum number of results that can be returned.
nextToken (string) – The pagination token.
templateId (string) –
[REQUIRED]
The ID of the template.
dict
Response Syntax
{
'nextToken': 'string',
'templateStepGroupSummary': [
{
'id': 'string',
'name': 'string',
'previous': [
'string',
],
'next': [
'string',
]
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
templateStepGroupSummary (list) –
The summary of the step group in the template.
(dict) –
The summary of the step group in the template.
id (string) –
The ID of the step group.
name (string) –
The name of the step group.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
Exceptions
List the steps in a template.
See also: AWS API Documentation
Request Syntax
response = client.list_template_steps(
maxResults=123,
nextToken='string',
templateId='string',
stepGroupId='string'
)
maxResults (integer) – The maximum number of results that can be returned.
nextToken (string) – The pagination token.
templateId (string) –
[REQUIRED]
The ID of the template.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
dict
Response Syntax
{
'nextToken': 'string',
'templateStepSummaryList': [
{
'id': 'string',
'stepGroupId': 'string',
'templateId': 'string',
'name': 'string',
'stepActionType': 'MANUAL'|'AUTOMATED',
'targetType': 'SINGLE'|'ALL'|'NONE',
'owner': 'AWS_MANAGED'|'CUSTOM',
'previous': [
'string',
],
'next': [
'string',
]
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
templateStepSummaryList (list) –
The list of summaries of steps in a template.
(dict) –
The summary of the step.
id (string) –
The ID of the step.
stepGroupId (string) –
The ID of the step group.
templateId (string) –
The ID of the template.
name (string) –
The name 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.
targetType (string) –
The servers on which to run the script.
owner (string) –
The owner of the step.
previous (list) –
The previous step.
(string) –
next (list) –
The next step.
(string) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
List the templates available in Migration Hub Orchestrator to create a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.list_templates(
maxResults=123,
nextToken='string',
name='string'
)
maxResults (integer) – The maximum number of results that can be returned.
nextToken (string) – The pagination token.
name (string) – The name of the template.
dict
Response Syntax
{
'nextToken': 'string',
'templateSummary': [
{
'id': 'string',
'name': 'string',
'arn': 'string',
'description': 'string'
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
templateSummary (list) –
The summary of the template.
(dict) –
The summary of the template.
id (string) –
The ID of the template.
name (string) –
The name of the template.
arn (string) –
The Amazon Resource Name (ARN) of the template.
description (string) –
The description of the template.
Exceptions
List the step groups in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.list_workflow_step_groups(
nextToken='string',
maxResults=123,
workflowId='string'
)
nextToken (string) – The pagination token.
maxResults (integer) – The maximum number of results that can be returned.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{
'nextToken': 'string',
'workflowStepGroupsSummary': [
{
'id': 'string',
'name': 'string',
'owner': 'AWS_MANAGED'|'CUSTOM',
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'PAUSING'|'USER_ATTENTION_REQUIRED',
'previous': [
'string',
],
'next': [
'string',
]
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
workflowStepGroupsSummary (list) –
The summary of step groups in a migration workflow.
(dict) –
The summary of a step group in a workflow.
id (string) –
The ID of the step group.
name (string) –
The name of the step group.
owner (string) –
The owner of the step group.
status (string) –
The status of the step group.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
List the steps in a workflow.
See also: AWS API Documentation
Request Syntax
response = client.list_workflow_steps(
nextToken='string',
maxResults=123,
workflowId='string',
stepGroupId='string'
)
nextToken (string) – The pagination token.
maxResults (integer) – The maximum number of results that can be returned.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
dict
Response Syntax
{
'nextToken': 'string',
'workflowStepsSummary': [
{
'stepId': 'string',
'name': 'string',
'stepActionType': 'MANUAL'|'AUTOMATED',
'owner': 'AWS_MANAGED'|'CUSTOM',
'previous': [
'string',
],
'next': [
'string',
],
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'USER_ATTENTION_REQUIRED',
'statusMessage': 'string',
'noOfSrvCompleted': 123,
'noOfSrvFailed': 123,
'totalNoOfSrv': 123,
'description': 'string',
'scriptLocation': 'string'
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
workflowStepsSummary (list) –
The summary of steps in a migration workflow.
(dict) –
The summary of the step in a migration workflow.
stepId (string) –
The ID of the step.
name (string) –
The name 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.
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.
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.
description (string) –
The description of the step.
scriptLocation (string) –
The location of the script.
Exceptions
List the migration workflows.
See also: AWS API Documentation
Request Syntax
response = client.list_workflows(
maxResults=123,
nextToken='string',
templateId='string',
adsApplicationConfigurationName='string',
status='CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
name='string'
)
maxResults (integer) – The maximum number of results that can be returned.
nextToken (string) – The pagination token.
templateId (string) – The ID of the template.
adsApplicationConfigurationName (string) – The name of the application configured in Application Discovery Service.
status (string) – The status of the migration workflow.
name (string) – The name of the migration workflow.
dict
Response Syntax
{
'nextToken': 'string',
'migrationWorkflowSummary': [
{
'id': 'string',
'name': 'string',
'templateId': 'string',
'adsApplicationConfigurationName': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'creationTime': datetime(2015, 1, 1),
'endTime': datetime(2015, 1, 1),
'statusMessage': 'string',
'completedSteps': 123,
'totalSteps': 123
},
]
}
Response Structure
(dict) –
nextToken (string) –
The pagination token.
migrationWorkflowSummary (list) –
The summary of the migration workflow.
(dict) –
The summary of a migration workflow.
id (string) –
The ID of the migration workflow.
name (string) –
The name of the migration workflow.
templateId (string) –
The ID of the template.
adsApplicationConfigurationName (string) –
The name of the application configured in Application Discovery Service.
status (string) –
The status of the migration workflow.
creationTime (datetime) –
The time at which the migration workflow was created.
endTime (datetime) –
The time at which the migration workflow ended.
statusMessage (string) –
The status message of the migration workflow.
completedSteps (integer) –
The steps completed in the migration workflow.
totalSteps (integer) –
All the steps in a migration workflow.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Retry a failed step in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.retry_workflow_step(
workflowId='string',
stepGroupId='string',
id='string'
)
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.
dict
Response Syntax
{
'stepGroupId': 'string',
'workflowId': 'string',
'id': 'string',
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'USER_ATTENTION_REQUIRED'
}
Response Structure
(dict) –
stepGroupId (string) –
The ID of the step group.
workflowId (string) –
The ID of the migration workflow.
id (string) –
The ID of the step.
status (string) –
The status of the step.
Exceptions
Start a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.start_workflow(
id='string'
)
id (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'statusMessage': 'string',
'lastStartTime': datetime(2015, 1, 1)
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
status (string) –
The status of the migration workflow.
statusMessage (string) –
The status message of the migration workflow.
lastStartTime (datetime) –
The time at which the migration workflow was last started.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Stop an ongoing migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.stop_workflow(
id='string'
)
id (string) –
[REQUIRED]
The ID of the migration workflow.
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'statusMessage': 'string',
'lastStopTime': datetime(2015, 1, 1)
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
status (string) –
The status of the migration workflow.
statusMessage (string) –
The status message of the migration workflow.
lastStopTime (datetime) –
The time at which the migration workflow was stopped.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Tag a resource by specifying its Amazon Resource Name (ARN).
See also: AWS API Documentation
Request Syntax
response = client.tag_resource(
resourceArn='string',
tags={
'string': 'string'
}
)
resourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource to which you want to add tags.
tags (dict) –
[REQUIRED]
A collection of labels, in the form of key:value pairs, that apply to this resource.
(string) –
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes the tags for a resource.
See also: AWS API Documentation
Request Syntax
response = client.untag_resource(
resourceArn='string',
tagKeys=[
'string',
]
)
resourceArn (string) –
[REQUIRED]
The Amazon Resource Name (ARN) of the resource from which you want to remove tags.
tagKeys (list) –
[REQUIRED]
One or more tag keys. Specify only the tag keys, not the tag values.
(string) –
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Update a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.update_workflow(
id='string',
name='string',
description='string',
inputParameters={
'string': {
'integerValue': 123,
'stringValue': 'string',
'listOfStringsValue': [
'string',
],
'mapOfStringValue': {
'string': 'string'
}
}
},
stepTargets=[
'string',
]
)
id (string) –
[REQUIRED]
The ID of the migration workflow.
name (string) – The name of the migration workflow.
description (string) – The description of the migration workflow.
inputParameters (dict) –
The input parameters required to update a migration workflow.
(string) –
(dict) –
A map of key value pairs that is generated when you create a migration workflow. The key value pairs will differ based on your selection of the template.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: integerValue
, stringValue
, listOfStringsValue
, mapOfStringValue
.
integerValue (integer) –
The value of the integer.
stringValue (string) –
String value.
listOfStringsValue (list) –
List of string values.
(string) –
mapOfStringValue (dict) –
Map of string values.
(string) –
(string) –
stepTargets (list) –
The servers on which a step will be run.
(string) –
dict
Response Syntax
{
'id': 'string',
'arn': 'string',
'name': 'string',
'description': 'string',
'templateId': 'string',
'adsApplicationConfigurationId': 'string',
'workflowInputs': {
'string': {
'integerValue': 123,
'stringValue': 'string',
'listOfStringsValue': [
'string',
],
'mapOfStringValue': {
'string': 'string'
}
}
},
'stepTargets': [
'string',
],
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'creationTime': datetime(2015, 1, 1),
'lastModifiedTime': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) –
id (string) –
The ID of the migration workflow.
arn (string) –
The Amazon Resource Name (ARN) of the migration workflow.
name (string) –
The name of the migration workflow.
description (string) –
The description of the migration workflow.
templateId (string) –
The ID of the template.
adsApplicationConfigurationId (string) –
The ID of the application configured in Application Discovery Service.
workflowInputs (dict) –
The inputs required to update a migration workflow.
(string) –
(dict) –
A map of key value pairs that is generated when you create a migration workflow. The key value pairs will differ based on your selection of the template.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set: integerValue
, stringValue
, listOfStringsValue
, mapOfStringValue
. 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 value of the integer.
stringValue (string) –
String value.
listOfStringsValue (list) –
List of string values.
(string) –
mapOfStringValue (dict) –
Map of string values.
(string) –
(string) –
stepTargets (list) –
The servers on which a step will be run.
(string) –
status (string) –
The status of the migration workflow.
creationTime (datetime) –
The time at which the migration workflow was created.
lastModifiedTime (datetime) –
The time at which the migration workflow was last modified.
tags (dict) –
The tags added to the migration workflow.
(string) –
(string) –
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Update a step in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.update_workflow_step(
id='string',
stepGroupId='string',
workflowId='string',
name='string',
description='string',
stepActionType='MANUAL'|'AUTOMATED',
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'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'USER_ATTENTION_REQUIRED'
)
id (string) –
[REQUIRED]
The ID of the step.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
name (string) – The name 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.
workflowStepAutomationConfiguration (dict) –
The custom script to run tests on the source and 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 a 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 can be set: integerValue
, stringValue
, listOfStringValue
.
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.
dict
Response Syntax
{
'id': 'string',
'stepGroupId': 'string',
'workflowId': 'string',
'name': 'string'
}
Response Structure
(dict) –
id (string) –
The ID of the step.
stepGroupId (string) –
The ID of the step group.
workflowId (string) –
The ID of the migration workflow.
name (string) –
The name of the step.
Exceptions
Update the step group in a migration workflow.
See also: AWS API Documentation
Request Syntax
response = client.update_workflow_step_group(
workflowId='string',
id='string',
name='string',
description='string',
next=[
'string',
],
previous=[
'string',
]
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
id (string) –
[REQUIRED]
The ID of the step group.
name (string) – The name of the step group.
description (string) – The description of the step group.
next (list) –
The next step group.
(string) –
previous (list) –
The previous step group.
(string) –
dict
Response Syntax
{
'workflowId': 'string',
'name': 'string',
'id': 'string',
'description': 'string',
'tools': [
{
'name': 'string',
'url': 'string'
},
],
'next': [
'string',
],
'previous': [
'string',
],
'lastModifiedTime': datetime(2015, 1, 1)
}
Response Structure
(dict) –
workflowId (string) –
The ID of the migration workflow.
name (string) –
The name of the step group.
id (string) –
The ID of the step group.
description (string) –
The description of the step group.
tools (list) –
List of AWS services utilized in a migration workflow.
(dict) –
List of AWS services utilized in a migration workflow.
name (string) –
The name of an AWS service.
url (string) –
The URL of an AWS service.
next (list) –
The next step group.
(string) –
previous (list) –
The previous step group.
(string) –
lastModifiedTime (datetime) –
The time at which the step group was last modified.
Exceptions
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ValidationException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
Client exceptions are available on a client instance via the exceptions
property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.
The available client exceptions are:
MigrationHubOrchestrator.Client.exceptions.AccessDeniedException
MigrationHubOrchestrator.Client.exceptions.InternalServerException
MigrationHubOrchestrator.Client.exceptions.ResourceNotFoundException
MigrationHubOrchestrator.Client.exceptions.ThrottlingException
MigrationHubOrchestrator.Client.exceptions.ValidationException
You do not have sufficient access to perform this action.
Example
try:
...
except client.exceptions.AccessDeniedException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
You do not have sufficient access to perform this action.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
An internal error has occurred.
Example
try:
...
except client.exceptions.InternalServerException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
An internal error has occurred.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The resource is not available.
Example
try:
...
except client.exceptions.ResourceNotFoundException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The resource is not available.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The request was denied due to request throttling.
Example
try:
...
except client.exceptions.ThrottlingException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The request was denied due to request throttling.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The input fails to satisfy the constraints specified by an AWS service.
Example
try:
...
except client.exceptions.ValidationException as e:
print(e.response)
The parsed error response. All exceptions have a top level Error
key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.
Syntax
{
'message': 'string',
'Error': {
'Code': 'string',
'Message': 'string'
}
}
Structure
(dict) –
The input fails to satisfy the constraints specified by an AWS service.
message (string) –
Error (dict) – Normalized access to common exception attributes.
Code (string) – An identifier specifying the exception type.
Message (string) – A descriptive message explaining why the exception occured.
The available paginators are:
paginator = client.get_paginator('list_plugins')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_plugins()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'plugins': [
{
'pluginId': 'string',
'hostname': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'ipAddress': 'string',
'version': 'string',
'registeredTime': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
plugins (list) –
Migration Hub Orchestrator plugins.
(dict) –
The summary of the Migration Hub Orchestrator plugin.
pluginId (string) –
The ID of the plugin.
hostname (string) –
The name of the host.
status (string) –
The status of the plugin.
ipAddress (string) –
The IP address at which the plugin is located.
version (string) –
The version of the plugin.
registeredTime (string) –
The time at which the plugin was registered.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_template_step_groups')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_template_step_groups()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
templateId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
templateId (string) –
[REQUIRED]
The ID of the template.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'templateStepGroupSummary': [
{
'id': 'string',
'name': 'string',
'previous': [
'string',
],
'next': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
templateStepGroupSummary (list) –
The summary of the step group in the template.
(dict) –
The summary of the step group in the template.
id (string) –
The ID of the step group.
name (string) –
The name of the step group.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_template_steps')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_template_steps()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
templateId='string',
stepGroupId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
templateId (string) –
[REQUIRED]
The ID of the template.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'templateStepSummaryList': [
{
'id': 'string',
'stepGroupId': 'string',
'templateId': 'string',
'name': 'string',
'stepActionType': 'MANUAL'|'AUTOMATED',
'targetType': 'SINGLE'|'ALL'|'NONE',
'owner': 'AWS_MANAGED'|'CUSTOM',
'previous': [
'string',
],
'next': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
templateStepSummaryList (list) –
The list of summaries of steps in a template.
(dict) –
The summary of the step.
id (string) –
The ID of the step.
stepGroupId (string) –
The ID of the step group.
templateId (string) –
The ID of the template.
name (string) –
The name 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.
targetType (string) –
The servers on which to run the script.
owner (string) –
The owner of the step.
previous (list) –
The previous step.
(string) –
next (list) –
The next step.
(string) –
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_templates')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_templates()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
name='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
name (string) – The name of the template.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'templateSummary': [
{
'id': 'string',
'name': 'string',
'arn': 'string',
'description': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
templateSummary (list) –
The summary of the template.
(dict) –
The summary of the template.
id (string) –
The ID of the template.
name (string) –
The name of the template.
arn (string) –
The Amazon Resource Name (ARN) of the template.
description (string) –
The description of the template.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_workflow_step_groups')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_workflow_step_groups()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
workflowId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'workflowStepGroupsSummary': [
{
'id': 'string',
'name': 'string',
'owner': 'AWS_MANAGED'|'CUSTOM',
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'PAUSING'|'USER_ATTENTION_REQUIRED',
'previous': [
'string',
],
'next': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
workflowStepGroupsSummary (list) –
The summary of step groups in a migration workflow.
(dict) –
The summary of a step group in a workflow.
id (string) –
The ID of the step group.
name (string) –
The name of the step group.
owner (string) –
The owner of the step group.
status (string) –
The status of the step group.
previous (list) –
The previous step group.
(string) –
next (list) –
The next step group.
(string) –
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_workflow_steps')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_workflow_steps()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
workflowId='string',
stepGroupId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
workflowId (string) –
[REQUIRED]
The ID of the migration workflow.
stepGroupId (string) –
[REQUIRED]
The ID of the step group.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'workflowStepsSummary': [
{
'stepId': 'string',
'name': 'string',
'stepActionType': 'MANUAL'|'AUTOMATED',
'owner': 'AWS_MANAGED'|'CUSTOM',
'previous': [
'string',
],
'next': [
'string',
],
'status': 'AWAITING_DEPENDENCIES'|'READY'|'IN_PROGRESS'|'COMPLETED'|'FAILED'|'PAUSED'|'USER_ATTENTION_REQUIRED',
'statusMessage': 'string',
'noOfSrvCompleted': 123,
'noOfSrvFailed': 123,
'totalNoOfSrv': 123,
'description': 'string',
'scriptLocation': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
workflowStepsSummary (list) –
The summary of steps in a migration workflow.
(dict) –
The summary of the step in a migration workflow.
stepId (string) –
The ID of the step.
name (string) –
The name 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.
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.
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.
description (string) –
The description of the step.
scriptLocation (string) –
The location of the script.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_workflows')
Creates an iterator that will paginate through responses from MigrationHubOrchestrator.Client.list_workflows()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
templateId='string',
adsApplicationConfigurationName='string',
status='CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
name='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
templateId (string) – The ID of the template.
adsApplicationConfigurationName (string) – The name of the application configured in Application Discovery Service.
status (string) – The status of the migration workflow.
name (string) – The name of the migration workflow.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken
will be provided in the output that you can use to resume pagination.
PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the NextToken
from a previous response.
dict
Response Syntax
{
'migrationWorkflowSummary': [
{
'id': 'string',
'name': 'string',
'templateId': 'string',
'adsApplicationConfigurationName': 'string',
'status': 'CREATING'|'NOT_STARTED'|'CREATION_FAILED'|'STARTING'|'IN_PROGRESS'|'WORKFLOW_FAILED'|'PAUSED'|'PAUSING'|'PAUSING_FAILED'|'USER_ATTENTION_REQUIRED'|'DELETING'|'DELETION_FAILED'|'DELETED'|'COMPLETED',
'creationTime': datetime(2015, 1, 1),
'endTime': datetime(2015, 1, 1),
'statusMessage': 'string',
'completedSteps': 123,
'totalSteps': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
migrationWorkflowSummary (list) –
The summary of the migration workflow.
(dict) –
The summary of a migration workflow.
id (string) –
The ID of the migration workflow.
name (string) –
The name of the migration workflow.
templateId (string) –
The ID of the template.
adsApplicationConfigurationName (string) –
The name of the application configured in Application Discovery Service.
status (string) –
The status of the migration workflow.
creationTime (datetime) –
The time at which the migration workflow was created.
endTime (datetime) –
The time at which the migration workflow ended.
statusMessage (string) –
The status message of the migration workflow.
completedSteps (integer) –
The steps completed in the migration workflow.
totalSteps (integer) –
All the steps in a migration workflow.
NextToken (string) –
A token to resume pagination.