# AWS Elastic Load Balancing API

[![hex.pm](https://img.shields.io/hexpm/v/ex_aws_elastic_load_balancing.svg)](https://hex.pm/packages/ex_aws_elastic_load_balancing)
[![hex.pm](https://img.shields.io/hexpm/dt/ex_aws_elastic_load_balancing.svg)](https://hex.pm/packages/ex_aws_elastic_load_balancing)
[![hex.pm](https://img.shields.io/hexpm/l/ex_aws_elastic_load_balancing.svg)](https://hex.pm/packages/ex_aws_elastic_load_balancing)
[![hexdocs.pm](https://img.shields.io/badge/hexdocs-release-lightgreen.svg)](https://hexdocs.pm/ex_aws_elastic_load_balancing)
[![github.com](https://img.shields.io/github/last-commit/fmcgeough/ex_aws_elastic_load_balancing.svg)](https://github.com/fmcgeough/ex_aws_elastic_load_balancing/commits/master)

AWS Elastic Load Balancing Service module for [ex_aws](https://github.com/ex-aws/ex_aws).

AWS Elastic Load Balancing consists of two different API's that are grouped under the general heading of "Elastic Load Balancing". Both are included in 
this library. `ExAws.ElasticLoadBalancing`is used for what Amazon calls "Classic" Load Balancers. `ExAws.ElasticLoadBalancingV2` is used for 
Application Load Balancers, Network Load Balancers and Gateway Load Balancers.

## Installation

The package can be installed by adding `ex_aws_elastic_load_balancing` to your
list of dependencies in mix.exs along with `:ex_aws` and your
preferred JSON codec / http client. Example:

```elixir
def deps do
  [
    {:ex_aws, "~> 2.5"},
    {:ex_aws_elastic_load_balancing, "~> 3.0"},
    {:poison, "~> 3.0"},
    {:hackney, "~> 1.9"},
  ]
end
```

Simple usage from command line:

```elixir
iex(1)> alias ExAws.ElasticLoadBalancing
ExAws.ElasticLoadBalancing
iex(2)>  keys = [secret_access_key: "my_secret_keys",  access_key_id: "my_access_id", region: "us-east-1"]
[secret_access_key: "my_secret_keys",
 access_key_id: "my_access_id", region: "us-east-1"]
iex(3)>  ElasticLoadBalancing.describe_load_balancers() |> ExAws.request(keys)
```

## Other Notes

Both AWS Elastic Load Balancing APIs use the "query" protocol. So every function in the API
returns a `ExAws.Operation.Query` struct.

Most of the unit tests are implemented using [DocTest](https://hexdocs.pm/ex_unit/ExUnit.DocTest.html).

There is some minimal support for parsing the results of a limited number of operations using the SweetXml library.

## License

[License](LICENSE)