[](https://badge.fury.io/js/cdk-organizations-list-accounts)
[](https://badge.fury.io/py/cdk-organizations-list-accounts)
# cdk-organizations-list-accounts
Want to keep an up-to-date list of your AWS accounts?
cdk-organizations-list-accounts is an AWS CDK building library that outputs a list of AWS organization accounts in CSV format.
## Overview
Amazon EventBridge detects the account creation event and starts a Lambda function.
An accounts list, including the organization structure, will be output to S3 bucket in CSV format.
Output Example:
```csv
Id,Name,Email,Status,Joined Method,Joined Timestamp,OU Id,1st Level OU,2nd Level OU,3rd Level OU,4th Level OU,5th Level OU
000000000000,account-mgmt,account+mgmt@example.com,ACTIVE,INVITED,2022-01-31 07:19:57,r-xxxx
111111111111,account-0001,account+0001@example.com,ACTIVE,INVITED,2022-01-31 07:25:38,ou-xxxx-yyyyyyyy,Suspended
222222222222,account-0002,account+0002@example.com,ACTIVE,CREATED,2022-01-31 07:31:28,ou-xxxx-zzzzzzzz,Sample System,Additional,Workloads,Prod
333333333333,account-0003,account+0003@example.com,ACTIVE,CREATED,2022-01-31 08:15:49,ou-xxxx-zzzzzzzz,Sample System,Additional,Workloads,SDLC
444444444444,account-0004,account+0004@example.com,ACTIVE,CREATED,2022-01-31 09:18:50,ou-xxxx-zzzzzzzz,Sample System,Foundational,Security,Prod
555555555555,account-0005,account+0005@example.com,ACTIVE,CREATED,2022-01-31 10:21:30,ou-xxxx-zzzzzzzz,Sample System,Foundational,Infrastructure,Prod
666666666666,account-0006,account+0006@example.com,ACTIVE,CREATED,2022-01-31 11:21:05,ou-xxxx-zzzzzzzz,Sample System,Foundational,Infrastructure,SDLC
```
## Limitations at present
* Must deploy to AWS Organization's management account
* Events other than CreateAccount are not supported
## Getting Started
### TypeScript
Installation
```
$ yarn add cdk-organizations-list-accounts
```
Usage
```python
import * as cdk from 'aws-cdk-lib';
import { OrganizationsListAccounts } from 'cdk-organizations-list-accounts';
const App = new cdk.App();
const stack = new cdk.Stack(App, 'Stack', { env: { region: 'us-east-1' } });
new OrganizationsListAccounts(stack, 'Organizations-List-Accounts');
```
Deploy!
```
$ cdk deploy
```
### Python
Installation
```
$ pip install cdk-organizations-list-accounts
```
Usage
```py
import aws_cdk as cdk
from cdk_organizations_list_accounts import OrganizationsListAccounts
app = cdk.App()
stack = cdk.Stack(app, "Stack", env={"region": "us-east-1"})
OrganizationsListAccounts(stack, "Organizations-List-Accounts")
app.synth()
```
Deploy!
```
$ cdk deploy
```
Raw data
{
"_id": null,
"home_page": "https://github.com/hayao-k/cdk-organizations-list-accounts.git",
"name": "cdk-organizations-list-accounts",
"maintainer": "",
"docs_url": null,
"requires_python": "~=3.7",
"maintainer_email": "",
"keywords": "",
"author": "hayao-k<30886141+hayao-k@users.noreply.github.com>",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/94/c3/8d3c93f8186f8e65b32706181ec4e97578f4fde19efa8aef9ae9691a4bb8/cdk-organizations-list-accounts-1.0.117.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/js/cdk-organizations-list-accounts)\n[](https://badge.fury.io/py/cdk-organizations-list-accounts)\n\n\n# cdk-organizations-list-accounts\n\nWant to keep an up-to-date list of your AWS accounts?\n\ncdk-organizations-list-accounts is an AWS CDK building library that outputs a list of AWS organization accounts in CSV format.\n\n## Overview\n\nAmazon EventBridge detects the account creation event and starts a Lambda function.\nAn accounts list, including the organization structure, will be output to S3 bucket in CSV format.\n\nOutput Example:\n\n```csv\nId,Name,Email,Status,Joined Method,Joined Timestamp,OU Id,1st Level OU,2nd Level OU,3rd Level OU,4th Level OU,5th Level OU\n000000000000,account-mgmt,account+mgmt@example.com,ACTIVE,INVITED,2022-01-31 07:19:57,r-xxxx\n111111111111,account-0001,account+0001@example.com,ACTIVE,INVITED,2022-01-31 07:25:38,ou-xxxx-yyyyyyyy,Suspended\n222222222222,account-0002,account+0002@example.com,ACTIVE,CREATED,2022-01-31 07:31:28,ou-xxxx-zzzzzzzz,Sample System,Additional,Workloads,Prod\n333333333333,account-0003,account+0003@example.com,ACTIVE,CREATED,2022-01-31 08:15:49,ou-xxxx-zzzzzzzz,Sample System,Additional,Workloads,SDLC\n444444444444,account-0004,account+0004@example.com,ACTIVE,CREATED,2022-01-31 09:18:50,ou-xxxx-zzzzzzzz,Sample System,Foundational,Security,Prod\n555555555555,account-0005,account+0005@example.com,ACTIVE,CREATED,2022-01-31 10:21:30,ou-xxxx-zzzzzzzz,Sample System,Foundational,Infrastructure,Prod\n666666666666,account-0006,account+0006@example.com,ACTIVE,CREATED,2022-01-31 11:21:05,ou-xxxx-zzzzzzzz,Sample System,Foundational,Infrastructure,SDLC\n```\n\n## Limitations at present\n\n* Must deploy to AWS Organization's management account\n* Events other than CreateAccount are not supported\n\n## Getting Started\n\n### TypeScript\n\nInstallation\n\n```\n$ yarn add cdk-organizations-list-accounts\n```\n\nUsage\n\n```python\nimport * as cdk from 'aws-cdk-lib';\nimport { OrganizationsListAccounts } from 'cdk-organizations-list-accounts';\n\nconst App = new cdk.App();\nconst stack = new cdk.Stack(App, 'Stack', { env: { region: 'us-east-1' } });\nnew OrganizationsListAccounts(stack, 'Organizations-List-Accounts');\n```\n\nDeploy!\n\n```\n$ cdk deploy\n```\n\n### Python\n\nInstallation\n\n```\n$ pip install cdk-organizations-list-accounts\n```\n\nUsage\n\n```py\nimport aws_cdk as cdk\nfrom cdk_organizations_list_accounts import OrganizationsListAccounts\n\napp = cdk.App()\nstack = cdk.Stack(app, \"Stack\", env={\"region\": \"us-east-1\"})\nOrganizationsListAccounts(stack, \"Organizations-List-Accounts\")\napp.synth()\n```\n\nDeploy!\n\n```\n$ cdk deploy\n```\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "cdk-organizations-list-accounts is an AWS CDK building library that outputs a list of AWS organization accounts in CSV format.",
"version": "1.0.117",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "a1a4d9e776c010057ac49a5363304049",
"sha256": "c7d40268562acd4855a68b865988e27052912e28485a5bc603c0cc4cbd70017a"
},
"downloads": -1,
"filename": "cdk_organizations_list_accounts-1.0.117-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1a4d9e776c010057ac49a5363304049",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.7",
"size": 28829,
"upload_time": "2022-07-03T01:18:21",
"upload_time_iso_8601": "2022-07-03T01:18:21.591849Z",
"url": "https://files.pythonhosted.org/packages/45/04/3506c4e640bbc67bfff4a7c4e0b6849f38c7e19648ac5f862734eff7a510/cdk_organizations_list_accounts-1.0.117-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "e83429fc60f184192db6c65539da0d72",
"sha256": "2010c55ba826c86684d88c94e8aeb96a9a7a687de92f9a0e7dff44a0b730e883"
},
"downloads": -1,
"filename": "cdk-organizations-list-accounts-1.0.117.tar.gz",
"has_sig": false,
"md5_digest": "e83429fc60f184192db6c65539da0d72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.7",
"size": 29817,
"upload_time": "2022-07-03T01:18:22",
"upload_time_iso_8601": "2022-07-03T01:18:22.790726Z",
"url": "https://files.pythonhosted.org/packages/94/c3/8d3c93f8186f8e65b32706181ec4e97578f4fde19efa8aef9ae9691a4bb8/cdk-organizations-list-accounts-1.0.117.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-07-03 01:18:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "hayao-k",
"github_project": "cdk-organizations-list-accounts.git",
"lcname": "cdk-organizations-list-accounts"
}
JSON
