DeleteFileSystem - Amazon Elastic File System

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

DeleteFileSystem

ファイルシステムを削除し、その内容へのアクセスを永久に切断します。戻ると、ファイルシステムは存在しなくなり、削除されたファイルシステムのコンテンツにアクセスできなくなります。

EFS ファイルシステムを削除する前に、ファイルシステムに接続されているマウントターゲットを手動で削除する必要があります。このステップは、AWS コンソールを使用してファイルシステムを削除するときに自動的に実行されます。

注記

EFS レプリケーション設定の一部であるファイルシステムを削除することはできません。レプリケーション設定を最初に削除する必要があります。

使用中のファイルシステムを削除することはできません。つまり、ファイルシステムにマウントターゲットがある場合は、まずマウントターゲットを削除する必要があります。詳細については、「DescribeMountTargets」および「DeleteMountTarget」を参照してください。

注記

DeleteFileSystem コールは、ファイルシステムの状態がまだ deleting である間に戻ります。ファイルシステムの削除状況をチェックするには、アカウント内のファイルシステムのリストを返す DescribeFileSystems オペレーションをコールします。削除されたファイルシステムのファイルシステム ID または作成 トークンを渡した場合、DescribeFileSystems404 FileSystemNotFound のエラーを返します。

このオペレーションには、elasticfilesystem:DeleteFileSystem アクションに対する許可が必要です。

リクエストの構文

DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

FileSystemId

削除するファイルシステムの ID。

長さの制限:最大長は 128 です。

パターン:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必須: はい

リクエストボディ

リクエストにリクエスト本文がありません。

レスポンスの構文

HTTP/1.1 204

レスポンス要素

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。

エラー

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。

HTTP ステータスコード:400

FileSystemInUse

ファイルシステムに、マウントターゲットがある場合に返されます。

HTTP ステータスコード: 409

FileSystemNotFound

指定された FileSystemId 値がリクエスタの AWS アカウント に存在しない場合に返されます。

HTTP ステータスコード: 404

InternalServerError

サーバー側でエラーが発生した場合に返されます。

HTTP ステータスコード:500

ファイルシステムの削除

次の例では、file-systems エンドポイント(elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567)に DELETE リクエストを送信して、ID が fs-01234567 のファイルシステムを削除します。

リクエスト例

DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T233021Z Authorization: <...>

レスポンス例

HTTP/1.1 204 No Content x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33 Content-Length: 0

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。