Collegamento e scollegamento delle policy di rifiuto dei servizi di IA

Puoi utilizzare le policy di rifiuto dei servizi di intelligenza artificiale (IA) su un'intera organizzazione, sulle unità organizzative e sui singoli account. L'ambito di applicazione della policy di rifiuto dei servizi di IA dipende dall'elemento dell'organizzazione a cui lo si collega:

• Quando alleghi una politica di disattivazione dei servizi di intelligenza artificiale alla radice della tua organizzazione, la politica si applica a tutte le unità organizzative e agli account, incluso l'account di gestione.

• Quando colleghi una policy di rifiuto dei servizi di IA a un'unità organizzativa, tale policy si applica agli account appartenenti all'unità organizzativa o a una qualsiasi delle unità organizzative figlie. Questi account sono soggetti anche a qualsiasi policy collegata alla root dell'organizzazione.

• Quando colleghi una policy di rifiuto dei servizi di IA a un account, tale policy si applica solo a tale account. L'account è inoltre soggetto a qualsiasi policy collegata alla root dell'organizzazione e a qualsiasi unità organizzativa a cui appartiene l'account.

L'aggregazione di eventuali policy di rifiuto dei servizi di IA che l'account eredita dal root e dalle unità organizzative padre, nonché le eventuali policy collegate direttamente all'account, formano la policy effettiva. Per informazioni sull'unione delle policy alla policy effettiva, consulta Comprendere l'ereditarietà delle policy di gestione.

Autorizzazioni minime

Per collegare le policy di rifiuto dei servizi di IA, è necessario disporre dell'autorizzazione per le seguenti operazioni:

• organizations:AttachPolicy

AWS Management Console

Per collegare una policy di rifiuto dei servizi di IA, puoi accedere alla policy oppure al root, all'unità organizzativa o all'account a cui vuoi collegare la policy.

Per collegare una policy di rifiuto dei servizi di IA passando dal root, dall'unità organizzativa o dall'account

1. Accedi alla console AWS Organizations. È necessario accedere come utente IAM, assumere un ruolo IAM o accedere come utente root (non consigliato) nell'account di gestione dell'organizzazione.

2. Nella pagina Account AWS, individua e scegli il nome del root, dell'unità organizzativa o dell'account a cui desideri collegare una policy. Potrebbe essere necessario espandere le UO (scegli l'opzione ) per individuare l'UO o l'account desiderato.

3. Nella scheda Policies (Policy), alla voce per AI service opt-out policies (Policy di rifiuto dei servizi di IA), scegli Attach (Collega).

4. Individua la policy desiderata e scegli Attach policy (Collega policy).

   L'elenco delle policy di rifiuto dei servizi di IA collegate nella scheda Policies (Policy) viene aggiornato per includere la nuova aggiunta. La modifica della policy diventa immediatamente effettiva.

Per collegare una policy di rifiuto dei servizi di IA passando dalla policy

1. Accedi alla console AWS Organizations. È necessario accedere come utente IAM, assumere un ruolo IAM o accedere come utente root (non consigliato) nell'account di gestione dell'organizzazione.

2. Nella pagina AI services opt-out policies (Policy di rifiuto dei servizi di IA), scegli il nome della policy che vuoi collegare.

3. Nella scheda Targets (Destinazioni), scegli Attach (Collega).

4. Scegli il pulsante di opzione accanto al root, all'unità organizzativa o all'account a cui vuoi collegare la policy. Potrebbe essere necessario espandere le UO (scegli l'opzione ) per individuare l'UO o l'account desiderato.

5. Scegli Collega policy.

   L'elenco delle policy di rifiuto dei servizi di IA collegate nella scheda Targets (Destinazioni) viene aggiornato per includere la nuova aggiunta. La modifica della policy diventa immediatamente effettiva.

AWS CLI & SDK AWS

Per allegare la politica di disattivazione dei servizi AI dalla radice, dall'unità organizzativa o dall'account dell'organizzazione

I seguenti esempi di codice mostrano come utilizzareAttachPolicy.

.NET

AWS SDK for .NET

Nota

C'è altro da fare GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel Repository di esempi di codice 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.");
            }
        }
    }

• Per i dettagli sull'API, AttachPolicyconsulta AWS SDK for .NET API Reference.

CLI

AWS CLI

Per allegare una policy a una root, a un'unità organizzativa o a un account

Esempio 1

L'esempio seguente mostra come collegare una policy di controllo del servizio (SCP) a un'unità organizzativa:

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

Esempio 2

L'esempio seguente mostra come allegare una politica di controllo del servizio direttamente a un account:

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

• Per i dettagli sull'API, consulta AttachPolicy AWS CLICommand Reference.

Python

SDK per Python (Boto3)

Nota

C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel Repository di esempi di codice 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

• Per i dettagli sull'API, consulta AttachPolicy AWSSDK for Python (Boto3) API Reference.

La modifica della politica ha effetto immediato

Scollegamento di una policy di rifiuto dei servizi di IA

Quando effettui l'accesso all'account di gestione della tua organizzazione, puoi scollegare una policy dal root, dall'unità organizzativa o dall'account a cui è collegata. Dopo avere scollegato una policy di rifiuto dei servizi di IA da un'entità, quella policy non si applica più ad alcun account interessato in precedenza dall'entità ora scollegata. Per distaccare una policy, completa le fasi seguenti.

Autorizzazioni minime

Per scollegare una policy di rifiuto dei servizi di IA dalla root dell'organizzazione, dall'unità organizzativa o dall'account, è necessaria l'autorizzazione per la seguente operazione:

• organizations:DetachPolicy

AWS Management Console

Per scollegare una policy di rifiuto dei servizi di IA, puoi accedere alla policy oppure al root, all'unità organizzativa o all'account da cui vuoi scollegare la policy.

Per scollegare una policy di rifiuto dei servizi di IA passando dal root, dall'unità organizzativa o dall'account

1. Accedi alla console AWS Organizations. È necessario accedere come utente IAM, assumere un ruolo IAM o accedere come utente root (non consigliato) nell'account di gestione dell'organizzazione.

2. Nella pagina Account AWS individua il root, l'unità organizzativa o l'account da cui desideri scollegare una policy. Potrebbe essere necessario espandere le UO (scegli l'opzione ) per individuare l'UO o l'account desiderato. Scegli il nome del root, dell'unità organizzativa o dell'account.

3. Nella scheda Policies (Policy), scegli il pulsante di opzione accanto alla policy di rifiuto dei servizi di IA che desideri scollegare, quindi scegli Detach (Scollega).

4. Nella finestra di dialogo di conferma, scegli Detach policy (Scollega policy).

   L'elenco delle policy di rifiuto dei servizi di IA collegate viene aggiornato. La modifica della policy diventa immediatamente effettiva.

Per scollegare una policy di rifiuto dei servizi di IA passando dalla policy

1. Accedi alla console AWS Organizations. È necessario accedere come utente IAM, assumere un ruolo IAM o accedere come utente root (non consigliato) nell'account di gestione dell'organizzazione.

2. Nella pagina AI services opt-out policies (Policy di rifiuto dei servizi di IA), scegli il nome della policy che vuoi scollegare da un root, un'UO o un account.

3. Nella scheda Targets (Destinazioni), scegli il pulsante di opzione accanto al root, all'unità organizzativa o all'account da cui vuoi scollegare la policy. Potrebbe essere necessario espandere le UO (scegli l'opzione ) per individuare l'UO o l'account desiderato.

4. Seleziona Scollega.

5. Nella finestra di dialogo di conferma, scegli Detach (Scollega).

   L'elenco delle policy di rifiuto dei servizi di IA collegate viene aggiornato. La modifica della policy diventa immediatamente effettiva.

AWS CLI & AWS SDK

Per scollegare una politica di disattivazione dei servizi di intelligenza artificiale dalla radice, dall'unità organizzativa o dall'account dell'organizzazione

I seguenti esempi di codice mostrano come utilizzare. DetachPolicy

.NET

AWS SDK for .NET

Nota

C'è altro da fare GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel Repository di esempi di codice 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.");
            }
        }
    }

• Per i dettagli sull'API, DetachPolicyconsulta AWS SDK for .NET API Reference.

CLI

AWS CLI

Per scollegare una policy da una root, un'unità organizzativa o un account

L'esempio seguente mostra come scollegare una policy da un'unità organizzativa:

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

• Per i dettagli sull'API, vedere DetachPolicyin AWS CLI Command Reference.

Python

SDK per Python (Boto3)

Nota

C'è altro su GitHub. Trova l'esempio completo e scopri di più sulla configurazione e l'esecuzione nel Repository di esempi di codice 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

• Per i dettagli sull'API, consulta DetachPolicy AWSSDK for Python (Boto3) API Reference.

La modifica della policy diventa immediatamente effettiva.