AmazonElasticFileSystemClient.ModifyMountTargetSecurityGroups Method (ModifyMountTargetSecurityGroupsRequest)

Modifies the set of security groups in effect for a mount target.

When you create a mount target, Amazon EFS also creates a new network interface. For more information, see CreateMountTarget. This operation replaces the security groups in effect for the network interface associated with a mount target, with the SecurityGroups provided in the request. This operation requires that the network interface of the mount target has been created and the lifecycle state of the mount target is not deleted.

The operation requires permissions for the following actions:

elasticfilesystem:ModifyMountTargetSecurityGroups action on the mount target's file system.
ec2:ModifyNetworkInterfaceAttribute action on the mount target's network interface.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to ModifyMountTargetSecurityGroupsAsync.

Namespace: Amazon.ElasticFileSystem
Assembly: AWSSDK.ElasticFileSystem.dll
Version: 3.x.y.z

Syntax

public virtual ModifyMountTargetSecurityGroupsResponse ModifyMountTargetSecurityGroups(
         ModifyMountTargetSecurityGroupsRequest request
)

Parameters

request: Type: Amazon.ElasticFileSystem.Model.ModifyMountTargetSecurityGroupsRequest

Container for the necessary parameters to execute the ModifyMountTargetSecurityGroups service method.

Return Value

Type: ModifyMountTargetSecurityGroupsResponse

The response from the ModifyMountTargetSecurityGroups service method, as returned by ElasticFileSystem.

Exceptions

Exception	Condition
BadRequestException	Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter.
IncorrectMountTargetStateException	Returned if the mount target is not in the correct state for the operation.
InternalServerErrorException	Returned if an error occurred on the server side.
MountTargetNotFoundException	Returned if there is no mount target with the specified ID found in the caller's Amazon Web Services account.
SecurityGroupLimitExceededException	Returned if the number of SecurityGroups specified in the request is greater than the limit, which is based on account quota. Either delete some security groups or request that the account quota be raised. For more information, see Amazon VPC Quotas in the Amazon VPC User Guide (see the Security Groups table).
SecurityGroupNotFoundException	Returned if one of the specified security groups doesn't exist in the subnet's virtual private cloud (VPC).

Examples

This operation modifies the security groups associated with a mount target for a file system.

To modify the security groups associated with a mount target for a file system


var client = new AmazonElasticFileSystemClient();
var response = client.ModifyMountTargetSecurityGroups(new ModifyMountTargetSecurityGroupsRequest 
{
    MountTargetId = "fsmt-12340abc",
    SecurityGroups = new List<string> {
        "sg-abcd1234"
    }
});

Version Information

.NET Framework:
Supported in: 4.7.2 and newer

AmazonElasticFileSystemClient.ModifyMountTargetSecurityGroups (ModifyMountTargetSecurityGroupsRequest)

Method