DeleteMountTarget - Amazon Elastic File System

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 を使用する方法の詳細については、以下を参照してください。