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

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

ModifyMountTargetSecurityGroups

修改挂载目标的一组有效安全组。

创建挂载目标时,Amazon EFS 还会创建新网络接口。有关更多信息,请参阅CreateMountTarget。此操作将与挂载目标关联的网络接口的有效安全组替换为请求中提供的 SecurityGroups。此操作需要已创建挂载目标的网络接口,并且挂载目标的生命周期状态不是 deleted

此操作需要以下操作的权限:

  • 对挂载目标的文件系统执行 elasticfilesystem:ModifyMountTargetSecurityGroups 操作。

  • 在挂载目标的网络接口上执行 ec2:ModifyNetworkInterfaceAttribute 操作。

请求语法

PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 Content-type: application/json { "SecurityGroups": [ "string" ] }

URI 请求参数

请求使用以下 URI 参数。

MountTargetId

要修改其安全组的挂载目标 ID。

长度限制:最小长度为 13。最大长度为 45。

模式:^fsmt-[0-9a-f]{8,40}$

必需:是

请求体

请求接受采用 JSON 格式的以下数据。

SecurityGroups

最多包含五个 VPC 安全组 ID 的数组。

类型:字符串数组

数组成员:最多 100 项。

长度限制:最小长度为 11。最大长度为 43。

模式:^sg-[0-9a-f]{8,40}

必需:否

响应语法

HTTP/1.1 204

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。

错误

BadRequest

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

HTTP 状态代码:400

IncorrectMountTargetState

如果挂载目标未处于执行操作的正确状态,则返回。

HTTP 状态代码:409

InternalServerError

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

HTTP 状态代码:500

MountTargetNotFound

如果在调用者的 Amazon Web Services 账户中未找到具有指定 ID 的挂载目标,则返回此内容。

HTTP 状态代码:404

SecurityGroupLimitExceeded

如果请求中指定的 SecurityGroups 大小大于五,则返回此内容。

HTTP 状态代码:400

SecurityGroupNotFound

如果子网的虚拟私有云 (VPC) 中不存在指定的安全组,则返回此内容。

HTTP 状态代码:400

示例

替换挂载目标的安全组

以下示例替换对与挂载目标关联的网络接口有效的安全组。

示例请求

PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223446Z Authorization: <...> Content-Type: application/json Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] }

示例响应

HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

另请参阅

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