# Actualización de StackSets de CloudFormation
<a name="stacksets-update"></a>

Puede actualizar el StackSet mediante la consola de CloudFormation o la AWS CLI. 

Para agregar y eliminar cuentas y regiones de un StackSet, consulte [Adición de pilas a StackSets](stackinstances-create.md) y [Eliminar pilas de los StackSets](stackinstances-delete.md). Para anular los valores de los parámetros para una pila, consulte [Anulación de parámetros en pilas](stackinstances-override.md). 

**Topics**
+ [Actualización del StackSet (consola)](#stacksets-update-console)
+ [Actualización del StackSet (AWS CLI)](#stacksets-update-cli)

## Actualización del StackSet (consola)
<a name="stacksets-update-console"></a>

**Actualización de un StackSet**

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 la barra de navegación de la parte superior de la pantalla, elija la Región de AWS en la que creó el StackSet.

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

1. En la página **StackSet**, seleccione el StackSet que desea actualizar.

1. Con el StackSet seleccionado, elija **Editar detalles de StackSet** en el menú **Acciones**.

1. En la página **Elegir una plantilla**, actualice la sección **Permisos** según sea necesario o pase al siguiente paso.

1. En **Requisito previo: preparar plantilla**, elija **Usar plantilla actual** para usar la plantilla actual o **Reemplazar plantilla actual** para especificar una URL de S3 a otra plantilla o cargar una nueva plantilla.

1. Elija **Siguiente**.

1. En la página **Especificar detalles del StackSet**, en **Descripción del StackSet**, actualice la descripción del StackSet según sea necesario.

1. En **Parámetros**, actualice los valores de los parámetros según sea necesario.

1. Elija **Siguiente**.

1. En la página **Configurar opciones del conjunto de pilas**, en **Etiquetas**, modifique etiquetas según sea necesario. Puede añadir, actualizar o eliminar etiquetas. Para obtener más información acerca del uso de etiquetas en AWS, consulte [Organización y rastreo de costos mediante las etiquetas de asignación de costos de AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *Guía del usuario de Administración de facturación y costos de AWS*.

1. Para la **configuración de ejecución**, puede actualizar la configuración de ejecución según sea necesario. 
**nota**  
Recuerde que no puede cambiar la configuración de ejecución cuando las operaciones están en ejecución o en cola.

1. Si la plantilla contiene recursos de IAM, en **Capacidades** elija **Confirmo que esta plantilla pueda crear recursos de IAM** para especificar que desea utilizar recursos de IAM en la plantilla. Para obtener más información, consulte [Reconocimiento de recursos de IAM en plantillas de CloudFormation](control-access-with-iam.md#using-iam-capabilities).

1. Elija **Siguiente**.

1. En la página **Establecer opciones de implementación**, proporcione las cuentas y regiones para la actualización.

   CloudFormation implementará actualizaciones de pilas en las cuentas especificadas en la primera región, a continuación pasará a la siguiente, y así sucesivamente, mientras los fallos de implementación de una región no superen la tolerancia de fallos especificada.

   1. [Permisos autoadministrados] En **Cuentas**, **Ubicaciones de implementación**, elija **Implementar pilas en cuentas**. Pegue los ID de las cuentas de destino que ha utilizado para crear el StackSet en el cuadro de texto, separando varios números mediante comas. 

      [Permisos administrados por el servicio] Realice una de las siguientes acciones:
      + Elija **Implementar en unidades organizativas (OU)**. Ingrese las UO de destino que haya utilizado para crear el StackSet.
      + Elija **Implementar en cuentas**. Pegue los ID de las UO o las cuentas de destino que haya utilizado para crear el StackSet.

   1. En **Especificar regiones**, especifique el orden en el que desea que CloudFormation implemente las actualizaciones.

   1. Para **Opciones de implementación**, haga lo siguiente:
      + Para **Número máximo de cuentas simultáneas**, especifique cuántas cuentas se procesan simultáneamente.
      + En **Tolerancia a errores**, especifique el número máximo de errores de cuenta permitidos por región. La operación se detendrá y no continuará en otras regiones cuando se alcance este límite.
      + Para **Concurrencia de regiones**, elija cómo procesar las regiones: **Secuencial** (una región a la vez) o **Paralelo** (varias regiones simultáneamente).
      + Para el **Modo de concurrencia**, elija cómo se comporta la concurrencia durante la ejecución de la operación.
        + **Tolerancia a errores estricta**: reduce el nivel de simultaneidad de la cuenta cuando se producen errores, manteniéndose dentro de **Tolerancia a errores** \$11.
        + **Tolerancia flexible a errores**: mantiene el nivel de concurrencia especificado (el valor de **Número máximo de cuentas simultáneas**) independientemente de los errores. 
      + [Permisos administrados por el servicio] Para las **dependencias** de StackSet, añada los ARN de StackSet dependientes, manteniéndose dentro de un máximo de 10 dependencias. Para obtener más información, consulte [Habilitar o deshabilitar las implementaciones automáticas para StackSets en AWS Organizations](stacksets-orgs-manage-auto-deployment.md).

   1. Elija **Siguiente** para continuar.

1. En la página **Review (Revisar)**, revise las opciones seleccionadas. Para realizar cambios, elija **Editar** en la sección correspondiente.

1. Cuando esté listo para continuar, elija **Enviar**.

   CloudFormation comienza a aplicar las actualizaciones en el StackSet y muestra la pestaña **Operaciones** de la página de detalles del StackSet. Puede ver el progreso y el estado de las operaciones de actualización en la pestaña **Operations (Operaciones)**.

## Actualización del StackSet (AWS CLI)
<a name="stacksets-update-cli"></a>

**nota**  
Al actuar como administrador delegado, debe incluir `--call-as DELEGATED_ADMIN` en el comando. 

1. 

**Actualización de un StackSet**

   Ejecute el comando de [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html) para hacer cambios en el StackSet.

   En los siguientes ejemplos, actualizamos el StackSet mediante la opción `--parameters`. Específicamente, modificamos la frecuencia de entrega de instantánea predeterminada para la configuración del canal de entrega de `TwentyFour_Hours` a `Twelve_Hours`. Dado que seguimos utilizando la plantilla actual, añadimos la opción `--use-previous-template`.

   Defina el procesamiento simultáneo de cuentas y otras preferencias de implementación con la opción `--operation-preferences`. Estos ejemplos utilizan una configuración basada en el recuento. Considere que `MaxConcurrentCount` no debe superar `FailureToleranceCount` \$1 1. Para ajustes basados en porcentajes, utilice `FailureTolerancePercentage` o `MaxConcurrentPercentage` en su lugar. 

   [Permisos autoadministrados] Para la opción `--accounts`, proporcione los ID de cuenta a los que desea que se dirija la actualización.

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --accounts account_ID_1 account_ID_2 \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
   ```

   [Permisos administrados por el servicio] Para la opción `--deployment-targets`, proporcione el ID de raíz de la organización o los ID de unidad organizativa (UO) a los que desea que se dirija la actualización.

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo,ou-rcuk-slr5lh0a \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
   ```

   Para obtener más información, consulte [UpdateStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html) en la *Referencia de la API de AWS CloudFormation*.

1. Compruebe que el StackSet se haya actualizado correctamente al ejecutar el comando **describe-stack-set-operation** para mostrar el estado y los resultados de la operación de actualización. Para `--operation-id`, utilice el ID de operación devuelto con el comando **update-stack-set**.

   ```
   aws cloudformation describe-stack-set-operation \
     --operation-id operation_ID
   ```