Skip to content

Updating to AWS published specs #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
michaelelrom merged 2 commits into from
Aug 12, 2026
Merged

Updating to AWS published specs #62

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5950e8a
fix(aws-ec2): convert OpenAPI specs from AWS's official service model
mikeelrom Aug 12, 2026
7eafaa5
Updating to AWS published specs
mikeelrom Aug 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24,399 changes: 7,930 additions & 16,469 deletions AWS/API Gateway/OpenAPIs/amazon_api_gateway-2015-07-09.json
View file
Open in desktop

Large diffs are not rendered by default.

18,713 changes: 6,723 additions & 11,990 deletions AWS/API Gateway/OpenAPIs/amazon_api_gateway-latest.json
View file
Open in desktop

Large diffs are not rendered by default.

4 changes: 3 additions & 1 deletion AWS/API Gateway/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ Sign requests with an AWS access key ID and secret access key belonging to an IA
| [`amazon_api_gateway-latest.json`](./OpenAPIs/amazon_api_gateway-latest.json) | latest (curated) | 104 | Trimmed to 104 of 120 upstream operations covering common CRUD for automation — see breakdown below |
| [`amazon_api_gateway-2015-07-09.json`](./OpenAPIs/amazon_api_gateway-2015-07-09.json) | 2015-07-09 | 120 | Full spec for the Amazon API Gateway `2015-07-09` management API (120 operations). |

Both specs are converted in-house from **AWS's own official Amazon API Gateway service model** (`apigateway-2015-07-09.normal.json`, published by AWS at [`github.com/aws/aws-sdk-js`](https://github.com/aws/aws-sdk-js/blob/master/apis/apigateway-2015-07-09.normal.json) — the same machine-readable definition AWS uses to generate its own SDKs), not from a third-party OpenAPI conversion. AWS does not publish a ready-made OpenAPI/Swagger document for this service directly.

### `amazon_api_gateway-latest.json`

Actively-maintained spec (`x-vendor-api-version: 2015-07-09`). Trimmed to 104 of 120 upstream operations covering common CRUD for automation.
Expand All @@ -61,4 +63,4 @@ Excluded as niche developer-tooling/reporting add-ons not core to REST API lifec

### `amazon_api_gateway-2015-07-09.json`

Full, unmodified vendor spec for the Amazon API Gateway `2015-07-09` management API (120 operations) — the vendor's complete API surface, preserved as-is. See `amazon_api_gateway-latest.json` above for the curated subset if you just need common CRUD automation.
Full spec, converted in-house from AWS's official service model, for the Amazon API Gateway `2015-07-09` management API (120 operations) — the entire upstream API surface as AWS defines it. See `amazon_api_gateway-latest.json` above for the curated subset if you just need common CRUD automation.
29,490 changes: 11,959 additions & 17,531 deletions AWS/CloudFormation/OpenAPIs/aws_cloudformation-2010-05-15.json
View file
Open in desktop

Large diffs are not rendered by default.

15,799 changes: 5,320 additions & 10,479 deletions AWS/CloudFormation/OpenAPIs/aws_cloudformation-latest.json
View file
Open in desktop

Large diffs are not rendered by default.

10 changes: 6 additions & 4 deletions AWS/CloudFormation/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,12 +41,14 @@ Generate an access key ID and secret access key in the AWS Console under **IAM >

| Spec | Version | Operations | Description |
|---|---|---|---|
| [`aws_cloudformation-latest.json`](./OpenAPIs/aws_cloudformation-latest.json) | latest (curated) | 74 | Trimmed to 74 of 132 upstream operations — see breakdown below |
| [`aws_cloudformation-2010-05-15.json`](./OpenAPIs/aws_cloudformation-2010-05-15.json) | 2010-05-15 | 132 | Full spec for the CloudFormation 2010-05-15 API (132 operations). |
| [`aws_cloudformation-latest.json`](./OpenAPIs/aws_cloudformation-latest.json) | latest (curated) | 74 | Trimmed to 74 of 164 upstream operations — see breakdown below |
| [`aws_cloudformation-2010-05-15.json`](./OpenAPIs/aws_cloudformation-2010-05-15.json) | 2010-05-15 | 164 | Full spec for the CloudFormation 2010-05-15 API (164 operations). |

Both specs are converted in-house from **AWS's own official AWS CloudFormation service model** (`cloudformation-2010-05-15.normal.json`, published by AWS at [`github.com/aws/aws-sdk-js`](https://github.com/aws/aws-sdk-js/blob/master/apis/cloudformation-2010-05-15.normal.json) — the same machine-readable definition AWS uses to generate its own SDKs), not from a third-party OpenAPI conversion. AWS does not publish a ready-made OpenAPI/Swagger document for this service directly.

### `aws_cloudformation-latest.json`

Actively-maintained spec (`x-vendor-api-version: 2010-05-15`). Trimmed to 74 of 132 upstream operations covering common CRUD for automation.
Actively-maintained spec (`x-vendor-api-version: 2010-05-15`). Trimmed to 74 of 164 upstream operations covering common CRUD for automation.

Resources included, by category:

Expand All @@ -58,4 +60,4 @@ Not included: type/extension registry management (`RegisterType`, `PublishType`,

### `aws_cloudformation-2010-05-15.json`

Full, unmodified vendor spec for the CloudFormation 2010-05-15 API (132 operations) — the vendor's complete API surface, preserved as-is. See `aws_cloudformation-latest.json` above for the curated subset if you just need common CRUD automation.
Full spec, converted in-house from AWS's official service model, for the CloudFormation 2010-05-15 API (164 operations) — the entire upstream API surface as AWS defines it. See `aws_cloudformation-latest.json` above for the curated subset if you just need common CRUD automation.
Loading
Loading