A low-level client representing AWS Server Migration Service (SMS)
Warning
Product update
We recommend Amazon Web Services Application Migration Service (Amazon Web Services MGN) as the primary migration service for lift-and-shift migrations. If Amazon Web Services MGN is unavailable in a specific Amazon Web Services Region, you can use the Server Migration Service APIs through March 2023.
Server Migration Service (Server Migration Service) makes it easier and faster for you to migrate your on-premises workloads to Amazon Web Services. To learn more about Server Migration Service, see the following resources:
client = session.create_client('sms')
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.
Creates an application. An application consists of one or more server groups. Each server group contain one or more servers.
See also: AWS API Documentation
Request Syntax
response = client.create_app(
name='string',
description='string',
roleName='string',
clientToken='string',
serverGroups=[
{
'serverGroupId': 'string',
'name': 'string',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
]
},
],
tags=[
{
'key': 'string',
'value': 'string'
},
]
)
name (string) – The name of the new application.
description (string) – The description of the new application
roleName (string) – The name of the service role in the customer’s account to be used by Server Migration Service.
clientToken (string) – A unique, case-sensitive identifier that you provide to ensure the idempotency of application creation.
serverGroups (list) –
The server groups to include in the application.
(dict) –
Logical grouping of servers.
serverGroupId (string) –
The ID of a server group.
name (string) –
The name of a server group.
serverList (list) –
The servers that belong to a server group.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
tags (list) –
The tags to be associated with the application.
(dict) –
Key/value pair that can be assigned to an application.
key (string) –
The tag key.
value (string) –
The tag value.
dict
Response Syntax
{
'appSummary': {
'appId': 'string',
'importedAppId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
'replicationStatusMessage': 'string',
'latestReplicationTime': datetime(2015, 1, 1),
'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
'launchStatusMessage': 'string',
'launchDetails': {
'latestLaunchTime': datetime(2015, 1, 1),
'stackName': 'string',
'stackId': 'string'
},
'creationTime': datetime(2015, 1, 1),
'lastModified': datetime(2015, 1, 1),
'roleName': 'string',
'totalServerGroups': 123,
'totalServers': 123
},
'serverGroups': [
{
'serverGroupId': 'string',
'name': 'string',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
]
},
],
'tags': [
{
'key': 'string',
'value': 'string'
},
]
}
Response Structure
(dict) –
appSummary (dict) –
A summary description of the application.
appId (string) –
The unique ID of the application.
importedAppId (string) –
The ID of the application.
name (string) –
The name of the application.
description (string) –
The description of the application.
status (string) –
Status of the application.
statusMessage (string) –
A message related to the status of the application
replicationConfigurationStatus (string) –
Status of the replication configuration.
replicationStatus (string) –
The replication status of the application.
replicationStatusMessage (string) –
A message related to the replication status of the application.
latestReplicationTime (datetime) –
The timestamp of the application’s most recent successful replication.
launchConfigurationStatus (string) –
Status of the launch configuration.
launchStatus (string) –
The launch status of the application.
launchStatusMessage (string) –
A message related to the launch status of the application.
launchDetails (dict) –
Details about the latest launch of the application.
latestLaunchTime (datetime) –
The latest time that this application was launched successfully.
stackName (string) –
The name of the latest stack launched for this application.
stackId (string) –
The ID of the latest stack launched for this application.
creationTime (datetime) –
The creation time of the application.
lastModified (datetime) –
The last modified time of the application.
roleName (string) –
The name of the service role in the customer’s account used by Server Migration Service.
totalServerGroups (integer) –
The number of server groups present in the application.
totalServers (integer) –
The number of servers present in the application.
serverGroups (list) –
The server groups included in the application.
(dict) –
Logical grouping of servers.
serverGroupId (string) –
The ID of a server group.
name (string) –
The name of a server group.
serverList (list) –
The servers that belong to a server group.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
tags (list) –
The tags associated with the application.
(dict) –
Key/value pair that can be assigned to an application.
key (string) –
The tag key.
value (string) –
The tag value.
Exceptions
Creates a replication job. The replication job schedules periodic replication runs to replicate your server to Amazon Web Services. Each replication run creates an Amazon Machine Image (AMI).
See also: AWS API Documentation
Request Syntax
response = client.create_replication_job(
serverId='string',
seedReplicationTime=datetime(2015, 1, 1),
frequency=123,
runOnce=True|False,
licenseType='AWS'|'BYOL',
roleName='string',
description='string',
numberOfRecentAmisToKeep=123,
encrypted=True|False,
kmsKeyId='string'
)
serverId (string) –
[REQUIRED]
The ID of the server.
seedReplicationTime (datetime) –
[REQUIRED]
The seed replication time.
frequency (integer) – The time between consecutive replication runs, in hours.
runOnce (boolean) – Indicates whether to run the replication job one time.
licenseType (string) – The license type to be used for the AMI created by a successful replication run.
roleName (string) – The name of the IAM role to be used by the Server Migration Service.
description (string) – The description of the replication job.
numberOfRecentAmisToKeep (integer) – The maximum number of SMS-created AMIs to retain. The oldest is deleted after the maximum number is reached and a new AMI is created.
encrypted (boolean) – Indicates whether the replication job produces encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
dict
Response Syntax
{
'replicationJobId': 'string'
}
Response Structure
(dict) –
replicationJobId (string) –
The unique identifier of the replication job.
Exceptions
Deletes the specified application. Optionally deletes the launched stack associated with the application and all Server Migration Service replication jobs for servers in the application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app(
appId='string',
forceStopAppReplication=True|False,
forceTerminateApp=True|False
)
appId (string) – The ID of the application.
forceStopAppReplication (boolean) – Indicates whether to stop all replication jobs corresponding to the servers in the application while deleting the application.
forceTerminateApp (boolean) – Indicates whether to terminate the stack corresponding to the application while deleting the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes the launch configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app_launch_configuration(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes the replication configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app_replication_configuration(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes the validation configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app_validation_configuration(
appId='string'
)
appId (string) –
[REQUIRED]
The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes the specified replication job.
After you delete a replication job, there are no further replication runs. Amazon Web Services deletes the contents of the Amazon S3 bucket used to store Server Migration Service artifacts. The AMIs created by the replication runs are not deleted.
See also: AWS API Documentation
Request Syntax
response = client.delete_replication_job(
replicationJobId='string'
)
replicationJobId (string) –
[REQUIRED]
The ID of the replication job.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Deletes all servers from your server catalog.
See also: AWS API Documentation
Request Syntax
response = client.delete_server_catalog()
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Disassociates the specified connector from Server Migration Service.
After you disassociate a connector, it is no longer available to support replication jobs.
See also: AWS API Documentation
Request Syntax
response = client.disassociate_connector(
connectorId='string'
)
connectorId (string) –
[REQUIRED]
The ID of the connector.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Generates a target change set for a currently launched stack and writes it to an Amazon S3 object in the customer’s Amazon S3 bucket.
See also: AWS API Documentation
Request Syntax
response = client.generate_change_set(
appId='string',
changesetFormat='JSON'|'YAML'
)
appId (string) – The ID of the application associated with the change set.
changesetFormat (string) – The format for the change set.
dict
Response Syntax
{
's3Location': {
'bucket': 'string',
'key': 'string'
}
}
Response Structure
(dict) –
s3Location (dict) –
The location of the Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
Exceptions
Generates an CloudFormation template based on the current launch configuration and writes it to an Amazon S3 object in the customer’s Amazon S3 bucket.
See also: AWS API Documentation
Request Syntax
response = client.generate_template(
appId='string',
templateFormat='JSON'|'YAML'
)
appId (string) – The ID of the application associated with the CloudFormation template.
templateFormat (string) – The format for generating the CloudFormation template.
dict
Response Syntax
{
's3Location': {
'bucket': 'string',
'key': 'string'
}
}
Response Structure
(dict) –
s3Location (dict) –
The location of the Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
Exceptions
Retrieve information about the specified application.
See also: AWS API Documentation
Request Syntax
response = client.get_app(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{
'appSummary': {
'appId': 'string',
'importedAppId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
'replicationStatusMessage': 'string',
'latestReplicationTime': datetime(2015, 1, 1),
'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
'launchStatusMessage': 'string',
'launchDetails': {
'latestLaunchTime': datetime(2015, 1, 1),
'stackName': 'string',
'stackId': 'string'
},
'creationTime': datetime(2015, 1, 1),
'lastModified': datetime(2015, 1, 1),
'roleName': 'string',
'totalServerGroups': 123,
'totalServers': 123
},
'serverGroups': [
{
'serverGroupId': 'string',
'name': 'string',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
]
},
],
'tags': [
{
'key': 'string',
'value': 'string'
},
]
}
Response Structure
(dict) –
appSummary (dict) –
Information about the application.
appId (string) –
The unique ID of the application.
importedAppId (string) –
The ID of the application.
name (string) –
The name of the application.
description (string) –
The description of the application.
status (string) –
Status of the application.
statusMessage (string) –
A message related to the status of the application
replicationConfigurationStatus (string) –
Status of the replication configuration.
replicationStatus (string) –
The replication status of the application.
replicationStatusMessage (string) –
A message related to the replication status of the application.
latestReplicationTime (datetime) –
The timestamp of the application’s most recent successful replication.
launchConfigurationStatus (string) –
Status of the launch configuration.
launchStatus (string) –
The launch status of the application.
launchStatusMessage (string) –
A message related to the launch status of the application.
launchDetails (dict) –
Details about the latest launch of the application.
latestLaunchTime (datetime) –
The latest time that this application was launched successfully.
stackName (string) –
The name of the latest stack launched for this application.
stackId (string) –
The ID of the latest stack launched for this application.
creationTime (datetime) –
The creation time of the application.
lastModified (datetime) –
The last modified time of the application.
roleName (string) –
The name of the service role in the customer’s account used by Server Migration Service.
totalServerGroups (integer) –
The number of server groups present in the application.
totalServers (integer) –
The number of servers present in the application.
serverGroups (list) –
The server groups that belong to the application.
(dict) –
Logical grouping of servers.
serverGroupId (string) –
The ID of a server group.
name (string) –
The name of a server group.
serverList (list) –
The servers that belong to a server group.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
tags (list) –
The tags associated with the application.
(dict) –
Key/value pair that can be assigned to an application.
key (string) –
The tag key.
value (string) –
The tag value.
Exceptions
Retrieves the application launch configuration associated with the specified application.
See also: AWS API Documentation
Request Syntax
response = client.get_app_launch_configuration(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{
'appId': 'string',
'roleName': 'string',
'autoLaunch': True|False,
'serverGroupLaunchConfigurations': [
{
'serverGroupId': 'string',
'launchOrder': 123,
'serverLaunchConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'logicalId': 'string',
'vpc': 'string',
'subnet': 'string',
'securityGroup': 'string',
'ec2KeyName': 'string',
'userData': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'instanceType': 'string',
'associatePublicIpAddress': True|False,
'iamInstanceProfileName': 'string',
'configureScript': {
'bucket': 'string',
'key': 'string'
},
'configureScriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT'
},
]
},
]
}
Response Structure
(dict) –
appId (string) –
The ID of the application.
roleName (string) –
The name of the service role in the customer’s account that CloudFormation uses to launch the application.
autoLaunch (boolean) –
Indicates whether the application is configured to launch automatically after replication is complete.
serverGroupLaunchConfigurations (list) –
The launch configurations for server groups in this application.
(dict) –
Launch configuration for a server group.
serverGroupId (string) –
The ID of the server group with which the launch configuration is associated.
launchOrder (integer) –
The launch order of servers in the server group.
serverLaunchConfigurations (list) –
The launch configuration for servers in the server group.
(dict) –
Launch configuration for a server.
server (dict) –
The ID of the server with which the launch configuration is associated.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
logicalId (string) –
The logical ID of the server in the CloudFormation template.
vpc (string) –
The ID of the VPC into which the server should be launched.
subnet (string) –
The ID of the subnet the server should be launched into.
securityGroup (string) –
The ID of the security group that applies to the launched server.
ec2KeyName (string) –
The name of the Amazon EC2 SSH key to be used for connecting to the launched server.
userData (dict) –
Location of the user-data script to be executed when launching the server.
s3Location (dict) –
Amazon S3 location of the user-data script.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
instanceType (string) –
The instance type to use when launching the server.
associatePublicIpAddress (boolean) –
Indicates whether a publicly accessible IP address is created when launching the server.
iamInstanceProfileName (string) –
The name of the IAM instance profile.
configureScript (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
configureScriptType (string) –
The type of configuration script.
Exceptions
Retrieves the application replication configuration associated with the specified application.
See also: AWS API Documentation
Request Syntax
response = client.get_app_replication_configuration(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{
'serverGroupReplicationConfigurations': [
{
'serverGroupId': 'string',
'serverReplicationConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'serverReplicationParameters': {
'seedTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'licenseType': 'AWS'|'BYOL',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string'
}
},
]
},
]
}
Response Structure
(dict) –
serverGroupReplicationConfigurations (list) –
The replication configurations associated with server groups in this application.
(dict) –
Replication configuration for a server group.
serverGroupId (string) –
The ID of the server group with which this replication configuration is associated.
serverReplicationConfigurations (list) –
The replication configuration for servers in the server group.
(dict) –
Replication configuration of a server.
server (dict) –
The ID of the server with which this replication configuration is associated.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
serverReplicationParameters (dict) –
The parameters for replicating the server.
seedTime (datetime) –
The seed time for creating a replication job for the server.
frequency (integer) –
The frequency of creating replication jobs for the server.
runOnce (boolean) –
Indicates whether to run the replication job one time.
licenseType (string) –
The license type for creating a replication job for the server.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep when creating a replication job for this server.
encrypted (boolean) –
Indicates whether the replication job produces encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
Exceptions
Retrieves information about a configuration for validating an application.
See also: AWS API Documentation
Request Syntax
response = client.get_app_validation_configuration(
appId='string'
)
appId (string) –
[REQUIRED]
The ID of the application.
dict
Response Syntax
{
'appValidationConfigurations': [
{
'validationId': 'string',
'name': 'string',
'appValidationStrategy': 'SSM',
'ssmValidationParameters': {
'source': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'instanceId': 'string',
'scriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT',
'command': 'string',
'executionTimeoutSeconds': 123,
'outputS3BucketName': 'string'
}
},
],
'serverGroupValidationConfigurations': [
{
'serverGroupId': 'string',
'serverValidationConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'validationId': 'string',
'name': 'string',
'serverValidationStrategy': 'USERDATA',
'userDataValidationParameters': {
'source': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'scriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT'
}
},
]
},
]
}
Response Structure
(dict) –
appValidationConfigurations (list) –
The configuration for application validation.
(dict) –
Configuration for validating an application.
validationId (string) –
The ID of the validation.
name (string) –
The name of the configuration.
appValidationStrategy (string) –
The validation strategy.
ssmValidationParameters (dict) –
The validation parameters.
source (dict) –
The location of the validation script.
s3Location (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
instanceId (string) –
The ID of the instance. The instance must have the following tag: UserForSMSApplicationValidation=true.
scriptType (string) –
The type of validation script.
command (string) –
The command to run the validation script.
executionTimeoutSeconds (integer) –
The timeout interval, in seconds.
outputS3BucketName (string) –
The name of the S3 bucket for output.
serverGroupValidationConfigurations (list) –
The configuration for instance validation.
(dict) –
Configuration for validating an instance.
serverGroupId (string) –
The ID of the server group.
serverValidationConfigurations (list) –
The validation configuration.
(dict) –
Configuration for validating an instance.
server (dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
validationId (string) –
The ID of the validation.
name (string) –
The name of the configuration.
serverValidationStrategy (string) –
The validation strategy.
userDataValidationParameters (dict) –
The validation parameters.
source (dict) –
The location of the validation script.
s3Location (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
scriptType (string) –
The type of validation script.
Exceptions
Retrieves output from validating an application.
See also: AWS API Documentation
Request Syntax
response = client.get_app_validation_output(
appId='string'
)
appId (string) –
[REQUIRED]
The ID of the application.
dict
Response Syntax
{
'validationOutputList': [
{
'validationId': 'string',
'name': 'string',
'status': 'READY_FOR_VALIDATION'|'PENDING'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
'statusMessage': 'string',
'latestValidationTime': datetime(2015, 1, 1),
'appValidationOutput': {
'ssmOutput': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
}
},
'serverValidationOutput': {
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
}
}
},
]
}
Response Structure
(dict) –
validationOutputList (list) –
The validation output.
(dict) –
Contains validation output.
validationId (string) –
The ID of the validation.
name (string) –
The name of the validation.
status (string) –
The status of the validation.
statusMessage (string) –
The status message.
latestValidationTime (datetime) –
The latest time that the validation was performed.
appValidationOutput (dict) –
The output from validating an application.
ssmOutput (dict) –
Output from using SSM to validate the application.
s3Location (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
serverValidationOutput (dict) –
The output from validation an instance.
server (dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
Exceptions
Describes the connectors registered with the Server Migration Service.
See also: AWS API Documentation
Request Syntax
response = client.get_connectors(
nextToken='string',
maxResults=123
)
nextToken (string) – The token for the next set of results.
maxResults (integer) – The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned NextToken
value.
dict
Response Syntax
{
'connectorList': [
{
'connectorId': 'string',
'version': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'capabilityList': [
'VSPHERE'|'SCVMM'|'HYPERV-MANAGER'|'SNAPSHOT_BATCHING'|'SMS_OPTIMIZED',
],
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmManagerId': 'string',
'ipAddress': 'string',
'macAddress': 'string',
'associatedOn': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
connectorList (list) –
Information about the registered connectors.
(dict) –
Represents a connector.
connectorId (string) –
The ID of the connector.
version (string) –
The connector version.
status (string) –
The status of the connector.
capabilityList (list) –
The capabilities of the connector.
(string) –
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The VM management product.
vmManagerId (string) –
The ID of the VM manager.
ipAddress (string) –
The IP address of the connector.
macAddress (string) –
The MAC address of the connector.
associatedOn (datetime) –
The time the connector was associated.
nextToken (string) –
The token required to retrieve the next set of results. This value is null when there are no more results to return.
Exceptions
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.
Describes the specified replication job or all of your replication jobs.
See also: AWS API Documentation
Request Syntax
response = client.get_replication_jobs(
replicationJobId='string',
nextToken='string',
maxResults=123
)
replicationJobId (string) – The ID of the replication job.
nextToken (string) – The token for the next set of results.
maxResults (integer) – The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned NextToken
value.
dict
Response Syntax
{
'replicationJobList': [
{
'replicationJobId': 'string',
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'seedReplicationTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'nextReplicationRunStartTime': datetime(2015, 1, 1),
'licenseType': 'AWS'|'BYOL',
'roleName': 'string',
'latestAmiId': 'string',
'state': 'PENDING'|'ACTIVE'|'FAILED'|'DELETING'|'DELETED'|'COMPLETED'|'PAUSED_ON_FAILURE'|'FAILING',
'statusMessage': 'string',
'description': 'string',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string',
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
]
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
replicationJobList (list) –
Information about the replication jobs.
(dict) –
Represents a replication job.
replicationJobId (string) –
The ID of the replication job.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
seedReplicationTime (datetime) –
The seed replication time.
frequency (integer) –
The time between consecutive replication runs, in hours.
runOnce (boolean) –
Indicates whether to run the replication job one time.
nextReplicationRunStartTime (datetime) –
The start time of the next replication run.
licenseType (string) –
The license type to be used for the AMI created by a successful replication run.
roleName (string) –
The name of the IAM role to be used by Server Migration Service.
latestAmiId (string) –
The ID of the latest Amazon Machine Image (AMI).
state (string) –
The state of the replication job.
statusMessage (string) –
The description of the current status of the replication job.
description (string) –
The description of the replication job.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep in the customer’s account for a replication job. By default, the value is set to zero, meaning that all AMIs are kept.
encrypted (boolean) –
Indicates whether the replication job should produce encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
nextToken (string) –
The token required to retrieve the next set of results. This value is null when there are no more results to return.
Exceptions
Describes the replication runs for the specified replication job.
See also: AWS API Documentation
Request Syntax
response = client.get_replication_runs(
replicationJobId='string',
nextToken='string',
maxResults=123
)
replicationJobId (string) –
[REQUIRED]
The ID of the replication job.
nextToken (string) – The token for the next set of results.
maxResults (integer) – The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned NextToken
value.
dict
Response Syntax
{
'replicationJob': {
'replicationJobId': 'string',
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'seedReplicationTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'nextReplicationRunStartTime': datetime(2015, 1, 1),
'licenseType': 'AWS'|'BYOL',
'roleName': 'string',
'latestAmiId': 'string',
'state': 'PENDING'|'ACTIVE'|'FAILED'|'DELETING'|'DELETED'|'COMPLETED'|'PAUSED_ON_FAILURE'|'FAILING',
'statusMessage': 'string',
'description': 'string',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string',
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
]
},
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
replicationJob (dict) –
Information about the replication job.
replicationJobId (string) –
The ID of the replication job.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
seedReplicationTime (datetime) –
The seed replication time.
frequency (integer) –
The time between consecutive replication runs, in hours.
runOnce (boolean) –
Indicates whether to run the replication job one time.
nextReplicationRunStartTime (datetime) –
The start time of the next replication run.
licenseType (string) –
The license type to be used for the AMI created by a successful replication run.
roleName (string) –
The name of the IAM role to be used by Server Migration Service.
latestAmiId (string) –
The ID of the latest Amazon Machine Image (AMI).
state (string) –
The state of the replication job.
statusMessage (string) –
The description of the current status of the replication job.
description (string) –
The description of the replication job.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep in the customer’s account for a replication job. By default, the value is set to zero, meaning that all AMIs are kept.
encrypted (boolean) –
Indicates whether the replication job should produce encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
nextToken (string) –
The token required to retrieve the next set of results. This value is null when there are no more results to return.
Exceptions
Describes the servers in your server catalog.
Before you can describe your servers, you must import them using ImportServerCatalog .
See also: AWS API Documentation
Request Syntax
response = client.get_servers(
nextToken='string',
maxResults=123,
vmServerAddressList=[
{
'vmManagerId': 'string',
'vmId': 'string'
},
]
)
nextToken (string) – The token for the next set of results.
maxResults (integer) – The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned NextToken
value.
vmServerAddressList (list) –
The server addresses.
(dict) –
Represents a VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
dict
Response Syntax
{
'lastModifiedOn': datetime(2015, 1, 1),
'serverCatalogStatus': 'NOT_IMPORTED'|'IMPORTING'|'AVAILABLE'|'DELETED'|'EXPIRED',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
lastModifiedOn (datetime) –
The time when the server was last modified.
serverCatalogStatus (string) –
The status of the server catalog.
serverList (list) –
Information about the servers.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
nextToken (string) –
The token required to retrieve the next set of results. This value is null when there are no more results to return.
Exceptions
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
Allows application import from Migration Hub.
See also: AWS API Documentation
Request Syntax
response = client.import_app_catalog(
roleName='string'
)
roleName (string) – The name of the service role. If you omit this parameter, we create a service-linked role for Migration Hub in your account. Otherwise, the role that you provide must have the policy and trust policy described in the Migration Hub User Guide .
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Gathers a complete list of on-premises servers. Connectors must be installed and monitoring all servers to import.
This call returns immediately, but might take additional time to retrieve all the servers.
See also: AWS API Documentation
Request Syntax
response = client.import_server_catalog()
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Launches the specified application as a stack in CloudFormation.
See also: AWS API Documentation
Request Syntax
response = client.launch_app(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Retrieves summaries for all applications.
See also: AWS API Documentation
Request Syntax
response = client.list_apps(
appIds=[
'string',
],
nextToken='string',
maxResults=123
)
appIds (list) –
The unique application IDs.
(string) –
nextToken (string) – The token for the next set of results.
maxResults (integer) – The maximum number of results to return in a single call. The default value is 100. To retrieve the remaining results, make another call with the returned NextToken
value.
dict
Response Syntax
{
'apps': [
{
'appId': 'string',
'importedAppId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
'replicationStatusMessage': 'string',
'latestReplicationTime': datetime(2015, 1, 1),
'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
'launchStatusMessage': 'string',
'launchDetails': {
'latestLaunchTime': datetime(2015, 1, 1),
'stackName': 'string',
'stackId': 'string'
},
'creationTime': datetime(2015, 1, 1),
'lastModified': datetime(2015, 1, 1),
'roleName': 'string',
'totalServerGroups': 123,
'totalServers': 123
},
],
'nextToken': 'string'
}
Response Structure
(dict) –
apps (list) –
The application summaries.
(dict) –
Information about the application.
appId (string) –
The unique ID of the application.
importedAppId (string) –
The ID of the application.
name (string) –
The name of the application.
description (string) –
The description of the application.
status (string) –
Status of the application.
statusMessage (string) –
A message related to the status of the application
replicationConfigurationStatus (string) –
Status of the replication configuration.
replicationStatus (string) –
The replication status of the application.
replicationStatusMessage (string) –
A message related to the replication status of the application.
latestReplicationTime (datetime) –
The timestamp of the application’s most recent successful replication.
launchConfigurationStatus (string) –
Status of the launch configuration.
launchStatus (string) –
The launch status of the application.
launchStatusMessage (string) –
A message related to the launch status of the application.
launchDetails (dict) –
Details about the latest launch of the application.
latestLaunchTime (datetime) –
The latest time that this application was launched successfully.
stackName (string) –
The name of the latest stack launched for this application.
stackId (string) –
The ID of the latest stack launched for this application.
creationTime (datetime) –
The creation time of the application.
lastModified (datetime) –
The last modified time of the application.
roleName (string) –
The name of the service role in the customer’s account used by Server Migration Service.
totalServerGroups (integer) –
The number of server groups present in the application.
totalServers (integer) –
The number of servers present in the application.
nextToken (string) –
The token required to retrieve the next set of results. This value is null when there are no more results to return.
Exceptions
Provides information to Server Migration Service about whether application validation is successful.
See also: AWS API Documentation
Request Syntax
response = client.notify_app_validation_output(
appId='string',
notificationContext={
'validationId': 'string',
'status': 'READY_FOR_VALIDATION'|'PENDING'|'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
'statusMessage': 'string'
}
)
appId (string) –
[REQUIRED]
The ID of the application.
notificationContext (dict) –
The notification information.
validationId (string) –
The ID of the validation.
status (string) –
The status of the validation.
statusMessage (string) –
The status message.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Creates or updates the launch configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.put_app_launch_configuration(
appId='string',
roleName='string',
autoLaunch=True|False,
serverGroupLaunchConfigurations=[
{
'serverGroupId': 'string',
'launchOrder': 123,
'serverLaunchConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'logicalId': 'string',
'vpc': 'string',
'subnet': 'string',
'securityGroup': 'string',
'ec2KeyName': 'string',
'userData': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'instanceType': 'string',
'associatePublicIpAddress': True|False,
'iamInstanceProfileName': 'string',
'configureScript': {
'bucket': 'string',
'key': 'string'
},
'configureScriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT'
},
]
},
]
)
appId (string) – The ID of the application.
roleName (string) – The name of service role in the customer’s account that CloudFormation uses to launch the application.
autoLaunch (boolean) – Indicates whether the application is configured to launch automatically after replication is complete.
serverGroupLaunchConfigurations (list) –
Information about the launch configurations for server groups in the application.
(dict) –
Launch configuration for a server group.
serverGroupId (string) –
The ID of the server group with which the launch configuration is associated.
launchOrder (integer) –
The launch order of servers in the server group.
serverLaunchConfigurations (list) –
The launch configuration for servers in the server group.
(dict) –
Launch configuration for a server.
server (dict) –
The ID of the server with which the launch configuration is associated.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
logicalId (string) –
The logical ID of the server in the CloudFormation template.
vpc (string) –
The ID of the VPC into which the server should be launched.
subnet (string) –
The ID of the subnet the server should be launched into.
securityGroup (string) –
The ID of the security group that applies to the launched server.
ec2KeyName (string) –
The name of the Amazon EC2 SSH key to be used for connecting to the launched server.
userData (dict) –
Location of the user-data script to be executed when launching the server.
s3Location (dict) –
Amazon S3 location of the user-data script.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
instanceType (string) –
The instance type to use when launching the server.
associatePublicIpAddress (boolean) –
Indicates whether a publicly accessible IP address is created when launching the server.
iamInstanceProfileName (string) –
The name of the IAM instance profile.
configureScript (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
configureScriptType (string) –
The type of configuration script.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Creates or updates the replication configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.put_app_replication_configuration(
appId='string',
serverGroupReplicationConfigurations=[
{
'serverGroupId': 'string',
'serverReplicationConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'serverReplicationParameters': {
'seedTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'licenseType': 'AWS'|'BYOL',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string'
}
},
]
},
]
)
appId (string) – The ID of the application.
serverGroupReplicationConfigurations (list) –
Information about the replication configurations for server groups in the application.
(dict) –
Replication configuration for a server group.
serverGroupId (string) –
The ID of the server group with which this replication configuration is associated.
serverReplicationConfigurations (list) –
The replication configuration for servers in the server group.
(dict) –
Replication configuration of a server.
server (dict) –
The ID of the server with which this replication configuration is associated.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
serverReplicationParameters (dict) –
The parameters for replicating the server.
seedTime (datetime) –
The seed time for creating a replication job for the server.
frequency (integer) –
The frequency of creating replication jobs for the server.
runOnce (boolean) –
Indicates whether to run the replication job one time.
licenseType (string) –
The license type for creating a replication job for the server.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep when creating a replication job for this server.
encrypted (boolean) –
Indicates whether the replication job produces encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Creates or updates a validation configuration for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.put_app_validation_configuration(
appId='string',
appValidationConfigurations=[
{
'validationId': 'string',
'name': 'string',
'appValidationStrategy': 'SSM',
'ssmValidationParameters': {
'source': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'instanceId': 'string',
'scriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT',
'command': 'string',
'executionTimeoutSeconds': 123,
'outputS3BucketName': 'string'
}
},
],
serverGroupValidationConfigurations=[
{
'serverGroupId': 'string',
'serverValidationConfigurations': [
{
'server': {
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
'validationId': 'string',
'name': 'string',
'serverValidationStrategy': 'USERDATA',
'userDataValidationParameters': {
'source': {
's3Location': {
'bucket': 'string',
'key': 'string'
}
},
'scriptType': 'SHELL_SCRIPT'|'POWERSHELL_SCRIPT'
}
},
]
},
]
)
appId (string) –
[REQUIRED]
The ID of the application.
appValidationConfigurations (list) –
The configuration for application validation.
(dict) –
Configuration for validating an application.
validationId (string) –
The ID of the validation.
name (string) –
The name of the configuration.
appValidationStrategy (string) –
The validation strategy.
ssmValidationParameters (dict) –
The validation parameters.
source (dict) –
The location of the validation script.
s3Location (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
instanceId (string) –
The ID of the instance. The instance must have the following tag: UserForSMSApplicationValidation=true.
scriptType (string) –
The type of validation script.
command (string) –
The command to run the validation script.
executionTimeoutSeconds (integer) –
The timeout interval, in seconds.
outputS3BucketName (string) –
The name of the S3 bucket for output.
serverGroupValidationConfigurations (list) –
The configuration for instance validation.
(dict) –
Configuration for validating an instance.
serverGroupId (string) –
The ID of the server group.
serverValidationConfigurations (list) –
The validation configuration.
(dict) –
Configuration for validating an instance.
server (dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
validationId (string) –
The ID of the validation.
name (string) –
The name of the configuration.
serverValidationStrategy (string) –
The validation strategy.
userDataValidationParameters (dict) –
The validation parameters.
source (dict) –
The location of the validation script.
s3Location (dict) –
Location of an Amazon S3 object.
bucket (string) –
The Amazon S3 bucket name.
key (string) –
The Amazon S3 bucket key.
scriptType (string) –
The type of validation script.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Starts replicating the specified application by creating replication jobs for each server in the application.
See also: AWS API Documentation
Request Syntax
response = client.start_app_replication(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Starts an on-demand replication run for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.start_on_demand_app_replication(
appId='string',
description='string'
)
appId (string) –
[REQUIRED]
The ID of the application.
description (string) – The description of the replication run.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Starts an on-demand replication run for the specified replication job. This replication run starts immediately. This replication run is in addition to the ones already scheduled.
There is a limit on the number of on-demand replications runs that you can request in a 24-hour period.
See also: AWS API Documentation
Request Syntax
response = client.start_on_demand_replication_run(
replicationJobId='string',
description='string'
)
replicationJobId (string) –
[REQUIRED]
The ID of the replication job.
description (string) – The description of the replication run.
dict
Response Syntax
{
'replicationRunId': 'string'
}
Response Structure
(dict) –
replicationRunId (string) –
The ID of the replication run.
Exceptions
Stops replicating the specified application by deleting the replication job for each server in the application.
See also: AWS API Documentation
Request Syntax
response = client.stop_app_replication(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Terminates the stack for the specified application.
See also: AWS API Documentation
Request Syntax
response = client.terminate_app(
appId='string'
)
appId (string) – The ID of the application.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
Updates the specified application.
See also: AWS API Documentation
Request Syntax
response = client.update_app(
appId='string',
name='string',
description='string',
roleName='string',
serverGroups=[
{
'serverGroupId': 'string',
'name': 'string',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
]
},
],
tags=[
{
'key': 'string',
'value': 'string'
},
]
)
appId (string) – The ID of the application.
name (string) – The new name of the application.
description (string) – The new description of the application.
roleName (string) – The name of the service role in the customer’s account used by Server Migration Service.
serverGroups (list) –
The server groups in the application to update.
(dict) –
Logical grouping of servers.
serverGroupId (string) –
The ID of a server group.
name (string) –
The name of a server group.
serverList (list) –
The servers that belong to a server group.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
tags (list) –
The tags to associate with the application.
(dict) –
Key/value pair that can be assigned to an application.
key (string) –
The tag key.
value (string) –
The tag value.
dict
Response Syntax
{
'appSummary': {
'appId': 'string',
'importedAppId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
'replicationStatusMessage': 'string',
'latestReplicationTime': datetime(2015, 1, 1),
'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
'launchStatusMessage': 'string',
'launchDetails': {
'latestLaunchTime': datetime(2015, 1, 1),
'stackName': 'string',
'stackId': 'string'
},
'creationTime': datetime(2015, 1, 1),
'lastModified': datetime(2015, 1, 1),
'roleName': 'string',
'totalServerGroups': 123,
'totalServers': 123
},
'serverGroups': [
{
'serverGroupId': 'string',
'name': 'string',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
]
},
],
'tags': [
{
'key': 'string',
'value': 'string'
},
]
}
Response Structure
(dict) –
appSummary (dict) –
A summary description of the application.
appId (string) –
The unique ID of the application.
importedAppId (string) –
The ID of the application.
name (string) –
The name of the application.
description (string) –
The description of the application.
status (string) –
Status of the application.
statusMessage (string) –
A message related to the status of the application
replicationConfigurationStatus (string) –
Status of the replication configuration.
replicationStatus (string) –
The replication status of the application.
replicationStatusMessage (string) –
A message related to the replication status of the application.
latestReplicationTime (datetime) –
The timestamp of the application’s most recent successful replication.
launchConfigurationStatus (string) –
Status of the launch configuration.
launchStatus (string) –
The launch status of the application.
launchStatusMessage (string) –
A message related to the launch status of the application.
launchDetails (dict) –
Details about the latest launch of the application.
latestLaunchTime (datetime) –
The latest time that this application was launched successfully.
stackName (string) –
The name of the latest stack launched for this application.
stackId (string) –
The ID of the latest stack launched for this application.
creationTime (datetime) –
The creation time of the application.
lastModified (datetime) –
The last modified time of the application.
roleName (string) –
The name of the service role in the customer’s account used by Server Migration Service.
totalServerGroups (integer) –
The number of server groups present in the application.
totalServers (integer) –
The number of servers present in the application.
serverGroups (list) –
The updated server groups in the application.
(dict) –
Logical grouping of servers.
serverGroupId (string) –
The ID of a server group.
name (string) –
The name of a server group.
serverList (list) –
The servers that belong to a server group.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
tags (list) –
The tags associated with the application.
(dict) –
Key/value pair that can be assigned to an application.
key (string) –
The tag key.
value (string) –
The tag value.
Exceptions
Updates the specified settings for the specified replication job.
See also: AWS API Documentation
Request Syntax
response = client.update_replication_job(
replicationJobId='string',
frequency=123,
nextReplicationRunStartTime=datetime(2015, 1, 1),
licenseType='AWS'|'BYOL',
roleName='string',
description='string',
numberOfRecentAmisToKeep=123,
encrypted=True|False,
kmsKeyId='string'
)
replicationJobId (string) –
[REQUIRED]
The ID of the replication job.
frequency (integer) – The time between consecutive replication runs, in hours.
nextReplicationRunStartTime (datetime) – The start time of the next replication run.
licenseType (string) – The license type to be used for the AMI created by a successful replication run.
roleName (string) – The name of the IAM role to be used by Server Migration Service.
description (string) – The description of the replication job.
numberOfRecentAmisToKeep (integer) – The maximum number of SMS-created AMIs to retain. The oldest is deleted after the maximum number is reached and a new AMI is created.
encrypted (boolean) – When true, the replication job produces encrypted AMIs. For more information, KmsKeyId
.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
dict
Response Syntax
{}
Response Structure
(dict) –
Exceptions
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:
The user has the required permissions, so the request would have succeeded, but a dry run was performed.
Example
try:
...
except client.exceptions.DryRunOperationException 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 user has the required permissions, so the request would have succeeded, but a dry run was performed.
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 occurred.
Example
try:
...
except client.exceptions.InternalError 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 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.
A specified parameter is not valid.
Example
try:
...
except client.exceptions.InvalidParameterException 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) –
A specified parameter is not valid.
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.
A required parameter is missing.
Example
try:
...
except client.exceptions.MissingRequiredParameterException 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) –
A required parameter is missing.
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.
There are no connectors available.
Example
try:
...
except client.exceptions.NoConnectorsAvailableException 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) –
There are no connectors 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.
This operation is not allowed.
Example
try:
...
except client.exceptions.OperationNotPermittedException 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) –
This operation is not allowed.
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 specified replication job already exists.
Example
try:
...
except client.exceptions.ReplicationJobAlreadyExistsException 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 specified replication job already exists.
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 specified replication job does not exist.
Example
try:
...
except client.exceptions.ReplicationJobNotFoundException 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 specified replication job does not exist.
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.
You have exceeded the number of on-demand replication runs you can request in a 24-hour period.
Example
try:
...
except client.exceptions.ReplicationRunLimitExceededException 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 have exceeded the number of on-demand replication runs you can request in a 24-hour period.
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 specified server cannot be replicated.
Example
try:
...
except client.exceptions.ServerCannotBeReplicatedException 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 specified server cannot be replicated.
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 service is temporarily unavailable.
Example
try:
...
except client.exceptions.TemporarilyUnavailableException 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
{}
Structure
(dict) –
The service is temporarily unavailable.
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.
You lack permissions needed to perform this operation. Check your IAM policies, and ensure that you are using the correct access keys.
Example
try:
...
except client.exceptions.UnauthorizedOperationException 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 lack permissions needed to perform this operation. Check your IAM policies, and ensure that you are using the correct access keys.
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('get_connectors')
Creates an iterator that will paginate through responses from SMS.Client.get_connectors()
.
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
{
'connectorList': [
{
'connectorId': 'string',
'version': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'capabilityList': [
'VSPHERE'|'SCVMM'|'HYPERV-MANAGER'|'SNAPSHOT_BATCHING'|'SMS_OPTIMIZED',
],
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmManagerId': 'string',
'ipAddress': 'string',
'macAddress': 'string',
'associatedOn': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
connectorList (list) –
Information about the registered connectors.
(dict) –
Represents a connector.
connectorId (string) –
The ID of the connector.
version (string) –
The connector version.
status (string) –
The status of the connector.
capabilityList (list) –
The capabilities of the connector.
(string) –
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The VM management product.
vmManagerId (string) –
The ID of the VM manager.
ipAddress (string) –
The IP address of the connector.
macAddress (string) –
The MAC address of the connector.
associatedOn (datetime) –
The time the connector was associated.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('get_replication_jobs')
Creates an iterator that will paginate through responses from SMS.Client.get_replication_jobs()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
replicationJobId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
replicationJobId (string) – The ID of the replication job.
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
{
'replicationJobList': [
{
'replicationJobId': 'string',
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'seedReplicationTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'nextReplicationRunStartTime': datetime(2015, 1, 1),
'licenseType': 'AWS'|'BYOL',
'roleName': 'string',
'latestAmiId': 'string',
'state': 'PENDING'|'ACTIVE'|'FAILED'|'DELETING'|'DELETED'|'COMPLETED'|'PAUSED_ON_FAILURE'|'FAILING',
'statusMessage': 'string',
'description': 'string',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string',
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
replicationJobList (list) –
Information about the replication jobs.
(dict) –
Represents a replication job.
replicationJobId (string) –
The ID of the replication job.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
seedReplicationTime (datetime) –
The seed replication time.
frequency (integer) –
The time between consecutive replication runs, in hours.
runOnce (boolean) –
Indicates whether to run the replication job one time.
nextReplicationRunStartTime (datetime) –
The start time of the next replication run.
licenseType (string) –
The license type to be used for the AMI created by a successful replication run.
roleName (string) –
The name of the IAM role to be used by Server Migration Service.
latestAmiId (string) –
The ID of the latest Amazon Machine Image (AMI).
state (string) –
The state of the replication job.
statusMessage (string) –
The description of the current status of the replication job.
description (string) –
The description of the replication job.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep in the customer’s account for a replication job. By default, the value is set to zero, meaning that all AMIs are kept.
encrypted (boolean) –
Indicates whether the replication job should produce encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('get_replication_runs')
Creates an iterator that will paginate through responses from SMS.Client.get_replication_runs()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
replicationJobId='string',
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
replicationJobId (string) –
[REQUIRED]
The ID of the replication job.
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
{
'replicationJob': {
'replicationJobId': 'string',
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'seedReplicationTime': datetime(2015, 1, 1),
'frequency': 123,
'runOnce': True|False,
'nextReplicationRunStartTime': datetime(2015, 1, 1),
'licenseType': 'AWS'|'BYOL',
'roleName': 'string',
'latestAmiId': 'string',
'state': 'PENDING'|'ACTIVE'|'FAILED'|'DELETING'|'DELETED'|'COMPLETED'|'PAUSED_ON_FAILURE'|'FAILING',
'statusMessage': 'string',
'description': 'string',
'numberOfRecentAmisToKeep': 123,
'encrypted': True|False,
'kmsKeyId': 'string',
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
]
},
'replicationRunList': [
{
'replicationRunId': 'string',
'state': 'PENDING'|'MISSED'|'ACTIVE'|'FAILED'|'COMPLETED'|'DELETING'|'DELETED',
'type': 'ON_DEMAND'|'AUTOMATIC',
'stageDetails': {
'stage': 'string',
'stageProgress': 'string'
},
'statusMessage': 'string',
'amiId': 'string',
'scheduledStartTime': datetime(2015, 1, 1),
'completedTime': datetime(2015, 1, 1),
'description': 'string',
'encrypted': True|False,
'kmsKeyId': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
replicationJob (dict) –
Information about the replication job.
replicationJobId (string) –
The ID of the replication job.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
seedReplicationTime (datetime) –
The seed replication time.
frequency (integer) –
The time between consecutive replication runs, in hours.
runOnce (boolean) –
Indicates whether to run the replication job one time.
nextReplicationRunStartTime (datetime) –
The start time of the next replication run.
licenseType (string) –
The license type to be used for the AMI created by a successful replication run.
roleName (string) –
The name of the IAM role to be used by Server Migration Service.
latestAmiId (string) –
The ID of the latest Amazon Machine Image (AMI).
state (string) –
The state of the replication job.
statusMessage (string) –
The description of the current status of the replication job.
description (string) –
The description of the replication job.
numberOfRecentAmisToKeep (integer) –
The number of recent AMIs to keep in the customer’s account for a replication job. By default, the value is set to zero, meaning that all AMIs are kept.
encrypted (boolean) –
Indicates whether the replication job should produce encrypted AMIs.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is enabled but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
replicationRunList (list) –
Information about the replication runs.
(dict) –
Represents a replication run.
replicationRunId (string) –
The ID of the replication run.
state (string) –
The state of the replication run.
type (string) –
The type of replication run.
stageDetails (dict) –
Details about the current stage of the replication run.
stage (string) –
The current stage of a replication run.
stageProgress (string) –
The progress of the current stage of a replication run.
statusMessage (string) –
The description of the current status of the replication job.
amiId (string) –
The ID of the Amazon Machine Image (AMI) from the replication run.
scheduledStartTime (datetime) –
The start time of the next replication run.
completedTime (datetime) –
The completion time of the last replication run.
description (string) –
The description of the replication run.
encrypted (boolean) –
Indicates whether the replication run should produce an encrypted AMI.
kmsKeyId (string) –
The ID of the KMS key for replication jobs that produce encrypted AMIs. This value can be any of the following:
KMS key ID
KMS key alias
ARN referring to the KMS key ID
ARN referring to the KMS key alias
If encrypted is true but a KMS key ID is not specified, the customer’s default KMS key for Amazon EBS is used.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('get_servers')
Creates an iterator that will paginate through responses from SMS.Client.get_servers()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
vmServerAddressList=[
{
'vmManagerId': 'string',
'vmId': 'string'
},
],
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
vmServerAddressList (list) –
The server addresses.
(dict) –
Represents a VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
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
{
'lastModifiedOn': datetime(2015, 1, 1),
'serverCatalogStatus': 'NOT_IMPORTED'|'IMPORTING'|'AVAILABLE'|'DELETED'|'EXPIRED',
'serverList': [
{
'serverId': 'string',
'serverType': 'VIRTUAL_MACHINE',
'vmServer': {
'vmServerAddress': {
'vmManagerId': 'string',
'vmId': 'string'
},
'vmName': 'string',
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmPath': 'string'
},
'replicationJobId': 'string',
'replicationJobTerminated': True|False
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
lastModifiedOn (datetime) –
The time when the server was last modified.
serverCatalogStatus (string) –
The status of the server catalog.
serverList (list) –
Information about the servers.
(dict) –
Represents a server.
serverId (string) –
The ID of the server.
serverType (string) –
The type of server.
vmServer (dict) –
Information about the VM server.
vmServerAddress (dict) –
The VM server location.
vmManagerId (string) –
The ID of the VM manager.
vmId (string) –
The ID of the VM.
vmName (string) –
The name of the VM.
vmManagerName (string) –
The name of the VM manager.
vmManagerType (string) –
The type of VM management product.
vmPath (string) –
The VM folder path in the vCenter Server virtual machine inventory tree.
replicationJobId (string) –
The ID of the replication job.
replicationJobTerminated (boolean) –
Indicates whether the replication job is deleted or failed.
NextToken (string) –
A token to resume pagination.
paginator = client.get_paginator('list_apps')
Creates an iterator that will paginate through responses from SMS.Client.list_apps()
.
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
appIds=[
'string',
],
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
appIds (list) –
The unique application IDs.
(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
{
'apps': [
{
'appId': 'string',
'importedAppId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
'replicationStatusMessage': 'string',
'latestReplicationTime': datetime(2015, 1, 1),
'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
'launchStatusMessage': 'string',
'launchDetails': {
'latestLaunchTime': datetime(2015, 1, 1),
'stackName': 'string',
'stackId': 'string'
},
'creationTime': datetime(2015, 1, 1),
'lastModified': datetime(2015, 1, 1),
'roleName': 'string',
'totalServerGroups': 123,
'totalServers': 123
},
],
'NextToken': 'string'
}
Response Structure
(dict) –
apps (list) –
The application summaries.
(dict) –
Information about the application.
appId (string) –
The unique ID of the application.
importedAppId (string) –
The ID of the application.
name (string) –
The name of the application.
description (string) –
The description of the application.
status (string) –
Status of the application.
statusMessage (string) –
A message related to the status of the application
replicationConfigurationStatus (string) –
Status of the replication configuration.
replicationStatus (string) –
The replication status of the application.
replicationStatusMessage (string) –
A message related to the replication status of the application.
latestReplicationTime (datetime) –
The timestamp of the application’s most recent successful replication.
launchConfigurationStatus (string) –
Status of the launch configuration.
launchStatus (string) –
The launch status of the application.
launchStatusMessage (string) –
A message related to the launch status of the application.
launchDetails (dict) –
Details about the latest launch of the application.
latestLaunchTime (datetime) –
The latest time that this application was launched successfully.
stackName (string) –
The name of the latest stack launched for this application.
stackId (string) –
The ID of the latest stack launched for this application.
creationTime (datetime) –
The creation time of the application.
lastModified (datetime) –
The last modified time of the application.
roleName (string) –
The name of the service role in the customer’s account used by Server Migration Service.
totalServerGroups (integer) –
The number of server groups present in the application.
totalServers (integer) –
The number of servers present in the application.
NextToken (string) –
A token to resume pagination.