AWS Organizations Visualiser
This is a tool that can be used to visualise the structure of an AWS
Organizations structure. It can be used to generate a JSON representation of the
structure or to display the structure in the CLI.
Usage
This tool generates a structure that represents the AWS Organizations structure
and then, based on the flags passed in, either displays the structure in the CLI
or outputs the structure to a JSON file or both.
To use this tool, download the latest release for your platform from the
releases page
and then run the binary with the required flags. Please note that for this tool
to work you must be logged into an AWS account that has access to the AWS
Organizations API and you must have the correct permissions to access the
required information.
If you wish to build the tool from source, clone the repository and run the
following command:
make build
This will build the tool for your current platform and place the binary in the
bin
directory.
If you wish to simply run the tool without building it, run the following
command:
make run
This will run the tool for your current platform.
Finally, if you wish to lint and test the tool, run the following command:
make test
This will run the linter and unit tests for the tool.
Example
To generate a JSON representation of the AWS Organizations structure and output
it to a file called output.json
run the following command:
aws-organizations-visualiser -include-visual=false
To generate a JSON representation of the AWS Organizations structure and output
it to a file called output.json
and display the structure in the CLI run the
following command:
aws-organizations-visualiser -o output.json
To generate a visual representation of the AWS Organizations structure in the
CLI run the following command:
aws-organizations-visualiser -include-json=false
Flags
Usage:
aws-organizations-visualiser [flags]
Flags:
-remove-suspended-accounts
Remove suspended accounts from the output (default false)
-include-json
Include the JSON representation of the AWS Organizations structure in the output (default true)
-include-visual
Include the visual representation of the AWS Organizations structure in the output (default true)
-o string
The output file for the JSON representation of the AWS Organizations structure (default "output.json")
Contributing
If you have any suggestions or issues, please raise them in the issues section
of this repository. If you wish to contribute to this project, please fork the
repository and raise a pull request.
License
This project is licensed under the GNU GPLv3 License - see the
LICENSE file for details.