

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

# DeleteMountTarget
<a name="API_DeleteMountTarget"></a>

刪除指定的掛載目標。

如果您刪除了掛載目標，該操作會強制中斷任何掛載的檔案系統掛載，此舉可能會中斷使用該掛載的執行個體或應用程式。為避免應用程式突然切斷，如果可行，您可以考慮卸載掛載目標的任何掛載。此操作也會刪除相關聯的網路介面。寫入未遞交時可能會遺失，但是借此操作中斷掛載目標並不會損毀檔案系統本身。您建立的檔案系統仍存在。您可以使用另一個掛載目標在 VPC 中掛載 EC2 執行個體。

此操作需要在檔案系統上具備以下動作的許可：
+  `elasticfilesystem:DeleteMountTarget` 

**注意**  
`DeleteMountTarget` 呼叫會在掛載目標狀態仍處於 `deleting` 時傳回。因 [DescribeMountTargets](API_DescribeMountTargets.md) 操作會傳回給定文件系統的掛載目標描述列表，所以您可以呼叫該操作來檢查掛載目標刪除情況。

此操作還需要在掛載目標網路介面上獲得下列 Amazon EC2 動作的許可：
+  `ec2:DeleteNetworkInterface` 

## 請求語法
<a name="API_DeleteMountTarget_RequestSyntax"></a>

```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteMountTarget_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **   <a name="efs-DeleteMountTarget-request-uri-MountTargetId"></a>
要刪除的掛載目標 ID (字串)。  
長度限制：長度下限為 13。長度上限為 45。  
模式：`^fsmt-[0-9a-f]{8,40}$`  
必要：是

## 請求主體
<a name="API_DeleteMountTarget_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteMountTarget_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 回應元素
<a name="API_DeleteMountTarget_ResponseElements"></a>

如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。

## 錯誤
<a name="API_DeleteMountTarget_Errors"></a>

 ** BadRequest **   
如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：400

 ** DependencyTimeout **   
嘗試處理請求時服務逾時，那麽用戶端應該再次嘗試呼叫。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：504

 ** InternalServerError **   
如果伺服器端發生錯誤，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：500

 ** MountTargetNotFound **   
如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。    
 ** ErrorCode **   
錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。  
 ** Message **   
錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。
HTTP 狀態碼：404

## 範例
<a name="API_DeleteMountTarget_Examples"></a>

### 移除檔案系統的掛載目標
<a name="API_DeleteMountTarget_Example_1"></a>

下列範例會傳送 DELETE 請求以刪除特定掛載目標。

#### 請求範例
<a name="API_DeleteMountTarget_Example_1_Request"></a>

```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```

#### 回應範例
<a name="API_DeleteMountTarget_Example_1_Response"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```

## 另請參閱
<a name="API_DeleteMountTarget_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget) 