Smaws_Client_StorageGateway.StartCacheReportStarts generating a report of the file metadata currently cached by an S3 File Gateway for a specific file share. You can use this report to identify and resolve issues if you have files failing upload from your gateway to Amazon S3. The report is a CSV file containing a list of files which match the set of filter parameters you specify in the request.
The Files Failing Upload flag is reset every 24 hours and during gateway reboot. If this report captures the files after the reset, but before they become flagged again, they will not be reported as Files Failing Upload.
The following requirements must be met to successfully generate a cache report:
s3:PutObject and s3:AbortMultipartUpload permissions for the Amazon S3 bucket where you want to store the cache report.InclusionFilters or ExclusionFilters in the request.val error_to_string :
[ Smaws_Lib.Protocols.AwsJson.error
| `InternalServerError of Types.internal_server_error
| `InvalidGatewayRequestException of Types.invalid_gateway_request_exception ] ->
stringval request :
'http_type Smaws_Lib.Context.t ->
Types.start_cache_report_input ->
(Types.start_cache_report_output,
[> Smaws_Lib.Protocols.AwsJson.error
| `InternalServerError of Types.internal_server_error
| `InvalidGatewayRequestException of
Types.invalid_gateway_request_exception ])
Stdlib.resultval request_with_metadata :
'http_type Smaws_Lib.Context.t ->
Types.start_cache_report_input ->
(Types.start_cache_report_output Smaws_Lib.Response.t,
[> Smaws_Lib.Protocols.AwsJson.error
| `InternalServerError of Types.internal_server_error
| `InvalidGatewayRequestException of
Types.invalid_gateway_request_exception ]
* Smaws_Lib.Response.metadata)
Stdlib.result