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

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

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

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

Data CreateOrganizationalUnit

Defined in Network.AWS.Organizations.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

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

readsPrec :: Int -> ReadS CreateOrganizationalUnit

readList :: ReadS [CreateOrganizationalUnit]

readPrec :: ReadPrec CreateOrganizationalUnit

readListPrec :: ReadPrec [CreateOrganizationalUnit]

Show CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

showsPrec :: Int -> CreateOrganizationalUnit -> ShowS

show :: CreateOrganizationalUnit -> String

showList :: [CreateOrganizationalUnit] -> ShowS

Generic CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Associated Types

type Rep CreateOrganizationalUnit :: Type -> Type

Methods

from :: CreateOrganizationalUnit -> Rep CreateOrganizationalUnit x

to :: Rep CreateOrganizationalUnit x -> CreateOrganizationalUnit

Hashable CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

hashWithSalt :: Int -> CreateOrganizationalUnit -> Int

hash :: CreateOrganizationalUnit -> Int

ToJSON CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

toJSON :: CreateOrganizationalUnit -> Value

toEncoding :: CreateOrganizationalUnit -> Encoding

toJSONList :: [CreateOrganizationalUnit] -> Value

toEncodingList :: [CreateOrganizationalUnit] -> Encoding

AWSRequest CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Associated Types

type Rs CreateOrganizationalUnit :: Type

Methods

request :: CreateOrganizationalUnit -> Request CreateOrganizationalUnit

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

ToHeaders CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

toHeaders :: CreateOrganizationalUnit -> [Header]

ToPath CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

toPath :: CreateOrganizationalUnit -> ByteString

ToQuery CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

toQuery :: CreateOrganizationalUnit -> QueryString

NFData CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

rnf :: CreateOrganizationalUnit -> ()

type Rep CreateOrganizationalUnit

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

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

type Rs CreateOrganizationalUnit

Defined in Network.AWS.Organizations.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

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

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

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

Data CreateOrganizationalUnitResponse

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

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

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

readsPrec :: Int -> ReadS CreateOrganizationalUnitResponse

readList :: ReadS [CreateOrganizationalUnitResponse]

readPrec :: ReadPrec CreateOrganizationalUnitResponse

readListPrec :: ReadPrec [CreateOrganizationalUnitResponse]

Show CreateOrganizationalUnitResponse

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

showsPrec :: Int -> CreateOrganizationalUnitResponse -> ShowS

show :: CreateOrganizationalUnitResponse -> String

showList :: [CreateOrganizationalUnitResponse] -> ShowS

Generic CreateOrganizationalUnitResponse

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Associated Types

type Rep CreateOrganizationalUnitResponse :: Type -> Type

Methods

from :: CreateOrganizationalUnitResponse -> Rep CreateOrganizationalUnitResponse x

to :: Rep CreateOrganizationalUnitResponse x -> CreateOrganizationalUnitResponse

NFData CreateOrganizationalUnitResponse

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

Methods

rnf :: CreateOrganizationalUnitResponse -> ()

type Rep CreateOrganizationalUnitResponse

Defined in Network.AWS.Organizations.CreateOrganizationalUnit

type Rep CreateOrganizationalUnitResponse = D1 (MetaData "CreateOrganizationalUnitResponse" "Network.AWS.Organizations.CreateOrganizationalUnit" "amazonka-organizations-1.6.1-AXMOvAV6jebLVZPNUpIjqF" False) (C1 (MetaCons "CreateOrganizationalUnitResponse'" PrefixI True) (S1 (MetaSel (Just "_coursOrganizationalUnit") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe OrganizationalUnit)) :*: S1 (MetaSel (Just "_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.