organizations_update_organizational_unit: Renames the specified organizational unit (OU)

Description

Renames the specified organizational unit (OU). The ID and ARN don't change. The child OUs and accounts remain in place, and any attached policies of the OU remain attached.

Usage

organizations_update_organizational_unit(OrganizationalUnitId, Name)

Arguments

OrganizationalUnitId

[required] The unique identifier (ID) of the OU that you want to rename. You can get the ID from the ListOrganizationalUnitsForParent operation.

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

Name

The new name that you want to assign to the OU.

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

Request syntax

svc$update_organizational_unit(
  OrganizationalUnitId = "string",
  Name = "string"
)

Details

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

Examples

Run this code

# NOT RUN {
# The following example shows how to rename an OU. The output confirms the
# new name:/n/n
# }
# NOT RUN {
svc$update_organizational_unit(
  Name = "AccountingOU",
  OrganizationalUnitId = "ou-examplerootid111-exampleouid111"
)
# }
# NOT RUN {
# }