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

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

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

(可选)设置文件系统的预配置吞吐量(以 MIB/s 为单位)。有效值为 1-1024。如果要将吞吐量模式更改为预配置,则还必须提供预配置吞吐量。如果必需ThroughputMode已更改为provisioned更新。

类型: Double

有效范围:最小值为 1.0。

:必需 否

ThroughputMode

(可选)更新文件系统的吞吐量模式。如果您没有更新吞吐量模式,则无需在请求中提供此值。如果你正在更改ThroughputModeprovisioned,还必须为设置的值ProvisionedThroughputInMibps.

类型: String

有效值: 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

存在文件系统的 One Zone Zone 存储类的可用区的唯一且一致的标识符。例如,use1-az1是 us-east-1 的可用区 IDAmazon Web Services 区域,它在每个人中都有相同的位置Amazon Web Services 账户.

类型: String

AvailabilityZoneName

描述Amazon文件系统所在的可用区,且仅对使用 “一个区域” 存储类的文件系统有效。有关更多信息,请参阅 。使用 EFS 存储类中的Amazon EFS 用户指南.

类型: String

长度约束:最小长度为 1。最大长度为 64。

模式:.+

CreationTime

创建文件系统的时间(以秒为单位)(自 1970-01-01T00:00:00 Z)。

类型: 时间戳

CreationToken

请求中指定的不透明字符串。

类型: String

长度约束:最小长度为 1。最大长度为 64。

模式:.+

Encrypted

一个布尔值,如果设为 true,则指示文件系统已加密。

类型: Boolean

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

类型: String

FileSystemId

Amazon EFS 分配的文件系统 ID。

类型: String

长度约束:长度上限为 128。

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

KmsKeyId

的 IDAmazon Key Management Service用于保护加密文件系统的客户主密钥 (CMK)。

类型: String

长度约束:长度上限为 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

文件系统的生命周期阶段。

类型: String

有效值: creating | available | updating | deleting | deleted | error

Name

您可以将标签添加到文件系统中,包括Name标签。有关更多信息,请参阅CreateFileSystem。如果文件系统有Name标签,Amazon EFS 将返回此字段中的值。

类型: String

长度约束:长度上限为 256。

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

NumberOfMountTargets

文件系统当前拥有的装载目标数。有关更多信息,请参阅CreateMountTarget

类型: 整数

有效范围:最小值为 0。

OwnerId

这些区域有:Amazon Web Services 账户创建文件系统。如果文件系统是由 IAM 用户创建的,则该用户所属的父账户为拥有者。

类型: String

长度约束:长度上限为 14。

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

PerformanceMode

文件系统的性能模式。

类型: String

有效值: generalPurpose | maxIO

ProvisionedThroughputInMibps

文件系统的预配置吞吐量(以 MiB/s 为单位)。对使用的文件系统有效ThroughputMode设置为provisioned.

类型: Double

有效范围:最小值为 1.0。

SizeInBytes

文件系统中存储的最新已知按计量计量的数据大小(以字节为单位),在其中Value字段,以及在其中确定该大小的时间Timestamp字段中返回的子位置类型。这些区域有:Timestamp值是 1970-01-01T00:00:00 Z 以来的秒数。这些区域有:SizeInBytesvalue 不表示文件系统的一致快照的大小,但在没有向文件系统写入内容时,它最终保持一致。也就是说,SizeInBytes只有在文件系统的修改时间超过几个小时时才表示实际大小。否则,该值不是文件系统在任何时间点的确切大小。

类型:FileSystemSize 对象

Tags

与文件系统关联的标签,显示为一组Tag对象。

类型: 数组Tagobjects

ThroughputMode

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

类型: String

有效值: bursting | provisioned

Errors

BadRequest

如果请求格式不正确或包含错误,例如无效的参数值或缺少必需参数,则返回此选项。

HTTP 状态代码:HTTP 状态 400

FileSystemNotFound

返回指定的FileSystemId请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码:HTTP 状态 404

IncorrectFileSystemLifeCycleState

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

HTTP 状态代码:HTTP 状态 409

InsufficientThroughputCapacity

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

HTTP 状态代码:HTTP 状态 503

InternalServerError

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

HTTP 状态代码:HTTP 状态 500

ThroughputLimitExceeded

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

HTTP 状态代码:HTTP 状态 400

TooManyRequests

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

HTTP 状态代码:HTTP 状态 429

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: