sam remote invoke - AWS Serverless Application Model
UsoArgumentosOpçõesExemplo

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

sam remote invoke

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam remote invoke.

O sam remote invoke comando invoca recursos suportados no . Nuvem AWS

Uso

$ sam remote invoke <arguments> <options>

Argumentos

Resource ID (ID do recurso)

O ID do recurso suportado a ser invocado.

Esse argumento aceita os seguintes valores:

  • O nome de recurso da Amazon (ARN) - O ARN do conjunto de recursos.

    dica

    Use sam list stack-outputs --stack-name <stack-name> para obter o ARN dos seus recursos.

  • ID lógico - O ID lógico do recurso. Você também deve fornecer o nome da AWS CloudFormation pilha usando a --stack-name opção.

  • ID físico — O ID físico do recurso. Esse ID é criado quando você implanta um recurso usando CloudFormation o.

    dica

    Use sam list resources --stack-name <stack-name> para obter a identificação física dos seus recursos.

Quando você fornece um ARN ou ID física:

Se você fornecer um ARN ou ID física, não forneça um nome de pilha. Quando o nome da pilha for fornecido usando a --stack-name opção, ou quando o nome da pilha for definido em seu arquivo de configuração, ele AWS SAM CLI processará automaticamente sua ID de recurso como um valor de ID lógico da CloudFormation pilha.

Quando você não fornece um ID de recurso:

Se você não fornecer um ID de recurso, mas fornecer um nome de pilha com a --stack-name opção, a AWS SAM CLI tentará invocar automaticamente um recurso em CloudFormation sua pilha usando a seguinte lógica:

  1. Eles AWS SAM CLI identificarão os tipos de recursos na seguinte ordem e passarão para a próxima etapa quando o tipo de recurso for encontrado em sua pilha:

    1. Lambda

    2. Step Functions

    3. Amazon SQS

    4. Kinesis Data Streams

  2. Se o tipo de recurso tiver um único recurso em sua pilha, AWS SAM CLI ele o invocará. Se existirem vários recursos do tipo de recurso em sua pilha, eles AWS SAM CLI retornarão um erro.

A seguir estão exemplos do que eles AWS SAM CLI farão:

  • Pilha que contém duas funções Lambda e uma fila do Amazon SQS — Ela AWS SAM CLI localizará o tipo de recurso Lambda e retornará um erro, pois a pilha contém mais de uma função Lambda.

  • Pilha que contém uma função Lambda e dois aplicativos Amazon Kinesis Data Streams AWS SAM CLI — Eles localizarão a função Lambda e a invocarão, pois a pilha contém um único recurso Lambda.

  • Pilha que contém uma única fila do Amazon SQS e dois aplicativos do Kinesis Data Streams — Eles AWS SAM CLI localizarão a fila do Amazon SQS e a invocarão, pois a pilha contém uma única fila do Amazon SQS.

Opções

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

Permita ou negue recursos beta.

--config-env TEXT

Especifique o ambiente a ser usado em seu arquivo AWS SAMCLI de configuração.

Padrão: default

--config-file FILENAME

Especifique o caminho e o nome do arquivo de configuração.

Para obter mais informações sobre esses arquivos de configuração, consulte Configurando o AWS SAM CLI.

Padrão: samconfig.toml na raiz do diretório do seu projeto.

--debug

Ative o registro da depuração. Isso imprime mensagens de depuração e registros de data e hora gerados pelo AWS SAM CLI.

--event, -e TEXT

O evento a ser enviado ao recurso de destino.

--event-file FILENAME

O caminho para um arquivo que contém o evento a ser enviado ao recurso de destino.

--help, -h

Mostra a mensagem de ajuda e sai.

--output [ text | json ]

Exiba os resultados da sua invocação em um formato de saída específico.

json— Os metadados da solicitação e a resposta do recurso são retornados na estrutura JSON. A resposta contém a saída completa do SDK.

text— Os metadados da solicitação são retornados na estrutura de texto. A resposta do recurso é retornada no formato de saída do recurso invocado.

--parameter

Boto3Parâmetros adicionais que você pode passar para o recurso que está sendo chamado.

Amazon Kinesis Data Streams

Os seguintes parâmetros adicionais podem ser usados para colocar um registro no fluxo de dados do Kinesis:

  • ExplicitHashKey='string'

  • PartitionKey='string'

  • SequenceNumberForOrdering='string'

  • StreamARN='string'

Para obter uma descrição de cada parâmetro, consulte Kinesis.client.PUT_RECORD.

AWS Lambda

Os seguintes parâmetros adicionais podem ser usados para invocar um recurso Lambda e receber uma resposta em buffer:

  • ClientContext='base64-encoded string'

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

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Os seguintes parâmetros adicionais podem ser usados para invocar um recurso Lambda com streaming de resposta:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Para obter uma descrição de cada parâmetro, consulte o seguinte:

Amazon Simple Queue Service (Amazon SQS)

Os seguintes parâmetros adicionais podem ser usados para enviar uma mensagem para uma fila do Amazon SQS:

  • DelaySeconds=integer

  • MessageAttributes='json string'

  • MessageDeduplicationId='string'

  • MessageGroupId='string'

  • MessageSystemAttributes='json string'

Para obter uma descrição de cada parâmetro, consulte sqs.client.SEND_MESSAGE.

AWS Step Functions

Os seguintes parâmetros adicionais podem ser usados para iniciar uma execução de máquina de estado:

  • name='string'

  • traceHeader='string'

Para obter uma descrição de cada parâmetro, consulte sfn.client.start_execution.

--profile TEXT

O perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

--region TEXT

O Região da AWS do recurso. Por exemplo, .us-east-1

--stack-name TEXT

O nome da CloudFormation pilha à qual o recurso pertence.

--tenant-id TEXT

O ID do locatário para funções Lambda de vários locatários. Usado para garantir o isolamento computacional entre diferentes inquilinos. Obrigatório ao invocar funções configuradas com o modo de isolamento do inquilino.

--test-event-name NAME

O nome do evento de teste compartilhável a ser passado para sua função do Lambda.

nota

Essa opção oferece suporte apenas às funções Lambda.

Exemplo

O exemplo a seguir invoca recursos compatíveis na AWS nuvem e ativa o registro de depuração, que imprime mensagens de depuração e registros de data e hora gerados pelo: AWS SAMCLI

$ sam remote invoke--debug