1. Packages
  2. AWS
  3. API Docs
  4. organizations
  5. getOrganizationalUnitChildAccounts
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

aws.organizations.getOrganizationalUnitChildAccounts

aws logo
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

    Get all direct child accounts under a parent organizational unit. This only provides immediate children, not all children.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const org = aws.organizations.getOrganization({});
const accounts = org.then(org => aws.organizations.getOrganizationalUnitChildAccounts({
    parentId: org.roots?.[0]?.id,
}));

    import pulumi
import pulumi_aws as aws

org = aws.organizations.get_organization()
accounts = aws.organizations.get_organizational_unit_child_accounts(parent_id=org.roots[0].id)

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/organizations"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		org, err := organizations.LookupOrganization(ctx, map[string]interface{}{}, nil)
		if err != nil {
			return err
		}
		_, err = organizations.GetOrganizationalUnitChildAccounts(ctx, &organizations.GetOrganizationalUnitChildAccountsArgs{
			ParentId: org.Roots[0].Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var org = Aws.Organizations.GetOrganization.Invoke();

    var accounts = Aws.Organizations.GetOrganizationalUnitChildAccounts.Invoke(new()
    {
        ParentId = org.Apply(getOrganizationResult => getOrganizationResult.Roots[0]?.Id),
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.organizations.OrganizationsFunctions;
import com.pulumi.aws.organizations.inputs.GetOrganizationalUnitChildAccountsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var org = OrganizationsFunctions.getOrganization(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference);

        final var accounts = OrganizationsFunctions.getOrganizationalUnitChildAccounts(GetOrganizationalUnitChildAccountsArgs.builder()
            .parentId(org.roots()[0].id())
            .build());

    }
}

    variables:
  org:
    fn::invoke:
      function: aws:organizations:getOrganization
      arguments: {}
  accounts:
    fn::invoke:
      function: aws:organizations:getOrganizationalUnitChildAccounts
      arguments:
        parentId: ${org.roots[0].id}

    Using getOrganizationalUnitChildAccounts

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getOrganizationalUnitChildAccounts(args: GetOrganizationalUnitChildAccountsArgs, opts?: InvokeOptions): Promise<GetOrganizationalUnitChildAccountsResult>
function getOrganizationalUnitChildAccountsOutput(args: GetOrganizationalUnitChildAccountsOutputArgs, opts?: InvokeOptions): Output<GetOrganizationalUnitChildAccountsResult>
    def get_organizational_unit_child_accounts(parent_id: Optional[str] = None,
                                           opts: Optional[InvokeOptions] = None) -> GetOrganizationalUnitChildAccountsResult
def get_organizational_unit_child_accounts_output(parent_id: Optional[pulumi.Input[str]] = None,
                                           opts: Optional[InvokeOptions] = None) -> Output[GetOrganizationalUnitChildAccountsResult]
    func GetOrganizationalUnitChildAccounts(ctx *Context, args *GetOrganizationalUnitChildAccountsArgs, opts ...InvokeOption) (*GetOrganizationalUnitChildAccountsResult, error)
func GetOrganizationalUnitChildAccountsOutput(ctx *Context, args *GetOrganizationalUnitChildAccountsOutputArgs, opts ...InvokeOption) GetOrganizationalUnitChildAccountsResultOutput

    > Note: This function is named GetOrganizationalUnitChildAccounts in the Go SDK.

    public static class GetOrganizationalUnitChildAccounts 
{
    public static Task<GetOrganizationalUnitChildAccountsResult> InvokeAsync(GetOrganizationalUnitChildAccountsArgs args, InvokeOptions? opts = null)
    public static Output<GetOrganizationalUnitChildAccountsResult> Invoke(GetOrganizationalUnitChildAccountsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetOrganizationalUnitChildAccountsResult> getOrganizationalUnitChildAccounts(GetOrganizationalUnitChildAccountsArgs args, InvokeOptions options)
public static Output<GetOrganizationalUnitChildAccountsResult> getOrganizationalUnitChildAccounts(GetOrganizationalUnitChildAccountsArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:organizations/getOrganizationalUnitChildAccounts:getOrganizationalUnitChildAccounts
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ParentId string
    The parent ID of the accounts.
    ParentId string
    The parent ID of the accounts.
    parentId String
    The parent ID of the accounts.
    parentId string
    The parent ID of the accounts.
    parent_id str
    The parent ID of the accounts.
    parentId String
    The parent ID of the accounts.

    getOrganizationalUnitChildAccounts Result

    The following output properties are available:

    Accounts List<GetOrganizationalUnitChildAccountsAccount>
    List of child accounts, which have the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    ParentId string
    Accounts []GetOrganizationalUnitChildAccountsAccount
    List of child accounts, which have the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    ParentId string
    accounts List<GetOrganizationalUnitChildAccountsAccount>
    List of child accounts, which have the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    parentId String
    accounts GetOrganizationalUnitChildAccountsAccount[]
    List of child accounts, which have the following attributes:
    id string
    The provider-assigned unique ID for this managed resource.
    parentId string
    accounts Sequence[GetOrganizationalUnitChildAccountsAccount]
    List of child accounts, which have the following attributes:
    id str
    The provider-assigned unique ID for this managed resource.
    parent_id str
    accounts List<Property Map>
    List of child accounts, which have the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    parentId String

    Supporting Types

    GetOrganizationalUnitChildAccountsAccount

    Arn string
    The Amazon Resource Name (ARN) of the account.
    Email string
    The email address associated with the AWS account.
    Id string
    Parent identifier of the organizational units.
    Name string
    The friendly name of the account.
    Status string
    The status of the account in the organization.
    Arn string
    The Amazon Resource Name (ARN) of the account.
    Email string
    The email address associated with the AWS account.
    Id string
    Parent identifier of the organizational units.
    Name string
    The friendly name of the account.
    Status string
    The status of the account in the organization.
    arn String
    The Amazon Resource Name (ARN) of the account.
    email String
    The email address associated with the AWS account.
    id String
    Parent identifier of the organizational units.
    name String
    The friendly name of the account.
    status String
    The status of the account in the organization.
    arn string
    The Amazon Resource Name (ARN) of the account.
    email string
    The email address associated with the AWS account.
    id string
    Parent identifier of the organizational units.
    name string
    The friendly name of the account.
    status string
    The status of the account in the organization.
    arn str
    The Amazon Resource Name (ARN) of the account.
    email str
    The email address associated with the AWS account.
    id str
    Parent identifier of the organizational units.
    name str
    The friendly name of the account.
    status str
    The status of the account in the organization.
    arn String
    The Amazon Resource Name (ARN) of the account.
    email String
    The email address associated with the AWS account.
    id String
    Parent identifier of the organizational units.
    name String
    The friendly name of the account.
    status String
    The status of the account in the organization.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v6.83.1 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.