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

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

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 的更多信息,请参阅以下内容: