%% WARNING: DO NOT EDIT, AUTO-GENERATED CODE!
%% See https://github.com/aws-beam/aws-codegen for more details.
%% @doc AWS IoT
%%
%% AWS IoT-Data enables secure, bi-directional communication between
%% Internet-connected things (such as sensors, actuators, embedded devices,
%% or smart appliances) and the AWS cloud. It implements a broker for
%% applications and things to publish messages over HTTP (Publish) and
%% retrieve, update, and delete shadows. A shadow is a persistent
%% representation of your things and their state in the AWS cloud.
%%
%% Find the endpoint address for actions in the AWS IoT data plane by running
%% this CLI command:
%%
%% aws iot describe-endpoint --endpoint-type iot:Data-ATS
%%
%% The service name used by AWS
%% Signature Version 4 to sign requests is: iotdevicegateway.
-module(aws_iot_data).
-export([delete_thing_shadow/3,
delete_thing_shadow/4,
get_thing_shadow/2,
get_thing_shadow/3,
list_named_shadows_for_thing/2,
list_named_shadows_for_thing/3,
publish/3,
publish/4,
update_thing_shadow/3,
update_thing_shadow/4]).
-include_lib("hackney/include/hackney_lib.hrl").
%%====================================================================
%% API
%%====================================================================
%% @doc Deletes the shadow for the specified thing.
%%
%% For more information, see DeleteThingShadow
%% in the AWS IoT Developer Guide.
delete_thing_shadow(Client, ThingName, Input) ->
delete_thing_shadow(Client, ThingName, Input, []).
delete_thing_shadow(Client, ThingName, Input0, Options) ->
Method = delete,
Path = ["/things/", http_uri:encode(ThingName), "/shadow"],
SuccessStatusCode = undefined,
Headers = [],
Input = Input0,
request(Client, Method, Path, Headers, Input, Options, SuccessStatusCode).
%% @doc Gets the shadow for the specified thing.
%%
%% For more information, see GetThingShadow
%% in the AWS IoT Developer Guide.
get_thing_shadow(Client, ThingName)
when is_map(Client) ->
get_thing_shadow(Client, ThingName, []).
get_thing_shadow(Client, ThingName, Options)
when is_map(Client), is_list(Options) ->
Path = ["/things/", http_uri:encode(ThingName), "/shadow"],
SuccessStatusCode = undefined,
Headers = [],
request(Client, get, Path, Headers, undefined, Options, SuccessStatusCode).
%% @doc Lists the shadows for the specified thing.
list_named_shadows_for_thing(Client, ThingName)
when is_map(Client) ->
list_named_shadows_for_thing(Client, ThingName, []).
list_named_shadows_for_thing(Client, ThingName, Options)
when is_map(Client), is_list(Options) ->
Path = ["/api/things/shadow/ListNamedShadowsForThing/", http_uri:encode(ThingName), ""],
SuccessStatusCode = undefined,
Headers = [],
request(Client, get, Path, Headers, undefined, Options, SuccessStatusCode).
%% @doc Publishes state information.
%%
%% For more information, see HTTP
%% Protocol in the AWS IoT Developer Guide.
publish(Client, Topic, Input) ->
publish(Client, Topic, Input, []).
publish(Client, Topic, Input0, Options) ->
Method = post,
Path = ["/topics/", http_uri:encode(Topic), ""],
SuccessStatusCode = undefined,
Headers = [],
Input = Input0,
request(Client, Method, Path, Headers, Input, Options, SuccessStatusCode).
%% @doc Updates the shadow for the specified thing.
%%
%% For more information, see UpdateThingShadow
%% in the AWS IoT Developer Guide.
update_thing_shadow(Client, ThingName, Input) ->
update_thing_shadow(Client, ThingName, Input, []).
update_thing_shadow(Client, ThingName, Input0, Options) ->
Method = post,
Path = ["/things/", http_uri:encode(ThingName), "/shadow"],
SuccessStatusCode = undefined,
Headers = [],
Input = Input0,
request(Client, Method, Path, Headers, Input, Options, SuccessStatusCode).
%%====================================================================
%% Internal functions
%%====================================================================
-spec request(aws_client:aws_client(), atom(), iolist(),
list(), map() | undefined, list(), pos_integer() | undefined) ->
{ok, Result, {integer(), list(), hackney:client()}} |
{error, Error, {integer(), list(), hackney:client()}} |
{error, term()} when
Result :: map() | undefined,
Error :: {binary(), binary()}.
request(Client, Method, Path, Headers0, Input, Options, SuccessStatusCode) ->
Client1 = Client#{service => <<"iotdata">>},
Host = get_host(<<"data.iot">>, Client1),
URL = get_url(Host, Path, Client1),
Headers1 = [
{<<"Host">>, Host},
{<<"Content-Type">>, <<"application/x-amz-json-1.1">>}
| Headers0
],
Payload = encode_payload(Input),
MethodBin = aws_request:method_to_binary(Method),
SignedHeaders = aws_request:sign_request(Client1, MethodBin, URL, Headers1, Payload),
Response = hackney:request(Method, URL, SignedHeaders, Payload, Options),
handle_response(Response, SuccessStatusCode).
handle_response({ok, StatusCode, ResponseHeaders, Client}, SuccessStatusCode)
when StatusCode =:= 200;
StatusCode =:= 202;
StatusCode =:= 204;
StatusCode =:= SuccessStatusCode ->
case hackney:body(Client) of
{ok, <<>>} when StatusCode =:= 200;
StatusCode =:= SuccessStatusCode ->
{ok, undefined, {StatusCode, ResponseHeaders, Client}};
{ok, Body} ->
Result = jsx:decode(Body, [return_maps]),
{ok, Result, {StatusCode, ResponseHeaders, Client}}
end;
handle_response({ok, StatusCode, ResponseHeaders, Client}, _) ->
{ok, Body} = hackney:body(Client),
Error = jsx:decode(Body, [return_maps]),
Reason1 = maps:get(<<"message">>, Error, undefined),
Reason2 = maps:get(<<"Message">>, Error, Reason1),
{error, Reason2, {StatusCode, ResponseHeaders, Client}};
handle_response({error, Reason}, _) ->
{error, Reason}.
get_host(_EndpointPrefix, #{region := <<"local">>}) ->
<<"localhost">>;
get_host(EndpointPrefix, #{region := Region, endpoint := Endpoint}) ->
aws_util:binary_join([EndpointPrefix, <<".">>, Region, <<".">>, Endpoint], <<"">>).
get_url(Host, Path0, Client) ->
Proto = maps:get(proto, Client),
Path = erlang:iolist_to_binary(Path0),
Port = maps:get(port, Client),
aws_util:binary_join([Proto, <<"://">>, Host, <<":">>, Port, Path], <<"">>).
-spec encode_payload(undefined | map()) -> binary().
encode_payload(undefined) ->
<<>>;
encode_payload(Input) ->
jsx:encode(Input).