sam remote invoke - AWS Serverless Application Model
UsoArgumentosOpcionesEjemplo

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.

sam remote invoke

Esta página proporciona información de referencia para la interfaz de línea de AWS Serverless Application Model comandos (AWS SAM CLIsam remote invokecomando).

El comando sam remote invoke invoca los recursos compatibles en Nube de AWS.

Uso

$ sam remote invoke <arguments> <options>

Argumentos

ID de recurso

El ID del recurso admitido a invocar.

Este argumento acepta los valores siguientes:

  • Nombre del recurso de Amazon (ARN): el ARN del recurso.

    sugerencia

    sam list stack-outputs --stack-name <stack-name>Úselo para obtener sus recursos. ARN

  • ID lógico: el ID lógico del recurso. También debes proporcionar el nombre de la AWS CloudFormation pila mediante la --stack-name opción.

  • ID físico: el ID físico del recurso. Este ID se crea al implementar un recurso utilizando AWS CloudFormation.

    sugerencia

    Usa sam list resources --stack-name <stack-name> para obtener el ID físico de sus recursos.

Al proporcionar un identificador físico ARN o uno:

Si proporciona una identificación física ARN o física, no proporcione un nombre de pila. Cuando el nombre de la pila se proporciona mediante la --stack-name opción, o cuando el nombre de la pila está definido en el archivo de configuración, AWS SAM CLI procesará automáticamente su ID de recurso como un valor de ID lógico de la AWS CloudFormation pila.

Cuando no proporciona un ID de recurso:

Si no proporcionas un ID de recurso, pero sí un nombre de pila con la --stack-name opción, esta AWS SAM CLI intentará invocar automáticamente un recurso de tu AWS CloudFormation pila mediante la siguiente lógica:

  1. El AWS SAM CLI identificará los tipos de recursos en el siguiente orden y pasará al siguiente paso una vez que el tipo de recurso se encuentre en la pila:

    1. Lambda

    2. Step Functions

    3. Amazon SQS

    4. Kinesis Data Streams

  2. Si el tipo de recurso tiene un único recurso en la pila, AWS SAM CLI lo invocará. Si existen varios recursos del tipo de recurso en su pila, el AWS SAM CLI devolverá un error.

Los siguientes son ejemplos de lo que AWS SAM CLI hará:

  • Pila que contiene dos funciones de Lambda y una SQS cola de Amazon: la AWS SAM CLI localizará el tipo de recurso de Lambda y devolverá un error, ya que la pila contiene más de una función de Lambda.

  • Pila que contiene una función de Lambda y dos aplicaciones de Amazon Kinesis Data Streams: la AWS SAM CLI localizará la función Lambda y la invocará, ya que la pila contiene un único recurso de Lambda.

  • Pila que contiene una sola SQS cola de Amazon y dos aplicaciones de Kinesis Data Streams: la AWS SAM CLI localizará la SQS cola de Amazon y la invocará, ya que la pila contiene una sola cola de AmazonSQS.

Opciones

--beta-features | --no-beta-features

Permitir o denegar las características beta.

--config-env TEXT

Especifique el entorno que va a utilizar desde su AWS SAM CLI archivo de configuración.

Valor predeterminado: default

--config-file FILENAME

Especifica la ruta y el nombre del archivo de configuración.

Para obtener más información sobre los archivos de configuración, consulta Configuración de la AWS SAM de CLI.

Predeterminado: samconfig.toml en la raíz del directorio del proyecto.

--debug

Activar el registro de depuración. Imprime los mensajes de depuración y las marcas de tiempo generados por el AWS SAM CLI.

--event, -e TEXT

El evento que se va a enviar al recurso de destino.

--event-file FILENAME

La ruta a un archivo que contiene el evento que se va a enviar al recurso de destino.

--help, -h

Muestre el mensaje de ayuda y salga.

--output [ text | json ]

Genera los resultados de la invocación en un formato de salida específico.

json— Los metadatos de la solicitud y la respuesta del recurso se devuelven estructurados. JSON La respuesta contiene el SDK resultado completo.

text: los metadatos de la solicitud se devuelven en una estructura de texto. La respuesta del recurso se devuelve en el formato de salida del recurso invocado.

--parameter

adicionalesBoto3parámetros que puede pasar al recurso que se está invocando.

Amazon Kinesis Data Streams

Los parámetros adicionales siguientes se pueden utilizar para incluir un registro en el flujo de datos de Kinesis:

  • ExplicitHashKey='string'

  • PartitionKey='string'

  • SequenceNumberForOrdering='string'

  • StreamARN='string'

Para obtener una descripción de cada parámetro, consulta Kinesis.Client.put_record.

AWS Lambda

Los siguientes parámetros adicionales se pueden usar para invocar un recurso de Lambda y recibir una respuesta almacenada en búfer:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | Event | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Los siguientes parámetros adicionales se pueden usar para invocar un recurso de Lambda con transmisión de respuesta:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Para ver una descripción de los parámetros, consulta lo siguiente:

Amazon Simple Queue Service (AmazonSQS)

Se pueden usar los siguientes parámetros adicionales para enviar un mensaje a una SQS cola de Amazon:

  • DelaySeconds=integer

  • MessageAttributes='json string'

  • MessageDeduplicationId='string'

  • MessageGroupId='string'

  • MessageSystemAttributes='json string'

Para ver una descripción de cada parámetro, consulta SQS.client.SEND_MESSAGE.

AWS Step Functions

Los parámetros adicionales siguientes se pueden utilizar para iniciar la ejecución de una máquina de estado:

  • name='string'

  • traceHeader='string'

Para obtener una descripción de cada parámetro, consulte .CLIENT.START_EXECUTION. SFN

--profile TEXT

El perfil específico del archivo de credenciales para obtener las credenciales. AWS

--region TEXT

El Región de AWS del recurso. Por ejemplo, us-east-1.

--stack-name TEXT

El nombre de la AWS CloudFormation pila a la que pertenece el recurso.

--test-event-name NAME

El nombre del evento de prueba compartible y pasarlo a la función de Lambda.

nota

Esta opción solo admite funciones de Lambda.

Ejemplo

En el siguiente ejemplo, se invocan los recursos compatibles de la AWS nube y se activa el registro de depuración, que imprime los mensajes de depuración y las marcas de tiempo generados por el AWS SAM CLI:

$ sam remote invoke--debug