OrganizationalUnit - Amazon Organizations
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Contains details about an organizational unit (OU). An OU is a container of Amazon accounts within a root of an organization. Policies that are attached to an OU apply to all accounts contained in that OU and in any child OUs.



The Amazon Resource Name (ARN) of this OU.

For more information about ARNs in Organizations, see ARN Formats Supported by Organizations in the Amazon Service Authorization Reference.

Type: String

Pattern: ^arn:aws:organizations::\d{12}:ou\/o-[a-z0-9]{10,32}\/ou-[0-9a-z]{4,32}-[0-9a-z]{8,32}

Required: No


The unique identifier (ID) associated with this OU. The ID is unique to the organization only.

The regex pattern for an organizational unit ID string requires "ou-" followed by from 4 to 32 lowercase letters or digits (the ID of the root that contains the OU). This string is followed by a second "-" dash and from 8 to 32 additional lowercase letters or digits.

Type: String

Length Constraints: Maximum length of 68.

Pattern: ^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$

Required: No


The friendly name of this OU.

The regex pattern that is used to validate this parameter is a string of any of the characters in the ASCII character range.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [\s\S]*

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: