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. # `AWSSupport-CopyEC2Instance` **Descripción** El `AWSSupport-CopyEC2Instance` manual proporciona una solución automatizada para el procedimiento descrito en el artículo del Knowledge Center [¿Cómo muevo mi EC2 instancia a otra subred, zona de disponibilidad o VPC](https://aws.amazon.com/premiumsupport/knowledge-center/move-ec2-instance/)? La automatización se ramifica en función de los valores que especifique para los parámetros `Region` y `SubnetId`. Si especificas un valor para el `SubnetId` parámetro pero no un valor para el `Region` parámetro, la automatización crea un Amazon Machine Image (AMI) de la instancia de destino y lanza una nueva instancia desde AMI en la subred que especificó. Si especifica un valor para el `SubnetId` parámetro y el `Region` parámetro, la automatización crea un AMI de la instancia de destino, copia el AMI a la Región de AWS que especificó y lanza una nueva instancia desde AMI en la subred que especificó. Si especifica un valor para el `Region` parámetro pero no un valor para el `SubnetId` parámetro, la automatización crea un AMI de la instancia de destino, copia el AMI a la región que especificó y lanza una nueva instancia desde AMI en la subred predeterminada de su nube privada virtual (VPC) en la región de destino. Si no se especifica ningún valor para los `SubnetId` parámetros `Region` o, la automatización crea un AMI de la instancia de destino y lanza una nueva instancia desde AMI en la subred predeterminada de la VPC. Para copiar una AMI a una región diferente, debe proporcionar un valor para el `AutomationAssumeRole` parámetro. Si se agota el tiempo de espera de la automatización durante el `waitForAvailableDestinationAmi` paso, AMI puede que todavía esté copiando. En este caso puede esperar a que se complete la copia y lanzar la instancia manualmente. Antes de ejecutar esta automatización, tenga en cuenta lo siguiente: + AMILas se basan en instantáneas de Amazon Elastic Block Store (Amazon EBS). Para sistemas de archivos de gran tamaño sin una instantánea previa, AMI la creación puede tardar varias horas. Para disminuir el AMI hora de creación, cree una instantánea de Amazon EBS antes de crear el AMI. + Creando un AMI no crea una instantánea, por ejemplo, almacena volúmenes en la instancia. Para obtener información sobre cómo hacer copias de seguridad de los volúmenes del almacén de instancias en Amazon EBS, consulte [¿Cómo hago una copia de seguridad de un volumen de almacén de instancias de mi EC2 instancia de Amazon en Amazon EBS](https://aws.amazon.com/premiumsupport/knowledge-center/back-up-instance-store-ebs/)? + La nueva EC2 instancia de Amazon tiene una dirección IPv6 IP pública IPv4 o privada diferente. Debe actualizar todas las referencias a las direcciones IP antiguas (por ejemplo, en las entradas de DNS) con las nuevas direcciones IP asignadas a la nueva instancia. Si utiliza una dirección IP elástica en la instancia de origen, asegúrese de adjuntarla a la nueva instancia. + Se pueden producir problemas con el identificador de seguridad de dominio (SID) cuando la copia se lanza e intenta contactar con el dominio. Antes de capturar la AMI, utilice Sysprep o elimine la instancia unida al dominio del dominio para evitar problemas de conflicto. Para obtener más información, consulte [¿Cómo puedo usar Sysprep para crear e instalar Windows reutilizable personalizado? AMIs](https://aws.amazon.com/premiumsupport/knowledge-center/sysprep-create-install-ec2-windows-amis/) [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CopyEC2Instance) **importante** No recomendamos usar este manual de procedimientos para copiar instancias del controlador de dominio de Microsoft Active Directory. **Tipo de documento** Automatización **Propietario** Amazon **Plataformas** Linux, macOS, Windows **Parámetros** + AutomationAssumeRole Tipo: cadena Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos. + InstanceId Tipo: cadena Descripción: (obligatorio) ID de la instancia de que desea reiniciar. + KeyPair Tipo: cadena Descripción: (opcional) el par de claves que desea asociar con la nueva instancia copiada. Si va a copiar la instancia a una región diferente, asegúrese de que el par de claves existe en la región especificada. + Región Tipo: cadena Descripción: (opcional) la región a la que quiere copiar la instancia. Si especifica un valor para este parámetro, pero no especifica valores para los parámetros `SubnetId` y `SecurityGroupIds`, la automatización intentará lanzar la instancia en la VPC predeterminada con el grupo de seguridad predeterminado. Si EC2 -Classic está activado en la región de destino, el lanzamiento fallará. + SubnetId Tipo: cadena Descripción: (opcional) el ID de la subred en la que desea copiar la instancia. Si EC2 -Classic está activado en la región de destino, debe proporcionar un valor para este parámetro. + InstanceType Tipo: cadena Descripción: (opcional) el tipo de instancia que se va iniciar como instancia copiada. Si no especifica un valor para este parámetro, se utiliza el tipo de instancia de origen. Si el tipo de instancia de origen no es compatible con la región en la que se está copiando la instancia, se produce un error en la automatización. + SecurityGroupIds Tipo: cadena Descripción: (opcional) Una lista separada por comas del grupo de seguridad IDs que desea asociar a la instancia copiada. Si no especifica un valor para este parámetro y la instancia no se copia en una región diferente, se utilizan los grupos de seguridad asociados a la instancia de origen. Si va a copiar la instancia a una región diferente, se utiliza el grupo de seguridad predeterminado para la VPC predeterminada de la región de destino. + KeepImageSourceRegion Tipo: Booleano Valores válidos: true \$1 false Predeterminado: true Descripción: (opcional) Si especifica `true` este parámetro, la automatización no elimina el AMI de la instancia de origen. Si especifica `false` este parámetro, la automatización anula el registro del AMI y elimina las instantáneas asociadas. + KeepImageDestinationRegion Tipo: Booleano Valores válidos: true \$1 false Predeterminado: true Descripción: (opcional) Si especifica `true` este parámetro, la automatización no elimina el AMI que se copia en la región que especificó. Si especifica `false` este parámetro, la automatización anula el registro del AMI y elimina las instantáneas asociadas. + NoRebootInstanceBeforeTakingImage Tipo: Booleano Valores válidos: true \$1 false Predeterminado: false Descripción: (opcional) Si especifica `true` este parámetro, la instancia de origen no se reiniciará antes de crear el AMI. Cuando se utiliza esta opción, no se puede garantizar la integridad del sistema de archivos de la imagen creada. **Permisos de IAM necesarios** El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente. + `ec2:CreateImage` + `ec2:DeleteSnapshot` + `ec2:DeregisterImage` + `ec2:DescribeInstances` + `ec2:DescribeImages` + `ec2:RunInstances` Si está copiando la instancia en una región diferente, también necesitará los siguientes permisos. + `ec2:CopyImage` **Pasos de documentos** + describeOriginalInstanceDetalles: recopila los detalles de la instancia que se va a copiar. + assertRootVolumeIsEbs - Comprueba si el tipo de dispositivo del volumen raíz es el correcto y`ebs`, de no ser así, finaliza la automatización. + evalInputParameters - Evalúa los valores proporcionados para los parámetros de entrada. + createLocalAmi - Crea un AMI de la instancia fuente. + tagLocalAmi - Etiqueta el AMI creado en el paso anterior. + branchAssertRegionIsSame - Se ramifica en función de si la instancia se está copiando dentro de la misma región o en una región diferente. + branchAssertSameRegionWithKeyPair - Se ramifica en función de si se ha proporcionado un valor para el `KeyPair` parámetro de una instancia que se está copiando en la misma región. + sameRegionLaunchInstanceWithKeyPair - Lanza una EC2 instancia de Amazon desde AMI de la instancia de origen en la misma subred o en la subred que especifique mediante el key pair que especificó. + sameRegionLaunchInstanceWithoutKeyPair - Lanza una EC2 instancia de Amazon desde AMI de la instancia de origen en la misma subred o en la subred que especifique sin un key pair. + copyAmiToRegión: copia el AMI a la región de destino. + waitForAvailableDestinationAmi - Espera a que se copie AMI estado en el que se convertirá`available`. + destinationRegionLaunchInstancia: lanza una EC2 instancia de Amazon con la copia AMI. + branchAssertDestinationAmiToDelete - Se ramifica en función del valor que proporcionó para el `KeepImageDestinationRegion` parámetro. + deregisterDestinationAmiAndDeleteSnapshots - Anula el registro de lo copiado AMI y elimina las instantáneas asociadas. + branchAssertSourceAmiTodelete - Se ramifica en función del valor que haya proporcionado para el `KeepImageSourceRegion` parámetro. + deregisterSourceAmiAndDeleteSnapshots - Anula el registro del AMI se crea a partir de la instancia de origen y elimina las instantáneas asociadas. + sleep: suspende la automatización durante 2 segundos. Se trata de un estado terminal. **Salidas** sameRegionLaunchInstanceWithKeyPair.InstanceIds sameRegionLaunchInstanceWithoutKeyPair.InstanceIds destinationRegionLaunchInstancia. DestinationInstanceId