module Awspec::Helper::Finder::Ec2

Public Instance Methods

dup_ec2_instance(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 49
def dup_ec2_instance(id)
  "Duplicate instances matching id or tag #{id}"
end
find_ec2(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 6
def find_ec2(id)
  # instance_id or tag:Name

  # First tries to search by using an educated guess, based on the
  # references below:
  # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/resource-ids.html
  # https://docs.chef.io/inspec/resources/aws_ec2_instance/
  # This should be faster then just first trying ID when the parameter is
  # clearly not one

  # https://medium.com/@Bakku1505/ruby-start-with-end-with-vs-regular-expressions-59728be0859e
  if id.start_with?('i-') && id.length == 19 && id =~ /^i-[0-9a-f]/
    begin
      res = ec2_client.describe_instances({
                                            instance_ids: [id]
                                          })
    rescue Aws::EC2::Errors::InvalidInstanceIDNotFound, Aws::EC2::Errors::InvalidInstanceIDMalformed => e
      res = ec2_client.describe_instances({
                                            filters: [{ name: 'tag:Name', values: [id] }]
                                          })
    end
  else
    begin
      res = ec2_client.describe_instances({
                                            filters: [{ name: 'tag:Name', values: [id] }]
                                          })
    rescue Aws::EC2::Errors::InvalidInstanceIDNotFound, Aws::EC2::Errors::InvalidInstanceIDMalformed => e
      res = ec2_client.describe_instances({
                                            instance_ids: [id]
                                          })
      if res.reservations.count > 1
        warn "Warning: '#{id}' unexpectedly identified as a valid instance ID during fallback search"
      end
    end
  end

  return nil if res.reservations.count == 0
  return res.reservations.first.instances.single_resource(id) if res.reservations.count == 1
  raise Awspec::DuplicatedResourceTypeError, dup_ec2_instance(id) if res.reservations.count > 1

  raise "Unexpected condition of having reservations = #{res.reservations.count}"
end
find_ec2_attribute(id, attribute) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 53
def find_ec2_attribute(id, attribute)
  res = ec2_client.describe_instance_attribute({
                                                 instance_id: id, attribute: attribute
                                               })
end
find_ec2_credit_specifications(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 59
def find_ec2_credit_specifications(id)
  res = ec2_client.describe_instance_credit_specifications({
                                                             instance_ids: [id]
                                                           })
  res.instance_credit_specifications.first if res.instance_credit_specifications.count == 1
end
find_ec2_status(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 66
def find_ec2_status(id)
  res = ec2_client.describe_instance_status({
                                              instance_ids: [id]
                                            })
  res.instance_statuses.first if res.instance_statuses.count == 1
end
find_launch_template(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 198
def find_launch_template(id)
  # launch_template_id or launch_template_name
  begin
    res = ec2_client.describe_launch_templates({
                                                 launch_template_ids: [id]
                                               })
  rescue StandardError
    res = ec2_client.describe_launch_templates({
                                                 launch_template_names: [id]
                                               })
  end
  res.launch_templates.single_resource(id)
end
find_launch_template_versions(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 212
def find_launch_template_versions(id)
  # launch_template_id or launch_template_name
  res = ec2_client.describe_launch_template_versions({
                                                       launch_template_id: id
                                                     })
rescue StandardError
  res = ec2_client.describe_launch_template_versions({
                                                       launch_template_name: id
                                                     })
end
find_managed_prefix_list(prefix_list_name) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 232
def find_managed_prefix_list(prefix_list_name)
  res = ec2_client.describe_managed_prefix_lists({
                                                   filters: [{ name: 'prefix-list-name',
                                                               values: [prefix_list_name] }]
                                                 })
  res.prefix_lists.single_resource(prefix_list_name)
end
find_nat_gateway(gateway_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 121
def find_nat_gateway(gateway_id)
  # nat_gateway_id or tag:Name
  begin
    res = ec2_client.describe_nat_gateways({
                                             nat_gateway_ids: [gateway_id]
                                           })
  rescue StandardError
    res = ec2_client.describe_nat_gateways({
                                             filter: [{ name: 'tag:Name', values: [gateway_id] }]
                                           })
  end
  if res.nat_gateways.count == 1
    res.nat_gateways.single_resource(gateway_id)
  elsif res.nat_gateways.count > 1
    raise Awspec::DuplicatedResourceTypeError, "Duplicate nat_gateways matching id or tag #{gateway_id}"
  end
end
find_network_interface(interface_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 139
def find_network_interface(interface_id)
  res = ec2_client.describe_network_interfaces({
                                                 filters: [
                                                   {
                                                     name: 'network-interface-id',
                                                     values: [interface_id]
                                                   }
                                                 ]
                                               })
  resource = res.network_interfaces.single_resource(interface_id)
  return resource if resource
rescue Aws::EC2::Errors::InvalidNetworkInterfaceIdMalformed => e
  res = ec2_client.describe_network_interfaces({
                                                 filters: [{ name: 'tag:Name', values: [interface_id] }]
                                               })
  res.network_interfaces.single_resource(interface_id)
end
find_tgw_attachments_by_tgw_id(tgw_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 223
def find_tgw_attachments_by_tgw_id(tgw_id)
  res = ec2_client.describe_transit_gateway_attachments({
                                                          filters: [
                                                            { name: 'transit-gateway-id', values: [tgw_id] }
                                                          ]
                                                        })
  res.transit_gateway_attachments
end
find_vpn_connection(vpn_connection_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 98
def find_vpn_connection(vpn_connection_id)
  res = ec2_client.describe_vpn_connections({
                                              filters: [
                                                {
                                                  name: 'vpn-connection-id',
                                                  values: [vpn_connection_id]
                                                }
                                              ]
                                            })
  resource = res.vpn_connections.single_resource(vpn_connection_id)
  return resource if resource

  res = ec2_client.describe_vpn_connections({
                                              filters: [
                                                {
                                                  name: 'tag:Name',
                                                  values: [vpn_connection_id]
                                                }
                                              ]
                                            })
  res.vpn_connections.single_resource(vpn_connection_id)
end
select_ec2_by_vpc_id(vpc_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 157
def select_ec2_by_vpc_id(vpc_id)
  res = ec2_client.describe_instances({
                                        filters: [{ name: 'vpc-id', values: [vpc_id] }]
                                      })
  instances = []
  res.reservations.each do |reservation|
    reservation.instances.each do |instance|
      instances.push(instance)
    end
  end
  instances
end
select_internet_gateway_by_vpc_id(vpc_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 184
def select_internet_gateway_by_vpc_id(vpc_id)
  res = ec2_client.describe_internet_gateways({
                                                filters: [{ name: 'attachment.vpc-id', values: [vpc_id] }]
                                              })
  res.internet_gateways
end
select_managed_prefix_list_entries(prefix_list_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 240
def select_managed_prefix_list_entries(prefix_list_id)
  ec2_client.get_managed_prefix_list_entries({ prefix_list_id: prefix_list_id }).data.entries
end
select_nat_gateway_by_vpc_id(vpc_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 177
def select_nat_gateway_by_vpc_id(vpc_id)
  res = ec2_client.describe_nat_gateways({
                                           filter: [{ name: 'vpc-id', values: [vpc_id] }]
                                         })
  res.nat_gateways
end
select_network_interface_by_instance_id(id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 170
def select_network_interface_by_instance_id(id)
  res = ec2_client.describe_network_interfaces({
                                                 filters: [{ name: 'attachment.instance-id', values: [id] }]
                                               })
  res.network_interfaces
end
select_network_interface_by_vpc_id(vpc_id) click to toggle source
# File lib/awspec/helper/finder/ec2.rb, line 191
def select_network_interface_by_vpc_id(vpc_id)
  res = ec2_client.describe_network_interfaces({
                                                 filters: [{ name: 'vpc-id', values: [vpc_id] }]
                                               })
  res.network_interfaces
end