本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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,上限视区域而定。要提高此限制,请联系 AWS Support。有关更多信息,请参阅《亚马逊EFS用户指南》中您可以增加的亚马逊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 AWS 区域-1 的可用区 ID,它在每个可用区中的位置都相同。 AWS 账户类型:字符串
- AvailabilityZoneName
-
描述文件系统所在的 AWS 可用区,并且仅对单区域文件系统有效。有关更多信息,请参阅 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
-
描述文件系统上的保护功能。
- KmsKeyId
-
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
-
文件系统的生命周期阶段。
类型:字符串
有效值:
creating | available | updating | deleting | deleted | error
- Name
-
可以向文件系统添加标签,包括
Name
标签。有关更多信息,请参阅 CreateFileSystem。如果文件系统有Name
标签,Amazon 会EFS返回此字段中的值。类型:字符串
长度约束:最大长度为 256。
模式:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
- NumberOfMountTargets
-
文件系统当前的挂载目标数。有关更多信息,请参阅 CreateMountTarget。
类型:整数
有效范围:最小值为 0。
- OwnerId
-
AWS 账户 创建文件系统的。
类型:字符串
长度限制:最大长度为 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
-
如果请求者的指定
FileSystemId
值不存在,则返回。 AWS 账户HTTP状态码:404
- IncorrectFileSystemLifeCycleState
-
如果文件系统的生命周期状态不是“可用”,则返回此内容。
HTTP状态码:409
- InsufficientThroughputCapacity
-
如果没有足够的容量来预置额外的吞吐量,则返回此内容。尝试在预配置吞吐量模式下创建文件系统,尝试增加现有文件系统的预配置吞吐量,或尝试将现有文件系统从突增吞吐量模式更改为预配置吞吐量模式时,可能会返回此值。请稍后重试。
HTTP状态码:503
- InternalServerError
-
如果服务器端发生错误,则返回此内容。
HTTP状态码:500
- ThroughputLimitExceeded
-
如果由于已达到 1024 MiB/s 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量,则返回此值。
HTTP状态码:400
- TooManyRequests
-
如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时,则返回。
HTTP状态码:429
另请参阅
有关API在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: