Class: AWS.Mgn
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.Mgn
- Identifier:
- mgn
- API Version:
- 2020-02-26
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
The Application Migration Service service.
Sending a Request Using Mgn
var mgn = new AWS.Mgn();
mgn.terminateTargetInstances(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the Mgn object uses this specific API, you can
construct the object by passing the apiVersion
option to the constructor:
var mgn = new AWS.Mgn({apiVersion: '2020-02-26'});
You can also set the API version globally in AWS.config.apiVersions
using
the mgn service identifier:
AWS.config.apiVersions = {
mgn: '2020-02-26',
// other service API versions
};
var mgn = new AWS.Mgn();
Version:
-
2020-02-26
Constructor Summary collapse
-
new AWS.Mgn(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
archiveApplication(params = {}, callback) ⇒ AWS.Request
Archive application.
.
-
archiveWave(params = {}, callback) ⇒ AWS.Request
Archive wave.
.
-
associateApplications(params = {}, callback) ⇒ AWS.Request
Associate applications to wave.
.
-
associateSourceServers(params = {}, callback) ⇒ AWS.Request
Associate source servers to application.
.
-
changeServerLifeCycleState(params = {}, callback) ⇒ AWS.Request
Allows the user to set the SourceServer.LifeCycle.state property for specific Source Server IDs to one of the following: READY_FOR_TEST or READY_FOR_CUTOVER.
-
createApplication(params = {}, callback) ⇒ AWS.Request
Create application.
.
-
createConnector(params = {}, callback) ⇒ AWS.Request
Create Connector.
.
-
createLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Creates a new Launch Configuration Template.
.
-
createReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Creates a new ReplicationConfigurationTemplate.
.
-
createWave(params = {}, callback) ⇒ AWS.Request
Create wave.
.
-
deleteApplication(params = {}, callback) ⇒ AWS.Request
Delete application.
.
-
deleteConnector(params = {}, callback) ⇒ AWS.Request
Delete Connector.
.
-
deleteJob(params = {}, callback) ⇒ AWS.Request
Deletes a single Job by ID.
.
-
deleteLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a single Launch Configuration Template by ID.
.
-
deleteReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a single Replication Configuration Template by ID
.
-
deleteSourceServer(params = {}, callback) ⇒ AWS.Request
Deletes a single source server by ID.
.
-
deleteVcenterClient(params = {}, callback) ⇒ AWS.Request
Deletes a given vCenter client by ID.
.
-
deleteWave(params = {}, callback) ⇒ AWS.Request
Delete wave.
.
-
describeJobLogItems(params = {}, callback) ⇒ AWS.Request
Retrieves detailed job log items with paging.
.
-
describeJobs(params = {}, callback) ⇒ AWS.Request
Returns a list of Jobs.
-
describeLaunchConfigurationTemplates(params = {}, callback) ⇒ AWS.Request
Lists all Launch Configuration Templates, filtered by Launch Configuration Template IDs
.
-
describeReplicationConfigurationTemplates(params = {}, callback) ⇒ AWS.Request
Lists all ReplicationConfigurationTemplates, filtered by Source Server IDs.
.
-
describeSourceServers(params = {}, callback) ⇒ AWS.Request
Retrieves all SourceServers or multiple SourceServers by ID.
.
-
describeVcenterClients(params = {}, callback) ⇒ AWS.Request
Returns a list of the installed vCenter clients.
.
-
disassociateApplications(params = {}, callback) ⇒ AWS.Request
Disassociate applications from wave.
.
-
disassociateSourceServers(params = {}, callback) ⇒ AWS.Request
Disassociate source servers from application.
.
-
disconnectFromService(params = {}, callback) ⇒ AWS.Request
Disconnects specific Source Servers from Application Migration Service.
-
finalizeCutover(params = {}, callback) ⇒ AWS.Request
Finalizes the cutover immediately for specific Source Servers.
-
getLaunchConfiguration(params = {}, callback) ⇒ AWS.Request
Lists all LaunchConfigurations available, filtered by Source Server IDs.
.
-
getReplicationConfiguration(params = {}, callback) ⇒ AWS.Request
Lists all ReplicationConfigurations, filtered by Source Server ID.
.
-
initializeService(params = {}, callback) ⇒ AWS.Request
Initialize Application Migration Service.
.
-
listApplications(params = {}, callback) ⇒ AWS.Request
Retrieves all applications or multiple applications by ID.
.
-
listConnectors(params = {}, callback) ⇒ AWS.Request
List Connectors.
.
-
listExportErrors(params = {}, callback) ⇒ AWS.Request
List export errors.
.
-
listExports(params = {}, callback) ⇒ AWS.Request
List exports.
.
-
listImportErrors(params = {}, callback) ⇒ AWS.Request
List import errors.
.
-
listImports(params = {}, callback) ⇒ AWS.Request
List imports.
.
-
listManagedAccounts(params = {}, callback) ⇒ AWS.Request
List Managed Accounts.
.
-
listSourceServerActions(params = {}, callback) ⇒ AWS.Request
List source server post migration custom actions.
.
-
listTagsForResource(params = {}, callback) ⇒ AWS.Request
List all tags for your Application Migration Service resources.
.
-
listTemplateActions(params = {}, callback) ⇒ AWS.Request
List template post migration custom actions.
.
-
listWaves(params = {}, callback) ⇒ AWS.Request
Retrieves all waves or multiple waves by ID.
.
-
markAsArchived(params = {}, callback) ⇒ AWS.Request
Archives specific Source Servers by setting the SourceServer.isArchived property to true for specified SourceServers by ID.
-
pauseReplication(params = {}, callback) ⇒ AWS.Request
Pause Replication.
.
-
putSourceServerAction(params = {}, callback) ⇒ AWS.Request
Put source server post migration custom action.
.
-
putTemplateAction(params = {}, callback) ⇒ AWS.Request
Put template post migration custom action.
.
-
removeSourceServerAction(params = {}, callback) ⇒ AWS.Request
Remove source server post migration custom action.
.
-
removeTemplateAction(params = {}, callback) ⇒ AWS.Request
Remove template post migration custom action.
.
-
resumeReplication(params = {}, callback) ⇒ AWS.Request
Resume Replication.
.
-
retryDataReplication(params = {}, callback) ⇒ AWS.Request
Causes the data replication initiation sequence to begin immediately upon next Handshake for specified SourceServer IDs, regardless of when the previous initiation started.
-
startCutover(params = {}, callback) ⇒ AWS.Request
Launches a Cutover Instance for specific Source Servers.
-
startExport(params = {}, callback) ⇒ AWS.Request
Start export.
.
-
startImport(params = {}, callback) ⇒ AWS.Request
Start import.
.
-
startReplication(params = {}, callback) ⇒ AWS.Request
Starts replication for SNAPSHOT_SHIPPING agents.
.
-
startTest(params = {}, callback) ⇒ AWS.Request
Launches a Test Instance for specific Source Servers.
-
stopReplication(params = {}, callback) ⇒ AWS.Request
Stop Replication.
.
-
tagResource(params = {}, callback) ⇒ AWS.Request
Adds or overwrites only the specified tags for the specified Application Migration Service resource or resources.
-
terminateTargetInstances(params = {}, callback) ⇒ AWS.Request
Starts a job that terminates specific launched EC2 Test and Cutover instances.
-
unarchiveApplication(params = {}, callback) ⇒ AWS.Request
Unarchive application.
.
-
unarchiveWave(params = {}, callback) ⇒ AWS.Request
Unarchive wave.
.
-
untagResource(params = {}, callback) ⇒ AWS.Request
Deletes the specified set of tags from the specified set of Application Migration Service resources.
.
-
updateApplication(params = {}, callback) ⇒ AWS.Request
Update application.
.
-
updateConnector(params = {}, callback) ⇒ AWS.Request
Update Connector.
.
-
updateLaunchConfiguration(params = {}, callback) ⇒ AWS.Request
Updates multiple LaunchConfigurations by Source Server ID.
Note: bootMode valid values are.LEGACY_BIOS | UEFI
-
updateLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Updates an existing Launch Configuration Template by ID.
.
-
updateReplicationConfiguration(params = {}, callback) ⇒ AWS.Request
Allows you to update multiple ReplicationConfigurations by Source Server ID.
.
-
updateReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Updates multiple ReplicationConfigurationTemplates by ID.
.
-
updateSourceServer(params = {}, callback) ⇒ AWS.Request
Update Source Server.
.
-
updateSourceServerReplicationType(params = {}, callback) ⇒ AWS.Request
Allows you to change between the AGENT_BASED replication type and the SNAPSHOT_SHIPPING replication type.
.
-
updateWave(params = {}, callback) ⇒ AWS.Request
Update wave.
.
Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService
Constructor Details
new AWS.Mgn(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Examples:
Constructing a Mgn object
var mgn = new AWS.Mgn({apiVersion: '2020-02-26'});
Options Hash (options):
-
params
(map)
—
An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.
-
endpoint
(String|AWS.Endpoint)
—
The endpoint URI to send requests to. The default endpoint is built from the configured
region
. The endpoint should be a string like'https://{service}.{region}.amazonaws.com'
or an Endpoint object. -
accessKeyId
(String)
—
your AWS access key ID.
-
secretAccessKey
(String)
—
your AWS secret access key.
-
sessionToken
(AWS.Credentials)
—
the optional AWS session token to sign requests with.
-
credentials
(AWS.Credentials)
—
the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.
-
credentialProvider
(AWS.CredentialProviderChain)
—
the provider chain used to resolve credentials if no static
credentials
property is set. -
region
(String)
—
the region to send service requests to. See AWS.Mgn.region for more information.
-
maxRetries
(Integer)
—
the maximum amount of retries to attempt with a request. See AWS.Mgn.maxRetries for more information.
-
maxRedirects
(Integer)
—
the maximum amount of redirects to follow with a request. See AWS.Mgn.maxRedirects for more information.
-
sslEnabled
(Boolean)
—
whether to enable SSL for requests.
-
paramValidation
(Boolean|map)
—
whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:
- min [Boolean] — Validates that a value meets the min
constraint. This is enabled by default when paramValidation is set
to
true
. - max [Boolean] — Validates that a value meets the max constraint.
- pattern [Boolean] — Validates that a string value matches a regular expression.
- enum [Boolean] — Validates that a string value matches one of the allowable enum values.
- min [Boolean] — Validates that a value meets the min
constraint. This is enabled by default when paramValidation is set
to
-
computeChecksums
(Boolean)
—
whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)
-
convertResponseTypes
(Boolean)
—
whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to
true
. -
correctClockSkew
(Boolean)
—
whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to
false
. -
s3ForcePathStyle
(Boolean)
—
whether to force path style URLs for S3 objects.
-
s3BucketEndpoint
(Boolean)
—
whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an
endpoint
to be provided explicitly to the service constructor. -
s3DisableBodySigning
(Boolean)
—
whether S3 body signing should be disabled when using signature version
v4
. Body signing can only be disabled when using https. Defaults totrue
. -
s3UsEast1RegionalEndpoint
('legacy'|'regional')
—
when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to
legacy
-
s3UseArnRegion
(Boolean)
—
whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to
true
-
retryDelayOptions
(map)
—
A set of options to configure the retry delay on retryable errors. Currently supported options are:
- base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
- customBackoff [function] — A custom function that accepts a
retry count and error and returns the amount of time to delay in
milliseconds. If the result is a non-zero negative value, no further
retry attempts will be made. The
base
option will be ignored if this option is supplied. The function is only called for retryable errors.
-
httpOptions
(map)
—
A set of options to pass to the low-level HTTP request. Currently supported options are:
- proxy [String] — the URL to proxy requests through
- agent [http.Agent, https.Agent] — the Agent object to perform
HTTP requests with. Used for connection pooling. Defaults to the global
agent (
http.globalAgent
) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment. - connectTimeout [Integer] — Sets the socket to timeout after
failing to establish a connection with the server after
connectTimeout
milliseconds. This timeout has no effect once a socket connection has been established. - timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
- xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
- xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
-
apiVersion
(String, Date)
—
a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by
apiVersions
). Specify 'latest' to use the latest possible version. -
apiVersions
(map<String, String|Date>)
—
a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.
-
logger
(#write, #log)
—
an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests
-
systemClockOffset
(Number)
—
an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global
AWS.config
object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds. -
signatureVersion
(String)
—
the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.
-
signatureCache
(Boolean)
—
whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to
true
. -
dynamoDbCrc32
(Boolean)
—
whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default:
true
. -
useAccelerateEndpoint
(Boolean)
—
Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default:
false
. -
clientSideMonitoring
(Boolean)
—
whether to collect and publish this client's performance metrics of all its API requests.
-
endpointDiscoveryEnabled
(Boolean|undefined)
—
whether to call operations with endpoints given by service dynamically. Setting this
-
endpointCacheSize
(Number)
—
the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000
-
hostPrefixEnabled
(Boolean)
—
whether to marshal request parameters to the prefix of hostname. Defaults to
true
. -
stsRegionalEndpoints
('legacy'|'regional')
—
whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.
-
useFipsEndpoint
(Boolean)
—
Enables FIPS compatible endpoints. Defaults to
false
. -
useDualstackEndpoint
(Boolean)
—
Enables IPv6 dualstack endpoint. Defaults to
false
.
Property Details
Method Details
archiveApplication(params = {}, callback) ⇒ AWS.Request
Archive application.
Service Reference:
Examples:
Calling the archiveApplication operation
var params = {
applicationID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.archiveApplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationAggregatedStatus
— (map
)Application aggregated status.
healthStatus
— (String
)Application aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Application aggregated status last update dateTime.
progressStatus
— (String
)Application aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
totalSourceServers
— (Integer
)Application aggregated status total source servers amount.
applicationID
— (String
)Application ID.
arn
— (String
)Application ARN.
creationDateTime
— (String
)Application creation dateTime.
description
— (String
)Application description.
isArchived
— (Boolean
)Application archival status.
lastModifiedDateTime
— (String
)Application last modified dateTime.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
waveID
— (String
)Application wave ID.
-
(AWS.Response)
—
Returns:
archiveWave(params = {}, callback) ⇒ AWS.Request
Archive wave.
Service Reference:
Examples:
Calling the archiveWave operation
var params = {
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.archiveWave(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Wave ARN.
creationDateTime
— (String
)Wave creation dateTime.
description
— (String
)Wave description.
isArchived
— (Boolean
)Wave archival status.
lastModifiedDateTime
— (String
)Wave last modified dateTime.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
waveAggregatedStatus
— (map
)Wave aggregated status.
healthStatus
— (String
)Wave aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Wave aggregated status last update dateTime.
progressStatus
— (String
)Wave aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
replicationStartedDateTime
— (String
)DateTime marking when the first source server in the wave started replication.
totalApplications
— (Integer
)Wave aggregated status total applications amount.
waveID
— (String
)Wave ID.
-
(AWS.Response)
—
Returns:
associateApplications(params = {}, callback) ⇒ AWS.Request
Associate applications to wave.
Service Reference:
Examples:
Calling the associateApplications operation
var params = {
applicationIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.associateApplications(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationIDs
— (Array<String>
)Application IDs list.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
associateSourceServers(params = {}, callback) ⇒ AWS.Request
Associate source servers to application.
Service Reference:
Examples:
Calling the associateSourceServers operation
var params = {
applicationID: 'STRING_VALUE', /* required */
sourceServerIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
accountID: 'STRING_VALUE'
};
mgn.associateSourceServers(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
sourceServerIDs
— (Array<String>
)Source server IDs list.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
changeServerLifeCycleState(params = {}, callback) ⇒ AWS.Request
Allows the user to set the SourceServer.LifeCycle.state property for specific Source Server IDs to one of the following: READY_FOR_TEST or READY_FOR_CUTOVER. This command only works if the Source Server is already launchable (dataReplicationInfo.lagDuration is not null.)
Service Reference:
Examples:
Calling the changeServerLifeCycleState operation
var params = {
lifeCycle: { /* required */
state: READY_FOR_TEST | READY_FOR_CUTOVER | CUTOVER /* required */
},
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.changeServerLifeCycleState(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)The request to change the source server migration account ID.
lifeCycle
— (map
)The request to change the source server migration lifecycle state.
state
— required — (String
)The request to change the source server migration lifecycle state.
Possible values include:"READY_FOR_TEST"
"READY_FOR_CUTOVER"
"CUTOVER"
sourceServerID
— (String
)The request to change the source server migration lifecycle state by source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
createApplication(params = {}, callback) ⇒ AWS.Request
Create application.
Service Reference:
Examples:
Calling the createApplication operation
var params = {
name: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
description: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.createApplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
description
— (String
)Application description.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationAggregatedStatus
— (map
)Application aggregated status.
healthStatus
— (String
)Application aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Application aggregated status last update dateTime.
progressStatus
— (String
)Application aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
totalSourceServers
— (Integer
)Application aggregated status total source servers amount.
applicationID
— (String
)Application ID.
arn
— (String
)Application ARN.
creationDateTime
— (String
)Application creation dateTime.
description
— (String
)Application description.
isArchived
— (Boolean
)Application archival status.
lastModifiedDateTime
— (String
)Application last modified dateTime.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
waveID
— (String
)Application wave ID.
-
(AWS.Response)
—
Returns:
createConnector(params = {}, callback) ⇒ AWS.Request
Create Connector.
Service Reference:
Examples:
Calling the createConnector operation
var params = {
name: 'STRING_VALUE', /* required */
ssmInstanceID: 'STRING_VALUE', /* required */
ssmCommandConfig: {
cloudWatchOutputEnabled: true || false, /* required */
s3OutputEnabled: true || false, /* required */
cloudWatchLogGroupName: 'STRING_VALUE',
outputS3BucketName: 'STRING_VALUE'
},
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.createConnector(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
name
— (String
)Create Connector request name.
ssmCommandConfig
— (map
)Create Connector request SSM command config.
cloudWatchLogGroupName
— (String
)Connector SSM command config CloudWatch log group name.
cloudWatchOutputEnabled
— required — (Boolean
)Connector SSM command config CloudWatch output enabled.
outputS3BucketName
— (String
)Connector SSM command config output S3 bucket name.
s3OutputEnabled
— required — (Boolean
)Connector SSM command config S3 output enabled.
ssmInstanceID
— (String
)Create Connector request SSM instance ID.
tags
— (map<String>
)Create Connector request tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Connector arn.
connectorID
— (String
)Connector ID.
name
— (String
)Connector name.
ssmCommandConfig
— (map
)Connector SSM command config.
cloudWatchLogGroupName
— (String
)Connector SSM command config CloudWatch log group name.
cloudWatchOutputEnabled
— required — (Boolean
)Connector SSM command config CloudWatch output enabled.
outputS3BucketName
— (String
)Connector SSM command config output S3 bucket name.
s3OutputEnabled
— required — (Boolean
)Connector SSM command config S3 output enabled.
ssmInstanceID
— (String
)Connector SSM instance ID.
tags
— (map<String>
)Connector tags.
-
(AWS.Response)
—
Returns:
createLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Creates a new Launch Configuration Template.
Service Reference:
Examples:
Calling the createLaunchConfigurationTemplate operation
var params = {
associatePublicIpAddress: true || false,
bootMode: LEGACY_BIOS | UEFI | USE_SOURCE,
copyPrivateIp: true || false,
copyTags: true || false,
enableMapAutoTagging: true || false,
largeVolumeConf: {
iops: 'NUMBER_VALUE',
throughput: 'NUMBER_VALUE',
volumeType: io1 | io2 | gp3 | gp2 | st1 | sc1 | standard
},
launchDisposition: STOPPED | STARTED,
licensing: {
osByol: true || false
},
mapAutoTaggingMpeID: 'STRING_VALUE',
postLaunchActions: {
cloudWatchLogGroupName: 'STRING_VALUE',
deployment: TEST_AND_CUTOVER | CUTOVER_ONLY | TEST_ONLY,
s3LogBucket: 'STRING_VALUE',
s3OutputKeyPrefix: 'STRING_VALUE',
ssmDocuments: [
{
actionName: 'STRING_VALUE', /* required */
ssmDocumentName: 'STRING_VALUE', /* required */
externalParameters: {
'<SsmDocumentParameterName>': {
dynamicPath: 'STRING_VALUE'
},
/* '<SsmDocumentParameterName>': ... */
},
mustSucceedForCutover: true || false,
parameters: {
'<SsmDocumentParameterName>': [
{
parameterName: 'STRING_VALUE', /* required */
parameterType: STRING /* required */
},
/* more items */
],
/* '<SsmDocumentParameterName>': ... */
},
timeoutSeconds: 'NUMBER_VALUE'
},
/* more items */
]
},
smallVolumeConf: {
iops: 'NUMBER_VALUE',
throughput: 'NUMBER_VALUE',
volumeType: io1 | io2 | gp3 | gp2 | st1 | sc1 | standard
},
smallVolumeMaxSize: 'NUMBER_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
},
targetInstanceTypeRightSizingMethod: NONE | BASIC
};
mgn.createLaunchConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
associatePublicIpAddress
— (Boolean
)Associate public Ip address.
bootMode
— (String
)Launch configuration template boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy private Ip.
copyTags
— (Boolean
)Copy tags.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
largeVolumeConf
— (map
)Large volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
launchDisposition
— (String
)Launch disposition.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Configure Licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration template map auto tagging MPE ID.
postLaunchActions
— (map
)Launch configuration template post launch actions.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
smallVolumeConf
— (map
)Small volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
smallVolumeMaxSize
— (Integer
)Small volume maximum size.
tags
— (map<String>
)Request to associate tags during creation of a Launch Configuration Template.
targetInstanceTypeRightSizingMethod
— (String
)Target instance type right-sizing method.
Possible values include:"NONE"
"BASIC"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)ARN of the Launch Configuration Template.
associatePublicIpAddress
— (Boolean
)Associate public Ip address.
bootMode
— (String
)Launch configuration template boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy private Ip.
copyTags
— (Boolean
)Copy tags.
ec2LaunchTemplateID
— (String
)EC2 launch template ID.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
largeVolumeConf
— (map
)Large volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
launchConfigurationTemplateID
— (String
)ID of the Launch Configuration Template.
launchDisposition
— (String
)Launch disposition.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Configure Licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration template map auto tagging MPE ID.
postLaunchActions
— (map
)Post Launch Actions of the Launch Configuration Template.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
smallVolumeConf
— (map
)Small volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
smallVolumeMaxSize
— (Integer
)Small volume maximum size.
tags
— (map<String>
)Tags of the Launch Configuration Template.
targetInstanceTypeRightSizingMethod
— (String
)Target instance type right-sizing method.
Possible values include:"NONE"
"BASIC"
-
(AWS.Response)
—
Returns:
createReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Creates a new ReplicationConfigurationTemplate.
Service Reference:
Examples:
Calling the createReplicationConfigurationTemplate operation
var params = {
associateDefaultSecurityGroup: true || false, /* required */
bandwidthThrottling: 'NUMBER_VALUE', /* required */
createPublicIP: true || false, /* required */
dataPlaneRouting: PRIVATE_IP | PUBLIC_IP, /* required */
defaultLargeStagingDiskType: GP2 | ST1 | GP3, /* required */
ebsEncryption: DEFAULT | CUSTOM, /* required */
replicationServerInstanceType: 'STRING_VALUE', /* required */
replicationServersSecurityGroupsIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
stagingAreaSubnetId: 'STRING_VALUE', /* required */
stagingAreaTags: { /* required */
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
},
useDedicatedReplicationServer: true || false, /* required */
ebsEncryptionKeyArn: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
},
useFipsEndpoint: true || false
};
mgn.createReplicationConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
associateDefaultSecurityGroup
— (Boolean
)Request to associate the default Application Migration Service Security group with the Replication Settings template.
bandwidthThrottling
— (Integer
)Request to configure bandwidth throttling during Replication Settings template creation.
createPublicIP
— (Boolean
)Request to create Public IP during Replication Settings template creation.
dataPlaneRouting
— (String
)Request to configure data plane routing during Replication Settings template creation.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Request to configure the default large staging disk EBS volume type during Replication Settings template creation.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Request to configure EBS encryption during Replication Settings template creation.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Request to configure an EBS encryption key during Replication Settings template creation.
replicationServerInstanceType
— (String
)Request to configure the Replication Server instance type during Replication Settings template creation.
replicationServersSecurityGroupsIDs
— (Array<String>
)Request to configure the Replication Server Security group ID during Replication Settings template creation.
stagingAreaSubnetId
— (String
)Request to configure the Staging Area subnet ID during Replication Settings template creation.
stagingAreaTags
— (map<String>
)Request to configure Staging Area tags during Replication Settings template creation.
tags
— (map<String>
)Request to configure tags during Replication Settings template creation.
useDedicatedReplicationServer
— (Boolean
)Request to use Dedicated Replication Servers during Replication Settings template creation.
useFipsEndpoint
— (Boolean
)Request to use Fips Endpoint during Replication Settings template creation.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Replication Configuration template ARN.
associateDefaultSecurityGroup
— (Boolean
)Replication Configuration template associate default Application Migration Service Security group.
bandwidthThrottling
— (Integer
)Replication Configuration template bandwidth throttling.
createPublicIP
— (Boolean
)Replication Configuration template create Public IP.
dataPlaneRouting
— (String
)Replication Configuration template data plane routing.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Replication Configuration template use default large Staging Disk type.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Replication Configuration template EBS encryption.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Replication Configuration template EBS encryption key ARN.
replicationConfigurationTemplateID
— (String
)Replication Configuration template ID.
replicationServerInstanceType
— (String
)Replication Configuration template server instance type.
replicationServersSecurityGroupsIDs
— (Array<String>
)Replication Configuration template server Security Groups IDs.
stagingAreaSubnetId
— (String
)Replication Configuration template Staging Area subnet ID.
stagingAreaTags
— (map<String>
)Replication Configuration template Staging Area Tags.
tags
— (map<String>
)Replication Configuration template Tags.
useDedicatedReplicationServer
— (Boolean
)Replication Configuration template use Dedicated Replication Server.
useFipsEndpoint
— (Boolean
)Replication Configuration template use Fips Endpoint.
-
(AWS.Response)
—
Returns:
createWave(params = {}, callback) ⇒ AWS.Request
Create wave.
Service Reference:
Examples:
Calling the createWave operation
var params = {
name: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
description: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.createWave(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
description
— (String
)Wave description.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Wave ARN.
creationDateTime
— (String
)Wave creation dateTime.
description
— (String
)Wave description.
isArchived
— (Boolean
)Wave archival status.
lastModifiedDateTime
— (String
)Wave last modified dateTime.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
waveAggregatedStatus
— (map
)Wave aggregated status.
healthStatus
— (String
)Wave aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Wave aggregated status last update dateTime.
progressStatus
— (String
)Wave aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
replicationStartedDateTime
— (String
)DateTime marking when the first source server in the wave started replication.
totalApplications
— (Integer
)Wave aggregated status total applications amount.
waveID
— (String
)Wave ID.
-
(AWS.Response)
—
Returns:
deleteApplication(params = {}, callback) ⇒ AWS.Request
Delete application.
Service Reference:
Examples:
Calling the deleteApplication operation
var params = {
applicationID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.deleteApplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteConnector(params = {}, callback) ⇒ AWS.Request
Delete Connector.
Service Reference:
Examples:
Calling the deleteConnector operation
var params = {
connectorID: 'STRING_VALUE' /* required */
};
mgn.deleteConnector(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
connectorID
— (String
)Delete Connector request connector ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteJob(params = {}, callback) ⇒ AWS.Request
Deletes a single Job by ID.
Service Reference:
Examples:
Calling the deleteJob operation
var params = {
jobID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.deleteJob(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to delete Job from service by Account ID.
jobID
— (String
)Request to delete Job from service by Job ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a single Launch Configuration Template by ID.
Service Reference:
Examples:
Calling the deleteLaunchConfigurationTemplate operation
var params = {
launchConfigurationTemplateID: 'STRING_VALUE' /* required */
};
mgn.deleteLaunchConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
launchConfigurationTemplateID
— (String
)ID of resource to be deleted.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a single Replication Configuration Template by ID
Service Reference:
Examples:
Calling the deleteReplicationConfigurationTemplate operation
var params = {
replicationConfigurationTemplateID: 'STRING_VALUE' /* required */
};
mgn.deleteReplicationConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
replicationConfigurationTemplateID
— (String
)Request to delete Replication Configuration Template from service by Replication Configuration Template ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteSourceServer(params = {}, callback) ⇒ AWS.Request
Deletes a single source server by ID.
Service Reference:
Examples:
Calling the deleteSourceServer operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.deleteSourceServer(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to delete Source Server from service by Account ID.
sourceServerID
— (String
)Request to delete Source Server from service by Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteVcenterClient(params = {}, callback) ⇒ AWS.Request
Deletes a given vCenter client by ID.
Service Reference:
Examples:
Calling the deleteVcenterClient operation
var params = {
vcenterClientID: 'STRING_VALUE' /* required */
};
mgn.deleteVcenterClient(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
vcenterClientID
— (String
)ID of resource to be deleted.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteWave(params = {}, callback) ⇒ AWS.Request
Delete wave.
Service Reference:
Examples:
Calling the deleteWave operation
var params = {
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.deleteWave(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
describeJobLogItems(params = {}, callback) ⇒ AWS.Request
Retrieves detailed job log items with paging.
Service Reference:
Examples:
Calling the describeJobLogItems operation
var params = {
jobID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.describeJobLogItems(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to describe Job log Account ID.
jobID
— (String
)Request to describe Job log job ID.
maxResults
— (Integer
)Request to describe Job log item maximum results.
nextToken
— (String
)Request to describe Job log next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Request to describe Job log response items.
event
— (String
)Job log event.
Possible values include:"JOB_START"
"SERVER_SKIPPED"
"CLEANUP_START"
"CLEANUP_END"
"CLEANUP_FAIL"
"SNAPSHOT_START"
"SNAPSHOT_END"
"SNAPSHOT_FAIL"
"USING_PREVIOUS_SNAPSHOT"
"CONVERSION_START"
"CONVERSION_END"
"CONVERSION_FAIL"
"LAUNCH_START"
"LAUNCH_FAILED"
"JOB_CANCEL"
"JOB_END"
eventData
— (map
)Job event data
conversionServerID
— (String
)Job Event conversion Server ID.
rawError
— (String
)Job error.
sourceServerID
— (String
)Job Event Source Server ID.
targetInstanceID
— (String
)Job Event Target instance ID.
logDateTime
— (String
)Job log event date and time.
nextToken
— (String
)Request to describe Job log response next token.
-
(AWS.Response)
—
Returns:
describeJobs(params = {}, callback) ⇒ AWS.Request
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 normally 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.
Service Reference:
Examples:
Calling the describeJobs operation
var params = {
accountID: 'STRING_VALUE',
filters: {
fromDate: 'STRING_VALUE',
jobIDs: [
'STRING_VALUE',
/* more items */
],
toDate: 'STRING_VALUE'
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.describeJobs(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to describe job log items by Account ID.
filters
— (map
)Request to describe Job log filters.
fromDate
— (String
)Request to describe Job log filters by date.
jobIDs
— (Array<String>
)Request to describe Job log filters by job ID.
toDate
— (String
)Request to describe job log items by last date.
maxResults
— (Integer
)Request to describe job log items by max results.
nextToken
— (String
)Request to describe job log items by next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Request to describe Job log items.
arn
— (String
)the ARN of the specific Job.
creationDateTime
— (String
)Job creation time.
endDateTime
— (String
)Job end time.
initiatedBy
— (String
)Job initiated by field.
Possible values include:"START_TEST"
"START_CUTOVER"
"DIAGNOSTIC"
"TERMINATE"
jobID
— required — (String
)Job ID.
participatingServers
— (Array<map>
)Servers participating in a specific Job.
launchStatus
— (String
)Participating server launch status.
Possible values include:"PENDING"
"IN_PROGRESS"
"LAUNCHED"
"FAILED"
"TERMINATED"
launchedEc2InstanceID
— (String
)Participating server's launched ec2 instance ID.
postLaunchActionsStatus
— (map
)Participating server's Post Launch Actions Status.
postLaunchActionsLaunchStatusList
— (Array<map>
)List of Post Launch Action status.
executionID
— (String
)AWS Systems Manager Document's execution ID of the of the Job Post Launch Actions.
executionStatus
— (String
)AWS Systems Manager Document's execution status.
Possible values include:"IN_PROGRESS"
"SUCCESS"
"FAILED"
failureReason
— (String
)AWS Systems Manager Document's failure reason.
ssmDocument
— (map
)AWS Systems Manager's Document of the of the Job Post Launch Actions.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
ssmDocumentType
— (String
)AWS Systems Manager Document type.
Possible values include:"AUTOMATION"
"COMMAND"
ssmAgentDiscoveryDatetime
— (String
)Time where the AWS Systems Manager was detected as running on the Test or Cutover instance.
sourceServerID
— required — (String
)Participating server Source Server ID.
status
— (String
)Job status.
Possible values include:"PENDING"
"STARTED"
"COMPLETED"
tags
— (map<String>
)Tags associated with specific Job.
type
— (String
)Job type.
Possible values include:"LAUNCH"
"TERMINATE"
nextToken
— (String
)Request to describe Job response by next token.
-
(AWS.Response)
—
Returns:
describeLaunchConfigurationTemplates(params = {}, callback) ⇒ AWS.Request
Lists all Launch Configuration Templates, filtered by Launch Configuration Template IDs
Service Reference:
Examples:
Calling the describeLaunchConfigurationTemplates operation
var params = {
launchConfigurationTemplateIDs: [
'STRING_VALUE',
/* more items */
],
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.describeLaunchConfigurationTemplates(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
launchConfigurationTemplateIDs
— (Array<String>
)Request to filter Launch Configuration Templates list by Launch Configuration Template ID.
maxResults
— (Integer
)Maximum results to be returned in DescribeLaunchConfigurationTemplates.
nextToken
— (String
)Next pagination token returned from DescribeLaunchConfigurationTemplates.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List of items returned by DescribeLaunchConfigurationTemplates.
arn
— (String
)ARN of the Launch Configuration Template.
associatePublicIpAddress
— (Boolean
)Associate public Ip address.
bootMode
— (String
)Launch configuration template boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy private Ip.
copyTags
— (Boolean
)Copy tags.
ec2LaunchTemplateID
— (String
)EC2 launch template ID.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
largeVolumeConf
— (map
)Large volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
launchConfigurationTemplateID
— required — (String
)ID of the Launch Configuration Template.
launchDisposition
— (String
)Launch disposition.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Configure Licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration template map auto tagging MPE ID.
postLaunchActions
— (map
)Post Launch Actions of the Launch Configuration Template.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
smallVolumeConf
— (map
)Small volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
smallVolumeMaxSize
— (Integer
)Small volume maximum size.
tags
— (map<String>
)Tags of the Launch Configuration Template.
targetInstanceTypeRightSizingMethod
— (String
)Target instance type right-sizing method.
Possible values include:"NONE"
"BASIC"
nextToken
— (String
)Next pagination token returned from DescribeLaunchConfigurationTemplates.
-
(AWS.Response)
—
Returns:
describeReplicationConfigurationTemplates(params = {}, callback) ⇒ AWS.Request
Lists all ReplicationConfigurationTemplates, filtered by Source Server IDs.
Service Reference:
Examples:
Calling the describeReplicationConfigurationTemplates operation
var params = {
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE',
replicationConfigurationTemplateIDs: [
'STRING_VALUE',
/* more items */
]
};
mgn.describeReplicationConfigurationTemplates(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
maxResults
— (Integer
)Request to describe Replication Configuration template by max results.
nextToken
— (String
)Request to describe Replication Configuration template by next token.
replicationConfigurationTemplateIDs
— (Array<String>
)Request to describe Replication Configuration template by template IDs.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Request to describe Replication Configuration template by items.
arn
— (String
)Replication Configuration template ARN.
associateDefaultSecurityGroup
— (Boolean
)Replication Configuration template associate default Application Migration Service Security group.
bandwidthThrottling
— (Integer
)Replication Configuration template bandwidth throttling.
createPublicIP
— (Boolean
)Replication Configuration template create Public IP.
dataPlaneRouting
— (String
)Replication Configuration template data plane routing.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Replication Configuration template use default large Staging Disk type.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Replication Configuration template EBS encryption.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Replication Configuration template EBS encryption key ARN.
replicationConfigurationTemplateID
— required — (String
)Replication Configuration template ID.
replicationServerInstanceType
— (String
)Replication Configuration template server instance type.
replicationServersSecurityGroupsIDs
— (Array<String>
)Replication Configuration template server Security Groups IDs.
stagingAreaSubnetId
— (String
)Replication Configuration template Staging Area subnet ID.
stagingAreaTags
— (map<String>
)Replication Configuration template Staging Area Tags.
tags
— (map<String>
)Replication Configuration template Tags.
useDedicatedReplicationServer
— (Boolean
)Replication Configuration template use Dedicated Replication Server.
useFipsEndpoint
— (Boolean
)Replication Configuration template use Fips Endpoint.
nextToken
— (String
)Request to describe Replication Configuration template by next token.
-
(AWS.Response)
—
Returns:
describeSourceServers(params = {}, callback) ⇒ AWS.Request
Retrieves all SourceServers or multiple SourceServers by ID.
Service Reference:
Examples:
Calling the describeSourceServers operation
var params = {
accountID: 'STRING_VALUE',
filters: {
applicationIDs: [
'STRING_VALUE',
/* more items */
],
isArchived: true || false,
lifeCycleStates: [
STOPPED | NOT_READY | READY_FOR_TEST | TESTING | READY_FOR_CUTOVER | CUTTING_OVER | CUTOVER | DISCONNECTED | DISCOVERED | PENDING_INSTALLATION,
/* more items */
],
replicationTypes: [
AGENT_BASED | SNAPSHOT_SHIPPING,
/* more items */
],
sourceServerIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.describeSourceServers(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to filter Source Servers list by Accoun ID.
filters
— (map
)Request to filter Source Servers list.
applicationIDs
— (Array<String>
)Request to filter Source Servers list by application IDs.
isArchived
— (Boolean
)Request to filter Source Servers list by archived.
lifeCycleStates
— (Array<String>
)Request to filter Source Servers list by life cycle states.
replicationTypes
— (Array<String>
)Request to filter Source Servers list by replication type.
sourceServerIDs
— (Array<String>
)Request to filter Source Servers list by Source Server ID.
maxResults
— (Integer
)Request to filter Source Servers list by maximum results.
nextToken
— (String
)Request to filter Source Servers list by next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Request to filter Source Servers list by item.
applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
nextToken
— (String
)Request to filter Source Servers next token.
-
(AWS.Response)
—
Returns:
describeVcenterClients(params = {}, callback) ⇒ AWS.Request
Returns a list of the installed vCenter clients.
Service Reference:
Examples:
Calling the describeVcenterClients operation
var params = {
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.describeVcenterClients(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
maxResults
— (Integer
)Maximum results to be returned in DescribeVcenterClients.
nextToken
— (String
)Next pagination token to be provided for DescribeVcenterClients.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List of items returned by DescribeVcenterClients.
arn
— (String
)Arn of vCenter client.
datacenterName
— (String
)Datacenter name of vCenter client.
hostname
— (String
)Hostname of vCenter client .
lastSeenDatetime
— (String
)Last seen time of vCenter client.
sourceServerTags
— (map<String>
)Tags for Source Server of vCenter client.
tags
— (map<String>
)Tags for vCenter client.
vcenterClientID
— (String
)ID of vCenter client.
vcenterUUID
— (String
)Vcenter UUID of vCenter client.
nextToken
— (String
)Next pagination token returned from DescribeVcenterClients.
-
(AWS.Response)
—
Returns:
disassociateApplications(params = {}, callback) ⇒ AWS.Request
Disassociate applications from wave.
Service Reference:
Examples:
Calling the disassociateApplications operation
var params = {
applicationIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.disassociateApplications(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationIDs
— (Array<String>
)Application IDs list.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
disassociateSourceServers(params = {}, callback) ⇒ AWS.Request
Disassociate source servers from application.
Service Reference:
Examples:
Calling the disassociateSourceServers operation
var params = {
applicationID: 'STRING_VALUE', /* required */
sourceServerIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
accountID: 'STRING_VALUE'
};
mgn.disassociateSourceServers(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
sourceServerIDs
— (Array<String>
)Source server IDs list.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
disconnectFromService(params = {}, callback) ⇒ AWS.Request
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 communicating 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.lagDuration will be nullified.
Service Reference:
Examples:
Calling the disconnectFromService operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.disconnectFromService(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to disconnect Source Server from service by Account ID.
sourceServerID
— (String
)Request to disconnect Source Server from service by Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
finalizeCutover(params = {}, callback) ⇒ AWS.Request
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 changed 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.lagDuration will be nullified.
Service Reference:
Examples:
Calling the finalizeCutover operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.finalizeCutover(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to finalize Cutover by Source Account ID.
sourceServerID
— (String
)Request to finalize Cutover by Source Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
getLaunchConfiguration(params = {}, callback) ⇒ AWS.Request
Lists all LaunchConfigurations available, filtered by Source Server IDs.
Service Reference:
Examples:
Calling the getLaunchConfiguration operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.getLaunchConfiguration(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to get Launch Configuration information by Account ID.
sourceServerID
— (String
)Request to get Launch Configuration information by Source Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:bootMode
— (String
)Launch configuration boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy Private IP during Launch Configuration.
copyTags
— (Boolean
)Copy Tags during Launch Configuration.
ec2LaunchTemplateID
— (String
)Launch configuration EC2 Launch template ID.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
launchDisposition
— (String
)Launch disposition for launch configuration.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Launch configuration OS licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Map auto tagging MPE ID.
name
— (String
)Launch configuration name.
postLaunchActions
— (map
)Post Launch Actions to executed on the Test or Cutover instance.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
sourceServerID
— (String
)Launch configuration Source Server ID.
targetInstanceTypeRightSizingMethod
— (String
)Launch configuration Target instance type right sizing method.
Possible values include:"NONE"
"BASIC"
-
(AWS.Response)
—
Returns:
getReplicationConfiguration(params = {}, callback) ⇒ AWS.Request
Lists all ReplicationConfigurations, filtered by Source Server ID.
Service Reference:
Examples:
Calling the getReplicationConfiguration operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.getReplicationConfiguration(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request to get Replication Configuration by Account ID.
sourceServerID
— (String
)Request to get Replication Configuration by Source Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:associateDefaultSecurityGroup
— (Boolean
)Replication Configuration associate default Application Migration Service Security Group.
bandwidthThrottling
— (Integer
)Replication Configuration set bandwidth throttling.
createPublicIP
— (Boolean
)Replication Configuration create Public IP.
dataPlaneRouting
— (String
)Replication Configuration data plane routing.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Replication Configuration use default large Staging Disks.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Replication Configuration EBS encryption.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Replication Configuration EBS encryption key ARN.
name
— (String
)Replication Configuration name.
replicatedDisks
— (Array<map>
)Replication Configuration replicated disks.
deviceName
— (String
)Replication Configuration replicated disk device name.
iops
— (Integer
)Replication Configuration replicated disk IOPs.
isBootDisk
— (Boolean
)Replication Configuration replicated disk boot disk.
stagingDiskType
— (String
)Replication Configuration replicated disk staging disk type.
Possible values include:"AUTO"
"GP2"
"IO1"
"SC1"
"ST1"
"STANDARD"
"GP3"
"IO2"
throughput
— (Integer
)Replication Configuration replicated disk throughput.
replicationServerInstanceType
— (String
)Replication Configuration Replication Server instance type.
replicationServersSecurityGroupsIDs
— (Array<String>
)Replication Configuration Replication Server Security Group IDs.
sourceServerID
— (String
)Replication Configuration Source Server ID.
stagingAreaSubnetId
— (String
)Replication Configuration Staging Area subnet ID.
stagingAreaTags
— (map<String>
)Replication Configuration Staging Area tags.
useDedicatedReplicationServer
— (Boolean
)Replication Configuration use Dedicated Replication Server.
useFipsEndpoint
— (Boolean
)Replication Configuration use Fips Endpoint.
-
(AWS.Response)
—
Returns:
initializeService(params = {}, callback) ⇒ AWS.Request
Initialize Application Migration Service.
Service Reference:
Examples:
Calling the initializeService operation
var params = {
};
mgn.initializeService(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
- params (Object) (defaults to: {})
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
listApplications(params = {}, callback) ⇒ AWS.Request
Retrieves all applications or multiple applications by ID.
Service Reference:
Examples:
Calling the listApplications operation
var params = {
accountID: 'STRING_VALUE',
filters: {
applicationIDs: [
'STRING_VALUE',
/* more items */
],
isArchived: true || false,
waveIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listApplications(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Applications list Account ID.
filters
— (map
)Applications list filters.
applicationIDs
— (Array<String>
)Filter applications list by application ID.
isArchived
— (Boolean
)Filter applications list by archival status.
waveIDs
— (Array<String>
)Filter applications list by wave ID.
maxResults
— (Integer
)Maximum results to return when listing applications.
nextToken
— (String
)Request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Applications list.
applicationAggregatedStatus
— (map
)Application aggregated status.
healthStatus
— (String
)Application aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Application aggregated status last update dateTime.
progressStatus
— (String
)Application aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
totalSourceServers
— (Integer
)Application aggregated status total source servers amount.
applicationID
— (String
)Application ID.
arn
— (String
)Application ARN.
creationDateTime
— (String
)Application creation dateTime.
description
— (String
)Application description.
isArchived
— (Boolean
)Application archival status.
lastModifiedDateTime
— (String
)Application last modified dateTime.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
waveID
— (String
)Application wave ID.
nextToken
— (String
)Response next token.
-
(AWS.Response)
—
Returns:
listConnectors(params = {}, callback) ⇒ AWS.Request
List Connectors.
Service Reference:
Examples:
Calling the listConnectors operation
var params = {
filters: {
connectorIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listConnectors(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
filters
— (map
)List Connectors Request filters.
connectorIDs
— (Array<String>
)List Connectors Request Filters connector IDs.
maxResults
— (Integer
)List Connectors Request max results.
nextToken
— (String
)List Connectors Request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List connectors response items.
arn
— (String
)Connector arn.
connectorID
— (String
)Connector ID.
name
— (String
)Connector name.
ssmCommandConfig
— (map
)Connector SSM command config.
cloudWatchLogGroupName
— (String
)Connector SSM command config CloudWatch log group name.
cloudWatchOutputEnabled
— required — (Boolean
)Connector SSM command config CloudWatch output enabled.
outputS3BucketName
— (String
)Connector SSM command config output S3 bucket name.
s3OutputEnabled
— required — (Boolean
)Connector SSM command config S3 output enabled.
ssmInstanceID
— (String
)Connector SSM instance ID.
tags
— (map<String>
)Connector tags.
nextToken
— (String
)List connectors response next token.
-
(AWS.Response)
—
Returns:
listExportErrors(params = {}, callback) ⇒ AWS.Request
List export errors.
Service Reference:
Examples:
Calling the listExportErrors operation
var params = {
exportID: 'STRING_VALUE', /* required */
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listExportErrors(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
exportID
— (String
)List export errors request export id.
maxResults
— (Integer
)List export errors request max results.
nextToken
— (String
)List export errors request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List export errors response items.
errorData
— (map
)Export task error data.
rawError
— (String
)Export errors data raw error.
errorDateTime
— (String
)Export task error datetime.
nextToken
— (String
)List export errors response next token.
-
(AWS.Response)
—
Returns:
listExports(params = {}, callback) ⇒ AWS.Request
List exports.
Service Reference:
Examples:
Calling the listExports operation
var params = {
filters: {
exportIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listExports(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
filters
— (map
)List exports request filters.
exportIDs
— (Array<String>
)List exports request filters export ids.
maxResults
— (Integer
)List export request max results.
nextToken
— (String
)List export request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List export response items.
creationDateTime
— (String
)Export task creation datetime.
endDateTime
— (String
)Export task end datetime.
exportID
— (String
)Export task id.
progressPercentage
— (Float
)Export task progress percentage.
s3Bucket
— (String
)Export task s3 bucket.
s3BucketOwner
— (String
)Export task s3 bucket owner.
s3Key
— (String
)Export task s3 key.
status
— (String
)Export task status.
Possible values include:"PENDING"
"STARTED"
"FAILED"
"SUCCEEDED"
summary
— (map
)Export task summary.
applicationsCount
— (Integer
)Export task summary applications count.
serversCount
— (Integer
)Export task summary servers count.
wavesCount
— (Integer
)Export task summary waves count.
nextToken
— (String
)List export response next token.
-
(AWS.Response)
—
Returns:
listImportErrors(params = {}, callback) ⇒ AWS.Request
List import errors.
Service Reference:
Examples:
Calling the listImportErrors operation
var params = {
importID: 'STRING_VALUE', /* required */
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listImportErrors(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
importID
— (String
)List import errors request import id.
maxResults
— (Integer
)List import errors request max results.
nextToken
— (String
)List import errors request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List imports errors response items.
errorData
— (map
)Import task error data.
accountID
— (String
)Import error data source account ID.
applicationID
— (String
)Import error data application ID.
ec2LaunchTemplateID
— (String
)Import error data ec2 LaunchTemplate ID.
rawError
— (String
)Import error data raw error.
rowNumber
— (Integer
)Import error data row number.
sourceServerID
— (String
)Import error data source server ID.
waveID
— (String
)Import error data wave id.
errorDateTime
— (String
)Import task error datetime.
errorType
— (String
)Import task error type.
Possible values include:"VALIDATION_ERROR"
"PROCESSING_ERROR"
nextToken
— (String
)List imports errors response next token.
-
(AWS.Response)
—
Returns:
listImports(params = {}, callback) ⇒ AWS.Request
List imports.
Service Reference:
Examples:
Calling the listImports operation
var params = {
filters: {
importIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listImports(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
filters
— (map
)List imports request filters.
importIDs
— (Array<String>
)List imports request filters import IDs.
maxResults
— (Integer
)List imports request max results.
nextToken
— (String
)List imports request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List import response items.
creationDateTime
— (String
)Import task creation datetime.
endDateTime
— (String
)Import task end datetime.
importID
— (String
)Import task id.
progressPercentage
— (Float
)Import task progress percentage.
s3BucketSource
— (map
)Import task s3 bucket source.
s3Bucket
— required — (String
)S3 bucket source s3 bucket.
s3BucketOwner
— (String
)S3 bucket source s3 bucket owner.
s3Key
— required — (String
)S3 bucket source s3 key.
status
— (String
)Import task status.
Possible values include:"PENDING"
"STARTED"
"FAILED"
"SUCCEEDED"
summary
— (map
)Import task summary.
applications
— (map
)Import task summary applications.
createdCount
— (Integer
)Import task summary applications created count.
modifiedCount
— (Integer
)Import task summary applications modified count.
servers
— (map
)Import task summary servers.
createdCount
— (Integer
)Import task summary servers created count.
modifiedCount
— (Integer
)Import task summary servers modified count.
waves
— (map
)Import task summary waves.
createdCount
— (Integer
)Import task summery waves created count.
modifiedCount
— (Integer
)Import task summery waves modified count.
nextToken
— (String
)List import response next token.
-
(AWS.Response)
—
Returns:
listManagedAccounts(params = {}, callback) ⇒ AWS.Request
List Managed Accounts.
Service Reference:
Examples:
Calling the listManagedAccounts operation
var params = {
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listManagedAccounts(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
maxResults
— (Integer
)List managed accounts request max results.
nextToken
— (String
)List managed accounts request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List managed accounts response items.
accountId
— (String
)Managed account, account ID.
nextToken
— (String
)List managed accounts response next token.
-
(AWS.Response)
—
Returns:
listSourceServerActions(params = {}, callback) ⇒ AWS.Request
List source server post migration custom actions.
Service Reference:
Examples:
Calling the listSourceServerActions operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
filters: {
actionIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listSourceServerActions(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID to return when listing source server post migration custom actions.
filters
— (map
)Filters to apply when listing source server post migration custom actions.
actionIDs
— (Array<String>
)Action IDs to filter source server post migration custom actions by.
maxResults
— (Integer
)Maximum amount of items to return when listing source server post migration custom actions.
nextToken
— (String
)Next token to use when listing source server post migration custom actions.
sourceServerID
— (String
)Source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List of source server post migration custom actions.
actionID
— (String
)Source server post migration custom action ID.
actionName
— (String
)Source server post migration custom action name.
active
— (Boolean
)Source server post migration custom action active status.
category
— (String
)Source server post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Source server post migration custom action description.
documentIdentifier
— (String
)Source server post migration custom action document identifier.
documentVersion
— (String
)Source server post migration custom action document version.
externalParameters
— (map<map>
)Source server post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)Source server post migration custom action must succeed for cutover.
order
— (Integer
)Source server post migration custom action order.
parameters
— (map<Array<map>>
)Source server post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
timeoutSeconds
— (Integer
)Source server post migration custom action timeout in seconds.
nextToken
— (String
)Next token returned when listing source server post migration custom actions.
-
(AWS.Response)
—
Returns:
listTagsForResource(params = {}, callback) ⇒ AWS.Request
List all tags for your Application Migration Service resources.
Service Reference:
Examples:
Calling the listTagsForResource operation
var params = {
resourceArn: 'STRING_VALUE' /* required */
};
mgn.listTagsForResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
resourceArn
— (String
)List tags for resource request by ARN.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:tags
— (map<String>
)List tags for resource response.
-
(AWS.Response)
—
Returns:
listTemplateActions(params = {}, callback) ⇒ AWS.Request
List template post migration custom actions.
Service Reference:
Examples:
Calling the listTemplateActions operation
var params = {
launchConfigurationTemplateID: 'STRING_VALUE', /* required */
filters: {
actionIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listTemplateActions(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
filters
— (map
)Filters to apply when listing template post migration custom actions.
actionIDs
— (Array<String>
)Action IDs to filter template post migration custom actions by.
launchConfigurationTemplateID
— (String
)Launch configuration template ID.
maxResults
— (Integer
)Maximum amount of items to return when listing template post migration custom actions.
nextToken
— (String
)Next token to use when listing template post migration custom actions.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)List of template post migration custom actions.
actionID
— (String
)Template post migration custom action ID.
actionName
— (String
)Template post migration custom action name.
active
— (Boolean
)Template post migration custom action active status.
category
— (String
)Template post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Template post migration custom action description.
documentIdentifier
— (String
)Template post migration custom action document identifier.
documentVersion
— (String
)Template post migration custom action document version.
externalParameters
— (map<map>
)Template post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)Template post migration custom action must succeed for cutover.
operatingSystem
— (String
)Operating system eligible for this template post migration custom action.
order
— (Integer
)Template post migration custom action order.
parameters
— (map<Array<map>>
)Template post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
timeoutSeconds
— (Integer
)Template post migration custom action timeout in seconds.
nextToken
— (String
)Next token returned when listing template post migration custom actions.
-
(AWS.Response)
—
Returns:
listWaves(params = {}, callback) ⇒ AWS.Request
Retrieves all waves or multiple waves by ID.
Service Reference:
Examples:
Calling the listWaves operation
var params = {
accountID: 'STRING_VALUE',
filters: {
isArchived: true || false,
waveIDs: [
'STRING_VALUE',
/* more items */
]
},
maxResults: 'NUMBER_VALUE',
nextToken: 'STRING_VALUE'
};
mgn.listWaves(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Request account ID.
filters
— (map
)Waves list filters.
isArchived
— (Boolean
)Filter waves list by archival status.
waveIDs
— (Array<String>
)Filter waves list by wave ID.
maxResults
— (Integer
)Maximum results to return when listing waves.
nextToken
— (String
)Request next token.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:items
— (Array<map>
)Waves list.
arn
— (String
)Wave ARN.
creationDateTime
— (String
)Wave creation dateTime.
description
— (String
)Wave description.
isArchived
— (Boolean
)Wave archival status.
lastModifiedDateTime
— (String
)Wave last modified dateTime.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
waveAggregatedStatus
— (map
)Wave aggregated status.
healthStatus
— (String
)Wave aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Wave aggregated status last update dateTime.
progressStatus
— (String
)Wave aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
replicationStartedDateTime
— (String
)DateTime marking when the first source server in the wave started replication.
totalApplications
— (Integer
)Wave aggregated status total applications amount.
waveID
— (String
)Wave ID.
nextToken
— (String
)Response next token.
-
(AWS.Response)
—
Returns:
markAsArchived(params = {}, callback) ⇒ AWS.Request
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.
Service Reference:
Examples:
Calling the markAsArchived operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.markAsArchived(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Mark as archived by Account ID.
sourceServerID
— (String
)Mark as archived by Source Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
pauseReplication(params = {}, callback) ⇒ AWS.Request
Pause Replication.
Service Reference:
Examples:
Calling the pauseReplication operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.pauseReplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Pause Replication Request account ID.
sourceServerID
— (String
)Pause Replication Request source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
putSourceServerAction(params = {}, callback) ⇒ AWS.Request
Put source server post migration custom action.
Service Reference:
Examples:
Calling the putSourceServerAction operation
var params = {
actionID: 'STRING_VALUE', /* required */
actionName: 'STRING_VALUE', /* required */
documentIdentifier: 'STRING_VALUE', /* required */
order: 'NUMBER_VALUE', /* required */
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
active: true || false,
category: DISASTER_RECOVERY | OPERATING_SYSTEM | LICENSE_AND_SUBSCRIPTION | VALIDATION | OBSERVABILITY | REFACTORING | SECURITY | NETWORKING | CONFIGURATION | BACKUP | OTHER,
description: 'STRING_VALUE',
documentVersion: 'STRING_VALUE',
externalParameters: {
'<SsmDocumentParameterName>': {
dynamicPath: 'STRING_VALUE'
},
/* '<SsmDocumentParameterName>': ... */
},
mustSucceedForCutover: true || false,
parameters: {
'<SsmDocumentParameterName>': [
{
parameterName: 'STRING_VALUE', /* required */
parameterType: STRING /* required */
},
/* more items */
],
/* '<SsmDocumentParameterName>': ... */
},
timeoutSeconds: 'NUMBER_VALUE'
};
mgn.putSourceServerAction(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Source server post migration custom account ID.
actionID
— (String
)Source server post migration custom action ID.
actionName
— (String
)Source server post migration custom action name.
active
— (Boolean
)Source server post migration custom action active status.
category
— (String
)Source server post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Source server post migration custom action description.
documentIdentifier
— (String
)Source server post migration custom action document identifier.
documentVersion
— (String
)Source server post migration custom action document version.
externalParameters
— (map<map>
)Source server post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)Source server post migration custom action must succeed for cutover.
order
— (Integer
)Source server post migration custom action order.
parameters
— (map<Array<map>>
)Source server post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
sourceServerID
— (String
)Source server ID.
timeoutSeconds
— (Integer
)Source server post migration custom action timeout in seconds.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:actionID
— (String
)Source server post migration custom action ID.
actionName
— (String
)Source server post migration custom action name.
active
— (Boolean
)Source server post migration custom action active status.
category
— (String
)Source server post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Source server post migration custom action description.
documentIdentifier
— (String
)Source server post migration custom action document identifier.
documentVersion
— (String
)Source server post migration custom action document version.
externalParameters
— (map<map>
)Source server post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)Source server post migration custom action must succeed for cutover.
order
— (Integer
)Source server post migration custom action order.
parameters
— (map<Array<map>>
)Source server post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
timeoutSeconds
— (Integer
)Source server post migration custom action timeout in seconds.
-
(AWS.Response)
—
Returns:
putTemplateAction(params = {}, callback) ⇒ AWS.Request
Put template post migration custom action.
Service Reference:
Examples:
Calling the putTemplateAction operation
var params = {
actionID: 'STRING_VALUE', /* required */
actionName: 'STRING_VALUE', /* required */
documentIdentifier: 'STRING_VALUE', /* required */
launchConfigurationTemplateID: 'STRING_VALUE', /* required */
order: 'NUMBER_VALUE', /* required */
active: true || false,
category: DISASTER_RECOVERY | OPERATING_SYSTEM | LICENSE_AND_SUBSCRIPTION | VALIDATION | OBSERVABILITY | REFACTORING | SECURITY | NETWORKING | CONFIGURATION | BACKUP | OTHER,
description: 'STRING_VALUE',
documentVersion: 'STRING_VALUE',
externalParameters: {
'<SsmDocumentParameterName>': {
dynamicPath: 'STRING_VALUE'
},
/* '<SsmDocumentParameterName>': ... */
},
mustSucceedForCutover: true || false,
operatingSystem: 'STRING_VALUE',
parameters: {
'<SsmDocumentParameterName>': [
{
parameterName: 'STRING_VALUE', /* required */
parameterType: STRING /* required */
},
/* more items */
],
/* '<SsmDocumentParameterName>': ... */
},
timeoutSeconds: 'NUMBER_VALUE'
};
mgn.putTemplateAction(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
actionID
— (String
)Template post migration custom action ID.
actionName
— (String
)Template post migration custom action name.
active
— (Boolean
)Template post migration custom action active status.
category
— (String
)Template post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Template post migration custom action description.
documentIdentifier
— (String
)Template post migration custom action document identifier.
documentVersion
— (String
)Template post migration custom action document version.
externalParameters
— (map<map>
)Template post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
launchConfigurationTemplateID
— (String
)Launch configuration template ID.
mustSucceedForCutover
— (Boolean
)Template post migration custom action must succeed for cutover.
operatingSystem
— (String
)Operating system eligible for this template post migration custom action.
order
— (Integer
)Template post migration custom action order.
parameters
— (map<Array<map>>
)Template post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
timeoutSeconds
— (Integer
)Template post migration custom action timeout in seconds.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:actionID
— (String
)Template post migration custom action ID.
actionName
— (String
)Template post migration custom action name.
active
— (Boolean
)Template post migration custom action active status.
category
— (String
)Template post migration custom action category.
Possible values include:"DISASTER_RECOVERY"
"OPERATING_SYSTEM"
"LICENSE_AND_SUBSCRIPTION"
"VALIDATION"
"OBSERVABILITY"
"REFACTORING"
"SECURITY"
"NETWORKING"
"CONFIGURATION"
"BACKUP"
"OTHER"
description
— (String
)Template post migration custom action description.
documentIdentifier
— (String
)Template post migration custom action document identifier.
documentVersion
— (String
)Template post migration custom action document version.
externalParameters
— (map<map>
)Template post migration custom action external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)Template post migration custom action must succeed for cutover.
operatingSystem
— (String
)Operating system eligible for this template post migration custom action.
order
— (Integer
)Template post migration custom action order.
parameters
— (map<Array<map>>
)Template post migration custom action parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
timeoutSeconds
— (Integer
)Template post migration custom action timeout in seconds.
-
(AWS.Response)
—
Returns:
removeSourceServerAction(params = {}, callback) ⇒ AWS.Request
Remove source server post migration custom action.
Service Reference:
Examples:
Calling the removeSourceServerAction operation
var params = {
actionID: 'STRING_VALUE', /* required */
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.removeSourceServerAction(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Source server post migration account ID.
actionID
— (String
)Source server post migration custom action ID to remove.
sourceServerID
— (String
)Source server ID of the post migration custom action to remove.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
removeTemplateAction(params = {}, callback) ⇒ AWS.Request
Remove template post migration custom action.
Service Reference:
Examples:
Calling the removeTemplateAction operation
var params = {
actionID: 'STRING_VALUE', /* required */
launchConfigurationTemplateID: 'STRING_VALUE' /* required */
};
mgn.removeTemplateAction(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
actionID
— (String
)Template post migration custom action ID to remove.
launchConfigurationTemplateID
— (String
)Launch configuration template ID of the post migration custom action to remove.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
resumeReplication(params = {}, callback) ⇒ AWS.Request
Resume Replication.
Service Reference:
Examples:
Calling the resumeReplication operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.resumeReplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Resume Replication Request account ID.
sourceServerID
— (String
)Resume Replication Request source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
retryDataReplication(params = {}, callback) ⇒ AWS.Request
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.
Service Reference:
Examples:
Calling the retryDataReplication operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.retryDataReplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Retry data replication for Account ID.
sourceServerID
— (String
)Retry data replication for Source Server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
startCutover(params = {}, callback) ⇒ AWS.Request
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.
Service Reference:
Examples:
Calling the startCutover operation
var params = {
sourceServerIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
accountID: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.startCutover(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Start Cutover by Account IDs
sourceServerIDs
— (Array<String>
)Start Cutover by Source Server IDs.
tags
— (map<String>
)Start Cutover by Tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:job
— (map
)Start Cutover Job response.
arn
— (String
)the ARN of the specific Job.
creationDateTime
— (String
)Job creation time.
endDateTime
— (String
)Job end time.
initiatedBy
— (String
)Job initiated by field.
Possible values include:"START_TEST"
"START_CUTOVER"
"DIAGNOSTIC"
"TERMINATE"
jobID
— required — (String
)Job ID.
participatingServers
— (Array<map>
)Servers participating in a specific Job.
launchStatus
— (String
)Participating server launch status.
Possible values include:"PENDING"
"IN_PROGRESS"
"LAUNCHED"
"FAILED"
"TERMINATED"
launchedEc2InstanceID
— (String
)Participating server's launched ec2 instance ID.
postLaunchActionsStatus
— (map
)Participating server's Post Launch Actions Status.
postLaunchActionsLaunchStatusList
— (Array<map>
)List of Post Launch Action status.
executionID
— (String
)AWS Systems Manager Document's execution ID of the of the Job Post Launch Actions.
executionStatus
— (String
)AWS Systems Manager Document's execution status.
Possible values include:"IN_PROGRESS"
"SUCCESS"
"FAILED"
failureReason
— (String
)AWS Systems Manager Document's failure reason.
ssmDocument
— (map
)AWS Systems Manager's Document of the of the Job Post Launch Actions.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
ssmDocumentType
— (String
)AWS Systems Manager Document type.
Possible values include:"AUTOMATION"
"COMMAND"
ssmAgentDiscoveryDatetime
— (String
)Time where the AWS Systems Manager was detected as running on the Test or Cutover instance.
sourceServerID
— required — (String
)Participating server Source Server ID.
status
— (String
)Job status.
Possible values include:"PENDING"
"STARTED"
"COMPLETED"
tags
— (map<String>
)Tags associated with specific Job.
type
— (String
)Job type.
Possible values include:"LAUNCH"
"TERMINATE"
-
(AWS.Response)
—
Returns:
startExport(params = {}, callback) ⇒ AWS.Request
Start export.
Service Reference:
Examples:
Calling the startExport operation
var params = {
s3Bucket: 'STRING_VALUE', /* required */
s3Key: 'STRING_VALUE', /* required */
s3BucketOwner: 'STRING_VALUE'
};
mgn.startExport(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
s3Bucket
— (String
)Start export request s3 bucket.
s3BucketOwner
— (String
)Start export request s3 bucket owner.
s3Key
— (String
)Start export request s3key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:exportTask
— (map
)Start export response export task.
creationDateTime
— (String
)Export task creation datetime.
endDateTime
— (String
)Export task end datetime.
exportID
— (String
)Export task id.
progressPercentage
— (Float
)Export task progress percentage.
s3Bucket
— (String
)Export task s3 bucket.
s3BucketOwner
— (String
)Export task s3 bucket owner.
s3Key
— (String
)Export task s3 key.
status
— (String
)Export task status.
Possible values include:"PENDING"
"STARTED"
"FAILED"
"SUCCEEDED"
summary
— (map
)Export task summary.
applicationsCount
— (Integer
)Export task summary applications count.
serversCount
— (Integer
)Export task summary servers count.
wavesCount
— (Integer
)Export task summary waves count.
-
(AWS.Response)
—
Returns:
startImport(params = {}, callback) ⇒ AWS.Request
Start import.
Service Reference:
Examples:
Calling the startImport operation
var params = {
s3BucketSource: { /* required */
s3Bucket: 'STRING_VALUE', /* required */
s3Key: 'STRING_VALUE', /* required */
s3BucketOwner: 'STRING_VALUE'
},
clientToken: 'STRING_VALUE'
};
mgn.startImport(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
clientToken
— (String
)Start import request client token.
If a token is not provided, the SDK will use a version 4 UUID.s3BucketSource
— (map
)Start import request s3 bucket source.
s3Bucket
— required — (String
)S3 bucket source s3 bucket.
s3BucketOwner
— (String
)S3 bucket source s3 bucket owner.
s3Key
— required — (String
)S3 bucket source s3 key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:importTask
— (map
)Start import response import task.
creationDateTime
— (String
)Import task creation datetime.
endDateTime
— (String
)Import task end datetime.
importID
— (String
)Import task id.
progressPercentage
— (Float
)Import task progress percentage.
s3BucketSource
— (map
)Import task s3 bucket source.
s3Bucket
— required — (String
)S3 bucket source s3 bucket.
s3BucketOwner
— (String
)S3 bucket source s3 bucket owner.
s3Key
— required — (String
)S3 bucket source s3 key.
status
— (String
)Import task status.
Possible values include:"PENDING"
"STARTED"
"FAILED"
"SUCCEEDED"
summary
— (map
)Import task summary.
applications
— (map
)Import task summary applications.
createdCount
— (Integer
)Import task summary applications created count.
modifiedCount
— (Integer
)Import task summary applications modified count.
servers
— (map
)Import task summary servers.
createdCount
— (Integer
)Import task summary servers created count.
modifiedCount
— (Integer
)Import task summary servers modified count.
waves
— (map
)Import task summary waves.
createdCount
— (Integer
)Import task summery waves created count.
modifiedCount
— (Integer
)Import task summery waves modified count.
-
(AWS.Response)
—
Returns:
startReplication(params = {}, callback) ⇒ AWS.Request
Starts replication for SNAPSHOT_SHIPPING agents.
Service Reference:
Examples:
Calling the startReplication operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.startReplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID on which to start replication.
sourceServerID
— (String
)ID of source server on which to start replication.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
startTest(params = {}, callback) ⇒ AWS.Request
Launches 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.
Service Reference:
Examples:
Calling the startTest operation
var params = {
sourceServerIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
accountID: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.startTest(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Start Test for Account ID.
sourceServerIDs
— (Array<String>
)Start Test for Source Server IDs.
tags
— (map<String>
)Start Test by Tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:job
— (map
)Start Test Job response.
arn
— (String
)the ARN of the specific Job.
creationDateTime
— (String
)Job creation time.
endDateTime
— (String
)Job end time.
initiatedBy
— (String
)Job initiated by field.
Possible values include:"START_TEST"
"START_CUTOVER"
"DIAGNOSTIC"
"TERMINATE"
jobID
— required — (String
)Job ID.
participatingServers
— (Array<map>
)Servers participating in a specific Job.
launchStatus
— (String
)Participating server launch status.
Possible values include:"PENDING"
"IN_PROGRESS"
"LAUNCHED"
"FAILED"
"TERMINATED"
launchedEc2InstanceID
— (String
)Participating server's launched ec2 instance ID.
postLaunchActionsStatus
— (map
)Participating server's Post Launch Actions Status.
postLaunchActionsLaunchStatusList
— (Array<map>
)List of Post Launch Action status.
executionID
— (String
)AWS Systems Manager Document's execution ID of the of the Job Post Launch Actions.
executionStatus
— (String
)AWS Systems Manager Document's execution status.
Possible values include:"IN_PROGRESS"
"SUCCESS"
"FAILED"
failureReason
— (String
)AWS Systems Manager Document's failure reason.
ssmDocument
— (map
)AWS Systems Manager's Document of the of the Job Post Launch Actions.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
ssmDocumentType
— (String
)AWS Systems Manager Document type.
Possible values include:"AUTOMATION"
"COMMAND"
ssmAgentDiscoveryDatetime
— (String
)Time where the AWS Systems Manager was detected as running on the Test or Cutover instance.
sourceServerID
— required — (String
)Participating server Source Server ID.
status
— (String
)Job status.
Possible values include:"PENDING"
"STARTED"
"COMPLETED"
tags
— (map<String>
)Tags associated with specific Job.
type
— (String
)Job type.
Possible values include:"LAUNCH"
"TERMINATE"
-
(AWS.Response)
—
Returns:
stopReplication(params = {}, callback) ⇒ AWS.Request
Stop Replication.
Service Reference:
Examples:
Calling the stopReplication operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.stopReplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Stop Replication Request account ID.
sourceServerID
— (String
)Stop Replication Request source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
tagResource(params = {}, callback) ⇒ AWS.Request
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.
Service Reference:
Examples:
Calling the tagResource operation
var params = {
resourceArn: 'STRING_VALUE', /* required */
tags: { /* required */
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.tagResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
resourceArn
— (String
)Tag resource by ARN.
tags
— (map<String>
)Tag resource by Tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
terminateTargetInstances(params = {}, callback) ⇒ AWS.Request
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.
Service Reference:
Examples:
Calling the terminateTargetInstances operation
var params = {
sourceServerIDs: [ /* required */
'STRING_VALUE',
/* more items */
],
accountID: 'STRING_VALUE',
tags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
}
};
mgn.terminateTargetInstances(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Terminate Target instance by Account ID
sourceServerIDs
— (Array<String>
)Terminate Target instance by Source Server IDs.
tags
— (map<String>
)Terminate Target instance by Tags.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:job
— (map
)Terminate Target instance Job response.
arn
— (String
)the ARN of the specific Job.
creationDateTime
— (String
)Job creation time.
endDateTime
— (String
)Job end time.
initiatedBy
— (String
)Job initiated by field.
Possible values include:"START_TEST"
"START_CUTOVER"
"DIAGNOSTIC"
"TERMINATE"
jobID
— required — (String
)Job ID.
participatingServers
— (Array<map>
)Servers participating in a specific Job.
launchStatus
— (String
)Participating server launch status.
Possible values include:"PENDING"
"IN_PROGRESS"
"LAUNCHED"
"FAILED"
"TERMINATED"
launchedEc2InstanceID
— (String
)Participating server's launched ec2 instance ID.
postLaunchActionsStatus
— (map
)Participating server's Post Launch Actions Status.
postLaunchActionsLaunchStatusList
— (Array<map>
)List of Post Launch Action status.
executionID
— (String
)AWS Systems Manager Document's execution ID of the of the Job Post Launch Actions.
executionStatus
— (String
)AWS Systems Manager Document's execution status.
Possible values include:"IN_PROGRESS"
"SUCCESS"
"FAILED"
failureReason
— (String
)AWS Systems Manager Document's failure reason.
ssmDocument
— (map
)AWS Systems Manager's Document of the of the Job Post Launch Actions.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
ssmDocumentType
— (String
)AWS Systems Manager Document type.
Possible values include:"AUTOMATION"
"COMMAND"
ssmAgentDiscoveryDatetime
— (String
)Time where the AWS Systems Manager was detected as running on the Test or Cutover instance.
sourceServerID
— required — (String
)Participating server Source Server ID.
status
— (String
)Job status.
Possible values include:"PENDING"
"STARTED"
"COMPLETED"
tags
— (map<String>
)Tags associated with specific Job.
type
— (String
)Job type.
Possible values include:"LAUNCH"
"TERMINATE"
-
(AWS.Response)
—
Returns:
unarchiveApplication(params = {}, callback) ⇒ AWS.Request
Unarchive application.
Service Reference:
Examples:
Calling the unarchiveApplication operation
var params = {
applicationID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.unarchiveApplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationAggregatedStatus
— (map
)Application aggregated status.
healthStatus
— (String
)Application aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Application aggregated status last update dateTime.
progressStatus
— (String
)Application aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
totalSourceServers
— (Integer
)Application aggregated status total source servers amount.
applicationID
— (String
)Application ID.
arn
— (String
)Application ARN.
creationDateTime
— (String
)Application creation dateTime.
description
— (String
)Application description.
isArchived
— (Boolean
)Application archival status.
lastModifiedDateTime
— (String
)Application last modified dateTime.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
waveID
— (String
)Application wave ID.
-
(AWS.Response)
—
Returns:
unarchiveWave(params = {}, callback) ⇒ AWS.Request
Unarchive wave.
Service Reference:
Examples:
Calling the unarchiveWave operation
var params = {
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.unarchiveWave(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Wave ARN.
creationDateTime
— (String
)Wave creation dateTime.
description
— (String
)Wave description.
isArchived
— (Boolean
)Wave archival status.
lastModifiedDateTime
— (String
)Wave last modified dateTime.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
waveAggregatedStatus
— (map
)Wave aggregated status.
healthStatus
— (String
)Wave aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Wave aggregated status last update dateTime.
progressStatus
— (String
)Wave aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
replicationStartedDateTime
— (String
)DateTime marking when the first source server in the wave started replication.
totalApplications
— (Integer
)Wave aggregated status total applications amount.
waveID
— (String
)Wave ID.
-
(AWS.Response)
—
Returns:
untagResource(params = {}, callback) ⇒ AWS.Request
Deletes the specified set of tags from the specified set of Application Migration Service resources.
Service Reference:
Examples:
Calling the untagResource operation
var params = {
resourceArn: 'STRING_VALUE', /* required */
tagKeys: [ /* required */
'STRING_VALUE',
/* more items */
]
};
mgn.untagResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
resourceArn
— (String
)Untag resource by ARN.
tagKeys
— (Array<String>
)Untag resource by Keys.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
updateApplication(params = {}, callback) ⇒ AWS.Request
Update application.
Service Reference:
Examples:
Calling the updateApplication operation
var params = {
applicationID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
description: 'STRING_VALUE',
name: 'STRING_VALUE'
};
mgn.updateApplication(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
applicationID
— (String
)Application ID.
description
— (String
)Application description.
name
— (String
)Application name.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationAggregatedStatus
— (map
)Application aggregated status.
healthStatus
— (String
)Application aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Application aggregated status last update dateTime.
progressStatus
— (String
)Application aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
totalSourceServers
— (Integer
)Application aggregated status total source servers amount.
applicationID
— (String
)Application ID.
arn
— (String
)Application ARN.
creationDateTime
— (String
)Application creation dateTime.
description
— (String
)Application description.
isArchived
— (Boolean
)Application archival status.
lastModifiedDateTime
— (String
)Application last modified dateTime.
name
— (String
)Application name.
tags
— (map<String>
)Application tags.
waveID
— (String
)Application wave ID.
-
(AWS.Response)
—
Returns:
updateConnector(params = {}, callback) ⇒ AWS.Request
Update Connector.
Service Reference:
Examples:
Calling the updateConnector operation
var params = {
connectorID: 'STRING_VALUE', /* required */
name: 'STRING_VALUE',
ssmCommandConfig: {
cloudWatchOutputEnabled: true || false, /* required */
s3OutputEnabled: true || false, /* required */
cloudWatchLogGroupName: 'STRING_VALUE',
outputS3BucketName: 'STRING_VALUE'
}
};
mgn.updateConnector(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
connectorID
— (String
)Update Connector request connector ID.
name
— (String
)Update Connector request name.
ssmCommandConfig
— (map
)Update Connector request SSM command config.
cloudWatchLogGroupName
— (String
)Connector SSM command config CloudWatch log group name.
cloudWatchOutputEnabled
— required — (Boolean
)Connector SSM command config CloudWatch output enabled.
outputS3BucketName
— (String
)Connector SSM command config output S3 bucket name.
s3OutputEnabled
— required — (Boolean
)Connector SSM command config S3 output enabled.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Connector arn.
connectorID
— (String
)Connector ID.
name
— (String
)Connector name.
ssmCommandConfig
— (map
)Connector SSM command config.
cloudWatchLogGroupName
— (String
)Connector SSM command config CloudWatch log group name.
cloudWatchOutputEnabled
— required — (Boolean
)Connector SSM command config CloudWatch output enabled.
outputS3BucketName
— (String
)Connector SSM command config output S3 bucket name.
s3OutputEnabled
— required — (Boolean
)Connector SSM command config S3 output enabled.
ssmInstanceID
— (String
)Connector SSM instance ID.
tags
— (map<String>
)Connector tags.
-
(AWS.Response)
—
Returns:
updateLaunchConfiguration(params = {}, callback) ⇒ AWS.Request
Updates multiple LaunchConfigurations by Source Server ID.
LEGACY_BIOS | UEFI
Service Reference:
Examples:
Calling the updateLaunchConfiguration operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
bootMode: LEGACY_BIOS | UEFI | USE_SOURCE,
copyPrivateIp: true || false,
copyTags: true || false,
enableMapAutoTagging: true || false,
launchDisposition: STOPPED | STARTED,
licensing: {
osByol: true || false
},
mapAutoTaggingMpeID: 'STRING_VALUE',
name: 'STRING_VALUE',
postLaunchActions: {
cloudWatchLogGroupName: 'STRING_VALUE',
deployment: TEST_AND_CUTOVER | CUTOVER_ONLY | TEST_ONLY,
s3LogBucket: 'STRING_VALUE',
s3OutputKeyPrefix: 'STRING_VALUE',
ssmDocuments: [
{
actionName: 'STRING_VALUE', /* required */
ssmDocumentName: 'STRING_VALUE', /* required */
externalParameters: {
'<SsmDocumentParameterName>': {
dynamicPath: 'STRING_VALUE'
},
/* '<SsmDocumentParameterName>': ... */
},
mustSucceedForCutover: true || false,
parameters: {
'<SsmDocumentParameterName>': [
{
parameterName: 'STRING_VALUE', /* required */
parameterType: STRING /* required */
},
/* more items */
],
/* '<SsmDocumentParameterName>': ... */
},
timeoutSeconds: 'NUMBER_VALUE'
},
/* more items */
]
},
targetInstanceTypeRightSizingMethod: NONE | BASIC
};
mgn.updateLaunchConfiguration(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Update Launch configuration Account ID.
bootMode
— (String
)Update Launch configuration boot mode request.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Update Launch configuration copy Private IP request.
copyTags
— (Boolean
)Update Launch configuration copy Tags request.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
launchDisposition
— (String
)Update Launch configuration launch disposition request.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Update Launch configuration licensing request.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration map auto tagging MPE ID.
name
— (String
)Update Launch configuration name request.
postLaunchActions
— (map
)Post Launch Actions to executed on the Test or Cutover instance.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
sourceServerID
— (String
)Update Launch configuration by Source Server ID request.
targetInstanceTypeRightSizingMethod
— (String
)Update Launch configuration Target instance right sizing request.
Possible values include:"NONE"
"BASIC"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:bootMode
— (String
)Launch configuration boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy Private IP during Launch Configuration.
copyTags
— (Boolean
)Copy Tags during Launch Configuration.
ec2LaunchTemplateID
— (String
)Launch configuration EC2 Launch template ID.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
launchDisposition
— (String
)Launch disposition for launch configuration.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Launch configuration OS licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Map auto tagging MPE ID.
name
— (String
)Launch configuration name.
postLaunchActions
— (map
)Post Launch Actions to executed on the Test or Cutover instance.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
sourceServerID
— (String
)Launch configuration Source Server ID.
targetInstanceTypeRightSizingMethod
— (String
)Launch configuration Target instance type right sizing method.
Possible values include:"NONE"
"BASIC"
-
(AWS.Response)
—
Returns:
updateLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Updates an existing Launch Configuration Template by ID.
Service Reference:
Examples:
Calling the updateLaunchConfigurationTemplate operation
var params = {
launchConfigurationTemplateID: 'STRING_VALUE', /* required */
associatePublicIpAddress: true || false,
bootMode: LEGACY_BIOS | UEFI | USE_SOURCE,
copyPrivateIp: true || false,
copyTags: true || false,
enableMapAutoTagging: true || false,
largeVolumeConf: {
iops: 'NUMBER_VALUE',
throughput: 'NUMBER_VALUE',
volumeType: io1 | io2 | gp3 | gp2 | st1 | sc1 | standard
},
launchDisposition: STOPPED | STARTED,
licensing: {
osByol: true || false
},
mapAutoTaggingMpeID: 'STRING_VALUE',
postLaunchActions: {
cloudWatchLogGroupName: 'STRING_VALUE',
deployment: TEST_AND_CUTOVER | CUTOVER_ONLY | TEST_ONLY,
s3LogBucket: 'STRING_VALUE',
s3OutputKeyPrefix: 'STRING_VALUE',
ssmDocuments: [
{
actionName: 'STRING_VALUE', /* required */
ssmDocumentName: 'STRING_VALUE', /* required */
externalParameters: {
'<SsmDocumentParameterName>': {
dynamicPath: 'STRING_VALUE'
},
/* '<SsmDocumentParameterName>': ... */
},
mustSucceedForCutover: true || false,
parameters: {
'<SsmDocumentParameterName>': [
{
parameterName: 'STRING_VALUE', /* required */
parameterType: STRING /* required */
},
/* more items */
],
/* '<SsmDocumentParameterName>': ... */
},
timeoutSeconds: 'NUMBER_VALUE'
},
/* more items */
]
},
smallVolumeConf: {
iops: 'NUMBER_VALUE',
throughput: 'NUMBER_VALUE',
volumeType: io1 | io2 | gp3 | gp2 | st1 | sc1 | standard
},
smallVolumeMaxSize: 'NUMBER_VALUE',
targetInstanceTypeRightSizingMethod: NONE | BASIC
};
mgn.updateLaunchConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
associatePublicIpAddress
— (Boolean
)Associate public Ip address.
bootMode
— (String
)Launch configuration template boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy private Ip.
copyTags
— (Boolean
)Copy tags.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
largeVolumeConf
— (map
)Large volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
launchConfigurationTemplateID
— (String
)Launch Configuration Template ID.
launchDisposition
— (String
)Launch disposition.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Configure Licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration template map auto tagging MPE ID.
postLaunchActions
— (map
)Post Launch Action to execute on the Test or Cutover instance.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
smallVolumeConf
— (map
)Small volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
smallVolumeMaxSize
— (Integer
)Small volume maximum size.
targetInstanceTypeRightSizingMethod
— (String
)Target instance type right-sizing method.
Possible values include:"NONE"
"BASIC"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)ARN of the Launch Configuration Template.
associatePublicIpAddress
— (Boolean
)Associate public Ip address.
bootMode
— (String
)Launch configuration template boot mode.
Possible values include:"LEGACY_BIOS"
"UEFI"
"USE_SOURCE"
copyPrivateIp
— (Boolean
)Copy private Ip.
copyTags
— (Boolean
)Copy tags.
ec2LaunchTemplateID
— (String
)EC2 launch template ID.
enableMapAutoTagging
— (Boolean
)Enable map auto tagging.
largeVolumeConf
— (map
)Large volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
launchConfigurationTemplateID
— (String
)ID of the Launch Configuration Template.
launchDisposition
— (String
)Launch disposition.
Possible values include:"STOPPED"
"STARTED"
licensing
— (map
)Configure Licensing.
osByol
— (Boolean
)Configure BYOL OS licensing.
mapAutoTaggingMpeID
— (String
)Launch configuration template map auto tagging MPE ID.
postLaunchActions
— (map
)Post Launch Actions of the Launch Configuration Template.
cloudWatchLogGroupName
— (String
)AWS Systems Manager Command's CloudWatch log group name.
deployment
— (String
)Deployment type in which AWS Systems Manager Documents will be executed.
Possible values include:"TEST_AND_CUTOVER"
"CUTOVER_ONLY"
"TEST_ONLY"
s3LogBucket
— (String
)AWS Systems Manager Command's logs S3 log bucket.
s3OutputKeyPrefix
— (String
)AWS Systems Manager Command's logs S3 output key prefix.
ssmDocuments
— (Array<map>
)AWS Systems Manager Documents.
actionName
— required — (String
)User-friendly name for the AWS Systems Manager Document.
externalParameters
— (map<map>
)AWS Systems Manager Document external parameters.
dynamicPath
— (String
)AWS Systems Manager Document external parameters dynamic path.
mustSucceedForCutover
— (Boolean
)If true, Cutover will not be enabled if the document has failed.
parameters
— (map<Array<map>>
)AWS Systems Manager Document parameters.
parameterName
— required — (String
)AWS Systems Manager Parameter Store parameter name.
parameterType
— required — (String
)AWS Systems Manager Parameter Store parameter type.
Possible values include:"STRING"
ssmDocumentName
— required — (String
)AWS Systems Manager Document name or full ARN.
timeoutSeconds
— (Integer
)AWS Systems Manager Document timeout seconds.
smallVolumeConf
— (map
)Small volume config.
iops
— (Integer
)Launch template disk iops configuration.
throughput
— (Integer
)Launch template disk throughput configuration.
volumeType
— (String
)Launch template disk volume type configuration.
Possible values include:"io1"
"io2"
"gp3"
"gp2"
"st1"
"sc1"
"standard"
smallVolumeMaxSize
— (Integer
)Small volume maximum size.
tags
— (map<String>
)Tags of the Launch Configuration Template.
targetInstanceTypeRightSizingMethod
— (String
)Target instance type right-sizing method.
Possible values include:"NONE"
"BASIC"
-
(AWS.Response)
—
Returns:
updateReplicationConfiguration(params = {}, callback) ⇒ AWS.Request
Allows you to update multiple ReplicationConfigurations by Source Server ID.
Service Reference:
Examples:
Calling the updateReplicationConfiguration operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
associateDefaultSecurityGroup: true || false,
bandwidthThrottling: 'NUMBER_VALUE',
createPublicIP: true || false,
dataPlaneRouting: PRIVATE_IP | PUBLIC_IP,
defaultLargeStagingDiskType: GP2 | ST1 | GP3,
ebsEncryption: DEFAULT | CUSTOM,
ebsEncryptionKeyArn: 'STRING_VALUE',
name: 'STRING_VALUE',
replicatedDisks: [
{
deviceName: 'STRING_VALUE',
iops: 'NUMBER_VALUE',
isBootDisk: true || false,
stagingDiskType: AUTO | GP2 | IO1 | SC1 | ST1 | STANDARD | GP3 | IO2,
throughput: 'NUMBER_VALUE'
},
/* more items */
],
replicationServerInstanceType: 'STRING_VALUE',
replicationServersSecurityGroupsIDs: [
'STRING_VALUE',
/* more items */
],
stagingAreaSubnetId: 'STRING_VALUE',
stagingAreaTags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
},
useDedicatedReplicationServer: true || false,
useFipsEndpoint: true || false
};
mgn.updateReplicationConfiguration(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Update replication configuration Account ID request.
associateDefaultSecurityGroup
— (Boolean
)Update replication configuration associate default Application Migration Service Security group request.
bandwidthThrottling
— (Integer
)Update replication configuration bandwidth throttling request.
createPublicIP
— (Boolean
)Update replication configuration create Public IP request.
dataPlaneRouting
— (String
)Update replication configuration data plane routing request.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Update replication configuration use default large Staging Disk type request.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Update replication configuration EBS encryption request.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Update replication configuration EBS encryption key ARN request.
name
— (String
)Update replication configuration name request.
replicatedDisks
— (Array<map>
)Update replication configuration replicated disks request.
deviceName
— (String
)Replication Configuration replicated disk device name.
iops
— (Integer
)Replication Configuration replicated disk IOPs.
isBootDisk
— (Boolean
)Replication Configuration replicated disk boot disk.
stagingDiskType
— (String
)Replication Configuration replicated disk staging disk type.
Possible values include:"AUTO"
"GP2"
"IO1"
"SC1"
"ST1"
"STANDARD"
"GP3"
"IO2"
throughput
— (Integer
)Replication Configuration replicated disk throughput.
replicationServerInstanceType
— (String
)Update replication configuration Replication Server instance type request.
replicationServersSecurityGroupsIDs
— (Array<String>
)Update replication configuration Replication Server Security Groups IDs request.
sourceServerID
— (String
)Update replication configuration Source Server ID request.
stagingAreaSubnetId
— (String
)Update replication configuration Staging Area subnet request.
stagingAreaTags
— (map<String>
)Update replication configuration Staging Area Tags request.
useDedicatedReplicationServer
— (Boolean
)Update replication configuration use dedicated Replication Server request.
useFipsEndpoint
— (Boolean
)Update replication configuration use Fips Endpoint.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:associateDefaultSecurityGroup
— (Boolean
)Replication Configuration associate default Application Migration Service Security Group.
bandwidthThrottling
— (Integer
)Replication Configuration set bandwidth throttling.
createPublicIP
— (Boolean
)Replication Configuration create Public IP.
dataPlaneRouting
— (String
)Replication Configuration data plane routing.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Replication Configuration use default large Staging Disks.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Replication Configuration EBS encryption.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Replication Configuration EBS encryption key ARN.
name
— (String
)Replication Configuration name.
replicatedDisks
— (Array<map>
)Replication Configuration replicated disks.
deviceName
— (String
)Replication Configuration replicated disk device name.
iops
— (Integer
)Replication Configuration replicated disk IOPs.
isBootDisk
— (Boolean
)Replication Configuration replicated disk boot disk.
stagingDiskType
— (String
)Replication Configuration replicated disk staging disk type.
Possible values include:"AUTO"
"GP2"
"IO1"
"SC1"
"ST1"
"STANDARD"
"GP3"
"IO2"
throughput
— (Integer
)Replication Configuration replicated disk throughput.
replicationServerInstanceType
— (String
)Replication Configuration Replication Server instance type.
replicationServersSecurityGroupsIDs
— (Array<String>
)Replication Configuration Replication Server Security Group IDs.
sourceServerID
— (String
)Replication Configuration Source Server ID.
stagingAreaSubnetId
— (String
)Replication Configuration Staging Area subnet ID.
stagingAreaTags
— (map<String>
)Replication Configuration Staging Area tags.
useDedicatedReplicationServer
— (Boolean
)Replication Configuration use Dedicated Replication Server.
useFipsEndpoint
— (Boolean
)Replication Configuration use Fips Endpoint.
-
(AWS.Response)
—
Returns:
updateReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request
Updates multiple ReplicationConfigurationTemplates by ID.
Service Reference:
Examples:
Calling the updateReplicationConfigurationTemplate operation
var params = {
replicationConfigurationTemplateID: 'STRING_VALUE', /* required */
arn: 'STRING_VALUE',
associateDefaultSecurityGroup: true || false,
bandwidthThrottling: 'NUMBER_VALUE',
createPublicIP: true || false,
dataPlaneRouting: PRIVATE_IP | PUBLIC_IP,
defaultLargeStagingDiskType: GP2 | ST1 | GP3,
ebsEncryption: DEFAULT | CUSTOM,
ebsEncryptionKeyArn: 'STRING_VALUE',
replicationServerInstanceType: 'STRING_VALUE',
replicationServersSecurityGroupsIDs: [
'STRING_VALUE',
/* more items */
],
stagingAreaSubnetId: 'STRING_VALUE',
stagingAreaTags: {
'<TagKey>': 'STRING_VALUE',
/* '<TagKey>': ... */
},
useDedicatedReplicationServer: true || false,
useFipsEndpoint: true || false
};
mgn.updateReplicationConfigurationTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
arn
— (String
)Update replication configuration template ARN request.
associateDefaultSecurityGroup
— (Boolean
)Update replication configuration template associate default Application Migration Service Security group request.
bandwidthThrottling
— (Integer
)Update replication configuration template bandwidth throttling request.
createPublicIP
— (Boolean
)Update replication configuration template create Public IP request.
dataPlaneRouting
— (String
)Update replication configuration template data plane routing request.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Update replication configuration template use default large Staging Disk type request.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Update replication configuration template EBS encryption request.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Update replication configuration template EBS encryption key ARN request.
replicationConfigurationTemplateID
— (String
)Update replication configuration template template ID request.
replicationServerInstanceType
— (String
)Update replication configuration template Replication Server instance type request.
replicationServersSecurityGroupsIDs
— (Array<String>
)Update replication configuration template Replication Server Security groups IDs request.
stagingAreaSubnetId
— (String
)Update replication configuration template Staging Area subnet ID request.
stagingAreaTags
— (map<String>
)Update replication configuration template Staging Area Tags request.
useDedicatedReplicationServer
— (Boolean
)Update replication configuration template use dedicated Replication Server request.
useFipsEndpoint
— (Boolean
)Update replication configuration template use Fips Endpoint request.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Replication Configuration template ARN.
associateDefaultSecurityGroup
— (Boolean
)Replication Configuration template associate default Application Migration Service Security group.
bandwidthThrottling
— (Integer
)Replication Configuration template bandwidth throttling.
createPublicIP
— (Boolean
)Replication Configuration template create Public IP.
dataPlaneRouting
— (String
)Replication Configuration template data plane routing.
Possible values include:"PRIVATE_IP"
"PUBLIC_IP"
defaultLargeStagingDiskType
— (String
)Replication Configuration template use default large Staging Disk type.
Possible values include:"GP2"
"ST1"
"GP3"
ebsEncryption
— (String
)Replication Configuration template EBS encryption.
Possible values include:"DEFAULT"
"CUSTOM"
ebsEncryptionKeyArn
— (String
)Replication Configuration template EBS encryption key ARN.
replicationConfigurationTemplateID
— (String
)Replication Configuration template ID.
replicationServerInstanceType
— (String
)Replication Configuration template server instance type.
replicationServersSecurityGroupsIDs
— (Array<String>
)Replication Configuration template server Security Groups IDs.
stagingAreaSubnetId
— (String
)Replication Configuration template Staging Area subnet ID.
stagingAreaTags
— (map<String>
)Replication Configuration template Staging Area Tags.
tags
— (map<String>
)Replication Configuration template Tags.
useDedicatedReplicationServer
— (Boolean
)Replication Configuration template use Dedicated Replication Server.
useFipsEndpoint
— (Boolean
)Replication Configuration template use Fips Endpoint.
-
(AWS.Response)
—
Returns:
updateSourceServer(params = {}, callback) ⇒ AWS.Request
Update Source Server.
Service Reference:
Examples:
Calling the updateSourceServer operation
var params = {
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
connectorAction: {
connectorArn: 'STRING_VALUE',
credentialsSecretArn: 'STRING_VALUE'
}
};
mgn.updateSourceServer(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Update Source Server request account ID.
connectorAction
— (map
)Update Source Server request connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
sourceServerID
— (String
)Update Source Server request source server ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
updateSourceServerReplicationType(params = {}, callback) ⇒ AWS.Request
Allows you to change between the AGENT_BASED replication type and the SNAPSHOT_SHIPPING replication type.
Service Reference:
Examples:
Calling the updateSourceServerReplicationType operation
var params = {
replicationType: AGENT_BASED | SNAPSHOT_SHIPPING, /* required */
sourceServerID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE'
};
mgn.updateSourceServerReplicationType(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID on which to update replication type.
replicationType
— (String
)Replication type to which to update source server.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceServerID
— (String
)ID of source server on which to update replication type.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:applicationID
— (String
)Source server application ID.
arn
— (String
)Source server ARN.
connectorAction
— (map
)Source Server connector action.
connectorArn
— (String
)Source Server connector action connector arn.
credentialsSecretArn
— (String
)Source Server connector action credentials secret arn.
dataReplicationInfo
— (map
)Source server data replication info.
dataReplicationError
— (map
)Error in obtaining data replication info.
error
— (String
)Error in data replication.
Possible values include:"AGENT_NOT_SEEN"
"SNAPSHOTS_FAILURE"
"NOT_CONVERGING"
"UNSTABLE_NETWORK"
"FAILED_TO_CREATE_SECURITY_GROUP"
"FAILED_TO_LAUNCH_REPLICATION_SERVER"
"FAILED_TO_BOOT_REPLICATION_SERVER"
"FAILED_TO_AUTHENTICATE_WITH_SERVICE"
"FAILED_TO_DOWNLOAD_REPLICATION_SOFTWARE"
"FAILED_TO_CREATE_STAGING_DISKS"
"FAILED_TO_ATTACH_STAGING_DISKS"
"FAILED_TO_PAIR_REPLICATION_SERVER_WITH_AGENT"
"FAILED_TO_CONNECT_AGENT_TO_REPLICATION_SERVER"
"FAILED_TO_START_DATA_TRANSFER"
"UNSUPPORTED_VM_CONFIGURATION"
"LAST_SNAPSHOT_JOB_FAILED"
rawError
— (String
)Error in data replication.
dataReplicationInitiation
— (map
)Request to query whether data replication has been initiated.
nextAttemptDateTime
— (String
)Request to query next data initiation date and time.
startDateTime
— (String
)Request to query data initiation start date and time.
steps
— (Array<map>
)Request to query data initiation steps.
name
— (String
)Request to query data initiation step name.
Possible values include:"WAIT"
"CREATE_SECURITY_GROUP"
"LAUNCH_REPLICATION_SERVER"
"BOOT_REPLICATION_SERVER"
"AUTHENTICATE_WITH_SERVICE"
"DOWNLOAD_REPLICATION_SOFTWARE"
"CREATE_STAGING_DISKS"
"ATTACH_STAGING_DISKS"
"PAIR_REPLICATION_SERVER_WITH_AGENT"
"CONNECT_AGENT_TO_REPLICATION_SERVER"
"START_DATA_TRANSFER"
status
— (String
)Request to query data initiation status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"SUCCEEDED"
"FAILED"
"SKIPPED"
dataReplicationState
— (String
)Request to query the data replication state.
Possible values include:"STOPPED"
"INITIATING"
"INITIAL_SYNC"
"BACKLOG"
"CREATING_SNAPSHOT"
"CONTINUOUS"
"PAUSED"
"RESCAN"
"STALLED"
"DISCONNECTED"
"PENDING_SNAPSHOT_SHIPPING"
"SHIPPING_SNAPSHOT"
etaDateTime
— (String
)Request to query the time when data replication will be complete.
lagDuration
— (String
)Request to query data replication lag duration.
lastSnapshotDateTime
— (String
)Request to query data replication last snapshot time.
replicatedDisks
— (Array<map>
)Request to query disks replicated.
backloggedStorageBytes
— (Integer
)Request to query data replication backlog size in bytes.
deviceName
— (String
)Request to query device name.
replicatedStorageBytes
— (Integer
)Request to query amount of data replicated in bytes.
rescannedStorageBytes
— (Integer
)Request to query amount of data rescanned in bytes.
totalStorageBytes
— (Integer
)Request to query total amount of data replicated in bytes.
fqdnForActionFramework
— (String
)Source server fqdn for action framework.
isArchived
— (Boolean
)Source server archived status.
launchedInstance
— (map
)Source server launched instance.
ec2InstanceID
— (String
)Launched instance EC2 ID.
firstBoot
— (String
)Launched instance first boot.
Possible values include:"WAITING"
"SUCCEEDED"
"UNKNOWN"
"STOPPED"
jobID
— (String
)Launched instance Job ID.
lifeCycle
— (map
)Source server lifecycle state.
addedToServiceDateTime
— (String
)Lifecycle added to service data and time.
elapsedReplicationDuration
— (String
)Lifecycle elapsed time and duration.
firstByteDateTime
— (String
)Lifecycle replication initiation date and time.
lastCutover
— (map
)Lifecycle last Cutover.
finalized
— (map
)Lifecycle Cutover finalized date and time.
apiCallDateTime
— (String
)Lifecycle Cutover finalized date and time.
initiated
— (map
)Lifecycle last Cutover initiated.
apiCallDateTime
— (String
)jobID
— (String
)Lifecycle last Cutover initiated by Job ID.
reverted
— (map
)Lifecycle last Cutover reverted.
apiCallDateTime
— (String
)Lifecycle last Cutover reverted API call date time.
lastSeenByServiceDateTime
— (String
)Lifecycle last seen date and time.
lastTest
— (map
)Lifecycle last Test.
finalized
— (map
)Lifecycle last Test finalized.
apiCallDateTime
— (String
)Lifecycle Test failed API call date and time.
initiated
— (map
)Lifecycle last Test initiated.
apiCallDateTime
— (String
)Lifecycle last Test initiated API call date and time.
jobID
— (String
)Lifecycle last Test initiated Job ID.
reverted
— (map
)Lifecycle last Test reverted.
apiCallDateTime
— (String
)Lifecycle last Test reverted API call date and time.
state
— (String
)Lifecycle state.
Possible values include:"STOPPED"
"NOT_READY"
"READY_FOR_TEST"
"TESTING"
"READY_FOR_CUTOVER"
"CUTTING_OVER"
"CUTOVER"
"DISCONNECTED"
"DISCOVERED"
"PENDING_INSTALLATION"
replicationType
— (String
)Source server replication type.
Possible values include:"AGENT_BASED"
"SNAPSHOT_SHIPPING"
sourceProperties
— (map
)Source server properties.
cpus
— (Array<map>
)Source Server CPUs.
cores
— (Integer
)The number of CPU cores on the source server.
modelName
— (String
)The source server's CPU model name.
disks
— (Array<map>
)Source Server disks.
bytes
— (Integer
)The amount of storage on the disk in bytes.
deviceName
— (String
)The disk or device name.
identificationHints
— (map
)Source server identification hints.
awsInstanceID
— (String
)AWS Instance ID identification hint.
fqdn
— (String
)FQDN address identification hint.
hostname
— (String
)Hostname identification hint.
vmPath
— (String
)vCenter VM path identification hint.
vmWareUuid
— (String
)vmWare UUID identification hint.
lastUpdatedDateTime
— (String
)Source server last update date and time.
networkInterfaces
— (Array<map>
)Source server network interfaces.
ips
— (Array<String>
)Network interface IPs.
isPrimary
— (Boolean
)Network interface primary IP.
macAddress
— (String
)Network interface Mac address.
os
— (map
)Source server OS.
fullString
— (String
)OS full string.
ramBytes
— (Integer
)Source server RAM in bytes.
recommendedInstanceType
— (String
)Source server recommended instance type.
sourceServerID
— (String
)Source server ID.
tags
— (map<String>
)Source server Tags.
userProvidedID
— (String
)Source server user provided ID.
vcenterClientID
— (String
)Source server vCenter client id.
-
(AWS.Response)
—
Returns:
updateWave(params = {}, callback) ⇒ AWS.Request
Update wave.
Service Reference:
Examples:
Calling the updateWave operation
var params = {
waveID: 'STRING_VALUE', /* required */
accountID: 'STRING_VALUE',
description: 'STRING_VALUE',
name: 'STRING_VALUE'
};
mgn.updateWave(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
accountID
— (String
)Account ID.
description
— (String
)Wave description.
name
— (String
)Wave name.
waveID
— (String
)Wave ID.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:arn
— (String
)Wave ARN.
creationDateTime
— (String
)Wave creation dateTime.
description
— (String
)Wave description.
isArchived
— (Boolean
)Wave archival status.
lastModifiedDateTime
— (String
)Wave last modified dateTime.
name
— (String
)Wave name.
tags
— (map<String>
)Wave tags.
waveAggregatedStatus
— (map
)Wave aggregated status.
healthStatus
— (String
)Wave aggregated status health status.
Possible values include:"HEALTHY"
"LAGGING"
"ERROR"
lastUpdateDateTime
— (String
)Wave aggregated status last update dateTime.
progressStatus
— (String
)Wave aggregated status progress status.
Possible values include:"NOT_STARTED"
"IN_PROGRESS"
"COMPLETED"
replicationStartedDateTime
— (String
)DateTime marking when the first source server in the wave started replication.
totalApplications
— (Integer
)Wave aggregated status total applications amount.
waveID
— (String
)Wave ID.
-
(AWS.Response)
—
Returns: