Mgn
This page documents function available when using the Mgn
module, created with @service Mgn
.
Index
Main.Mgn.change_server_life_cycle_state
Main.Mgn.create_replication_configuration_template
Main.Mgn.delete_job
Main.Mgn.delete_replication_configuration_template
Main.Mgn.delete_source_server
Main.Mgn.describe_job_log_items
Main.Mgn.describe_jobs
Main.Mgn.describe_replication_configuration_templates
Main.Mgn.describe_source_servers
Main.Mgn.disconnect_from_service
Main.Mgn.finalize_cutover
Main.Mgn.get_launch_configuration
Main.Mgn.get_replication_configuration
Main.Mgn.initialize_service
Main.Mgn.list_tags_for_resource
Main.Mgn.mark_as_archived
Main.Mgn.retry_data_replication
Main.Mgn.start_cutover
Main.Mgn.start_test
Main.Mgn.tag_resource
Main.Mgn.terminate_target_instances
Main.Mgn.untag_resource
Main.Mgn.update_launch_configuration
Main.Mgn.update_replication_configuration
Main.Mgn.update_replication_configuration_template
Documentation
Main.Mgn.change_server_life_cycle_state
— Methodchange_server_life_cycle_state(life_cycle, source_server_id)
change_server_life_cycle_state(life_cycle, source_server_id, params::Dict{String,<:Any})
Allows the user to set the SourceServer.LifeCycle.state property for specific Source Server IDs to one of the following: READYFORTEST or READYFORCUTOVER. This command only works if the Source Server is already launchable (dataReplicationInfo.lagDuration is not null.)
Arguments
life_cycle
: The request to change the source server migration lifecycle state.source_server_id
: The request to change the source server migration lifecycle state by source server ID.
Main.Mgn.create_replication_configuration_template
— Methodcreate_replication_configuration_template(associate_default_security_group, bandwidth_throttling, create_public_ip, data_plane_routing, default_large_staging_disk_type, ebs_encryption, replication_server_instance_type, replication_servers_security_groups_ids, staging_area_subnet_id, staging_area_tags, use_dedicated_replication_server)
create_replication_configuration_template(associate_default_security_group, bandwidth_throttling, create_public_ip, data_plane_routing, default_large_staging_disk_type, ebs_encryption, replication_server_instance_type, replication_servers_security_groups_ids, staging_area_subnet_id, staging_area_tags, use_dedicated_replication_server, params::Dict{String,<:Any})
Creates a new ReplicationConfigurationTemplate.
Arguments
associate_default_security_group
: Request to associate the default Application Migration Service Security group with the Replication Settings template.bandwidth_throttling
: Request to configure bandwidth throttling during Replication Settings template creation.create_public_ip
: Request to create Public IP during Replication Settings template creation.data_plane_routing
: Request to configure data plane routing during Replication Settings template creation.default_large_staging_disk_type
: Request to configure the Staging Disk EBS volume type to "gp2" during Replication Settings template creation.ebs_encryption
: Request to configure EBS enryption during Replication Settings template creation.replication_server_instance_type
: Request to configure the Replication Server instance type during Replication Settings template creation.replication_servers_security_groups_ids
: Request to configure the Replication Server Secuirity group ID during Replication Settings template creation.staging_area_subnet_id
: Request to configure the Staging Area subnet ID during Replication Settings template creation.staging_area_tags
: Request to configure Staiging Area tags during Replication Settings template creation.use_dedicated_replication_server
: Request to use Dedicated Replication Servers during Replication Settings template creation.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ebsEncryptionKeyArn"
: Request to configure an EBS enryption key during Replication Settings template creation."tags"
: Request to configure tags during Replication Settings template creation.
Main.Mgn.delete_job
— Methoddelete_job(job_id)
delete_job(job_id, params::Dict{String,<:Any})
Deletes a single Job by ID.
Arguments
job_id
: Request to delete Job from service by Job ID.
Main.Mgn.delete_replication_configuration_template
— Methoddelete_replication_configuration_template(replication_configuration_template_id)
delete_replication_configuration_template(replication_configuration_template_id, params::Dict{String,<:Any})
Deletes a single Replication Configuration Template by ID
Arguments
replication_configuration_template_id
: Request to delete Replication Configuration Template from service by Replication Configuration Template ID.
Main.Mgn.delete_source_server
— Methoddelete_source_server(source_server_id)
delete_source_server(source_server_id, params::Dict{String,<:Any})
Deletes a single source server by ID.
Arguments
source_server_id
: Request to delete Source Server from service by Server ID.
Main.Mgn.describe_job_log_items
— Methoddescribe_job_log_items(job_id)
describe_job_log_items(job_id, params::Dict{String,<:Any})
Retrieves detailed Job log with paging.
Arguments
job_id
: Request to describe Job log job ID.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: Request to describe Job log item maximum results."nextToken"
: Request to describe Job log next token.
Main.Mgn.describe_jobs
— Methoddescribe_jobs(filters)
describe_jobs(filters, params::Dict{String,<:Any})
Returns a list of Jobs. Use the JobsID and fromDate and toData filters to limit which jobs are returned. The response is sorted by creationDataTime - latest date first. Jobs are normaly created by the StartTest, StartCutover, and TerminateTargetInstances APIs. Jobs are also created by DiagnosticLaunch and TerminateDiagnosticInstances, which are APIs available only to Support and only used in response to relevant support tickets.
Arguments
filters
: Request to describe Job log filters.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: Request to describe Job log by max results."nextToken"
: Request to describe Job logby next token.
Main.Mgn.describe_replication_configuration_templates
— Methoddescribe_replication_configuration_templates(replication_configuration_template_ids)
describe_replication_configuration_templates(replication_configuration_template_ids, params::Dict{String,<:Any})
Lists all ReplicationConfigurationTemplates, filtered by Source Server IDs.
Arguments
replication_configuration_template_ids
: Request to describe Replication Configuration template by template IDs.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: Request to describe Replication Configuration template by max results."nextToken"
: Request to describe Replication Configuration template by next token.
Main.Mgn.describe_source_servers
— Methoddescribe_source_servers(filters)
describe_source_servers(filters, params::Dict{String,<:Any})
Retrieves all SourceServers or multiple SourceServers by ID.
Arguments
filters
: Request to filter Source Servers list.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: Request to filter Source Servers list by maximum results."nextToken"
: Request to filter Source Servers list by next token.
Main.Mgn.disconnect_from_service
— Methoddisconnect_from_service(source_server_id)
disconnect_from_service(source_server_id, params::Dict{String,<:Any})
Disconnects specific Source Servers from Application Migration Service. Data replication is stopped immediately. All AWS resources created by Application Migration Service for enabling the replication of these source servers will be terminated / deleted within 90 minutes. Launched Test or Cutover instances will NOT be terminated. If the agent on the source server has not been prevented from communciating with the Application Migration Service service, then it will receive a command to uninstall itself (within approximately 10 minutes). The following properties of the SourceServer will be changed immediately: dataReplicationInfo.dataReplicationState will be set to DISCONNECTED; The totalStorageBytes property for each of dataReplicationInfo.replicatedDisks will be set to zero; dataReplicationInfo.lagDuration and dataReplicationInfo.lagDurationwill be nullified.
Arguments
source_server_id
: Request to disconnect Source Server from service by Server ID.
Main.Mgn.finalize_cutover
— Methodfinalize_cutover(source_server_id)
finalize_cutover(source_server_id, params::Dict{String,<:Any})
Finalizes the cutover immediately for specific Source Servers. All AWS resources created by Application Migration Service for enabling the replication of these source servers will be terminated / deleted within 90 minutes. Launched Test or Cutover instances will NOT be terminated. The AWS Replication Agent will receive a command to uninstall itself (within 10 minutes). The following properties of the SourceServer will be changed immediately: dataReplicationInfo.dataReplicationState will be to DISCONNECTED; The SourceServer.lifeCycle.state will be changed to CUTOVER; The totalStorageBytes property fo each of dataReplicationInfo.replicatedDisks will be set to zero; dataReplicationInfo.lagDuration and dataReplicationInfo.lagDurationwill be nullified.
Arguments
source_server_id
: Request to finalize Cutover by Soure Server ID.
Main.Mgn.get_launch_configuration
— Methodget_launch_configuration(source_server_id)
get_launch_configuration(source_server_id, params::Dict{String,<:Any})
Lists all LaunchConfigurations available, filtered by Source Server IDs.
Arguments
source_server_id
: Request to get Launch Configuration information by Source Server ID.
Main.Mgn.get_replication_configuration
— Methodget_replication_configuration(source_server_id)
get_replication_configuration(source_server_id, params::Dict{String,<:Any})
Lists all ReplicationConfigurations, filtered by Source Server ID.
Arguments
source_server_id
: Request to get Replication Configuaration by Source Server ID.
Main.Mgn.initialize_service
— Methodinitialize_service()
initialize_service(params::Dict{String,<:Any})
Initialize Application Migration Service.
Main.Mgn.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
List all tags for your Application Migration Service resources.
Arguments
resource_arn
: List tags for resource request by ARN.
Main.Mgn.mark_as_archived
— Methodmark_as_archived(source_server_id)
mark_as_archived(source_server_id, params::Dict{String,<:Any})
Archives specific Source Servers by setting the SourceServer.isArchived property to true for specified SourceServers by ID. This command only works for SourceServers with a lifecycle.state which equals DISCONNECTED or CUTOVER.
Arguments
source_server_id
: Mark as archived by Source Server ID.
Main.Mgn.retry_data_replication
— Methodretry_data_replication(source_server_id)
retry_data_replication(source_server_id, params::Dict{String,<:Any})
Causes the data replication initiation sequence to begin immediately upon next Handshake for specified SourceServer IDs, regardless of when the previous initiation started. This command will not work if the SourceServer is not stalled or is in a DISCONNECTED or STOPPED state.
Arguments
source_server_id
: Retry data replication for Source Server ID.
Main.Mgn.start_cutover
— Methodstart_cutover(source_server_ids)
start_cutover(source_server_ids, params::Dict{String,<:Any})
Launches a Cutover Instance for specific Source Servers. This command starts a LAUNCH job whose initiatedBy property is StartCutover and changes the SourceServer.lifeCycle.state property to CUTTING_OVER.
Arguments
source_server_ids
: Start Cutover by Source Server IDs.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"tags"
: Start Cutover by Tags.
Main.Mgn.start_test
— Methodstart_test(source_server_ids)
start_test(source_server_ids, params::Dict{String,<:Any})
Lauches a Test Instance for specific Source Servers. This command starts a LAUNCH job whose initiatedBy property is StartTest and changes the SourceServer.lifeCycle.state property to TESTING.
Arguments
source_server_ids
: Start Test for Source Server IDs.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"tags"
: Start Test by Tags.
Main.Mgn.tag_resource
— Methodtag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})
Adds or overwrites only the specified tags for the specified Application Migration Service resource or resources. When you specify an existing tag key, the value is overwritten with the new value. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value.
Arguments
resource_arn
: Tag resource by ARN.tags
: Tag resource by Tags.
Main.Mgn.terminate_target_instances
— Methodterminate_target_instances(source_server_ids)
terminate_target_instances(source_server_ids, params::Dict{String,<:Any})
Starts a job that terminates specific launched EC2 Test and Cutover instances. This command will not work for any Source Server with a lifecycle.state of TESTING, CUTTING_OVER, or CUTOVER.
Arguments
source_server_ids
: Terminate Target instance by Source Server IDs.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"tags"
: Terminate Target instance by Tags.
Main.Mgn.untag_resource
— Methoduntag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})
Deletes the specified set of tags from the specified set of Application Migration Service resources.
Arguments
resource_arn
: Untag resource by ARN.tag_keys
: Untag resource by Keys.
Main.Mgn.update_launch_configuration
— Methodupdate_launch_configuration(source_server_id)
update_launch_configuration(source_server_id, params::Dict{String,<:Any})
Updates multiple LaunchConfigurations by Source Server ID.
Arguments
source_server_id
: Update Launch configuration by Source Server ID request.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"copyPrivateIp"
: Update Launch configuration copy Private IP request."copyTags"
: Update Launch configuration copy Tags request."launchDisposition"
: Update Launch configuration launch disposition request."licensing"
: Update Launch configuration licensing request."name"
: Update Launch configuration name request."targetInstanceTypeRightSizingMethod"
: Update Launch configuration Target instance right sizing request.
Main.Mgn.update_replication_configuration
— Methodupdate_replication_configuration(source_server_id)
update_replication_configuration(source_server_id, params::Dict{String,<:Any})
Allows you to update multiple ReplicationConfigurations by Source Server ID.
Arguments
source_server_id
: Update replication configuration Source Server ID request.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"associateDefaultSecurityGroup"
: Update replication configuration associate default Application Migration Service Security group request."bandwidthThrottling"
: Update replication configuration bandwidth throttling request."createPublicIP"
: Update replication configuration create Public IP request."dataPlaneRouting"
: Update replication configuration data plane routing request."defaultLargeStagingDiskType"
: Update replication configuration use default large Staging Disk type request."ebsEncryption"
: Update replication configuration EBS encryption request."ebsEncryptionKeyArn"
: Update replication configuration EBS encryption key ARN request."name"
: Update replication configuration name request."replicatedDisks"
: Update replication configuration replicated disks request."replicationServerInstanceType"
: Update replication configuration Replication Server instance type request."replicationServersSecurityGroupsIDs"
: Update replication configuration Replication Server Security Groups IDs request."stagingAreaSubnetId"
: Update replication configuration Staging Area subnet request."stagingAreaTags"
: Update replication configuration Staging Area Tags request."useDedicatedReplicationServer"
: Update replication configuration use dedicated Replication Server request.
Main.Mgn.update_replication_configuration_template
— Methodupdate_replication_configuration_template(replication_configuration_template_id)
update_replication_configuration_template(replication_configuration_template_id, params::Dict{String,<:Any})
Updates multiple ReplicationConfigurationTemplates by ID.
Arguments
replication_configuration_template_id
: Update replication configuration template template ID request.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"arn"
: Update replication configuration template ARN request."associateDefaultSecurityGroup"
: Update replication configuration template associate default Application Migration Service Security group request."bandwidthThrottling"
: Update replication configuration template bandwidth throttling request."createPublicIP"
: Update replication configuration template create Public IP request."dataPlaneRouting"
: Update replication configuration template data plane routing request."defaultLargeStagingDiskType"
: Update replication configuration template use default large Staging Disk type request."ebsEncryption"
: Update replication configuration template EBS encryption request."ebsEncryptionKeyArn"
: Update replication configuration template EBS encryption key ARN request."replicationServerInstanceType"
: Update replication configuration template Replication Server instance type request."replicationServersSecurityGroupsIDs"
: Update replication configuration template Replication Server Security groups IDs request."stagingAreaSubnetId"
: Update replication configuration template Staging Area subnet ID request."stagingAreaTags"
: Update replication configuration template Staging Area Tags request."useDedicatedReplicationServer"
: Update replication configuration template use dedicated Replication Server request.