Method: Aws::MigrationHub::Client#notify_migration_task_state

Defined in:
lib/aws-sdk-migrationhub/client.rb

#notify_migration_task_state(params = {}) ⇒ Struct

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

  • Migration tools will call the ‘NotifyMigrationTaskState` API to share the latest progress and status.

  • ‘MigrationTaskName` is used for addressing updates to the correct target.

  • ‘ProgressUpdateStream` is used for access control and to provide a namespace for each migration tool.

Examples:

Request syntax with placeholder values


resp = client.notify_migration_task_state({
  progress_update_stream: "ProgressUpdateStream", # required
  migration_task_name: "MigrationTaskName", # required
  task: { # required
    status: "NOT_STARTED", # required, accepts NOT_STARTED, IN_PROGRESS, FAILED, COMPLETED
    status_detail: "StatusDetail",
    progress_percent: 1,
  },
  update_date_time: Time.now, # required
  next_update_seconds: 1, # required
  dry_run: false,
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :progress_update_stream (required, String) —

    The name of the ProgressUpdateStream.

  • :migration_task_name (required, String) —

    Unique identifier that references the migration task. *Do not store personal data in this field.*

  • :task (required, Types::Task) —

    Information about the task’s progress and status.

  • :update_date_time (required, Time, DateTime, Date, Integer, String) —

    The timestamp when the task was gathered.

  • :next_update_seconds (required, Integer) —

    Number of seconds after the UpdateDateTime within which the Migration Hub can expect an update. If Migration Hub does not receive an update within the specified interval, then the migration task will be considered stale.

  • :dry_run (Boolean) —

    Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



1431
1432
1433
1434
 
# File 'lib/aws-sdk-migrationhub/client.rb', line 1431

def notify_migration_task_state(params = {}, options = {})
  req = build_request(:notify_migration_task_state, params)
  req.send_request(options)
end