aws-sdk-storagegateway 1.54.0 → 1.55.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6100cd8b682bb19d3dd56d5faebdaf27e79d0b4b4f1211b8d3dac623cd324e19
4
- data.tar.gz: 3e8d1b47e6a49cd7683923b4c9ae2440b2cd270c5232e60e5b7ab04295ed8a6a
3
+ metadata.gz: 63a78c9034098eb8e2f3591d751b897f293127b035f1127ffbe495fa9d8c3bda
4
+ data.tar.gz: 5c76e00de07ae6e89b00330143fbeb9dcb77f49747f408982fd6cfba1ba02d1f
5
5
  SHA512:
6
- metadata.gz: f175dc2e7ef450e9cb7dae996748a630c18c9f5221810ef1202be76f902eab16569acd6e7788447a6bd2a1afa2e7bf56c1fc919791761c6c67923b43ccaf4967
7
- data.tar.gz: 4143fc71ac27929200edc68cff3f976ae8fbb0a557b4582d4bd4ce1b1d33b5bbef630b87c794b76b701750c5af10a0fe02cc9d8f5de7198f80a9d695a8e2493e
6
+ metadata.gz: 4b5d576df02bdcd7c0e1313878230826440d5590542bf16bd812766d1191caf448b104bd7bbdf746bd5fc39c1f69d61abc462056143c3c6f6e6807c1d2e13f11
7
+ data.tar.gz: 859dee0a753ac78cd07750e8ddcf0e555f4b1e228e34d9ff3654eb89babe2eead3358e41b79665e47247021e1092b5ae2f92c2a9b32bd13ec036ef932c971125
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.55.0 (2021-04-07)
5
+ ------------------
6
+
7
+ * Feature - File Gateway APIs now support FSx for Windows as a cloud storage.
8
+
4
9
  1.54.0 (2021-03-10)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.54.0
1
+ 1.55.0
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-storagegateway/customizations'
48
48
  # @!group service
49
49
  module Aws::StorageGateway
50
50
 
51
- GEM_VERSION = '1.54.0'
51
+ GEM_VERSION = '1.55.0'
52
52
 
53
53
  end
@@ -627,7 +627,7 @@ module Aws::StorageGateway
627
627
 
628
628
  # Configures one or more gateway local disks as upload buffer for a
629
629
  # specified gateway. This operation is supported for the stored volume,
630
- # cached volume and tape gateway types.
630
+ # cached volume, and tape gateway types.
631
631
  #
632
632
  # In the request, you specify the gateway Amazon Resource Name (ARN) to
633
633
  # which you want to add upload buffer, and one or more disk IDs that you
@@ -809,6 +809,79 @@ module Aws::StorageGateway
809
809
  req.send_request(options)
810
810
  end
811
811
 
812
+ # Associate an Amazon FSx file system with the Amazon FSx file gateway.
813
+ # After the association process is complete, the file shares on the
814
+ # Amazon FSx file system are available for access through the gateway.
815
+ # This operation only supports the Amazon FSx file gateway type.
816
+ #
817
+ # @option params [required, String] :user_name
818
+ # The user name of the user credential that has permission to access the
819
+ # root share D$ of the Amazon FSx file system. The user account must
820
+ # belong to the Amazon FSx delegated admin user group.
821
+ #
822
+ # @option params [required, String] :password
823
+ # The password of the user credential.
824
+ #
825
+ # @option params [required, String] :client_token
826
+ # A unique string value that you supply that is used by the file gateway
827
+ # to ensure idempotent file system association creation.
828
+ #
829
+ # @option params [required, String] :gateway_arn
830
+ # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways
831
+ # operation to return a list of gateways for your account and AWS
832
+ # Region.
833
+ #
834
+ # @option params [required, String] :location_arn
835
+ # The Amazon Resource Name (ARN) of the Amazon FSx file system to
836
+ # associate with the Amazon FSx file gateway.
837
+ #
838
+ # @option params [Array<Types::Tag>] :tags
839
+ # A list of up to 50 tags that can be assigned to the file system
840
+ # association. Each tag is a key-value pair.
841
+ #
842
+ # @option params [String] :audit_destination_arn
843
+ # The Amazon Resource Name (ARN) of the storage used for the audit logs.
844
+ #
845
+ # @option params [Types::CacheAttributes] :cache_attributes
846
+ # The refresh cache information for the file share.
847
+ #
848
+ # @return [Types::AssociateFileSystemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
849
+ #
850
+ # * {Types::AssociateFileSystemOutput#file_system_association_arn #file_system_association_arn} => String
851
+ #
852
+ # @example Request syntax with placeholder values
853
+ #
854
+ # resp = client.associate_file_system({
855
+ # user_name: "DomainUserName", # required
856
+ # password: "DomainUserPassword", # required
857
+ # client_token: "ClientToken", # required
858
+ # gateway_arn: "GatewayARN", # required
859
+ # location_arn: "FileSystemLocationARN", # required
860
+ # tags: [
861
+ # {
862
+ # key: "TagKey", # required
863
+ # value: "TagValue", # required
864
+ # },
865
+ # ],
866
+ # audit_destination_arn: "AuditDestinationARN",
867
+ # cache_attributes: {
868
+ # cache_stale_timeout_in_seconds: 1,
869
+ # },
870
+ # })
871
+ #
872
+ # @example Response structure
873
+ #
874
+ # resp.file_system_association_arn #=> String
875
+ #
876
+ # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AssociateFileSystem AWS API Documentation
877
+ #
878
+ # @overload associate_file_system(params = {})
879
+ # @param [Hash] params ({})
880
+ def associate_file_system(params = {}, options = {})
881
+ req = build_request(:associate_file_system, params)
882
+ req.send_request(options)
883
+ end
884
+
812
885
  # Connects a volume to an iSCSI connection and then attaches the volume
813
886
  # to the specified gateway. Detaching and attaching a volume enables you
814
887
  # to recover your data from one gateway to a different gateway without
@@ -1262,10 +1335,30 @@ module Aws::StorageGateway
1262
1335
  # </note>
1263
1336
  #
1264
1337
  # @option params [Types::CacheAttributes] :cache_attributes
1265
- # Refresh cache information.
1338
+ # Specifies refresh cache information for the file share.
1266
1339
  #
1267
1340
  # @option params [String] :notification_policy
1268
- # The notification policy of the file share.
1341
+ # The notification policy of the file share. `SettlingTimeInSeconds`
1342
+ # controls the number of seconds to wait after the last point in time a
1343
+ # client wrote to a file before generating an `ObjectUploaded`
1344
+ # notification. Because clients can make many small writes to files,
1345
+ # it's best to set this parameter for as long as possible to avoid
1346
+ # generating multiple notifications for the same file in a small time
1347
+ # period.
1348
+ #
1349
+ # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1350
+ # uploading to Amazon S3, only the timing of the notification.
1351
+ #
1352
+ # </note>
1353
+ #
1354
+ # The following example sets `NotificationPolicy` on with
1355
+ # `SettlingTimeInSeconds` set to 60.
1356
+ #
1357
+ # `\{"Upload": \{"SettlingTimeInSeconds": 60\}\}`
1358
+ #
1359
+ # The following example sets `NotificationPolicy` off.
1360
+ #
1361
+ # `\{\}`
1269
1362
  #
1270
1363
  # @return [Types::CreateNFSFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1271
1364
  #
@@ -1452,7 +1545,7 @@ module Aws::StorageGateway
1452
1545
  # set to `ActiveDirectory`.
1453
1546
  #
1454
1547
  # @option params [String] :audit_destination_arn
1455
- # The Amazon Resource Name (ARN) of the storage used for the audit logs.
1548
+ # The Amazon Resource Name (ARN) of the storage used for audit logs.
1456
1549
  #
1457
1550
  # @option params [String] :authentication
1458
1551
  # The authentication method that users use to access the file share. The
@@ -1486,10 +1579,30 @@ module Aws::StorageGateway
1486
1579
  # </note>
1487
1580
  #
1488
1581
  # @option params [Types::CacheAttributes] :cache_attributes
1489
- # Refresh cache information.
1582
+ # Specifies refresh cache information for the file share.
1490
1583
  #
1491
1584
  # @option params [String] :notification_policy
1492
- # The notification policy of the file share.
1585
+ # The notification policy of the file share. `SettlingTimeInSeconds`
1586
+ # controls the number of seconds to wait after the last point in time a
1587
+ # client wrote to a file before generating an `ObjectUploaded`
1588
+ # notification. Because clients can make many small writes to files,
1589
+ # it's best to set this parameter for as long as possible to avoid
1590
+ # generating multiple notifications for the same file in a small time
1591
+ # period.
1592
+ #
1593
+ # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1594
+ # uploading to Amazon S3, only the timing of the notification.
1595
+ #
1596
+ # </note>
1597
+ #
1598
+ # The following example sets `NotificationPolicy` on with
1599
+ # `SettlingTimeInSeconds` set to 60.
1600
+ #
1601
+ # `\{"Upload": \{"SettlingTimeInSeconds": 60\}\}`
1602
+ #
1603
+ # The following example sets `NotificationPolicy` off.
1604
+ #
1605
+ # `\{\}`
1493
1606
  #
1494
1607
  # @return [Types::CreateSMBFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1495
1608
  #
@@ -1511,9 +1624,9 @@ module Aws::StorageGateway
1511
1624
  # requester_pays: false,
1512
1625
  # smbacl_enabled: false,
1513
1626
  # access_based_enumeration: false,
1514
- # admin_user_list: ["FileShareUser"],
1515
- # valid_user_list: ["FileShareUser"],
1516
- # invalid_user_list: ["FileShareUser"],
1627
+ # admin_user_list: ["UserListUser"],
1628
+ # valid_user_list: ["UserListUser"],
1629
+ # invalid_user_list: ["UserListUser"],
1517
1630
  # audit_destination_arn: "AuditDestinationARN",
1518
1631
  # authentication: "Authentication",
1519
1632
  # case_sensitivity: "ClientSpecified", # accepts ClientSpecified, CaseSensitive
@@ -1547,7 +1660,7 @@ module Aws::StorageGateway
1547
1660
  #
1548
1661
  # AWS Storage Gateway provides the ability to back up point-in-time
1549
1662
  # snapshots of your data to Amazon Simple Storage (Amazon S3) for
1550
- # durable off-site recovery, as well as import the data to an Amazon
1663
+ # durable off-site recovery, and also import the data to an Amazon
1551
1664
  # Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud
1552
1665
  # (EC2). You can take snapshots of your gateway volume on a scheduled or
1553
1666
  # ad hoc basis. This API enables you to take an ad hoc snapshot. For
@@ -1779,8 +1892,8 @@ module Aws::StorageGateway
1779
1892
  # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/API_ListLocalDisks.html
1780
1893
  #
1781
1894
  # @option params [String] :snapshot_id
1782
- # The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as
1783
- # the new stored volume. Specify this field if you want to create the
1895
+ # The snapshot ID (e.g., "snap-1122aabb") of the snapshot to restore
1896
+ # as the new stored volume. Specify this field if you want to create the
1784
1897
  # iSCSI storage volume from a snapshot; otherwise, do not include this
1785
1898
  # field. To list snapshots for your account use [DescribeSnapshots][1]
1786
1899
  # in the *Amazon Elastic Compute Cloud API Reference*.
@@ -1790,7 +1903,7 @@ module Aws::StorageGateway
1790
1903
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html
1791
1904
  #
1792
1905
  # @option params [required, Boolean] :preserve_existing_data
1793
- # Set to true `true` if you want to preserve the data on the local disk.
1906
+ # Set to `true` if you want to preserve the data on the local disk.
1794
1907
  # Otherwise, set to `false` to create an empty volume.
1795
1908
  #
1796
1909
  # Valid Values: `true` \| `false`
@@ -2121,7 +2234,7 @@ module Aws::StorageGateway
2121
2234
  # A prefix that you append to the barcode of the virtual tape you are
2122
2235
  # creating. This prefix makes the barcode unique.
2123
2236
  #
2124
- # <note markdown="1"> The prefix must be 1 to 4 characters in length and must be one of the
2237
+ # <note markdown="1"> The prefix must be 1-4 characters in length and must be one of the
2125
2238
  # uppercase letters from A to Z.
2126
2239
  #
2127
2240
  # </note>
@@ -2733,7 +2846,7 @@ module Aws::StorageGateway
2733
2846
  req.send_request(options)
2734
2847
  end
2735
2848
 
2736
- # Returns information about the most recent High Availability monitoring
2849
+ # Returns information about the most recent high availability monitoring
2737
2850
  # test that was performed on the host in a cluster. If a test isn't
2738
2851
  # performed, the status and start time in the response would be null.
2739
2852
  #
@@ -3100,6 +3213,45 @@ module Aws::StorageGateway
3100
3213
  req.send_request(options)
3101
3214
  end
3102
3215
 
3216
+ # Gets the file system association information. This operation is only
3217
+ # supported for Amazon FSx file gateways.
3218
+ #
3219
+ # @option params [required, Array<String>] :file_system_association_arn_list
3220
+ # An array containing the Amazon Resource Name (ARN) of each file system
3221
+ # association to be described.
3222
+ #
3223
+ # @return [Types::DescribeFileSystemAssociationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3224
+ #
3225
+ # * {Types::DescribeFileSystemAssociationsOutput#file_system_association_info_list #file_system_association_info_list} => Array&lt;Types::FileSystemAssociationInfo&gt;
3226
+ #
3227
+ # @example Request syntax with placeholder values
3228
+ #
3229
+ # resp = client.describe_file_system_associations({
3230
+ # file_system_association_arn_list: ["FileSystemAssociationARN"], # required
3231
+ # })
3232
+ #
3233
+ # @example Response structure
3234
+ #
3235
+ # resp.file_system_association_info_list #=> Array
3236
+ # resp.file_system_association_info_list[0].file_system_association_arn #=> String
3237
+ # resp.file_system_association_info_list[0].location_arn #=> String
3238
+ # resp.file_system_association_info_list[0].file_system_association_status #=> String
3239
+ # resp.file_system_association_info_list[0].audit_destination_arn #=> String
3240
+ # resp.file_system_association_info_list[0].gateway_arn #=> String
3241
+ # resp.file_system_association_info_list[0].tags #=> Array
3242
+ # resp.file_system_association_info_list[0].tags[0].key #=> String
3243
+ # resp.file_system_association_info_list[0].tags[0].value #=> String
3244
+ # resp.file_system_association_info_list[0].cache_attributes.cache_stale_timeout_in_seconds #=> Integer
3245
+ #
3246
+ # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeFileSystemAssociations AWS API Documentation
3247
+ #
3248
+ # @overload describe_file_system_associations(params = {})
3249
+ # @param [Hash] params ({})
3250
+ def describe_file_system_associations(params = {}, options = {})
3251
+ req = build_request(:describe_file_system_associations, params)
3252
+ req.send_request(options)
3253
+ end
3254
+
3103
3255
  # Returns metadata about a gateway such as its name, network interfaces,
3104
3256
  # configured time zone, and the state (whether the gateway is running or
3105
3257
  # not). To specify which gateway to describe, use the Amazon Resource
@@ -4235,6 +4387,46 @@ module Aws::StorageGateway
4235
4387
  req.send_request(options)
4236
4388
  end
4237
4389
 
4390
+ # Disassociates an Amazon FSx file system from the specified gateway.
4391
+ # After the disassociation process finishes, the gateway can no longer
4392
+ # access the Amazon FSx file system. This operation is only supported in
4393
+ # the Amazon FSx file gateway type.
4394
+ #
4395
+ # @option params [required, String] :file_system_association_arn
4396
+ # The Amazon Resource Name (ARN) of the file system association to be
4397
+ # deleted.
4398
+ #
4399
+ # @option params [Boolean] :force_delete
4400
+ # If this value is set to true, the operation disassociates an Amazon
4401
+ # FSx file system immediately. It ends all data uploads to the file
4402
+ # system, and the file system association enters the `FORCE_DELETING`
4403
+ # status. If this value is set to false, the Amazon FSx file system does
4404
+ # not disassociate until all data is uploaded.
4405
+ #
4406
+ # @return [Types::DisassociateFileSystemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4407
+ #
4408
+ # * {Types::DisassociateFileSystemOutput#file_system_association_arn #file_system_association_arn} => String
4409
+ #
4410
+ # @example Request syntax with placeholder values
4411
+ #
4412
+ # resp = client.disassociate_file_system({
4413
+ # file_system_association_arn: "FileSystemAssociationARN", # required
4414
+ # force_delete: false,
4415
+ # })
4416
+ #
4417
+ # @example Response structure
4418
+ #
4419
+ # resp.file_system_association_arn #=> String
4420
+ #
4421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DisassociateFileSystem AWS API Documentation
4422
+ #
4423
+ # @overload disassociate_file_system(params = {})
4424
+ # @param [Hash] params ({})
4425
+ def disassociate_file_system(params = {}, options = {})
4426
+ req = build_request(:disassociate_file_system, params)
4427
+ req.send_request(options)
4428
+ end
4429
+
4238
4430
  # Adds a file gateway to an Active Directory domain. This operation is
4239
4431
  # only supported for file gateways that support the SMB file protocol.
4240
4432
  #
@@ -4398,6 +4590,61 @@ module Aws::StorageGateway
4398
4590
  req.send_request(options)
4399
4591
  end
4400
4592
 
4593
+ # Gets a list of `FileSystemAssociationSummary` objects. Each object
4594
+ # contains a summary of a file system association. This operation is
4595
+ # only supported for Amazon FSx file gateways.
4596
+ #
4597
+ # @option params [String] :gateway_arn
4598
+ # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways
4599
+ # operation to return a list of gateways for your account and AWS
4600
+ # Region.
4601
+ #
4602
+ # @option params [Integer] :limit
4603
+ # The maximum number of file system associations to return in the
4604
+ # response. If present, `Limit` must be an integer with a value greater
4605
+ # than zero. Optional.
4606
+ #
4607
+ # @option params [String] :marker
4608
+ # Opaque pagination token returned from a previous
4609
+ # `ListFileSystemAssociations` operation. If present, `Marker` specifies
4610
+ # where to continue the list from after a previous call to
4611
+ # `ListFileSystemAssociations`. Optional.
4612
+ #
4613
+ # @return [Types::ListFileSystemAssociationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4614
+ #
4615
+ # * {Types::ListFileSystemAssociationsOutput#marker #marker} => String
4616
+ # * {Types::ListFileSystemAssociationsOutput#next_marker #next_marker} => String
4617
+ # * {Types::ListFileSystemAssociationsOutput#file_system_association_summary_list #file_system_association_summary_list} => Array&lt;Types::FileSystemAssociationSummary&gt;
4618
+ #
4619
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4620
+ #
4621
+ # @example Request syntax with placeholder values
4622
+ #
4623
+ # resp = client.list_file_system_associations({
4624
+ # gateway_arn: "GatewayARN",
4625
+ # limit: 1,
4626
+ # marker: "Marker",
4627
+ # })
4628
+ #
4629
+ # @example Response structure
4630
+ #
4631
+ # resp.marker #=> String
4632
+ # resp.next_marker #=> String
4633
+ # resp.file_system_association_summary_list #=> Array
4634
+ # resp.file_system_association_summary_list[0].file_system_association_id #=> String
4635
+ # resp.file_system_association_summary_list[0].file_system_association_arn #=> String
4636
+ # resp.file_system_association_summary_list[0].file_system_association_status #=> String
4637
+ # resp.file_system_association_summary_list[0].gateway_arn #=> String
4638
+ #
4639
+ # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListFileSystemAssociations AWS API Documentation
4640
+ #
4641
+ # @overload list_file_system_associations(params = {})
4642
+ # @param [Hash] params ({})
4643
+ def list_file_system_associations(params = {}, options = {})
4644
+ req = build_request(:list_file_system_associations, params)
4645
+ req.send_request(options)
4646
+ end
4647
+
4401
4648
  # Lists gateways owned by an AWS account in an AWS Region specified in
4402
4649
  # the request. The returned list is ordered by gateway Amazon Resource
4403
4650
  # Name (ARN).
@@ -5004,25 +5251,28 @@ module Aws::StorageGateway
5004
5251
  req.send_request(options)
5005
5252
  end
5006
5253
 
5007
- # Refreshes the cache for the specified file share. This operation finds
5008
- # objects in the Amazon S3 bucket that were added, removed, or replaced
5009
- # since the gateway last listed the bucket's contents and cached the
5010
- # results. This operation is only supported in the file gateway type.
5011
- # You can subscribe to be notified through an Amazon CloudWatch event
5012
- # when your RefreshCache operation completes. For more information, see
5013
- # [Getting notified about file operations][1] in the *AWS Storage
5014
- # Gateway User Guide*.
5254
+ # Refreshes the cached inventory of objects for the specified file
5255
+ # share. This operation finds objects in the Amazon S3 bucket that were
5256
+ # added, removed, or replaced since the gateway last listed the
5257
+ # bucket's contents and cached the results. This operation does not
5258
+ # import files into the file gateway cache storage. It only updates the
5259
+ # cached inventory to reflect changes in the inventory of the objects in
5260
+ # the S3 bucket. This operation is only supported in the file gateway
5261
+ # type. You can subscribe to be notified through an Amazon CloudWatch
5262
+ # event when your `RefreshCache` operation completes. For more
5263
+ # information, see [Getting notified about file operations][1] in the
5264
+ # *AWS Storage Gateway User Guide*.
5015
5265
  #
5016
5266
  # When this API is called, it only initiates the refresh operation. When
5017
5267
  # the API call completes and returns a success code, it doesn't
5018
5268
  # necessarily mean that the file refresh has completed. You should use
5019
5269
  # the refresh-complete notification to determine that the operation has
5020
5270
  # completed before you check for new files on the gateway file share.
5021
- # You can subscribe to be notified through an CloudWatch event when your
5271
+ # You can subscribe to be notified through a CloudWatch event when your
5022
5272
  # `RefreshCache` operation completes.
5023
5273
  #
5024
- # Throttle limit: This API is asynchronous so the gateway will accept no
5025
- # more than two refreshes at any time. We recommend using the
5274
+ # Throttle limit: This API is asynchronous, so the gateway will accept
5275
+ # no more than two refreshes at any time. We recommend using the
5026
5276
  # refresh-complete CloudWatch event notification before issuing
5027
5277
  # additional requests. For more information, see [Getting notified about
5028
5278
  # file operations][1] in the *AWS Storage Gateway User Guide*.
@@ -5830,6 +6080,56 @@ module Aws::StorageGateway
5830
6080
  req.send_request(options)
5831
6081
  end
5832
6082
 
6083
+ # Updates a file system association. This operation is only supported in
6084
+ # the Amazon FSx file gateway type.
6085
+ #
6086
+ # @option params [required, String] :file_system_association_arn
6087
+ # The Amazon Resource Name (ARN) of the file system association that you
6088
+ # want to update.
6089
+ #
6090
+ # @option params [String] :user_name
6091
+ # The user name of the user credential that has permission to access the
6092
+ # root share D$ of the Amazon FSx file system. The user account must
6093
+ # belong to the Amazon FSx delegated admin user group.
6094
+ #
6095
+ # @option params [String] :password
6096
+ # The password of the user credential.
6097
+ #
6098
+ # @option params [String] :audit_destination_arn
6099
+ # The Amazon Resource Name (ARN) of the storage used for the audit logs.
6100
+ #
6101
+ # @option params [Types::CacheAttributes] :cache_attributes
6102
+ # The refresh cache information for the file share.
6103
+ #
6104
+ # @return [Types::UpdateFileSystemAssociationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6105
+ #
6106
+ # * {Types::UpdateFileSystemAssociationOutput#file_system_association_arn #file_system_association_arn} => String
6107
+ #
6108
+ # @example Request syntax with placeholder values
6109
+ #
6110
+ # resp = client.update_file_system_association({
6111
+ # file_system_association_arn: "FileSystemAssociationARN", # required
6112
+ # user_name: "DomainUserName",
6113
+ # password: "DomainUserPassword",
6114
+ # audit_destination_arn: "AuditDestinationARN",
6115
+ # cache_attributes: {
6116
+ # cache_stale_timeout_in_seconds: 1,
6117
+ # },
6118
+ # })
6119
+ #
6120
+ # @example Response structure
6121
+ #
6122
+ # resp.file_system_association_arn #=> String
6123
+ #
6124
+ # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateFileSystemAssociation AWS API Documentation
6125
+ #
6126
+ # @overload update_file_system_association(params = {})
6127
+ # @param [Hash] params ({})
6128
+ def update_file_system_association(params = {}, options = {})
6129
+ req = build_request(:update_file_system_association, params)
6130
+ req.send_request(options)
6131
+ end
6132
+
5833
6133
  # Updates a gateway's metadata, which includes the gateway's name and
5834
6134
  # time zone. To specify which gateway to update, use the Amazon Resource
5835
6135
  # Name (ARN) of the gateway in your request.
@@ -6147,10 +6447,30 @@ module Aws::StorageGateway
6147
6447
  # </note>
6148
6448
  #
6149
6449
  # @option params [Types::CacheAttributes] :cache_attributes
6150
- # Refresh cache information.
6450
+ # specifies refresh cache information for the file share.
6151
6451
  #
6152
6452
  # @option params [String] :notification_policy
6153
- # The notification policy of the file share.
6453
+ # The notification policy of the file share. `SettlingTimeInSeconds`
6454
+ # controls the number of seconds to wait after the last point in time a
6455
+ # client wrote to a file before generating an `ObjectUploaded`
6456
+ # notification. Because clients can make many small writes to files,
6457
+ # it's best to set this parameter for as long as possible to avoid
6458
+ # generating multiple notifications for the same file in a small time
6459
+ # period.
6460
+ #
6461
+ # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
6462
+ # uploading to Amazon S3, only the timing of the notification.
6463
+ #
6464
+ # </note>
6465
+ #
6466
+ # The following example sets `NotificationPolicy` on with
6467
+ # `SettlingTimeInSeconds` set to 60.
6468
+ #
6469
+ # `\{"Upload": \{"SettlingTimeInSeconds": 60\}\}`
6470
+ #
6471
+ # The following example sets `NotificationPolicy` off.
6472
+ #
6473
+ # `\{\}`
6154
6474
  #
6155
6475
  # @return [Types::UpdateNFSFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6156
6476
  #
@@ -6317,7 +6637,7 @@ module Aws::StorageGateway
6317
6637
  # set to `ActiveDirectory`.
6318
6638
  #
6319
6639
  # @option params [String] :audit_destination_arn
6320
- # The Amazon Resource Name (ARN) of the storage used for the audit logs.
6640
+ # The Amazon Resource Name (ARN) of the storage used for audit logs.
6321
6641
  #
6322
6642
  # @option params [String] :case_sensitivity
6323
6643
  # The case of an object name in an Amazon S3 bucket. For
@@ -6334,10 +6654,30 @@ module Aws::StorageGateway
6334
6654
  # </note>
6335
6655
  #
6336
6656
  # @option params [Types::CacheAttributes] :cache_attributes
6337
- # Refresh cache information.
6657
+ # Specifies refresh cache information for the file share.
6338
6658
  #
6339
6659
  # @option params [String] :notification_policy
6340
- # The notification policy of the file share.
6660
+ # The notification policy of the file share. `SettlingTimeInSeconds`
6661
+ # controls the number of seconds to wait after the last point in time a
6662
+ # client wrote to a file before generating an `ObjectUploaded`
6663
+ # notification. Because clients can make many small writes to files,
6664
+ # it's best to set this parameter for as long as possible to avoid
6665
+ # generating multiple notifications for the same file in a small time
6666
+ # period.
6667
+ #
6668
+ # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
6669
+ # uploading to Amazon S3, only the timing of the notification.
6670
+ #
6671
+ # </note>
6672
+ #
6673
+ # The following example sets `NotificationPolicy` on with
6674
+ # `SettlingTimeInSeconds` set to 60.
6675
+ #
6676
+ # `\{"Upload": \{"SettlingTimeInSeconds": 60\}\}`
6677
+ #
6678
+ # The following example sets `NotificationPolicy` off.
6679
+ #
6680
+ # `\{\}`
6341
6681
  #
6342
6682
  # @return [Types::UpdateSMBFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6343
6683
  #
@@ -6356,9 +6696,9 @@ module Aws::StorageGateway
6356
6696
  # requester_pays: false,
6357
6697
  # smbacl_enabled: false,
6358
6698
  # access_based_enumeration: false,
6359
- # admin_user_list: ["FileShareUser"],
6360
- # valid_user_list: ["FileShareUser"],
6361
- # invalid_user_list: ["FileShareUser"],
6699
+ # admin_user_list: ["UserListUser"],
6700
+ # valid_user_list: ["UserListUser"],
6701
+ # invalid_user_list: ["UserListUser"],
6362
6702
  # audit_destination_arn: "AuditDestinationARN",
6363
6703
  # case_sensitivity: "ClientSpecified", # accepts ClientSpecified, CaseSensitive
6364
6704
  # file_share_name: "FileShareName",
@@ -6629,7 +6969,7 @@ module Aws::StorageGateway
6629
6969
  params: params,
6630
6970
  config: config)
6631
6971
  context[:gem_name] = 'aws-sdk-storagegateway'
6632
- context[:gem_version] = '1.54.0'
6972
+ context[:gem_version] = '1.55.0'
6633
6973
  Seahorse::Client::Request.new(handlers, context)
6634
6974
  end
6635
6975