v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Gets a list of the file shares for a specific S3 File Gateway, or the list of file shares that belong to the calling user account. This operation is only supported for S3 File Gateways.

post/#X-Amz-Target=StorageGateway_20130630.ListFileShares

Query parameters

Limitstring

Pagination limit

Markerstring

Pagination token

Headers

X-Amz-Target'StorageGateway_20130630.ListFileShares' required

Request body

GatewayARNstring

The Amazon Resource Name (ARN) of the gateway whose file shares you want to list. If this field is not present, all file shares under your account are listed.

Limitinteger

The maximum number of file shares to return in the response. The value must be an integer with a value greater than zero. Optional.

Markerstring

Opaque pagination token returned from a previous ListFileShares operation. If present, <code>Marker</code> specifies where to continue the list from after a previous call to ListFileShares. Optional.

Response

Success

Markerstring

If the request includes <code>Marker</code>, the response returns that value in this field.

NextMarkerstring

If a value is present, there are more file shares to return. In a subsequent request, use <code>NextMarker</code> as the value for <code>Marker</code> to retrieve the next set of file shares.