

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Eliminar una unidad organizativa (OU) con AWS Organizations
<a name="delete-ou"></a>

Cuando inicias sesión en la cuenta de administración de tu organización, puedes eliminar las OUs que ya no necesites. 

Primero debe sacar todas las cuentas de la OU y todas las cuentas secundarias y OUs, a continuación, puede eliminarlas OUs.

**Permisos mínimos**  
Para eliminar una unidad organizativa, debe contar con los permisos siguientes:  
`organizations:DescribeOrganization`: solo se requiere cuando se utiliza la consola de Organizations
`organizations:DeleteOrganizationalUnit`

## Consola de administración de AWS
<a name="delete-ou-console"></a>

**Para eliminar una unidad organizativa**

1. Inicie sesión en la [consola de AWS Organizations](https://console.aws.amazon.com/organizations/v2). Debe iniciar sesión como usuario de IAM, asumir un rol de IAM; o iniciar sesión como usuario raíz ([no se recomienda](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)) en la cuenta de administración de la organización.

1. En la **[Cuentas de AWS](https://console.aws.amazon.com/organizations/v2/home/accounts)**página, busque la OUs que desee eliminar y seleccione la casilla de verificación situada ![Blue checkmark icon indicating confirmation or completion of a task.](http://docs.aws.amazon.com/es_es/organizations/latest/userguide/images/checkbox-selected.png) junto al nombre de cada unidad organizativa.

1. Seleccionar **Acciones** y, a continuación, en **Unidad organizativa**, elija **Eliminar**.

1. Para confirmar que desea eliminarlos OUs, introduzca el nombre de la OU (si ha elegido eliminar solo una) o la palabra «eliminar» (si ha elegido más de una) y, a continuación, seleccione **Eliminar**.

   AWS Organizations elimina las OUs y las elimina de la lista.

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

**Eliminación de una unidad organizativa**

Los siguientes ejemplos de código muestran cómo utilizar `DeleteOrganizationalUnit`.

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

**SDK para .NET**  
 Hay más información. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de AWS](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 obtener más información sobre la API, consulta [DeleteOrganizationalUnit](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/DeleteOrganizationalUnit)la *Referencia AWS SDK para .NET de la API*. 

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

**AWS CLI**  
**Eliminación de una unidad organizativa**  
En el ejemplo siguiente se muestra cómo se elimina una OU. En el ejemplo se supone que anteriormente se eliminaron todas las cuentas y otras OUs de la OU:  

```
aws organizations delete-organizational-unit --organizational-unit-id {{ou-examplerootid111-exampleouid111}}
```
+  Para obtener más información sobre la API, consulte [DeleteOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-organizational-unit.html)la *Referencia de AWS CLI comandos*. 

------