本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 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) ** 文件系统所在可用区的唯一且一致的标识符，仅对单区域文件系统有效。例如，`use1-az1`是 us-east AWS 区域-1 的可用区 ID，它在每个可用区中的位置都相同。 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 起）。类型：时间戳 ** [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) ** 文件系统 ID，由 Amazon EFS 分配。类型：字符串长度限制：最大长度为 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` 的文件系统有效。类型：双精度有效范围：最小值为 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 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量 MiB/s ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ** TooManyRequests ** 如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：429 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS Python 软件开发工具包](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)