aws-sdk-storagegateway 1.94.0 → 1.95.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: 5f0914d8108f99e02db2962ae9d05525593f72784519f13d2bac0c6e1d6f0a02
4
- data.tar.gz: 327a40525e4d2092aa34b6e7de591341244d99cea09e5386fbec22683a86beca
3
+ metadata.gz: 1505583933fee1695cf586f60032612bc7b2a5f49d8baf5babb963215150a323
4
+ data.tar.gz: d72049d456ad5a6d0efb62888bcbc2ec614ea8f67deacc443ccc179df405d200
5
5
  SHA512:
6
- metadata.gz: 0c78804bd83742f8b98fc92d7e229d692ea49c27e2e34fd043f9e8e617207f162b7dadc8a8d26b29b52cda9a8f1288cf5c502df9ba2a4314edc2e0eed888b9fc
7
- data.tar.gz: 0ddd9087bc3fce04133c61703941db3e84e907e2e60959adaab85fa10c8086414468d2ecde84a57b174f93d1bdc5e882e80f79c61b2f862014f3f245be488ffb
6
+ metadata.gz: a62893f952ebfc0eed4c797c74b3dd4fbce5c9afdaef9a0e8a6e3d7bc5daf392760b9b182d939a40916fcf4a7a793f383b5adbe1375ca746e2954be6e54b2f15
7
+ data.tar.gz: 1544f47cec2e18c0d20eceaebbebff105f66a98efef5ace092202bad117c75be9adfc1a966e13b9c0387ebc4cb63909c953da6db5b1a74fc5cdf5d60cf187158
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.95.0 (2024-09-12)
5
+ ------------------
6
+
7
+ * Feature - The S3 File Gateway now supports DSSE-KMS encryption. A new parameter EncryptionType is added to these APIs: CreateSmbFileShare, CreateNfsFileShare, UpdateSmbFileShare, UpdateNfsFileShare, DescribeSmbFileShares, DescribeNfsFileShares. Also, in favor of EncryptionType, KmsEncrypted is deprecated.
8
+
4
9
  1.94.0 (2024-09-11)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.94.0
1
+ 1.95.0
@@ -1367,17 +1367,48 @@ module Aws::StorageGateway
1367
1367
  # The Amazon Resource Name (ARN) of the S3 File Gateway on which you
1368
1368
  # want to create a file share.
1369
1369
  #
1370
+ # @option params [String] :encryption_type
1371
+ # A value that specifies the type of server-side encryption that the
1372
+ # file share will use for the data that it stores in Amazon S3.
1373
+ #
1374
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1375
+ # the file share encryption method. You do not need to provide values
1376
+ # for both parameters.
1377
+ #
1378
+ # If values for both parameters exist in the same request, then the
1379
+ # specified encryption methods must not conflict. For example, if
1380
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1381
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
1382
+ # `true`.
1383
+ #
1384
+ # </note>
1385
+ #
1370
1386
  # @option params [Boolean] :kms_encrypted
1371
- # Set to `true` to use Amazon S3 server-side encryption with your own
1372
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
1387
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
1388
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by Amazon
1389
+ # S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
1390
+ # `EncryptionType` parameter instead.
1391
+ #
1392
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1393
+ # the file share encryption method. You do not need to provide values
1394
+ # for both parameters.
1395
+ #
1396
+ # If values for both parameters exist in the same request, then the
1397
+ # specified encryption methods must not conflict. For example, if
1398
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1399
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
1400
+ # `true`.
1401
+ #
1402
+ # </note>
1373
1403
  #
1374
1404
  # Valid Values: `true` \| `false`
1375
1405
  #
1376
1406
  # @option params [String] :kms_key
1377
- # The Amazon Resource Name (ARN) of a symmetric customer master key
1378
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1379
- # not support asymmetric CMKs. This value can only be set when
1380
- # `KMSEncrypted` is `true`. Optional.
1407
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
1408
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
1409
+ # Gateway does not support asymmetric CMKs. This value must be set if
1410
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
1411
+ # `DsseKms`.
1381
1412
  #
1382
1413
  # @option params [required, String] :role
1383
1414
  # The ARN of the Identity and Access Management (IAM) role that an S3
@@ -1503,6 +1534,10 @@ module Aws::StorageGateway
1503
1534
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1504
1535
  # uploading to Amazon S3, only the timing of the notification.
1505
1536
  #
1537
+ # This setting is not meant to specify an exact time at which the
1538
+ # notification will be sent. In some cases, the gateway might require
1539
+ # more than the specified delay time to generate and send notifications.
1540
+ #
1506
1541
  # </note>
1507
1542
  #
1508
1543
  # The following example sets `NotificationPolicy` on with
@@ -1552,6 +1587,7 @@ module Aws::StorageGateway
1552
1587
  # owner_id: 1,
1553
1588
  # },
1554
1589
  # gateway_arn: "GatewayARN", # required
1590
+ # encryption_type: "SseS3", # accepts SseS3, SseKms, DsseKms
1555
1591
  # kms_encrypted: false,
1556
1592
  # kms_key: "KMSKey",
1557
1593
  # role: "Role", # required
@@ -1624,17 +1660,48 @@ module Aws::StorageGateway
1624
1660
  # The ARN of the S3 File Gateway on which you want to create a file
1625
1661
  # share.
1626
1662
  #
1663
+ # @option params [String] :encryption_type
1664
+ # A value that specifies the type of server-side encryption that the
1665
+ # file share will use for the data that it stores in Amazon S3.
1666
+ #
1667
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1668
+ # the file share encryption method. You do not need to provide values
1669
+ # for both parameters.
1670
+ #
1671
+ # If values for both parameters exist in the same request, then the
1672
+ # specified encryption methods must not conflict. For example, if
1673
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1674
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
1675
+ # `true`.
1676
+ #
1677
+ # </note>
1678
+ #
1627
1679
  # @option params [Boolean] :kms_encrypted
1628
- # Set to `true` to use Amazon S3 server-side encryption with your own
1629
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
1680
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
1681
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by Amazon
1682
+ # S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
1683
+ # `EncryptionType` parameter instead.
1684
+ #
1685
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1686
+ # the file share encryption method. You do not need to provide values
1687
+ # for both parameters.
1688
+ #
1689
+ # If values for both parameters exist in the same request, then the
1690
+ # specified encryption methods must not conflict. For example, if
1691
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1692
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
1693
+ # `true`.
1694
+ #
1695
+ # </note>
1630
1696
  #
1631
1697
  # Valid Values: `true` \| `false`
1632
1698
  #
1633
1699
  # @option params [String] :kms_key
1634
- # The Amazon Resource Name (ARN) of a symmetric customer master key
1635
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1636
- # not support asymmetric CMKs. This value can only be set when
1637
- # `KMSEncrypted` is `true`. Optional.
1700
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
1701
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
1702
+ # Gateway does not support asymmetric CMKs. This value must be set if
1703
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
1704
+ # `DsseKms`.
1638
1705
  #
1639
1706
  # @option params [required, String] :role
1640
1707
  # The ARN of the Identity and Access Management (IAM) role that an S3
@@ -1716,14 +1783,14 @@ module Aws::StorageGateway
1716
1783
  # SMB file share. Set it to `false` to map file and directory
1717
1784
  # permissions to the POSIX permissions.
1718
1785
  #
1719
- # For more information, see [Using Microsoft Windows ACLs to control
1720
- # access to an SMB file share][1] in the *Storage Gateway User Guide*.
1786
+ # For more information, see [Using Windows ACLs to limit SMB file share
1787
+ # access][1] in the *Amazon S3 File Gateway User Guide*.
1721
1788
  #
1722
1789
  # Valid Values: `true` \| `false`
1723
1790
  #
1724
1791
  #
1725
1792
  #
1726
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
1793
+ # [1]: https://docs.aws.amazon.com/filegateway/latest/files3/smb-acl.html
1727
1794
  #
1728
1795
  # @option params [Boolean] :access_based_enumeration
1729
1796
  # The files and folders on this share will only be visible to users with
@@ -1801,6 +1868,10 @@ module Aws::StorageGateway
1801
1868
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1802
1869
  # uploading to Amazon S3, only the timing of the notification.
1803
1870
  #
1871
+ # This setting is not meant to specify an exact time at which the
1872
+ # notification will be sent. In some cases, the gateway might require
1873
+ # more than the specified delay time to generate and send notifications.
1874
+ #
1804
1875
  # </note>
1805
1876
  #
1806
1877
  # The following example sets `NotificationPolicy` on with
@@ -1853,6 +1924,7 @@ module Aws::StorageGateway
1853
1924
  # resp = client.create_smb_file_share({
1854
1925
  # client_token: "ClientToken", # required
1855
1926
  # gateway_arn: "GatewayARN", # required
1927
+ # encryption_type: "SseS3", # accepts SseS3, SseKms, DsseKms
1856
1928
  # kms_encrypted: false,
1857
1929
  # kms_key: "KMSKey",
1858
1930
  # role: "Role", # required
@@ -3701,6 +3773,7 @@ module Aws::StorageGateway
3701
3773
  # resp.nfs_file_share_info_list[0].file_share_id #=> String
3702
3774
  # resp.nfs_file_share_info_list[0].file_share_status #=> String
3703
3775
  # resp.nfs_file_share_info_list[0].gateway_arn #=> String
3776
+ # resp.nfs_file_share_info_list[0].encryption_type #=> String, one of "SseS3", "SseKms", "DsseKms"
3704
3777
  # resp.nfs_file_share_info_list[0].kms_encrypted #=> Boolean
3705
3778
  # resp.nfs_file_share_info_list[0].kms_key #=> String
3706
3779
  # resp.nfs_file_share_info_list[0].path #=> String
@@ -3758,6 +3831,7 @@ module Aws::StorageGateway
3758
3831
  # resp.smb_file_share_info_list[0].file_share_id #=> String
3759
3832
  # resp.smb_file_share_info_list[0].file_share_status #=> String
3760
3833
  # resp.smb_file_share_info_list[0].gateway_arn #=> String
3834
+ # resp.smb_file_share_info_list[0].encryption_type #=> String, one of "SseS3", "SseKms", "DsseKms"
3761
3835
  # resp.smb_file_share_info_list[0].kms_encrypted #=> Boolean
3762
3836
  # resp.smb_file_share_info_list[0].kms_key #=> String
3763
3837
  # resp.smb_file_share_info_list[0].path #=> String
@@ -6654,7 +6728,11 @@ module Aws::StorageGateway
6654
6728
  # `ALL_VERSIONS` - Enables regular gateway maintenance updates.
6655
6729
  #
6656
6730
  # `EMERGENCY_VERSIONS_ONLY` - Disables regular gateway maintenance
6657
- # updates.
6731
+ # updates. The gateway will still receive emergency version updates on
6732
+ # rare occasions if necessary to remedy highly critical security or
6733
+ # durability issues. You will be notified before an emergency version
6734
+ # update is applied. These updates are applied during your gateway's
6735
+ # scheduled maintenance window.
6658
6736
  #
6659
6737
  # @return [Types::UpdateMaintenanceStartTimeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6660
6738
  #
@@ -6727,17 +6805,48 @@ module Aws::StorageGateway
6727
6805
  # @option params [required, String] :file_share_arn
6728
6806
  # The Amazon Resource Name (ARN) of the file share to be updated.
6729
6807
  #
6808
+ # @option params [String] :encryption_type
6809
+ # A value that specifies the type of server-side encryption that the
6810
+ # file share will use for the data that it stores in Amazon S3.
6811
+ #
6812
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
6813
+ # the file share encryption method. You do not need to provide values
6814
+ # for both parameters.
6815
+ #
6816
+ # If values for both parameters exist in the same request, then the
6817
+ # specified encryption methods must not conflict. For example, if
6818
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
6819
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
6820
+ # `true`.
6821
+ #
6822
+ # </note>
6823
+ #
6730
6824
  # @option params [Boolean] :kms_encrypted
6731
- # Set to `true` to use Amazon S3 server-side encryption with your own
6732
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
6825
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
6826
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by Amazon
6827
+ # S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
6828
+ # `EncryptionType` parameter instead.
6829
+ #
6830
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
6831
+ # the file share encryption method. You do not need to provide values
6832
+ # for both parameters.
6833
+ #
6834
+ # If values for both parameters exist in the same request, then the
6835
+ # specified encryption methods must not conflict. For example, if
6836
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
6837
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
6838
+ # `true`.
6839
+ #
6840
+ # </note>
6733
6841
  #
6734
6842
  # Valid Values: `true` \| `false`
6735
6843
  #
6736
6844
  # @option params [String] :kms_key
6737
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6738
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
6739
- # not support asymmetric CMKs. This value can only be set when
6740
- # `KMSEncrypted` is `true`. Optional.
6845
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
6846
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
6847
+ # Gateway does not support asymmetric CMKs. This value must be set if
6848
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
6849
+ # `DsseKms`.
6741
6850
  #
6742
6851
  # @option params [Types::NFSFileShareDefaults] :nfs_file_share_defaults
6743
6852
  # The default values for the file share. Optional.
@@ -6820,6 +6929,10 @@ module Aws::StorageGateway
6820
6929
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
6821
6930
  # uploading to Amazon S3, only the timing of the notification.
6822
6931
  #
6932
+ # This setting is not meant to specify an exact time at which the
6933
+ # notification will be sent. In some cases, the gateway might require
6934
+ # more than the specified delay time to generate and send notifications.
6935
+ #
6823
6936
  # </note>
6824
6937
  #
6825
6938
  # The following example sets `NotificationPolicy` on with
@@ -6842,6 +6955,7 @@ module Aws::StorageGateway
6842
6955
  #
6843
6956
  # resp = client.update_nfs_file_share({
6844
6957
  # file_share_arn: "FileShareARN", # required
6958
+ # encryption_type: "SseS3", # accepts SseS3, SseKms, DsseKms
6845
6959
  # kms_encrypted: false,
6846
6960
  # kms_key: "KMSKey",
6847
6961
  # nfs_file_share_defaults: {
@@ -6908,17 +7022,48 @@ module Aws::StorageGateway
6908
7022
  # The Amazon Resource Name (ARN) of the SMB file share that you want to
6909
7023
  # update.
6910
7024
  #
7025
+ # @option params [String] :encryption_type
7026
+ # A value that specifies the type of server-side encryption that the
7027
+ # file share will use for the data that it stores in Amazon S3.
7028
+ #
7029
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
7030
+ # the file share encryption method. You do not need to provide values
7031
+ # for both parameters.
7032
+ #
7033
+ # If values for both parameters exist in the same request, then the
7034
+ # specified encryption methods must not conflict. For example, if
7035
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
7036
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
7037
+ # `true`.
7038
+ #
7039
+ # </note>
7040
+ #
6911
7041
  # @option params [Boolean] :kms_encrypted
6912
- # Set to `true` to use Amazon S3 server-side encryption with your own
6913
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
7042
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
7043
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by Amazon
7044
+ # S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
7045
+ # `EncryptionType` parameter instead.
7046
+ #
7047
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
7048
+ # the file share encryption method. You do not need to provide values
7049
+ # for both parameters.
7050
+ #
7051
+ # If values for both parameters exist in the same request, then the
7052
+ # specified encryption methods must not conflict. For example, if
7053
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
7054
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must be
7055
+ # `true`.
7056
+ #
7057
+ # </note>
6914
7058
  #
6915
7059
  # Valid Values: `true` \| `false`
6916
7060
  #
6917
7061
  # @option params [String] :kms_key
6918
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6919
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
6920
- # not support asymmetric CMKs. This value can only be set when
6921
- # `KMSEncrypted` is `true`. Optional.
7062
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
7063
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
7064
+ # Gateway does not support asymmetric CMKs. This value must be set if
7065
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
7066
+ # `DsseKms`.
6922
7067
  #
6923
7068
  # @option params [String] :default_storage_class
6924
7069
  # The default storage class for objects put into an Amazon S3 bucket by
@@ -6965,14 +7110,14 @@ module Aws::StorageGateway
6965
7110
  # SMB file share. Set it to `false` to map file and directory
6966
7111
  # permissions to the POSIX permissions.
6967
7112
  #
6968
- # For more information, see [Using Microsoft Windows ACLs to control
6969
- # access to an SMB file share][1] in the *Storage Gateway User Guide*.
7113
+ # For more information, see [Using Windows ACLs to limit SMB file share
7114
+ # access][1] in the *Amazon S3 File Gateway User Guide*.
6970
7115
  #
6971
7116
  # Valid Values: `true` \| `false`
6972
7117
  #
6973
7118
  #
6974
7119
  #
6975
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
7120
+ # [1]: https://docs.aws.amazon.com/filegateway/latest/files3/smb-acl.html
6976
7121
  #
6977
7122
  # @option params [Boolean] :access_based_enumeration
6978
7123
  # The files and folders on this share will only be visible to users with
@@ -7031,6 +7176,10 @@ module Aws::StorageGateway
7031
7176
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
7032
7177
  # uploading to Amazon S3, only the timing of the notification.
7033
7178
  #
7179
+ # This setting is not meant to specify an exact time at which the
7180
+ # notification will be sent. In some cases, the gateway might require
7181
+ # more than the specified delay time to generate and send notifications.
7182
+ #
7034
7183
  # </note>
7035
7184
  #
7036
7185
  # The following example sets `NotificationPolicy` on with
@@ -7062,6 +7211,7 @@ module Aws::StorageGateway
7062
7211
  #
7063
7212
  # resp = client.update_smb_file_share({
7064
7213
  # file_share_arn: "FileShareARN", # required
7214
+ # encryption_type: "SseS3", # accepts SseS3, SseKms, DsseKms
7065
7215
  # kms_encrypted: false,
7066
7216
  # kms_key: "KMSKey",
7067
7217
  # default_storage_class: "StorageClass",
@@ -7403,7 +7553,7 @@ module Aws::StorageGateway
7403
7553
  tracer: tracer
7404
7554
  )
7405
7555
  context[:gem_name] = 'aws-sdk-storagegateway'
7406
- context[:gem_version] = '1.94.0'
7556
+ context[:gem_version] = '1.95.0'
7407
7557
  Seahorse::Client::Request.new(handlers, context)
7408
7558
  end
7409
7559
 
@@ -165,6 +165,7 @@ module Aws::StorageGateway
165
165
  DoubleObject = Shapes::FloatShape.new(name: 'DoubleObject')
166
166
  Ec2InstanceId = Shapes::StringShape.new(name: 'Ec2InstanceId')
167
167
  Ec2InstanceRegion = Shapes::StringShape.new(name: 'Ec2InstanceRegion')
168
+ EncryptionType = Shapes::StringShape.new(name: 'EncryptionType')
168
169
  EndpointNetworkConfiguration = Shapes::StructureShape.new(name: 'EndpointNetworkConfiguration')
169
170
  EndpointType = Shapes::StringShape.new(name: 'EndpointType')
170
171
  ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
@@ -561,7 +562,8 @@ module Aws::StorageGateway
561
562
  CreateNFSFileShareInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "ClientToken"))
562
563
  CreateNFSFileShareInput.add_member(:nfs_file_share_defaults, Shapes::ShapeRef.new(shape: NFSFileShareDefaults, location_name: "NFSFileShareDefaults"))
563
564
  CreateNFSFileShareInput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, required: true, location_name: "GatewayARN"))
564
- CreateNFSFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, location_name: "KMSEncrypted"))
565
+ CreateNFSFileShareInput.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
566
+ CreateNFSFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
565
567
  CreateNFSFileShareInput.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
566
568
  CreateNFSFileShareInput.add_member(:role, Shapes::ShapeRef.new(shape: Role, required: true, location_name: "Role"))
567
569
  CreateNFSFileShareInput.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationARN, required: true, location_name: "LocationARN"))
@@ -586,7 +588,8 @@ module Aws::StorageGateway
586
588
 
587
589
  CreateSMBFileShareInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "ClientToken"))
588
590
  CreateSMBFileShareInput.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, required: true, location_name: "GatewayARN"))
589
- CreateSMBFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, location_name: "KMSEncrypted"))
591
+ CreateSMBFileShareInput.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
592
+ CreateSMBFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
590
593
  CreateSMBFileShareInput.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
591
594
  CreateSMBFileShareInput.add_member(:role, Shapes::ShapeRef.new(shape: Role, required: true, location_name: "Role"))
592
595
  CreateSMBFileShareInput.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationARN, required: true, location_name: "LocationARN"))
@@ -1183,7 +1186,8 @@ module Aws::StorageGateway
1183
1186
  NFSFileShareInfo.add_member(:file_share_id, Shapes::ShapeRef.new(shape: FileShareId, location_name: "FileShareId"))
1184
1187
  NFSFileShareInfo.add_member(:file_share_status, Shapes::ShapeRef.new(shape: FileShareStatus, location_name: "FileShareStatus"))
1185
1188
  NFSFileShareInfo.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, location_name: "GatewayARN"))
1186
- NFSFileShareInfo.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: boolean, location_name: "KMSEncrypted"))
1189
+ NFSFileShareInfo.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
1190
+ NFSFileShareInfo.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
1187
1191
  NFSFileShareInfo.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
1188
1192
  NFSFileShareInfo.add_member(:path, Shapes::ShapeRef.new(shape: Path, location_name: "Path"))
1189
1193
  NFSFileShareInfo.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
@@ -1270,7 +1274,8 @@ module Aws::StorageGateway
1270
1274
  SMBFileShareInfo.add_member(:file_share_id, Shapes::ShapeRef.new(shape: FileShareId, location_name: "FileShareId"))
1271
1275
  SMBFileShareInfo.add_member(:file_share_status, Shapes::ShapeRef.new(shape: FileShareStatus, location_name: "FileShareStatus"))
1272
1276
  SMBFileShareInfo.add_member(:gateway_arn, Shapes::ShapeRef.new(shape: GatewayARN, location_name: "GatewayARN"))
1273
- SMBFileShareInfo.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: boolean, location_name: "KMSEncrypted"))
1277
+ SMBFileShareInfo.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
1278
+ SMBFileShareInfo.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
1274
1279
  SMBFileShareInfo.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
1275
1280
  SMBFileShareInfo.add_member(:path, Shapes::ShapeRef.new(shape: Path, location_name: "Path"))
1276
1281
  SMBFileShareInfo.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
@@ -1501,7 +1506,8 @@ module Aws::StorageGateway
1501
1506
  UpdateMaintenanceStartTimeOutput.struct_class = Types::UpdateMaintenanceStartTimeOutput
1502
1507
 
1503
1508
  UpdateNFSFileShareInput.add_member(:file_share_arn, Shapes::ShapeRef.new(shape: FileShareARN, required: true, location_name: "FileShareARN"))
1504
- UpdateNFSFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, location_name: "KMSEncrypted"))
1509
+ UpdateNFSFileShareInput.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
1510
+ UpdateNFSFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
1505
1511
  UpdateNFSFileShareInput.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
1506
1512
  UpdateNFSFileShareInput.add_member(:nfs_file_share_defaults, Shapes::ShapeRef.new(shape: NFSFileShareDefaults, location_name: "NFSFileShareDefaults"))
1507
1513
  UpdateNFSFileShareInput.add_member(:default_storage_class, Shapes::ShapeRef.new(shape: StorageClass, location_name: "DefaultStorageClass"))
@@ -1521,7 +1527,8 @@ module Aws::StorageGateway
1521
1527
  UpdateNFSFileShareOutput.struct_class = Types::UpdateNFSFileShareOutput
1522
1528
 
1523
1529
  UpdateSMBFileShareInput.add_member(:file_share_arn, Shapes::ShapeRef.new(shape: FileShareARN, required: true, location_name: "FileShareARN"))
1524
- UpdateSMBFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, location_name: "KMSEncrypted"))
1530
+ UpdateSMBFileShareInput.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
1531
+ UpdateSMBFileShareInput.add_member(:kms_encrypted, Shapes::ShapeRef.new(shape: Boolean, deprecated: true, location_name: "KMSEncrypted", metadata: {"deprecatedMessage"=>"KMSEncrypted is deprecated, use EncryptionType instead."}))
1525
1532
  UpdateSMBFileShareInput.add_member(:kms_key, Shapes::ShapeRef.new(shape: KMSKey, location_name: "KMSKey"))
1526
1533
  UpdateSMBFileShareInput.add_member(:default_storage_class, Shapes::ShapeRef.new(shape: StorageClass, location_name: "DefaultStorageClass"))
1527
1534
  UpdateSMBFileShareInput.add_member(:object_acl, Shapes::ShapeRef.new(shape: ObjectACL, location_name: "ObjectACL"))
@@ -762,10 +762,11 @@ module Aws::StorageGateway
762
762
  # @return [Integer]
763
763
  #
764
764
  # @!attribute [rw] kms_key
765
- # The Amazon Resource Name (ARN) of a symmetric customer master key
766
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
767
- # does not support asymmetric CMKs. This value can only be set when
768
- # `KMSEncrypted` is `true`. Optional.
765
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
766
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
767
+ # Gateway does not support asymmetric CMKs. This value must be set if
768
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
769
+ # `DsseKms`.
769
770
  # @return [String]
770
771
  #
771
772
  # @!attribute [rw] target_name
@@ -1044,18 +1045,50 @@ module Aws::StorageGateway
1044
1045
  # want to create a file share.
1045
1046
  # @return [String]
1046
1047
  #
1048
+ # @!attribute [rw] encryption_type
1049
+ # A value that specifies the type of server-side encryption that the
1050
+ # file share will use for the data that it stores in Amazon S3.
1051
+ #
1052
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1053
+ # the file share encryption method. You do not need to provide values
1054
+ # for both parameters.
1055
+ #
1056
+ # If values for both parameters exist in the same request, then the
1057
+ # specified encryption methods must not conflict. For example, if
1058
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1059
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
1060
+ # be `true`.
1061
+ #
1062
+ # </note>
1063
+ # @return [String]
1064
+ #
1047
1065
  # @!attribute [rw] kms_encrypted
1048
- # Set to `true` to use Amazon S3 server-side encryption with your own
1049
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
1066
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
1067
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
1068
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
1069
+ # `EncryptionType` parameter instead.
1070
+ #
1071
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1072
+ # the file share encryption method. You do not need to provide values
1073
+ # for both parameters.
1074
+ #
1075
+ # If values for both parameters exist in the same request, then the
1076
+ # specified encryption methods must not conflict. For example, if
1077
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1078
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
1079
+ # be `true`.
1080
+ #
1081
+ # </note>
1050
1082
  #
1051
1083
  # Valid Values: `true` \| `false`
1052
1084
  # @return [Boolean]
1053
1085
  #
1054
1086
  # @!attribute [rw] kms_key
1055
- # The Amazon Resource Name (ARN) of a symmetric customer master key
1056
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
1057
- # does not support asymmetric CMKs. This value can only be set when
1058
- # `KMSEncrypted` is `true`. Optional.
1087
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
1088
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
1089
+ # Gateway does not support asymmetric CMKs. This value must be set if
1090
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
1091
+ # `DsseKms`.
1059
1092
  # @return [String]
1060
1093
  #
1061
1094
  # @!attribute [rw] role
@@ -1198,6 +1231,11 @@ module Aws::StorageGateway
1198
1231
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1199
1232
  # uploading to Amazon S3, only the timing of the notification.
1200
1233
  #
1234
+ # This setting is not meant to specify an exact time at which the
1235
+ # notification will be sent. In some cases, the gateway might require
1236
+ # more than the specified delay time to generate and send
1237
+ # notifications.
1238
+ #
1201
1239
  # </note>
1202
1240
  #
1203
1241
  # The following example sets `NotificationPolicy` on with
@@ -1242,6 +1280,7 @@ module Aws::StorageGateway
1242
1280
  :client_token,
1243
1281
  :nfs_file_share_defaults,
1244
1282
  :gateway_arn,
1283
+ :encryption_type,
1245
1284
  :kms_encrypted,
1246
1285
  :kms_key,
1247
1286
  :role,
@@ -1290,18 +1329,50 @@ module Aws::StorageGateway
1290
1329
  # share.
1291
1330
  # @return [String]
1292
1331
  #
1332
+ # @!attribute [rw] encryption_type
1333
+ # A value that specifies the type of server-side encryption that the
1334
+ # file share will use for the data that it stores in Amazon S3.
1335
+ #
1336
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1337
+ # the file share encryption method. You do not need to provide values
1338
+ # for both parameters.
1339
+ #
1340
+ # If values for both parameters exist in the same request, then the
1341
+ # specified encryption methods must not conflict. For example, if
1342
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1343
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
1344
+ # be `true`.
1345
+ #
1346
+ # </note>
1347
+ # @return [String]
1348
+ #
1293
1349
  # @!attribute [rw] kms_encrypted
1294
- # Set to `true` to use Amazon S3 server-side encryption with your own
1295
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
1350
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
1351
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
1352
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
1353
+ # `EncryptionType` parameter instead.
1354
+ #
1355
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
1356
+ # the file share encryption method. You do not need to provide values
1357
+ # for both parameters.
1358
+ #
1359
+ # If values for both parameters exist in the same request, then the
1360
+ # specified encryption methods must not conflict. For example, if
1361
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
1362
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
1363
+ # be `true`.
1364
+ #
1365
+ # </note>
1296
1366
  #
1297
1367
  # Valid Values: `true` \| `false`
1298
1368
  # @return [Boolean]
1299
1369
  #
1300
1370
  # @!attribute [rw] kms_key
1301
- # The Amazon Resource Name (ARN) of a symmetric customer master key
1302
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
1303
- # does not support asymmetric CMKs. This value can only be set when
1304
- # `KMSEncrypted` is `true`. Optional.
1371
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
1372
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
1373
+ # Gateway does not support asymmetric CMKs. This value must be set if
1374
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
1375
+ # `DsseKms`.
1305
1376
  # @return [String]
1306
1377
  #
1307
1378
  # @!attribute [rw] role
@@ -1394,14 +1465,14 @@ module Aws::StorageGateway
1394
1465
  # SMB file share. Set it to `false` to map file and directory
1395
1466
  # permissions to the POSIX permissions.
1396
1467
  #
1397
- # For more information, see [Using Microsoft Windows ACLs to control
1398
- # access to an SMB file share][1] in the *Storage Gateway User Guide*.
1468
+ # For more information, see [Using Windows ACLs to limit SMB file
1469
+ # share access][1] in the *Amazon S3 File Gateway User Guide*.
1399
1470
  #
1400
1471
  # Valid Values: `true` \| `false`
1401
1472
  #
1402
1473
  #
1403
1474
  #
1404
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
1475
+ # [1]: https://docs.aws.amazon.com/filegateway/latest/files3/smb-acl.html
1405
1476
  # @return [Boolean]
1406
1477
  #
1407
1478
  # @!attribute [rw] access_based_enumeration
@@ -1491,6 +1562,11 @@ module Aws::StorageGateway
1491
1562
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
1492
1563
  # uploading to Amazon S3, only the timing of the notification.
1493
1564
  #
1565
+ # This setting is not meant to specify an exact time at which the
1566
+ # notification will be sent. In some cases, the gateway might require
1567
+ # more than the specified delay time to generate and send
1568
+ # notifications.
1569
+ #
1494
1570
  # </note>
1495
1571
  #
1496
1572
  # The following example sets `NotificationPolicy` on with
@@ -1543,6 +1619,7 @@ module Aws::StorageGateway
1543
1619
  class CreateSMBFileShareInput < Struct.new(
1544
1620
  :client_token,
1545
1621
  :gateway_arn,
1622
+ :encryption_type,
1546
1623
  :kms_encrypted,
1547
1624
  :kms_key,
1548
1625
  :role,
@@ -2997,12 +3074,17 @@ module Aws::StorageGateway
2997
3074
  # A set of variables indicating the software update preferences for
2998
3075
  # the gateway.
2999
3076
  #
3000
- # Includes `AutomaticUpdatePolicy` field with the following inputs:
3077
+ # Includes `AutomaticUpdatePolicy` parameter with the following
3078
+ # inputs:
3001
3079
  #
3002
3080
  # `ALL_VERSIONS` - Enables regular gateway maintenance updates.
3003
3081
  #
3004
3082
  # `EMERGENCY_VERSIONS_ONLY` - Disables regular gateway maintenance
3005
- # updates.
3083
+ # updates. The gateway will still receive emergency version updates on
3084
+ # rare occasions if necessary to remedy highly critical security or
3085
+ # durability issues. You will be notified before an emergency version
3086
+ # update is applied. These updates are applied during your gateway's
3087
+ # scheduled maintenance window.
3006
3088
  # @return [Types::SoftwareUpdatePreferences]
3007
3089
  #
3008
3090
  # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeMaintenanceStartTimeOutput AWS API Documentation
@@ -4857,18 +4939,50 @@ module Aws::StorageGateway
4857
4939
  # Web Services Region.
4858
4940
  # @return [String]
4859
4941
  #
4942
+ # @!attribute [rw] encryption_type
4943
+ # A value that specifies the type of server-side encryption that the
4944
+ # file share will use for the data that it stores in Amazon S3.
4945
+ #
4946
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
4947
+ # the file share encryption method. You do not need to provide values
4948
+ # for both parameters.
4949
+ #
4950
+ # If values for both parameters exist in the same request, then the
4951
+ # specified encryption methods must not conflict. For example, if
4952
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
4953
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
4954
+ # be `true`.
4955
+ #
4956
+ # </note>
4957
+ # @return [String]
4958
+ #
4860
4959
  # @!attribute [rw] kms_encrypted
4861
- # Set to `true` to use Amazon S3 server-side encryption with your own
4862
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
4960
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
4961
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
4962
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
4963
+ # `EncryptionType` parameter instead.
4964
+ #
4965
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
4966
+ # the file share encryption method. You do not need to provide values
4967
+ # for both parameters.
4968
+ #
4969
+ # If values for both parameters exist in the same request, then the
4970
+ # specified encryption methods must not conflict. For example, if
4971
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
4972
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
4973
+ # be `true`.
4974
+ #
4975
+ # </note>
4863
4976
  #
4864
4977
  # Valid Values: `true` \| `false`
4865
4978
  # @return [Boolean]
4866
4979
  #
4867
4980
  # @!attribute [rw] kms_key
4868
- # The Amazon Resource Name (ARN) of a symmetric customer master key
4869
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
4870
- # does not support asymmetric CMKs. This value can only be set when
4871
- # `KMSEncrypted` is `true`. Optional.
4981
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
4982
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
4983
+ # Gateway does not support asymmetric CMKs. This value must be set if
4984
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
4985
+ # `DsseKms`.
4872
4986
  # @return [String]
4873
4987
  #
4874
4988
  # @!attribute [rw] path
@@ -5009,6 +5123,11 @@ module Aws::StorageGateway
5009
5123
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
5010
5124
  # uploading to Amazon S3, only the timing of the notification.
5011
5125
  #
5126
+ # This setting is not meant to specify an exact time at which the
5127
+ # notification will be sent. In some cases, the gateway might require
5128
+ # more than the specified delay time to generate and send
5129
+ # notifications.
5130
+ #
5012
5131
  # </note>
5013
5132
  #
5014
5133
  # The following example sets `NotificationPolicy` on with
@@ -5055,6 +5174,7 @@ module Aws::StorageGateway
5055
5174
  :file_share_id,
5056
5175
  :file_share_status,
5057
5176
  :gateway_arn,
5177
+ :encryption_type,
5058
5178
  :kms_encrypted,
5059
5179
  :kms_key,
5060
5180
  :path,
@@ -5413,18 +5533,50 @@ module Aws::StorageGateway
5413
5533
  # Web Services Region.
5414
5534
  # @return [String]
5415
5535
  #
5536
+ # @!attribute [rw] encryption_type
5537
+ # A value that specifies the type of server-side encryption that the
5538
+ # file share will use for the data that it stores in Amazon S3.
5539
+ #
5540
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
5541
+ # the file share encryption method. You do not need to provide values
5542
+ # for both parameters.
5543
+ #
5544
+ # If values for both parameters exist in the same request, then the
5545
+ # specified encryption methods must not conflict. For example, if
5546
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
5547
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
5548
+ # be `true`.
5549
+ #
5550
+ # </note>
5551
+ # @return [String]
5552
+ #
5416
5553
  # @!attribute [rw] kms_encrypted
5417
- # Set to `true` to use Amazon S3 server-side encryption with your own
5418
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
5554
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
5555
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
5556
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
5557
+ # `EncryptionType` parameter instead.
5558
+ #
5559
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
5560
+ # the file share encryption method. You do not need to provide values
5561
+ # for both parameters.
5562
+ #
5563
+ # If values for both parameters exist in the same request, then the
5564
+ # specified encryption methods must not conflict. For example, if
5565
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
5566
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
5567
+ # be `true`.
5568
+ #
5569
+ # </note>
5419
5570
  #
5420
5571
  # Valid Values: `true` \| `false`
5421
5572
  # @return [Boolean]
5422
5573
  #
5423
5574
  # @!attribute [rw] kms_key
5424
- # The Amazon Resource Name (ARN) of a symmetric customer master key
5425
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
5426
- # does not support asymmetric CMKs. This value can only be set when
5427
- # `KMSEncrypted` is `true`. Optional.
5575
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
5576
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
5577
+ # Gateway does not support asymmetric CMKs. This value must be set if
5578
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
5579
+ # `DsseKms`.
5428
5580
  # @return [String]
5429
5581
  #
5430
5582
  # @!attribute [rw] path
@@ -5523,12 +5675,12 @@ module Aws::StorageGateway
5523
5675
  # `false`, it indicates that file and directory permissions are mapped
5524
5676
  # to the POSIX permission.
5525
5677
  #
5526
- # For more information, see [Using Microsoft Windows ACLs to control
5527
- # access to an SMB file share][1] in the *Storage Gateway User Guide*.
5678
+ # For more information, see [Using Windows ACLs to limit SMB file
5679
+ # share access][1] in the *Amazon S3 File Gateway User Guide*.
5528
5680
  #
5529
5681
  #
5530
5682
  #
5531
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
5683
+ # [1]: https://docs.aws.amazon.com/filegateway/latest/files3/smb-acl.html
5532
5684
  # @return [Boolean]
5533
5685
  #
5534
5686
  # @!attribute [rw] access_based_enumeration
@@ -5609,6 +5761,11 @@ module Aws::StorageGateway
5609
5761
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
5610
5762
  # uploading to Amazon S3, only the timing of the notification.
5611
5763
  #
5764
+ # This setting is not meant to specify an exact time at which the
5765
+ # notification will be sent. In some cases, the gateway might require
5766
+ # more than the specified delay time to generate and send
5767
+ # notifications.
5768
+ #
5612
5769
  # </note>
5613
5770
  #
5614
5771
  # The following example sets `NotificationPolicy` on with
@@ -5663,6 +5820,7 @@ module Aws::StorageGateway
5663
5820
  :file_share_id,
5664
5821
  :file_share_status,
5665
5822
  :gateway_arn,
5823
+ :encryption_type,
5666
5824
  :kms_encrypted,
5667
5825
  :kms_key,
5668
5826
  :path,
@@ -5845,7 +6003,11 @@ module Aws::StorageGateway
5845
6003
  # `ALL_VERSIONS` - Enables regular gateway maintenance updates.
5846
6004
  #
5847
6005
  # `EMERGENCY_VERSIONS_ONLY` - Disables regular gateway maintenance
5848
- # updates.
6006
+ # updates. The gateway will still receive emergency version updates on
6007
+ # rare occasions if necessary to remedy highly critical security or
6008
+ # durability issues. You will be notified before an emergency version
6009
+ # update is applied. These updates are applied during your gateway's
6010
+ # scheduled maintenance window.
5849
6011
  # @return [String]
5850
6012
  #
5851
6013
  # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SoftwareUpdatePreferences AWS API Documentation
@@ -6026,10 +6188,11 @@ module Aws::StorageGateway
6026
6188
  # @return [Integer]
6027
6189
  #
6028
6190
  # @!attribute [rw] kms_key
6029
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6030
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
6031
- # does not support asymmetric CMKs. This value can only be set when
6032
- # `KMSEncrypted` is `true`. Optional.
6191
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
6192
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
6193
+ # Gateway does not support asymmetric CMKs. This value must be set if
6194
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
6195
+ # `DsseKms`.
6033
6196
  # @return [String]
6034
6197
  #
6035
6198
  # @!attribute [rw] target_name
@@ -6129,10 +6292,11 @@ module Aws::StorageGateway
6129
6292
  # @return [Integer]
6130
6293
  #
6131
6294
  # @!attribute [rw] kms_key
6132
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6133
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
6134
- # does not support asymmetric CMKs. This value can only be set when
6135
- # `KMSEncrypted` is `true`. Optional.
6295
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
6296
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
6297
+ # Gateway does not support asymmetric CMKs. This value must be set if
6298
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
6299
+ # `DsseKms`.
6136
6300
  # @return [String]
6137
6301
  #
6138
6302
  # @!attribute [rw] pool_id
@@ -6224,10 +6388,11 @@ module Aws::StorageGateway
6224
6388
  # @return [Integer]
6225
6389
  #
6226
6390
  # @!attribute [rw] kms_key
6227
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6228
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
6229
- # does not support asymmetric CMKs. This value can only be set when
6230
- # `KMSEncrypted` is `true`. Optional.
6391
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
6392
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
6393
+ # Gateway does not support asymmetric CMKs. This value must be set if
6394
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
6395
+ # `DsseKms`.
6231
6396
  # @return [String]
6232
6397
  #
6233
6398
  # @!attribute [rw] pool_id
@@ -6759,7 +6924,11 @@ module Aws::StorageGateway
6759
6924
  # `ALL_VERSIONS` - Enables regular gateway maintenance updates.
6760
6925
  #
6761
6926
  # `EMERGENCY_VERSIONS_ONLY` - Disables regular gateway maintenance
6762
- # updates.
6927
+ # updates. The gateway will still receive emergency version updates on
6928
+ # rare occasions if necessary to remedy highly critical security or
6929
+ # durability issues. You will be notified before an emergency version
6930
+ # update is applied. These updates are applied during your gateway's
6931
+ # scheduled maintenance window.
6763
6932
  # @return [Types::SoftwareUpdatePreferences]
6764
6933
  #
6765
6934
  # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateMaintenanceStartTimeInput AWS API Documentation
@@ -6798,18 +6967,50 @@ module Aws::StorageGateway
6798
6967
  # The Amazon Resource Name (ARN) of the file share to be updated.
6799
6968
  # @return [String]
6800
6969
  #
6970
+ # @!attribute [rw] encryption_type
6971
+ # A value that specifies the type of server-side encryption that the
6972
+ # file share will use for the data that it stores in Amazon S3.
6973
+ #
6974
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
6975
+ # the file share encryption method. You do not need to provide values
6976
+ # for both parameters.
6977
+ #
6978
+ # If values for both parameters exist in the same request, then the
6979
+ # specified encryption methods must not conflict. For example, if
6980
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
6981
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
6982
+ # be `true`.
6983
+ #
6984
+ # </note>
6985
+ # @return [String]
6986
+ #
6801
6987
  # @!attribute [rw] kms_encrypted
6802
- # Set to `true` to use Amazon S3 server-side encryption with your own
6803
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
6988
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
6989
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
6990
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
6991
+ # `EncryptionType` parameter instead.
6992
+ #
6993
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
6994
+ # the file share encryption method. You do not need to provide values
6995
+ # for both parameters.
6996
+ #
6997
+ # If values for both parameters exist in the same request, then the
6998
+ # specified encryption methods must not conflict. For example, if
6999
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
7000
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
7001
+ # be `true`.
7002
+ #
7003
+ # </note>
6804
7004
  #
6805
7005
  # Valid Values: `true` \| `false`
6806
7006
  # @return [Boolean]
6807
7007
  #
6808
7008
  # @!attribute [rw] kms_key
6809
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6810
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
6811
- # does not support asymmetric CMKs. This value can only be set when
6812
- # `KMSEncrypted` is `true`. Optional.
7009
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
7010
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
7011
+ # Gateway does not support asymmetric CMKs. This value must be set if
7012
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
7013
+ # `DsseKms`.
6813
7014
  # @return [String]
6814
7015
  #
6815
7016
  # @!attribute [rw] nfs_file_share_defaults
@@ -6907,6 +7108,11 @@ module Aws::StorageGateway
6907
7108
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
6908
7109
  # uploading to Amazon S3, only the timing of the notification.
6909
7110
  #
7111
+ # This setting is not meant to specify an exact time at which the
7112
+ # notification will be sent. In some cases, the gateway might require
7113
+ # more than the specified delay time to generate and send
7114
+ # notifications.
7115
+ #
6910
7116
  # </note>
6911
7117
  #
6912
7118
  # The following example sets `NotificationPolicy` on with
@@ -6927,6 +7133,7 @@ module Aws::StorageGateway
6927
7133
  #
6928
7134
  class UpdateNFSFileShareInput < Struct.new(
6929
7135
  :file_share_arn,
7136
+ :encryption_type,
6930
7137
  :kms_encrypted,
6931
7138
  :kms_key,
6932
7139
  :nfs_file_share_defaults,
@@ -6966,18 +7173,50 @@ module Aws::StorageGateway
6966
7173
  # to update.
6967
7174
  # @return [String]
6968
7175
  #
7176
+ # @!attribute [rw] encryption_type
7177
+ # A value that specifies the type of server-side encryption that the
7178
+ # file share will use for the data that it stores in Amazon S3.
7179
+ #
7180
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
7181
+ # the file share encryption method. You do not need to provide values
7182
+ # for both parameters.
7183
+ #
7184
+ # If values for both parameters exist in the same request, then the
7185
+ # specified encryption methods must not conflict. For example, if
7186
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
7187
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
7188
+ # be `true`.
7189
+ #
7190
+ # </note>
7191
+ # @return [String]
7192
+ #
6969
7193
  # @!attribute [rw] kms_encrypted
6970
- # Set to `true` to use Amazon S3 server-side encryption with your own
6971
- # KMS key, or `false` to use a key managed by Amazon S3. Optional.
7194
+ # Optional. Set to `true` to use Amazon S3 server-side encryption with
7195
+ # your own KMS key (SSE-KMS), or `false` to use a key managed by
7196
+ # Amazon S3 (SSE-S3). To use dual-layer encryption (DSSE-KMS), set the
7197
+ # `EncryptionType` parameter instead.
7198
+ #
7199
+ # <note markdown="1"> We recommend using `EncryptionType` instead of `KMSEncrypted` to set
7200
+ # the file share encryption method. You do not need to provide values
7201
+ # for both parameters.
7202
+ #
7203
+ # If values for both parameters exist in the same request, then the
7204
+ # specified encryption methods must not conflict. For example, if
7205
+ # `EncryptionType` is `SseS3`, then `KMSEncrypted` must be `false`. If
7206
+ # `EncryptionType` is `SseKms` or `DsseKms`, then `KMSEncrypted` must
7207
+ # be `true`.
7208
+ #
7209
+ # </note>
6972
7210
  #
6973
7211
  # Valid Values: `true` \| `false`
6974
7212
  # @return [Boolean]
6975
7213
  #
6976
7214
  # @!attribute [rw] kms_key
6977
- # The Amazon Resource Name (ARN) of a symmetric customer master key
6978
- # (CMK) used for Amazon S3 server-side encryption. Storage Gateway
6979
- # does not support asymmetric CMKs. This value can only be set when
6980
- # `KMSEncrypted` is `true`. Optional.
7215
+ # Optional. The Amazon Resource Name (ARN) of a symmetric customer
7216
+ # master key (CMK) used for Amazon S3 server-side encryption. Storage
7217
+ # Gateway does not support asymmetric CMKs. This value must be set if
7218
+ # `KMSEncrypted` is `true`, or if `EncryptionType` is `SseKms` or
7219
+ # `DsseKms`.
6981
7220
  # @return [String]
6982
7221
  #
6983
7222
  # @!attribute [rw] default_storage_class
@@ -7033,14 +7272,14 @@ module Aws::StorageGateway
7033
7272
  # SMB file share. Set it to `false` to map file and directory
7034
7273
  # permissions to the POSIX permissions.
7035
7274
  #
7036
- # For more information, see [Using Microsoft Windows ACLs to control
7037
- # access to an SMB file share][1] in the *Storage Gateway User Guide*.
7275
+ # For more information, see [Using Windows ACLs to limit SMB file
7276
+ # share access][1] in the *Amazon S3 File Gateway User Guide*.
7038
7277
  #
7039
7278
  # Valid Values: `true` \| `false`
7040
7279
  #
7041
7280
  #
7042
7281
  #
7043
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
7282
+ # [1]: https://docs.aws.amazon.com/filegateway/latest/files3/smb-acl.html
7044
7283
  # @return [Boolean]
7045
7284
  #
7046
7285
  # @!attribute [rw] access_based_enumeration
@@ -7108,6 +7347,11 @@ module Aws::StorageGateway
7108
7347
  # <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object
7109
7348
  # uploading to Amazon S3, only the timing of the notification.
7110
7349
  #
7350
+ # This setting is not meant to specify an exact time at which the
7351
+ # notification will be sent. In some cases, the gateway might require
7352
+ # more than the specified delay time to generate and send
7353
+ # notifications.
7354
+ #
7111
7355
  # </note>
7112
7356
  #
7113
7357
  # The following example sets `NotificationPolicy` on with
@@ -7137,6 +7381,7 @@ module Aws::StorageGateway
7137
7381
  #
7138
7382
  class UpdateSMBFileShareInput < Struct.new(
7139
7383
  :file_share_arn,
7384
+ :encryption_type,
7140
7385
  :kms_encrypted,
7141
7386
  :kms_key,
7142
7387
  :default_storage_class,
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-storagegateway/customizations'
52
52
  # @!group service
53
53
  module Aws::StorageGateway
54
54
 
55
- GEM_VERSION = '1.94.0'
55
+ GEM_VERSION = '1.95.0'
56
56
 
57
57
  end
data/sig/client.rbs CHANGED
@@ -261,6 +261,7 @@ module Aws
261
261
  owner_id: ::Integer?
262
262
  },
263
263
  gateway_arn: ::String,
264
+ ?encryption_type: ("SseS3" | "SseKms" | "DsseKms"),
264
265
  ?kms_encrypted: bool,
265
266
  ?kms_key: ::String,
266
267
  role: ::String,
@@ -297,6 +298,7 @@ module Aws
297
298
  def create_smb_file_share: (
298
299
  client_token: ::String,
299
300
  gateway_arn: ::String,
301
+ ?encryption_type: ("SseS3" | "SseKms" | "DsseKms"),
300
302
  ?kms_encrypted: bool,
301
303
  ?kms_key: ::String,
302
304
  role: ::String,
@@ -1271,6 +1273,7 @@ module Aws
1271
1273
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#update_nfs_file_share-instance_method
1272
1274
  def update_nfs_file_share: (
1273
1275
  file_share_arn: ::String,
1276
+ ?encryption_type: ("SseS3" | "SseKms" | "DsseKms"),
1274
1277
  ?kms_encrypted: bool,
1275
1278
  ?kms_key: ::String,
1276
1279
  ?nfs_file_share_defaults: {
@@ -1302,6 +1305,7 @@ module Aws
1302
1305
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/StorageGateway/Client.html#update_smb_file_share-instance_method
1303
1306
  def update_smb_file_share: (
1304
1307
  file_share_arn: ::String,
1308
+ ?encryption_type: ("SseS3" | "SseKms" | "DsseKms"),
1305
1309
  ?kms_encrypted: bool,
1306
1310
  ?kms_key: ::String,
1307
1311
  ?default_storage_class: ::String,
data/sig/types.rbs CHANGED
@@ -216,6 +216,7 @@ module Aws::StorageGateway
216
216
  attr_accessor client_token: ::String
217
217
  attr_accessor nfs_file_share_defaults: Types::NFSFileShareDefaults
218
218
  attr_accessor gateway_arn: ::String
219
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
219
220
  attr_accessor kms_encrypted: bool
220
221
  attr_accessor kms_key: ::String
221
222
  attr_accessor role: ::String
@@ -245,6 +246,7 @@ module Aws::StorageGateway
245
246
  class CreateSMBFileShareInput
246
247
  attr_accessor client_token: ::String
247
248
  attr_accessor gateway_arn: ::String
249
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
248
250
  attr_accessor kms_encrypted: bool
249
251
  attr_accessor kms_key: ::String
250
252
  attr_accessor role: ::String
@@ -1038,6 +1040,7 @@ module Aws::StorageGateway
1038
1040
  attr_accessor file_share_id: ::String
1039
1041
  attr_accessor file_share_status: ::String
1040
1042
  attr_accessor gateway_arn: ::String
1043
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
1041
1044
  attr_accessor kms_encrypted: bool
1042
1045
  attr_accessor kms_key: ::String
1043
1046
  attr_accessor path: ::String
@@ -1149,6 +1152,7 @@ module Aws::StorageGateway
1149
1152
  attr_accessor file_share_id: ::String
1150
1153
  attr_accessor file_share_status: ::String
1151
1154
  attr_accessor gateway_arn: ::String
1155
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
1152
1156
  attr_accessor kms_encrypted: bool
1153
1157
  attr_accessor kms_key: ::String
1154
1158
  attr_accessor path: ::String
@@ -1434,6 +1438,7 @@ module Aws::StorageGateway
1434
1438
 
1435
1439
  class UpdateNFSFileShareInput
1436
1440
  attr_accessor file_share_arn: ::String
1441
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
1437
1442
  attr_accessor kms_encrypted: bool
1438
1443
  attr_accessor kms_key: ::String
1439
1444
  attr_accessor nfs_file_share_defaults: Types::NFSFileShareDefaults
@@ -1458,6 +1463,7 @@ module Aws::StorageGateway
1458
1463
 
1459
1464
  class UpdateSMBFileShareInput
1460
1465
  attr_accessor file_share_arn: ::String
1466
+ attr_accessor encryption_type: ("SseS3" | "SseKms" | "DsseKms")
1461
1467
  attr_accessor kms_encrypted: bool
1462
1468
  attr_accessor kms_key: ::String
1463
1469
  attr_accessor default_storage_class: ::String
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-storagegateway
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.94.0
4
+ version: 1.95.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-09-11 00:00:00.000000000 Z
11
+ date: 2024-09-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core