AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
CreationToken
or the FileSystemId
is provided; otherwise,
returns descriptions of all file systems owned by the caller's AWS account in the
AWS region of the endpoint that you're calling.
When retrieving all file system descriptions, you can optionally specify the MaxItems
parameter to limit the number of descriptions in a response. If more file system descriptions
remain, Amazon EFS returns a NextMarker
, an opaque token, in the response.
In this case, you should send a subsequent request with the Marker
request
parameter set to the value of NextMarker
.
So to retrieve a list of your file system descriptions, the expected usage of this
API is an iterative process of first calling DescribeFileSystems
without
the Marker
and then continuing to call it with the Marker
parameter set to the value of the NextMarker
from the previous response
until the response has no NextMarker
.
Note that the implementation may return fewer than MaxItems
file system
descriptions while still including a NextMarker
value.
The order of file systems returned in the response of one DescribeFileSystems
call, and the order of file systems returned across the responses of a multi-call
iteration, is unspecified.
This operation requires permission for the elasticfilesystem:DescribeFileSystems
action.
Namespace: Amazon.ElasticFileSystem
Assembly: AWSSDK.dll
Version: (assembly version)
public abstract DescribeFileSystemsResponse DescribeFileSystems( DescribeFileSystemsRequest request )
Container for the necessary parameters to execute the DescribeFileSystems service method.
Exception | Condition |
---|---|
BadRequestException | Returned if the request is malformed or contains an error such as an invalid parameter value or a missing required parameter. |
FileSystemNotFoundException | Returned if the specified FileSystemId does not exist in the requester's AWS account. |
InternalServerErrorException | Returned if an error occurred on the server side. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5