Table of Contents
A low-level client representing AWS Server Migration Service (SMS):
import boto3
client = boto3.client('sms')
These are the available methods:
Check if an operation can be paginated.
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'
},
]
)
List of server groups to include in the application.
A logical grouping of servers.
Identifier of a server group.
Name of a server group.
List of servers belonging to a server group.
Represents a server.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
List of tags to be associated with the application.
A label that can be assigned to an application.
Tag key.
Tag value.
dict
Response Syntax
{
'appSummary': {
'appId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'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),
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'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) --
Summary description of the application.
appId (string) --
Unique ID of the application.
name (string) --
Name of the application.
description (string) --
Description of the application.
status (string) --
Status of the application.
statusMessage (string) --
A message related to the status of the application
replicationStatus (string) --
Replication status of the application.
replicationStatusMessage (string) --
A message related to the replication status of the application.
latestReplicationTime (datetime) --
Timestamp of the application's most recent successful replication.
launchStatus (string) --
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) --
Latest time this application was launched successfully.
stackName (string) --
Name of the latest stack launched for this application.
stackId (string) --
Identifier of the latest stack launched for this application.
creationTime (datetime) --
Time of creation of this application.
lastModified (datetime) --
Timestamp of the application's creation.
roleName (string) --
Name of the service role in the customer's account used by AWS SMS.
totalServerGroups (integer) --
Number of server groups present in the application.
totalServers (integer) --
Number of servers present in the application.
serverGroups (list) --
List of server groups included in the application.
(dict) --
A logical grouping of servers.
serverGroupId (string) --
Identifier of a server group.
name (string) --
Name of a server group.
serverList (list) --
List of servers belonging to a server group.
(dict) --
Represents a server.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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 identifier of the replication job.
replicationJobTerminated (boolean) --
Indicates whether the replication job is deleted or failed.
tags (list) --
List of taags associated with the application.
(dict) --
A label that can be assigned to an application.
key (string) --
Tag key.
value (string) --
Tag value.
Creates a replication job. The replication job schedules periodic replication runs to replicate your server to AWS. 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'
)
[REQUIRED]
The identifier of the server.
[REQUIRED]
The seed replication time.
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
dict
Response Syntax
{
'replicationJobId': 'string'
}
Response Structure
(dict) --
replicationJobId (string) --
The unique identifier of the replication job.
Deletes an existing application. Optionally deletes the launched stack associated with the application and all AWS SMS 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
)
dict
Response Syntax
{}
Response Structure
Deletes existing launch configuration for an application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app_launch_configuration(
appId='string'
)
{}
Response Structure
Deletes existing replication configuration for an application.
See also: AWS API Documentation
Request Syntax
response = client.delete_app_replication_configuration(
appId='string'
)
{}
Response Structure
Deletes the specified replication job.
After you delete a replication job, there are no further replication runs. AWS deletes the contents of the Amazon S3 bucket used to store AWS SMS 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'
)
[REQUIRED]
The identifier of the replication job.
{}
Response Structure
Deletes all servers from your server catalog.
See also: AWS API Documentation
Request Syntax
response = client.delete_server_catalog()
{}
Response Structure
Disassociates the specified connector from AWS SMS.
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'
)
[REQUIRED]
The identifier of the connector.
{}
Response Structure
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'
)
dict
Response Syntax
{
's3Location': {
'bucket': 'string',
'key': 'string'
}
}
Response Structure
(dict) --
s3Location (dict) --
Location of the Amazon S3 object.
bucket (string) --
Amazon S3 bucket name.
key (string) --
Amazon S3 bucket key.
Generate a presigned url given a client, its method, and arguments
The presigned url
Generates an Amazon 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'
)
dict
Response Syntax
{
's3Location': {
'bucket': 'string',
'key': 'string'
}
}
Response Structure
(dict) --
s3Location (dict) --
Location of the Amazon S3 object.
bucket (string) --
Amazon S3 bucket name.
key (string) --
Amazon S3 bucket key.
Retrieve information about an application.
See also: AWS API Documentation
Request Syntax
response = client.get_app(
appId='string'
)
{
'appSummary': {
'appId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'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),
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'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
Information about the application.
Unique ID of the application.
Name of the application.
Description of the application.
Status of the application.
A message related to the status of the application
Replication status of the application.
A message related to the replication status of the application.
Timestamp of the application's most recent successful replication.
Launch status of the application.
A message related to the launch status of the application.
Details about the latest launch of the application.
Latest time this application was launched successfully.
Name of the latest stack launched for this application.
Identifier of the latest stack launched for this application.
Time of creation of this application.
Timestamp of the application's creation.
Name of the service role in the customer's account used by AWS SMS.
Number of server groups present in the application.
Number of servers present in the application.
List of server groups belonging to the application.
A logical grouping of servers.
Identifier of a server group.
Name of a server group.
List of servers belonging to a server group.
Represents a server.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
List of tags associated with the application.
A label that can be assigned to an application.
Tag key.
Tag value.
Retrieves the application launch configuration associated with an application.
See also: AWS API Documentation
Request Syntax
response = client.get_app_launch_configuration(
appId='string'
)
{
'appId': 'string',
'roleName': 'string',
'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
},
]
},
]
}
Response Structure
ID of the application associated with the launch configuration.
Name of the service role in the customer's account that Amazon CloudFormation uses to launch the application.
List of launch configurations for server groups in this application.
Launch configuration for a server group.
Identifier of the server group the launch configuration is associated with.
Launch order of servers in the server group.
Launch configuration for servers in the server group.
Launch configuration for a server.
Identifier of the server the launch configuration is associated with.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
Logical ID of the server in the Amazon CloudFormation template.
Identifier of the VPC the server should be launched into.
Identifier of the subnet the server should be launched into.
Identifier of the security group that applies to the launched server.
Name of the EC2 SSH Key to be used for connecting to the launched server.
Location of the user-data script to be executed when launching the server.
Amazon S3 location of the user-data script.
Amazon S3 bucket name.
Amazon S3 bucket key.
Instance type to be used for launching the server.
If true, a publicly accessible IP address is created when launching the server.
Retrieves an application replication configuration associatd with an application.
See also: AWS API Documentation
Request Syntax
response = client.get_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'
}
},
]
},
]
}
Response Structure
Replication configurations associated with server groups in this application.
Replication configuration for a server group.
Identifier of the server group this replication configuration is associated with.
Replication configuration for servers in the server group.
Replication configuration of a server.
Identifier of the server this replication configuration is associated with.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
Parameters for replicating the server.
Seed time for creating a replication job for the server.
Frequency of creating replication jobs for the server.
License type for creating a replication job for the server.
Number of recent AMIs to keep when creating a replication job for this server.
When true, the replication job produces encrypted AMIs. See also KmsKeyId below.
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
Describes the connectors registered with the AWS SMS.
See also: AWS API Documentation
Request Syntax
response = client.get_connectors(
nextToken='string',
maxResults=123
)
dict
Response Syntax
{
'connectorList': [
{
'connectorId': 'string',
'version': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'capabilityList': [
'VSPHERE'|'SCVMM'|'HYPERV-MANAGER'|'SNAPSHOT_BATCHING',
],
'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 identifier of the connector.
version (string) --
The connector version.
status (string) --
The status of the connector.
capabilityList (list) --
The capabilities of the connector.
vmManagerName (string) --
The name of the VM manager.
vmManagerType (string) --
The VM management product.
vmManagerId (string) --
The identifier 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.
Create a paginator for an operation.
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
)
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 identifier of the replication job.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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) --
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 the 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) --
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) --
Whether the replication job should produce encrypted AMIs or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for 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.
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
)
[REQUIRED]
The identifier of the replication job.
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 identifier of the replication job.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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) --
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 the 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) --
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) --
Whether the replication job should produce encrypted AMIs or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for 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.
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'
},
]
)
List of VmServerAddress objects
Represents a VM server location.
The identifier of the VM manager.
The identifier 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 identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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 identifier 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.
Returns an object that can wait for some condition.
Gathers a complete list of on-premises servers. Connectors must be installed and monitoring all servers that you want 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()
{}
Response Structure
Launches an application stack.
See also: AWS API Documentation
Request Syntax
response = client.launch_app(
appId='string'
)
{}
Response Structure
Returns a list of summaries for all applications.
See also: AWS API Documentation
Request Syntax
response = client.list_apps(
appIds=[
'string',
],
nextToken='string',
maxResults=123
)
dict
Response Syntax
{
'apps': [
{
'appId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'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),
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'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) --
A list of application summaries.
(dict) --
Information about the application.
appId (string) --
Unique ID of the application.
name (string) --
Name of the application.
description (string) --
Description of the application.
status (string) --
Status of the application.
statusMessage (string) --
A message related to the status of the application
replicationStatus (string) --
Replication status of the application.
replicationStatusMessage (string) --
A message related to the replication status of the application.
latestReplicationTime (datetime) --
Timestamp of the application's most recent successful replication.
launchStatus (string) --
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) --
Latest time this application was launched successfully.
stackName (string) --
Name of the latest stack launched for this application.
stackId (string) --
Identifier of the latest stack launched for this application.
creationTime (datetime) --
Time of creation of this application.
lastModified (datetime) --
Timestamp of the application's creation.
roleName (string) --
Name of the service role in the customer's account used by AWS SMS.
totalServerGroups (integer) --
Number of server groups present in the application.
totalServers (integer) --
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.
Creates a launch configuration for an application.
See also: AWS API Documentation
Request Syntax
response = client.put_app_launch_configuration(
appId='string',
roleName='string',
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
},
]
},
]
)
Launch configurations for server groups in the application.
Launch configuration for a server group.
Identifier of the server group the launch configuration is associated with.
Launch order of servers in the server group.
Launch configuration for servers in the server group.
Launch configuration for a server.
Identifier of the server the launch configuration is associated with.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
Logical ID of the server in the Amazon CloudFormation template.
Identifier of the VPC the server should be launched into.
Identifier of the subnet the server should be launched into.
Identifier of the security group that applies to the launched server.
Name of the EC2 SSH Key to be used for connecting to the launched server.
Location of the user-data script to be executed when launching the server.
Amazon S3 location of the user-data script.
Amazon S3 bucket name.
Amazon S3 bucket key.
Instance type to be used for launching the server.
If true, a publicly accessible IP address is created when launching the server.
dict
Response Syntax
{}
Response Structure
Creates or updates a replication configuration for an 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'
}
},
]
},
]
)
Replication configurations for server groups in the application.
Replication configuration for a server group.
Identifier of the server group this replication configuration is associated with.
Replication configuration for servers in the server group.
Replication configuration of a server.
Identifier of the server this replication configuration is associated with.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
Parameters for replicating the server.
Seed time for creating a replication job for the server.
Frequency of creating replication jobs for the server.
License type for creating a replication job for the server.
Number of recent AMIs to keep when creating a replication job for this server.
When true, the replication job produces encrypted AMIs. See also KmsKeyId below.
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
dict
Response Syntax
{}
Response Structure
Starts replicating an application.
See also: AWS API Documentation
Request Syntax
response = client.start_app_replication(
appId='string'
)
{}
Response Structure
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 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'
)
[REQUIRED]
The identifier of the replication job.
dict
Response Syntax
{
'replicationRunId': 'string'
}
Response Structure
(dict) --
replicationRunId (string) --
The identifier of the replication run.
Stops replicating an application.
See also: AWS API Documentation
Request Syntax
response = client.stop_app_replication(
appId='string'
)
{}
Response Structure
Terminates the stack for an application.
See also: AWS API Documentation
Request Syntax
response = client.terminate_app(
appId='string'
)
{}
Response Structure
Updates an 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'
},
]
)
List of server groups in the application to update.
A logical grouping of servers.
Identifier of a server group.
Name of a server group.
List of servers belonging to a server group.
Represents a server.
The identifier of the server.
The type of server.
Information about the VM server.
Information about the VM server location.
The identifier of the VM manager.
The identifier of the VM.
The name of the VM.
The name of the VM manager.
The type of VM management product.
The VM folder path in the vCenter Server virtual machine inventory tree.
The identifier of the replication job.
Indicates whether the replication job is deleted or failed.
List of tags to associate with the application.
A label that can be assigned to an application.
Tag key.
Tag value.
dict
Response Syntax
{
'appSummary': {
'appId': 'string',
'name': 'string',
'description': 'string',
'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
'statusMessage': 'string',
'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'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),
'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'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) --
Summary description of the application.
appId (string) --
Unique ID of the application.
name (string) --
Name of the application.
description (string) --
Description of the application.
status (string) --
Status of the application.
statusMessage (string) --
A message related to the status of the application
replicationStatus (string) --
Replication status of the application.
replicationStatusMessage (string) --
A message related to the replication status of the application.
latestReplicationTime (datetime) --
Timestamp of the application's most recent successful replication.
launchStatus (string) --
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) --
Latest time this application was launched successfully.
stackName (string) --
Name of the latest stack launched for this application.
stackId (string) --
Identifier of the latest stack launched for this application.
creationTime (datetime) --
Time of creation of this application.
lastModified (datetime) --
Timestamp of the application's creation.
roleName (string) --
Name of the service role in the customer's account used by AWS SMS.
totalServerGroups (integer) --
Number of server groups present in the application.
totalServers (integer) --
Number of servers present in the application.
serverGroups (list) --
List of updated server groups in the application.
(dict) --
A logical grouping of servers.
serverGroupId (string) --
Identifier of a server group.
name (string) --
Name of a server group.
serverList (list) --
List of servers belonging to a server group.
(dict) --
Represents a server.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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 identifier of the replication job.
replicationJobTerminated (boolean) --
Indicates whether the replication job is deleted or failed.
tags (list) --
List of tags associated with the application.
(dict) --
A label that can be assigned to an application.
key (string) --
Tag key.
value (string) --
Tag value.
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'
)
[REQUIRED]
The identifier of the replication job.
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
dict
Response Syntax
{}
Response Structure
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'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
{
'connectorList': [
{
'connectorId': 'string',
'version': 'string',
'status': 'HEALTHY'|'UNHEALTHY',
'capabilityList': [
'VSPHERE'|'SCVMM'|'HYPERV-MANAGER'|'SNAPSHOT_BATCHING',
],
'vmManagerName': 'string',
'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
'vmManagerId': 'string',
'ipAddress': 'string',
'macAddress': 'string',
'associatedOn': datetime(2015, 1, 1)
},
],
'NextToken': 'string'
}
Response Structure
Information about the registered connectors.
Represents a connector.
The identifier of the connector.
The connector version.
The status of the connector.
The capabilities of the connector.
The name of the VM manager.
The VM management product.
The identifier of the VM manager.
The IP address of the connector.
The MAC address of the connector.
The time the connector was associated.
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'
}
)
A dictionary that provides parameters to control pagination.
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.
The size of each page.
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 identifier of the replication job.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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) --
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 the 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) --
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) --
Whether the replication job should produce encrypted AMIs or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for 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'
}
)
[REQUIRED]
The identifier of the replication job.
A dictionary that provides parameters to control pagination.
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.
The size of each page.
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 identifier of the replication job.
serverId (string) --
The identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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) --
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 the 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) --
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) --
Whether the replication job should produce encrypted AMIs or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for EBS is used.
replicationRunList (list) --
Information about the replication runs.
(dict) --
Represents a replication run.
replicationRunId (string) --
The identifier of the replication run.
state (string) --
The state of the replication run.
type (string) --
The type of replication run.
stageDetails (dict) --
Details of the current stage of the replication run.
stage (string) --
String describing the current stage of a replication run.
stageProgress (string) --
String describing 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 identifier 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) --
Whether the replication run should produce encrypted AMI or not. See also KmsKeyId below.
kmsKeyId (string) --
KMS key ID for replication jobs that produce encrypted AMIs. Can be any of the following:
If encrypted is true but a KMS key id is not specified, the customer's default KMS key for 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'
}
)
List of VmServerAddress objects
Represents a VM server location.
The identifier of the VM manager.
The identifier of the VM.
A dictionary that provides parameters to control pagination.
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.
The size of each page.
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 identifier of the server.
serverType (string) --
The type of server.
vmServer (dict) --
Information about the VM server.
vmServerAddress (dict) --
Information about the VM server location.
vmManagerId (string) --
The identifier of the VM manager.
vmId (string) --
The identifier 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 identifier of the replication job.
replicationJobTerminated (boolean) --
Indicates whether the replication job is deleted or failed.
NextToken (string) --
A token to resume pagination.