Accounts
Every account of your AWS organization belongs to some OU. To place an account to an OU, you add the account to the accounts property of the OU in question. The accounts property is a list that accepts plain account ids and account objects that let you provide additional account-specific configuration.
AWS account id may begin with zero and that is why account ids must always be strings in Takomo configuration, i.e., the id must be quoted like so "012345678901".

Example

Here's an example of how to put accounts into OUs. The account 876754648373 is defined with object notation. The other accounts are defined as plain account ids.
organization/organization.yml
1
masterAccountId: "098765432100"
2
3
organizationalUnits:
4
Root:
5
accounts:
6
# This is the organization master account
7
- "098765432100"
8
Root/Workloads/Dev: {}
9
Root/Workloads/Test: {}
10
Root/Workloads/Prod:
11
accounts:
12
# Account using the object notation
13
- id: "876754648373"
14
Root/Sandbox:
15
# Only the id is given for these accounts
16
accounts:
17
- "123456789012"
18
- "448873940474"
Copied!

Additional configuration

The account id is the only required information for accounts. With object notation, you can provide additional information.

Name

You can specify the account name with the name property. The name helps you to identify the account. Takomo uses the name to verify that the account configuration is valid, i.e., there actually exists an account with the given id and name.
Please note that Takomo won't update the actual account name to match what you have defined in the configuration.

Example

Here's how to specify the name for account 876754648373..
organization/organization.yml
1
masterAccountId: "098765432100"
2
3
organizationalUnits:
4
Root:
5
accounts:
6
- "098765432100"
7
Root/Workloads/Dev: {}
8
Root/Workloads/Test: {}
9
Root/Workloads/Prod:
10
accounts:
11
- id: "876754648373"
12
# Account name is specified like this
13
name: MyAccount
14
Root/Sandbox:
15
accounts:
16
- "123456789012"
17
- "448873940474"
Copied!

Email

You can specify the account email with the email property. The email helps you to identify the account. Takomo uses the email to verify that the account configuration is valid, i.e., there actually exists an account with the given id and email.
Please note that Takomo won't update the actual account email to match what you have defined in the configuration.

Example

Here's how to specify the email for account 876754648373.
organization/organization.yml
1
masterAccountId: "098765432100"
2
3
organizationalUnits:
4
Root:
5
accounts:
6
- "098765432100"
7
Root/Workloads/Dev: {}
8
Root/Workloads/Test: {}
9
Root/Workloads/Prod:
10
accounts:
11
- id: "876754648373"
12
name: MyAccount
13
# Account email is specified like this
15
Root/Sandbox:
16
accounts:
17
- "123456789012"
18
- "448873940474"
Copied!

Description

You can give a short description for an account with the description property.

Example

Here's how to specify the description for account 876754648373.
organization/organization.yml
1
masterAccountId: "098765432100"
2
3
organizationalUnits:
4
Root:
5
accounts:
6
- "098765432100"
7
Root/Workloads/Dev: {}
8
Root/Workloads/Test: {}
9
Root/Workloads/Prod:
10
accounts:
11
- id: "876754648373"
12
name: MyAccount
14
# Account description is specified like this
15
description: This is a production account
16
Root/Sandbox:
17
accounts:
18
- "123456789012"
19
- "448873940474"
Copied!
Last modified 1mo ago