NAME

aws-api-builder

SYNOPSIS

aws-api-autobuilder [options] command

aws-api-autobuilder --download build sts

DESCRIPTION

HTTP client for building or retrieving Amazon::API clients.

Amazon::API is a Perl module that is used as a base class to build other classes that call Amazon's various APIs. It uses the Botocore data to construct dynamic interfaces to those APIs. The Amazon::API project itself can construct individual classes like Amazon::API::CloudWatchLogs or Amazon::API::SQS that allow you to invoke the functionality of those services using the same interface as Paws or Python's Boto library.

Unlike Paws and Boto, individual API classes are not bundled with Amazon::API. Instead, you are expected to build just the services you need by cloning the project and following the instructions of creating the class you need.

make cpan-dist SERVICE=sts

In order to make it easier and to promote wider adoption of Amazon::API a service has been built that will allow you to request and download any Amazon API. This script implements an HTTP client that allows you to interact with that service.

Commands

build
```
  aws-api-autobuilder build service-name
```
Sends a build command to the factory service. Returns a JSON response with the distribution name and download URL. If the distribution already exists on the DarkPAN server the cache element of the returned payload will be true. If the distribution has never been built, the factory will build the distribution. Builds can take as long as 60 seconds depending on the API. Set --no-cache to force the server to rebuild a distribution.

To automatically download the tarball, use the --download option.
```
  aws-api-autobuilder --download build sts
```
Building an API class also injects that API into the DarkPAN if it is not already installed.
list-distributions

Lists the immediately available services and their versions. Only the latest version is available for downloading.
services

Returns a JSON payload with two keys that lists all of the services available.
- service_names
  
  Alphabetically sorted list of service names that can be built.
- services
  
  Hash where the keys are the service names and the value is the API date.

Options

help|h

This help page...
endpoint-url|u

You normally do not want to change this!

default: https://sandbox.treasurersbriefcase.com/aws-api-autobuilder
cache|c

Forces a new build of the API on the factory server.

default: 1
download|d

This option is used with the build command to build and download an API class.

AUTHOR