本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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安全组的数组IDs。
类型:字符串数组
数组成员:最多 100 项。
长度限制:最小长度为 11。最大长度为 43。
模式:
^sg-[0-9a-f]{8,40}
必需:否
响应语法
HTTP/1.1 204
响应元素
如果操作成功,服务将返回一个 HTTP 204 响应,HTTP主体为空。
错误
- 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
另请参阅
有关在特定语言API中使用它的更多信息 Amazon SDKs,请参阅以下内容: