Menu
Amazon Elastic File System
User Guide

DescribeMountTargetSecurityGroups

Returns the security groups currently in effect for a mount target. 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.

This operation requires permissions for the following actions:

  • elasticfilesystem:DescribeMountTargetSecurityGroups action on the mount target's file system.

  • ec2:DescribeNetworkInterfaceAttribute action on the mount target's network interface.

Request Syntax

Copy
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

MountTargetId

ID of the mount target whose security groups you want to retrieve.

Request Body

The request does not have a request body.

Response Syntax

Copy
HTTP/1.1 200 Content-type: application/json { "SecurityGroups": [ "string" ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

SecurityGroups

Array of security groups.

Type: Array of strings

Array Members: Maximum number of 5 items.

Errors

BadRequest

Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter.

HTTP Status Code: 400

IncorrectMountTargetState

Returned if the mount target is not in the correct state for the operation.

HTTP Status Code: 409

InternalServerError

Returned if an error occurred on the server side.

HTTP Status Code: 500

MountTargetNotFound

Returned if there is no mount target with the specified ID found in the caller's account.

HTTP Status Code: 404

Example

Retrieve security groups in effect for a file system

The following example retrieves the security groups that are in effect for the network interface associated with a mount target.

Sample Request

Copy
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223513Z Authorization: <...>

Sample Response

Copy
HTTP/1.1 200 OK x-amzn-RequestId: 088fb0b4-0c1d-4af7-9de1-933207fbdb46 Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: