

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.

# Introducción a las pruebas en la nube con evento de prueba remoto de sam

Utilice el AWS Serverless Application Model comando Command Line Interface (AWS SAM CLI) `sam remote test-event` para acceder y gestionar los eventos de prueba que se pueden compartir para sus AWS Lambda funciones de eventos.

Para obtener más información sobre los eventos de prueba compartibles, consulta [Eventos de prueba compartibles](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) en la *Guía para desarrolladores de AWS Lambda *.

**Topics**
+ [Configure el AWS SAM CLI para usar evento de prueba remoto de sam](#using-sam-cli-remote-test-event-setup)
+ [Uso de evento de prueba remoto de sam comando](#using-sam-cli-remote-test-event-use)
+ [Uso de eventos de prueba compartibles](#using-sam-cli-remote-test-event-invoke)
+ [Gestion de eventos de prueba compartibles](#using-sam-cli-remote-test-event-manage)

## Requisitos previos
<a name="using-sam-cli-remote-test-event-prerequisites"></a>

Para usar `sam remote test-event`, completa lo siguiente para instalar la CLI de AWS SAM:
+ [AWS SAM requisitos previos](prerequisites.md).
+ [Instala la   AWS SAM CLI](install-sam-cli.md).

Si ya la tiene AWS SAM CLI instalada, le recomendamos que la actualice a la última AWS SAMCLI versión. Para obtener más información, consulta [Actualización de AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

Antes de usar `sam remote test-event`, se recomienda tener conocimientos básicos de lo siguiente:
+ [Configuración de la AWS SAM de CLI](using-sam-cli-configure.md).
+ [Crea tu solicitud en AWS SAM](using-sam-cli-init.md).
+ [Introducción a la construcción con AWS SAM](using-sam-cli-build.md).
+ [Introducción a la implementación con AWS SAM](using-sam-cli-deploy.md).
+ [Introducción al uso sam sync para sincronizarse con Nube de AWS](using-sam-cli-sync.md).

## Configure el AWS SAM CLI para usar evento de prueba remoto de sam
<a name="using-sam-cli-remote-test-event-setup"></a>

Complete los siguientes pasos de configuración para usar el AWS SAM CLI `sam remote test-event` comando:

1. **Configure el AWS SAM CLI para usar su Cuenta de AWS**: los usuarios pueden acceder a los eventos de prueba de Lambda que se pueden compartir y administrarlos dentro del mismo. Cuenta de AWS Para configurarlos AWS SAM CLI para que usen los suyos Cuenta de AWS, consulte. [Configuración de la AWS SAM de CLI](using-sam-cli-configure.md)

1. **Configurar los permisos para los eventos de prueba compartibles**: para acceder a los eventos de prueba compartibles y gestionarlos, debe tener los permisos adecuados. Para obtener más información, consulta los [Eventos de prueba que se puedan compartir](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) en la *Guía para desarrolladores de AWS Lambda *.

## Uso de evento de prueba remoto de sam comando
<a name="using-sam-cli-remote-test-event-use"></a>

El AWS SAM CLI `sam remote test-event` comando proporciona los siguientes subcomandos que puede usar para acceder a los eventos de prueba que se pueden compartir y administrarlos:
+ `delete`— Eliminar un evento de prueba que se pueda compartir del registro de EventBridge esquemas de Amazon.
+ `get`— Obtenga un evento de prueba que se pueda compartir del registro de EventBridge esquemas.
+ `list`— Listar los eventos de prueba que se pueden compartir existentes para una función del registro del EventBridge esquema.
+ `put`— Guarda un evento de un archivo local en el registro del EventBridge esquema.

Para enumerar estos subcomandos mediante el AWS SAM CLI, ejecute lo siguiente:

```
$ sam remote test-event --help
```

### Eliminación de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-use-delete"></a>

Puede eliminar un evento de prueba compartible usando el subcomando `delete` junto con lo siguiente:
+ Proporciona el nombre del evento de prueba compartible que se va a eliminar.
+ Proporciona un ID aceptable de la función de Lambda asociada al evento.
+ Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la AWS CloudFormation pila asociada a la función Lambda.

A continuación, se muestra un ejemplo:

```
$ sam remote test-event delete {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}}
```

Para obtener una lista de las opciones que se pueden usar con el subcomando `delete`, consulta [eliminación remota del evento de prueba sam](sam-cli-command-reference-remote-test-event-delete.md). También puede ejecutar lo siguiente desde: AWS SAM CLI

```
$ sam remote test-event delete --help
```

### Obtención de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-use-get"></a>

Puede obtener un evento de prueba que se pueda compartir desde el registro del EventBridge esquema mediante el `get` subcomando junto con lo siguiente:
+ Proporciona el nombre del evento de prueba compartible que se desea obtener.
+ Proporciona un ID aceptable de la función de Lambda asociada al evento.
+ Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la AWS CloudFormation pila asociada a la función Lambda.

A continuación se muestra un ejemplo en el que se obtiene un evento de prueba compartible llamado `demo-event` que está asociado a la función de Lambda `HelloWorldFunction` de la pila de `sam-app`. Este comando imprimirá el evento en la consola.

```
$ sam remote test-event get {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}}
```

Para obtener un evento de prueba compartible y guardarlo en su equipo local, utiliza la opción `--output-file` y proporciona una ruta de archivo y un nombre. A continuación se muestra un ejemplo que guarda `demo-event` como `demo-event.json` en el directorio de trabajo actual:

```
$ sam remote test-event get {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}} --output-file {{demo-event.json}}
```

Para obtener una lista de las opciones que se pueden usar con el subcomando `get`, consulta [sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md). También puede ejecutar lo siguiente desde: AWS SAM CLI

```
$ sam remote test-event get --help
```

### Enumeración de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-use-list"></a>

Puede enumerar todos los eventos de prueba compartibles para una función de Lambda concreta desde el registro de esquemas. Utiliza el subcomando `list` junto con lo siguiente:
+ Proporciona un ID aceptable de la función de Lambda asociada a los eventos.
+ Si proporciona el identificador lógico de la función Lambda, también debe proporcionar el nombre de la CloudFormation pila asociada a la función Lambda.

A continuación se muestra un ejemplo en el que se obtiene una lista de todos los eventos de prueba compartibles asociados con la función de Lambda `HelloWorldFunction` de la pila de `sam-app`.

```
$ sam remote test-event list {{HelloWorldFunction}} --stack-name {{sam-app}}
```

Para obtener una lista de las opciones que se pueden usar con el subcomando `list`, consulta [lista de eventos de prueba remotos sam](sam-cli-command-reference-remote-test-event-list.md). También puede ejecutar lo siguiente desde: AWS SAM CLI

```
$ sam remote test-event list --help
```

### Almacenamiento de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-use-put"></a>

Puede guardar los eventos de prueba que se pueden compartir en el registro de EventBridge esquemas. Utiliza el subcomando `put` junto con lo siguiente:
+ Proporciona un identificador aceptable de la función de Lambda asociada al evento de prueba compartible.
+ Proporciona un nombre para el evento de prueba compartible.
+ Proporciona la ruta del archivo y el nombre del evento local que desee cargar.

El siguiente es un ejemplo que guarda el evento `demo-event.json` local como `demo-event` y lo asocia a la función de Lambda `HelloWorldFunction` de la pila de `sam-app`:

```
$ sam remote test-event put {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}} --file {{demo-event.json}}
```

Si existe un evento de prueba que se pueda compartir con el mismo nombre en el registro del EventBridge esquema, no AWS SAM CLI lo sobrescribirá. Para sobrescribir, añada la opción `--force` a su comando.

Para obtener una lista de las opciones que se pueden usar con el subcomando `put`, consulta [salida de evento de prueba remota sam](sam-cli-command-reference-remote-test-event-put.md). También puede ejecutar lo siguiente desde: AWS SAM CLI

```
$ sam remote test-event put --help
```

## Uso de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-invoke"></a>

Utilice eventos de prueba que se puedan compartir para probar las funciones de Lambda en Nube de AWS el comando with `sam remote invoke` the. Para obtener más información, consulte [Transfiera eventos de prueba compartibles a una función de eventos de Lambda en la nube](using-sam-cli-remote-invoke.md#using-sam-cli-remote-invoke-shareable).

## Gestion de eventos de prueba compartibles
<a name="using-sam-cli-remote-test-event-manage"></a>

Este tema contiene ejemplos sobre cómo administrar y usar los eventos de prueba compartibles.

### Obtén un evento de prueba compartible, modifíquelo y úselo
<a name="using-sam-cli-remote-test-event-manage-example1"></a>

Puede obtener un evento de prueba que se pueda compartir del registro del EventBridge esquema, modificarlo localmente y usar el evento de prueba local con la función Lambda en. Nube de AWS A continuación, se muestra un ejemplo:

1. **Recuperar el evento de prueba compartible**: utiliza el subcomando `sam remote test-event get` para recuperar un evento de prueba compartible para una función de Lambda específica y guárdalo localmente:

   ```
   $ sam remote test-event get {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}} --output-file {{demo-event.json}}
   ```

1. **Modifica el evento de prueba compartible**: utiliza un editor de texto de tu elección para modificar el evento de prueba compartible.

1. **Usar el evento de prueba compartible**: usa el `sam remote invoke` comando y proporciona la ruta del archivo y el nombre del evento con: `--event-file`

   ```
   $ sam remote invoke {{HelloWorldFunction}} --stack-name {{sam-app}} --event-file {{demo-event.json}}
   ```

### Obtén un evento de prueba compartible, modifíquelo, cárguelo y úselo
<a name="using-sam-cli-remote-test-event-manage-example2"></a>

Puede obtener un evento de prueba que se pueda compartir del registro del EventBridge esquema, modificarlo localmente y cargarlo. A continuación, puede pasar el evento de prueba compartible directamente a la función de Lambda en la Nube de AWS. A continuación, se muestra un ejemplo:

1. **Recuperar el evento de prueba compartible**: utiliza el subcomando `sam remote test-event get` para recuperar un evento de prueba compartible para una función de Lambda específica y guárdalo localmente:

   ```
   $ sam remote test-event get {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}} --output-file {{demo-event.json}}
   ```

1. **Modifica el evento de prueba compartible**: utiliza un editor de texto de tu elección para modificar el evento de prueba compartible.

1. **Cargue el evento de prueba que se puede compartir**: utilice el `sam remote test-event put` subcomando para cargar y guardar el evento de prueba que se puede compartir en el registro del esquema. EventBridge En este ejemplo, utilizamos la opción `--force` para sobrescribir una versión anterior de nuestra prueba compartible.

   ```
   $ sam remote test-event put {{HelloWorldFunction}} --stack-name {{sam-app}} --name {{demo-event}} --file {{demo-event.json}} --force
   ```

1. **Pase el evento de prueba compartible a la función de Lambda**: utiliza el comando `sam remote invoke` para pasar el evento de prueba compartible directamente a la función de Lambda en la Nube de AWS:

   ```
   $ sam remote invoke {{HelloWorldFunction}} --stack-name {{sam-app}} --test-event-name {{demo-event}}
   ```