Class ApiProvider

API providers.

An API provider is a function that accepts a type, service, and version and returns an array of API data on success or NULL if no API data can be created for the provided arguments.

You can wrap your calls to an API provider with the ApiProvider::resolve method to ensure that API data is created. If the API data is not created, then the resolve() method will throw a Aws\Exception\UnresolvedApiException. use Aws\Api\ApiProvider; $provider = ApiProvider::defaultProvider(); // Returns an array or NULL. $data = $provider('api', 's3', '2006-03-01'); // Returns an array or throws. $data = ApiProvider::resolve($provider, 'api', 'elasticfood', '2020-01-01');

You can compose multiple providers into a single provider using Aws\or_chain(). This method accepts providers as arguments and returns a new function that will invoke each provider until a non-null value is returned. $a = ApiProvider::filesystem(sys_get_temp_dir() . '/aws-beta-models'); $b = ApiProvider::manifest(); $c = \Aws\or_chain($a, $b); $data = $c('api', 'betaservice', '2015-08-08'); // $a handles this. $data = $c('api', 's3', '2006-03-01'); // $b handles this. $data = $c('api', 'invalid', '2014-12-15'); // Neither handles this.