๐ Create, configure, and manage AWS services from Erlang code. ๐
- A clean API separated per service. One module per service.
- Support for most of the AWS services.
- Generated by aws-codegen using the same JSON descriptions of AWS services used to build the AWS SDK for Go.
- Documentation updated from the official AWS docs.
Here is an example of listing Amazon Kinesis streams. First of all,
start a shell with rebar3 shell
, then:
Here is another example, this time using a temporary client, showing how to upload a file to S3 and how to fetch it back:
> Client = aws_client:make_temporary_client(<<"my-access-key-id">>, <<"my-secret-access-key">>, <<"my-token">>, <<"eu-west-1">>).
[...]
> {ok, Content} = file:read_file("/tmp/erlang-logo.png").
[...]
> aws_s3:put_object(Client, <<"my-bucket">>, <<"my-key">>, #{<<"Body">> => Content}).
[...]
> {ok, Response, _} = aws_s3:get_object(Client, <<"my-bucket">>, <<"my-key">>).
[...]
> Content = maps:get(<<"Body">>, Response).
Support for creating Presigned URLs is provided
through the aws_s3_presigned_url
module.
> Client = aws_client:make_client(<<"my-access-key-id">>, <<"my-secret-access-key">>, <<"eu-west-1">>),
[...]
> {ok, Result, _Response} = aws_kinesis:list_streams(Client, #{}),
[...]
> io:format("~p~n", [Result]).
#{<<"HasMoreStreams">> => false,<<"StreamNames">> => []}
Each API which takes Options
allows a retry_options
key and can allow for automatic retries.
Simple provide the following:
[{retry_options, {exponential_with_jitter, {MaxAttempts, BaseSleepTime, CapSleepTime}}} | <other_options>]
This implementation is based on AWS: Exponential Backoff And Jitter.
Simply add the library to your rebar.config
:
{deps, [{aws, "1.0.0", {pkg, aws_erlang}}]}.
Credentials can be obtained via the separate aws_credentials application, which can be configured to fetch credentials from:
- Erlang environment variables
- OS environment variables
- An AWS credentials file
- ECS task credentials
- EC2 metadata (including v2 - IMDS)
Here is an example on how to obtain credentials:
> Credentials = aws_credentials:get_credentials().
[...]
> #{ access_key_id := AccessKeyId
, token := Token
, region := Region
, secret_access_key := SecretAccessKey } = Credentials.
The aws_credentials
application can be installed by adding the following to your rebar.config
:
{deps, [{aws_credentials, "0.1.10"}]}.
The service-specific modules are generated using the aws-codegen library from the JSON descriptions of AWS services provided by Amazon.
The rest of the code is manually written and used as support for the generated code.
$ rebar3 ex_doc
The docs will be available in ./doc
.
$ rebar3 eunit
$ docker-compose -f test/docker/docker-compose.yml up -d
$ rebar3 ct
$ docker-compose -f test/docker/docker-compose.yml down
Copyright 2015 Jamshed Kakar [email protected]
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.