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
.
-
Para obter uma introdução ao AWS SAMCLI, consulteO que é o AWS SAMCLI?.
-
Para obter a documentação sobre o uso do AWS SAMCLI
sam remote invoke
comando, consulteIntrodução aos testes na nuvem com sam remote invoke.
O sam remote invoke
comando invoca recursos suportados no . Nuvem AWS
Uso
$
sam remote invoke
<arguments> <options>
Argumentos
- 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
para obter o ARN dos seus recursos.<stack-name>
-
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 AWS CloudFormation o.
dica
Use
sam list resources --stack-name
para obter a identificação física dos seus recursos.<stack-name>
- 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 AWS 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 AWS CloudFormation sua pilha usando a seguinte lógica:-
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:
-
Lambda
-
Step Functions
-
Amazon SQS
-
Kinesis Data Streams
-
-
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
-
Boto3
Parâ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 AWS CloudFormation pilha à qual o recurso pertence.
--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.