# Importación de las pilas administradas automáticamente para conjuntos de pilas de CloudFormation
<a name="self-managed-import"></a>

La operación de importación de pilas de CloudFormation puede importar pilas existentes en StackSets nuevos o existentes, de modo que pueda migrar las pilas existentes a un StackSet en una sola operación. Al utilizar la importación de pilas, se evita el tiempo de inactividad y las interrupciones sin eliminar ni volver a crear esos recursos. Una vez que la pila se importe en un StackSet, la pila original se convertirá en una instancia de pila del conjunto de pila especificado.

**Consideraciones sobre las importaciones de pilas autoadministradas**
+ La operación de importación de pilas requiere una cuenta de administrador en la que se cree un StackSet y una cuenta de destino que contenga una pila.
+ La cuenta de destino debe tener permisos para utilizar la operación `GetTemplate` con la entrada de ID de pila o ARN. Por eso, su cuenta de administrador debe disponer de los permisos **AWSCloudFormationStackSetAdministrationRole** o **AWSCloudFormationStackSetsExectionRole**.

**Topics**
+ [Importación de una pila existente en un nuevo StackSet (consola)](#import-stacks-to-stack-set)
+ [Importación de una pila existente en un StackSet existente (consola)](#import-stack-to-existing-stackset)
+ [Importación de una pila en un StackSet (AWS CLI)](#importing-stack-to-stackset.cli)

## Importación de una pila existente en un nuevo StackSet (consola)
<a name="import-stacks-to-stack-set"></a>

Antes de empezar, identifique la pila que desee importar.

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFormation en [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. En el panel de navegación, seleccione **StackSets (Conjuntos de pilas)**.

1. En la parte superior de la página **StackSets (Conjuntos de pilas)**, seleccione **Create StackSet (Crear conjunto de pilas)**.

1. En la página **Elegir una plantilla**, especifique una plantilla utilizando una de las siguientes opciones y seleccione **Siguiente**.
   + Elija **Amazon S3 URL** (URL de Amazon S3) y especifique la URL de la plantilla en el cuadro de texto.
   + Elija **Upload a template file** (Cargar un archivo de plantilla) y busque la plantilla.
   + Elija **From stack ID** (Desde el ID de la pila) e ingrese el ID de la pila.

1. En la página **Especificar detalles del StackSet**, ingrese el nombre del StackSet que desee crear y seleccione **Siguiente**.

   (Opcional) Ingrese una descripción del StackSet.

1. En la página **Configurar las opciones del StackSet**, revise las opciones y seleccione **Siguiente**.

1. En la página **Establecer opciones de implementación**, seleccione **Importar pilas al conjunto de pilas**.

1. Ingrese el ID de la pila que desea importar en el campo **Stacks to import** (Pilas para importar). Por ejemplo, `arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786`.

   (Opcional) Seleccione **Agregar otro ID de pila** e ingrese el ID de otra pila que desee importar. Puede agregar hasta 10 pilas por cada operación de importación de pilas.

1. Revise las opciones de implementación y seleccione **Siguiente**.

1. En la página **Revisar**, revise sus opciones y las propiedades del StackSet. Cuando lo tenga todo listo para importar la pila en su StackSet, seleccione **Enviar**.

**Resultados**: La pila importada ahora es una instancia de pila del StackSet especificado. Para obtener más información sobre el estado de importación de la pila, consulte [Códigos de estado de StackSets](stacksets-concepts.md#stackset-status-codes).

## Importación de una pila existente en un StackSet existente (consola)
<a name="import-stack-to-existing-stackset"></a>

Antes de empezar, identifique la pila que desee importar.

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFormation en [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. En el panel de navegación, seleccione **StackSets (Conjuntos de pilas)**.

1. En la página **StackSets**, seleccione el StackSet en el que desee importar una pila.

1. Con el StackSet seleccionado, elija **Agregar pilas al StackSet** en el menú **Acciones**.

1. En la página **Establecer opciones de implementación**, seleccione **Importar pilas al conjunto de pilas** e ingrese el ID de la pila que desea importar en el campo **Pilas para importar**. Por ejemplo, `arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786`.

   (Opcional) Seleccione **Agregar otro ID de pila** e ingrese el ID de otra pila que desee importar. Puede agregar hasta 10 pilas por cada operación de importación de pilas.

1. Elija **Siguiente**.

1. En la página **Especificar anulaciones**, revise las opciones y seleccione **Siguiente**.

1. En la página **Revisar**, revise sus opciones y las propiedades del StackSet. Cuando lo tenga todo listo para crear su StackSet, elija **Enviar**.

**Resultados**: La pila importada ahora es una instancia de pila del StackSet especificado. Para obtener más información sobre el estado de importación de la pila, consulte [Códigos de estado de StackSets](stacksets-concepts.md#stackset-status-codes).

## Importación de una pila en un StackSet (AWS CLI)
<a name="importing-stack-to-stackset.cli"></a>

**Importación de una pila existente en un nuevo StackSet**  
El comando `create-stack-set` siguiente crea un StackSet e importa la pila especificada. La pila que desea importar se identifica mediante su ARN. Sustituya el texto del marcador de posición por su propia información.

```
aws cloudformation create-stack-set \
  --stack-set-name MyStackSet \
  --stack-id arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/466df9e0-0dff-08e3-8e2f-5088487c4896 \
  --administration-role-arn arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole \
  --execution-role-name AWSCloudFormationStackSetExecutionRole
```

**Importación de una pila existente en un StackSet existente**  
El comando `import-stacks-to-stack-sets` siguiente importa la pila especificada en el StackSet *MyStackSet*. La pila que desea importar se identifica mediante su ARN. Sustituya el texto del marcador de posición por su propia información.

```
aws cloudformation import-stacks-to-stack-set \
  --stack-set MyStackSet \
  --stack-ids arn:aws:cloudformation:us-east-1:123456789012:stack/StackToImport/f449b250-b969-11e0-a185-5081d0136786
```

Para especificar más de una pila, utilice el siguiente formato para el valor de la opción `--stack-ids`.

```
--stack-ids "arn_1" "arn_2"
```

**Para clonar la pila importada en otras regiones y cuentas**  
El comando `create-stack-instances` siguiente agrega instancias de pila al StackSet. Sustituya el texto del marcador de posición por su propia información.

```
aws cloudformation create-stack-instances \
  --stack-set-name MyStackSet \
  --accounts '["account_ID_1","account_ID_2"]' \
  --regions '["region_1","region_2"]'
```