aws-sdk-storagegateway 1.39.0 → 1.44.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3fd732e1bb891036f779dd8717176fd1b9dc489dc10c1777247e776a09e57f09
4
- data.tar.gz: f0e8e31bfbd34df384dba9f3a08b6701b981197dd39eb454aa167aba819f6985
3
+ metadata.gz: fbe6f9eb17ade1de4734d43b1ed137e3195e8ae0e6b442a8f856ecd7a7db654f
4
+ data.tar.gz: a3d6471335ae9a7a62d5987d497210160aaa553b38d310fb921737aa8e027472
5
5
  SHA512:
6
- metadata.gz: 112b93180fde6b116565ce7052981dc8d8ae674d545e83f00187cccb533cb4f2f119f4285760d00e9de818a15337932fa668d11fe186a8808b05e8ca33718e75
7
- data.tar.gz: 704b309103d5fd816d8fef918d8156ee46cdbdb42a43669ebb58f2b085db7e95227591a7a8215aa0088ad64faac4ca9e61b3a60c74a11ed611198cbd0ca780b4
6
+ metadata.gz: 83c55796d70d1b44c3543c40703cc2bf773d15eb80faf2a18bcd41d9f7434381e996bb5b8defd1a1639f9534efa7fbbd6812231347284f7569e8b034e9ab865d
7
+ data.tar.gz: 3a876ef14d17123bdd9d2ae184e64d34380e5580817b42649c0b74b2d4c20520330d3d23eafa85b694245c0082bfa7b4689eb467c666269a3190a345c07f8b95
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-storagegateway/customizations'
45
47
  # @service
46
48
  module Aws::StorageGateway
47
49
 
48
- GEM_VERSION = '1.39.0'
50
+ GEM_VERSION = '1.44.0'
49
51
 
50
52
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
26
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
26
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
27
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
31
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
29
32
 
@@ -69,6 +72,7 @@ module Aws::StorageGateway
69
72
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
70
73
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
71
74
  add_plugin(Aws::Plugins::TransferEncoding)
75
+ add_plugin(Aws::Plugins::HttpChecksum)
72
76
  add_plugin(Aws::Plugins::SignatureV4)
73
77
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
74
78
 
@@ -105,7 +109,7 @@ module Aws::StorageGateway
105
109
  # @option options [required, String] :region
106
110
  # The AWS region to connect to. The configured `:region` is
107
111
  # used to determine the service `:endpoint`. When not passed,
108
- # a default `:region` is search for in the following locations:
112
+ # a default `:region` is searched for in the following locations:
109
113
  #
110
114
  # * `Aws.config[:region]`
111
115
  # * `ENV['AWS_REGION']`
@@ -161,7 +165,7 @@ module Aws::StorageGateway
161
165
  # @option options [String] :endpoint
162
166
  # The client endpoint is normally constructed from the `:region`
163
167
  # option. You should only configure an `:endpoint` when connecting
164
- # to test endpoints. This should be avalid HTTP(S) URI.
168
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
165
169
  #
166
170
  # @option options [Integer] :endpoint_cache_max_entries (1000)
167
171
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::StorageGateway
176
180
  # requests fetching endpoints information. Defaults to 60 sec.
177
181
  #
178
182
  # @option options [Boolean] :endpoint_discovery (false)
179
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
183
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
180
184
  #
181
185
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
182
186
  # The log formatter.
@@ -323,7 +327,7 @@ module Aws::StorageGateway
323
327
  # that you want to use for storing snapshots or tapes, the time zone for
324
328
  # scheduled snapshots the gateway snapshot schedule window, an
325
329
  # activation key, and a name for your gateway. The activation process
326
- # also associates your gateway with your account; for more information,
330
+ # also associates your gateway with your account. For more information,
327
331
  # see UpdateGatewayInformation.
328
332
  #
329
333
  # <note markdown="1"> You must turn on the gateway VM before you can activate your gateway.
@@ -340,9 +344,12 @@ module Aws::StorageGateway
340
344
  # pass to the `ActivateGateway` API call determine the actual
341
345
  # configuration of your gateway.
342
346
  #
343
- # For more information, see
344
- # https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html
345
- # in the Storage Gateway User Guide.
347
+ # For more information, see [Getting activation key][1] in the *AWS
348
+ # Storage Gateway User Guide*.
349
+ #
350
+ #
351
+ #
352
+ # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html
346
353
  #
347
354
  # @option params [required, String] :gateway_name
348
355
  # The name you configured for your gateway.
@@ -360,34 +367,34 @@ module Aws::StorageGateway
360
367
  # data. The gateway AWS Region specified must be the same AWS Region as
361
368
  # the AWS Region in your `Host` header in the request. For more
362
369
  # information about available AWS Regions and endpoints for AWS Storage
363
- # Gateway, see [Regions and Endpoints][1] in the *Amazon Web Services
364
- # Glossary*.
370
+ # Gateway, see [AWS Storage Gateway endpoints and quotas][1] in the *AWS
371
+ # General Reference*.
365
372
  #
366
- # Valid Values: See [AWS Storage Gateway Regions and Endpoints][1] in
367
- # the AWS General Reference.
373
+ # Valid Values: See [AWS Storage Gateway endpoints and quotas][1] in the
374
+ # *AWS General Reference*.
368
375
  #
369
376
  #
370
377
  #
371
- # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#sg_region
378
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/sg.html
372
379
  #
373
380
  # @option params [String] :gateway_type
374
381
  # A value that defines the type of gateway to activate. The type
375
382
  # specified is critical to all later functions of the gateway and cannot
376
383
  # be changed after activation. The default value is `CACHED`.
377
384
  #
378
- # Valid Values: "STORED", "CACHED", "VTL", "FILE\_S3"
385
+ # Valid Values: `STORED` \| `CACHED` \| `VTL` \| `FILE_S3`
379
386
  #
380
387
  # @option params [String] :tape_drive_type
381
388
  # The value that indicates the type of tape drive to use for tape
382
389
  # gateway. This field is optional.
383
390
  #
384
- # Valid Values: "IBM-ULT3580-TD5"
391
+ # Valid Values: `IBM-ULT3580-TD5`
385
392
  #
386
393
  # @option params [String] :medium_changer_type
387
394
  # The value that indicates the type of medium changer to use for tape
388
395
  # gateway. This field is optional.
389
396
  #
390
- # Valid Values: "STK-L700", "AWS-Gateway-VTL"
397
+ # Valid Values: `STK-L700` \| `AWS-Gateway-VTL`
391
398
  #
392
399
  # @option params [Array<Types::Tag>] :tags
393
400
  # A list of up to 50 tags that you can assign to the gateway. Each tag
@@ -457,8 +464,8 @@ module Aws::StorageGateway
457
464
  end
458
465
 
459
466
  # Configures one or more gateway local disks as cache for a gateway.
460
- # This operation is only supported in the cached volume, tape and file
461
- # gateway type (see [Storage Gateway Concepts][1]).
467
+ # This operation is only supported in the cached volume, tape, and file
468
+ # gateway type (see [How AWS Storage Gateway works (architecture)][1].
462
469
  #
463
470
  # In the request, you specify the gateway Amazon Resource Name (ARN) to
464
471
  # which you want to add cache, and one or more disk IDs that you want to
@@ -737,7 +744,7 @@ module Aws::StorageGateway
737
744
  # is archived directly into the S3 storage class (S3 Glacier or S3
738
745
  # Glacier Deep Archive) that corresponds to the pool.
739
746
  #
740
- # Valid values: "GLACIER", "DEEP\_ARCHIVE"
747
+ # Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
741
748
  #
742
749
  # @option params [required, String] :tape_arn
743
750
  # The unique Amazon Resource Name (ARN) of the virtual tape that you
@@ -750,7 +757,7 @@ module Aws::StorageGateway
750
757
  # eject the tape, the tape is archived directly into the storage class
751
758
  # (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
752
759
  #
753
- # Valid values: "GLACIER", "DEEP\_ARCHIVE"
760
+ # Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
754
761
  #
755
762
  # @return [Types::AssignTapePoolOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
756
763
  #
@@ -981,7 +988,7 @@ module Aws::StorageGateway
981
988
  # @option params [String] :snapshot_id
982
989
  # The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as
983
990
  # the new cached volume. Specify this field if you want to create the
984
- # iSCSI storage volume from a snapshot otherwise do not include this
991
+ # iSCSI storage volume from a snapshot; otherwise, do not include this
985
992
  # field. To list snapshots for your account use [DescribeSnapshots][1]
986
993
  # in the *Amazon Elastic Compute Cloud API Reference*.
987
994
  #
@@ -1019,13 +1026,16 @@ module Aws::StorageGateway
1019
1026
  # request.
1020
1027
  #
1021
1028
  # @option params [Boolean] :kms_encrypted
1022
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1023
- # key, or false to use a key managed by Amazon S3. Optional.
1029
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1030
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1031
+ #
1032
+ # Valid Values: `true` \| `false`
1024
1033
  #
1025
1034
  # @option params [String] :kms_key
1026
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
1027
- # server-side encryption. This value can only be set when KMSEncrypted
1028
- # is true. Optional.
1035
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1036
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1037
+ # not support asymmetric CMKs. This value can only be set when
1038
+ # `KMSEncrypted` is `true`. Optional.
1029
1039
  #
1030
1040
  # @option params [Array<Types::Tag>] :tags
1031
1041
  # A list of up to 50 tags that you can assign to a cached volume. Each
@@ -1108,13 +1118,17 @@ module Aws::StorageGateway
1108
1118
  # activated to enable you to create a file share. Make sure AWS STS is
1109
1119
  # activated in the AWS Region you are creating your file gateway in. If
1110
1120
  # AWS STS is not activated in the AWS Region, activate it. For
1111
- # information about how to activate AWS STS, see Activating and
1112
- # Deactivating AWS STS in an AWS Region in the AWS Identity and Access
1113
- # Management User Guide.
1121
+ # information about how to activate AWS STS, see [Activating and
1122
+ # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
1123
+ # Access Management User Guide*.
1114
1124
  #
1115
1125
  # File gateway does not support creating hard or symbolic links on a
1116
1126
  # file share.
1117
1127
  #
1128
+ #
1129
+ #
1130
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html
1131
+ #
1118
1132
  # @option params [required, String] :client_token
1119
1133
  # A unique string value that you supply that is used by file gateway to
1120
1134
  # ensure idempotent file share creation.
@@ -1127,13 +1141,16 @@ module Aws::StorageGateway
1127
1141
  # to create a file share.
1128
1142
  #
1129
1143
  # @option params [Boolean] :kms_encrypted
1130
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1131
- # key, or false to use a key managed by Amazon S3. Optional.
1144
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1145
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1146
+ #
1147
+ # Valid Values: `true` \| `false`
1132
1148
  #
1133
1149
  # @option params [String] :kms_key
1134
- # The Amazon Resource Name (ARN) AWS KMS key used for Amazon S3
1135
- # server-side encryption. This value can only be set when KMSEncrypted
1136
- # is true. Optional.
1150
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1151
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1152
+ # not support asymmetric CMKs. This value can only be set when
1153
+ # `KMSEncrypted` is `true`. Optional.
1137
1154
  #
1138
1155
  # @option params [required, String] :role
1139
1156
  # The ARN of the AWS Identity and Access Management (IAM) role that a
@@ -1144,44 +1161,51 @@ module Aws::StorageGateway
1144
1161
  #
1145
1162
  # @option params [String] :default_storage_class
1146
1163
  # The default storage class for objects put into an Amazon S3 bucket by
1147
- # the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
1148
- # or `S3_ONEZONE_IA`. If this field is not populated, the default value
1149
- # `S3_STANDARD` is used. Optional.
1164
+ # the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
1165
+ # Optional.
1166
+ #
1167
+ # Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
1168
+ # `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
1150
1169
  #
1151
1170
  # @option params [String] :object_acl
1152
- # A value that sets the access control list permission for objects in
1153
- # the S3 bucket that a file gateway puts objects into. The default value
1154
- # is "private".
1171
+ # A value that sets the access control list (ACL) permission for objects
1172
+ # in the S3 bucket that a file gateway puts objects into. The default
1173
+ # value is `private`.
1155
1174
  #
1156
1175
  # @option params [Array<String>] :client_list
1157
1176
  # The list of clients that are allowed to access the file gateway. The
1158
1177
  # list must contain either valid IP addresses or valid CIDR blocks.
1159
1178
  #
1160
1179
  # @option params [String] :squash
1161
- # A value that maps a user to anonymous user. Valid options are the
1162
- # following:
1180
+ # A value that maps a user to anonymous user.
1163
1181
  #
1164
- # * `RootSquash` - Only root is mapped to anonymous user.
1182
+ # Valid values are the following:
1165
1183
  #
1166
- # * `NoSquash` - No one is mapped to anonymous user
1184
+ # * `RootSquash`\: Only root is mapped to anonymous user.
1167
1185
  #
1168
- # * `AllSquash` - Everyone is mapped to anonymous user.
1186
+ # * `NoSquash`\: No one is mapped to anonymous user.
1187
+ #
1188
+ # * `AllSquash`\: Everyone is mapped to anonymous user.
1169
1189
  #
1170
1190
  # @option params [Boolean] :read_only
1171
- # A value that sets the write status of a file share. This value is true
1172
- # if the write status is read-only, and otherwise false.
1191
+ # A value that sets the write status of a file share. Set this value to
1192
+ # `true` to set the write status to read-only, otherwise set to `false`.
1193
+ #
1194
+ # Valid Values: `true` \| `false`
1173
1195
  #
1174
1196
  # @option params [Boolean] :guess_mime_type_enabled
1175
1197
  # A value that enables guessing of the MIME type for uploaded objects
1176
- # based on file extensions. Set this value to true to enable MIME type
1177
- # guessing, and otherwise to false. The default value is true.
1198
+ # based on file extensions. Set this value to `true` to enable MIME type
1199
+ # guessing, otherwise set to `false`. The default value is `true`.
1200
+ #
1201
+ # Valid Values: `true` \| `false`
1178
1202
  #
1179
1203
  # @option params [Boolean] :requester_pays
1180
1204
  # A value that sets who pays the cost of the request and the cost
1181
1205
  # associated with data download from the S3 bucket. If this value is set
1182
- # to true, the requester pays the costs. Otherwise the S3 bucket owner
1183
- # pays. However, the S3 bucket owner always pays the cost of storing
1184
- # data.
1206
+ # to `true`, the requester pays the costs; otherwise, the S3 bucket
1207
+ # owner pays. However, the S3 bucket owner always pays the cost of
1208
+ # storing data.
1185
1209
  #
1186
1210
  # <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
1187
1211
  # file share, so make sure that the configuration on the file share is
@@ -1189,6 +1213,8 @@ module Aws::StorageGateway
1189
1213
  #
1190
1214
  # </note>
1191
1215
  #
1216
+ # Valid Values: `true` \| `false`
1217
+ #
1192
1218
  # @option params [Array<Types::Tag>] :tags
1193
1219
  # A list of up to 50 tags that can be assigned to the NFS file share.
1194
1220
  # Each tag is a key-value pair.
@@ -1258,8 +1284,8 @@ module Aws::StorageGateway
1258
1284
  # is activated in the AWS Region you are creating your file gateway in.
1259
1285
  # If AWS STS is not activated in this AWS Region, activate it. For
1260
1286
  # information about how to activate AWS STS, see [Activating and
1261
- # Deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
1262
- # Access Management User Guide.*
1287
+ # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
1288
+ # Access Management User Guide*.
1263
1289
  #
1264
1290
  # File gateways don't support creating hard or symbolic links on a
1265
1291
  # file
@@ -1277,13 +1303,16 @@ module Aws::StorageGateway
1277
1303
  # The ARN of the file gateway on which you want to create a file share.
1278
1304
  #
1279
1305
  # @option params [Boolean] :kms_encrypted
1280
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1281
- # key, or false to use a key managed by Amazon S3. Optional.
1306
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1307
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1308
+ #
1309
+ # Valid Values: `true` \| `false`
1282
1310
  #
1283
1311
  # @option params [String] :kms_key
1284
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
1285
- # server-side encryption. This value can only be set when KMSEncrypted
1286
- # is true. Optional.
1312
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1313
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1314
+ # not support asymmetric CMKs. This value can only be set when
1315
+ # `KMSEncrypted` is `true`. Optional.
1287
1316
  #
1288
1317
  # @option params [required, String] :role
1289
1318
  # The ARN of the AWS Identity and Access Management (IAM) role that a
@@ -1294,30 +1323,36 @@ module Aws::StorageGateway
1294
1323
  #
1295
1324
  # @option params [String] :default_storage_class
1296
1325
  # The default storage class for objects put into an Amazon S3 bucket by
1297
- # the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
1298
- # or `S3_ONEZONE_IA`. If this field is not populated, the default value
1299
- # `S3_STANDARD` is used. Optional.
1326
+ # the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
1327
+ # Optional.
1328
+ #
1329
+ # Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
1330
+ # `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
1300
1331
  #
1301
1332
  # @option params [String] :object_acl
1302
- # A value that sets the access control list permission for objects in
1303
- # the S3 bucket that a file gateway puts objects into. The default value
1304
- # is "private".
1333
+ # A value that sets the access control list (ACL) permission for objects
1334
+ # in the S3 bucket that a file gateway puts objects into. The default
1335
+ # value is `private`.
1305
1336
  #
1306
1337
  # @option params [Boolean] :read_only
1307
- # A value that sets the write status of a file share. This value is true
1308
- # if the write status is read-only, and otherwise false.
1338
+ # A value that sets the write status of a file share. Set this value to
1339
+ # `true` to set the write status to read-only, otherwise set to `false`.
1340
+ #
1341
+ # Valid Values: `true` \| `false`
1309
1342
  #
1310
1343
  # @option params [Boolean] :guess_mime_type_enabled
1311
1344
  # A value that enables guessing of the MIME type for uploaded objects
1312
- # based on file extensions. Set this value to true to enable MIME type
1313
- # guessing, and otherwise to false. The default value is true.
1345
+ # based on file extensions. Set this value to `true` to enable MIME type
1346
+ # guessing, otherwise set to `false`. The default value is `true`.
1347
+ #
1348
+ # Valid Values: `true` \| `false`
1314
1349
  #
1315
1350
  # @option params [Boolean] :requester_pays
1316
1351
  # A value that sets who pays the cost of the request and the cost
1317
1352
  # associated with data download from the S3 bucket. If this value is set
1318
- # to true, the requester pays the costs. Otherwise the S3 bucket owner
1319
- # pays. However, the S3 bucket owner always pays the cost of storing
1320
- # data.
1353
+ # to `true`, the requester pays the costs; otherwise, the S3 bucket
1354
+ # owner pays. However, the S3 bucket owner always pays the cost of
1355
+ # storing data.
1321
1356
  #
1322
1357
  # <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
1323
1358
  # file share, so make sure that the configuration on the file share is
@@ -1325,14 +1360,22 @@ module Aws::StorageGateway
1325
1360
  #
1326
1361
  # </note>
1327
1362
  #
1363
+ # Valid Values: `true` \| `false`
1364
+ #
1328
1365
  # @option params [Boolean] :smbacl_enabled
1329
- # Set this value to "true to enable ACL (access control list) on the
1330
- # SMB file share. Set it to "false" to map file and directory
1366
+ # Set this value to `true` to enable access control list (ACL) on the
1367
+ # SMB file share. Set it to `false` to map file and directory
1331
1368
  # permissions to the POSIX permissions.
1332
1369
  #
1333
- # For more information, see
1334
- # https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
1335
- # in the Storage Gateway User Guide.
1370
+ # For more information, see [Using Microsoft Windows ACLs to control
1371
+ # access to an SMB file share][1] in the *AWS Storage Gateway User
1372
+ # Guide*.
1373
+ #
1374
+ # Valid Values: `true` \| `false`
1375
+ #
1376
+ #
1377
+ #
1378
+ # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
1336
1379
  #
1337
1380
  # @option params [Array<String>] :admin_user_list
1338
1381
  # A list of users in the Active Directory that will be granted
@@ -1345,7 +1388,7 @@ module Aws::StorageGateway
1345
1388
  # @option params [Array<String>] :valid_user_list
1346
1389
  # A list of users or groups in the Active Directory that are allowed to
1347
1390
  # access the file share. A group must be prefixed with the @ character.
1348
- # For example `@group1`. Can only be set if Authentication is set to
1391
+ # For example, `@group1`. Can only be set if Authentication is set to
1349
1392
  # `ActiveDirectory`.
1350
1393
  #
1351
1394
  # @option params [Array<String>] :invalid_user_list
@@ -1358,10 +1401,10 @@ module Aws::StorageGateway
1358
1401
  # The Amazon Resource Name (ARN) of the storage used for the audit logs.
1359
1402
  #
1360
1403
  # @option params [String] :authentication
1361
- # The authentication method that users use to access the file share.
1404
+ # The authentication method that users use to access the file share. The
1405
+ # default is `ActiveDirectory`.
1362
1406
  #
1363
- # Valid values are `ActiveDirectory` or `GuestAccess`. The default is
1364
- # `ActiveDirectory`.
1407
+ # Valid Values: `ActiveDirectory` \| `GuestAccess`
1365
1408
  #
1366
1409
  # @option params [Array<Types::Tag>] :tags
1367
1410
  # A list of up to 50 tags that can be assigned to the NFS file share.
@@ -1422,12 +1465,12 @@ module Aws::StorageGateway
1422
1465
  # Initiates a snapshot of a volume.
1423
1466
  #
1424
1467
  # AWS Storage Gateway provides the ability to back up point-in-time
1425
- # snapshots of your data to Amazon Simple Storage Service (Amazon S3)
1426
- # for durable off-site recovery, as well as import the data to an Amazon
1468
+ # snapshots of your data to Amazon Simple Storage (Amazon S3) for
1469
+ # durable off-site recovery, as well as import the data to an Amazon
1427
1470
  # Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud
1428
1471
  # (EC2). You can take snapshots of your gateway volume on a scheduled or
1429
- # ad hoc basis. This API enables you to take an ad hoc snapshot. For
1430
- # more information, see [Editing a Snapshot Schedule][1].
1472
+ # ad hoc basis. This API enables you to take ad-hoc snapshot. For more
1473
+ # information, see [Editing a snapshot schedule][1].
1431
1474
  #
1432
1475
  # In the CreateSnapshot request you identify the volume by providing its
1433
1476
  # Amazon Resource Name (ARN). You must also provide description for the
@@ -1440,19 +1483,20 @@ module Aws::StorageGateway
1440
1483
  # gateway type.
1441
1484
  #
1442
1485
  # <note markdown="1"> To list or delete a snapshot, you must use the Amazon EC2 API. For
1443
- # more information, see DescribeSnapshots or DeleteSnapshot in the [EC2
1444
- # API reference][2].
1486
+ # more information, see [DescribeSnapshots][2] or [DeleteSnapshot][3] in
1487
+ # the *Amazon Elastic Compute Cloud API Reference*.
1445
1488
  #
1446
1489
  # </note>
1447
1490
  #
1448
1491
  # Volume and snapshot IDs are changing to a longer length ID format. For
1449
- # more information, see the important note on the [Welcome][3] page.
1492
+ # more information, see the important note on the [Welcome][4] page.
1450
1493
  #
1451
1494
  #
1452
1495
  #
1453
1496
  # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/managing-volumes.html#SchedulingSnapshot
1454
- # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Operations.html
1455
- # [3]: https://docs.aws.amazon.com/storagegateway/latest/APIReference/Welcome.html
1497
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
1498
+ # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSnapshot.html
1499
+ # [4]: https://docs.aws.amazon.com/storagegateway/latest/APIReference/Welcome.html
1456
1500
  #
1457
1501
  # @option params [required, String] :volume_arn
1458
1502
  # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes
@@ -1462,7 +1506,7 @@ module Aws::StorageGateway
1462
1506
  # Textual description of the snapshot that appears in the Amazon EC2
1463
1507
  # console, Elastic Block Store snapshots panel in the **Description**
1464
1508
  # field, and in the AWS Storage Gateway snapshot **Details** pane,
1465
- # **Description** field
1509
+ # **Description** field.
1466
1510
  #
1467
1511
  # @option params [Array<Types::Tag>] :tags
1468
1512
  # A list of up to 50 tags that can be assigned to a snapshot. Each tag
@@ -1541,10 +1585,16 @@ module Aws::StorageGateway
1541
1585
  # from a snapshot.
1542
1586
  #
1543
1587
  # <note markdown="1"> To list or delete a snapshot, you must use the Amazon EC2 API. For
1544
- # more information, in *Amazon Elastic Compute Cloud API Reference*.
1588
+ # more information, see [DescribeSnapshots][1] or [DeleteSnapshot][2] in
1589
+ # the *Amazon Elastic Compute Cloud API Reference*.
1545
1590
  #
1546
1591
  # </note>
1547
1592
  #
1593
+ #
1594
+ #
1595
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
1596
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSnapshot.html
1597
+ #
1548
1598
  # @option params [required, String] :volume_arn
1549
1599
  # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the
1550
1600
  # DescribeStorediSCSIVolumes operation to return to retrieve the
@@ -1554,7 +1604,7 @@ module Aws::StorageGateway
1554
1604
  # Textual description of the snapshot that appears in the Amazon EC2
1555
1605
  # console, Elastic Block Store snapshots panel in the **Description**
1556
1606
  # field, and in the AWS Storage Gateway snapshot **Details** pane,
1557
- # **Description** field
1607
+ # **Description** field.
1558
1608
  #
1559
1609
  # @option params [Array<Types::Tag>] :tags
1560
1610
  # A list of up to 50 tags that can be assigned to a snapshot. Each tag
@@ -1650,7 +1700,7 @@ module Aws::StorageGateway
1650
1700
  # @option params [String] :snapshot_id
1651
1701
  # The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as
1652
1702
  # the new stored volume. Specify this field if you want to create the
1653
- # iSCSI storage volume from a snapshot otherwise do not include this
1703
+ # iSCSI storage volume from a snapshot; otherwise, do not include this
1654
1704
  # field. To list snapshots for your account use [DescribeSnapshots][1]
1655
1705
  # in the *Amazon Elastic Compute Cloud API Reference*.
1656
1706
  #
@@ -1659,11 +1709,10 @@ module Aws::StorageGateway
1659
1709
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html
1660
1710
  #
1661
1711
  # @option params [required, Boolean] :preserve_existing_data
1662
- # Specify this field as true if you want to preserve the data on the
1663
- # local disk. Otherwise, specifying this field as false creates an empty
1664
- # volume.
1712
+ # Set to true `true` if you want to preserve the data on the local disk.
1713
+ # Otherwise, set to `false` to create an empty volume.
1665
1714
  #
1666
- # Valid Values: true, false
1715
+ # Valid Values: `true` \| `false`
1667
1716
  #
1668
1717
  # @option params [required, String] :target_name
1669
1718
  # The name of the iSCSI target used by an initiator to connect to a
@@ -1684,13 +1733,16 @@ module Aws::StorageGateway
1684
1733
  # Valid Values: A valid IP address.
1685
1734
  #
1686
1735
  # @option params [Boolean] :kms_encrypted
1687
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1688
- # key, or false to use a key managed by Amazon S3. Optional.
1736
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1737
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1738
+ #
1739
+ # Valid Values: `true` \| `false`
1689
1740
  #
1690
1741
  # @option params [String] :kms_key
1691
- # The Amazon Resource Name (ARN) of the KMS key used for Amazon S3
1692
- # server-side encryption. This value can only be set when KMSEncrypted
1693
- # is true. Optional.
1742
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1743
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1744
+ # not support asymmetric CMKs. This value can only be set when
1745
+ # `KMSEncrypted` is `true`. Optional.
1694
1746
  #
1695
1747
  # @option params [Array<Types::Tag>] :tags
1696
1748
  # A list of up to 50 tags that can be assigned to a stored volume. Each
@@ -1766,7 +1818,7 @@ module Aws::StorageGateway
1766
1818
 
1767
1819
  # Creates a virtual tape by using your own barcode. You write data to
1768
1820
  # the virtual tape and then archive the tape. A barcode is unique and
1769
- # cannot be reused if it has already been used on a tape. This applies
1821
+ # can not be reused if it has already been used on a tape. This applies
1770
1822
  # to barcodes used on deleted tapes. This operation is only supported in
1771
1823
  # the tape gateway type.
1772
1824
  #
@@ -1797,22 +1849,25 @@ module Aws::StorageGateway
1797
1849
  # </note>
1798
1850
  #
1799
1851
  # @option params [Boolean] :kms_encrypted
1800
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1801
- # key, or false to use a key managed by Amazon S3. Optional.
1852
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1853
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1854
+ #
1855
+ # Valid Values: `true` \| `false`
1802
1856
  #
1803
1857
  # @option params [String] :kms_key
1804
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
1805
- # server-side encryption. This value can only be set when KMSEncrypted
1806
- # is true. Optional.
1858
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1859
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1860
+ # not support asymmetric CMKs. This value can only be set when
1861
+ # `KMSEncrypted` is `true`. Optional.
1807
1862
  #
1808
1863
  # @option params [String] :pool_id
1809
1864
  # The ID of the pool that you want to add your tape to for archiving.
1810
1865
  # The tape in this pool is archived in the S3 storage class that is
1811
1866
  # associated with the pool. When you use your backup application to
1812
1867
  # eject the tape, the tape is archived directly into the storage class
1813
- # (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
1868
+ # (S3 Glacier or S3 Deep Archive) that corresponds to the pool.
1814
1869
  #
1815
- # Valid values: "GLACIER", "DEEP\_ARCHIVE"
1870
+ # Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
1816
1871
  #
1817
1872
  # @option params [Array<Types::Tag>] :tags
1818
1873
  # A list of up to 50 tags that can be assigned to a virtual tape that
@@ -1920,13 +1975,16 @@ module Aws::StorageGateway
1920
1975
  # </note>
1921
1976
  #
1922
1977
  # @option params [Boolean] :kms_encrypted
1923
- # True to use Amazon S3 server-side encryption with your own AWS KMS
1924
- # key, or false to use a key managed by Amazon S3. Optional.
1978
+ # Set to `true` to use Amazon S3 server-side encryption with your own
1979
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
1980
+ #
1981
+ # Valid Values: `true` \| `false`
1925
1982
  #
1926
1983
  # @option params [String] :kms_key
1927
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
1928
- # server-side encryption. This value can only be set when KMSEncrypted
1929
- # is true. Optional.
1984
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
1985
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
1986
+ # not support asymmetric CMKs. This value can only be set when
1987
+ # `KMSEncrypted` is `true`. Optional.
1930
1988
  #
1931
1989
  # @option params [String] :pool_id
1932
1990
  # The ID of the pool that you want to add your tape to for archiving.
@@ -1935,7 +1993,7 @@ module Aws::StorageGateway
1935
1993
  # eject the tape, the tape is archived directly into the storage class
1936
1994
  # (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
1937
1995
  #
1938
- # Valid values: "GLACIER", "DEEP\_ARCHIVE"
1996
+ # Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
1939
1997
  #
1940
1998
  # @option params [Array<Types::Tag>] :tags
1941
1999
  # A list of up to 50 tags that can be assigned to a virtual tape. Each
@@ -2056,7 +2114,7 @@ module Aws::StorageGateway
2056
2114
  # One of the BandwidthType values that indicates the gateway bandwidth
2057
2115
  # rate limit to delete.
2058
2116
  #
2059
- # Valid Values: `Upload`, `Download`, `All`.
2117
+ # Valid Values: `Upload` \| `Download` \| `All`
2060
2118
  #
2061
2119
  # @return [Types::DeleteBandwidthRateLimitOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2062
2120
  #
@@ -2158,11 +2216,13 @@ module Aws::StorageGateway
2158
2216
  # The Amazon Resource Name (ARN) of the file share to be deleted.
2159
2217
  #
2160
2218
  # @option params [Boolean] :force_delete
2161
- # If this value is set to true, the operation deletes a file share
2219
+ # If this value is set to `true`, the operation deletes a file share
2162
2220
  # immediately and aborts all data uploads to AWS. Otherwise, the file
2163
2221
  # share is not deleted until all data is uploaded to AWS. This process
2164
2222
  # aborts the data upload process, and the file share enters the
2165
- # FORCE\_DELETING status.
2223
+ # `FORCE_DELETING` status.
2224
+ #
2225
+ # Valid Values: `true` \| `false`
2166
2226
  #
2167
2227
  # @return [Types::DeleteFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2168
2228
  #
@@ -2205,8 +2265,8 @@ module Aws::StorageGateway
2205
2265
  # all remaining Amazon EBS snapshots by canceling your Amazon EC2
2206
2266
  # subscription.  If you prefer not to cancel your Amazon EC2
2207
2267
  # subscription, you can delete your snapshots using the Amazon EC2
2208
- # console. For more information, see the [ AWS Storage Gateway Detail
2209
- # Page][1].
2268
+ # console. For more information, see the [AWS Storage Gateway detail
2269
+ # page][1].
2210
2270
  #
2211
2271
  #
2212
2272
  #
@@ -2258,7 +2318,7 @@ module Aws::StorageGateway
2258
2318
  #
2259
2319
  # You can take snapshots of your gateway volumes on a scheduled or ad
2260
2320
  # hoc basis. This API action enables you to delete a snapshot schedule
2261
- # for a volume. For more information, see [Working with Snapshots][1].
2321
+ # for a volume. For more information, see [Backing up your volumes][1].
2262
2322
  # In the `DeleteSnapshotSchedule` request, you identify the volume by
2263
2323
  # providing its Amazon Resource Name (ARN). This operation is only
2264
2324
  # supported in stored and cached volume gateway types.
@@ -2271,7 +2331,7 @@ module Aws::StorageGateway
2271
2331
  #
2272
2332
  #
2273
2333
  #
2274
- # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/WorkingWithSnapshots.html
2334
+ # [1]: https://docs.aws.amazon.com/storagegatewaylatest/userguide/backing-up-volumes.html
2275
2335
  # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
2276
2336
  #
2277
2337
  # @option params [required, String] :volume_arn
@@ -2511,7 +2571,7 @@ module Aws::StorageGateway
2511
2571
  # Returns the bandwidth rate limits of a gateway. By default, these
2512
2572
  # limits are not set, which means no bandwidth rate limiting is in
2513
2573
  # effect. This operation is supported for the stored volume, cached
2514
- # volume and tape gateway types.'
2574
+ # volume and tape gateway types.
2515
2575
  #
2516
2576
  # This operation only returns a value for a bandwidth rate limit only if
2517
2577
  # the limit is set. If no limits are set for the gateway, then this
@@ -2807,6 +2867,7 @@ module Aws::StorageGateway
2807
2867
  # * {Types::DescribeGatewayInformationOutput#vpc_endpoint #vpc_endpoint} => String
2808
2868
  # * {Types::DescribeGatewayInformationOutput#cloud_watch_log_group_arn #cloud_watch_log_group_arn} => String
2809
2869
  # * {Types::DescribeGatewayInformationOutput#host_environment #host_environment} => String
2870
+ # * {Types::DescribeGatewayInformationOutput#endpoint_type #endpoint_type} => String
2810
2871
  #
2811
2872
  #
2812
2873
  # @example Example: To describe metadata about the gateway
@@ -2863,6 +2924,7 @@ module Aws::StorageGateway
2863
2924
  # resp.vpc_endpoint #=> String
2864
2925
  # resp.cloud_watch_log_group_arn #=> String
2865
2926
  # resp.host_environment #=> String, one of "VMWARE", "HYPER-V", "EC2", "KVM", "OTHER"
2927
+ # resp.endpoint_type #=> String
2866
2928
  #
2867
2929
  # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeGatewayInformation AWS API Documentation
2868
2930
  #
@@ -3150,7 +3212,7 @@ module Aws::StorageGateway
3150
3212
 
3151
3213
  # Returns the description of the gateway volumes specified in the
3152
3214
  # request. The list of gateway volumes in the request must be from one
3153
- # gateway. In the response AWS Storage Gateway returns volume
3215
+ # gateway. In the response, AWS Storage Gateway returns volume
3154
3216
  # information sorted by volume ARNs. This operation is only supported in
3155
3217
  # stored volume gateway type.
3156
3218
  #
@@ -3517,7 +3579,7 @@ module Aws::StorageGateway
3517
3579
  end
3518
3580
 
3519
3581
  # Returns information about the upload buffer of a gateway. This
3520
- # operation is supported for the stored volume, cached volume and tape
3582
+ # operation is supported for the stored volume, cached volume, and tape
3521
3583
  # gateway types.
3522
3584
  #
3523
3585
  # The response includes disk IDs that are configured as upload buffer
@@ -3814,6 +3876,8 @@ module Aws::StorageGateway
3814
3876
  # set to `false`, you must manually disconnect the iSCSI connection from
3815
3877
  # the target volume.
3816
3878
  #
3879
+ # Valid Values: `true` \| `false`
3880
+ #
3817
3881
  # @return [Types::DetachVolumeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3818
3882
  #
3819
3883
  # * {Types::DetachVolumeOutput#volume_arn #volume_arn} => String
@@ -4563,9 +4627,12 @@ module Aws::StorageGateway
4563
4627
  # as Amazon SNS or AWS Lambda function. This operation is only supported
4564
4628
  # for file gateways.
4565
4629
  #
4566
- # For more information, see Getting File Upload Notification in the
4567
- # Storage Gateway User Guide
4568
- # (https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-upload-notification).
4630
+ # For more information, see [Getting file upload notification][1] in the
4631
+ # *AWS Storage Gateway User Guide*.
4632
+ #
4633
+ #
4634
+ #
4635
+ # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-upload-notification
4569
4636
  #
4570
4637
  # @option params [required, String] :file_share_arn
4571
4638
  # The Amazon Resource Name (ARN) of the file share.
@@ -4601,7 +4668,8 @@ module Aws::StorageGateway
4601
4668
  # results. This operation is only supported in the file gateway type.
4602
4669
  # You can subscribe to be notified through an Amazon CloudWatch event
4603
4670
  # when your RefreshCache operation completes. For more information, see
4604
- # [Getting Notified About File Operations][1].
4671
+ # [Getting notified about file operations][1] in the *AWS Storage
4672
+ # Gateway User Guide*.
4605
4673
  #
4606
4674
  # When this API is called, it only initiates the refresh operation. When
4607
4675
  # the API call completes and returns a success code, it doesn't
@@ -4614,16 +4682,16 @@ module Aws::StorageGateway
4614
4682
  # Throttle limit: This API is asynchronous so the gateway will accept no
4615
4683
  # more than two refreshes at any time. We recommend using the
4616
4684
  # refresh-complete CloudWatch event notification before issuing
4617
- # additional requests. For more information, see [Getting Notified About
4618
- # File Operations][1].
4685
+ # additional requests. For more information, see [Getting notified about
4686
+ # file operations][1] in the *AWS Storage Gateway User Guide*.
4619
4687
  #
4620
4688
  # If you invoke the RefreshCache API when two requests are already being
4621
4689
  # processed, any new request will cause an
4622
4690
  # `InvalidGatewayRequestException` error because too many requests were
4623
4691
  # sent to the server.
4624
4692
  #
4625
- # For more information, see
4626
- # "https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-notification".
4693
+ # For more information, see [Getting notified about file operations][1]
4694
+ # in the *AWS Storage Gateway User Guide*.
4627
4695
  #
4628
4696
  #
4629
4697
  #
@@ -4636,18 +4704,19 @@ module Aws::StorageGateway
4636
4704
  # A comma-separated list of the paths of folders to refresh in the
4637
4705
  # cache. The default is \[`"/"`\]. The default refreshes objects and
4638
4706
  # folders at the root of the Amazon S3 bucket. If `Recursive` is set to
4639
- # "true", the entire S3 bucket that the file share has access to is
4707
+ # `true`, the entire S3 bucket that the file share has access to is
4640
4708
  # refreshed.
4641
4709
  #
4642
4710
  # @option params [Boolean] :recursive
4643
4711
  # A value that specifies whether to recursively refresh folders in the
4644
4712
  # cache. The refresh includes folders that were in the cache the last
4645
4713
  # time the gateway listed the folder's contents. If this value set to
4646
- # "true", each folder that is listed in `FolderList` is recursively
4714
+ # `true`, each folder that is listed in `FolderList` is recursively
4647
4715
  # updated. Otherwise, subfolders listed in `FolderList` are not
4648
4716
  # refreshed. Only objects that are in folders listed directly under
4649
- # `FolderList` are found and used for the update. The default is
4650
- # "true".
4717
+ # `FolderList` are found and used for the update. The default is `true`.
4718
+ #
4719
+ # Valid Values: `true` \| `false`
4651
4720
  #
4652
4721
  # @return [Types::RefreshCacheOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4653
4722
  #
@@ -4973,7 +5042,7 @@ module Aws::StorageGateway
4973
5042
  # is associated with.
4974
5043
  #
4975
5044
  # @option params [required, String] :password
4976
- # The password that you want to set for your SMB Server.
5045
+ # The password that you want to set for your SMB server.
4977
5046
  #
4978
5047
  # @return [Types::SetSMBGuestPasswordOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4979
5048
  #
@@ -5012,7 +5081,7 @@ module Aws::StorageGateway
5012
5081
  # </note>
5013
5082
  #
5014
5083
  # After the gateway is shutdown, you cannot call any other API except
5015
- # StartGateway, DescribeGatewayInformation and ListGateways. For more
5084
+ # StartGateway, DescribeGatewayInformation, and ListGateways. For more
5016
5085
  # information, see ActivateGateway. Your applications cannot read from
5017
5086
  # or write to the gateway's storage volumes, and there are no snapshots
5018
5087
  # taken.
@@ -5224,7 +5293,7 @@ module Aws::StorageGateway
5224
5293
  # the upload and download bandwidth rate limit or specify only one of
5225
5294
  # the two. If you don't set a bandwidth rate limit, the existing rate
5226
5295
  # limit remains. This operation is supported for the stored volume,
5227
- # cached volume and tape gateway types.'
5296
+ # cached volume, and tape gateway types.
5228
5297
  #
5229
5298
  # By default, a gateway's bandwidth rate limits are not set. If you
5230
5299
  # don't set any limit, the gateway does not have any limitations on its
@@ -5393,7 +5462,7 @@ module Aws::StorageGateway
5393
5462
  # The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
5394
5463
  # you want to use to monitor and log events in the gateway.
5395
5464
  #
5396
- # For more information, see [What Is Amazon CloudWatch Logs?][1].
5465
+ # For more information, see [What is Amazon CloudWatch logs?][1].
5397
5466
  #
5398
5467
  #
5399
5468
  #
@@ -5458,8 +5527,8 @@ module Aws::StorageGateway
5458
5527
  # minimize the chance of any disruption to your applications by
5459
5528
  # increasing your iSCSI Initiators' timeouts. For more information
5460
5529
  # about increasing iSCSI Initiator timeouts for Windows and Linux, see
5461
- # [Customizing Your Windows iSCSI Settings][1] and [Customizing Your
5462
- # Linux iSCSI Settings][2], respectively.
5530
+ # [Customizing your Windows iSCSI settings][1] and [Customizing your
5531
+ # Linux iSCSI settings][2], respectively.
5463
5532
  #
5464
5533
  #
5465
5534
  #
@@ -5537,10 +5606,6 @@ module Aws::StorageGateway
5537
5606
  # represented as an ordinal number from 1 to 28, where 1 represents the
5538
5607
  # first day of the month and 28 represents the last day of the month.
5539
5608
  #
5540
- # <note markdown="1"> This value is only available for tape and volume gateways.
5541
- #
5542
- # </note>
5543
- #
5544
5609
  # @return [Types::UpdateMaintenanceStartTimeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5545
5610
  #
5546
5611
  # * {Types::UpdateMaintenanceStartTimeOutput#gateway_arn #gateway_arn} => String
@@ -5615,56 +5680,67 @@ module Aws::StorageGateway
5615
5680
  # The Amazon Resource Name (ARN) of the file share to be updated.
5616
5681
  #
5617
5682
  # @option params [Boolean] :kms_encrypted
5618
- # True to use Amazon S3 server-side encryption with your own AWS KMS
5619
- # key, or false to use a key managed by Amazon S3. Optional.
5683
+ # Set to `true` to use Amazon S3 server-side encryption with your own
5684
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
5685
+ #
5686
+ # Valid Values: `true` \| `false`
5620
5687
  #
5621
5688
  # @option params [String] :kms_key
5622
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
5623
- # server-side encryption. This value can only be set when KMSEncrypted
5624
- # is true. Optional.
5689
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
5690
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
5691
+ # not support asymmetric CMKs. This value can only be set when
5692
+ # `KMSEncrypted` is `true`. Optional.
5625
5693
  #
5626
5694
  # @option params [Types::NFSFileShareDefaults] :nfs_file_share_defaults
5627
5695
  # The default values for the file share. Optional.
5628
5696
  #
5629
5697
  # @option params [String] :default_storage_class
5630
5698
  # The default storage class for objects put into an Amazon S3 bucket by
5631
- # the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
5632
- # or `S3_ONEZONE_IA`. If this field is not populated, the default value
5633
- # `S3_STANDARD` is used. Optional.
5699
+ # the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
5700
+ # Optional.
5701
+ #
5702
+ # Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
5703
+ # `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
5634
5704
  #
5635
5705
  # @option params [String] :object_acl
5636
- # A value that sets the access control list permission for objects in
5637
- # the S3 bucket that a file gateway puts objects into. The default value
5638
- # is "private".
5706
+ # A value that sets the access control list (ACL) permission for objects
5707
+ # in the S3 bucket that a file gateway puts objects into. The default
5708
+ # value is `private`.
5639
5709
  #
5640
5710
  # @option params [Array<String>] :client_list
5641
5711
  # The list of clients that are allowed to access the file gateway. The
5642
5712
  # list must contain either valid IP addresses or valid CIDR blocks.
5643
5713
  #
5644
5714
  # @option params [String] :squash
5645
- # The user mapped to anonymous user. Valid options are the following:
5715
+ # The user mapped to anonymous user.
5716
+ #
5717
+ # Valid values are the following:
5646
5718
  #
5647
- # * `RootSquash` - Only root is mapped to anonymous user.
5719
+ # * `RootSquash`\: Only root is mapped to anonymous user.
5648
5720
  #
5649
- # * `NoSquash` - No one is mapped to anonymous user
5721
+ # * `NoSquash`\: No one is mapped to anonymous user.
5650
5722
  #
5651
- # * `AllSquash` - Everyone is mapped to anonymous user.
5723
+ # * `AllSquash`\: Everyone is mapped to anonymous user.
5652
5724
  #
5653
5725
  # @option params [Boolean] :read_only
5654
- # A value that sets the write status of a file share. This value is true
5655
- # if the write status is read-only, and otherwise false.
5726
+ # A value that sets the write status of a file share. Set this value to
5727
+ # `true` to set the write status to read-only, otherwise set to `false`.
5728
+ #
5729
+ # Valid Values: `true` \| `false`
5656
5730
  #
5657
5731
  # @option params [Boolean] :guess_mime_type_enabled
5658
5732
  # A value that enables guessing of the MIME type for uploaded objects
5659
- # based on file extensions. Set this value to true to enable MIME type
5660
- # guessing, and otherwise to false. The default value is true.
5733
+ # based on file extensions. Set this value to `true` to enable MIME type
5734
+ # guessing, otherwise set to `false`. The default value is `true`.
5735
+ #
5736
+ # Valid Values: `true` \| `false`
5661
5737
  #
5662
5738
  # @option params [Boolean] :requester_pays
5663
5739
  # A value that sets who pays the cost of the request and the cost
5664
5740
  # associated with data download from the S3 bucket. If this value is set
5665
- # to true, the requester pays the costs. Otherwise the S3 bucket owner
5666
- # pays. However, the S3 bucket owner always pays the cost of storing
5667
- # data.
5741
+ # to `true`, the requester pays the costs; otherwise, the S3 bucket
5742
+ # owner pays. However, the S3 bucket owner always pays the cost of
5743
+ # storing data.
5668
5744
  #
5669
5745
  # <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
5670
5746
  # file share, so make sure that the configuration on the file share is
@@ -5672,6 +5748,8 @@ module Aws::StorageGateway
5672
5748
  #
5673
5749
  # </note>
5674
5750
  #
5751
+ # Valid Values: `true` \| `false`
5752
+ #
5675
5753
  # @return [Types::UpdateNFSFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5676
5754
  #
5677
5755
  # * {Types::UpdateNFSFileShareOutput#file_share_arn #file_share_arn} => String
@@ -5722,8 +5800,8 @@ module Aws::StorageGateway
5722
5800
  # is activated in the AWS Region you are creating your file gateway in.
5723
5801
  # If AWS STS is not activated in this AWS Region, activate it. For
5724
5802
  # information about how to activate AWS STS, see [Activating and
5725
- # Deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
5726
- # Access Management User Guide.*
5803
+ # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
5804
+ # Access Management User Guide*.
5727
5805
  #
5728
5806
  # File gateways don't support creating hard or symbolic links on a
5729
5807
  # file
@@ -5738,40 +5816,49 @@ module Aws::StorageGateway
5738
5816
  # update.
5739
5817
  #
5740
5818
  # @option params [Boolean] :kms_encrypted
5741
- # True to use Amazon S3 server-side encryption with your own AWS KMS
5742
- # key, or false to use a key managed by Amazon S3. Optional.
5819
+ # Set to `true` to use Amazon S3 server-side encryption with your own
5820
+ # AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
5821
+ #
5822
+ # Valid Values: `true` \| `false`
5743
5823
  #
5744
5824
  # @option params [String] :kms_key
5745
- # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
5746
- # server-side encryption. This value can only be set when KMSEncrypted
5747
- # is true. Optional.
5825
+ # The Amazon Resource Name (ARN) of a symmetric customer master key
5826
+ # (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
5827
+ # not support asymmetric CMKs. This value can only be set when
5828
+ # `KMSEncrypted` is `true`. Optional.
5748
5829
  #
5749
5830
  # @option params [String] :default_storage_class
5750
5831
  # The default storage class for objects put into an Amazon S3 bucket by
5751
- # the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
5752
- # or `S3_ONEZONE_IA`. If this field is not populated, the default value
5753
- # `S3_STANDARD` is used. Optional.
5832
+ # the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
5833
+ # Optional.
5834
+ #
5835
+ # Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
5836
+ # `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
5754
5837
  #
5755
5838
  # @option params [String] :object_acl
5756
- # A value that sets the access control list permission for objects in
5757
- # the S3 bucket that a file gateway puts objects into. The default value
5758
- # is "private".
5839
+ # A value that sets the access control list (ACL) permission for objects
5840
+ # in the S3 bucket that a file gateway puts objects into. The default
5841
+ # value is `private`.
5759
5842
  #
5760
5843
  # @option params [Boolean] :read_only
5761
- # A value that sets the write status of a file share. This value is true
5762
- # if the write status is read-only, and otherwise false.
5844
+ # A value that sets the write status of a file share. Set this value to
5845
+ # `true` to set write status to read-only, otherwise set to `false`.
5846
+ #
5847
+ # Valid Values: `true` \| `false`
5763
5848
  #
5764
5849
  # @option params [Boolean] :guess_mime_type_enabled
5765
5850
  # A value that enables guessing of the MIME type for uploaded objects
5766
- # based on file extensions. Set this value to true to enable MIME type
5767
- # guessing, and otherwise to false. The default value is true.
5851
+ # based on file extensions. Set this value to `true` to enable MIME type
5852
+ # guessing, otherwise set to `false`. The default value is `true`.
5853
+ #
5854
+ # Valid Values: `true` \| `false`
5768
5855
  #
5769
5856
  # @option params [Boolean] :requester_pays
5770
5857
  # A value that sets who pays the cost of the request and the cost
5771
5858
  # associated with data download from the S3 bucket. If this value is set
5772
- # to true, the requester pays the costs. Otherwise the S3 bucket owner
5773
- # pays. However, the S3 bucket owner always pays the cost of storing
5774
- # data.
5859
+ # to `true`, the requester pays the costs; otherwise, the S3 bucket
5860
+ # owner pays. However, the S3 bucket owner always pays the cost of
5861
+ # storing data.
5775
5862
  #
5776
5863
  # <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
5777
5864
  # file share, so make sure that the configuration on the file share is
@@ -5779,25 +5866,33 @@ module Aws::StorageGateway
5779
5866
  #
5780
5867
  # </note>
5781
5868
  #
5869
+ # Valid Values: `true` \| `false`
5870
+ #
5782
5871
  # @option params [Boolean] :smbacl_enabled
5783
- # Set this value to "true to enable ACL (access control list) on the
5784
- # SMB file share. Set it to "false" to map file and directory
5872
+ # Set this value to `true` to enable access control list (ACL) on the
5873
+ # SMB file share. Set it to `false` to map file and directory
5785
5874
  # permissions to the POSIX permissions.
5786
5875
  #
5787
- # For more information, see
5788
- # https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.htmlin
5789
- # the Storage Gateway User Guide.
5876
+ # For more information, see [Using Microsoft Windows ACLs to control
5877
+ # access to an SMB file share][1] in the *AWS Storage Gateway User
5878
+ # Guide*.
5879
+ #
5880
+ # Valid Values: `true` \| `false`
5881
+ #
5882
+ #
5883
+ #
5884
+ # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
5790
5885
  #
5791
5886
  # @option params [Array<String>] :admin_user_list
5792
5887
  # A list of users in the Active Directory that have administrator rights
5793
5888
  # to the file share. A group must be prefixed with the @ character. For
5794
- # example `@group1`. Can only be set if Authentication is set to
5889
+ # example, `@group1`. Can only be set if Authentication is set to
5795
5890
  # `ActiveDirectory`.
5796
5891
  #
5797
5892
  # @option params [Array<String>] :valid_user_list
5798
5893
  # A list of users or groups in the Active Directory that are allowed to
5799
5894
  # access the file share. A group must be prefixed with the @ character.
5800
- # For example `@group1`. Can only be set if Authentication is set to
5895
+ # For example, `@group1`. Can only be set if Authentication is set to
5801
5896
  # `ActiveDirectory`.
5802
5897
  #
5803
5898
  # @option params [Array<String>] :invalid_user_list
@@ -6003,7 +6098,7 @@ module Aws::StorageGateway
6003
6098
  # @option params [required, String] :device_type
6004
6099
  # The type of medium changer you want to select.
6005
6100
  #
6006
- # Valid Values: "STK-L700", "AWS-Gateway-VTL"
6101
+ # Valid Values: `STK-L700` \| `AWS-Gateway-VTL`
6007
6102
  #
6008
6103
  # @return [Types::UpdateVTLDeviceTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6009
6104
  #
@@ -6057,7 +6152,7 @@ module Aws::StorageGateway
6057
6152
  params: params,
6058
6153
  config: config)
6059
6154
  context[:gem_name] = 'aws-sdk-storagegateway'
6060
- context[:gem_version] = '1.39.0'
6155
+ context[:gem_version] = '1.44.0'
6061
6156
  Seahorse::Client::Request.new(handlers, context)
6062
6157
  end
6063
6158