翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateFileSystem スループットモード、または既存のファイルシステムのプロビジョニングされたスループットの量を更新します。 ## リクエストの構文 ``` PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1 Content-type: application/json { "ProvisionedThroughputInMibps": number, "ThroughputMode": "string" } ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) ** 更新するファイル システムの 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](#API_UpdateFileSystem_RequestSyntax) ** (オプション) 作成するファイルシステムにプロビジョニングするスループットを、毎秒メビバイト (MiBps) で計測します。`ThroughputMode` が `provisioned` に設定されている場合は必須です。有効な値は 1～3414 MiBps で、上限はリージョンによって異なります。この制限を引き上げるには、 にお問い合わせください サポート。詳細については、*Amazon EFS ユーザーガイド*の「[引き上げ可能な Amazon EFS クォータ](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)」を参照してください。 型: 倍精度浮動小数点数 値の範囲: 最小値 は 1.0 です。 必須: いいえ ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) ** （オプション）ファイル システムのスループットモードを更新します。スループットモードを更新しない場合は、リクエストでこの値を指定する必要はありません。`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" } ``` ## レスポンス要素 アクションが成功すると、HTTP 202 レスポンスが返されます。 サービスから以下のデータが JSON 形式で返されます。 ** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムが配置されているアベイラビリティーゾーンの一意で一貫性のある識別子。これは、1 ゾーンファイルシステムでのみ有効です。たとえば、 `use1-az1`は us-east-1 のアベイラビリティーゾーン ID であり AWS リージョン、すべての に同じ場所があります AWS アカウント。 タイプ: 文字列 ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムが配置されている AWS アベイラビリティーゾーンについて説明し、1 ゾーンファイルシステムでのみ有効です。詳細については、「**Amazon EFS ユーザーガイド」の「[EFS ストレージクラスの使用](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)」を参照してください。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長 64 パターン: `.+` ** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムが作成された時間 (秒単位) (1970-01-01T00:00:00Z から)。 型: タイムスタンプ ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** リクエストで指定された不透明な文字列。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長 64 パターン: `.+` ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) ** true の場合はファイルシステムの暗号化を示すブール値。 型: ブール値 ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Amazon EFS によって割り当てられるファイルシステムの ID。 タイプ: 文字列 長さの制約: 最大長は 128 です。 パターン: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムの保護について説明します。 型: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) オブジェクト ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) ** 暗号化されたファイルシステムの保護 AWS KMS key に使用される の ID。 タイプ: 文字列 長さの制約: 最大長は 2,048 です。 パターン: `^([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](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムのライフサイクルフェーズ。 型: 文字列 有効な値：`creating | available | updating | deleting | deleted | error` ** [Name](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムには、`Name` タグをはじめとするタグを追加することができます。詳細については、「[CreateFileSystem](API_CreateFileSystem.md)」を参照してください。ファイルシステムに `Name` タグがある場合、Amazon EFS はこのフィールドの値を返します。 タイプ: 文字列 長さの制約: 最大長は 256 です。 パターン: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` ** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムが持つ現在のマウントターゲットの数。詳細については、「[CreateMountTarget](API_CreateMountTarget.md)」を参照してください。 型: 整数 有効範囲: 最小値 は 0 です。 ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムを AWS アカウント 作成した 。 タイプ: 文字列 長さの制限: 最大長は 14 です。 パターン: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) ** ファイル システムのパフォーマンス モード。 型: 文字列 有効な値：`generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムのプロビジョニングされたスループットの量を MiBps で表したもの。`ThroughputMode` を `provisioned` に設定したファイルシステムに有効です。 型: 倍精度浮動小数点数 有効な範囲: 最小値 は 1.0 です。 ** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムに保存されているデータの最新の測定サイズ（バイト）を `Value` のフィールドに、そのサイズが決定された時間を `Timestamp` のフィールドに入力しています。`Timestamp` 値は、1970-01-01T00:00:00Z 以降の整数秒数です。`SizeInBytes`値は、ファイルシステムの一貫したスナップショットのサイズを表すものではありませんが、ファイルシステムへの書き込みがない場合に結果整合性があります。つまり、`SizeInBytes`は、ファイルシステムが 2 時間以上変更されていない場合のみ、実際のサイズを表します。それ以外の場合、値はファイルシステムの特定の時点での正確なサイズではありません。 型: [FileSystemSize](API_FileSystemSize.md) オブジェクト ** [Tags](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムに関連するタグで、`Tag` のオブジェクトの配列として表示されます。 型: [Tag](API_Tag.md) オブジェクトの配列 ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) ** ファイルシステムのスループットモードを表示。詳細については、「**Amazon EFS ユーザーガイド」の「[スループットモード](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)」を参照してください。 型: 文字列 有効な値：`bursting | provisioned | elastic` ## エラー ** BadRequest ** リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 400 ** FileSystemNotFound ** 指定された`FileSystemId`値がリクエスタの に存在しない場合に返されます AWS アカウント。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 404 ** IncorrectFileSystemLifeCycleState ** ファイルシステムのライフサイクル状態が「使用可能」でない場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 409 ** InsufficientThroughputCapacity ** 追加のスループットをプロビジョニングするのに十分な容量がない場合に返されます。この値は、プロビジョニングされたスループットモードでファイルシステムを作成しようとしたとき、既存のファイルシステムのプロビジョニングされたスループットを上げようとしたとき、または既存のファイルシステムをバーストからプロビジョニングされたスループットモードに変更しようとしたときに返されることがあります。後でもう一度お試しください。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 503 ** InternalServerError ** サーバー側でエラーが発生した場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 500 ** ThroughputLimitExceeded ** スループット制限の 1024 MiB/s に達したため、スループットモードまたはプロビジョニングされたスループットの量を変更できない場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 400 ** TooManyRequests ** スループットモードを変更するか、プロビジョニングされたスループット値を減らす前に少なくとも 24 時間以上待たない場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 429 ## 以下も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)