Class: Aws::EC2::Instance::Collection

Inherits:

Resources::Collection

• Object
• Resources::Collection
• Aws::EC2::Instance::Collection

Defined in:

lib/aws-sdk-ec2/instance.rb

Batch Actions

• #batch_create_tags(options = {}) ⇒ void
• #batch_monitor(options = {}) ⇒ void
• #batch_reboot(options = {}) ⇒ void
• #batch_start(options = {}) ⇒ void
• #batch_stop(options = {}) ⇒ void
• #batch_terminate!(options = {}) ⇒ void
• #batch_unmonitor(options = {}) ⇒ void

Instance Method Details

#batch_create_tags(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_create_tags({
  dry_run: false,
  tags: [ # required
    {
      key: "String",
      value: "String",
    },
  ],
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

• :tags (required, Array<Types::Tag>) —

  One or more tags. The ‘value` parameter is required, but if you don’t want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.

# File 'lib/aws-sdk-ec2/instance.rb', line 1397

def batch_create_tags(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:resources] ||= []
    batch.each do |item|
      params[:resources] << {
        id: item.id
      }
    end
    batch[0].client.create_tags(params)
  end
  nil
end

#batch_monitor(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_monitor({
  dry_run: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

# File 'lib/aws-sdk-ec2/instance.rb', line 1423

def batch_monitor(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.monitor_instances(params)
  end
  nil
end

#batch_reboot(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_reboot({
  dry_run: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

# File 'lib/aws-sdk-ec2/instance.rb', line 1449

def batch_reboot(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.reboot_instances(params)
  end
  nil
end

#batch_start(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_start({
  additional_info: "String",
  dry_run: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :additional_info (String) —

  Reserved.

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

# File 'lib/aws-sdk-ec2/instance.rb', line 1478

def batch_start(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.start_instances(params)
  end
  nil
end

#batch_stop(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_stop({
  dry_run: false,
  force: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

• :force (Boolean) —

  Forces the instances to stop. The instances do not have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

  Default: ‘false`

# File 'lib/aws-sdk-ec2/instance.rb', line 1512

def batch_stop(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.stop_instances(params)
  end
  nil
end

#batch_terminate!(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_terminate!({
  dry_run: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

# File 'lib/aws-sdk-ec2/instance.rb', line 1538

def batch_terminate!(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.terminate_instances(params)
  end
  nil
end

#batch_unmonitor(options = {}) ⇒ void

This method returns an undefined value.

Examples:

Request syntax with placeholder values

instance.batch_unmonitor({
  dry_run: false,
})

Parameters:

• options ({}) (defaults to: {})

Options Hash (options):

• :dry_run (Boolean) —

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

# File 'lib/aws-sdk-ec2/instance.rb', line 1564

def batch_unmonitor(options = {})
  batch_enum.each do |batch|
    params = Aws::Util.copy_hash(options)
    params[:instance_ids] ||= []
    batch.each do |item|
      params[:instance_ids] << {
        id: item.id
      }
    end
    batch[0].client.unmonitor_instances(params)
  end
  nil
end