UpdateFileSystem - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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

(可选)您要为正在创建的文件系统预配置的吞吐量,以兆字节每秒 (MiBps) 为单位。如果将 ThroughputMode 设置为 provisioned,则是必需的。有效值为 1-3414 MiBps,上限视区域而定。要提高此限制,请联系 Amazon Web Services Support。有关更多信息,请参阅《Amazon EFS 用户指南》中的您可以提高的 Amazon EFS 配额

类型:双精度

有效范围:最小值为 1.0。

必需:否

ThroughputMode

(可选)更新文件系统的吞吐量模式。如果不更新吞吐量模式,则无需在请求中提供此值。如果将 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

文件系统所在可用区的唯一且一致的标识符,仅对单区域文件系统有效。例如,use1-az1 是 us-east-1 Amazon Web Services 区域的可用区 ID,它在每个 Amazon Web Services 账户中的位置均相同。

类型:字符串

AvailabilityZoneName

描述文件系统所在的 Amazon 可用区,仅对单区文件系统有效。有关更多信息,请参阅《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

文件系统 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

描述文件系统上的保护功能。

类型:FileSystemProtectionDescription 对象

KmsKeyId

用于保护加密文件系统的 Amazon 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

创建文件系统的 Amazon Web Services 账户。

类型:字符串

长度限制:最大长度为 14。

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

PerformanceMode

文件系统的性能模式。

类型:字符串

有效值:generalPurpose | maxIO

ProvisionedThroughputInMibps

文件系统的预配置吞吐量(以 MiBps衡量单位)。对使用将 ThroughputMode 设置为 provisioned 的文件系统有效。

类型:双精度

有效范围:最小值为 1.0。

SizeInBytes

文件系统中存储的数据的最新已知计量大小(以字节为单位)(在其 Value 字段中),以及确定该大小的时间(在其 Timestamp 字段中)。Timestamp 值是自 1970-01-01T00:00:00Z 以来的整数秒数。SizeInBytes 值并不代表文件系统一致快照的大小,但是当没有写入文件系统时,该值最终会保持一致。也就是说,只有在超过几个小时的时间内未修改文件系统时,SizeInBytes 才表示实际大小。否则,该值不是文件系统在任何时间点的确切大小。

类型:FileSystemSize 对象

Tags

与文件系统关联的标签,以 Tag 对象数组形式呈现。

类型:Tag 对象数组

ThroughputMode

显示文件系统的吞吐量模式。有关更多信息,请参阅《Amazon EFS 用户指南》中的吞吐量模式

类型:字符串

有效值:bursting | provisioned | elastic

错误

BadRequest

如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。

HTTP 状态代码:400

FileSystemNotFound

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

HTTP 状态代码:404

IncorrectFileSystemLifeCycleState

如果文件系统的生命周期状态不是“可用”,则返回此内容。

HTTP 状态代码:409

InsufficientThroughputCapacity

如果没有足够的容量来预置额外的吞吐量,则返回此内容。尝试在预配置吞吐量模式下创建文件系统,尝试增加现有文件系统的预配置吞吐量,或尝试将现有文件系统从突增吞吐量模式更改为预配置吞吐量模式时,可能会返回此值。请稍后重试。

HTTP 状态代码:503

InternalServerError

如果服务器端发生错误,则返回此内容。

HTTP 状态代码:500

ThroughputLimitExceeded

如果由于已达到 1024 MiB/s 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量,则返回此值。

HTTP 状态代码:400

TooManyRequests

如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时,则返回。

HTTP 状态代码:429

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: