CreateFileSystem - Amazon Elastic File System

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

CreateFileSystem

空のファイルシステムを新しく作成します。オペレーションでは、冪等性の作成を確保するために Amazon がEFS使用するリクエストに作成トークンが必要です (同じ作成トークンでオペレーションを呼び出しても効果はありません)。指定された作成トークン AWS アカウント を持つ発信者の が所有するファイルシステムが現在存在しない場合、このオペレーションは以下を実行します。

  • 空のファイルシステムを新しく作成します。ファイルシステムには、Amazon EFSに割り当てられた ID と初期ライフサイクル状態 がありますcreating

  • 作成したファイルシステムの説明を返します。

それ以外の場合、このオペレーションは既存のファイルシステムの ID とともに FileSystemAlreadyExists エラーを返します。

注記

基本的なユースケースでは、作成トークンにランダムに生成された UUID を使用できます。

べき等のオペレーションを使用すると、余分なファイルシステムを作成するリスクなしに CreateFileSystem コールを再試行できます。これは、ファイルシステムが実際に作成されたかどうかが不明確なまま、最初のコールが失敗したときに発生する可能性があります。例としては、トランスポートレベルのタイムアウトが発生したか、接続がリセットされたことが挙げられます。同じ作成 トークンを使用している限り、最初のコールでファイルシステムの作成に成功した場合、クライアントは FileSystemAlreadyExists エラーからその存在を知ることができます。

詳細については、「Amazon ユーザーガイド」の「ファイルシステムの作成」を参照してください。 EFS

注記

CreateFileSystem コールは、ファイルシステムのライフサイクル状態がまだ creating である間に戻ります。DescribeFileSystems オペレーションをコールすることでファイルシステムの作成ステータスをチェックできます。これにより、ファイルシステムの状態が返されます。

このオペレーションでは、ファイルシステム用に選択したオプションの PerformanceMode パラメータを受け入れます。すべてのファイルシステムに generalPurpose PerformanceMode をお勧めします。maxIO モードは前世代のパフォーマンスタイプであり、generalPurpose モードよりも高いレイテンシーを許容できる高度に並列化されたワークロード向けに設計されています。MaxIO モードは、1 ゾーンファイルシステムやエラスティックスループットを使用するファイルシステムではサポートされません。

PerformanceMode は、ファイルシステムの作成後は変更できません。詳細については、「Amazon EFSパフォーマンスモード」を参照してください。

ファイルシステムのスループットモードは、ThroughputModeパラメータで設定できます。

ファイルシステムが完全に作成されると、Amazon はそのライフサイクル状態を EFSに設定しavailable、その時点で でファイルシステムの 1 つ以上のマウントターゲットを作成できますVPC。詳細については、「CreateMountTarget」を参照してください。マウントターゲットVPCを使用して、Amazon EFS ファイルシステムを のEC2インスタンスにマウントします。詳細については、「Amazon EFS: の仕組み」を参照してください。

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

ファイルシステムは作成時にタグ付けできます。作成アクションでタグが指定されている場合、 はelasticfilesystem:TagResourceアクションに対して追加の認証IAMを実行して、ユーザーがタグを作成するアクセス許可を持っているかどうかを確認します。したがって、elasticfilesystem:TagResource アクションを使用するための明示的なアクセス許可を付与する必要があります。詳細については、「リソース作成時にタグ付けするアクセス許可の付与」を参照してください。

リクエストの構文

POST /2015-02-01/file-systems HTTP/1.1 Content-type: application/json { "AvailabilityZoneName": "string", "Backup": boolean, "CreationToken": "string", "Encrypted": boolean, "KmsKeyId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" }

URI リクエストパラメータ

リクエストはURIパラメータを使用しません。

リクエスト本文

リクエストは、 JSON形式の次のデータを受け入れます。

AvailabilityZoneName

1 ゾーンファイルシステムの場合は、ファイルシステムを作成する AWS アベイラビリティーゾーンを指定します。形式 us-east-1a を使用して、アベイラビリティーゾーンを指定します。1 ゾーンファイルシステムの詳細については、「Amazon ユーザーガイド」のEFS「ファイルシステムタイプ」を参照してください。 EFS

注記

1 ゾーンファイルシステムは、Amazon AWS リージョン が利用可能な のすべてのアベイラビリティーゾーンでEFS利用できるわけではありません。

型: 文字列

長さの制限:最小長は 1 です。最大長は 64 文字です。

パターン: .+

必須: いいえ

Backup

作成するファイルシステム上で自動バックアップを有効にするかどうかを指定します。自動バックアップを有効にするには、値を true に設定します。1 ゾーンファイルシステムを作成している場合、デフォルトで自動バックアップが有効になります。詳細については、「Amazon EFSユーザーガイド」の「自動バックアップ」を参照してください。

デフォルトは false です。ただし、AvailabilityZoneName を指定した場合、デフォルトは true です。

注記

AWS Backup は、Amazon EFS が利用可能なすべての AWS リージョン で利用できるわけではありません。

型: ブール値

必須:いいえ

CreationToken

最大 64 ASCII文字の文字列。Amazon EFS はこれを使用して冪等性の作成を行います。

型: 文字列

長さの制限:最小長は 1 です。最大長は 64 文字です。

パターン: .+

必須:はい

Encrypted

このブール値が true の場合、暗号化されたファイルシステムが作成されます。暗号化されたファイルシステムを作成するときは、既存の AWS Key Management Service キー (KMS キー) を指定できます。KMS キーを指定しない場合、暗号化されたファイルシステムの保護には EFSAmazon /aws/elasticfilesystemのデフォルトKMSキー が使用されます。

型: ブール値

必須:いいえ

KmsKeyId

暗号化されたファイルシステムの保護に使用するKMSキーの ID。このパラメータは、デフォルト以外のKMSキーを使用する場合にのみ必要です。このパラメータを指定しない場合、Amazon のデフォルトKMSキーEFSが使用されます。次の形式を使用してKMSキー ID を指定できます。

  • キー ID - キーの一意の識別子 (例: 1234abcd-12ab-34cd-56ef-1234567890ab)。

  • ARN - キーの Amazon リソースネーム (ARN)。例: arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • キーのエイリアス - 以前に作成したキーの表示名 (例: alias/projectKey1)。

  • キーエイリアス ARN- ARNキーエイリアスの 。例: arn:aws:kms:us-west-2:444455556666:alias/projectKey1

を使用する場合はKmsKeyIdCreateFileSystem:Encrypted パラメータを true に設定する必要があります。

重要

EFS は対称KMSキーのみを受け入れます。Amazon EFS ファイルシステムでは非対称KMSキーを使用できません。

型: 文字列

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

Pattern: ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

必須: いいえ

PerformanceMode

ファイル システムのパフォーマンス モード。すべてのファイルシステムに generalPurpose パフォーマンスモードをお勧めします。maxIO パフォーマンスモードを使用しているファイルシステムでは、ほとんどのファイルオペレーションのレイテンシーがわずかに大きくなる代わりに、より高いレベルの集計スループットと 1 秒あたりのオペレーションにスケールできます。パフォーマンスモードは、ファイルシステムの作成後は変更できません。maxIO モードは、1 ゾーンファイルシステムではサポートされません。

重要

最大 I/O ではオペレーションごとのレイテンシーが高くなるため、すべてのファイルシステムに汎用パフォーマンスモードを使用することをお勧めします。

デフォルトは generalPurpose です。

型: 文字列

有効な値:generalPurpose | maxIO

必須:いいえ

ProvisionedThroughputInMibps

作成するファイルシステムにプロビジョニングするスループット (1 秒あたりのメビバイト数MiBps) で測定されます。ThroughputModeprovisioned に設定されている場合は必須です。有効な値は 1~3414 で MiBps、上限はリージョンによって異なります。この制限を引き上げるには、 にお問い合わせください AWS Support。詳細については、「Amazon ユーザーガイドEFS」の「引き上げることができる Amazon クォータEFS」を参照してください。

型: 倍精度

値の範囲: 最小値 は 1.0 です。

必須:いいえ

Tags

ファイルシステムに関連付けられている 1 つ以上のタグを作成するために使用します。各タグはユーザー定義のキーバリューのペアです。"Key":"Name","Value":"{value}" キーバリューのペアを含めることで、作成時にファイルシステムに名前を付けます。各キーは一意である必要があります。詳細については、「 AWS 全般のリファレンスガイド」の「 AWS リソースのタグ付け」を参照してください。

型: Tag オブジェクトの配列

必須:いいえ

ThroughputMode

ファイルシステムのスループットモードを指定します。モードには、burstingprovisionedelastic などがあります。ThroughputModeprovisioned に設定した場合、ProvisionedThroughputInMibps の値も設定する必要があります。ファイルシステムを作成した後は、一定の時間制限付きで、ファイルシステムのプロビジョニングされたスループットを下げたり、スループットモードを変更したりすることができます。詳細については、「Amazon ユーザーガイド」の「プロビジョニングモードでのスループットの指定」を参照してください。 EFS

デフォルトは bursting です。

型: 文字列

有効な値:bursting | provisioned | elastic

必須:いいえ

レスポンスの構文

HTTP/1.1 201 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "FileSystemProtection": { "ReplicationOverwriteProtection": "string" }, "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInArchive": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" }

レスポンス要素

アクションが成功すると、サービスは 201 HTTP レスポンスを返します。

次のデータは、 サービスによって JSON 形式で返されます。

AvailabilityZoneId

ファイルシステムが配置されているアベイラビリティーゾーンの一意で一貫性のある識別子。これは、1 ゾーンファイルシステムでのみ有効です。例えば、 use1-az1は us-east-1 のアベイラビリティーゾーン ID であり AWS リージョン、すべての に同じ場所があります AWS アカウント。

型: 文字列

AvailabilityZoneName

ファイルシステムが配置されている AWS アベイラビリティーゾーンを記述し、1 ゾーンファイルシステムでのみ有効です。詳細については、「Amazon ユーザーガイド」のEFS「ストレージクラスの使用」を参照してください。 EFS

型: 文字列

長さの制限:最小長は 1 です。最大長は 64 文字です。

パターン: .+

CreationTime

ファイルシステムが作成された時間 (秒単位) (1970-01-01T00:00:00Z から)。

型: タイムスタンプ

CreationToken

リクエストで指定された不透明な文字列。

型: 文字列

長さの制限:最小長は 1 です。最大長は 64 文字です。

パターン: .+

Encrypted

true の場合はファイルシステムの暗号化を示すブール値。

型: ブール値

FileSystemArn

EFS ファイルシステムの Amazon リソースネーム (ARN) の形式は ですarn:aws:elasticfilesystem:region:account-id:file-system/file-system-id 。サンプルデータの例:arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567

型: 文字列

FileSystemId

Amazon によって割り当てられたファイルシステムの IDEFS。

型: 文字列

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

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

FileSystemProtection

ファイルシステムの保護について説明します。

タイプ:FileSystemProtectionDescription オブジェクト

KmsKeyId

暗号化されたファイルシステムの保護 AWS KMS key に使用される の ID。

型: 文字列

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

パターン:^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

LifeCycleState

ファイルシステムのライフサイクルフェーズ。

型: 文字列

有効な値:creating | available | updating | deleting | deleted | error

Name

ファイルシステムには、Name タグをはじめとするタグを追加することができます。詳細については、「CreateFileSystem」を参照してください。ファイルシステムにNameタグがある場合、Amazon はこのフィールドの値EFSを返します。

型: 文字列

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

パターン:^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

ファイルシステムが持つ現在のマウントターゲットの数。詳細については、「CreateMountTarget」を参照してください。

型: 整数

有効な範囲: 最小値 は 0 です。

OwnerId

ファイルシステムを AWS アカウント 作成した 。

型: 文字列

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

パターン:^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

ファイル システムのパフォーマンス モード。

型: 文字列

有効な値:generalPurpose | maxIO

ProvisionedThroughputInMibps

MiBpsファイルシステムの で測定されたプロビジョニングされたスループットの量。ThroughputModeprovisioned に設定したファイルシステムに有効です。

型: 倍精度浮動小数点数

有効な範囲: 最小値 は 1.0 です。

SizeInBytes

ファイルシステムに保存されているデータの最新の測定サイズ(バイト)を Value のフィールドに、そのサイズが決定された時間を Timestamp のフィールドに入力しています。Timestamp 値は、1970-01-01T00:00:00Z 以降の整数秒数です。SizeInBytes値は、ファイルシステムの一貫したスナップショットのサイズを表すものではありませんが、ファイルシステムへの書き込みがない場合に結果整合性があります。つまり、SizeInBytesは、ファイルシステムが 2 時間以上変更されていない場合のみ、実際のサイズを表します。それ以外の場合、値はファイルシステムの特定の時点での正確なサイズではありません。

型: FileSystemSize オブジェクト

Tags

ファイルシステムに関連するタグで、Tag のオブジェクトの配列として表示されます。

型: Tag オブジェクトの配列

ThroughputMode

ファイルシステムのスループットモードを表示。詳細については、「Amazon ユーザーガイド」の「スループットモード」を参照してください。 EFS

型: 文字列

有効な値:bursting | provisioned | elastic

エラー

BadRequest

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

HTTP ステータスコード: 400

FileSystemAlreadyExists

作成しようとしているファイルシステムがすでに存在し、指定した作成トークンを使用して返されます。

HTTP ステータスコード: 409

FileSystemLimitExceeded

AWS アカウント がアカウントごとに許可されるファイルシステムの最大数を既に作成している場合に返されます。

HTTP ステータスコード: 403

InsufficientThroughputCapacity

追加のスループットをプロビジョニングするのに十分な容量がない場合に返されます。この値は、プロビジョニングされたスループットモードでファイルシステムを作成しようとしたとき、既存のファイルシステムのプロビジョニングされたスループットを上げようとしたとき、または既存のファイルシステムをバーストからプロビジョニングされたスループットモードに変更しようとしたときに返されることがあります。後でもう一度お試しください。

HTTP ステータスコード: 503

InternalServerError

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

HTTP ステータスコード: 500

ThroughputLimitExceeded

スループット制限の 1024 MiB/s に達したため、スループットモードまたはプロビジョニングされたスループットの量を変更できない場合に返されます。

HTTP ステータスコード: 400

UnsupportedAvailabilityZone

リクエストされた Amazon EFS機能が指定されたアベイラビリティーゾーンで使用できない場合に返されます。

HTTP ステータスコード: 400

暗号化されたEFSファイルシステムを作成する

次の例では、自動バックアップを有効にして us-west-2リージョンにファイルシステムを作成するPOSTリクエストを送信します。このリクエストでは、べき等の作成トークンとして myFileSystem1 を指定します。

リクエスト例

POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem1", "PerformanceMode" : "generalPurpose", "Backup": true, "Encrypted": true, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] }

レスポンス例

HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" }

1 ゾーンの可用性を備えた暗号化されたEFSファイルシステムを作成する

次の例では、自動バックアップを有効にして us-west-2リージョンにファイルシステムを作成するPOSTリクエストを送信します。ファイルシステムには、us-west-2b アベイラビリティーゾーンに 1 ゾーンストレージがあります。

リクエスト例

POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem2", "PerformanceMode" : "generalPurpose", "Backup": true, "AvailabilityZoneName": "us-west-2b", "Encrypted": true, "ThroughputMode": "elastic", "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] }

レスポンス例

HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "AvailabilityZoneId": "usew2-az2", "AvailabilityZoneName": "us-west-2b", "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" }

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

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