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

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

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam local callback` comando permite que você envie retornos de chamada para execuções de funções duráveis locais durante o desenvolvimento e o teste.

## Usage
<a name="sam-cli-command-reference-sam-local-callback-usage"></a>

```
$ sam local callback <subcommand> <options>
```

## Opções
<a name="sam-cli-command-reference-sam-local-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-callback-options-help"></a>
Mostre esta mensagem e saia.

## Subcomandos
<a name="sam-cli-command-reference-sam-local-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Envie um retorno de chamada bem-sucedido para uma execução de função durável. Para obter mais informações, consulte [sam local callback succeed](sam-cli-command-reference-sam-local-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-fail"></a>
Envie um retorno de chamada de falha para uma execução de função durável. Para obter mais informações, consulte [sam local callback fail](sam-cli-command-reference-sam-local-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-heartbeat"></a>
Envie um retorno de chamada de pulsação para uma execução de função durável. Para obter mais informações, consulte [sam local callback heartbeat](sam-cli-command-reference-sam-local-callback-heartbeat.md).

# sam local callback succeed
<a name="sam-cli-command-reference-sam-local-callback-succeed"></a>

Envie um retorno de chamada bem-sucedido para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-succeed-usage"></a>

```
$ sam local callback succeed CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-callback-succeed-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta bem-sucedida.

## Opções
<a name="ref-sam-cli-local-callback-succeed-options"></a>

`-r, --result TEXT`  
Carga útil do resultado de sucesso como string.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-succeed-examples"></a>

Envie um retorno de chamada bem-sucedido sem resultado:

```
$ sam local callback succeed my-callback-id
```

Envie um retorno de chamada de sucesso com o resultado:

```
$ sam local callback succeed my-callback-id --result 'Task completed successfully'
```

Envie um retorno de chamada bem-sucedido com a opção curta:

```
$ sam local callback succeed my-callback-id -r 'Success result'
```

# sam local callback fail
<a name="sam-cli-command-reference-sam-local-callback-fail"></a>

Envie um retorno de chamada de falha para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-fail-usage"></a>

```
$ sam local callback fail CALLBACK_ID [OPTIONS]
```

## Argumentos necessários
<a name="ref-sam-cli-local-callback-fail-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma resposta de falha.

## Opções
<a name="ref-sam-cli-local-callback-fail-options"></a>

`--error-data TEXT`  
Dados de erro adicionais.

`--stack-trace TEXT`  
Entradas de rastreamento de pilha. Essa opção pode ser especificada várias vezes.

`--error-type TEXT`  
Tipo de erro.

`--error-message TEXT`  
Mensagem de erro detalhada.

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-fail-examples"></a>

Enviar retorno de chamada de falha sem parâmetros:

```
$ sam local callback fail my-callback-id
```

Enviar retorno de chamada de falha com mensagem de erro:

```
$ sam local callback fail my-callback-id --error-message 'Task failed'
```

Envie um retorno de chamada de falha com todos os parâmetros:

```
$ sam local callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam local callback heartbeat
<a name="sam-cli-command-reference-sam-local-callback-heartbeat"></a>

Envie um retorno de chamada de pulsação para uma execução de função durável.

## Usage
<a name="ref-sam-cli-local-callback-heartbeat-usage"></a>

```
$ sam local callback heartbeat CALLBACK_ID [OPTIONS]
```

## Argumentos obrigatórios
<a name="ref-sam-cli-local-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
O identificador exclusivo do retorno de chamada para o qual enviar uma pulsação.

## Opções
<a name="ref-sam-cli-local-callback-heartbeat-options"></a>

`--region TEXT`  
Defina a AWS região do serviço (por exemplo,`us-east-1`).

`--profile TEXT`  
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--config-env TEXT`  
Nome do ambiente especificando valores de parâmetros padrão no arquivo de configuração. Padrão: `default`

`--config-file TEXT`  
Arquivo de configuração contendo valores de parâmetros padrão. Padrão: `samconfig.toml`

`--save-params`  
Salve os parâmetros fornecidos pela linha de comando no arquivo de configuração.

`--beta-features / --no-beta-features`  
Ativar/desativar recursos beta.

`--debug`  
Ative o registro de depuração para imprimir mensagens de depuração geradas pela AWS SAM CLI e exibir registros de data e hora.

`-h, --help`  
Mostra esta mensagem e sai.

## Exemplos
<a name="ref-sam-cli-local-callback-heartbeat-examples"></a>

Enviar retorno de chamada de pulsação:

```
$ sam local callback heartbeat my-callback-id
```