aws-sdk-storagegateway 1.54.0 → 1.55.0

Sign up to get free protection for your applications and to get access to all the features.
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