amazonka-efs-2.0: Amazon Elastic File System SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EFS.DescribeAccessPoints

Description

Returns the description of a specific Amazon EFS access point if the AccessPointId is provided. If you provide an EFS FileSystemId, it returns descriptions of all access points for that file system. You can provide either an AccessPointId or a FileSystemId in the request, but not both.

This operation requires permissions for the elasticfilesystem:DescribeAccessPoints action.

Synopsis

Creating a Request

data DescribeAccessPoints Source #

See: newDescribeAccessPoints smart constructor.

Constructors

DescribeAccessPoints' 

Fields

  • accessPointId :: Maybe Text

    (Optional) Specifies an EFS access point to describe in the response; mutually exclusive with FileSystemId.

  • fileSystemId :: Maybe Text

    (Optional) If you provide a FileSystemId, EFS returns all access points for that file system; mutually exclusive with AccessPointId.

  • maxResults :: Maybe Natural

    (Optional) When retrieving all access points for a file system, you can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.

  • nextToken :: Maybe Text

    NextToken is present if the response is paginated. You can use NextMarker in the subsequent request to fetch the next page of access point descriptions.

Instances

Instances details
ToHeaders DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

ToPath DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

ToQuery DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

AWSRequest DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Associated Types

type AWSResponse DescribeAccessPoints #

Generic DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Associated Types

type Rep DescribeAccessPoints :: Type -> Type #

Read DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Show DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

NFData DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Methods

rnf :: DescribeAccessPoints -> () #

Eq DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Hashable DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

type AWSResponse DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

type Rep DescribeAccessPoints Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

type Rep DescribeAccessPoints = D1 ('MetaData "DescribeAccessPoints" "Amazonka.EFS.DescribeAccessPoints" "amazonka-efs-2.0-EHRjUBbcNxzHWDmYi0HAD5" 'False) (C1 ('MetaCons "DescribeAccessPoints'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "accessPointId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "fileSystemId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))

newDescribeAccessPoints :: DescribeAccessPoints Source #

Create a value of DescribeAccessPoints with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

DescribeAccessPoints, describeAccessPoints_accessPointId - (Optional) Specifies an EFS access point to describe in the response; mutually exclusive with FileSystemId.

DescribeAccessPoints, describeAccessPoints_fileSystemId - (Optional) If you provide a FileSystemId, EFS returns all access points for that file system; mutually exclusive with AccessPointId.

$sel:maxResults:DescribeAccessPoints', describeAccessPoints_maxResults - (Optional) When retrieving all access points for a file system, you can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.

DescribeAccessPoints, describeAccessPoints_nextToken - NextToken is present if the response is paginated. You can use NextMarker in the subsequent request to fetch the next page of access point descriptions.

Request Lenses

describeAccessPoints_accessPointId :: Lens' DescribeAccessPoints (Maybe Text) Source #

(Optional) Specifies an EFS access point to describe in the response; mutually exclusive with FileSystemId.

describeAccessPoints_fileSystemId :: Lens' DescribeAccessPoints (Maybe Text) Source #

(Optional) If you provide a FileSystemId, EFS returns all access points for that file system; mutually exclusive with AccessPointId.

describeAccessPoints_maxResults :: Lens' DescribeAccessPoints (Maybe Natural) Source #

(Optional) When retrieving all access points for a file system, you can optionally specify the MaxItems parameter to limit the number of objects returned in a response. The default value is 100.

describeAccessPoints_nextToken :: Lens' DescribeAccessPoints (Maybe Text) Source #

NextToken is present if the response is paginated. You can use NextMarker in the subsequent request to fetch the next page of access point descriptions.

Destructuring the Response

data DescribeAccessPointsResponse Source #

See: newDescribeAccessPointsResponse smart constructor.

Constructors

DescribeAccessPointsResponse' 

Fields

Instances

Instances details
Generic DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Associated Types

type Rep DescribeAccessPointsResponse :: Type -> Type #

Read DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Show DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

NFData DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

Eq DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

type Rep DescribeAccessPointsResponse Source # 
Instance details

Defined in Amazonka.EFS.DescribeAccessPoints

type Rep DescribeAccessPointsResponse = D1 ('MetaData "DescribeAccessPointsResponse" "Amazonka.EFS.DescribeAccessPoints" "amazonka-efs-2.0-EHRjUBbcNxzHWDmYi0HAD5" 'False) (C1 ('MetaCons "DescribeAccessPointsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "accessPoints") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [AccessPointDescription])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeAccessPointsResponse Source #

Create a value of DescribeAccessPointsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:accessPoints:DescribeAccessPointsResponse', describeAccessPointsResponse_accessPoints - An array of access point descriptions.

DescribeAccessPoints, describeAccessPointsResponse_nextToken - Present if there are more access points than returned in the response. You can use the NextMarker in the subsequent request to fetch the additional descriptions.

$sel:httpStatus:DescribeAccessPointsResponse', describeAccessPointsResponse_httpStatus - The response's http status code.

Response Lenses

describeAccessPointsResponse_nextToken :: Lens' DescribeAccessPointsResponse (Maybe Text) Source #

Present if there are more access points than returned in the response. You can use the NextMarker in the subsequent request to fetch the additional descriptions.