Method: Aws::Drs::Client#terminate_recovery_instances

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

#terminate_recovery_instances(params = {}) ⇒ Types::TerminateRecoveryInstancesResponse

Initiates a Job for terminating the EC2 resources associated with the specified Recovery Instances, and then will delete the Recovery Instances from the Elastic Disaster Recovery service.

Examples:

Request syntax with placeholder values


resp = client.terminate_recovery_instances({
  recovery_instance_i_ds: ["RecoveryInstanceID"], # required
})

Response structure


resp.job.arn #=> String
resp.job.creation_date_time #=> String
resp.job.end_date_time #=> String
resp.job.initiated_by #=> String, one of "START_RECOVERY", "START_DRILL", "FAILBACK", "DIAGNOSTIC", "TERMINATE_RECOVERY_INSTANCES", "TARGET_ACCOUNT", "CREATE_NETWORK_RECOVERY", "UPDATE_NETWORK_RECOVERY", "ASSOCIATE_NETWORK_RECOVERY"
resp.job.job_id #=> String
resp.job.participating_resources #=> Array
resp.job.participating_resources[0].launch_status #=> String, one of "PENDING", "IN_PROGRESS", "LAUNCHED", "FAILED", "TERMINATED"
resp.job.participating_resources[0].participating_resource_id.source_network_id #=> String
resp.job.participating_servers #=> Array
resp.job.participating_servers[0].launch_actions_status.runs #=> Array
resp.job.participating_servers[0].launch_actions_status.runs[0].action.action_code #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.action_id #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.action_version #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.active #=> Boolean
resp.job.participating_servers[0].launch_actions_status.runs[0].action.category #=> String, one of "MONITORING", "VALIDATION", "CONFIGURATION", "SECURITY", "OTHER"
resp.job.participating_servers[0].launch_actions_status.runs[0].action.description #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.name #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.optional #=> Boolean
resp.job.participating_servers[0].launch_actions_status.runs[0].action.order #=> Integer
resp.job.participating_servers[0].launch_actions_status.runs[0].action.parameters #=> Hash
resp.job.participating_servers[0].launch_actions_status.runs[0].action.parameters["LaunchActionParameterName"].type #=> String, one of "SSM_STORE", "DYNAMIC"
resp.job.participating_servers[0].launch_actions_status.runs[0].action.parameters["LaunchActionParameterName"].value #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].action.type #=> String, one of "SSM_AUTOMATION", "SSM_COMMAND"
resp.job.participating_servers[0].launch_actions_status.runs[0].failure_reason #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].run_id #=> String
resp.job.participating_servers[0].launch_actions_status.runs[0].status #=> String, one of "IN_PROGRESS", "SUCCEEDED", "FAILED"
resp.job.participating_servers[0].launch_actions_status.ssm_agent_discovery_datetime #=> String
resp.job.participating_servers[0].launch_status #=> String, one of "PENDING", "IN_PROGRESS", "LAUNCHED", "FAILED", "TERMINATED"
resp.job.participating_servers[0].recovery_instance_id #=> String
resp.job.participating_servers[0].source_server_id #=> String
resp.job.status #=> String, one of "PENDING", "STARTED", "COMPLETED"
resp.job.tags #=> Hash
resp.job.tags["TagKey"] #=> String
resp.job.type #=> String, one of "LAUNCH", "TERMINATE", "CREATE_CONVERTED_SNAPSHOT"

Parameters:

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

    ({})

Options Hash (params):

  • :recovery_instance_i_ds (required, Array<String>)

    The IDs of the Recovery Instances that should be terminated.

Returns:

See Also:



3014
3015
3016
3017
# File 'lib/aws-sdk-drs/client.rb', line 3014

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