AWS Organizations
Ingests AWS Organizations account structure and organizational units for governance monitoring and compliance.
Sync Type: Full Synchronisation
Details
The AWS Organizations input collects comprehensive information about your AWS Organizations structure. It provides insights into your multi-account setup, organizational units (OUs), account relationships, and hierarchical organization to help you monitor and analyze your AWS account governance. The input works in one of two modes, depending on Parent ID:
- Parent ID not set: the input lists every account in the organization as a flat list (one record per account, with account metadata such as ID, name, email and status). Child Type is ignored in this mode.
- Parent ID set (a root ID or OU ID): the input lists the direct children of that parent of the selected Child Type, one level only.
For
ACCOUNT, each record holds the account's metadata; forORGANIZATIONAL_UNIT, each record holds only the OU'sIdandType.
The input does not walk the full OU hierarchy and does not collect organization policies. Each sync re-lists every account or child, so the same records are emitted again on every run.
Requirements
- AWS Organizations must be enabled in your AWS management account.
- IAM Role Assumption / Static Credentials
- Example permission to attach to the role/user:
Code
Configuration
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
region | string | Yes | us-east-1 | The AWS region to use. Allowed values: us-east-1, us-east-2, us-west-1, us-west-2, af-south-1, ap-east-1, ap-south-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-southeast-1, ap-southeast-2, ca-central-1, ca-west-1, cn-north-1, cn-northwest-1, eu-central-1, eu-west-1, eu-west-2, eu-west-3, eu-north-1, eu-south-1, me-south-1, sa-east-1, us-gov-east-1, us-gov-west-1. |
cron | string (cron) | Yes | 0 * * * * | Cron string for scheduling the ingest of your input. eg: 0 0 * * * - Daily at midnight, or */15 * * * * - Every 15 minutes. Defaults to an hour. |
role_arn | string | No | - | The ARN of the IAM role to assume for accessing AWS resources. |
parent_id | string | No | - | The unique identifier of the parent entity |
child_type | string | Yes | - | Specifies whether to list AWS accounts or organizational units (OUs) as children of the parent entity. Allowed values: ACCOUNT, ORGANIZATIONAL_UNIT. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
Secrets (Static Credentials Only)
| Secret | Type | Required | Description |
|---|---|---|---|
access_key | secret | No | The Access Key from AWS to authenticate with AWS |
secret_key | secret | No | The Secret Key from AWS to authenticate with AWS |
⚠️ Authentication: Choose either Role ARN (recommended) or static credentials. See AWS Authentication Guide for setup instructions.
Related Articles
- AWS Organizations Documentation
- AWS List Children API
- AWS List Accounts API
- AWS Describe Account API
Sample Record
Code
Sync frequency
This input runs on a cron schedule (default hourly, 0 * * * *), which you can configure on the pipeline.
See Input Sync Frequency for details.
Community transforms
The Monad Transforms Repository has ready-made transforms for this input. Import one into your organization, then add it to a pipeline after this input.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | AWS Organizations Account Inventory to OCSF v1.9.0 |
| ECS v9.5.0 | AWS Organizations Account Inventory to ECS v9.5.0 |
| CEF | AWS Organizations Account Inventory to CEF |
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.