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
<a name="sam-cli-command-reference-remote-invoke"></a>

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 uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam remote invoke` comando, consulte[Introdução aos testes na nuvem com sam remote invoke](using-sam-cli-remote-invoke.md).

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

## Usage
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

```
$ sam remote invoke <arguments> <options>
```

## Argumentos
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**Resource ID (ID do recurso)**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
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

   1. Step Functions

   1. Amazon SQS

   1. Kinesis Data Streams

1. 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
<a name="sam-cli-command-reference-remote-invoke-options"></a>

`--beta-features | --no-beta-features`  <a name="sam-cli-command-reference-remote-invoke-options-beta-features"></a>
Permita ou negue recursos beta.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Especifique o ambiente a ser usado em seu arquivo AWS SAMCLI de configuração.  
*Padrão*: `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
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](using-sam-cli-configure.md).  
*Padrão*: `samconfig.toml` na raiz do diretório do seu projeto. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
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`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
O evento a ser enviado ao recurso de destino.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
O caminho para um arquivo que contém o evento a ser enviado ao recurso de destino.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Mostra a mensagem de ajuda e sai.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
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`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
[https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)Parâmetros adicionais que você pode passar para o recurso que está sendo chamado.    
**Amazon Kinesis Data Streams**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
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\$1RECORD](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis/client/put_record.html).  
**AWS Lambda**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-lambda"></a>
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:  
+ [Lambda com resposta em buffer — Lambda.client.invoke](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ [Lambda com streaming de resposta — Lambda.client.invoke\$1with\$1response\$1stream](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke_with_response_stream.html)  
**Amazon Simple Queue Service (Amazon SQS)**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sqs"></a>
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\$1MESSAGE](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs/client/send_message.html).  
**AWS Step Functions**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sf"></a>
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\$1execution](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/stepfunctions/client/start_execution.html).

`--profile TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-profile"></a>
O perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
O Região da AWS do recurso. Por exemplo, .`us-east-1`

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
O nome da CloudFormation pilha à qual o recurso pertence.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
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`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
O nome do evento de teste compartilhável a ser passado para sua função do Lambda.  
Essa opção oferece suporte apenas às funções Lambda.

## Exemplo
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

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
```