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
-
如果在调用者的 AWS 账户中未找到具有指定 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
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: