UpdateFileSystem - Amazon Elastic File System

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

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) で測定されます。ThroughputModeprovisioned に設定されている場合は必須です。有効な値は 1~3414 で MiBps、上限はリージョンによって異なります。この制限を引き上げるには、 にお問い合わせください AWS Support。詳細については、「Amazon ユーザーガイドEFS」の「引き上げることができる Amazon クォータEFS」を参照してください。

型: 倍精度

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

必須:いいえ

ThroughputMode

(オプション)ファイル システムのスループットモードを更新します。スループットモードを更新しない場合は、リクエストでこの値を指定する必要はありません。ThroughputModeprovisioned に変更する場合、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します。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

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、以下を参照してください。