We announced the upcoming end-of-support for AWS SDK for JavaScript v2.
We recommend that you migrate to AWS SDK for JavaScript v3. For dates, additional details, and information on how to migrate, please refer to the linked announcement.

Class: AWS.Mgn

Inherits:
AWS.Service show all
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

Property Summary collapse

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

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.
  • 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 to true.

  • 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

endpointAWS.Endpoint (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

  • (AWS.Endpoint)

    an Endpoint object representing the endpoint URL for service requests.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

      • staterequired — (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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

      • cloudWatchOutputEnabledrequired — (Boolean)

        Connector SSM command config CloudWatch output enabled.

      • outputS3BucketName — (String)

        Connector SSM command config output S3 bucket name.

      • s3OutputEnabledrequired — (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. The data 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.

        • cloudWatchOutputEnabledrequired — (Boolean)

          Connector SSM command config CloudWatch output enabled.

        • outputS3BucketName — (String)

          Connector SSM command config output S3 bucket name.

        • s3OutputEnabledrequired — (Boolean)

          Connector SSM command config S3 output enabled.

      • ssmInstanceID — (String)

        Connector SSM instance ID.

      • tags — (map<String>)

        Connector tags.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Creates a new Launch Configuration Template.

Examples:

Calling the createLaunchConfigurationTemplate operation

var params = {
  associatePublicIpAddress: true || false,
  bootMode: LEGACY_BIOS | UEFI,
  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"
    • 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.

        • actionNamerequired — (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.

          • parameterNamerequired — (String)

            AWS Systems Manager Parameter Store parameter name.

          • parameterTyperequired — (String)

            AWS Systems Manager Parameter Store parameter type.

            Possible values include:
            • "STRING"
        • ssmDocumentNamerequired — (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. The data 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"
      • 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.

          • actionNamerequired — (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.

            • parameterNamerequired — (String)

              AWS Systems Manager Parameter Store parameter name.

            • parameterTyperequired — (String)

              AWS Systems Manager Parameter Store parameter type.

              Possible values include:
              • "STRING"
          • ssmDocumentNamerequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Creates a new ReplicationConfigurationTemplate.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Deletes a single Launch Configuration Template by ID.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Deletes a single Replication Configuration Template by ID

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
        • jobIDrequired — (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.

                • actionNamerequired — (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.

                  • parameterNamerequired — (String)

                    AWS Systems Manager Parameter Store parameter name.

                  • parameterTyperequired — (String)

                    AWS Systems Manager Parameter Store parameter type.

                    Possible values include:
                    • "STRING"
                • ssmDocumentNamerequired — (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.

          • sourceServerIDrequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeLaunchConfigurationTemplates(params = {}, callback) ⇒ AWS.Request

Lists all Launch Configuration Templates, filtered by Launch Configuration Template IDs

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. The data 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"
        • 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"
        • launchConfigurationTemplateIDrequired — (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.

            • actionNamerequired — (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.

              • parameterNamerequired — (String)

                AWS Systems Manager Parameter Store parameter name.

              • parameterTyperequired — (String)

                AWS Systems Manager Parameter Store parameter type.

                Possible values include:
                • "STRING"
            • ssmDocumentNamerequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

describeReplicationConfigurationTemplates(params = {}, callback) ⇒ AWS.Request

Lists all ReplicationConfigurationTemplates, filtered by Source Server IDs.

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. The data 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.

        • replicationConfigurationTemplateIDrequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data object has the following properties:

      • bootMode — (String)

        Launch configuration boot mode.

        Possible values include:
        • "LEGACY_BIOS"
        • "UEFI"
      • 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.

          • actionNamerequired — (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.

            • parameterNamerequired — (String)

              AWS Systems Manager Parameter Store parameter name.

            • parameterTyperequired — (String)

              AWS Systems Manager Parameter Store parameter type.

              Possible values include:
              • "STRING"
          • ssmDocumentNamerequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

          • cloudWatchOutputEnabledrequired — (Boolean)

            Connector SSM command config CloudWatch output enabled.

          • outputS3BucketName — (String)

            Connector SSM command config output S3 bucket name.

          • s3OutputEnabledrequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

          • s3Bucketrequired — (String)

            S3 bucket source s3 bucket.

          • s3BucketOwner — (String)

            S3 bucket source s3 bucket owner.

          • s3Keyrequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
          • "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.

          • parameterNamerequired — (String)

            AWS Systems Manager Parameter Store parameter name.

          • parameterTyperequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data object has the following properties:

      • tags — (map<String>)

        List tags for resource response.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
          • "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.

          • parameterNamerequired — (String)

            AWS Systems Manager Parameter Store parameter name.

          • parameterTyperequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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 | 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"
      • "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.

      • parameterNamerequired — (String)

        AWS Systems Manager Parameter Store parameter name.

      • parameterTyperequired — (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. The data 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"
        • "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.

        • parameterNamerequired — (String)

          AWS Systems Manager Parameter Store parameter name.

        • parameterTyperequired — (String)

          AWS Systems Manager Parameter Store parameter type.

          Possible values include:
          • "STRING"
      • timeoutSeconds — (Integer)

        Source server post migration custom action timeout in seconds.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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 | 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"
      • "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.

      • parameterNamerequired — (String)

        AWS Systems Manager Parameter Store parameter name.

      • parameterTyperequired — (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. The data 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"
        • "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.

        • parameterNamerequired — (String)

          AWS Systems Manager Parameter Store parameter name.

        • parameterTyperequired — (String)

          AWS Systems Manager Parameter Store parameter type.

          Possible values include:
          • "STRING"
      • timeoutSeconds — (Integer)

        Template post migration custom action timeout in seconds.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
        • jobIDrequired — (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.

                • actionNamerequired — (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.

                  • parameterNamerequired — (String)

                    AWS Systems Manager Parameter Store parameter name.

                  • parameterTyperequired — (String)

                    AWS Systems Manager Parameter Store parameter type.

                    Possible values include:
                    • "STRING"
                • ssmDocumentNamerequired — (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.

          • sourceServerIDrequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

      • s3Bucketrequired — (String)

        S3 bucket source s3 bucket.

      • s3BucketOwner — (String)

        S3 bucket source s3 bucket owner.

      • s3Keyrequired — (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. The data 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.

          • s3Bucketrequired — (String)

            S3 bucket source s3 bucket.

          • s3BucketOwner — (String)

            S3 bucket source s3 bucket owner.

          • s3Keyrequired — (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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
        • jobIDrequired — (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.

                • actionNamerequired — (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.

                  • parameterNamerequired — (String)

                    AWS Systems Manager Parameter Store parameter name.

                  • parameterTyperequired — (String)

                    AWS Systems Manager Parameter Store parameter type.

                    Possible values include:
                    • "STRING"
                • ssmDocumentNamerequired — (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.

          • sourceServerIDrequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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"
        • jobIDrequired — (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.

                • actionNamerequired — (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.

                  • parameterNamerequired — (String)

                    AWS Systems Manager Parameter Store parameter name.

                  • parameterTyperequired — (String)

                    AWS Systems Manager Parameter Store parameter type.

                    Possible values include:
                    • "STRING"
                • ssmDocumentNamerequired — (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.

          • sourceServerIDrequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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.

      • cloudWatchOutputEnabledrequired — (Boolean)

        Connector SSM command config CloudWatch output enabled.

      • outputS3BucketName — (String)

        Connector SSM command config output S3 bucket name.

      • s3OutputEnabledrequired — (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. The data 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.

        • cloudWatchOutputEnabledrequired — (Boolean)

          Connector SSM command config CloudWatch output enabled.

        • outputS3BucketName — (String)

          Connector SSM command config output S3 bucket name.

        • s3OutputEnabledrequired — (Boolean)

          Connector SSM command config S3 output enabled.

      • ssmInstanceID — (String)

        Connector SSM instance ID.

      • tags — (map<String>)

        Connector tags.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateLaunchConfiguration(params = {}, callback) ⇒ AWS.Request

Updates multiple LaunchConfigurations by Source Server ID.

Service Reference:

Examples:

Calling the updateLaunchConfiguration operation

var params = {
  sourceServerID: 'STRING_VALUE', /* required */
  accountID: 'STRING_VALUE',
  bootMode: LEGACY_BIOS | UEFI,
  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"
    • 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.

        • actionNamerequired — (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.

          • parameterNamerequired — (String)

            AWS Systems Manager Parameter Store parameter name.

          • parameterTyperequired — (String)

            AWS Systems Manager Parameter Store parameter type.

            Possible values include:
            • "STRING"
        • ssmDocumentNamerequired — (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. The data object has the following properties:

      • bootMode — (String)

        Launch configuration boot mode.

        Possible values include:
        • "LEGACY_BIOS"
        • "UEFI"
      • 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.

          • actionNamerequired — (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.

            • parameterNamerequired — (String)

              AWS Systems Manager Parameter Store parameter name.

            • parameterTyperequired — (String)

              AWS Systems Manager Parameter Store parameter type.

              Possible values include:
              • "STRING"
          • ssmDocumentNamerequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateLaunchConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Updates an existing Launch Configuration Template by ID.

Examples:

Calling the updateLaunchConfigurationTemplate operation

var params = {
  launchConfigurationTemplateID: 'STRING_VALUE', /* required */
  associatePublicIpAddress: true || false,
  bootMode: LEGACY_BIOS | UEFI,
  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"
    • 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.

        • actionNamerequired — (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.

          • parameterNamerequired — (String)

            AWS Systems Manager Parameter Store parameter name.

          • parameterTyperequired — (String)

            AWS Systems Manager Parameter Store parameter type.

            Possible values include:
            • "STRING"
        • ssmDocumentNamerequired — (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. The data 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"
      • 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.

          • actionNamerequired — (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.

            • parameterNamerequired — (String)

              AWS Systems Manager Parameter Store parameter name.

            • parameterTyperequired — (String)

              AWS Systems Manager Parameter Store parameter type.

              Possible values include:
              • "STRING"
          • ssmDocumentNamerequired — (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"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateReplicationConfigurationTemplate(params = {}, callback) ⇒ AWS.Request

Updates multiple ReplicationConfigurationTemplates by ID.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateSourceServerReplicationType(params = {}, callback) ⇒ AWS.Request

Allows you to change between the AGENT_BASED replication type and the SNAPSHOT_SHIPPING replication type.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

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. The data 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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.