本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

此頁面提供 AWS Serverless Application Model Command Line Interface (AWS SAM CLI) `sam delete`命令的參考資訊。

如需 的簡介 AWS SAM CLI，請參閱 [什麼是 AWS SAM CLI？](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 儲存庫。

## Usage
<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 SAM CLI 組態檔案](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
組態檔案的路徑和檔案名稱，其中包含要使用的預設參數值。預設值位於專案目錄的根`samconfig.toml`目錄中。如需關於組態檔案的詳細資訊，請參閱 [AWS SAM CLI 組態檔案](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
```