

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á.

# Excluindo uma unidade organizacional (OU) com AWS Organizations
<a name="delete-ou"></a>

Ao entrar na conta de gerenciamento da sua organização, você pode excluir qualquer uma OUs que não seja mais necessária. 

Primeiro, você deve remover todas as contas da OU e de qualquer criança e OUs, em seguida, excluir a criança OUs.

**Permissões mínimas**  
Para excluir uma UO, você precisa ter as seguintes permissões:  
`organizations:DescribeOrganization` – necessária somente ao usar o console do Organizations
`organizations:DeleteOrganizationalUnit`

## Console de gerenciamento da AWS
<a name="delete-ou-console"></a>

**Para excluir uma UO**

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. Na **[Contas da AWS](https://console.aws.amazon.com/organizations/v2/home/accounts)**página, localize o OUs que você deseja excluir e escolha a caixa de seleção ![Blue checkmark icon indicating confirmation or completion of a task.](http://docs.aws.amazon.com/pt_br/organizations/latest/userguide/images/checkbox-selected.png) ao lado do nome de cada OU.

1. Selecione **Actions (Ações)** e, em **Organizational unit (Unidade organizacional)**, escolha **Delete (Excluir)**.

1. Para confirmar que você deseja excluir o OUs, insira o nome da OU (se você optou por excluir somente uma) ou a palavra 'excluir' (se você escolheu mais de uma) e escolha **Excluir**.

   AWS Organizations exclui os OUs e os remove da lista.

## AWS CLI & AWS SDKs
<a name="delete-ou-cli-sdk"></a>

**Como excluir uma UO**

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

------
#### [ .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>
    /// Shows how to delete an existing AWS Organizations organizational unit.
    /// </summary>
    public class DeleteOrganizationalUnit
    {
        /// <summary>
        /// Initializes the Organizations client object and calls
        /// DeleteOrganizationalUnitAsync to delete the organizational unit
        /// with the selected ID.
        /// </summary>
        public static async Task Main()
        {
            // Create the client object using the default account.
            IAmazonOrganizations client = new AmazonOrganizationsClient();

            var orgUnitId = "ou-0000-00000000";

            var request = new DeleteOrganizationalUnitRequest
            {
                OrganizationalUnitId = orgUnitId,
            };

            var response = await client.DeleteOrganizationalUnitAsync(request);

            if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
            {
                Console.WriteLine($"Successfully deleted the organizational unit with ID: {orgUnitId}.");
            }
            else
            {
                Console.WriteLine($"Could not delete the organizational unit with ID: {orgUnitId}.");
            }
        }
    }
```
+  Para obter detalhes da API, consulte [DeleteOrganizationalUnit](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/DeleteOrganizationalUnit)a *Referência AWS SDK para .NET da API*. 

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

**AWS CLI**  
**Como excluir uma UO**  
O exemplo a seguir mostra como excluir uma UO. O exemplo pressupõe que você removeu anteriormente todas as contas e outras OUs da OU:  

```
aws organizations delete-organizational-unit --organizational-unit-id {{ou-examplerootid111-exampleouid111}}
```
+  Para obter detalhes da API, consulte [DeleteOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-organizational-unit.html)em *Referência de AWS CLI Comandos*. 

------