翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
。
を使用する場合は
KmsKeyId
、CreateFileSystem: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) で測定されます。
ThroughputMode
がprovisioned
に設定されている場合は必須です。有効な値は 1~3414 で MiBps、上限はリージョンによって異なります。この制限を引き上げるには、 にお問い合わせください AWS Support。詳細については、「Amazon ユーザーガイドEFS」の「引き上げることができる Amazon クォータEFS」を参照してください。型: 倍精度
値の範囲: 最小値 は 1.0 です。
必須:いいえ
- Tags
-
ファイルシステムに関連付けられている 1 つ以上のタグを作成するために使用します。各タグはユーザー定義のキーバリューのペアです。
"Key":"Name","Value":"{value}"
キーバリューのペアを含めることで、作成時にファイルシステムに名前を付けます。各キーは一意である必要があります。詳細については、「 AWS 全般のリファレンスガイド」の「 AWS リソースのタグ付け」を参照してください。型: Tag オブジェクトの配列
必須:いいえ
- ThroughputMode
-
ファイルシステムのスループットモードを指定します。モードには、
bursting
、provisioned
、elastic
などがあります。ThroughputMode
をprovisioned
に設定した場合、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ファイルシステムの で測定されたプロビジョニングされたスループットの量。
ThroughputMode
をprovisioned
に設定したファイルシステムに有効です。型: 倍精度浮動小数点数
有効な範囲: 最小値 は 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、以下を参照してください。