anchor.diff:  }
   ----
   // CONSOLE
  -// TEST[skip:we don't have s3 set up while testing this]
  +// TEST[skip:we don't have S3 set up while testing this]
   
   The following settings are supported:
   
  
positive.code: 
  `access_key` ({ref}/secure-settings.html[Secure])::
  
      An s3 access key. The `secret_key` setting must also be specified. 
  
  `secret_key` ({ref}/secure-settings.html[Secure])::
  
      An s3 secret key. The `access_key` setting must also be specified. 
  
  `session_token`::
      An s3 session token. The `access_key` and `secret_key` settings must also
      be specified. (Secure)
  
  `endpoint`::
  
      The s3 service endpoint to connect to. This will be automatically
      figured out by the s3 client based on the bucket location, but
      can be specified explicitly. See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region.
  
  `protocol`::
  
      The protocol to use to connect to s3. Valid values are either `http`
      or `https`. Defaults to `https`. 
  
  `proxy.host`::
  
      The host name of a proxy to connect to s3 through.
  
  `proxy.port`::
  
      The port of a proxy to connect to s3 through.
  
  `proxy.username` ({ref}/secure-settings.html[Secure])::
  
      The username to connect to the `proxy.host` with.    
  
  `proxy.password` ({ref}/secure-settings.html[Secure])::
  
      The password to connect to the `proxy.host` with.   
  
  `read_timeout`::
  
      The socket timeout for connecting to s3. The value should specify the unit. For example,
      a value of `5s` specifies a 5 second timeout. The default value is 50 seconds.
  
  `max_retries`::
  
      The number of retries to use when an s3 request fails. The default value is 3.
  
  `use_throttle_retries`::
  
      Whether retries should be throttled (ie use backoff). Must be `true` or `false`. Defaults to `true`.
  
  [[repository-s3-repository]]
  ==== Repository Settings
  
  The `s3` repository type supports a number of settings to customize how data is stored in S3.
  These can be specified when creating the repository. For example:
  
  [source,js]
  ----
  
negative.code: 
  `client`::
  
      The name of the <<repository-s3-client,S3 client>> to use to connect to S3.
      Defaults to `default`.
  
  `base_path`::
  
      Specifies the path within bucket to repository data. Defaults to value of
      `repositories.s3.base_path` or to root directory if not set.  Previously,
      the base_path could take a leading `/` (forward slash).  However, this has
      been deprecated and setting the base_path now should omit the leading `/`.
  
  `chunk_size`::
  
      Big files can be broken down into chunks during snapshotting if needed.  The
      chunk size can be specified in bytes or by using size value notation, i.e.
      `1gb`, `10mb`, `5kb`. Defaults to `1gb`.
  
  `compress`::
  
  