aws_erlang

%% WARNING: DO NOT EDIT, AUTO-GENERATED CODE!
%% See https://github.com/aws-beam/aws-codegen for more details.

%% @doc The AWS Migration Hub home region APIs are available specifically for
%% working with your
%% Migration Hub home region.
%%
%% You can use these APIs to determine a home region, as well as to
%% create and work with controls that describe the home region.
%%
%% You must make API calls for write actions (create, notify, associate,
%% disassociate,
%% import, or put) while in your home region, or a
%% `HomeRegionNotSetException'
%% error is returned.
%%
%% API calls for read actions (list, describe, stop, and delete) are
%% permitted outside of
%% your home region.
%%
%% If you call a write API outside the home region, an
%% `InvalidInputException'
%% is returned.
%%
%% You can call `GetHomeRegion' action to obtain the account's
%% Migration Hub
%% home region.
%%
%% For specific API usage, see the sections that follow in this AWS Migration
%% Hub Home Region
%% API reference.
-module(aws_migrationhub_config).

-export([create_home_region_control/2,
         create_home_region_control/3,
         delete_home_region_control/2,
         delete_home_region_control/3,
         describe_home_region_controls/2,
         describe_home_region_controls/3,
         get_home_region/2,
         get_home_region/3]).

-include_lib("hackney/include/hackney_lib.hrl").


%% Example:
%% access_denied_exception() :: #{
%%   <<"Message">> => string()
%% }
-type access_denied_exception() :: #{binary() => any()}.

%% Example:
%% create_home_region_control_request() :: #{
%%   <<"DryRun">> => boolean(),
%%   <<"HomeRegion">> := string(),
%%   <<"Target">> := target()
%% }
-type create_home_region_control_request() :: #{binary() => any()}.

%% Example:
%% create_home_region_control_result() :: #{
%%   <<"HomeRegionControl">> => home_region_control()
%% }
-type create_home_region_control_result() :: #{binary() => any()}.

%% Example:
%% delete_home_region_control_request() :: #{
%%   <<"ControlId">> := string()
%% }
-type delete_home_region_control_request() :: #{binary() => any()}.

%% Example:
%% delete_home_region_control_result() :: #{

%% }
-type delete_home_region_control_result() :: #{binary() => any()}.

%% Example:
%% describe_home_region_controls_request() :: #{
%%   <<"ControlId">> => string(),
%%   <<"HomeRegion">> => string(),
%%   <<"MaxResults">> => integer(),
%%   <<"NextToken">> => string(),
%%   <<"Target">> => target()
%% }
-type describe_home_region_controls_request() :: #{binary() => any()}.

%% Example:
%% describe_home_region_controls_result() :: #{
%%   <<"HomeRegionControls">> => list(home_region_control()()),
%%   <<"NextToken">> => string()
%% }
-type describe_home_region_controls_result() :: #{binary() => any()}.

%% Example:
%% dry_run_operation() :: #{
%%   <<"Message">> => string()
%% }
-type dry_run_operation() :: #{binary() => any()}.

%% Example:
%% get_home_region_request() :: #{

%% }
-type get_home_region_request() :: #{binary() => any()}.

%% Example:
%% get_home_region_result() :: #{
%%   <<"HomeRegion">> => string()
%% }
-type get_home_region_result() :: #{binary() => any()}.

%% Example:
%% home_region_control() :: #{
%%   <<"ControlId">> => string(),
%%   <<"HomeRegion">> => string(),
%%   <<"RequestedTime">> => non_neg_integer(),
%%   <<"Target">> => target()
%% }
-type home_region_control() :: #{binary() => any()}.

%% Example:
%% internal_server_error() :: #{
%%   <<"Message">> => string()
%% }
-type internal_server_error() :: #{binary() => any()}.

%% Example:
%% invalid_input_exception() :: #{
%%   <<"Message">> => string()
%% }
-type invalid_input_exception() :: #{binary() => any()}.

%% Example:
%% service_unavailable_exception() :: #{
%%   <<"Message">> => string()
%% }
-type service_unavailable_exception() :: #{binary() => any()}.

%% Example:
%% target() :: #{
%%   <<"Id">> => string(),
%%   <<"Type">> => list(any())
%% }
-type target() :: #{binary() => any()}.

%% Example:
%% throttling_exception() :: #{
%%   <<"Message">> => string(),
%%   <<"RetryAfterSeconds">> => integer()
%% }
-type throttling_exception() :: #{binary() => any()}.

-type create_home_region_control_errors() ::
    throttling_exception() | 
    service_unavailable_exception() | 
    invalid_input_exception() | 
    internal_server_error() | 
    dry_run_operation() | 
    access_denied_exception().

-type delete_home_region_control_errors() ::
    throttling_exception() | 
    service_unavailable_exception() | 
    invalid_input_exception() | 
    internal_server_error() | 
    access_denied_exception().

-type describe_home_region_controls_errors() ::
    throttling_exception() | 
    service_unavailable_exception() | 
    invalid_input_exception() | 
    internal_server_error() | 
    access_denied_exception().

-type get_home_region_errors() ::
    throttling_exception() | 
    service_unavailable_exception() | 
    invalid_input_exception() | 
    internal_server_error() | 
    access_denied_exception().

%%====================================================================
%% API
%%====================================================================

%% @doc This API sets up the home region for the calling account only.
-spec create_home_region_control(aws_client:aws_client(), create_home_region_control_request()) ->
    {ok, create_home_region_control_result(), tuple()} |
    {error, any()} |
    {error, create_home_region_control_errors(), tuple()}.
create_home_region_control(Client, Input)
  when is_map(Client), is_map(Input) ->
    create_home_region_control(Client, Input, []).

-spec create_home_region_control(aws_client:aws_client(), create_home_region_control_request(), proplists:proplist()) ->
    {ok, create_home_region_control_result(), tuple()} |
    {error, any()} |
    {error, create_home_region_control_errors(), tuple()}.
create_home_region_control(Client, Input, Options)
  when is_map(Client), is_map(Input), is_list(Options) ->
    request(Client, <<"CreateHomeRegionControl">>, Input, Options).

%% @doc This operation deletes the home region configuration for the calling
%% account.
%%
%% The operation does not delete discovery or migration tracking data in the
%% home region.
-spec delete_home_region_control(aws_client:aws_client(), delete_home_region_control_request()) ->
    {ok, delete_home_region_control_result(), tuple()} |
    {error, any()} |
    {error, delete_home_region_control_errors(), tuple()}.
delete_home_region_control(Client, Input)
  when is_map(Client), is_map(Input) ->
    delete_home_region_control(Client, Input, []).

-spec delete_home_region_control(aws_client:aws_client(), delete_home_region_control_request(), proplists:proplist()) ->
    {ok, delete_home_region_control_result(), tuple()} |
    {error, any()} |
    {error, delete_home_region_control_errors(), tuple()}.
delete_home_region_control(Client, Input, Options)
  when is_map(Client), is_map(Input), is_list(Options) ->
    request(Client, <<"DeleteHomeRegionControl">>, Input, Options).

%% @doc This API permits filtering on the `ControlId' and
%% `HomeRegion'
%% fields.
-spec describe_home_region_controls(aws_client:aws_client(), describe_home_region_controls_request()) ->
    {ok, describe_home_region_controls_result(), tuple()} |
    {error, any()} |
    {error, describe_home_region_controls_errors(), tuple()}.
describe_home_region_controls(Client, Input)
  when is_map(Client), is_map(Input) ->
    describe_home_region_controls(Client, Input, []).

-spec describe_home_region_controls(aws_client:aws_client(), describe_home_region_controls_request(), proplists:proplist()) ->
    {ok, describe_home_region_controls_result(), tuple()} |
    {error, any()} |
    {error, describe_home_region_controls_errors(), tuple()}.
describe_home_region_controls(Client, Input, Options)
  when is_map(Client), is_map(Input), is_list(Options) ->
    request(Client, <<"DescribeHomeRegionControls">>, Input, Options).

%% @doc Returns the calling account’s home region, if configured.
%%
%% This API is used by other AWS
%% services to determine the regional endpoint for calling AWS Application
%% Discovery Service and
%% Migration Hub. You must call `GetHomeRegion' at least once before you
%% call any
%% other AWS Application Discovery Service and AWS Migration Hub APIs, to
%% obtain the account's
%% Migration Hub home region.
-spec get_home_region(aws_client:aws_client(), get_home_region_request()) ->
    {ok, get_home_region_result(), tuple()} |
    {error, any()} |
    {error, get_home_region_errors(), tuple()}.
get_home_region(Client, Input)
  when is_map(Client), is_map(Input) ->
    get_home_region(Client, Input, []).

-spec get_home_region(aws_client:aws_client(), get_home_region_request(), proplists:proplist()) ->
    {ok, get_home_region_result(), tuple()} |
    {error, any()} |
    {error, get_home_region_errors(), tuple()}.
get_home_region(Client, Input, Options)
  when is_map(Client), is_map(Input), is_list(Options) ->
    request(Client, <<"GetHomeRegion">>, Input, Options).

%%====================================================================
%% Internal functions
%%====================================================================

-spec request(aws_client:aws_client(), binary(), map(), list()) ->
    {ok, Result, {integer(), list(), hackney:client()}} |
    {error, Error, {integer(), list(), hackney:client()}} |
    {error, term()} when
    Result :: map() | undefined,
    Error :: map().
request(Client, Action, Input, Options) ->
    RequestFun = fun() -> do_request(Client, Action, Input, Options) end,
    aws_request:request(RequestFun, Options).

do_request(Client, Action, Input0, Options) ->
    Client1 = Client#{service => <<"migrationhub-config">>},
    Host = build_host(<<"migrationhub-config">>, Client1),
    URL = build_url(Host, Client1),
    Headers = [
        {<<"Host">>, Host},
        {<<"Content-Type">>, <<"application/x-amz-json-1.1">>},
        {<<"X-Amz-Target">>, <<"AWSMigrationHubMultiAccountService.", Action/binary>>}
    ],

    Input = Input0,

    Payload = jsx:encode(Input),
    SignedHeaders = aws_request:sign_request(Client1, <<"POST">>, URL, Headers, Payload),
    Response = hackney:request(post, URL, SignedHeaders, Payload, Options),
    handle_response(Response).

handle_response({ok, 200, ResponseHeaders, Client}) ->
    case hackney:body(Client) of
        {ok, <<>>} ->
            {ok, undefined, {200, ResponseHeaders, Client}};
        {ok, Body} ->
            Result = jsx:decode(Body),
            {ok, Result, {200, ResponseHeaders, Client}}
    end;
handle_response({ok, StatusCode, ResponseHeaders, Client}) ->
    {ok, Body} = hackney:body(Client),
    Error = jsx:decode(Body),
    {error, Error, {StatusCode, ResponseHeaders, Client}};
handle_response({error, Reason}) ->
    {error, Reason}.

build_host(_EndpointPrefix, #{region := <<"local">>, endpoint := Endpoint}) ->
    Endpoint;
build_host(_EndpointPrefix, #{region := <<"local">>}) ->
    <<"localhost">>;
build_host(EndpointPrefix, #{region := Region, endpoint := Endpoint}) ->
    aws_util:binary_join([EndpointPrefix, Region, Endpoint], <<".">>).

build_url(Host, Client) ->
    Proto = aws_client:proto(Client),
    Port = aws_client:port(Client),
    aws_util:binary_join([Proto, <<"://">>, Host, <<":">>, Port, <<"/">>], <<"">>).