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.
Refreshes the cached inventory of objects for the specified file share. This operation finds objects in the Amazon S3 bucket that were added, removed, or replaced since the gateway last listed the bucket's contents and cached the results. This operation does not import files into the S3 File Gateway cache storage. It only updates the cached inventory to reflect changes in the inventory of the objects in the S3 bucket. This operation is only supported in the S3 File Gateway types.
You can subscribe to be notified through an Amazon CloudWatch event when your RefreshCache
operation completes. For more information, see Getting
notified about file operations in the Amazon S3 File Gateway User Guide.
This operation is Only supported for S3 File Gateways.
When this API is called, it only initiates the refresh operation. When the API call
completes and returns a success code, it doesn't necessarily mean that the file refresh
has completed. You should use the refresh-complete notification to determine that
the operation has completed before you check for new files on the gateway file share.
You can subscribe to be notified through a CloudWatch event when your RefreshCache
operation completes.
Throttle limit: This API is asynchronous, so the gateway will accept no more than two refreshes at any time. We recommend using the refresh-complete CloudWatch event notification before issuing additional requests. For more information, see Getting notified about file operations in the Amazon S3 File Gateway User Guide.
Wait at least 60 seconds between consecutive RefreshCache API requests.
If you invoke the RefreshCache API when two requests are already being processed,
any new request will cause an InvalidGatewayRequestException error because
too many requests were sent to the server.
The S3 bucket name does not need to be included when entering the list of folders in the FolderList parameter.
For more information, see Getting notified about file operations in the Amazon S3 File Gateway User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to RefreshCacheAsync.
Namespace: Amazon.StorageGateway
Assembly: AWSSDK.StorageGateway.dll
Version: 3.x.y.z
public virtual RefreshCacheResponse RefreshCache( RefreshCacheRequest request )
Container for the necessary parameters to execute the RefreshCache service method.
| Exception | Condition |
|---|---|
| InternalServerErrorException | An internal server error has occurred during the request. For more information, see the error and message fields. |
| InvalidGatewayRequestException | An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5