Network.AWS.Organizations.CreateOrganizationalUnit

Creates an organizational unit (OU) within a root or parent OU. An OU is a container for accounts that enables you to organize your accounts to apply policies according to your business requirements. The number of levels deep that you can nest OUs is dependent upon the policy types enabled for that root. For service control policies, the limit is five.

For more information about OUs, see Managing Organizational Units in the AWS Organizations User Guide .

This operation can be called only from the organization's master account.

Creating a Request

createOrganizationalUnit

Arguments

:: Text

couParentId

-> Text

couName

-> CreateOrganizationalUnit

Creates a value of CreateOrganizationalUnit with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• couParentId - The unique identifier (ID) of the parent root or OU in which you want to create the new OU. 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 lower-case letters or digits. * Organizational unit (OU): a string that begins with "ou-" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second "-" dash and from 8 to 32 additional lower-case letters or digits.
• couName - The friendly name to assign to the new OU.

data CreateOrganizationalUnit

See: createOrganizationalUnit smart constructor.

Instances

Eq CreateOrganizationalUnit

Methods

(==) :: CreateOrganizationalUnit -> CreateOrganizationalUnit -> Bool

(/=) :: CreateOrganizationalUnit -> CreateOrganizationalUnit -> Bool

Data CreateOrganizationalUnit

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateOrganizationalUnit -> c CreateOrganizationalUnit

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateOrganizationalUnit

toConstr :: CreateOrganizationalUnit -> Constr

dataTypeOf :: CreateOrganizationalUnit -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateOrganizationalUnit)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateOrganizationalUnit)

gmapT :: (forall b. Data b => b -> b) -> CreateOrganizationalUnit -> CreateOrganizationalUnit

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateOrganizationalUnit -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateOrganizationalUnit -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateOrganizationalUnit -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateOrganizationalUnit -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnit -> m CreateOrganizationalUnit

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnit -> m CreateOrganizationalUnit

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnit -> m CreateOrganizationalUnit

Read CreateOrganizationalUnit

Methods

readsPrec :: Int -> ReadS CreateOrganizationalUnit

readList :: ReadS [CreateOrganizationalUnit]

readPrec :: ReadPrec CreateOrganizationalUnit

readListPrec :: ReadPrec [CreateOrganizationalUnit]

Show CreateOrganizationalUnit

Methods

showsPrec :: Int -> CreateOrganizationalUnit -> ShowS

show :: CreateOrganizationalUnit -> String

showList :: [CreateOrganizationalUnit] -> ShowS

Generic CreateOrganizationalUnit

Associated Types

type Rep CreateOrganizationalUnit :: * -> *

Methods

from :: CreateOrganizationalUnit -> Rep CreateOrganizationalUnit x

to :: Rep CreateOrganizationalUnit x -> CreateOrganizationalUnit

Hashable CreateOrganizationalUnit

Methods

hashWithSalt :: Int -> CreateOrganizationalUnit -> Int

hash :: CreateOrganizationalUnit -> Int

ToJSON CreateOrganizationalUnit

Methods

toJSON :: CreateOrganizationalUnit -> Value

toEncoding :: CreateOrganizationalUnit -> Encoding

toJSONList :: [CreateOrganizationalUnit] -> Value

toEncodingList :: [CreateOrganizationalUnit] -> Encoding

NFData CreateOrganizationalUnit

Methods

rnf :: CreateOrganizationalUnit -> ()

AWSRequest CreateOrganizationalUnit

Associated Types

type Rs CreateOrganizationalUnit :: *

Methods

request :: CreateOrganizationalUnit -> Request CreateOrganizationalUnit

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * CreateOrganizationalUnit -> ClientResponse -> m (Response CreateOrganizationalUnit)

ToHeaders CreateOrganizationalUnit

Methods

toHeaders :: CreateOrganizationalUnit -> [Header]

ToPath CreateOrganizationalUnit

Methods

toPath :: CreateOrganizationalUnit -> ByteString

ToQuery CreateOrganizationalUnit

Methods

toQuery :: CreateOrganizationalUnit -> QueryString

type Rep CreateOrganizationalUnit

type Rep CreateOrganizationalUnit = D1 * (MetaData "CreateOrganizationalUnit" "Network.AWS.Organizations.CreateOrganizationalUnit" "amazonka-organizations-1.6.0-rHxjcIb8Bn6XT7VgZWDi9" False) (C1 * (MetaCons "CreateOrganizationalUnit'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_couParentId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_couName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))

type Rs CreateOrganizationalUnit

type Rs CreateOrganizationalUnit = CreateOrganizationalUnitResponse

Request Lenses

couParentId :: Lens' CreateOrganizationalUnit Text

The unique identifier (ID) of the parent root or OU in which you want to create the new OU. 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 lower-case letters or digits. * Organizational unit (OU): a string that begins with "ou-" followed by from 4 to 32 lower-case letters or digits (the ID of the root that the OU is in) followed by a second "-" dash and from 8 to 32 additional lower-case letters or digits.

couName :: Lens' CreateOrganizationalUnit Text

The friendly name to assign to the new OU.

Destructuring the Response

createOrganizationalUnitResponse

Arguments

:: Int

coursResponseStatus

-> CreateOrganizationalUnitResponse

Creates a value of CreateOrganizationalUnitResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• coursOrganizationalUnit - A structure that contains details about the newly created OU.
• coursResponseStatus - -- | The response status code.

data CreateOrganizationalUnitResponse

See: createOrganizationalUnitResponse smart constructor.

Instances

Eq CreateOrganizationalUnitResponse

Methods

(==) :: CreateOrganizationalUnitResponse -> CreateOrganizationalUnitResponse -> Bool

(/=) :: CreateOrganizationalUnitResponse -> CreateOrganizationalUnitResponse -> Bool

Data CreateOrganizationalUnitResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateOrganizationalUnitResponse -> c CreateOrganizationalUnitResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateOrganizationalUnitResponse

toConstr :: CreateOrganizationalUnitResponse -> Constr

dataTypeOf :: CreateOrganizationalUnitResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateOrganizationalUnitResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateOrganizationalUnitResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateOrganizationalUnitResponse -> CreateOrganizationalUnitResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateOrganizationalUnitResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateOrganizationalUnitResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateOrganizationalUnitResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateOrganizationalUnitResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnitResponse -> m CreateOrganizationalUnitResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnitResponse -> m CreateOrganizationalUnitResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateOrganizationalUnitResponse -> m CreateOrganizationalUnitResponse

Read CreateOrganizationalUnitResponse

Methods

readsPrec :: Int -> ReadS CreateOrganizationalUnitResponse

readList :: ReadS [CreateOrganizationalUnitResponse]

readPrec :: ReadPrec CreateOrganizationalUnitResponse

readListPrec :: ReadPrec [CreateOrganizationalUnitResponse]

Show CreateOrganizationalUnitResponse

Methods

showsPrec :: Int -> CreateOrganizationalUnitResponse -> ShowS

show :: CreateOrganizationalUnitResponse -> String

showList :: [CreateOrganizationalUnitResponse] -> ShowS

Generic CreateOrganizationalUnitResponse

Associated Types

type Rep CreateOrganizationalUnitResponse :: * -> *

Methods

from :: CreateOrganizationalUnitResponse -> Rep CreateOrganizationalUnitResponse x

to :: Rep CreateOrganizationalUnitResponse x -> CreateOrganizationalUnitResponse

NFData CreateOrganizationalUnitResponse

Methods

rnf :: CreateOrganizationalUnitResponse -> ()

type Rep CreateOrganizationalUnitResponse

type Rep CreateOrganizationalUnitResponse = D1 * (MetaData "CreateOrganizationalUnitResponse" "Network.AWS.Organizations.CreateOrganizationalUnit" "amazonka-organizations-1.6.0-rHxjcIb8Bn6XT7VgZWDi9" False) (C1 * (MetaCons "CreateOrganizationalUnitResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_coursOrganizationalUnit") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe OrganizationalUnit))) (S1 * (MetaSel (Just Symbol "_coursResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int))))

Response Lenses

coursOrganizationalUnit :: Lens' CreateOrganizationalUnitResponse (Maybe OrganizationalUnit)

A structure that contains details about the newly created OU.

coursResponseStatus :: Lens' CreateOrganizationalUnitResponse Int

• - | The response status code.