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 です。

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

必須 あり

リクエストボディ

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

ProvisionedThroughputInMibps

(任意)ファイルシステムに対してプロビジョニングされるスループットの量(MIB/秒)を設定します。有効な値は、1~1024 です。スループットモードをプロビジョニング済みに変更する場合は、プロビジョニングされたスループットの量も指定する必要があります。次の場合に必須ThroughputModeはに変更されます。provisioned更新時。

Type: Double

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

必須 いいえ

ThroughputMode

(任意)ファイルシステムのスループットモードを更新します。スループットモードを更新しない場合は、リクエストでこの値を指定する必要はありません。あなたが変更している場合ThroughputModeprovisionedの値も設定する必要があります。ProvisionedThroughputInMibps

Type: 文字列

有効な値: bursting | provisioned

必須 いいえ

レスポンスの構文

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

レスポンス要素

アクションが成功すると、HTTP 202 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

AvailabilityZoneId

ファイルシステムの 1 ゾーンストレージクラスが存在するアベイラビリティーゾーンの一意で一貫性のある識別子。たとえば、use1-az1us-east-1 のアベイラビリティーゾーン ID ですか AWS リージョン であり、すべての場所で同じ場所になります AWS アカウント 。

Type: 文字列

AvailabilityZoneName

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

Type: 文字列

長さ制約: 最小長は 1 です。 最大長は 64 です。

Pattern: .+

CreationTime

ファイルシステムが作成された時間 (1970-01-01T 00:00:00 Z) を秒単位で指定します。

Type: タイムスタンプ

CreationToken

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

Type: 文字列

長さ制約: 最小長は 1 です。 最大長は 64 です。

Pattern: .+

Encrypted

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

Type: ブール値

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

Type: 文字列

FileSystemId

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

Type: 文字列

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

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

KmsKeyId

のIDAWS Key Management Service暗号化されたファイルシステムの保護に使用されたカスタマーマスターキー (CMK)。

Type: 文字列

長さの制限: 最大長は 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/_-]+))))$

LifeCycleState

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

Type: 文字列

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

Name

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

Type: 文字列

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

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

NumberOfMountTargets

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

Type: 整数

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

OwnerId

- AWS アカウント ファイルシステムを作成しました。ファイルシステムが IAM ユーザーによって作成された場合、ユーザーが属する親アカウントが所有者です。

Type: 文字列

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

Pattern: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

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

Type: 文字列

有効な値: generalPurpose | maxIO

ProvisionedThroughputInMibps

ファイルシステムのプロビジョニングされたスループット (MiB/秒単位で計測)。を使ってファイルシステムに対して有効ThroughputModeに設定するprovisioned

Type: Double

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

SizeInBytes

ファイル・システムに格納されているデータの最新の既知のメーター・サイズ(バイト単位)。Valueフィールド、およびそのサイズがその中で決定された時刻Timestampフィールド。-Timestamp値は、1970-01T 00:00:00 Z からの整数秒数です。-SizeInBytes値は、ファイルシステムの整合したスナップショットのサイズを表すものではありませんが、最終的に、ファイルシステムへの書き込みがないときに整合されます。つまり、SizeInBytesは、ファイルシステムが 2 時間以上変更されていない場合のみ、実際のサイズを表します。それ以外の場合、値はファイルシステムの特定の時点での正確なサイズではありません。

タイプ: FileSystemSize オブジェクト

Tags

ファイルシステムに関連付けられたタグ。Tagオブジェクト。

Type: の配列 Tag objects

ThroughputMode

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

Type: 文字列

有効な値: bursting | provisioned

Errors

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

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

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