Conectar y separar políticas de etiquetas

Puede utilizar las políticas de etiquetas en toda una organización además de en las unidades organizativas (OU) y las cuentas individuales.

• Cuando asocia una política de etiquetas a la raíz de su organización, la política de etiquetas se aplica a todas las cuentas y unidades organizativas de los miembros de la raíz.

• Cuando asocia una política de etiquetas a una unidad organizativa, esa política de etiquetas se aplica a las cuentas que pertenecen a la unidad organizativa. Esas cuentas también están sujetas a cualquier política de etiquetas asocia a la raíz de la organización.

• Cuando asocia una política de etiquetas a una cuenta, esa política de etiquetas se aplica a la cuenta. Además, esa cuenta está sujeta a cualquier política de etiquetas asociada a la raíz de la organización, a parte de a cualquier política de etiquetas asociada a una unidad organizativa a la que pertenece la cuenta.

La agregación de cualquier política de etiquetas que herede la cuenta, además de cualquier política de etiquetas asociada directamente a la cuenta, es la política de etiquetas en vigor. Para obtener más información, consulte Descripción de la herencia de políticas de administración.

importante

Los recursos no etiquetados no aparecen como no conformes en los resultados.

Permisos mínimos

Para asociar políticas de etiquetas, debe tener permiso para ejecutar la siguiente acción:

• organizations:AttachPolicy

AWS Management Console

Puede asociar una política de etiquetas navegando hasta la política o el nodo raíz, unidad organizativa o cuenta a la que desee adjuntar la política.

Para asociar una política de etiquetas navegando hasta el nodo raíz, unidad organizativa o cuenta

1. Inicie sesión en la consola de AWS Organizations. Debe iniciar sesión como usuario de IAM, asumir un rol de IAM; o iniciar sesión como usuario raíz (no se recomienda) en la cuenta de administración de la organización.

2. En la página Cuentas de AWS, busque y seleccione el nombre del nodo raíz, unidad organizativa o cuenta a la que desea asociar la política. Es posible que tenga que expandir las unidades organizativas (elija la opción ) para encontrar la unidad organizativa o la cuenta que desea.

3. En la pestaña Políticas, en la entrada de Políticas de etiquetas, elija Adjuntar.

4. Busque la política que desea y elija Asociar política.

   La lista de políticas de etiquetas asociadas en la pestaña Políticas se actualiza para incluir la nueva adición. El cambio en la política surtirá efecto de inmediato.

Para adjuntar una política de etiquetas navegando a la política

1. Inicie sesión en la consola de AWS Organizations. Debe iniciar sesión como usuario de IAM, asumir un rol de IAM; o iniciar sesión como usuario raíz (no se recomienda) en la cuenta de administración de la organización.

2. En la página Políticas de etiquetas, elija el nombre de la política que desea adjuntar.

3. En la pestaña Objetivos, seleccione Adjuntar.

4. Elija el botón de opción situado junto al nodo raíz, unidad organizativa o cuenta a la que desea adjuntar la política. Es posible que tenga que expandir las unidades organizativas (elija la opción ) para encontrar la unidad organizativa o la cuenta que desea.

5. Elija Asociar política.

   La lista de políticas de etiquetas asociadas en la pestaña Objetivos se actualiza para incluir la nueva adición. El cambio en la política surtirá efecto de inmediato.

AWS CLI y AWS SDK

Para adjuntar una política de etiquetas a la raíz, unidad organizativa o cuenta de la organización

En los siguientes ejemplos de código, se muestra cómo utilizar AttachPolicy.

.NET

AWS SDK for .NET

nota

Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

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

    /// <summary>
    /// Shows how to attach an AWS Organizations policy to an organization,
    /// an organizational unit, or an account.
    /// </summary>
    public class AttachPolicy
    {
        /// <summary>
        /// Initializes the Organizations client object and then calls the
        /// AttachPolicyAsync method to attach the policy to the root
        /// organization.
        /// </summary>
        public static async Task Main()
        {
            IAmazonOrganizations client = new AmazonOrganizationsClient();
            var policyId = "p-00000000";
            var targetId = "r-0000";

            var request = new AttachPolicyRequest
            {
                PolicyId = policyId,
                TargetId = targetId,
            };

            var response = await client.AttachPolicyAsync(request);

            if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
            {
                Console.WriteLine($"Successfully attached Policy ID {policyId} to Target ID: {targetId}.");
            }
            else
            {
                Console.WriteLine("Was not successful in attaching the policy.");
            }
        }
    }

• Para obtener más información sobre la API, consulta AttachPolicyla Referencia AWS SDK for .NET de la API.

CLI

AWS CLI

Asociación de una política a un nodo raíz, unidad organizativa o cuenta

Ejemplo 1

El siguiente ejemplo de código muestra cómo adjuntar una política de control de servicio (SCP) a una unidad organizativa.

aws organizations attach-policy
                --policy-id p-examplepolicyid111
                --target-id ou-examplerootid111-exampleouid111

Ejemplo 2

El siguiente ejemplo de código muestra cómo adjuntar una política de control de servicio directamente a una cuenta:

aws organizations attach-policy
                --policy-id p-examplepolicyid111
                --target-id 333333333333

• Para obtener más información sobre la API, consulta AttachPolicyla Referencia de AWS CLI comandos.

Python

SDK para Python (Boto3)

nota

Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

def attach_policy(policy_id, target_id, orgs_client):
    """
    Attaches a policy to a target. The target is an organization root, account, or
    organizational unit.

    :param policy_id: The ID of the policy to attach.
    :param target_id: The ID of the resources to attach the policy to.
    :param orgs_client: The Boto3 Organizations client.
    """
    try:
        orgs_client.attach_policy(PolicyId=policy_id, TargetId=target_id)
        logger.info("Attached policy %s to target %s.", policy_id, target_id)
    except ClientError:
        logger.exception(
            "Couldn't attach policy %s to target %s.", policy_id, target_id
        )
        raise

• Para obtener más información sobre la API, consulta AttachPolicyla AWS Referencia de API de SDK for Python (Boto3).

El cambio de política entra en vigor de forma inmediata

Qué hacer a continuación

Después de asociar una política de etiquetas, puede averiguar la conformidad de sus recursos con esa política de etiquetas. Para ello, utilice la consola de Resource Groups. Para obtener más información, consulte Evaluación del cumplimiento de una cuenta en la Guía del usuario del AWS recurso de etiquetado.

Desasociación de una política de etiquetas

Cuando inicia sesión en la cuenta de administración de su organización, puede desconectar una política de etiquetas del nodo raíz de la organización, unidad organizativa o cuenta a la que está asociada. Después de desasociar una política de etiquetas de una entidad, dicha política ya no se aplica a ninguna cuenta que estuviera afectada por la entidad ahora desasociada. Para desasociar una política, siga los pasos que se describen a continuación.

Permisos mínimos

Para desasociar una política de etiquetas de la raíz de una organización, unidad organizativa o cuenta, debe tener permiso para ejecutar la siguiente acción:

• organizations:DetachPolicy

AWS Management Console

Puede desconectar una política de etiquetas navegando hasta la política o el nodo raíz, unidad organizativa o cuenta de la que desee desconectar la política.

Para desconectar una política de etiqueta navegando hasta el nodo raíz, unidad organizativa o cuenta a la que está adjunta

1. Inicie sesión en la consola de AWS Organizations. Debe iniciar sesión como usuario de IAM, asumir un rol de IAM; o iniciar sesión como usuario raíz (no se recomienda) en la cuenta de administración de la organización.

2. En la página Cuentas de AWS desplácese hasta el nodo raíz, unidad organizativa o cuenta de la que desea desconectar una política. Es posible que tenga que expandir las unidades organizativas (elija la opción ) para encontrar la unidad organizativa o la cuenta que desea. Elija el nombre del nodo raíz, unidad organizativa o cuenta.

3. En la pestaña Políticas, elija el botón de opción situado junto a la política de etiquetas que desea desconectar y, a continuación, elija Desconectar.

4. En el cuadro de diálogo de confirmación, elija Desconectar política.

   Actualización de la lista de políticas de etiquetas asociadas. El cambio en la política surtirá efecto de inmediato.

Para desconectar una política de etiquetas navegando hasta la política

1. Inicie sesión en la consola de AWS Organizations. Debe iniciar sesión como usuario de IAM, asumir un rol de IAM; o iniciar sesión como usuario raíz (no se recomienda) en la cuenta de administración de la organización.

2. En la página Políticas de etiquetas, elija el nombre de la política que desea desconectar de un nodo raíz, unidad organizativa o cuenta.

3. En la pestaña de Objetivos, elija el botón de opción situado junto al nodo raíz, unidad organizativa o cuenta de la que desea desconectar la política. Es posible que tenga que expandir las unidades organizativas (elija la opción ) para encontrar la unidad organizativa o la cuenta que desea.

4. Elija Desasociar.

5. En el cuadro de diálogo de confirmación, elija Desconectar.

   Actualización de la lista de políticas de etiquetas asociadas. El cambio en la política surtirá efecto de inmediato.

AWS CLI & SDK AWS

Para separar una política de etiquetas de la raíz, la unidad organizativa o la cuenta

En los siguientes ejemplos de código, se muestra cómo utilizar DetachPolicy.

.NET

AWS SDK for .NET

nota

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.

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

    /// <summary>
    /// Shows how to detach a policy from an AWS Organizations organization,
    /// organizational unit, or account.
    /// </summary>
    public class DetachPolicy
    {
        /// <summary>
        /// Initializes the Organizations client object and uses it to call
        /// DetachPolicyAsync to detach the policy.
        /// </summary>
        public static async Task Main()
        {
            // Create the client object using the default account.
            IAmazonOrganizations client = new AmazonOrganizationsClient();

            var policyId = "p-00000000";
            var targetId = "r-0000";

            var request = new DetachPolicyRequest
            {
                PolicyId = policyId,
                TargetId = targetId,
            };

            var response = await client.DetachPolicyAsync(request);

            if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
            {
                Console.WriteLine($"Successfully detached policy with Policy Id: {policyId}.");
            }
            else
            {
                Console.WriteLine("Could not detach the policy.");
            }
        }
    }

• Para obtener más información sobre la API, consulta DetachPolicyla Referencia AWS SDK for .NET de la API.

CLI

AWS CLI

Desasociación de una política de un nodo raíz, unidad organizativa o cuenta

En el siguiente ejemplo se muestra cómo desasociar una política de una unidad organizativa:

aws organizations  detach-policy  --target-id ou-examplerootid111-exampleouid111 --policy-id p-examplepolicyid111

• Para obtener más información sobre la API, consulta DetachPolicyla Referencia de AWS CLI comandos.

Python

SDK para Python (Boto3)

nota

Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el Repositorio de ejemplos de código de AWS.

def detach_policy(policy_id, target_id, orgs_client):
    """
    Detaches a policy from a target.

    :param policy_id: The ID of the policy to detach.
    :param target_id: The ID of the resource where the policy is currently attached.
    :param orgs_client: The Boto3 Organizations client.
    """
    try:
        orgs_client.detach_policy(PolicyId=policy_id, TargetId=target_id)
        logger.info("Detached policy %s from target %s.", policy_id, target_id)
    except ClientError:
        logger.exception(
            "Couldn't detach policy %s from target %s.", policy_id, target_id
        )
        raise

• Para obtener más información sobre la API, consulta DetachPolicyla AWS Referencia de API de SDK for Python (Boto3).

El cambio en la política surtirá efecto de inmediato.