Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). 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. # Ejemplos de código para organizaciones que utilizan AWS SDKs Los siguientes ejemplos de código muestran cómo usarlo AWS Organizations con un kit de desarrollo de AWS software (SDK). Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados. Los *escenarios* son ejemplos de código que muestran cómo llevar a cabo una tarea específica a través de llamadas a varias funciones dentro del servicio o combinado con otros Servicios de AWS. **Más recursos** + **[Guía del usuario de Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)**: más información sobre Organizations. + **[Referencia de la API de Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)**: información sobre todas las acciones de Organizations disponibles. + **[AWS Centro para desarrolladores](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23organizations)**: ejemplos de código que puede filtrar por categoría o por búsqueda de texto completo. + **[AWS Ejemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repositorio con código completo en los idiomas preferidos. Incluye instrucciones para configurar y ejecutar el código. **Contents** + [Conceptos básicos](organizations_code_examples_basics.md) + [Acciones](organizations_code_examples_actions.md) + [`AttachPolicy`](organizations_example_organizations_AttachPolicy_section.md) + [`CreateAccount`](organizations_example_organizations_CreateAccount_section.md) + [`CreateOrganization`](organizations_example_organizations_CreateOrganization_section.md) + [`CreateOrganizationalUnit`](organizations_example_organizations_CreateOrganizationalUnit_section.md) + [`CreatePolicy`](organizations_example_organizations_CreatePolicy_section.md) + [`DeleteOrganization`](organizations_example_organizations_DeleteOrganization_section.md) + [`DeleteOrganizationalUnit`](organizations_example_organizations_DeleteOrganizationalUnit_section.md) + [`DeletePolicy`](organizations_example_organizations_DeletePolicy_section.md) + [`DescribePolicy`](organizations_example_organizations_DescribePolicy_section.md) + [`DetachPolicy`](organizations_example_organizations_DetachPolicy_section.md) + [`ListAccounts`](organizations_example_organizations_ListAccounts_section.md) + [`ListOrganizationalUnitsForParent`](organizations_example_organizations_ListOrganizationalUnitsForParent_section.md) + [`ListPolicies`](organizations_example_organizations_ListPolicies_section.md) + [Escenarios](organizations_code_examples_scenarios.md) + [La política de permisos permite a AWS Compute Optimizer Automation aplicar las acciones recomendadas](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.managed-policies.xml.10_section.md) + [Política de permisos para habilitar la automatización en una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.2_section.md) + [Política de permisos para habilitar la automatización de una cuenta](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.1_section.md) + [Política de permisos para conceder acceso completo a la automatización de Compute Optimizer para una cuenta de administración de una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.5_section.md) + [Política de permisos para conceder acceso completo a Compute Optimizer Automation para cuentas independientes AWS](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.3_section.md) + [Política de permisos para conceder acceso de solo lectura a la automatización de Compute Optimizer para una cuenta de administración de una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.6_section.md) + [Política de permisos para conceder acceso de solo lectura a Compute Optimizer Automation para cuentas independientes AWS](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.4_section.md) + [Política de permisos para conceder permisos de roles vinculados a servicios de la automatización de optimización de cómputo](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.slr-automation.xml.1_section.md) # Ejemplos básicos para las organizaciones que utilizan AWS SDKs Los siguientes ejemplos de código muestran cómo utilizar los conceptos básicos de AWS Organizations with AWS SDKs. **Contents** + [Acciones](organizations_code_examples_actions.md) + [`AttachPolicy`](organizations_example_organizations_AttachPolicy_section.md) + [`CreateAccount`](organizations_example_organizations_CreateAccount_section.md) + [`CreateOrganization`](organizations_example_organizations_CreateOrganization_section.md) + [`CreateOrganizationalUnit`](organizations_example_organizations_CreateOrganizationalUnit_section.md) + [`CreatePolicy`](organizations_example_organizations_CreatePolicy_section.md) + [`DeleteOrganization`](organizations_example_organizations_DeleteOrganization_section.md) + [`DeleteOrganizationalUnit`](organizations_example_organizations_DeleteOrganizationalUnit_section.md) + [`DeletePolicy`](organizations_example_organizations_DeletePolicy_section.md) + [`DescribePolicy`](organizations_example_organizations_DescribePolicy_section.md) + [`DetachPolicy`](organizations_example_organizations_DetachPolicy_section.md) + [`ListAccounts`](organizations_example_organizations_ListAccounts_section.md) + [`ListOrganizationalUnitsForParent`](organizations_example_organizations_ListOrganizationalUnitsForParent_section.md) + [`ListPolicies`](organizations_example_organizations_ListPolicies_section.md) # Actions for Organizations que utilizan AWS SDKs Los siguientes ejemplos de código muestran cómo realizar acciones individuales de Organizations con AWS SDKs. Cada ejemplo incluye un enlace a GitHub, donde puede encontrar instrucciones para configurar y ejecutar el código. Estos fragmentos llaman a la API de Organizations y son fragmentos de código de programas más grandes que deben ejecutarse en contexto. Puede ver las acciones en contexto en [Escenarios para organizaciones que utilizan AWS SDKs](organizations_code_examples_scenarios.md). Los siguientes ejemplos incluyen solo las acciones que se utilizan con mayor frecuencia. Para ver una lista completa, consulte la [Referencia de la API de AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html). **Topics** + [`AttachPolicy`](organizations_example_organizations_AttachPolicy_section.md) + [`CreateAccount`](organizations_example_organizations_CreateAccount_section.md) + [`CreateOrganization`](organizations_example_organizations_CreateOrganization_section.md) + [`CreateOrganizationalUnit`](organizations_example_organizations_CreateOrganizationalUnit_section.md) + [`CreatePolicy`](organizations_example_organizations_CreatePolicy_section.md) + [`DeleteOrganization`](organizations_example_organizations_DeleteOrganization_section.md) + [`DeleteOrganizationalUnit`](organizations_example_organizations_DeleteOrganizationalUnit_section.md) + [`DeletePolicy`](organizations_example_organizations_DeletePolicy_section.md) + [`DescribePolicy`](organizations_example_organizations_DescribePolicy_section.md) + [`DetachPolicy`](organizations_example_organizations_DetachPolicy_section.md) + [`ListAccounts`](organizations_example_organizations_ListAccounts_section.md) + [`ListOrganizationalUnitsForParent`](organizations_example_organizations_ListOrganizationalUnitsForParent_section.md) + [`ListPolicies`](organizations_example_organizations_ListPolicies_section.md) # Úselo `AttachPolicy` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `AttachPolicy`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Shows how to attach an AWS Organizations policy to an organization, /// an organizational unit, or an account. /// public class AttachPolicy { /// /// Initializes the Organizations client object and then calls the /// AttachPolicyAsync method to attach the policy to the root /// organization. /// 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 [AttachPolicy](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/AttachPolicy)la *Referencia AWS SDK para .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 [AttachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/attach-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` 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 [AttachPolicy](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/AttachPolicy)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. lo_org->attachpolicy( iv_policyid = iv_policy_id iv_targetid = iv_target_id ). MESSAGE 'Policy attached to target.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to attach the policy.' TYPE 'E'. CATCH /aws1/cx_orgpolicynotfoundex. MESSAGE 'The specified policy does not exist.' TYPE 'E'. CATCH /aws1/cx_orgtargetnotfoundex. MESSAGE 'The specified target does not exist.' TYPE 'E'. CATCH /aws1/cx_orgduplicateplyatta00. MESSAGE 'The policy is already attached to the target.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [AttachPolicy](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Úselo `CreateAccount` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `CreateAccount`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Creates a new AWS Organizations account. /// public class CreateAccount { /// /// Initializes an Organizations client object and uses it to create /// the new account with the name specified in accountName. /// public static async Task Main() { IAmazonOrganizations client = new AmazonOrganizationsClient(); var accountName = "ExampleAccount"; var email = "someone@example.com"; var request = new CreateAccountRequest { AccountName = accountName, Email = email, }; var response = await client.CreateAccountAsync(request); var status = response.CreateAccountStatus; Console.WriteLine($"The staus of {status.AccountName} is {status.State}."); } } ``` + Para obtener más información sobre la API, consulta [CreateAccount](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/CreateAccount)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Creación de una cuenta de miembro que forme parte automáticamente de la organización** En el siguiente ejemplo se muestra cómo crear una cuenta de miembro en una organización. La cuenta de miembro se configura con el nombre Production Account y la dirección de correo electrónico susan@example.com. Organizations crea automáticamente un rol de IAM con el nombre predeterminado de OrganizationAccountAccessRole porque no se especifica el parámetro roleName. Además, la configuración que permite a los usuarios o roles de IAM con permisos suficientes acceder a los datos de facturación de la cuenta se establece en el valor predeterminado de ALLOW porque no se especifica el IamUserAccessToBilling parámetro. Organizations envía automáticamente a Susan un correo electrónico de AWS bienvenida a: ``` aws organizations create-account --email susan@example.com --account-name "Production Account" ``` La salida incluye un objeto de solicitud que muestra que el estado ahora es `IN_PROGRESS`: ``` { "CreateAccountStatus": { "State": "IN_PROGRESS", "Id": "car-examplecreateaccountrequestid111" } } ``` Más adelante, puede consultar el estado actual de la solicitud proporcionando el valor de respuesta Id al describe-create-account-status comando como valor del create-account-request-id parámetro. Para obtener más información, consulte Crear una AWS cuenta en su organización en la *Guía del AWS usuario de Organizations*. + Para obtener más información sobre la API, consulte [CreateAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-account.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `CreateOrganization` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `CreateOrganization`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Creates an organization in AWS Organizations. /// public class CreateOrganization { /// /// Creates an Organizations client object and then uses it to create /// a new organization with the default user as the administrator, and /// then displays information about the new organization. /// public static async Task Main() { IAmazonOrganizations client = new AmazonOrganizationsClient(); var response = await client.CreateOrganizationAsync(new CreateOrganizationRequest { FeatureSet = "ALL", }); Organization newOrg = response.Organization; Console.WriteLine($"Organization: {newOrg.Id} Main Accoount: {newOrg.MasterAccountId}"); } } ``` + Para obtener más información sobre la API, consulta [CreateOrganization](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/CreateOrganization)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: Creación de una nueva organización** Bill quiere crear una organización con las credenciales de la cuenta 111111111111. En el siguiente ejemplo se muestra que la cuenta se convierte en la cuenta maestra de la nueva organización. Puesto que no especifica un conjunto de características, la nueva organización tiene habilitadas todas las características de forma predeterminada y las políticas de control de servicios están habilitadas en la raíz. ``` aws organizations create-organization ``` El resultado incluye un objeto de organización con detalles sobre la nueva organización: ``` { "Organization": { "AvailablePolicyTypes": [ { "Status": "ENABLED", "Type": "SERVICE_CONTROL_POLICY" } ], "MasterAccountId": "111111111111", "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "MasterAccountEmail": "bill@example.com", "FeatureSet": "ALL", "Id": "o-exampleorgid", "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid" } } ``` **Ejemplo 2: Creación de una nueva organización con solo las características de facturación consolidada habilitadas** En el siguiente ejemplo se crea una organización que solo admite las características de facturación consolidada: ``` aws organizations create-organization --feature-set CONSOLIDATED_BILLING ``` El resultado incluye un objeto de organización con detalles sobre la nueva organización: ``` { "Organization": { "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid", "AvailablePolicyTypes": [], "Id": "o-exampleorgid", "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "MasterAccountEmail": "bill@example.com", "MasterAccountId": "111111111111", "FeatureSet": "CONSOLIDATED_BILLING" } } ``` Para obtener más información, consulte Creación de una organización en la *Guía del usuario de AWS Organizations*. + Para obtener más información sobre la API, consulta [CreateOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-organization.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `CreateOrganizationalUnit` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `CreateOrganizationalUnit`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Creates a new organizational unit in AWS Organizations. /// public class CreateOrganizationalUnit { /// /// Initializes an Organizations client object and then uses it to call /// the CreateOrganizationalUnit method. If the call succeeds, it /// displays information about the new organizational unit. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); var orgUnitName = "ProductDevelopmentUnit"; var request = new CreateOrganizationalUnitRequest { Name = orgUnitName, ParentId = "r-0000", }; var response = await client.CreateOrganizationalUnitAsync(request); if (response.HttpStatusCode == System.Net.HttpStatusCode.OK) { Console.WriteLine($"Successfully created organizational unit: {orgUnitName}."); Console.WriteLine($"Organizational unit {orgUnitName} Details"); Console.WriteLine($"ARN: {response.OrganizationalUnit.Arn} Id: {response.OrganizationalUnit.Id}"); } else { Console.WriteLine("Could not create new organizational unit."); } } } ``` + Para obtener más información sobre la API, consulta [CreateOrganizationalUnit](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/CreateOrganizationalUnit)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Creación de una unidad organizativa en raíz o UO principal** En el siguiente ejemplo se muestra cómo crear una unidad organizativa que se denomina AccountingOU: ``` aws organizations create-organizational-unit --parent-id r-examplerootid111 --name AccountingOU ``` El resultado incluye un objeto organizationalUnit con detalles sobre la nueva unidad organizativa: ``` { "OrganizationalUnit": { "Id": "ou-examplerootid111-exampleouid111", "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111", "Name": "AccountingOU" } } ``` + Para obtener más información sobre la API, consulta [CreateOrganizationalUnit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-organizational-unit.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `CreatePolicy` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `CreatePolicy`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Creates a new AWS Organizations Policy. /// public class CreatePolicy { /// /// Initializes the AWS Organizations client object, uses it to /// create a new Organizations Policy, and then displays information /// about the newly created Policy. /// public static async Task Main() { IAmazonOrganizations client = new AmazonOrganizationsClient(); var policyContent = "{" + " \"Version\": \"2012-10-17\"," + " \"Statement\" : [{" + " \"Action\" : [\"s3:*\"]," + " \"Effect\" : \"Allow\"," + " \"Resource\" : \"*\"" + "}]" + "}"; try { var response = await client.CreatePolicyAsync(new CreatePolicyRequest { Content = policyContent, Description = "Enables admins of attached accounts to delegate all Amazon S3 permissions", Name = "AllowAllS3Actions", Type = "SERVICE_CONTROL_POLICY", }); Policy policy = response.Policy; Console.WriteLine($"{policy.PolicySummary.Name} has the following content: {policy.Content}"); } catch (Exception ex) { Console.WriteLine(ex.Message); } } } ``` + Para obtener más información sobre la API, consulta [CreatePolicy](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/CreatePolicy)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: Creación de una política con un archivo fuente de texto para la política JSON** En el siguiente ejemplo se muestra cómo crear una política de control de servicios (SCP) denominada `AllowAllS3Actions`. El contenido de la política se extrae de un archivo del equipo local denominado `policy.json`. ``` aws organizations create-policy --content file://policy.json --name AllowAllS3Actions, --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions" ``` La salida incluye un objeto de política con detalles sobre la nueva política: ``` { "Policy": { "Content": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}", "PolicySummary": { "Arn": "arn:aws:organizations::o-exampleorgid:policy/service_control_policy/p-examplepolicyid111", "Description": "Allows delegation of all S3 actions", "Name": "AllowAllS3Actions", "Type":"SERVICE_CONTROL_POLICY" } } } ``` **Ejemplo 2: Creación de una política con una política JSON como parámetro** En el siguiente ejemplo se muestra cómo crear el mismo SCP, esta vez integrando el contenido de la política como una cadena JSON en el parámetro. La cadena debe aplicar una secuencia de escape con barras diagonales antes de las comillas dobles para garantizar que se traten como literales en el parámetro, que a su vez queda rodeado de comillas dobles: ``` aws organizations create-policy --content "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}" --name AllowAllS3Actions --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions" ``` Para obtener más información sobre la creación y el uso de políticas en su organización, consulte Administración de políticas de la organización en la *Guía del usuario de AWS Organizations*. + Para obtener más información sobre la API, consulta [CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/create-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` def create_policy(name, description, content, policy_type, orgs_client): """ Creates a policy. :param name: The name of the policy. :param description: The description of the policy. :param content: The policy content as a dict. This is converted to JSON before it is sent to AWS. The specific format depends on the policy type. :param policy_type: The type of the policy. :param orgs_client: The Boto3 Organizations client. :return: The newly created policy. """ try: response = orgs_client.create_policy( Name=name, Description=description, Content=json.dumps(content), Type=policy_type, ) policy = response["Policy"] logger.info("Created policy %s.", name) except ClientError: logger.exception("Couldn't create policy %s.", name) raise else: return policy ``` + Para obtener más información sobre la API, consulta [CreatePolicy](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/CreatePolicy)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. oo_result = lo_org->createpolicy( " oo_result is returned for testing purposes. " iv_name = iv_policy_name iv_description = iv_policy_description iv_content = iv_policy_content iv_type = iv_policy_type ). MESSAGE 'Policy created.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to create a policy.' TYPE 'E'. CATCH /aws1/cx_orgduplicatepolicyex. MESSAGE 'A policy with this name already exists.' TYPE 'E'. CATCH /aws1/cx_orgmalformedplydocex. MESSAGE 'The policy content is malformed.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [CreatePolicy](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Úselo `DeleteOrganization` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DeleteOrganization`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Shows how to delete an existing organization using the AWS /// Organizations Service. /// public class DeleteOrganization { /// /// Initializes the Organizations client and then calls /// DeleteOrganizationAsync to delete the organization. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); var response = await client.DeleteOrganizationAsync(new DeleteOrganizationRequest()); if (response.HttpStatusCode == System.Net.HttpStatusCode.OK) { Console.WriteLine("Successfully deleted organization."); } else { Console.WriteLine("Could not delete organization."); } } } ``` + Para obtener más información sobre la API, consulta [DeleteOrganization](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/DeleteOrganization)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Eliminación de una organización** En el siguiente ejemplo se muestra cómo eliminar una organización. Para realizar esta operación, debe ser administrador de la cuenta maestra de la organización. En el ejemplo se supone que previamente eliminaste todas las cuentas y políticas de los miembros de la organización: OUs ``` aws organizations delete-organization ``` + Para obtener más información sobre la API, consulte [DeleteOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-organization.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `DeleteOrganizationalUnit` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DeleteOrganizationalUnit`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Shows how to delete an existing AWS Organizations organizational unit. /// public class DeleteOrganizationalUnit { /// /// Initializes the Organizations client object and calls /// DeleteOrganizationalUnitAsync to delete the organizational unit /// with the selected ID. /// 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*. ------ # Úselo `DeletePolicy` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DeletePolicy`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Deletes an existing AWS Organizations policy. /// public class DeletePolicy { /// /// Initializes the Organizations client object and then uses it to /// delete the policy with the specified policyId. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); var policyId = "p-00000000"; var request = new DeletePolicyRequest { PolicyId = policyId, }; var response = await client.DeletePolicyAsync(request); if (response.HttpStatusCode == System.Net.HttpStatusCode.OK) { Console.WriteLine($"Successfully deleted Policy: {policyId}."); } else { Console.WriteLine($"Could not delete Policy: {policyId}."); } } } ``` + Para obtener más información sobre la API, consulta [DeletePolicy](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/DeletePolicy)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Eliminación de una política** En el siguiente ejemplo se muestra cómo eliminar una política de una organización. En el ejemplo se asume que anteriormente se ha desvinculado la política de todas las entidades: ``` aws organizations delete-policy --policy-id p-examplepolicyid111 ``` + Para obtener más información sobre la API, consulta [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/delete-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` def delete_policy(policy_id, orgs_client): """ Deletes a policy. :param policy_id: The ID of the policy to delete. :param orgs_client: The Boto3 Organizations client. """ try: orgs_client.delete_policy(PolicyId=policy_id) logger.info("Deleted policy %s.", policy_id) except ClientError: logger.exception("Couldn't delete policy %s.", policy_id) raise ``` + Para obtener más información sobre la API, consulta [DeletePolicy](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/DeletePolicy)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. lo_org->deletepolicy( iv_policyid = iv_policy_id ). MESSAGE 'Policy deleted.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to delete the policy.' TYPE 'E'. CATCH /aws1/cx_orgpolicynotfoundex. MESSAGE 'The specified policy does not exist.' TYPE 'E'. CATCH /aws1/cx_orgpolicyinuseex. MESSAGE 'The policy is still attached to one or more targets.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [DeletePolicy](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Úselo `DescribePolicy` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DescribePolicy`. ------ #### [ CLI ] **AWS CLI** **Obtención de información acerca de una política** En el siguiente ejemplo se muestra cómo solicitar información acerca de una política: ``` aws organizations describe-policy --policy-id p-examplepolicyid111 ``` El resultado incluye un objeto de política que contiene detalles acerca de la política: ``` { "Policy": { "Content": "{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"*\",\n \"Resource\": \"*\"\n }\n ]\n}", "PolicySummary": { "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111", "Type": "SERVICE_CONTROL_POLICY", "Id": "p-examplepolicyid111", "AwsManaged": false, "Name": "AllowAllS3Actions", "Description": "Enables admins to delegate S3 permissions" } } } ``` + Para obtener más información sobre la API, consulte [DescribePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/describe-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` def describe_policy(policy_id, orgs_client): """ Describes a policy. :param policy_id: The ID of the policy to describe. :param orgs_client: The Boto3 Organizations client. :return: The description of the policy. """ try: response = orgs_client.describe_policy(PolicyId=policy_id) policy = response["Policy"] logger.info("Got policy %s.", policy_id) except ClientError: logger.exception("Couldn't get policy %s.", policy_id) raise else: return policy ``` + Para obtener más información sobre la API, consulta [DescribePolicy](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/DescribePolicy)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. oo_result = lo_org->describepolicy( " oo_result is returned for testing purposes. " iv_policyid = iv_policy_id ). DATA(lo_policy) = oo_result->get_policy( ). MESSAGE 'Retrieved policy details.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to describe the policy.' TYPE 'E'. CATCH /aws1/cx_orgpolicynotfoundex. MESSAGE 'The specified policy does not exist.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [DescribePolicy](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Úselo `DetachPolicy` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `DetachPolicy`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Shows how to detach a policy from an AWS Organizations organization, /// organizational unit, or account. /// public class DetachPolicy { /// /// Initializes the Organizations client object and uses it to call /// DetachPolicyAsync to detach the policy. /// 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 [DetachPolicy](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/DetachPolicy)la *Referencia AWS SDK para .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 [DetachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/detach-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` 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 [DetachPolicy](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/DetachPolicy)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. lo_org->detachpolicy( iv_policyid = iv_policy_id iv_targetid = iv_target_id ). MESSAGE 'Policy detached from target.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to detach the policy.' TYPE 'E'. CATCH /aws1/cx_orgpolicynotfoundex. MESSAGE 'The specified policy does not exist.' TYPE 'E'. CATCH /aws1/cx_orgtargetnotfoundex. MESSAGE 'The specified target does not exist.' TYPE 'E'. CATCH /aws1/cx_orgpolicynotattex. MESSAGE 'The policy is not attached to the target.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [DetachPolicy](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Úselo `ListAccounts` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `ListAccounts`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Uses the AWS Organizations service to list the accounts associated /// with the default account. /// public class ListAccounts { /// /// Creates the Organizations client and then calls its /// ListAccountsAsync method. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); var request = new ListAccountsRequest { MaxResults = 5, }; var response = new ListAccountsResponse(); try { do { response = await client.ListAccountsAsync(request); response.Accounts.ForEach(a => DisplayAccounts(a)); if (response.NextToken is not null) { request.NextToken = response.NextToken; } } while (response.NextToken is not null); } catch (AWSOrganizationsNotInUseException ex) { Console.WriteLine(ex.Message); } } /// /// Displays information about an Organizations account. /// /// An Organizations account for which to display /// information on the console. private static void DisplayAccounts(Account account) { string accountInfo = $"{account.Id} {account.Name}\t{account.Status}"; Console.WriteLine(accountInfo); } } ``` + Para obtener más información sobre la API, consulta [ListAccounts](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/ListAccounts)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Para recuperar una lista de todas las cuentas de una organización** En el siguiente ejemplo se muestra cómo solicitar una lista de las cuentas de una organización: ``` aws organizations list-accounts ``` La salida incluye una lista de objetos de resumen de cuenta. ``` { "Accounts": [ { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481830215.45, "Id": "111111111111", "Name": "Master Account", "Email": "bill@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/222222222222", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835741.044, "Id": "222222222222", "Name": "Production Account", "Email": "alice@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835795.536, "Id": "333333333333", "Name": "Development Account", "Email": "juan@example.com", "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444", "JoinedMethod": "INVITED", "JoinedTimestamp": 1481835812.143, "Id": "444444444444", "Name": "Test Account", "Email": "anika@example.com", "Status": "ACTIVE" } ] } ``` + Para obtener más información sobre la API, consulta [ListAccounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-accounts.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `ListOrganizationalUnitsForParent` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `ListOrganizationalUnitsForParent`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Lists the AWS Organizations organizational units that belong to an /// organization. /// public class ListOrganizationalUnitsForParent { /// /// Initializes the Organizations client object and then uses it to /// call the ListOrganizationalUnitsForParentAsync method to retrieve /// the list of organizational units. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); var parentId = "r-0000"; var request = new ListOrganizationalUnitsForParentRequest { ParentId = parentId, MaxResults = 5, }; var response = new ListOrganizationalUnitsForParentResponse(); try { do { response = await client.ListOrganizationalUnitsForParentAsync(request); response.OrganizationalUnits.ForEach(u => DisplayOrganizationalUnit(u)); if (response.NextToken is not null) { request.NextToken = response.NextToken; } } while (response.NextToken is not null); } catch (Exception ex) { Console.WriteLine(ex.Message); } } /// /// Displays information about an Organizations organizational unit. /// /// The OrganizationalUnit for which to display /// information. public static void DisplayOrganizationalUnit(OrganizationalUnit unit) { string accountInfo = $"{unit.Id} {unit.Name}\t{unit.Arn}"; Console.WriteLine(accountInfo); } } ``` + Para obtener más información sobre la API, consulta [ListOrganizationalUnitsForParent](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/ListOrganizationalUnitsForParent)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Para recuperar una lista de las que se encuentran OUs en una unidad organizativa o raíz principal** El siguiente ejemplo muestra cómo obtener una lista de OUs en una raíz específica: ``` aws organizations list-organizational-units-for-parent --parent-id r-examplerootid111 ``` El resultado muestra que la raíz especificada contiene dos OUs y muestra los detalles de cada una: ``` { "OrganizationalUnits": [ { "Name": "AccountingDepartment", "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid111" }, { "Name": "ProductionDepartment", "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid222" } ] } ``` + Para obtener más información sobre la API, consulte [ListOrganizationalUnitsForParent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-organizational-units-for-parent.html)la *Referencia de AWS CLI comandos*. ------ # Úselo `ListPolicies` con un AWS SDK o CLI Los siguientes ejemplos de código muestran cómo utilizar `ListPolicies`. ------ #### [ .NET ] **SDK para .NET** Hay más en marcha 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; /// /// Shows how to list the AWS Organizations policies associated with an /// organization. /// public class ListPolicies { /// /// Initializes an Organizations client object, and then calls its /// ListPoliciesAsync method. /// public static async Task Main() { // Create the client object using the default account. IAmazonOrganizations client = new AmazonOrganizationsClient(); // The value for the Filter parameter is required and must must be // one of the following: // AISERVICES_OPT_OUT_POLICY // BACKUP_POLICY // SERVICE_CONTROL_POLICY // TAG_POLICY var request = new ListPoliciesRequest { Filter = "SERVICE_CONTROL_POLICY", MaxResults = 5, }; var response = new ListPoliciesResponse(); try { do { response = await client.ListPoliciesAsync(request); response.Policies.ForEach(p => DisplayPolicies(p)); if (response.NextToken is not null) { request.NextToken = response.NextToken; } } while (response.NextToken is not null); } catch (AWSOrganizationsNotInUseException ex) { Console.WriteLine(ex.Message); } } /// /// Displays information about the Organizations policies associated /// with an organization. /// /// An Organizations policy summary to display /// information on the console. private static void DisplayPolicies(PolicySummary policy) { string policyInfo = $"{policy.Id} {policy.Name}\t{policy.Description}"; Console.WriteLine(policyInfo); } } ``` + Para obtener más información sobre la API, consulta [ListPolicies](https://docs.aws.amazon.com/goto/DotNetSDKV3/organizations-2016-11-28/ListPolicies)la *Referencia AWS SDK para .NET de la API*. ------ #### [ CLI ] **AWS CLI** **Recuperación de una lista de todas las políticas de una organización de un tipo determinado** En el siguiente ejemplo, se muestra cómo obtener una lista de SCPs, tal como se especifica en el parámetro de filtro: ``` aws organizations list-policies --filter SERVICE_CONTROL_POLICY ``` La salida incluye una lista de políticas con información resumida: ``` { "Policies": [ { "Type": "SERVICE_CONTROL_POLICY", "Name": "AllowAllS3Actions", "AwsManaged": false, "Id": "p-examplepolicyid111", "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid111", "Description": "Enables account admins to delegate permissions for any S3 actions to users and roles in their accounts." }, { "Type": "SERVICE_CONTROL_POLICY", "Name": "AllowAllEC2Actions", "AwsManaged": false, "Id": "p-examplepolicyid222", "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid222", "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts." }, { "AwsManaged": true, "Description": "Allows access to every operation", "Type": "SERVICE_CONTROL_POLICY", "Id": "p-FullAWSAccess", "Arn": "arn:aws:organizations::aws:policy/service_control_policy/p-FullAWSAccess", "Name": "FullAWSAccess" } ] } ``` + Para obtener más información sobre la API, consulte [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/organizations/list-policies.html)la *Referencia de AWS CLI comandos*. ------ #### [ Python ] **SDK para Python (Boto3)** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/organizations#code-examples). ``` def list_policies(policy_filter, orgs_client): """ Lists the policies for the account, limited to the specified filter. :param policy_filter: The kind of policies to return. :param orgs_client: The Boto3 Organizations client. :return: The list of policies found. """ try: response = orgs_client.list_policies(Filter=policy_filter) policies = response["Policies"] logger.info("Found %s %s policies.", len(policies), policy_filter) except ClientError: logger.exception("Couldn't get %s policies.", policy_filter) raise else: return policies ``` + Para obtener más información sobre la API, consulta [ListPolicies](https://docs.aws.amazon.com/goto/boto3/organizations-2016-11-28/ListPolicies)la *AWS Referencia de API de SDK for Python (Boto3*). ------ #### [ SAP ABAP ] **SDK para SAP ABAP** 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/org#code-examples). ``` TRY. oo_result = lo_org->listpolicies( " oo_result is returned for testing purposes. " iv_filter = iv_filter ). DATA(lt_policies) = oo_result->get_policies( ). MESSAGE 'Retrieved list of policies.' TYPE 'I'. CATCH /aws1/cx_orgaccessdeniedex. MESSAGE 'You do not have permission to list policies.' TYPE 'E'. CATCH /aws1/cx_orgawsorgsnotinuseex. MESSAGE 'Your account is not a member of an organization.' TYPE 'E'. ENDTRY. ``` + Para obtener más información sobre la API, consulte [ListPolicies](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*. ------ # Escenarios para organizaciones que utilizan AWS SDKs Los siguientes ejemplos de código muestran cómo implementar escenarios comunes en Organizations with AWS SDKs. Estos escenarios muestran cómo llevar a cabo tareas específicas con llamadas a varias funciones dentro de Organizations o en combinación con otros Servicios de AWS. En cada escenario se incluye un enlace al código fuente completo, con instrucciones de configuración y ejecución del código. Los escenarios requieren un nivel intermedio de experiencia para entender las acciones de servicio en su contexto. **Topics** + [La política de permisos permite a AWS Compute Optimizer Automation aplicar las acciones recomendadas](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.managed-policies.xml.10_section.md) + [Política de permisos para habilitar la automatización en una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.2_section.md) + [Política de permisos para habilitar la automatización de una cuenta](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.1_section.md) + [Política de permisos para conceder acceso completo a la automatización de Compute Optimizer para una cuenta de administración de una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.5_section.md) + [Política de permisos para conceder acceso completo a Compute Optimizer Automation para cuentas independientes AWS](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.3_section.md) + [Política de permisos para conceder acceso de solo lectura a la automatización de Compute Optimizer para una cuenta de administración de una organización](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.6_section.md) + [Política de permisos para conceder acceso de solo lectura a Compute Optimizer Automation para cuentas independientes AWS](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.automation.xml.4_section.md) + [Política de permisos para conceder permisos de roles vinculados a servicios de la automatización de optimización de cómputo](organizations_example_iam-policies.AWSMettleDocs.latest.userguide.slr-automation.xml.1_section.md) # Permite que la función de AWS Compute Optimizer automatización aplique las acciones recomendadas El siguiente ejemplo de código muestra cómo: esta política basada en permisos permite que la función de AWS Compute Optimizer automatización aplique las acciones recomendadas ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "aco-automation.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ # Política para habilitar la automatización en una organización En el siguiente ejemplo de código se muestra cómo esta política basada en permisos habilita la automatización en su organización. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation", "Condition": {"StringLike": {"iam:AWSServiceName": "aco-automation.amazonaws.com"}} }, { "Effect": "Allow", "Action": [ "iam:PutRolePolicy", "iam:AttachRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation" }, { "Effect": "Allow", "Action": "aco-automation:UpdateEnrollmentConfiguration", "Resource": "*" }, { "Effect": "Allow", "Action": "aco-automation:AssociateAccounts", "Resource": "*" }, { "Effect": "Allow", "Action": "aco-automation:DisassociateAccounts", "Resource": "*" }, { "Effect": "Allow", "Action": "aco-automation:ListAccounts", "Resource": "*" } ] } ``` ------ # Política para habilitar la automatización de una cuenta En el siguiente ejemplo de código se muestra cómo esta política basada en permisos habilita la automatización de su cuenta. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation", "Condition": {"StringLike": {"iam:AWSServiceName": "aco-automation.amazonaws.com"}} }, { "Effect": "Allow", "Action": [ "iam:PutRolePolicy", "iam:AttachRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation" }, { "Effect": "Allow", "Action": "aco-automation:UpdateEnrollmentConfiguration", "Resource": "*" } ] } ``` ------ # Política para conceder acceso completo a la automatización de Compute Optimizer para una cuenta de administración de una organización En el siguiente ejemplo de código se muestra cómo esta política basada en permisos otorga acceso completo a la automatización de Compute Optimizer para una cuenta de administración de una organización. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aco-automation:*", "ec2:DescribeVolumes", "organizations:ListAccounts", "organizations:DescribeOrganization", "organizations:DescribeAccount", "organizations:EnableAWSServiceAccess", "organizations:ListDelegatedAdministrators", "organizations:RegisterDelegatedAdministrator", "organizations:DeregisterDelegatedAdministrator" ], "Resource": "*" } ] } ``` ------ # Política para otorgar acceso completo a Compute Optimizer Automation para cuentas independientes AWS El siguiente ejemplo de código muestra cómo: Esta política basada en permisos otorga acceso completo a Compute Optimizer Automation para cuentas independientes. AWS ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aco-automation:*", "ec2:DescribeVolumes" ], "Resource": "*" } ] } ``` ------ # Política para conceder acceso de solo lectura a la automatización de Compute Optimizer para una cuenta de administración de una organización En el siguiente ejemplo de código se muestra cómo esta política basada en permisos otorga acceso de solo lectura a la automatización de Compute Optimizer para una cuenta de administración de una organización. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aco-automation:GetEnrollmentConfiguration", "aco-automation:GetAutomationEvent", "aco-automation:GetAutomationRule", "aco-automation:ListAccounts", "aco-automation:ListAutomationEvents", "aco-automation:ListAutomationEventSteps", "aco-automation:ListAutomationEventSummaries", "aco-automation:ListAutomationRules", "aco-automation:ListAutomationRulePreview", "aco-automation:ListAutomationRulePreviewSummaries", "aco-automation:ListRecommendedActions", "aco-automation:ListRecommendedActionSummaries", "aco-automation:ListTagsForResource", "ec2:DescribeVolumes" ], "Resource": "*" } ] } ``` ------ # Política para conceder acceso de solo lectura a Compute Optimizer Automation para cuentas independientes AWS El siguiente ejemplo de código muestra cómo: Esta política basada en permisos otorga acceso de solo lectura a Compute Optimizer Automation para cuentas independientes. AWS ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aco-automation:GetEnrollmentConfiguration", "aco-automation:GetAutomationEvent", "aco-automation:GetAutomationRule", "aco-automation:ListAutomationEvents", "aco-automation:ListAutomationEventSteps", "aco-automation:ListAutomationEventSummaries", "aco-automation:ListAutomationRules", "aco-automation:ListAutomationRulePreview", "aco-automation:ListAutomationRulePreviewSummaries", "aco-automation:ListRecommendedActions", "aco-automation:ListRecommendedActionSummaries", "aco-automation:ListTagsForResource", "ec2:DescribeVolumes" ], "Resource": "*" } ] } ``` ------ # Política para conceder permisos de roles vinculados a servicios de la automatización de optimización de cómputo En el siguiente ejemplo de código se muestra cómo esta política basada en permisos otorga permisos de roles vinculados a servicios para la automatización de optimización de cómputo. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation", "Condition": {"StringLike": {"iam:AWSServiceName": "aco-automation.amazonaws.com"}} }, { "Effect": "Allow", "Action": "iam:PutRolePolicy", "Resource": "arn:aws:iam::*:role/aws-service-role/aco-automation.amazonaws.com/AWSServiceRoleForComputeOptimizerAutomation" } ] } ``` ------