Package software.amazon.awscdk.services.organizations

Interface CfnOrganizationalUnitProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnOrganizationalUnitProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.104.0 (build e79254c)",
           date="2025-01-15T21:09:22.692Z")
@Stability(Stable)
public interface CfnOrganizationalUnitProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnOrganizationalUnit.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.organizations.*;
 CfnOrganizationalUnitProps cfnOrganizationalUnitProps = CfnOrganizationalUnitProps.builder()
         .name("name")
         .parentId("parentId")
         // the properties below are optional
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-organizations-organizationalunit.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnOrganizationalUnitProps.Builder	A builder for CfnOrganizationalUnitProps
static final class	CfnOrganizationalUnitProps.Jsii$Proxy	An implementation for CfnOrganizationalUnitProps

Method Summary

Modifier and Type	Method	Description
static CfnOrganizationalUnitProps.Builder	builder()
String	getName()	The friendly name of this OU.
String	getParentId()	The unique identifier (ID) of the parent root or OU that you want to create the new OU in.
default List<CfnTag>	getTags()	A list of tags that you want to attach to the newly created OU.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getName

@Stability(Stable)
@NotNull
String getName()

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.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-organizations-organizationalunit.html#cfn-organizations-organizationalunit-name

getParentId

@Stability(Stable)
@NotNull
String getParentId()

The unique identifier (ID) of the parent root or OU that you want to create the new OU in.

To update the ParentId parameter value, you must first remove all accounts attached to the organizational unit (OU). OUs can't be moved within the organization with accounts still attached.

The regex pattern for a parent ID string requires one of the following:

• Root - A string that begins with "r-" followed by from 4 to 32 lowercase letters or digits.
• Organizational unit (OU) - A string that begins with "ou-" followed by from 4 to 32 lowercase letters or digits (the ID of the root that the OU is in). This string is followed by a second "-" dash and from 8 to 32 additional lowercase letters or digits.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-organizations-organizationalunit.html#cfn-organizations-organizationalunit-parentid

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

A list of tags that you want to attach to the newly created OU.

For each tag in the list, you must specify both a tag key and a value. You can set the value to an empty string, but you can't set it to null . For more information about tagging, see Tagging AWS Organizations resources in the AWS Organizations User Guide.

If any one of the tags is not valid or if you exceed the allowed number of tags for an OU, then the entire request fails and the OU is not created.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-organizations-organizationalunit.html#cfn-organizations-organizationalunit-tags

builder

@Stability(Stable)
static CfnOrganizationalUnitProps.Builder builder()

Returns:

a CfnOrganizationalUnitProps.Builder of CfnOrganizationalUnitProps