翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateFileSystem
スループットモード、または既存のファイルシステムのプロビジョニングされたスループットの量を更新します。
リクエストの構文
PUT /2015-02-01/file-systems/FileSystemId
HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number
,
"ThroughputMode": "string
"
}
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})$
必須: はい
リクエストボディ
リクエストは、 JSON形式の次のデータを受け入れます。
- ProvisionedThroughputInMibps
-
(オプション) 作成するファイルシステムにプロビジョニングするスループット。1 秒あたりのメビバイト数 (MiBps) で測定されます。
ThroughputMode
がprovisioned
に設定されている場合は必須です。有効な値は 1~3414 で MiBps、上限はリージョンによって異なります。この制限を引き上げるには、 にお問い合わせください AWS Support。詳細については、「Amazon ユーザーガイドEFS」の「引き上げることができる Amazon クォータEFS」を参照してください。型: 倍精度
値の範囲: 最小値 は 1.0 です。
必須:いいえ
- ThroughputMode
-
(オプション)ファイル システムのスループットモードを更新します。スループットモードを更新しない場合は、リクエストでこの値を指定する必要はありません。
ThroughputMode
をprovisioned
に変更する場合、ProvisionedThroughputInMibps
の値も設定する必要があります。型: 文字列
有効な値:
bursting | provisioned | elastic
必須:いいえ
レスポンスの構文
HTTP/1.1 202
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"
}
レスポンス要素
アクションが成功すると、サービスは 202 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
- FileSystemNotFound
-
指定された
FileSystemId
値がリクエスタの に存在しない場合に返されます AWS アカウント。HTTP ステータスコード: 404
- IncorrectFileSystemLifeCycleState
-
ファイルシステムのライフサイクル状態が「使用可能」でない場合に返されます。
HTTP ステータスコード: 409
- InsufficientThroughputCapacity
-
追加のスループットをプロビジョニングするのに十分な容量がない場合に返されます。この値は、プロビジョニングされたスループットモードでファイルシステムを作成しようとしたとき、既存のファイルシステムのプロビジョニングされたスループットを上げようとしたとき、または既存のファイルシステムをバーストからプロビジョニングされたスループットモードに変更しようとしたときに返されることがあります。後でもう一度お試しください。
HTTP ステータスコード: 503
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
HTTP ステータスコード: 500
- ThroughputLimitExceeded
-
スループット制限の 1024 MiB/s に達したため、スループットモードまたはプロビジョニングされたスループットの量を変更できない場合に返されます。
HTTP ステータスコード: 400
- TooManyRequests
-
スループットモードを変更するか、プロビジョニングされたスループット値を減らす前に少なくとも 24 時間以上待たない場合に返されます。
HTTP ステータスコード: 429
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。