UpdateFileSystemProtection
更新文件系统的保护。
此操作需要 elasticfilesystem:UpdateFileSystemProtection
操作的权限。
请求语法
PUT /2015-02-01/file-systems/FileSystemId
/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "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 格式的以下数据。
- ReplicationOverwriteProtection
-
文件系统的复制覆盖保护的状态。
-
ENABLED
– 此文件系统不能用作复制配置中的目标文件系统。文件系统是可写的。默认情况下,复制覆盖保护功能处于ENABLED
状态。 -
DISABLED
– 此文件系统可以用作复制配置中的目标文件系统。文件系统是只读的,只能通过 EFS 复制进行修改。 -
REPLICATING
– 此文件系统正用作复制配置中的目标文件系统。文件系统是只读的,仅通过 EFS 复制进行修改。
如果删除复制配置,则文件系统的复制覆盖保护功能将重新启用,文件系统将变为可写状态。
类型:字符串
有效值:
ENABLED | DISABLED | REPLICATING
必需:否
-
响应语法
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- ReplicationOverwriteProtection
-
文件系统的复制覆盖保护的状态。
-
ENABLED
– 此文件系统不能用作复制配置中的目标文件系统。文件系统是可写的。默认情况下,复制覆盖保护功能处于ENABLED
状态。 -
DISABLED
– 此文件系统可以用作复制配置中的目标文件系统。文件系统是只读的,只能通过 EFS 复制进行修改。 -
REPLICATING
– 此文件系统正用作复制配置中的目标文件系统。文件系统是只读的,仅通过 EFS 复制进行修改。
如果删除复制配置,则文件系统的复制覆盖保护功能将重新启用,文件系统将变为可写状态。
类型:字符串
有效值:
ENABLED | DISABLED | REPLICATING
-
错误
- BadRequest
-
如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。
HTTP 状态代码:400
- FileSystemNotFound
-
如果请求者的 Amazon Web Services 账户中不存在指定的
FileSystemId
值,则返回此内容。HTTP 状态代码:404
- IncorrectFileSystemLifeCycleState
-
如果文件系统的生命周期状态不是“可用”,则返回此内容。
HTTP 状态代码:409
- InsufficientThroughputCapacity
-
如果没有足够的容量来预置额外的吞吐量,则返回此内容。尝试在预配置吞吐量模式下创建文件系统,尝试增加现有文件系统的预配置吞吐量,或尝试将现有文件系统从突增吞吐量模式更改为预配置吞吐量模式时,可能会返回此值。请稍后重试。
HTTP 状态代码:503
- InternalServerError
-
如果服务器端发生错误,则返回此内容。
HTTP 状态代码:500
- ReplicationAlreadyExists
-
如果文件系统已包含在复制配置中,则返回此内容。
HTTP 状态代码:409
- ThroughputLimitExceeded
-
如果由于已达到 1024 MiB/s 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量,则返回此值。
HTTP 状态代码:400
- TooManyRequests
-
如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时,则返回。
HTTP 状态代码:429
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: