Attachement et détachement de politiques de sauvegarde

Vous pouvez utiliser des politiques de sauvegarde sur l'ensemble d'une organisation ainsi que sur des UO et des comptes individuels. Gardez les points suivants à l'esprit :

• Lorsque vous attachez une politique de sauvegarde à la racine de votre organisation, la politique s'applique à toutes les UO et tous les comptes membres de cette racine.

• Lorsque vous attachez une politique de sauvegarde à une UO, cette politique s'applique aux comptes qui appartiennent à l'UO ou à l'une de ses UO enfants. Ces comptes sont également soumis à toutes les politiques attachées à la racine de l'organisation.

• Lorsque vous attachez une politique de sauvegarde à un compte, cette politique s'applique uniquement à ce compte. Le compte est également soumis à toute politique attachée à la racine de l'organisation et aux UO auxquelles le compte appartient.

L'agrégation de toutes les politiques de sauvegarde que le compte hérite des UO racines et parentes, ainsi que de toutes les politiques directement associées au compte constitue la politique effective. Pour de plus amples informations sur la façon dont les politiques sont fusionnées pour constituer la politique effective, consultez Fonctionnement de l'héritage des politiques de gestion.

Attachement d'une politique de sauvegarde

Lorsque vous êtes connecté au compte de gestion de votre organisation, vous pouvez attacher une politique de sauvegarde à la racine, à l'UO ou directement à un compte de l'organisation.

Autorisations minimales

Pour attacher des politiques de sauvegarde, vous devez avoir l'autorisation d'exécuter l'action suivante :

• organizations:AttachPolicy

AWS Management Console

Vous pouvez attacher une politique de sauvegarde en accédant à la politique ou à la racine, à l'unité d'organisation ou au compte auquel vous souhaitez attacher la politique.

Pour attacher une politique de sauvegarde en accédant à la racine, à l'unité d'organisation ou au compte

1. Connectez-vous à la console AWS Organizations. Vous devez vous connecter en tant qu'utilisateur IAM, assumer un rôle IAM ou vous connecter en tant qu'utilisateur racine (non recommandé) dans le compte de gestion de l'organisation.

2. Dans la page Comptes AWS, accédez au nom de la racine, de l'unité d'organisation ou du compte auquel vous souhaitez attacher une politique et choisissez ce nom. Vous devrez peut-être développer des unités d'organisation (choisissez l'icône ) pour trouver l'UO ou le compte souhaité.

3. Dans l'onglet Politiques, dans Politiques de sauvegarde, choisissez Attacher.

4. Recherchez la politique souhaitée et choisissez Attacher la politique.

   La liste des politiques de sauvegarde attachées sur l'onglet Politiques est mise à jour pour inclure le nouvel ajout. La modification de la politique prend effet immédiatement.

Pour attacher une politique de sauvegarde en accédant à la politique

1. Connectez-vous à la console AWS Organizations. Vous devez vous connecter en tant qu'utilisateur IAM, assumer un rôle IAM ou vous connecter en tant qu'utilisateur racine (non recommandé) dans le compte de gestion de l'organisation.

2. Sur la page Politiques de sauvegarde, choisissez le nom de la politique que vous souhaitez attacher.

3. Dans l'onglet Cibles, choisissez Attacher.

4. Choisissez la case d'option en regard de la racine, de l'unité d'organisation ou du compte auquel vous souhaitez attacher la politique. Vous devrez peut-être développer des unités d'organisation (choisissez l'icône ) pour trouver l'UO ou le compte souhaité.

5. Choisissez Attacher la politique.

   La liste des politiques de sauvegarde attachées sur l'onglet Cibles est mise à jour pour inclure le nouvel ajout. La modification de la politique prend effet immédiatement.

AWS CLI et AWS SDK

Pour associer une politique de sauvegarde à la racine, à l'unité d'organisation ou au compte de l'organisation

Les exemples de code suivants montrent comment utiliserAttachPolicy.

.NET

AWS SDK for .NET

Note

Il y en a plus sur GitHub. Trouvez l'exemple complet et découvrez comment le configurer et l'exécuter dans le référentiel d'exemples de code 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.");
            }
        }
    }

• Pour plus de détails sur l'API, reportez-vous AttachPolicyà la section Référence des AWS SDK for .NET API.

CLI

AWS CLI

Pour associer une politique à une racine, une unité d'organisation ou un compte

Exemple 1

L'exemple suivant montre comment associer une politique de contrôle des services (SCP) à une unité d'organisation :

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

Exemple 2

L'exemple suivant montre comment associer une politique de contrôle des services directement à un compte :

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

• Pour plus de détails sur l'API, reportez-vous AttachPolicyà la section Référence des AWS CLI commandes.

Python

SDK pour Python (Boto3)

Note

Il y en a plus sur GitHub. Trouvez l'exemple complet et découvrez comment le configurer et l'exécuter dans le référentiel d'exemples de code 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

• Pour plus de détails sur l'API, consultez AttachPolicyle AWS manuel de référence de l'API SDK for Python (Boto3).

Le changement de politique prend effet immédiatement

Détachement d'une politique de sauvegarde

Lorsque vous êtes connecté au compte de gestion de votre organisation, vous pouvez détacher une politique de sauvegarde de la racine de l'organisation, de l'UO ou du compte auquel celle-ci est attachée. Une fois que vous avez détaché une politique de sauvegarde d'une entité, cette politique ne s'applique plus à aucun compte qui était affecté par celle-ci. Pour détacher une politique, effectuez les opérations suivantes.

Autorisations minimales

Pour détacher une politique de sauvegarde de la racine de l'organisation, de l'UO ou du compte, vous devez être autorisé à exécuter l'action suivante :

• organizations:DetachPolicy

AWS Management Console

Vous pouvez détacher une politique de sauvegarde en accédant à la politique ou à la racine, à l'unité d'organisation ou au compte dont vous souhaitez détacher la politique.

Pour détacher une politique de sauvegarde en accédant à la racine, à l'unité d'organisation ou au compte auquel elle est attachée

1. Connectez-vous à la console AWS Organizations. Vous devez vous connecter en tant qu'utilisateur IAM, assumer un rôle IAM ou vous connecter en tant qu'utilisateur racine (non recommandé) dans le compte de gestion de l'organisation.

2. Dans la page Comptes AWS, accédez à la racine, à l'unité d'organisation ou au compte dont vous souhaitez détacher une politique. Vous devrez peut-être développer des unités d'organisation (choisissez l'icône ) pour trouver l'UO ou le compte souhaité. Choisissez le nom de la racine, de l'unité d'organisation ou du compte.

3. Dans l'onglet Politiques, choisissez la case d'option en regard de la politique de sauvegarde à détacher, puis choisissez Détacher.

4. Dans la boîte de dialogue de confirmation, choisissez Détacher la politique.

   La liste des politiques de sauvegarde attachées est mise à jour. La modification de la politique prend effet immédiatement.

Pour détacher une politique de sauvegarde en accédant à la politique

1. Connectez-vous à la console AWS Organizations. Vous devez vous connecter en tant qu'utilisateur IAM, assumer un rôle IAM ou vous connecter en tant qu'utilisateur racine (non recommandé) dans le compte de gestion de l'organisation.

2. Dans la page Politiques de sauvegarde, choisissez le nom de la politique que vous souhaitez détacher d'une racine, d'une unité d'organisation ou d'un compte.

3. Dans la page Cibles, choisissez la case d'option en regard de la racine, de l'unité d'organisation ou du compte dont vous souhaitez détacher la politique. Vous devrez peut-être développer des unités d'organisation (choisissez l'icône ) pour trouver l'UO ou le compte souhaité.

4. Choisissez Détacher.

5. Dans la boîte de dialogue de confirmation, choisissez Détacher.

   La liste des politiques de sauvegarde attachées est mise à jour. La modification de la politique prend effet immédiatement.

AWS CLI et AWS SDK

Pour détacher une politique de sauvegarde de la racine, de l'unité d'organisation ou du compte de l'organisation

Les exemples de code suivants montrent comment utiliserDetachPolicy.

.NET

AWS SDK for .NET

Note

Il y en a plus sur GitHub. Trouvez l'exemple complet et découvrez comment le configurer et l'exécuter dans le référentiel d'exemples de code 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.");
            }
        }
    }

• Pour plus de détails sur l'API, reportez-vous DetachPolicyà la section Référence des AWS SDK for .NET API.

CLI

AWS CLI

Pour détacher une politique d'une racine, d'une unité d'organisation ou d'un compte

L'exemple suivant montre comment détacher une politique d'une unité d'organisation :

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

• Pour plus de détails sur l'API, reportez-vous DetachPolicyà la section Référence des AWS CLI commandes.

Python

SDK pour Python (Boto3)

Note

Il y en a plus sur GitHub. Trouvez l'exemple complet et découvrez comment le configurer et l'exécuter dans le référentiel d'exemples de code 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

• Pour plus de détails sur l'API, consultez DetachPolicyle AWS manuel de référence de l'API SDK for Python (Boto3).

La modification de la politique prend effet immédiatement.