AWS.MigrationHub — AWS SDK for JavaScript (original) (raw)

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.

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

The AWS Migration Hub API methods help to obtain server and application migration status and integrate your resource-specific migration tool by providing a programmatic interface to Migration Hub.

Remember that you must set your AWS Migration Hub home region before you call any of these APIs, or a HomeRegionNotSetException error will be returned. Also, you must make the API calls while in your home region.

Sending a Request Using MigrationHub

var migrationhub = new AWS.MigrationHub();
migrationhub.associateCreatedArtifact(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 MigrationHub object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var migrationhub = new AWS.MigrationHub({apiVersion: '2017-05-31'});

You can also set the API version globally in AWS.config.apiVersions using the migrationhub service identifier:

AWS.config.apiVersions = {
  migrationhub: '2017-05-31',
  // other service API versions
};

var migrationhub = new AWS.MigrationHub();

Constructor Summarycollapse

Property Summarycollapse

Properties inherited from AWS.Service

apiVersions

Method Summarycollapse

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService

Constructor Details

new AWS.MigrationHub(options = {}) ⇒ Object

Constructs a service object. This object has one method for each API operation.

Property Details

endpoint ⇒ AWS.Endpoint

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

Method Details

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

Associates a created artifact of an AWS cloud resource, the target receiving the migration, with the migration task performed by a migration tool. This API has the following traits:

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

Associates a discovered resource ID from Application Discovery Service with a migration task.

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

Creates a progress update stream which is an AWS resource used for access control as well as a namespace for migration task names that is implicitly linked to your AWS account. It must uniquely identify the migration tool as it is used for all updates made by the tool; however, it does not need to be unique for each AWS account because it is scoped to the AWS account.

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

Deletes a progress update stream, including all of its tasks, which was previously created as an AWS resource used for access control. This API has the following traits:

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

Gets the migration status of an application.

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

Retrieves a list of all attributes associated with a specific migration task.

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

Disassociates a created artifact of an AWS resource with a migration task performed by a migration tool that was previously associated. This API has the following traits:

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

Disassociate an Application Discovery Service discovered resource from a migration task.

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

Registers a new migration task which represents a server, database, etc., being migrated to AWS by a migration tool.

This API is a prerequisite to calling the NotifyMigrationTaskState API as the migration tool must first register the migration task with Migration Hub.

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

Lists all the migration statuses for your applications. If you use the optional ApplicationIds parameter, only the migration statuses for those applications will be returned.

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

Lists the created artifacts attached to a given migration task in an update stream. This API has the following traits:

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

Lists discovered resources associated with the given MigrationTask.

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

Lists all, or filtered by resource name, migration tasks associated with the user account making this call. This API has the following traits:

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

Lists progress update streams associated with the user account making this call.

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

Sets the migration state of an application. For a given application identified by the value passed to ApplicationId, its status is set or updated by passing one of three values to Status: NOT_STARTED | IN_PROGRESS | COMPLETED.

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

Notifies Migration Hub of the current status, progress, or other detail regarding a migration task. This API has the following traits:

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

Provides identifying details of the resource being migrated so that it can be associated in the Application Discovery Service repository. This association occurs asynchronously after PutResourceAttributes returns.

Note: Because this is an asynchronous call, it will always return 200, whether an association occurs or not. To confirm if an association was found based on the provided details, call ListDiscoveredResources.