Collegamento e scollegamento delle policy di tag - AWS Organizations

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Collegamento e scollegamento delle policy di tag

Puoi utilizzare le policy di tag su un'intera organizzazione, sulle unità organizzative e sui singoli account.

  • Quando colleghi una policy di tag alla root dell'organizzazione, la policy di tag si applica a tutte le unità organizzative e agli account membri della root.

  • Quando colleghi una policy di tag a un'unità organizzativa, la policy viene applicata agli account che appartengono all'unità organizzativa. Questi account sono soggetti anche a qualsiasi policy di tag collegata alla root dell'organizzazione.

  • Quando colleghi una policy di tag a un account, la policy viene applicata all'account. Inoltre, l'account è soggetto a qualsiasi policy di tag collegata alla root dell'organizzazione, oltre a qualsiasi policy di tag collegata a un'unità organizzativa a cui appartiene l'account.

L'aggregazione di tutte le policy di tag ereditate dall'account, oltre a qualsiasi policy di tag direttamente collegata all'account è la policy di tag operativa. Per ulteriori informazioni, consulta Comprendere l'ereditarietà delle policy di gestione.

Importante

Le risorse senza tag non appaiono nei risultati come non conformi.

Autorizzazioni minime

Per collegare le policy di tag, è necessaria l'autorizzazione per la seguente operazione:

  • organizations:AttachPolicy

Puoi collegare una policy di tag accedendo alla policy oppure al root, all'unità organizzativa o all'account a cui vuoi collegare la policy.

Per collegare una policy di tag passando dal root, un'unità organizzativa o un 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 Tag policies (Policy di tag), scegli Attach (Collega).

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

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

Per collegare una policy di tag 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 Tag policies (Policy di tag), scegli il nome della policy che desideri 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 tag collegate nella scheda Targets (Destinazioni) viene aggiornato per includere la nuova aggiunta. La modifica della policy diventa immediatamente effettiva.

Per allegare una politica di tag alla radice, all'unità organizzativa o all'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, consulta la AttachPolicysezione 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
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

Cosa fare in seguito

Dopo avere collegato una policy di tag, puoi verificare quanto le tue risorse sono conformi con la policy di tag. A tale scopo, utilizza la console Resource Groups. Per informazioni, consulta Evaluating Compliance for an Account nella Tagging AWS Resource User Guide.

Scollegamento di una policy di tag

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

Autorizzazioni minime

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

  • organizations:DetachPolicy

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

Per scollegare una policy di tag passando dal root, dall'unità organizzativa o da un account a cui è collegata
  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 tag che desideri scollegare, quindi scegli Detach (Scollega).

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

    L'elenco delle policy di tag collegate viene aggiornato. La modifica della policy diventa immediatamente effettiva.

Per scollegare una policy di tag 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 Tag policies (Policy di tag), 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 tag collegate viene aggiornato. La modifica della policy diventa immediatamente effettiva.

Per scollegare una politica relativa ai tag dalla radice, dall'unità organizzativa o dall'account dell'organizzazione

I seguenti esempi di codice mostrano come utilizzareDetachPolicy.

.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, consulta la DetachPolicysezione 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.