

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criando uma unidade organizacional (OU) com AWS Organizations
<a name="create_ou"></a>

Ao entrar na conta de gerenciamento da sua organização, você pode criar uma OU na raiz da sua organização. OUs pode ser aninhado até cinco níveis de profundidade. Para criar uma UO, conclua as seguintes etapas.

**Importante**  
Se essa organização for gerenciada com AWS Control Tower, crie a sua OUs com o AWS Control Tower console ou APIs. Se você criar a OU em Organizations, essa OU não será registrada no AWS Control Tower. Para obter mais informações, consulte [Referência a recursos fora do AWS Control Tower](https://docs.aws.amazon.com/controltower/latest/userguide/external-resources.html#ungoverned-resources) no *Manual do usuário do AWS Control Tower *.

**Permissões mínimas**  
Para criar uma UO dentro de uma raiz em sua organização, você precisa ter as seguintes permissões:  
`organizations:DescribeOrganization` – necessária somente ao usar o console do Organizations
`organizations:CreateOrganizationalUnit`

## Console de gerenciamento da AWS
<a name="create_ou_console"></a>

**Para criar uma OU**

1. Faça login no [console do AWS Organizations](https://console.aws.amazon.com/organizations/v2). Você deve fazer login como um usuário do IAM, assumir uma função do IAM ou fazer login como usuário-raiz ([não recomendado](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)) na conta de gerenciamento da organização.

1. Navegue até o página **[Contas da AWS](https://console.aws.amazon.com/organizations/v2/home/accounts)**.

   O console exibe a UO-raiz e seu conteúdo. Na primeira vez em que você acessa uma raiz, o console exibe todas as suas Contas da AWS na visualização de nível superior. Se você já criou OUs e transferiu contas para elas, o console mostra somente as contas de nível superior OUs e todas as contas que você ainda não transferiu para uma OU.

1. (Opcional) Se você quiser criar uma OU dentro de uma UO existente, [navegue até a UO secundária](navigate_tree.md) escolhendo o nome (não a caixa de seleção) da UO secundária ou escolhendo a ![\[Gray cloud icon with an arrow pointing downward, indicating download or cloud storage.\]](http://docs.aws.amazon.com/pt_br/organizations/latest/userguide/images/expand-icon.png) próxima na exibição OUs em árvore até ver a que deseja e, em seguida, escolhendo seu nome.

1. Quando você tiver selecionado a UO superior correta na hierarquia, no menu **Actions (Ações)**, em **Organizational Unit (Unidade Organizacional)**, escolha **Create new (Criar nova)**

1. Na caixa de diálogo **Create organizational unit (Criar unidade organizacional)**, insira o nome da UO que você deseja criar.

1. (Opcional) Adicione uma ou mais tags escolhendo **Add tag (Adicionar tag)** e inserindo uma chave e um valor opcional. Se deixar o valor em branco, ele é definido como uma sequência vazia, não `null`. É possível anexar até 50 tags a uma UO.

1. Por fim, selecione **Create organizational unit (Criar unidade organizacional)**.

A nova UO aparece dentro do pai. Agora você pode [mover contas para essa UO](move_account_to_ou.md) ou anexar políticas a ela.

## AWS CLI & AWS SDKs
<a name="create_ou_cli_sdk"></a>

**Para criar uma OU**

Os exemplos de código a seguir mostram como usar o `CreateOrganizationalUnit`.

------
#### [ .NET ]

**SDK para .NET**  
 Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Organizations#code-examples). 

```
    using System;
    using System.Threading.Tasks;
    using Amazon.Organizations;
    using Amazon.Organizations.Model;

    /// <summary>
    /// Creates a new organizational unit in AWS Organizations.
    /// </summary>
    public class CreateOrganizationalUnit
    {
        /// <summary>
        /// Initializes an Organizations client object and then uses it to call
        /// the CreateOrganizationalUnit method. If the call succeeds, it
        /// displays information about the new organizational unit.
        /// </summary>
        public static async Task Main()
        {
            // Create the client object using the default account.
            IAmazonOrganizations client = new AmazonOrganizationsClient();

            var orgUnitName = "ProductDevelopmentUnit";

            var request = new CreateOrganizationalUnitRequest
            {
                Name = orgUnitName,
                ParentId = "r-0000",
            };

            var response = await client.CreateOrganizationalUnitAsync(request);

            if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
            {
                Console.WriteLine($"Successfully created organizational unit: {orgUnitName}.");
                Console.WriteLine($"Organizational unit {orgUnitName} Details");
                Console.WriteLine($"ARN: {response.OrganizationalUnit.Arn} Id: {response.OrganizationalUnit.Id}");
            }
            else
            {
                Console.WriteLine("Could not create new organizational unit.");
            }
        }
    }
```
+  Para obter detalhes da API, consulte [CreateOrganizationalUnit](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/CreateOrganizationalUnit)a *Referência AWS SDK para .NET da API*. 

------
#### [ CLI ]

**AWS CLI**  
**Como criar uma unidade organizacional em uma unidade organizacional raiz ou pai**  
O seguinte exemplo mostra como criar uma UO chamada AccountingOU:  

```
aws organizations create-organizational-unit --parent-id r-examplerootid111 --name AccountingOU
```
A saída inclui um objeto organizationalUnit que contém detalhes sobre a nova UO:  

```
{
        "OrganizationalUnit": {
                "Id": "ou-examplerootid111-exampleouid111",
                "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
                "Name": "AccountingOU"
        }
}
```
+  Para obter detalhes da API, consulte [CreateOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-organizational-unit.html)em *Referência de AWS CLI Comandos*. 

------