# Creación de instantáneas de EBS basadas en VSS para instancias de Windows de EC2
Después de cumplir con todos los [Requisitos previos para crear las instantáneas de EBS basadas en VSS de Windows](application-consistent-snapshots-prereqs.md), puede usar cualquiera de los siguientes métodos para crear instantáneas basadas en VSS a partir de su instancia de EC2.
**Documentos de comandos de AWS Systems Manager**
[Uso de documentos de comandos de Systems Manager](create-vss-snapshots-ssm.md) para crear instantáneas basadas en VSS.
Para automatizar las copias de seguridad, puede crear una tarea de periodo de mantenimiento de AWS Systems Manager que use el documento de comandos de `AWSEC2-VssInstallAndSnapshot`. Para obtener más información, consulte [Trabajo con periodos de mantenimiento (Consola)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) en la *Guía del usuario de AWS Systems Manager*.
**AWS Backup**
Puede crear una copia de seguridad de VSS cuando utilice AWS Backup si habilita VSS en la consola o en la CLI. Para obtener más información, consulte [Creación de copias de seguridad de Windows VSS](https://docs.aws.amazon.com/aws-backup/latest/devguide/windows-backups.html) en la *Guía para desarrolladores de AWS Backup*.
AWS Backup no instala automáticamente el paquete `AwsVssComponents` en la instancia. Debe realizar una instalación manual en la instancia. Para obtener más información, consulte [Instalación manual de los componentes de VSS en una instancia de Windows de EC2](application-consistent-snapshots-getting-started.md#install-vss-comps).
**Administrador de vida útil de datos de Amazon**
Puede crear instantáneas de VSS con Amazon Data Lifecycle Manager habilitando scripts previos y posteriores en sus políticas de ciclo de vida de instantáneas. Para obtener más información, consulte [Automating application-consistent snapshots](https://docs.aws.amazon.com/ebs/latest/userguide/automate-app-consistent-backups.html) en la *Guía del usuario de Amazon EBS*.
Amazon Data Lifecycle Manager no instala automáticamente el paquete `AwsVssComponents` en la instancia. Debe realizar una instalación manual en la instancia. Para obtener más información, consulte [Instalación manual de los componentes de VSS en una instancia de Windows de EC2](application-consistent-snapshots-getting-started.md#install-vss-comps).
# Uso de documentos de comandos de Systems Manager para crear instantáneas basadas en VSS
Puede usar los documentos de comandos de AWS Systems Manager para crear instantáneas basadas en VSS. En el siguiente contenido, se presentan los documentos de comandos disponibles y los parámetros de tiempo de ejecución que usan los documentos para crear las instantáneas.
Antes de usar cualquiera de los documentos de comandos de Systems Manager, asegúrese de cumplir con todos los [Requisitos previos para crear las instantáneas de EBS basadas en VSS de Windows](application-consistent-snapshots-prereqs.md).
**Topics**
+ [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params)
+ [Ejecute los documentos de comandos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-methods)
## Parámetros de los documentos para instantáneas de VSS de Systems Manager
Todos los documentos de Systems Manager que crean instantáneas de VSS usan los siguientes parámetros, excepto cuando se indica lo contrario:
**AmiName** (cadena, opcional)
Si el estado de **CreateAmi** es `True`, especifique el nombre de la AMI creada por la copia de seguridad.
**description** (cadena, opcional)
Especifique una descripción para las instantáneas o la imagen que crea este proceso.
**CollectDiagnosticLogs** (cadena, opcional)
Para recopilar más información durante los pasos de creación de la instantánea y la AMI, establezca este parámetro en “`True`”. El valor predeterminado para este parámetro es “`False`”. Los registros de diagnóstico consolidados se guardan como un archivo en formato `.zip` en la siguiente ubicación de la instancia:
`C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip`
**CopyOnly** (cadena, opcional)
Si utiliza la copia de seguridad nativa de SQL Server además de VSS de AWS, llevar a cabo una copia de seguridad de solo copia impide que VSS de AWS interrumpa la cadena de copia de seguridad diferencial nativa. Para realizar una operación de copia de seguridad de solo copia, establezca este parámetro en `True`.
El valor predeterminado de este parámetro es `False`, lo que hace que VSS de AWS realice una operación de copia de seguridad completa.
**CreateAmi** (cadena, opcional)
Para crear una imagen de máquina de Amazon (AMI) basada en VSS para hacer una copia de seguridad de la instancia, establezca este parámetro en `True`. El valor predeterminado de este parámetro es `False`, que en su lugar hace una copia de seguridad de la instancia con una instantánea de EBS.
Para obtener más información sobre la creación de una AMI a partir de una instancia, consulte [Creación de una AMI basada en Amazon EBS](creating-an-ami-ebs.md).
**executionTimeout** (cadena, opcional)
Especifique el tiempo máximo en segundos para ejecutar el proceso de creación de instantáneas en la instancia o para crear una AMI a partir de la instancia. Al aumentar este tiempo de espera, el comando puede esperar más tiempo hasta que VSS inicie la congelación y complete el etiquetado de los recursos que crea. Este tiempo de espera solo se aplica a los pasos de creación de la instantánea o de la AMI. El paso inicial para instalar o actualizar el paquete `AwsVssComponents` no está incluido en el tiempo de espera.
**ExcludeBootVolume** (cadena, opcional)
Esta configuración excluye volúmenes de arranque del proceso de copia de seguridad si crea instantáneas. Para excluir los volúmenes de arranque de las instantáneas, configure **ExcludeBootVolume** en `True` y **CreateAmi** en `False`.
Si crea una AMI para la copia de seguridad, este parámetro se debe establecer en `False`. El valor predeterminado para este parámetro es `False`.
**NoWriters** (cadena, opcional)
Para excluir los escritores de VSS de la aplicación del proceso de instantáneas, establezca este parámetro en `True`. Excluir los escritores de VSS de la aplicación puede ayudar a resolver los conflictos con los componentes de copia de seguridad de VSS de terceros. El valor predeterminado para este parámetro es `False`.
Si `SaveVssMetadata` es `True`, este parámetro debe establecerse en `False`.
**SaveVssMetadata** (cadena, opcional)
Para guardar los archivos de metadatos de VSS durante cada instantánea, defina este parámetro en `True`. El valor predeterminado es `False`. Estos archivos ayudan a proporcionar información sobre los componentes o grabadores que se incluyeron en una operación de copia de seguridad y los archivos y volúmenes asociados a cada componente. Los archivos de metadatos se utilizan al restaurar una base de datos SQL con la solución de restauración VSS. Para obtener más información sobre cómo restaurar una base de datos SQL a partir de instantáneas de VSS, consulte [Utilizar un manual de procedimientos de automatización para restaurar la base de datos a partir de instantáneas de soluciones de AWS VSS](https://docs.aws.amazon.com/sql-server-ec2/latest/userguide/ms-ssdb-ec2-restore-vss.html).
Los archivos de metadatos tienen el identificador del conjunto de instantáneas asociado en sus nombres. Puede encontrarlos en la siguiente ubicación de la instancia:
```
C:\ProgramData\Amazon\AwsVss\VssMetadata\
```
+ Para guardar archivos de metadatos de VSS, se requiere la versión 2.4.0 o posterior del paquete `AwsVssComponents`. Si la instancia tiene instalada una versión anterior, si se configura `SaveVssMetadata` en `True`, se produce un error en la creación de la instantánea.
+ Los parámetros `NoWriters` y `SaveVssMetadata` son mutuamente excluyentes. Si ambos se establecen en `True`, se produce un error en la creación de la instantánea.
**tags** (cadena, opcional)
Recomendamos etiquetar las instantáneas e imágenes para localizar y administrar los recursos, por ejemplo, para restaurar los volúmenes a partir de una lista de instantáneas. El sistema agrega la clave `Name`, con un valor en blanco, donde puede indicar el nombre que quiere aplicar a las instantáneas o imágenes de salida.
Si quiere especificar otras etiquetas, separe las etiquetas mediante un punto y coma. Por ejemplo, `Key=Environment,Value=Test;Key=User,Value=TestUser1`.
Las claves y los valores de las etiquetas solo deben contener caracteres alfanuméricos y los siguientes caracteres especiales: `() ./\-"'@_+:={}`.
De manera predeterminada, el sistema agrega las siguientes etiquetas reservadas para las instantáneas e imágenes basadas en VSS.
+ **Dispositivo**: en el caso de las instantáneas compatibles con VSS, este es el nombre de dispositivo del volumen de EBS que captura la instantánea.
+ **AppConsistent**: esta etiqueta indica la creación correcta de una instantánea o AMI compatible con VSS.
+ **AWSVSSConfig**: identifica las instantáneas y las AMI que se crean con compatibilidad con VSS. La etiqueta incluye metadatos, como la versión de `AwsVssComponents` y el ID del conjunto de instantáneas.
Si se especifica alguna de estas etiquetas reservadas en la lista de parámetros, se producirá un error.
**VssVersion** (cadena, opcional)
Solo para el documento `AWSEC2-VssInstallAndSnapshot`, puede especificar el parámetro `VssVersion` para instalar una versión específica del paquete `AwsVssComponents` en la instancia. Deje en blanco este parámetro para instalar la versión predeterminada recomendada.
Si la versión especificada del paquete `AwsVssComponents` ya está instalada, el script omite el paso de instalación y procede a realizar el paso de copia de seguridad. Para obtener una lista de las versiones del paquete `AwsVssComponents` y la compatibilidad operativa, consulte [Historial de versiones de la solución AWS VSS](vss-comps-history.md).
## Ejecute los documentos de comandos para instantáneas de VSS de Systems Manager
Puede crear instantáneas de EBS basadas en VSS con los documentos de comandos de AWS Systems Manager de la siguiente forma.
### Ejecute el documento de comandos AWSEC2-VssInstallAndSnapshot (recomendado)
Cuando usa AWS Systems Manager para ejecutar el documento `AWSEC2-VssInstallAndSnapshot`, el script ejecuta los siguientes pasos.
1. El script primero instala o actualiza el paquete `AwsVssComponents` en la instancia, en función de si ya está instalado o no.
1. El script crea las instantáneas coherentes con las aplicaciones una vez finalizado el primer paso.
Para ejecutar el documento `AWSEC2-VssInstallAndSnapshot`, siga los pasos de su entorno de preferencia.
------
#### [ Console ]
**Creación de instantáneas de EBS basadas en VSS desde la consola**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, seleccione **Ejecutar comando**. Se muestra una lista de los comandos que se están ejecutando actualmente en su cuenta, si corresponde.
1. Elija **Run command (Ejecutar comando)**. Se abre una lista de documentos de comandos a los que tiene acceso.
1. Seleccione `AWSEC2-VssInstallAndSnapshot` de la lista de documentos de comandos. Para agilizar los resultados, puede ingresar todo el nombre del documento o una parte. También puede filtrar por propietario, por tipo de plataforma o por etiquetas.
Al seleccionar un documento de comandos, los detalles aparecen debajo de la lista.
1. Seleccione `Default version at runtime` de la lista **Versión del documento**.
1. Configure **Parámetros de comando** para definir cómo `AWSEC2-VssInstallAndSnapshot` instalará el paquete `AwsVssComponents` y realizará la copia de seguridad con una AMI o instantáneas de VSS. Para obtener detalles sobre los parámetros, consulte [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params).
1. En **Selección de destino**, especifique las etiquetas o seleccione manualmente las instancias para identificar las instancias en las que ejecutar esta operación.
**nota**
Si selecciona las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte [¿Dónde están mis instancias?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) para ver cómo resolver el problema.
1. Para obtener parámetros adicionales que definan el comportamiento de Systems Manager Run Command, como **Control de velocidad**, ingrese los valores descritos en [Ejecución de comandos desde la consola](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).
1. Elija **Run (Ejecutar)**.
Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de Systems Manager para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en un backup de volumen específico, puede solucionar el error en la lista de volúmenes de EBS.
------
#### [ AWS CLI ]
Puede ejecutar los siguientes comandos en la AWS CLI para crear instantáneas de EBS basadas en VSS y obtener el estado de la creación de la instantánea.
**Creación de instantáneas de EBS basadas en VSS**
Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro `--instance-ids`. Para obtener más información acerca de otros parámetros que puede usar, consulte [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params).
```
aws ssm send-command \
--document-name "AWSEC2-VssInstallAndSnapshot" \
--instance-ids "i-01234567890abcdef" \
--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'
```
Si todo sale bien, el documento de comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.
**Obtener el estado del comando**
Para obtener el estado actual de las instantáneas, ejecute el siguiente comando con el ID de comando devuelto de **send-command**.
```
aws ssm get-command-invocation
--instance-ids "i-01234567890abcdef" \
--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
--plugin-name "CreateVssSnapshot"
```
------
#### [ PowerShell ]
Ejecute los siguientes comandos con AWS Tools for Windows PowerShell para crear instantáneas de EBS basadas en VSS y obtener el estado de tiempo de ejecución actual de la creación de la salida. Especifique los parámetros descritos en la lista anterior para modificar el comportamiento del procesamiento de instantáneas.
**Creación de instantáneas de EBS basadas en VSS mediante Herramientas para Windows PowerShell**
Para crear AMI o instantáneas de EBS basadas en VSS, ejecute el siguiente comando.
```
Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
```
**Obtener el estado del comando**
Para obtener el estado actual de las instantáneas, ejecute el siguiente comando con el ID de comando devuelto de **Send-SSMCommand**.
```
Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"
```
Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.
------
### Ejecute el documento de comandos AWSEC2-CreateVssSnapshot
Para ejecutar el documento `AWSEC2-CreateVssSnapshot`, siga los pasos de su entorno de preferencia.
------
#### [ Console ]
**Creación de instantáneas de EBS basadas en VSS desde la consola**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, seleccione **Ejecutar comando**. Se muestra una lista de los comandos que se están ejecutando actualmente en su cuenta, si corresponde.
1. Elija **Run command (Ejecutar comando)**. Se abre una lista de documentos de comandos a los que tiene acceso.
1. Seleccione `AWSEC2-CreateVssSnapshot` de la lista de documentos de comandos. Para agilizar los resultados, puede ingresar todo el nombre del documento o una parte. También puede filtrar por propietario, por tipo de plataforma o por etiquetas.
Al seleccionar un documento de comandos, los detalles aparecen debajo de la lista.
1. Seleccione `Default version at runtime` de la lista **Versión del documento**.
1. Configure los **Parámetros de comando** para definir cómo `AWSEC2-CreateVssSnapshot` realizará la copia de seguridad con instantáneas de VSS o con una AMI. Para obtener detalles sobre los parámetros, consulte [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params).
1. En **Selección de destino**, especifique las etiquetas o seleccione manualmente las instancias para identificar las instancias en las que ejecutar esta operación.
**nota**
Si selecciona las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte [¿Dónde están mis instancias?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) para ver cómo resolver el problema.
1. Para obtener parámetros adicionales que definan el comportamiento de Systems Manager Run Command, como **Control de velocidad**, ingrese los valores descritos en [Ejecución de comandos desde la consola](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).
1. Elija **Run (Ejecutar)**.
Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de Systems Manager para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en un backup de volumen específico, puede solucionar el error en la lista de volúmenes de EBS.
------
#### [ AWS CLI ]
Puede ejecutar el siguiente comando en la AWS CLI para crear instantáneas de EBS basadas en VSS.
**Creación de instantáneas de EBS basadas en VSS**
Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro `--instance-ids`. Para obtener más información acerca de otros parámetros que puede usar, consulte [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params).
```
aws ssm send-command \
--document-name "AWSEC2-CreateVssSnapshot" \
--instance-ids "i-01234567890abcdef" \
--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'
```
Si todo sale bien, el documento de comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.
------
#### [ PowerShell ]
Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando con AWS Tools for Windows PowerShell.
**Creación de instantáneas de EBS basadas en VSS mediante Herramientas para Windows PowerShell**
Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro `InstanceId`. Puede especificar más de una instancia para crear instantáneas. Para obtener más información acerca de otros parámetros que puede usar, consulte [Parámetros de los documentos para instantáneas de VSS de Systems Manager](#create-vss-snapshots-ssm-params).
```
Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
;'tags'='Key=key_name,Value=tag_value'}
```
Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o `AppConsistent`. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en una copia de seguridad de volumen específico, puede solucionar el error en la lista de instantáneas de EBS.
------
### Ejecución de los documentos de comandos en un clúster de conmutación por error de Windows con almacenamiento EBS compartido
Puede usar cualquiera de los procedimientos de línea de comandos descritos en la sección anterior para crear una instantánea basada en VSS. El documento de comandos (`AWSEC2-VssInstallAndSnapshot` o `AWSEC2-CreateVssSnapshot`) debe ejecutarse en el nodo principal del clúster. El documento fallará en los nodos secundarios, ya que no tienen acceso a los discos compartidos. Si el comando principal y el secundario cambian de forma dinámica, puede ejecutar el documento Ejecutar comandos de AWS Systems Manager en varios nodos con la expectativa de que el comando se ejecute correctamente en el nodo principal y falle en los nodos secundarios.
**nota**
Para automatizar las copias de seguridad, puede crear una tarea de periodo de mantenimiento de AWS Systems Manager que use el documento `AWSEC2-VssInstallAndSnapshot`. Para obtener más información, consulte [Trabajo con periodos de mantenimiento (Consola)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) en la *Guía del usuario de AWS Systems Manager*.