organizations:ListChildren

List

organizations:ListChildren is a List access-level action in the organizations service. Grants permission to list all of the OUs or accounts that are contained in a parent OU or root

Resource types

ARNs that organizations:ListChildren can be scoped to in an IAM policy.

arn:${Partition}:organizations::${Account}:ou/o-${OrganizationId}/ou-${OrganizationalUnitId}

organizationalunit

arn:${Partition}:organizations::${Account}:root/o-${OrganizationId}/r-${RootId}

root

Condition keys

Keys you can use in the Condition block of a policy that grants organizations:ListChildren.

aws:ResourceTag/${TagKey} String

Filters access by the tags associated with the resource

Example IAM policy

A minimal policy that allows organizations:ListChildren. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowOrganizationsListChildren",
      "Effect": "Allow",
      "Action": "organizations:ListChildren",
      "Resource": "*"
    }
  ]
}

Related actions in organizations

organizations:AcceptHandshake Write organizations:AttachPolicy Write organizations:CancelHandshake Write organizations:CloseAccount Write organizations:CreateAccount Write organizations:CreateGovCloudAccount Write organizations:CreateOrganization Write organizations:CreateOrganizationalUnit Write organizations:CreatePolicy Write organizations:DeclineHandshake Write organizations:DeleteOrganization Write organizations:DeleteOrganizationalUnit Write

View all organizations actions →