aws-sdk-storagegateway 1.103.0 → 1.104.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5868793b64b8986134d081a5934b99d826ce675405c336fab1f50da6d7c551f3
-  data.tar.gz: f983c8180a812f814dd0b90c66aec072c2a6af618363a78923c5047c25b35b65
+  metadata.gz: 8e74c741ad4b21705f0778f20ac7b11f92b999f2ee5143accfd4e9469f45ddd3
+  data.tar.gz: 15d3f5fb83ff82f9e44d46820eedb8de973b455ba9dffae23729727151830986
 SHA512:
-  metadata.gz: da29ff0b2df8d1eab0a365e891a87744a16a5ee568535d786776b9fc5c872d7fc784b0c59fd4b8a4d794a3992a8061894886e380a394fb1b013af518dd42dcdb
-  data.tar.gz: fe908fd07244cbdd51763673c2c239e2fa87192400f9742e6a3bb1ae6971391b2bbb2c46a86ed58700a120a12a33845cad28a8be8a2d66b89067aa8f05a5be11
+  metadata.gz: 55eedad2bac2222f464c2ca6bacc03a31b4a5d705763c83078358e9e7a2832afbf3cc515342977e1dc84ca77671bb697d858f89491c46a8940cf7dd33ab258eb
+  data.tar.gz: 3eb1d73256285f4fa027902d8b72839ccc436bf339771f6cfcb6a48701c2160455d86de6aeb3bc6c6cdbbc1ea16ed00dd63ed55c7c6321d22e02006205e67345

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.104.0 (2025-02-13)
+------------------
+
+* Feature - This release adds support for generating cache reports on S3 File Gateways for files that fail to upload.
+
 1.103.0 (2025-02-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.103.0
+1.104.0

data/lib/aws-sdk-storagegateway/client.rb

@@ -1162,6 +1162,39 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Cancels generation of a specified cache report. You can use this
+    # operation to manually cancel an IN-PROGRESS report for any reason.
+    # This action changes the report status from IN-PROGRESS to CANCELLED.
+    # You can only cancel in-progress reports. If the the report you attempt
+    # to cancel is in FAILED, ERROR, or COMPLETED state, the cancel
+    # operation returns an error.
+    #
+    # @option params [required, String] :cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to cancel.
+    #
+    # @return [Types::CancelCacheReportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CancelCacheReportOutput#cache_report_arn #cache_report_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_cache_report({
+    #     cache_report_arn: "CacheReportARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cache_report_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelCacheReport AWS API Documentation
+    #
+    # @overload cancel_cache_report(params = {})
+    # @param [Hash] params ({})
+    def cancel_cache_report(params = {}, options = {})
+      req = build_request(:cancel_cache_report, params)
+      req.send_request(options)
+    end
+
     # Cancels retrieval of a virtual tape from the virtual tape shelf (VTS)
     # to a gateway after the retrieval process is initiated. The virtual
     # tape is returned to the VTS. This operation is only supported in the
@@ -2782,6 +2815,43 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Deletes the specified cache report and any associated tags from the
+    # Storage Gateway database. You can only delete completed reports. If
+    # the status of the report you attempt to delete still IN-PROGRESS, the
+    # delete operation returns an error. You can use `CancelCacheReport` to
+    # cancel an IN-PROGRESS report.
+    #
+    # <note markdown="1"> `DeleteCacheReport` does not delete the report object from your Amazon
+    # S3 bucket.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to delete.
+    #
+    # @return [Types::DeleteCacheReportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteCacheReportOutput#cache_report_arn #cache_report_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_cache_report({
+    #     cache_report_arn: "CacheReportARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cache_report_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteCacheReport AWS API Documentation
+    #
+    # @overload delete_cache_report(params = {})
+    # @param [Hash] params ({})
+    def delete_cache_report(params = {}, options = {})
+      req = build_request(:delete_cache_report, params)
+      req.send_request(options)
+    end
+
     # Deletes Challenge-Handshake Authentication Protocol (CHAP) credentials
     # for a specified iSCSI target and initiator pair. This operation is
     # supported in volume and tape gateway types.
@@ -3430,6 +3500,55 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Returns information about the specified cache report, including
+    # completion status and generation progress.
+    #
+    # @option params [required, String] :cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   describe.
+    #
+    # @return [Types::DescribeCacheReportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeCacheReportOutput#cache_report_info #cache_report_info} => Types::CacheReportInfo
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_cache_report({
+    #     cache_report_arn: "CacheReportARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cache_report_info.cache_report_arn #=> String
+    #   resp.cache_report_info.cache_report_status #=> String, one of "IN_PROGRESS", "COMPLETED", "CANCELED", "FAILED", "ERROR"
+    #   resp.cache_report_info.report_completion_percent #=> Integer
+    #   resp.cache_report_info.end_time #=> Time
+    #   resp.cache_report_info.role #=> String
+    #   resp.cache_report_info.file_share_arn #=> String
+    #   resp.cache_report_info.location_arn #=> String
+    #   resp.cache_report_info.start_time #=> Time
+    #   resp.cache_report_info.inclusion_filters #=> Array
+    #   resp.cache_report_info.inclusion_filters[0].name #=> String, one of "UploadState", "UploadFailureReason"
+    #   resp.cache_report_info.inclusion_filters[0].values #=> Array
+    #   resp.cache_report_info.inclusion_filters[0].values[0] #=> String
+    #   resp.cache_report_info.exclusion_filters #=> Array
+    #   resp.cache_report_info.exclusion_filters[0].name #=> String, one of "UploadState", "UploadFailureReason"
+    #   resp.cache_report_info.exclusion_filters[0].values #=> Array
+    #   resp.cache_report_info.exclusion_filters[0].values[0] #=> String
+    #   resp.cache_report_info.report_name #=> String
+    #   resp.cache_report_info.tags #=> Array
+    #   resp.cache_report_info.tags[0].key #=> String
+    #   resp.cache_report_info.tags[0].value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCacheReport AWS API Documentation
+    #
+    # @overload describe_cache_report(params = {})
+    # @param [Hash] params ({})
+    def describe_cache_report(params = {}, options = {})
+      req = build_request(:describe_cache_report, params)
+      req.send_request(options)
+    end
+
     # Returns a description of the gateway volumes specified in the request.
     # This operation is only supported in the cached volume gateway types.
     #
@@ -4944,6 +5063,62 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Returns a list of existing cache reports for all file shares
+    # associated with your Amazon Web Services account. This list includes
+    # all information provided by the `DescribeCacheReport` action, such as
+    # report name, status, completion progress, start time, end time,
+    # filters, and tags.
+    #
+    # @option params [String] :marker
+    #   Opaque pagination token returned from a previous `ListCacheReports`
+    #   operation. If present, `Marker` specifies where to continue the list
+    #   from after a previous call to `ListCacheReports`. Optional.
+    #
+    # @return [Types::ListCacheReportsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListCacheReportsOutput#cache_report_list #cache_report_list} => Array&lt;Types::CacheReportInfo&gt;
+    #   * {Types::ListCacheReportsOutput#marker #marker} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_cache_reports({
+    #     marker: "Marker",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cache_report_list #=> Array
+    #   resp.cache_report_list[0].cache_report_arn #=> String
+    #   resp.cache_report_list[0].cache_report_status #=> String, one of "IN_PROGRESS", "COMPLETED", "CANCELED", "FAILED", "ERROR"
+    #   resp.cache_report_list[0].report_completion_percent #=> Integer
+    #   resp.cache_report_list[0].end_time #=> Time
+    #   resp.cache_report_list[0].role #=> String
+    #   resp.cache_report_list[0].file_share_arn #=> String
+    #   resp.cache_report_list[0].location_arn #=> String
+    #   resp.cache_report_list[0].start_time #=> Time
+    #   resp.cache_report_list[0].inclusion_filters #=> Array
+    #   resp.cache_report_list[0].inclusion_filters[0].name #=> String, one of "UploadState", "UploadFailureReason"
+    #   resp.cache_report_list[0].inclusion_filters[0].values #=> Array
+    #   resp.cache_report_list[0].inclusion_filters[0].values[0] #=> String
+    #   resp.cache_report_list[0].exclusion_filters #=> Array
+    #   resp.cache_report_list[0].exclusion_filters[0].name #=> String, one of "UploadState", "UploadFailureReason"
+    #   resp.cache_report_list[0].exclusion_filters[0].values #=> Array
+    #   resp.cache_report_list[0].exclusion_filters[0].values[0] #=> String
+    #   resp.cache_report_list[0].report_name #=> String
+    #   resp.cache_report_list[0].tags #=> Array
+    #   resp.cache_report_list[0].tags[0].key #=> String
+    #   resp.cache_report_list[0].tags[0].value #=> String
+    #   resp.marker #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListCacheReports AWS API Documentation
+    #
+    # @overload list_cache_reports(params = {})
+    # @param [Hash] params ({})
+    def list_cache_reports(params = {}, options = {})
+      req = build_request(:list_cache_reports, params)
+      req.send_request(options)
+    end
+
     # Gets a list of the file shares for a specific S3 File Gateway, or the
     # list of file shares that belong to the calling Amazon Web Services
     # account. This operation is only supported for S3 File Gateways.
@@ -5615,18 +5790,18 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
-    # Sends you notification through CloudWatch Events when all files
+    # Sends you notification through Amazon EventBridge when all files
     # written to your file share have been uploaded to Amazon S3.
     #
-    # Storage Gateway can send a notification through Amazon CloudWatch
-    # Events when all files written to your file share up to that point in
-    # time have been uploaded to Amazon S3. These files include files
-    # written to the file share up to the time that you make a request for
+    # Storage Gateway can send a notification through Amazon EventBridge
+    # when all files written to your file share up to that point in time
+    # have been uploaded to Amazon S3. These files include files written to
+    # the file share up to the time that you make a request for
     # notification. When the upload is done, Storage Gateway sends you
-    # notification through an Amazon CloudWatch Event. You can configure
-    # CloudWatch Events to send the notification through event targets such
-    # as Amazon SNS or Lambda function. This operation is only supported for
-    # S3 File Gateways.
+    # notification through EventBridge. You can configure EventBridge to
+    # send the notification through event targets such as Amazon SNS or
+    # Lambda function. This operation is only supported for S3 File
+    # Gateways.
     #
     # For more information, see [Getting file upload notification][1] in the
     # *Amazon S3 File Gateway User Guide*.
@@ -6204,6 +6379,134 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Starts 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.
+    #
+    # <note markdown="1"> 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**.
+    #
+    #  </note>
+    #
+    # The following requirements must be met to successfully generate a
+    # cache report:
+    #
+    # * You must have permissions to list the entire Amazon S3 bucket
+    #   associated with the specified file share.
+    #
+    # * No other cache reports can currently be in-progress for the
+    #   specified file share.
+    #
+    # * There must be fewer than 10 existing cache reports for the specified
+    #   file share.
+    #
+    # * The gateway must be online and connected to Amazon Web Services.
+    #
+    # * The root disk must have at least 20GB of free space when report
+    #   generation starts.
+    #
+    # * You must specify at least one value for `InclusionFilters` or
+    #   `ExclusionFilters` in the request.
+    #
+    # @option params [required, String] :file_share_arn
+    #   The Amazon Resource Name (ARN) of the file share.
+    #
+    # @option params [required, String] :role
+    #   The ARN of the IAM role used when saving the cache report to Amazon
+    #   S3.
+    #
+    # @option params [required, String] :location_arn
+    #   The ARN of the Amazon S3 bucket where the cache report will be saved.
+    #
+    #   <note markdown="1"> We do not recommend saving the cache report to the same Amazon S3
+    #   bucket for which you are generating the report.
+    #
+    #    This field does not accept access point ARNs.
+    #
+    #    </note>
+    #
+    # @option params [required, String] :bucket_region
+    #   The Amazon Web Services Region of the Amazon S3 bucket associated with
+    #   the file share for which you want to generate the cache report.
+    #
+    # @option params [String] :vpc_endpoint_dns_name
+    #   The DNS name of the VPC endpoint associated with the Amazon S3 where
+    #   you want to save the cache report. Optional.
+    #
+    # @option params [Array<Types::CacheReportFilter>] :inclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   included in the report. You must specify at least one value for
+    #   `InclusionFilters` or `ExclusionFilters` in a `StartCacheReport`
+    #   request.
+    #
+    # @option params [Array<Types::CacheReportFilter>] :exclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   excluded from the report. You must specify at least one value for
+    #   `InclusionFilters` or `ExclusionFilters` in a `StartCacheReport`
+    #   request.
+    #
+    # @option params [required, String] :client_token
+    #   A unique identifier that you use to ensure idempotent report
+    #   generation if you need to retry an unsuccessful `StartCacheReport`
+    #   request. If you retry a request, use the same `ClientToken` you
+    #   specified in the initial request.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of up to 50 key/value tags that you can assign to the cache
+    #   report. Using tags can help you categorize your reports and more
+    #   easily locate them in search results.
+    #
+    # @return [Types::StartCacheReportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartCacheReportOutput#cache_report_arn #cache_report_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_cache_report({
+    #     file_share_arn: "FileShareARN", # required
+    #     role: "Role", # required
+    #     location_arn: "LocationARN", # required
+    #     bucket_region: "RegionId", # required
+    #     vpc_endpoint_dns_name: "DNSHostName",
+    #     inclusion_filters: [
+    #       {
+    #         name: "UploadState", # required, accepts UploadState, UploadFailureReason
+    #         values: ["CacheReportFilterValue"], # required
+    #       },
+    #     ],
+    #     exclusion_filters: [
+    #       {
+    #         name: "UploadState", # required, accepts UploadState, UploadFailureReason
+    #         values: ["CacheReportFilterValue"], # required
+    #       },
+    #     ],
+    #     client_token: "ClientToken", # required
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cache_report_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StartCacheReport AWS API Documentation
+    #
+    # @overload start_cache_report(params = {})
+    # @param [Hash] params ({})
+    def start_cache_report(params = {}, options = {})
+      req = build_request(:start_cache_report, params)
+      req.send_request(options)
+    end
+
     # Starts a gateway that you previously shut down (see ShutdownGateway).
     # After the gateway starts, you can then make other API calls, your
     # applications can read from or write to the gateway's storage volumes
@@ -7603,7 +7906,7 @@ module Aws::StorageGateway
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-storagegateway'
-      context[:gem_version] = '1.103.0'
+      context[:gem_version] = '1.104.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-storagegateway/client_api.rb

@@ -47,11 +47,23 @@ module Aws::StorageGateway
     BandwidthUploadRateLimit = Shapes::IntegerShape.new(name: 'BandwidthUploadRateLimit')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     CacheAttributes = Shapes::StructureShape.new(name: 'CacheAttributes')
+    CacheReportARN = Shapes::StringShape.new(name: 'CacheReportARN')
+    CacheReportFilter = Shapes::StructureShape.new(name: 'CacheReportFilter')
+    CacheReportFilterList = Shapes::ListShape.new(name: 'CacheReportFilterList')
+    CacheReportFilterName = Shapes::StringShape.new(name: 'CacheReportFilterName')
+    CacheReportFilterValue = Shapes::StringShape.new(name: 'CacheReportFilterValue')
+    CacheReportFilterValues = Shapes::ListShape.new(name: 'CacheReportFilterValues')
+    CacheReportInfo = Shapes::StructureShape.new(name: 'CacheReportInfo')
+    CacheReportList = Shapes::ListShape.new(name: 'CacheReportList')
+    CacheReportName = Shapes::StringShape.new(name: 'CacheReportName')
+    CacheReportStatus = Shapes::StringShape.new(name: 'CacheReportStatus')
     CacheStaleTimeoutInSeconds = Shapes::IntegerShape.new(name: 'CacheStaleTimeoutInSeconds')
     CachediSCSIVolume = Shapes::StructureShape.new(name: 'CachediSCSIVolume')
     CachediSCSIVolumes = Shapes::ListShape.new(name: 'CachediSCSIVolumes')
     CancelArchivalInput = Shapes::StructureShape.new(name: 'CancelArchivalInput')
     CancelArchivalOutput = Shapes::StructureShape.new(name: 'CancelArchivalOutput')
+    CancelCacheReportInput = Shapes::StructureShape.new(name: 'CancelCacheReportInput')
+    CancelCacheReportOutput = Shapes::StructureShape.new(name: 'CancelCacheReportOutput')
     CancelRetrievalInput = Shapes::StructureShape.new(name: 'CancelRetrievalInput')
     CancelRetrievalOutput = Shapes::StructureShape.new(name: 'CancelRetrievalOutput')
     CaseSensitivity = Shapes::StringShape.new(name: 'CaseSensitivity')
@@ -87,6 +99,8 @@ module Aws::StorageGateway
     DeleteAutomaticTapeCreationPolicyOutput = Shapes::StructureShape.new(name: 'DeleteAutomaticTapeCreationPolicyOutput')
     DeleteBandwidthRateLimitInput = Shapes::StructureShape.new(name: 'DeleteBandwidthRateLimitInput')
     DeleteBandwidthRateLimitOutput = Shapes::StructureShape.new(name: 'DeleteBandwidthRateLimitOutput')
+    DeleteCacheReportInput = Shapes::StructureShape.new(name: 'DeleteCacheReportInput')
+    DeleteCacheReportOutput = Shapes::StructureShape.new(name: 'DeleteCacheReportOutput')
     DeleteChapCredentialsInput = Shapes::StructureShape.new(name: 'DeleteChapCredentialsInput')
     DeleteChapCredentialsOutput = Shapes::StructureShape.new(name: 'DeleteChapCredentialsOutput')
     DeleteFileShareInput = Shapes::StructureShape.new(name: 'DeleteFileShareInput')
@@ -112,6 +126,8 @@ module Aws::StorageGateway
     DescribeBandwidthRateLimitScheduleOutput = Shapes::StructureShape.new(name: 'DescribeBandwidthRateLimitScheduleOutput')
     DescribeCacheInput = Shapes::StructureShape.new(name: 'DescribeCacheInput')
     DescribeCacheOutput = Shapes::StructureShape.new(name: 'DescribeCacheOutput')
+    DescribeCacheReportInput = Shapes::StructureShape.new(name: 'DescribeCacheReportInput')
+    DescribeCacheReportOutput = Shapes::StructureShape.new(name: 'DescribeCacheReportOutput')
     DescribeCachediSCSIVolumesInput = Shapes::StructureShape.new(name: 'DescribeCachediSCSIVolumesInput')
     DescribeCachediSCSIVolumesOutput = Shapes::StructureShape.new(name: 'DescribeCachediSCSIVolumesOutput')
     DescribeChapCredentialsInput = Shapes::StructureShape.new(name: 'DescribeChapCredentialsInput')
@@ -223,6 +239,8 @@ module Aws::StorageGateway
     LastSoftwareUpdate = Shapes::StringShape.new(name: 'LastSoftwareUpdate')
     ListAutomaticTapeCreationPoliciesInput = Shapes::StructureShape.new(name: 'ListAutomaticTapeCreationPoliciesInput')
     ListAutomaticTapeCreationPoliciesOutput = Shapes::StructureShape.new(name: 'ListAutomaticTapeCreationPoliciesOutput')
+    ListCacheReportsInput = Shapes::StructureShape.new(name: 'ListCacheReportsInput')
+    ListCacheReportsOutput = Shapes::StructureShape.new(name: 'ListCacheReportsOutput')
     ListFileSharesInput = Shapes::StructureShape.new(name: 'ListFileSharesInput')
     ListFileSharesOutput = Shapes::StructureShape.new(name: 'ListFileSharesOutput')
     ListFileSystemAssociationsInput = Shapes::StructureShape.new(name: 'ListFileSystemAssociationsInput')
@@ -279,6 +297,7 @@ module Aws::StorageGateway
     RegionId = Shapes::StringShape.new(name: 'RegionId')
     RemoveTagsFromResourceInput = Shapes::StructureShape.new(name: 'RemoveTagsFromResourceInput')
     RemoveTagsFromResourceOutput = Shapes::StructureShape.new(name: 'RemoveTagsFromResourceOutput')
+    ReportCompletionPercent = Shapes::IntegerShape.new(name: 'ReportCompletionPercent')
     ResetCacheInput = Shapes::StructureShape.new(name: 'ResetCacheInput')
     ResetCacheOutput = Shapes::StructureShape.new(name: 'ResetCacheOutput')
     ResourceARN = Shapes::StringShape.new(name: 'ResourceARN')
@@ -309,6 +328,8 @@ module Aws::StorageGateway
     Squash = Shapes::StringShape.new(name: 'Squash')
     StartAvailabilityMonitorTestInput = Shapes::StructureShape.new(name: 'StartAvailabilityMonitorTestInput')
     StartAvailabilityMonitorTestOutput = Shapes::StructureShape.new(name: 'StartAvailabilityMonitorTestOutput')
+    StartCacheReportInput = Shapes::StructureShape.new(name: 'StartCacheReportInput')
+    StartCacheReportOutput = Shapes::StructureShape.new(name: 'StartCacheReportOutput')
     StartGatewayInput = Shapes::StructureShape.new(name: 'StartGatewayInput')
     StartGatewayOutput = Shapes::StructureShape.new(name: 'StartGatewayOutput')
     StorageClass = Shapes::StringShape.new(name: 'StorageClass')
@@ -505,6 +526,30 @@ module Aws::StorageGateway
     CacheAttributes.add_member(:cache_stale_timeout_in_seconds, Shapes::ShapeRef.new(shape: CacheStaleTimeoutInSeconds, location_name: "CacheStaleTimeoutInSeconds"))
     CacheAttributes.struct_class = Types::CacheAttributes
 
+    CacheReportFilter.add_member(:name, Shapes::ShapeRef.new(shape: CacheReportFilterName, required: true, location_name: "Name"))
+    CacheReportFilter.add_member(:values, Shapes::ShapeRef.new(shape: CacheReportFilterValues, required: true, location_name: "Values"))
+    CacheReportFilter.struct_class = Types::CacheReportFilter
+
+    CacheReportFilterList.member = Shapes::ShapeRef.new(shape: CacheReportFilter)
+
+    CacheReportFilterValues.member = Shapes::ShapeRef.new(shape: CacheReportFilterValue)
+
+    CacheReportInfo.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, location_name: "CacheReportARN"))
+    CacheReportInfo.add_member(:cache_report_status, Shapes::ShapeRef.new(shape: CacheReportStatus, location_name: "CacheReportStatus"))
+    CacheReportInfo.add_member(:report_completion_percent, Shapes::ShapeRef.new(shape: ReportCompletionPercent, location_name: "ReportCompletionPercent"))
+    CacheReportInfo.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "EndTime"))
+    CacheReportInfo.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
+    CacheReportInfo.add_member(:file_share_arn, Shapes::ShapeRef.new(shape: FileShareARN, location_name: "FileShareARN"))
+    CacheReportInfo.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationARN, location_name: "LocationARN"))
+    CacheReportInfo.add_member(:start_time, Shapes::ShapeRef.new(shape: Time, location_name: "StartTime"))
+    CacheReportInfo.add_member(:inclusion_filters, Shapes::ShapeRef.new(shape: CacheReportFilterList, location_name: "InclusionFilters"))
+    CacheReportInfo.add_member(:exclusion_filters, Shapes::ShapeRef.new(shape: CacheReportFilterList, location_name: "ExclusionFilters"))
+    CacheReportInfo.add_member(:report_name, Shapes::ShapeRef.new(shape: CacheReportName, location_name: "ReportName"))
+    CacheReportInfo.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
+    CacheReportInfo.struct_class = Types::CacheReportInfo
+
+    CacheReportList.member = Shapes::ShapeRef.new(shape: CacheReportInfo)
+
     CachediSCSIVolume.add_member(:volume_arn, Shapes::ShapeRef.new(shape: VolumeARN, location_name: "VolumeARN"))
     CachediSCSIVolume.add_member(:volume_id, Shapes::ShapeRef.new(shape: VolumeId, location_name: "VolumeId"))
     CachediSCSIVolume.add_member(:volume_type, Shapes::ShapeRef.new(shape: VolumeType, location_name: "VolumeType"))
@@ -529,6 +574,12 @@ module Aws::StorageGateway
     CancelArchivalOutput.add_member(:tape_arn, Shapes::ShapeRef.new(shape: TapeARN, location_name: "TapeARN"))
     CancelArchivalOutput.struct_class = Types::CancelArchivalOutput
 
+    CancelCacheReportInput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, required: true, location_name: "CacheReportARN"))
+    CancelCacheReportInput.struct_class = Types::CancelCacheReportInput
+
+    CancelCacheReportOutput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, location_name: "CacheReportARN"))
+    CancelCacheReportOutput.struct_class = Types::CancelCacheReportOutput
+
     CancelRetrievalInput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, required: true, location_name: "GatewayARN"))
     CancelRetrievalInput.add_member(:tape_arn, Shapes::ShapeRef.new(shape: TapeARN, required: true, location_name: "TapeARN"))
     CancelRetrievalInput.struct_class = Types::CancelRetrievalInput
@@ -707,6 +758,12 @@ module Aws::StorageGateway
     DeleteBandwidthRateLimitOutput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, location_name: "GatewayARN"))
     DeleteBandwidthRateLimitOutput.struct_class = Types::DeleteBandwidthRateLimitOutput
 
+    DeleteCacheReportInput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, required: true, location_name: "CacheReportARN"))
+    DeleteCacheReportInput.struct_class = Types::DeleteCacheReportInput
+
+    DeleteCacheReportOutput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, location_name: "CacheReportARN"))
+    DeleteCacheReportOutput.struct_class = Types::DeleteCacheReportOutput
+
     DeleteChapCredentialsInput.add_member(:target_arn, Shapes::ShapeRef.new(shape: TargetARN, required: true, location_name: "TargetARN"))
     DeleteChapCredentialsInput.add_member(:initiator_name, Shapes::ShapeRef.new(shape: IqnName, required: true, location_name: "InitiatorName"))
     DeleteChapCredentialsInput.struct_class = Types::DeleteChapCredentialsInput
@@ -796,6 +853,12 @@ module Aws::StorageGateway
     DescribeCacheOutput.add_member(:cache_miss_percentage, Shapes::ShapeRef.new(shape: double, location_name: "CacheMissPercentage"))
     DescribeCacheOutput.struct_class = Types::DescribeCacheOutput
 
+    DescribeCacheReportInput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, required: true, location_name: "CacheReportARN"))
+    DescribeCacheReportInput.struct_class = Types::DescribeCacheReportInput
+
+    DescribeCacheReportOutput.add_member(:cache_report_info, Shapes::ShapeRef.new(shape: CacheReportInfo, location_name: "CacheReportInfo"))
+    DescribeCacheReportOutput.struct_class = Types::DescribeCacheReportOutput
+
     DescribeCachediSCSIVolumesInput.add_member(:volume_arns, Shapes::ShapeRef.new(shape: VolumeARNs, required: true, location_name: "VolumeARNs"))
     DescribeCachediSCSIVolumesInput.struct_class = Types::DescribeCachediSCSIVolumesInput
 
@@ -1090,6 +1153,13 @@ module Aws::StorageGateway
     ListAutomaticTapeCreationPoliciesOutput.add_member(:automatic_tape_creation_policy_infos, Shapes::ShapeRef.new(shape: AutomaticTapeCreationPolicyInfos, location_name: "AutomaticTapeCreationPolicyInfos"))
     ListAutomaticTapeCreationPoliciesOutput.struct_class = Types::ListAutomaticTapeCreationPoliciesOutput
 
+    ListCacheReportsInput.add_member(:marker, Shapes::ShapeRef.new(shape: Marker, location_name: "Marker"))
+    ListCacheReportsInput.struct_class = Types::ListCacheReportsInput
+
+    ListCacheReportsOutput.add_member(:cache_report_list, Shapes::ShapeRef.new(shape: CacheReportList, location_name: "CacheReportList"))
+    ListCacheReportsOutput.add_member(:marker, Shapes::ShapeRef.new(shape: Marker, location_name: "Marker"))
+    ListCacheReportsOutput.struct_class = Types::ListCacheReportsOutput
+
     ListFileSharesInput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, location_name: "GatewayARN"))
     ListFileSharesInput.add_member(:limit, Shapes::ShapeRef.new(shape: PositiveIntObject, location_name: "Limit"))
     ListFileSharesInput.add_member(:marker, Shapes::ShapeRef.new(shape: Marker, location_name: "Marker"))
@@ -1341,6 +1411,20 @@ module Aws::StorageGateway
     StartAvailabilityMonitorTestOutput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, location_name: "GatewayARN"))
     StartAvailabilityMonitorTestOutput.struct_class = Types::StartAvailabilityMonitorTestOutput
 
+    StartCacheReportInput.add_member(:file_share_arn, Shapes::ShapeRef.new(shape: FileShareARN, required: true, location_name: "FileShareARN"))
+    StartCacheReportInput.add_member(:role, Shapes::ShapeRef.new(shape: Role, required: true, location_name: "Role"))
+    StartCacheReportInput.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationARN, required: true, location_name: "LocationARN"))
+    StartCacheReportInput.add_member(:bucket_region, Shapes::ShapeRef.new(shape: RegionId, required: true, location_name: "BucketRegion"))
+    StartCacheReportInput.add_member(:vpc_endpoint_dns_name, Shapes::ShapeRef.new(shape: DNSHostName, location_name: "VPCEndpointDNSName"))
+    StartCacheReportInput.add_member(:inclusion_filters, Shapes::ShapeRef.new(shape: CacheReportFilterList, location_name: "InclusionFilters"))
+    StartCacheReportInput.add_member(:exclusion_filters, Shapes::ShapeRef.new(shape: CacheReportFilterList, location_name: "ExclusionFilters"))
+    StartCacheReportInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "ClientToken"))
+    StartCacheReportInput.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
+    StartCacheReportInput.struct_class = Types::StartCacheReportInput
+
+    StartCacheReportOutput.add_member(:cache_report_arn, Shapes::ShapeRef.new(shape: CacheReportARN, location_name: "CacheReportARN"))
+    StartCacheReportOutput.struct_class = Types::StartCacheReportOutput
+
     StartGatewayInput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, required: true, location_name: "GatewayARN"))
     StartGatewayInput.struct_class = Types::StartGatewayInput
 
@@ -1744,6 +1828,16 @@ module Aws::StorageGateway
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:cancel_cache_report, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CancelCacheReport"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CancelCacheReportInput)
+        o.output = Shapes::ShapeRef.new(shape: CancelCacheReportOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGatewayRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+      end)
+
       api.add_operation(:cancel_retrieval, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CancelRetrieval"
         o.http_method = "POST"
@@ -1866,6 +1960,16 @@ module Aws::StorageGateway
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:delete_cache_report, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteCacheReport"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DeleteCacheReportInput)
+        o.output = Shapes::ShapeRef.new(shape: DeleteCacheReportOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGatewayRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+      end)
+
       api.add_operation(:delete_chap_credentials, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeleteChapCredentials"
         o.http_method = "POST"
@@ -1986,6 +2090,16 @@ module Aws::StorageGateway
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:describe_cache_report, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeCacheReport"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeCacheReportInput)
+        o.output = Shapes::ShapeRef.new(shape: DescribeCacheReportOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGatewayRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+      end)
+
       api.add_operation(:describe_cached_iscsi_volumes, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeCachediSCSIVolumes"
         o.http_method = "POST"
@@ -2220,6 +2334,16 @@ module Aws::StorageGateway
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:list_cache_reports, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListCacheReports"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListCacheReportsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListCacheReportsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGatewayRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+      end)
+
       api.add_operation(:list_file_shares, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListFileShares"
         o.http_method = "POST"
@@ -2462,6 +2586,16 @@ module Aws::StorageGateway
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:start_cache_report, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartCacheReport"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: StartCacheReportInput)
+        o.output = Shapes::ShapeRef.new(shape: StartCacheReportOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGatewayRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+      end)
+
       api.add_operation(:start_gateway, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartGateway"
         o.http_method = "POST"

data/lib/aws-sdk-storagegateway/types.rb

@@ -699,6 +699,122 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # A list of filter parameters and associated values that determine which
+    # files are included or excluded from a cache report created by a
+    # `StartCacheReport` request. Multiple instances of the same filter
+    # parameter are combined with an OR operation, while different
+    # parameters are combined with an AND operation.
+    #
+    # @!attribute [rw] name
+    #   The parameter name for a filter that determines which files are
+    #   included or excluded from a cache report.
+    #
+    #   **Valid Names:**
+    #
+    #   UploadFailureReason \| UploadState
+    #   @return [String]
+    #
+    # @!attribute [rw] values
+    #   The parameter value for a filter that determines which files are
+    #   included or excluded from a cache report.
+    #
+    #   **Valid `UploadFailureReason` Values:**
+    #
+    #   `InaccessibleStorageClass` \| `InvalidObjectState` \|
+    #   `ObjectMissing` \| `S3AccessDenied`
+    #
+    #   **Valid `UploadState` Values:**
+    #
+    #   `FailingUpload`
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CacheReportFilter AWS API Documentation
+    #
+    class CacheReportFilter < Struct.new(
+      :name,
+      :values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains all informational fields associated with a cache report.
+    # Includes name, ARN, tags, status, progress, filters, start time, and
+    # end time.
+    #
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   describe.
+    #   @return [String]
+    #
+    # @!attribute [rw] cache_report_status
+    #   The status of the specified cache report.
+    #   @return [String]
+    #
+    # @!attribute [rw] report_completion_percent
+    #   The percentage of the report generation process that has been
+    #   completed at time of inquiry.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] end_time
+    #   The time at which the gateway stopped generating the cache report.
+    #   @return [Time]
+    #
+    # @!attribute [rw] role
+    #   The ARN of the IAM role that an S3 File Gateway assumes when it
+    #   accesses the underlying storage.
+    #   @return [String]
+    #
+    # @!attribute [rw] file_share_arn
+    #   The Amazon Resource Name (ARN) of the file share.
+    #   @return [String]
+    #
+    # @!attribute [rw] location_arn
+    #   The ARN of the Amazon S3 bucket location where the cache report is
+    #   saved.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   The time at which the gateway started generating the cache report.
+    #   @return [Time]
+    #
+    # @!attribute [rw] inclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   included in the report.
+    #   @return [Array<Types::CacheReportFilter>]
+    #
+    # @!attribute [rw] exclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   excluded from the report.
+    #   @return [Array<Types::CacheReportFilter>]
+    #
+    # @!attribute [rw] report_name
+    #   The file name of the completed cache report object stored in Amazon
+    #   S3.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   The list of key/value tags associated with the report.
+    #   @return [Array<Types::Tag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CacheReportInfo AWS API Documentation
+    #
+    class CacheReportInfo < Struct.new(
+      :cache_report_arn,
+      :cache_report_status,
+      :report_completion_percent,
+      :end_time,
+      :role,
+      :file_share_arn,
+      :location_arn,
+      :start_time,
+      :inclusion_filters,
+      :exclusion_filters,
+      :report_name,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an iSCSI cached volume.
     #
     # @!attribute [rw] volume_arn
@@ -854,6 +970,32 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   cancel.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelCacheReportInput AWS API Documentation
+    #
+    class CancelCacheReportInput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   cancel.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelCacheReportOutput AWS API Documentation
+    #
+    class CancelCacheReportOutput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # CancelRetrievalInput
     #
     # @!attribute [rw] gateway_arn
@@ -2288,6 +2430,32 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteCacheReportInput AWS API Documentation
+    #
+    class DeleteCacheReportInput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteCacheReportOutput AWS API Documentation
+    #
+    class DeleteCacheReportOutput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A JSON object containing one or more of the following fields:
     #
     # * DeleteChapCredentialsInput$InitiatorName
@@ -2754,6 +2922,33 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report you want to
+    #   describe.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCacheReportInput AWS API Documentation
+    #
+    class DescribeCacheReportInput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cache_report_info
+    #   Contains all informational fields associated with a cache report.
+    #   Includes name, ARN, tags, status, progress, filters, start time, and
+    #   end time.
+    #   @return [Types::CacheReportInfo]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCacheReportOutput AWS API Documentation
+    #
+    class DescribeCacheReportOutput < Struct.new(
+      :cache_report_info)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] volume_arns
     #   An array of strings where each string represents the Amazon Resource
     #   Name (ARN) of a cached volume. All of the specified cached volumes
@@ -3220,6 +3415,12 @@ module Aws::StorageGateway
     #   Indicates the status of a gateway that is a member of the Active
     #   Directory domain.
     #
+    #   <note markdown="1"> This field is only used as part of a `JoinDomain` request. It is not
+    #   affected by Active Directory connectivity changes that occur after
+    #   the `JoinDomain` request succeeds.
+    #
+    #    </note>
+    #
     #   * `ACCESS_DENIED`: Indicates that the `JoinDomain` operation failed
     #     due to an authentication error.
     #
@@ -4363,6 +4564,12 @@ module Aws::StorageGateway
     #   Indicates the status of the gateway as a member of the Active
     #   Directory domain.
     #
+    #   <note markdown="1"> This field is only used as part of a `JoinDomain` request. It is not
+    #   affected by Active Directory connectivity changes that occur after
+    #   the `JoinDomain` request succeeds.
+    #
+    #    </note>
+    #
     #   * `ACCESS_DENIED`: Indicates that the `JoinDomain` operation failed
     #     due to an authentication error.
     #
@@ -4420,6 +4627,41 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # @!attribute [rw] marker
+    #   Opaque pagination token returned from a previous `ListCacheReports`
+    #   operation. If present, `Marker` specifies where to continue the list
+    #   from after a previous call to `ListCacheReports`. Optional.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListCacheReportsInput AWS API Documentation
+    #
+    class ListCacheReportsInput < Struct.new(
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cache_report_list
+    #   A list of existing cache reports for all file shares associated with
+    #   your Amazon Web Services account. This list includes all information
+    #   provided by the `DescribeCacheReport` action, such as report status,
+    #   completion progress, start time, end time, filters, and tags.
+    #   @return [Array<Types::CacheReportInfo>]
+    #
+    # @!attribute [rw] marker
+    #   If the request includes `Marker`, the response returns that value in
+    #   this field.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListCacheReportsOutput AWS API Documentation
+    #
+    class ListCacheReportsOutput < Struct.new(
+      :cache_report_list,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # ListFileShareInput
     #
     # @!attribute [rw] gateway_arn
@@ -6088,6 +6330,93 @@ module Aws::StorageGateway
       include Aws::Structure
     end
 
+    # @!attribute [rw] file_share_arn
+    #   The Amazon Resource Name (ARN) of the file share.
+    #   @return [String]
+    #
+    # @!attribute [rw] role
+    #   The ARN of the IAM role used when saving the cache report to Amazon
+    #   S3.
+    #   @return [String]
+    #
+    # @!attribute [rw] location_arn
+    #   The ARN of the Amazon S3 bucket where the cache report will be
+    #   saved.
+    #
+    #   <note markdown="1"> We do not recommend saving the cache report to the same Amazon S3
+    #   bucket for which you are generating the report.
+    #
+    #    This field does not accept access point ARNs.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] bucket_region
+    #   The Amazon Web Services Region of the Amazon S3 bucket associated
+    #   with the file share for which you want to generate the cache report.
+    #   @return [String]
+    #
+    # @!attribute [rw] vpc_endpoint_dns_name
+    #   The DNS name of the VPC endpoint associated with the Amazon S3 where
+    #   you want to save the cache report. Optional.
+    #   @return [String]
+    #
+    # @!attribute [rw] inclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   included in the report. You must specify at least one value for
+    #   `InclusionFilters` or `ExclusionFilters` in a `StartCacheReport`
+    #   request.
+    #   @return [Array<Types::CacheReportFilter>]
+    #
+    # @!attribute [rw] exclusion_filters
+    #   The list of filters and parameters that determine which files are
+    #   excluded from the report. You must specify at least one value for
+    #   `InclusionFilters` or `ExclusionFilters` in a `StartCacheReport`
+    #   request.
+    #   @return [Array<Types::CacheReportFilter>]
+    #
+    # @!attribute [rw] client_token
+    #   A unique identifier that you use to ensure idempotent report
+    #   generation if you need to retry an unsuccessful `StartCacheReport`
+    #   request. If you retry a request, use the same `ClientToken` you
+    #   specified in the initial request.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   A list of up to 50 key/value tags that you can assign to the cache
+    #   report. Using tags can help you categorize your reports and more
+    #   easily locate them in search results.
+    #   @return [Array<Types::Tag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StartCacheReportInput AWS API Documentation
+    #
+    class StartCacheReportInput < Struct.new(
+      :file_share_arn,
+      :role,
+      :location_arn,
+      :bucket_region,
+      :vpc_endpoint_dns_name,
+      :inclusion_filters,
+      :exclusion_filters,
+      :client_token,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cache_report_arn
+    #   The Amazon Resource Name (ARN) of the cache report generated by the
+    #   `StartCacheReport` request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StartCacheReportOutput AWS API Documentation
+    #
+    class StartCacheReportOutput < Struct.new(
+      :cache_report_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A JSON object containing the Amazon Resource Name (ARN) of the gateway
     # to start.
     #

data/lib/aws-sdk-storagegateway.rb

@@ -54,7 +54,7 @@ module Aws::StorageGateway
   autoload :EndpointProvider, 'aws-sdk-storagegateway/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-storagegateway/endpoints'
 
-  GEM_VERSION = '1.103.0'
+  GEM_VERSION = '1.104.0'
 
 end
 

data/sig/client.rbs

@@ -214,6 +214,16 @@ module Aws
                            ) -> _CancelArchivalResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CancelArchivalResponseSuccess
 
+      interface _CancelCacheReportResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::CancelCacheReportOutput]
+        def cache_report_arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#cancel_cache_report-instance_method
+      def cancel_cache_report: (
+                                 cache_report_arn: ::String
+                               ) -> _CancelCacheReportResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CancelCacheReportResponseSuccess
+
       interface _CancelRetrievalResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::CancelRetrievalOutput]
         def tape_arn: () -> ::String
@@ -484,6 +494,16 @@ module Aws
                                        ) -> _DeleteBandwidthRateLimitResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteBandwidthRateLimitResponseSuccess
 
+      interface _DeleteCacheReportResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DeleteCacheReportOutput]
+        def cache_report_arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#delete_cache_report-instance_method
+      def delete_cache_report: (
+                                 cache_report_arn: ::String
+                               ) -> _DeleteCacheReportResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteCacheReportResponseSuccess
+
       interface _DeleteChapCredentialsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::DeleteChapCredentialsOutput]
         def target_arn: () -> ::String
@@ -621,6 +641,16 @@ module Aws
                           ) -> _DescribeCacheResponseSuccess
                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeCacheResponseSuccess
 
+      interface _DescribeCacheReportResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DescribeCacheReportOutput]
+        def cache_report_info: () -> Types::CacheReportInfo
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#describe_cache_report-instance_method
+      def describe_cache_report: (
+                                   cache_report_arn: ::String
+                                 ) -> _DescribeCacheReportResponseSuccess
+                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeCacheReportResponseSuccess
+
       interface _DescribeCachediSCSIVolumesResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::DescribeCachediSCSIVolumesOutput]
         def cached_iscsi_volumes: () -> ::Array[Types::CachediSCSIVolume]
@@ -900,6 +930,17 @@ module Aws
                                                  ) -> _ListAutomaticTapeCreationPoliciesResponseSuccess
                                                | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListAutomaticTapeCreationPoliciesResponseSuccess
 
+      interface _ListCacheReportsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListCacheReportsOutput]
+        def cache_report_list: () -> ::Array[Types::CacheReportInfo]
+        def marker: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#list_cache_reports-instance_method
+      def list_cache_reports: (
+                                ?marker: ::String
+                              ) -> _ListCacheReportsResponseSuccess
+                            | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCacheReportsResponseSuccess
+
       interface _ListFileSharesResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListFileSharesOutput]
         def marker: () -> ::String
@@ -1135,6 +1176,39 @@ module Aws
                                            ) -> _StartAvailabilityMonitorTestResponseSuccess
                                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartAvailabilityMonitorTestResponseSuccess
 
+      interface _StartCacheReportResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::StartCacheReportOutput]
+        def cache_report_arn: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#start_cache_report-instance_method
+      def start_cache_report: (
+                                file_share_arn: ::String,
+                                role: ::String,
+                                location_arn: ::String,
+                                bucket_region: ::String,
+                                ?vpc_endpoint_dns_name: ::String,
+                                ?inclusion_filters: Array[
+                                  {
+                                    name: ("UploadState" | "UploadFailureReason"),
+                                    values: Array[::String]
+                                  },
+                                ],
+                                ?exclusion_filters: Array[
+                                  {
+                                    name: ("UploadState" | "UploadFailureReason"),
+                                    values: Array[::String]
+                                  },
+                                ],
+                                client_token: ::String,
+                                ?tags: Array[
+                                  {
+                                    key: ::String,
+                                    value: ::String
+                                  },
+                                ]
+                              ) -> _StartCacheReportResponseSuccess
+                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartCacheReportResponseSuccess
+
       interface _StartGatewayResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::StartGatewayOutput]
         def gateway_arn: () -> ::String

data/sig/types.rbs

@@ -145,6 +145,28 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class CacheReportFilter
+      attr_accessor name: ("UploadState" | "UploadFailureReason")
+      attr_accessor values: ::Array[::String]
+      SENSITIVE: []
+    end
+
+    class CacheReportInfo
+      attr_accessor cache_report_arn: ::String
+      attr_accessor cache_report_status: ("IN_PROGRESS" | "COMPLETED" | "CANCELED" | "FAILED" | "ERROR")
+      attr_accessor report_completion_percent: ::Integer
+      attr_accessor end_time: ::Time
+      attr_accessor role: ::String
+      attr_accessor file_share_arn: ::String
+      attr_accessor location_arn: ::String
+      attr_accessor start_time: ::Time
+      attr_accessor inclusion_filters: ::Array[Types::CacheReportFilter]
+      attr_accessor exclusion_filters: ::Array[Types::CacheReportFilter]
+      attr_accessor report_name: ::String
+      attr_accessor tags: ::Array[Types::Tag]
+      SENSITIVE: []
+    end
+
     class CachediSCSIVolume
       attr_accessor volume_arn: ::String
       attr_accessor volume_id: ::String
@@ -173,6 +195,16 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class CancelCacheReportInput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
+    class CancelCacheReportOutput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
     class CancelRetrievalInput
       attr_accessor gateway_arn: ::String
       attr_accessor tape_arn: ::String
@@ -397,6 +429,16 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class DeleteCacheReportInput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
+    class DeleteCacheReportOutput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
     class DeleteChapCredentialsInput
       attr_accessor target_arn: ::String
       attr_accessor initiator_name: ::String
@@ -534,6 +576,16 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class DescribeCacheReportInput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
+    class DescribeCacheReportOutput
+      attr_accessor cache_report_info: Types::CacheReportInfo
+      SENSITIVE: []
+    end
+
     class DescribeCachediSCSIVolumesInput
       attr_accessor volume_arns: ::Array[::String]
       SENSITIVE: []
@@ -900,6 +952,17 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class ListCacheReportsInput
+      attr_accessor marker: ::String
+      SENSITIVE: []
+    end
+
+    class ListCacheReportsOutput
+      attr_accessor cache_report_list: ::Array[Types::CacheReportInfo]
+      attr_accessor marker: ::String
+      SENSITIVE: []
+    end
+
     class ListFileSharesInput
       attr_accessor gateway_arn: ::String
       attr_accessor limit: ::Integer
@@ -1239,6 +1302,24 @@ module Aws::StorageGateway
       SENSITIVE: []
     end
 
+    class StartCacheReportInput
+      attr_accessor file_share_arn: ::String
+      attr_accessor role: ::String
+      attr_accessor location_arn: ::String
+      attr_accessor bucket_region: ::String
+      attr_accessor vpc_endpoint_dns_name: ::String
+      attr_accessor inclusion_filters: ::Array[Types::CacheReportFilter]
+      attr_accessor exclusion_filters: ::Array[Types::CacheReportFilter]
+      attr_accessor client_token: ::String
+      attr_accessor tags: ::Array[Types::Tag]
+      SENSITIVE: []
+    end
+
+    class StartCacheReportOutput
+      attr_accessor cache_report_arn: ::String
+      SENSITIVE: []
+    end
+
     class StartGatewayInput
       attr_accessor gateway_arn: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-storagegateway
 version: !ruby/object:Gem::Version
-  version: 1.103.0
+  version: 1.104.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-06 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core