Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaypipes/aws-api-tools
Toolkit for working with AWS APIs
https://github.com/jaypipes/aws-api-tools
Last synced: about 2 months ago
JSON representation
Toolkit for working with AWS APIs
- Host: GitHub
- URL: https://github.com/jaypipes/aws-api-tools
- Owner: jaypipes
- License: apache-2.0
- Created: 2020-03-26T21:25:32.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-07-08T15:13:42.000Z (over 4 years ago)
- Last Synced: 2024-08-02T01:25:42.430Z (4 months ago)
- Language: Go
- Size: 183 KB
- Stars: 15
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-repositories - jaypipes/aws-api-tools - Toolkit for working with AWS APIs (Go)
README
# `aws-api-tools`
Tools to explore and transform AWS service APIs.
## `aws-api-tool` CLI binary
The `aws-api-tool` CLI binary can be used to list AWS service APIs and explore
aspects of those APIs.
### Installation
The easiest way to install `aws-api-tool` is to use `go get`:
```
$ go get github.com/jaypipes/aws-api-tools/cmd/aws-api-tool
```
which will install the binary into your `$GOPATH/bin` directory.
### List AWS service APIs
Use the `aws-api-tool list-apis` command to list AWS services:
```
$ aws-api-tool list-apis
+------------------------------+-------------+-----------------+------------------------------------+
| ALIAS | API VERSION | PROTOCOL/SCHEME | FULL NAME |
+------------------------------+-------------+-----------------+------------------------------------+
| AWSMigrationHub | 2017-05-31 | json | AWS Migration Hub |
| accessanalyzer | 2019-11-01 | rest-json | Access Analyzer |
| workspaces | 2015-04-08 | json | Amazon WorkSpaces |
| xray | 2016-04-12 | rest-json | AWS X-Ray |
+------------------------------+-------------+-----------------+------------------------------------+
```
You can filter the results using the `--filter` flag, which accepts a
comma-delimited string of strings to match for the service's alias:
```
$ aws-api-tool list-apis --filter ebs,sdb
+-------+-------------+-----------------+----------------------------+
| ALIAS | API VERSION | PROTOCOL/SCHEME | FULL NAME |
+-------+-------------+-----------------+----------------------------+
| ebs | 2019-11-02 | rest-json | Amazon Elastic Block Store |
| sdb | 2009-04-15 | query | Amazon SimpleDB |
+-------+-------------+-----------------+----------------------------+
```
You can filter the results to only APIs that use a particular protocol/scheme
with the `--protocol` flag, which accepts a comma-delimited string of strings
to match on the service's protocol/scheme:
```
$ aws-api-tool list-apis --protocol query
+------------------------+-------------+-----------------+--------------------------------+
| ALIAS | API VERSION | PROTOCOL/SCHEME | FULL NAME |
+------------------------+-------------+-----------------+--------------------------------+
| autoscaling | 2011-01-01 | query | Auto Scaling |
| cloudformation | 2010-05-15 | query | AWS CloudFormation |
| cloudsearch | 2013-01-01 | query | Amazon CloudSearch |
| docdb | 2014-10-31 | query | Amazon DocumentDB with MongoDB |
| | | | compatibility |
| elasticache | 2015-02-02 | query | Amazon ElastiCache |
| elasticbeanstalk | 2010-12-01 | query | AWS Elastic Beanstalk |
| elasticloadbalancing | 2012-06-01 | query | Elastic Load Balancing |
| elasticloadbalancingv2 | 2015-12-01 | query | Elastic Load Balancing |
| email | 2010-12-01 | query | Amazon Simple Email Service |
| iam | 2010-05-08 | query | AWS Identity and Access |
| | | | Management |
| importexport | 2010-06-01 | query | AWS Import/Export |
| monitoring | 2010-08-01 | query | Amazon CloudWatch |
| neptune | 2014-10-31 | query | Amazon Neptune |
| rds | 2014-10-31 | query | Amazon Relational Database |
| | | | Service |
| redshift | 2012-12-01 | query | Amazon Redshift |
| sdb | 2009-04-15 | query | Amazon SimpleDB |
| sns | 2010-03-31 | query | Amazon Simple Notification |
| | | | Service |
| sqs | 2012-11-05 | query | Amazon Simple Queue Service |
| sts | 2011-06-15 | query | AWS Security Token Service |
+------------------------+-------------+-----------------+--------------------------------+
```
### Get summary information about an API
To get summary information about a particular AWS service API, use the
`aws-api-tool info ` command.
```
$ aws-api-tool info ec2
Full name: Amazon Elastic Compute Cloud
API version: 2016-11-15
Protocol: ec2
Total operations: 400
Total resources: 52
Total objects: 1991
Total scalars: 383
Total payloads: 738
Total exceptions: 0
Total lists: 405
```
### List API operations
To list operations for an AWS service API, use the `aws-api-tool
list-operations ` command:
```
$ aws-api-tool list-operations sns
+------------------------------------+-------------+
| NAME | HTTP METHOD |
+------------------------------------+-------------+
| AddPermission | POST |
| CheckIfPhoneNumberIsOptedOut | POST |
| ConfirmSubscription | POST |
| CreatePlatformApplication | POST |
| CreatePlatformEndpoint | POST |
| CreateTopic | POST |
| DeleteEndpoint | POST |
| DeletePlatformApplication | POST |
| DeleteTopic | POST |
| GetEndpointAttributes | POST |
| GetPlatformApplicationAttributes | POST |
| GetSMSAttributes | POST |
| GetSubscriptionAttributes | POST |
| GetTopicAttributes | POST |
| ListEndpointsByPlatformApplication | POST |
| ListPhoneNumbersOptedOut | POST |
| ListPlatformApplications | POST |
| ListSubscriptions | POST |
| ListSubscriptionsByTopic | POST |
| ListTagsForResource | POST |
| ListTopics | POST |
| OptInPhoneNumber | POST |
| Publish | POST |
| RemovePermission | POST |
| SetEndpointAttributes | POST |
| SetPlatformApplicationAttributes | POST |
| SetSMSAttributes | POST |
| SetSubscriptionAttributes | POST |
| SetTopicAttributes | POST |
| Subscribe | POST |
| TagResource | POST |
| Unsubscribe | POST |
| UntagResource | POST |
+------------------------------------+-------------+
```
You can filter the results using the `--method` and `--prefix` flags which both
take a comma-delimited string of HTTP methods or string name prefixes to filter
results by:
```
$ aws-api-tool list-operations sns --prefix Update,Delete
+--------------------------------------------+-------------+
| NAME | HTTP METHOD |
+--------------------------------------------+-------------+
| DeleteClientVpnEndpoint | POST |
| DeleteClientVpnRoute | POST |
| DeleteCustomerGateway | POST |
| DeleteDhcpOptions | POST |
| DeleteEgressOnlyInternetGateway | POST |
| DeleteFleets | POST |
| DeleteFlowLogs | POST |
| DeleteFpgaImage | POST |
| DeleteInternetGateway | POST |
| DeleteKeyPair | POST |
| DeleteLaunchTemplate | POST |
| DeleteLaunchTemplateVersions | POST |
| DeleteLocalGatewayRoute | POST |
| DeleteLocalGatewayRouteTableVpcAssociation | POST |
| DeleteNatGateway | POST |
| DeleteNetworkAcl | POST |
| DeleteNetworkAclEntry | POST |
| DeleteNetworkInterface | POST |
| DeleteNetworkInterfacePermission | POST |
| DeletePlacementGroup | POST |
| DeleteQueuedReservedInstances | POST |
| DeleteRoute | POST |
| DeleteRouteTable | POST |
| DeleteSecurityGroup | POST |
| DeleteSnapshot | POST |
| DeleteSpotDatafeedSubscription | POST |
| DeleteSubnet | POST |
| DeleteTags | POST |
| DeleteTrafficMirrorFilter | POST |
| DeleteTrafficMirrorFilterRule | POST |
| DeleteTrafficMirrorSession | POST |
| DeleteTrafficMirrorTarget | POST |
| DeleteTransitGateway | POST |
| DeleteTransitGatewayMulticastDomain | POST |
| DeleteTransitGatewayPeeringAttachment | POST |
| DeleteTransitGatewayRoute | POST |
| DeleteTransitGatewayRouteTable | POST |
| DeleteTransitGatewayVpcAttachment | POST |
| DeleteVolume | POST |
| DeleteVpc | POST |
| DeleteVpcEndpointConnectionNotifications | POST |
| DeleteVpcEndpointServiceConfigurations | POST |
| DeleteVpcEndpoints | POST |
| DeleteVpcPeeringConnection | POST |
| DeleteVpnConnection | POST |
| DeleteVpnConnectionRoute | POST |
| DeleteVpnGateway | POST |
| UpdateSecurityGroupRuleDescriptionsEgress | POST |
| UpdateSecurityGroupRuleDescriptionsIngress | POST |
+--------------------------------------------+-------------+
```
```
$ aws-api-tool list-operations s3 --method GET --prefix ListO
+--------------------+-------------+
| NAME | HTTP METHOD |
+--------------------+-------------+
| ListObjectVersions | GET |
| ListObjects | GET |
| ListObjectsV2 | GET |
+--------------------+-------------+
```
#### List API resource objects
Resource objects are those objects that are "top-level" constructs in an API.
These resource objects correspond to the core structures exposed in the API with
Create, Read, Update and Delete operations.
Use the `aws-api-tool list-resources ` command to list these resource objects:
```
$ aws-api-tool list-resources sqs
+-------+
| NAME |
+-------+
| Queue |
+-------+
```
Resource objects are only top-level objects in the API. If an object is solely
contained within another object, it is not a resource object. For example, the
AWS APIGateway API has the following Create operations:
```
$ aws-api-tool list-operations apigateway --prefix Create
+----------------------------+-------------+
| NAME | HTTP METHOD |
+----------------------------+-------------+
| CreateApiKey | POST |
| CreateAuthorizer | POST |
| CreateBasePathMapping | POST |
| CreateDeployment | POST |
| CreateDocumentationPart | POST |
| CreateDocumentationVersion | POST |
| CreateDomainName | POST |
| CreateModel | POST |
| CreateRequestValidator | POST |
| CreateResource | POST |
| CreateRestApi | POST |
| CreateStage | POST |
| CreateUsagePlan | POST |
| CreateUsagePlanKey | POST |
| CreateVpcLink | POST |
+----------------------------+-------------+
```
However, of the above, only the `ApiKey`, `DomainName`, `RestApi`, `UsagePlan` and
`VpcLink` are resources:
```
$ aws-api-tool list-resources apigateway
+------------+
| NAME |
+------------+
| ApiKey |
| DomainName |
| RestApi |
| UsagePlan |
| VpcLink |
+------------+
```
This is because the other objects are solely contained within
another object. For example, a `Deployment` is solely a part of a `RestApi`
object; it cannot be created as a separate thing.
#### List API objects
Use the `aws-api-tool list-objects ` command to list an API's objects. You
can use the `--type` flag to filter objects by type ("scalar", "list",
"payload" and "exception"):
```
$ aws-api-tool list-objects sns --type scalar
+---------------------------+-------------+-----------+
| NAME | OBJECT TYPE | DATA TYPE |
+---------------------------+-------------+-----------+
| AmazonResourceName | scalar | string |
| Binary | scalar | blob |
| MapStringToString | scalar | map |
| MessageAttributeMap | scalar | map |
| PhoneNumber | scalar | string |
| String | scalar | string |
| SubscriptionAttributesMap | scalar | map |
| TagKey | scalar | string |
| TagValue | scalar | string |
| TopicAttributesMap | scalar | map |
| account | scalar | string |
| action | scalar | string |
| attributeName | scalar | string |
| attributeValue | scalar | string |
| authenticateOnUnsubscribe | scalar | string |
| boolean | scalar | boolean |
| delegate | scalar | string |
| endpoint | scalar | string |
| label | scalar | string |
| message | scalar | string |
| messageId | scalar | string |
| messageStructure | scalar | string |
| nextToken | scalar | string |
| protocol | scalar | string |
| string | scalar | string |
| subject | scalar | string |
| subscriptionARN | scalar | string |
| token | scalar | string |
| topicARN | scalar | string |
| topicName | scalar | string |
+---------------------------+-------------+-----------+
```
#### Show OpenAPI3 Schema (Swagger) for API
Use the `aws-api-tool schema ` command to display the OpenAPI3 (Swagger)
Schema for an AWS Service API.
**NOTE**: The output of this command is voluminous, especially for the larger
AWS APIs. We recommend piping the output to a file like so:
```
$ aws-api-tool schema eks > eks.swagger.yaml
```
The `eks.swagger.yaml` file created from the above command will have the entire
Swagger API document.
```
$ head -n20 eks.swagger.yaml
components:
schemas:
AMITypes:
enum:
- AL2_x86_64
- AL2_x86_64_GPU
type: string
AutoScalingGroup:
properties:
name:
type: string
type: object
AutoScalingGroupList:
items:
properties:
name:
type: string
type: object
type: array
BadRequestException:
```
```
$ tail -n54 eks.swagger.yaml
/clusters/{name}/updates/{updateId}:
get:
operationId: DescribeUpdate
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeUpdateRequest'
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeUpdateResponse'
/tags/{resourceArn}:
delete:
operationId: UntagResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UntagResourceRequest'
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/UntagResourceResponse'
get:
operationId: ListTagsForResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListTagsForResourceRequest'
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/ListTagsForResourceResponse'
post:
operationId: TagResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TagResourceRequest'
responses:
"200":
content:
application/json:
schema:
$ref: '#/components/schemas/TagResourceResponse'
```
Note that different AWS service APIs will represent the same things
differently. An example of this is the AWS SQS Queue resource uses the
lowercase name "tags" to refer to a simple `map[string]string` whereas the AWS
SNS Topic resource uses the CamelCased name "Tags" and uses a list of objects
with a "Key" and "Value" property.
**NOTE**: By default, the `aws-api-tool schema ` command outputs the
OpenAPI3 Schema as YAML. You can output condensed JSON instead using the
`--output json` flag:
```
$ aws-api-tool schema sqs Queue --format json > sqs.swagger.json
```