本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 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) ** (選用) 您要為所建立檔案系統佈建的輸送量 (以 MiB/s 為單位)。若將 `ThroughputMode` 設為 `provisioned`，則為必要項目。有效值為 1 - 3414 MiBps，上限視「地區」而定。若要提高此限制，請聯絡支援。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的[您可以增加的 Amazon EFS 配額](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)。類型：Double 有效範圍：最小值為 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) ** 檔案系統所在可用區域的唯一且一致的識別碼僅對單區域有效。例如， `use1-az1` 是 us-east-1 的可用區域 ID AWS 區域，且每個都有相同的位置 AWS 帳戶。類型：字串 ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) ** 描述檔案系統所在的 AWS 可用區域，且僅適用於單區域檔案系統。如需詳細資訊，請參閱《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 以來)。類型：Timestamp ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** 請求中指定的不透明字串。類型：字串長度限制：長度下限為 1。長度上限為 64。模式：`.+` ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) ** 布林值，若為 true，指出加密檔案系統。類型：布林值 ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** Amazon EFS 檔案系統的 Amazon Resource Name (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。類型：字串長度限制：長度上限為 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](#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` 的檔案系統有效。類型：Double 有效範圍：最小值為 1.0。 ** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) ** 儲存在檔案系統、`Value` 欄位中的資料最新已知計量大小 (以位元組為單位)，以及在 `Timestamp` 欄位中決定該大小的時間。`Timestamp` 值是自 1970-01-01T00:00:00Z 以來的整數秒數。`SizeInBytes` 值不代表檔案系統的一致快照集大小，但是在沒有寫入檔案系統時，它最終會保持一致。也就是說，只有超過幾個小時未修改檔案系統，`SizeInBytes` 才能表示實際大小。否則，該值并不能代表檔案系統在任何時間點的確切大小。類型：[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 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** 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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)