Skip to content

Commit

Permalink
Merge pull request #1377 from jeskew/docs/generate-service-list-to-se…
Browse files Browse the repository at this point in the history
…parate-file

Generate the list of services supported by the SDK to a separate file.
  • Loading branch information
jeskew committed Mar 1, 2017
2 parents 975b315 + d8f1b60 commit 6db3ffa
Show file tree
Hide file tree
Showing 5 changed files with 161 additions and 90 deletions.
90 changes: 1 addition & 89 deletions README.md
Expand Up @@ -130,95 +130,7 @@ keeping the list of open issues lean we can respond in a timely manner.

## Supported Services

<p class="note"><strong>Note</strong>:
Although all services are supported in the browser version of the SDK,
not all of the services are available in the default hosted build (using the
script tag provided above). Instructions on how to build a
custom version of the SDK with individual services are provided
in the "<a href="http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html">Building the SDK for Browsers</a>" section of the SDK Developer Guide.
</p>

The SDK currently supports the following services:

<table>
<thead>
<th>Service Name</th>
<th>Class Name</th>
<th>API Version</th>
</thead>
<tbody>
<tr><td>Amazon API Gateway</td><td>AWS.APIGateway</td><td>2015-07-09</td></tr>
<tr><td>Amazon CloudFront</td><td>AWS.CloudFront</td><td>2014-10-21</td></tr>
<tr><td>Amazon CloudHSM</td><td>AWS.CloudHSM</td><td>2014-05-30</td></tr>
<tr><td>Amazon CloudSearch</td><td>AWS.CloudSearch</td><td>2013-01-01</td></tr>
<tr><td>Amazon CloudSearch Domain</td><td>AWS.CloudSearchDomain</td><td>2013-01-01</td></tr>
<tr><td>Amazon CloudWatch</td><td>AWS.CloudWatch</td><td>2010-08-01</td></tr>
<tr><td>Amazon CloudWatch Events</td><td>AWS.CloudWatchLogs</td><td>2015-10-07</td></tr>
<tr><td>Amazon CloudWatch Logs</td><td>AWS.CloudWatchLogs</td><td>2014-03-28</td></tr>
<tr><td>Amazon Cognito Identity</td><td>AWS.CognitoIdentity</td><td>2014-06-30</td></tr>
<tr><td>Amazon Cognito Sync</td><td>AWS.CognitoSync</td><td>2014-06-30</td></tr>
<tr><td>Amazon DynamoDB</td><td>AWS.DynamoDB</td><td>2012-08-10</td></tr>
<tr><td>Amazon DynamoDB Streams</td><td>AWS.DynamoDBStreams</td><td>2012-08-10</td></tr>
<tr><td>Amazon EC2 Container Registry</td><td>AWS.ECR</td><td>2015-09-21</td></tr>
<tr><td>Amazon EC2 Container Service</td><td>AWS.ECS</td><td>2014-11-13</td></tr>
<tr><td>Amazon Elastic Compute Cloud</td><td>AWS.EC2</td><td>2014-10-01</td></tr>
<tr><td>Amazon Elastic File System</td><td>AWS.EFS</td><td>2015-02-01</td></tr>
<tr><td>Amazon Elastic MapReduce</td><td>AWS.EMR</td><td>2009-03-31</td></tr>
<tr><td>Amazon Elastic Transcoder</td><td>AWS.ElasticTranscoder</td><td>2012-09-25</td></tr>
<tr><td>Amazon ElastiCache</td><td>AWS.ElastiCache</td><td>2014-09-30</td></tr>
<tr><td>Amazon Elasticsearch Service</td><td>AWS.ES</td><td>2015-01-01</td></tr>
<tr><td>Amazon GameLift</td><td>AWS.GameLift</td><td>2015-10-01</td></tr>
<tr><td>Amazon Glacier</td><td>AWS.Glacier</td><td>2012-06-01</td></tr>
<tr><td>Amazon Inspector</td><td>AWS.Inspector</td><td>2016-02-16</td></tr>
<tr><td>Amazon Kinesis</td><td>AWS.Kinesis</td><td>2013-12-02</td></tr>
<tr><td>Amazon Kinesis Analytics</td><td>AWS.KinesisAnalytics</td><td>2015-08-14</td></tr>
<tr><td>Amazon Kinesis Firehose</td><td>AWS.Firehose</td><td>2015-08-04</td></tr>
<tr><td>Amazon Machine Learning</td><td>AWS.MachineLearning</td><td>2014-12-12</td></tr>
<tr><td>Amazon Mobile Analytics</td><td>AWS.MobileAnalytics</td><td>2014-06-05</td></tr>
<tr><td>Amazon Redshift</td><td>AWS.Redshift</td><td>2012-12-01</td></tr>
<tr><td>Amazon Relational Database Service</td><td>AWS.RDS</td><td>2014-09-01</td></tr>
<tr><td>Amazon Route 53</td><td>AWS.Route53</td><td>2013-04-01</td></tr>
<tr><td>Amazon Route 53 Domains</td><td>AWS.Route53Domains</td><td>2014-05-15</td></tr>
<tr><td>Amazon Simple Email Service</td><td>AWS.SES</td><td>2010-12-01</td></tr>
<tr><td>Amazon Simple Notification Service</td><td>AWS.SNS</td><td>2010-03-31</td></tr>
<tr><td>Amazon Simple Queue Service</td><td>AWS.SQS</td><td>2012-11-05</td></tr>
<tr><td>Amazon Simple Storage Service</td><td>AWS.S3</td><td>2006-03-01</td></tr>
<tr><td>Amazon Simple Systems Management Service</td><td>AWS.SSM</td><td>2014-11-06</td></tr>
<tr><td>Amazon Simple Workflow Service</td><td>AWS.SWF</td><td>2012-01-25</td></tr>
<tr><td>Amazon SimpleDB</td><td>AWS.SimpleDB</td><td>2009-04-15</td></tr>
<tr><td>Amazon Snowball</td><td>AWS.Snowball</td><td>2016-06-30</td></tr>
<tr><td>Amazon WorkSpaces</td><td>AWS.WorkSpaces</td><td>2015-04-08</td></tr>
<tr><td>Auto Scaling</td><td>AWS.AutoScaling</td><td>2011-01-01</td></tr>
<tr><td>AWS Certificate Manager</td><td>AWS.ACM</td><td>2015-12-08</td></tr>
<tr><td>AWS CloudFormation</td><td>AWS.CloudFormation</td><td>2010-05-15</td></tr>
<tr><td>AWS CloudTrail</td><td>AWS.CloudTrail</td><td>2013-11-01</td></tr>
<tr><td>AWS CodeCommit</td><td>AWS.CodeCommit</td><td>2015-04-13</td></tr>
<tr><td>AWS CodeDeploy</td><td>AWS.CodeDeploy</td><td>2014-10-06</td></tr>
<tr><td>AWS CodePipeline</td><td>AWS.CodePipeline</td><td>2015-07-09</td></tr>
<tr><td>AWS Config</td><td>AWS.ConfigService</td><td>2014-11-12</td></tr>
<tr><td>AWS Data Pipeline</td><td>AWS.DataPipeline</td><td>2012-10-29</td></tr>
<tr><td>AWS Database Migration Service</td><td>AWS.DMS</td><td>2016-01-01</td></tr>
<tr><td>AWS Device Farm</td><td>AWS.DeviceFarm</td><td>2015-06-23</td></tr>
<tr><td>AWS Direct Connect</td><td>AWS.DirectConnect</td><td>2012-10-25</td></tr>
<tr><td>AWS Directory Service</td><td>AWS.DirectoryService</td><td>2015-04-16</td></tr>
<tr><td>AWS Elastic Beanstalk</td><td>AWS.ElasticBeanstalk</td><td>2010-12-01</td></tr>
<tr><td>AWS Identity and Access Management</td><td>AWS.IAM</td><td>2010-05-08</td></tr>
<tr><td>AWS Import/Export</td><td>AWS.ImportExport</td><td>2010-06-01</td></tr>
<tr><td>AWS IoT</td><td>AWS.Iot</td><td>2015-05-28</td></tr>
<tr><td>AWS IoT Data Plane</td><td>AWS.IotData</td><td>2015-05-28</td></tr>
<tr><td>AWS Key Management Service</td><td>AWS.KMS</td><td>2014-11-01</td></tr>
<tr><td>AWS Lambda</td><td>AWS.Lambda</td><td>2015-03-31</td></tr>
<tr><td>AWS Marketplace Commerce Analytics</td><td>AWS.MarketplaceCommerceAnalytics</td><td>2015-07-01</td></tr>
<tr><td>AWS Marketplace Metering</td><td>AWS.MarketplaceMetering</td><td>2016-01-14</td></tr>
<tr><td>AWS OpsWorks</td><td>AWS.OpsWorks</td><td>2013-02-18</td></tr>
<tr><td>AWS Security Token Service</td><td>AWS.STS</td><td>2011-06-15</td></tr>
<tr><td>AWS Storage Gateway</td><td>AWS.StorageGateway</td><td>2013-06-30</td></tr>
<tr><td>AWS Support</td><td>AWS.Support</td><td>2013-04-15</td></tr>
<tr><td>AWS WAF</td><td>AWS.WAF</td><td>2015-08-24</td></tr>
<tr><td>Elastic Load Balancing</td><td>AWS.ELB</td><td>2012-06-01</td></tr>
<tr><td>Elastic Load Balancing v2</td><td>AWS.ELBv2</td><td>2015-12-01</td></tr>
</tbody>
</table>
Please see [SERVICES.md](./SERVICES.md) for a list of supported services.

## License

Expand Down
112 changes: 112 additions & 0 deletions SERVICES.md
@@ -0,0 +1,112 @@
The SDK currently supports the following services:

<p class="note"><strong>Note</strong>:
Although all services are supported in the browser version of the SDK,
not all of the services are available in the default hosted build (using the
script tag provided above). Instructions on how to build a
custom version of the SDK with individual services are provided
in the "<a href="http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html">Building the SDK for Browsers</a>" section of the SDK Developer Guide.
</p>

Service Name | Class Name | API Version | Allows CORS |
------------ | ---------- | ----------- | ----------- |
AWS Certificate Manager | AWS.ACM | 2015-12-08 | :tada: |
Amazon API Gateway | AWS.APIGateway | 2015-07-09 | :tada: |
Application Auto Scaling | AWS.ApplicationAutoScaling | 2016-02-06 | :tada: |
Amazon AppStream | AWS.AppStream | 2016-12-01 | |
Auto Scaling | AWS.AutoScaling | 2011-01-01 | :tada: |
AWS Batch | AWS.Batch | 2016-08-10 | |
AWS Budgets | AWS.Budgets | 2016-10-20 | |
Amazon CloudDirectory | AWS.CloudDirectory | 2016-05-10 | |
AWS CloudFormation | AWS.CloudFormation | 2010-05-15 | :tada: |
Amazon CloudFront | AWS.CloudFront | 2016-11-25 | :tada: |
Amazon CloudHSM | AWS.CloudHSM | 2014-05-30 | :tada: |
Amazon CloudSearch | AWS.CloudSearch | 2013-01-01 | |
Amazon CloudSearch | AWS.CloudSearch | 2011-02-01 | |
Amazon CloudSearch Domain | AWS.CloudSearchDomain | 2013-01-01 | |
AWS CloudTrail | AWS.CloudTrail | 2013-11-01 | :tada: |
Amazon CloudWatch | AWS.CloudWatch | 2010-08-01 | :tada: |
Amazon CloudWatch Events | AWS.CloudWatchEvents | 2015-10-07 | :tada: |
Amazon CloudWatch Logs | AWS.CloudWatchLogs | 2014-03-28 | :tada: |
AWS CodeBuild | AWS.CodeBuild | 2016-10-06 | |
AWS CodeCommit | AWS.CodeCommit | 2015-04-13 | :tada: |
AWS CodeDeploy | AWS.CodeDeploy | 2014-10-06 | :tada: |
AWS CodePipeline | AWS.CodePipeline | 2015-07-09 | :tada: |
Amazon Cognito Identity | AWS.CognitoIdentity | 2014-06-30 | :tada: |
Amazon Cognito Identity Provider | AWS.CognitoIdentityServiceProvider | 2016-04-18 | :tada: |
Amazon Cognito Sync | AWS.CognitoSync | 2014-06-30 | :tada: |
AWS Config | AWS.ConfigService | 2014-11-12 | :tada: |
AWS Cost and Usage Report Service | AWS.CUR | 2017-01-06 | :tada: |
AWS Data Pipeline | AWS.DataPipeline | 2012-10-29 | |
AWS Device Farm | AWS.DeviceFarm | 2015-06-23 | :tada: |
AWS Direct Connect | AWS.DirectConnect | 2012-10-25 | :tada: |
AWS Directory Service | AWS.DirectoryService | 2015-04-16 | |
AWS Application Discovery Service | AWS.Discovery | 2015-11-01 | |
AWS Database Migration Service | AWS.DMS | 2016-01-01 | |
Amazon DynamoDB | AWS.DynamoDB | 2012-08-10 | :tada: |
Amazon DynamoDB | AWS.DynamoDB | 2011-12-05 | :tada: |
Amazon DynamoDB Streams | AWS.DynamoDBStreams | 2012-08-10 | :tada: |
Amazon Elastic Compute Cloud | AWS.EC2 | 2016-11-15 | :tada: |
Amazon EC2 Container Registry | AWS.ECR | 2015-09-21 | :tada: |
Amazon EC2 Container Service | AWS.ECS | 2014-11-13 | :tada: |
Amazon Elastic File System | AWS.EFS | 2015-02-01 | |
Amazon ElastiCache | AWS.ElastiCache | 2015-02-02 | :tada: |
AWS Elastic Beanstalk | AWS.ElasticBeanstalk | 2010-12-01 | :tada: |
Elastic Load Balancing | AWS.ELB | 2012-06-01 | :tada: |
Elastic Load Balancing | AWS.ELBv2 | 2015-12-01 | :tada: |
Amazon Elastic MapReduce | AWS.EMR | 2009-03-31 | :tada: |
Amazon Elasticsearch Service | AWS.ES | 2015-01-01 | |
Amazon Elastic Transcoder | AWS.ElasticTranscoder | 2012-09-25 | :tada: |
Amazon Kinesis Firehose | AWS.Firehose | 2015-08-04 | :tada: |
Amazon GameLift | AWS.GameLift | 2015-10-01 | :tada: |
Amazon Glacier | AWS.Glacier | 2012-06-01 | |
AWS Health APIs and Notifications | AWS.Health | 2016-08-04 | |
AWS Identity and Access Management | AWS.IAM | 2010-05-08 | |
AWS Import/Export | AWS.ImportExport | 2010-06-01 | |
Amazon Inspector | AWS.Inspector | 2016-02-16 | :tada: |
AWS IoT | AWS.Iot | 2015-05-28 | :tada: |
AWS IoT Data Plane | AWS.IotData | 2015-05-28 | :tada: |
Amazon Kinesis | AWS.Kinesis | 2013-12-02 | :tada: |
Amazon Kinesis Analytics | AWS.KinesisAnalytics | 2015-08-14 | |
AWS Key Management Service | AWS.KMS | 2014-11-01 | :tada: |
AWS Lambda | AWS.Lambda | 2015-03-31 | :tada: |
AWS Lambda | AWS.Lambda | 2014-11-11 | :tada: |
Amazon Lex Runtime Service | AWS.LexRuntime | 2016-11-28 | :tada: |
Amazon Lightsail | AWS.Lightsail | 2016-11-28 | |
Amazon Machine Learning | AWS.MachineLearning | 2014-12-12 | :tada: |
AWS Marketplace Commerce Analytics | AWS.MarketplaceCommerceAnalytics | 2015-07-01 | :tada: |
AWSMarketplace Metering | AWS.MarketplaceMetering | 2016-01-14 | |
Amazon Mechanical Turk | AWS.MTurk | 2017-01-17 | :tada: |
Amazon Mobile Analytics | AWS.MobileAnalytics | 2014-06-05 | :tada: |
AWS OpsWorks | AWS.OpsWorks | 2013-02-18 | :tada: |
AWS OpsWorks for Chef Automate | AWS.OpsWorksCM | 2016-11-01 | |
AWS Organizations | AWS.Organizations | 2016-11-28 | |
Amazon Pinpoint | AWS.Pinpoint | 2016-12-01 | |
Amazon Polly | AWS.Polly | 2016-06-10 | :tada: |
Amazon Relational Database Service | AWS.RDS | 2014-10-31 | :tada: |
Amazon Relational Database Service | AWS.RDS | 2013-09-09 | :tada: |
Amazon Relational Database Service | AWS.RDS | 2013-02-12 | :tada: |
Amazon Relational Database Service | AWS.RDS | 2013-01-10 | :tada: |
Amazon Redshift | AWS.Redshift | 2012-12-01 | :tada: |
Amazon Rekognition | AWS.Rekognition | 2016-06-27 | :tada: |
Amazon Route 53 | AWS.Route53 | 2013-04-01 | :tada: |
Amazon Route 53 Domains | AWS.Route53Domains | 2014-05-15 | :tada: |
Amazon Simple Storage Service | AWS.S3 | 2006-03-01 | :tada: |
AWS Service Catalog | AWS.ServiceCatalog | 2015-12-10 | :tada: |
Amazon Simple Email Service | AWS.SES | 2010-12-01 | :tada: |
AWS Shield | AWS.Shield | 2016-06-02 | |
Amazon SimpleDB | AWS.SimpleDB | 2009-04-15 | |
AWS Server Migration Service | AWS.SMS | 2016-10-24 | |
Amazon Import/Export Snowball | AWS.Snowball | 2016-06-30 | |
Amazon Simple Notification Service | AWS.SNS | 2010-03-31 | :tada: |
Amazon Simple Queue Service | AWS.SQS | 2012-11-05 | :tada: |
Amazon Simple Systems Manager (SSM) | AWS.SSM | 2014-11-06 | :tada: |
AWS Storage Gateway | AWS.StorageGateway | 2013-06-30 | :tada: |
AWS Step Functions | AWS.StepFunctions | 2016-11-23 | |
AWS Security Token Service | AWS.STS | 2011-06-15 | :tada: |
AWS Support | AWS.Support | 2013-04-15 | |
Amazon Simple Workflow Service | AWS.SWF | 2012-01-25 | |
AWS X-Ray | AWS.XRay | 2016-04-12 | |
AWS WAF | AWS.WAF | 2015-08-24 | :tada: |
AWS WAF Regional | AWS.WAFRegional | 2016-11-28 | |
Amazon WorkSpaces | AWS.WorkSpaces | 2015-04-08 | |
6 changes: 5 additions & 1 deletion lib/api_loader.js
Expand Up @@ -7,6 +7,10 @@ AWS.apiLoader = function(svc, version) {
return AWS.apiLoader.services[svc][version];
};

/**
* This member of AWS.apiLoader is private, but changing it will necessitate a
* change to ../scripts/services-table-generator.ts
*/
AWS.apiLoader.services = {};

module.exports = AWS.apiLoader;
module.exports = AWS.apiLoader;
14 changes: 14 additions & 0 deletions scripts/services-table-generator.js
@@ -0,0 +1,14 @@
"use strict";
var fs_1 = require("fs");
var path_1 = require("path");
var clients = require('../clients/all');
var metadata = require('../apis/metadata');
var api_loader = require('../lib/api_loader');
fs_1.writeFileSync(path_1.resolve(__dirname, '..', 'SERVICES.md'), Object.keys(clients).reduce(function (serviceTable, clientId) {
var cid = clientId.toLowerCase();
return serviceTable + Object.keys(api_loader.services[cid]).reverse()
.map(function (version) {
var model = api_loader(cid, version);
return model.metadata.serviceFullName + " | AWS." + clientId + " | " + version + " | " + (metadata[cid].cors === true ? ':tada:' : '') + " |";
}).join("\n") + "\n";
}, "The SDK currently supports the following services:\n\n<p class=\"note\"><strong>Note</strong>:\nAlthough all services are supported in the browser version of the SDK,\nnot all of the services are available in the default hosted build (using the\nscript tag provided above). Instructions on how to build a\ncustom version of the SDK with individual services are provided\nin the \"<a href=\"http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html\">Building the SDK for Browsers</a>\" section of the SDK Developer Guide.\n</p>\n\nService Name | Class Name | API Version | Allows CORS |\n------------ | ---------- | ----------- | ----------- |\n"));
29 changes: 29 additions & 0 deletions scripts/services-table-generator.ts
@@ -0,0 +1,29 @@
import {writeFileSync} from 'fs';
import {resolve} from 'path';

const clients = require('../clients/all');
const metadata = require('../apis/metadata');
const api_loader = require('../lib/api_loader');

writeFileSync(
resolve(__dirname, '..', 'SERVICES.md'),
Object.keys(clients).reduce((serviceTable, clientId): string => {
const cid = clientId.toLowerCase();
return serviceTable + Object.keys(api_loader.services[cid]).reverse()
.map((version: string): string => {
const model = api_loader(cid, version);
return `${model.metadata.serviceFullName} | AWS.${clientId} | ${version} | ${metadata[cid].cors === true ? ':tada:' : ''} |`;
}).join("\n") + "\n";
}, `The SDK currently supports the following services:
<p class="note"><strong>Note</strong>:
Although all services are supported in the browser version of the SDK,
not all of the services are available in the default hosted build (using the
script tag provided above). Instructions on how to build a
custom version of the SDK with individual services are provided
in the "<a href="http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html">Building the SDK for Browsers</a>" section of the SDK Developer Guide.
</p>
Service Name | Class Name | API Version | Allows CORS |
------------ | ---------- | ----------- | ----------- |
`));

0 comments on commit 6db3ffa

Please sign in to comment.