aws-sdk-storagegateway 1.93.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.
@@ -40,11 +40,20 @@ module Aws::StorageGateway
40
40
  context[:auth_scheme] =
41
41
  Aws::Endpoints.resolve_auth_scheme(context, endpoint)
42
42
 
43
- @handler.call(context)
43
+ with_metrics(context) { @handler.call(context) }
44
44
  end
45
45
 
46
46
  private
47
47
 
48
+ def with_metrics(context, &block)
49
+ metrics = []
50
+ metrics << 'ENDPOINT_OVERRIDE' unless context.config.regional_endpoint
51
+ if context[:auth_scheme] && context[:auth_scheme]['name'] == 'sigv4a'
52
+ metrics << 'SIGV4A_SIGNING'
53
+ end
54
+ Aws::Plugins::UserAgent.metric(*metrics, &block)
55
+ end
56
+
48
57
  def apply_endpoint_headers(context, headers)
49
58
  headers.each do |key, values|
50
59
  value = values
@@ -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.93.0'
55
+ GEM_VERSION = '1.95.0'
56
56
 
57
57
  end