Method: AWS::Configuration#with

Defined in:

lib/aws/configuration.rb

#with(options = {}) ⇒ Configuration

Used to create a new Configuration object with the given modifications. The current configuration object is not modified.

AWS.config(:max_retries => 2)

no_retries_config = AWS.config.with(:max_retries => 0)

AWS.config.max_retries        #=> 2
no_retries_config.max_retries #=> 0

You can use these configuration objects returned by #with to create AWS objects:

AWS::S3.new(:config => no_retries_config)
AWS::SQS.new(:config => no_retries_config)

Parameters:

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

Options Hash (options):

• :access_key_id (String) —

  Your account access key id credential.

• :secret_access_key (String) —

  Your account secret access key credential.

• :max_retries (Integer) — default: 3 —

  The maximum number of times service errors (500) should be retried. There is an exponential backoff in between service request retries, so the more retries the longer it can take to fail.

• :ec2_endpoint (String) — default: 'ec2.amazonaws.com' —

  The service endpoint to use when communicating with Amazon EC2.

• :http_handler (Object) —

  The request/response handler for all service requests. The default handler uses HTTParty to send requests.

• :logger (Object) — default: nil —

  A logger instance that should receive log messages generated by service requets. A logger needs to respond to #log and must accept a severity (e.g. :info, :error, etc) and a string message.

• :s3_endpoint (String) — default: 's3.amazonaws.com' —

  The service endpoint to use when communicating with Amazon S3.

• :simple_db_consistent_reads (Boolean) — default: false —

  When true all read operations against SimpleDB will be consistent reads (slower).

• :simple_db_endpoint (String) — default: 'sdb.amazonaws.com' —

  The service endpoint to use when communicating with Amazon SimpleDB.

• :simple_email_service_endpoint (String) — default: 'email.us-east-1.amazonaws.com' —

  The service endpoint to use when communicating with Amazon SimpleEmailService.

• :signer (Object) —

  The request signer. Defaults to a DefaultSigner.

• :sns_endpoint (String) — default: 'sns.us-east-1.amazonaws.com' —

  The service endpoint to use when communicating with Amazon SNS.

• :sqs_endpoint (String) — default: 'sqs.us-east-1.amazonaws.com' —

  The service endpoint to use when communicating with Amazon SQS.

• :stub_requests (Object) — default: false —

  When true no requests will be made against the live service. Responses returned will have empty values. This is primarily used for writing tests.

• :use_ssl (Boolean) — default: true —

  When true, all requests are sent over SSL.

• :ssl_verify_peer (Boolean) — default: true —

  True if the HTTPS client should validate the server certificate. Note: This option should only be used for diagnostic purposes; leaving this option set to false exposes your application to man-in-the-middle attacks and can pose a serious security risk.

• :ssl_ca_file (String) —

  The path to a CA cert bundle in PEM format. If :ssl_verify_peer is true (the default) this bundle will be used to validate the server certificate in each HTTPS request. The AWS SDK for Ruby ships with a CA cert bundle, which is the default value for this option.

• :user_agent_prefix (String) — default: nil —

  A string prefix to append to all requets against AWS services. This should be set for clients and applications built ontop of the aws-sdk gem.

Returns:

• (Configuration) —

  Copies the current configuration and returns a new one with modifications as provided in :options.

# File 'lib/aws/configuration.rb', line 145

def with options = {}
  overridden = @overridden + options.keys.map { |k| k.to_sym }
  self.class.new(@options.merge(options).
                 merge(:__create_options__ => @create_options,
                       :__overridden__ => overridden))
end