本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# sam delete
<a name="sam-cli-command-reference-sam-delete"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam delete` 命令的参考信息。

有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)

该`sam delete`命令通过删除 CloudFormation 堆栈、打包并部署到 Amazon S3 和 Amazon ECR 的项目以及 AWS SAM 模板文件来删除 AWS SAM 应用程序。

此命令还会检查是否部署了 Amazon ECR 配套堆栈，如果是，则会提示用户删除该堆栈和 Amazon ECR 存储库。如果指定了 `--no-prompts`，则默认情况下会删除配套堆栈和 Amazon ECR 存储库。

## 用法
<a name="sam-cli-command-reference-sam-delete-usage"></a>

```
$ sam delete <options>
```

## 选项
<a name="sam-cli-command-reference-sam-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-delete-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为 `default`。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为 `samconfig.toml`。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
启用调试日志记录，以打印 AWS SAM CLI 生成的调试消息并显示时间戳。

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
显示此消息并退出。

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
将此选项指定为在非交互模式下 AWS SAM 操作。必须使用 `--stack-name` 选项或在 `toml` 配置文件中提供堆栈名称。

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
您的凭证文件中用于获取 AWS 凭证的特定个人资料。

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
要部署到的 AWS 区域。例如，us-east-1。

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
要删除的 Amazon S3 存储桶的路径。

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
要删除的 Amazon S3 存储桶的前缀。

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
将您在命令行中提供的参数保存到 AWS SAM 配置文件中。

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
要删除的 CloudFormation 堆栈的名称。

## 示例
<a name="sam-cli-command-reference-sam-delete-examples"></a>

以下命令删除堆栈 `MY-STACK`。

```
$ sam delete --stack-name MY-STACK
```

以下命令删除堆栈 `MY-STACK` 和 S3 存储桶 `sam-s3-demo-bucket`：

```
$ sam delete \
    --stack-name MyStack \
    --s3-bucket MySAMBucket
```