DeleteMountTarget
指定されたマウントターゲットを削除します。
このオペレーションにより、削除されるマウントターゲットを使用しているファイルシステムのマウントが強制的に解除されるため、そのマウントを使用しているインスタンスやアプリケーションが停止する可能性があります。アプリケーションが突然切断されないように、可能であれば、マウントターゲットのマウントをすべてアンマウントすることを検討してください。このオペレーションにより、関連付けられたネットワークインターフェイスも削除されます。コミットされていない書き込みは失われる可能性がありますが、このオペレーションを使用してマウント・ターゲットを破っても、ファイル・システム自体が破損することはありません。作成したファイルシステムは残ります。別のマウントターゲットを使用して VPC に EC2 インスタンスをマウントできます。
このオペレーションには、ファイルシステムに対する次のアクションに対するアクセス許可が必要です。
-
elasticfilesystem:DeleteMountTarget
注記
マウントターゲットの状態がまだ deleting
にある間に DeleteMountTarget
コールが戻ります。マウントターゲットの削除をチェックするには、指定されたファイルシステムのマウントターゲットの説明のリストを返す DescribeMountTargets オペレーションをコールします。
オペレーションには、マウントターゲットのネットワーク インターフェイスで次の Amazon EC2 アクションに対するアクセス許可も必要です。
-
ec2:DeleteNetworkInterface
リクエストの構文
DELETE /2015-02-01/mount-targets/MountTargetId
HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- MountTargetId
-
削除するマウントターゲットの ID (文字列)。
長さの制限: 最小長は 13 です。最大長は 45 です。
Pattern:
^fsmt-[0-9a-f]{8,40}$
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 204
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。
エラー
- BadRequest
-
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。
HTTP ステータスコード: 400
- DependencyTimeout
-
リクエストを履行しようとしてサービスがタイムアウトしたため、クライアントはコールを再試行する必要があります。
HTTP ステータスコード: 504
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
HTTP ステータスコード: 500
- MountTargetNotFound
-
指定された ID のマウントターゲットが発信者の AWS アカウント で見つからない場合に返されます。
HTTP ステータスコード: 404
例
ファイルシステムのマウントターゲットの削除
次の例では、DELETE リクエストを送信して、特定のマウントターゲットを削除します。
リクエスト例
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
レスポンス例
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。