aws-sdk-storagegateway 1.42.1 → 1.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11c17ff9df661fa81c697645f68eae6a17888414d5548c2b56b85ae582e82c56
-  data.tar.gz: 3854e6f2b126eb667b76bb40d84ad29df0e29f7454d7680f746ab69175a018c7
+  metadata.gz: 1ad78eee66ee3ffcd55e69eed29c73d23c0ace6d1d7d8349c42d89470ebb6a4f
+  data.tar.gz: cf7b2b3b56f11375dd9fc74ee40855d81f7ec299f615df0346da88d6b1ae192c
 SHA512:
-  metadata.gz: 6caa37736a42e977b2b336a60317c306d507727fe057c2584d2315a742344e7d04a8afc3171a65d56c1ec8c6a90b9857cdbbbd32329d571f1c5d79863114f805
-  data.tar.gz: ad06c77ab2d773895e737b9c086d0c6245aa849960553004c9d6c028ec42b6846defa34927961091f3811fb7f97fbcd64eae8582a915304715f7f6bea555de92
+  metadata.gz: db52d9da9c84e28ba2349b9c34f9483ece3861ce600418022e9875054a171991f38280a686b3f20d38be11f476a9150d6f6b10b4ef78fa501e01804fe9c661fe
+  data.tar.gz: ac06897cf67cd637281e04e99e24d7df6df687e968e1a31ccb864d4aa39fdb95ad62cb0abab18eb35037ea919d02048b5ba83c7dc6958fc8d0602fa151028797

data/lib/aws-sdk-storagegateway.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-storagegateway/customizations'
 # @service
 module Aws::StorageGateway
 
-  GEM_VERSION = '1.42.1'
+  GEM_VERSION = '1.47.0'
 
 end

data/lib/aws-sdk-storagegateway/client.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -325,7 +327,7 @@ module Aws::StorageGateway
     # that you want to use for storing snapshots or tapes, the time zone for
     # scheduled snapshots the gateway snapshot schedule window, an
     # activation key, and a name for your gateway. The activation process
-    # also associates your gateway with your account; for more information,
+    # also associates your gateway with your account. For more information,
     # see UpdateGatewayInformation.
     #
     # <note markdown="1"> You must turn on the gateway VM before you can activate your gateway.
@@ -342,9 +344,12 @@ module Aws::StorageGateway
     #   pass to the `ActivateGateway` API call determine the actual
     #   configuration of your gateway.
     #
-    #   For more information, see
-    #   https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html
-    #   in the Storage Gateway User Guide.
+    #   For more information, see [Getting activation key][1] in the *AWS
+    #   Storage Gateway User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html
     #
     # @option params [required, String] :gateway_name
     #   The name you configured for your gateway.
@@ -362,34 +367,34 @@ module Aws::StorageGateway
     #   data. The gateway AWS Region specified must be the same AWS Region as
     #   the AWS Region in your `Host` header in the request. For more
     #   information about available AWS Regions and endpoints for AWS Storage
-    #   Gateway, see [Regions and Endpoints][1] in the *Amazon Web Services
-    #   Glossary*.
+    #   Gateway, see [AWS Storage Gateway endpoints and quotas][1] in the *AWS
+    #   General Reference*.
     #
-    #   Valid Values: See [AWS Storage Gateway Regions and Endpoints][1] in
-    #   the AWS General Reference.
+    #   Valid Values: See [AWS Storage Gateway endpoints and quotas][1] in the
+    #   *AWS General Reference*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#sg_region
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/sg.html
     #
     # @option params [String] :gateway_type
     #   A value that defines the type of gateway to activate. The type
     #   specified is critical to all later functions of the gateway and cannot
     #   be changed after activation. The default value is `CACHED`.
     #
-    #   Valid Values: "STORED", "CACHED", "VTL", "FILE\_S3"
+    #   Valid Values: `STORED` \| `CACHED` \| `VTL` \| `FILE_S3`
     #
     # @option params [String] :tape_drive_type
     #   The value that indicates the type of tape drive to use for tape
     #   gateway. This field is optional.
     #
-    #   Valid Values: "IBM-ULT3580-TD5"
+    #   Valid Values: `IBM-ULT3580-TD5`
     #
     # @option params [String] :medium_changer_type
     #   The value that indicates the type of medium changer to use for tape
     #   gateway. This field is optional.
     #
-    #   Valid Values: "STK-L700", "AWS-Gateway-VTL"
+    #   Valid Values: `STK-L700` \| `AWS-Gateway-VTL` \| `IBM-03584L32-0402`
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that you can assign to the gateway. Each tag
@@ -459,8 +464,8 @@ module Aws::StorageGateway
     end
 
     # Configures one or more gateway local disks as cache for a gateway.
-    # This operation is only supported in the cached volume, tape and file
-    # gateway type (see [Storage Gateway Concepts][1]).
+    # This operation is only supported in the cached volume, tape, and file
+    # gateway type (see [How AWS Storage Gateway works (architecture)][1].
     #
     # In the request, you specify the gateway Amazon Resource Name (ARN) to
     # which you want to add cache, and one or more disk IDs that you want to
@@ -739,7 +744,7 @@ module Aws::StorageGateway
     # is archived directly into the S3 storage class (S3 Glacier or S3
     # Glacier Deep Archive) that corresponds to the pool.
     #
-    # Valid values: "GLACIER", "DEEP\_ARCHIVE"
+    # Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
     #
     # @option params [required, String] :tape_arn
     #   The unique Amazon Resource Name (ARN) of the virtual tape that you
@@ -752,7 +757,17 @@ module Aws::StorageGateway
     #   eject the tape, the tape is archived directly into the storage class
     #   (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
     #
-    #   Valid values: "GLACIER", "DEEP\_ARCHIVE"
+    #   Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
+    #
+    # @option params [Boolean] :bypass_governance_retention
+    #   Set permissions to bypass governance retention. If the lock type of
+    #   the archived tape is `Governance`, the tape's archived age is not
+    #   older than `RetentionLockInDays`, and the user does not already have
+    #   `BypassGovernanceRetention`, setting this to TRUE enables the user to
+    #   bypass the retention lock. This parameter is set to true by default
+    #   for calls from the console.
+    #
+    #   Valid values: `TRUE` \| `FALSE`
     #
     # @return [Types::AssignTapePoolOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -763,6 +778,7 @@ module Aws::StorageGateway
     #   resp = client.assign_tape_pool({
     #     tape_arn: "TapeARN", # required
     #     pool_id: "PoolId", # required
+    #     bypass_governance_retention: false,
     #   })
     #
     # @example Response structure
@@ -983,7 +999,7 @@ module Aws::StorageGateway
     # @option params [String] :snapshot_id
     #   The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as
     #   the new cached volume. Specify this field if you want to create the
-    #   iSCSI storage volume from a snapshot otherwise do not include this
+    #   iSCSI storage volume from a snapshot; otherwise, do not include this
     #   field. To list snapshots for your account use [DescribeSnapshots][1]
     #   in the *Amazon Elastic Compute Cloud API Reference*.
     #
@@ -1021,13 +1037,16 @@ module Aws::StorageGateway
     #   request.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that you can assign to a cached volume. Each
@@ -1110,13 +1129,17 @@ module Aws::StorageGateway
     # activated to enable you to create a file share. Make sure AWS STS is
     # activated in the AWS Region you are creating your file gateway in. If
     # AWS STS is not activated in the AWS Region, activate it. For
-    # information about how to activate AWS STS, see Activating and
-    # Deactivating AWS STS in an AWS Region in the AWS Identity and Access
-    # Management User Guide.
+    # information about how to activate AWS STS, see [Activating and
+    # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
+    # Access Management User Guide*.
     #
     #  File gateway does not support creating hard or symbolic links on a
     # file share.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html
+    #
     # @option params [required, String] :client_token
     #   A unique string value that you supply that is used by file gateway to
     #   ensure idempotent file share creation.
@@ -1129,61 +1152,72 @@ module Aws::StorageGateway
     #   to create a file share.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [required, String] :role
     #   The ARN of the AWS Identity and Access Management (IAM) role that a
     #   file gateway assumes when it accesses the underlying storage.
     #
     # @option params [required, String] :location_arn
-    #   The ARN of the backed storage used for storing file data.
+    #   The ARN of the backend storage used for storing file data. A prefix
+    #   name can be added to the S3 bucket name. It must end with a "/".
     #
     # @option params [String] :default_storage_class
     #   The default storage class for objects put into an Amazon S3 bucket by
-    #   the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
-    #   or `S3_ONEZONE_IA`. If this field is not populated, the default value
-    #   `S3_STANDARD` is used. Optional.
+    #   the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
+    #   Optional.
+    #
+    #   Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
+    #   `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
     #
     # @option params [String] :object_acl
-    #   A value that sets the access control list permission for objects in
-    #   the S3 bucket that a file gateway puts objects into. The default value
-    #   is "private".
+    #   A value that sets the access control list (ACL) permission for objects
+    #   in the S3 bucket that a file gateway puts objects into. The default
+    #   value is `private`.
     #
     # @option params [Array<String>] :client_list
     #   The list of clients that are allowed to access the file gateway. The
     #   list must contain either valid IP addresses or valid CIDR blocks.
     #
     # @option params [String] :squash
-    #   A value that maps a user to anonymous user. Valid options are the
-    #   following:
+    #   A value that maps a user to anonymous user.
     #
-    #   * `RootSquash` - Only root is mapped to anonymous user.
+    #   Valid values are the following:
     #
-    #   * `NoSquash` - No one is mapped to anonymous user
+    #   * `RootSquash`\: Only root is mapped to anonymous user.
     #
-    #   * `AllSquash` - Everyone is mapped to anonymous user.
+    #   * `NoSquash`\: No one is mapped to anonymous user.
+    #
+    #   * `AllSquash`\: Everyone is mapped to anonymous user.
     #
     # @option params [Boolean] :read_only
-    #   A value that sets the write status of a file share. This value is true
-    #   if the write status is read-only, and otherwise false.
+    #   A value that sets the write status of a file share. Set this value to
+    #   `true` to set the write status to read-only, otherwise set to `false`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :guess_mime_type_enabled
     #   A value that enables guessing of the MIME type for uploaded objects
-    #   based on file extensions. Set this value to true to enable MIME type
-    #   guessing, and otherwise to false. The default value is true.
+    #   based on file extensions. Set this value to `true` to enable MIME type
+    #   guessing, otherwise set to `false`. The default value is `true`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :requester_pays
     #   A value that sets who pays the cost of the request and the cost
     #   associated with data download from the S3 bucket. If this value is set
-    #   to true, the requester pays the costs. Otherwise the S3 bucket owner
-    #   pays. However, the S3 bucket owner always pays the cost of storing
-    #   data.
+    #   to `true`, the requester pays the costs; otherwise, the S3 bucket
+    #   owner pays. However, the S3 bucket owner always pays the cost of
+    #   storing data.
     #
     #   <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
     #   file share, so make sure that the configuration on the file share is
@@ -1191,6 +1225,8 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    #   Valid Values: `true` \| `false`
+    #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to the NFS file share.
     #   Each tag is a key-value pair.
@@ -1202,6 +1238,17 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    # @option params [String] :file_share_name
+    #   The name of the file share. Optional.
+    #
+    #   <note markdown="1"> `FileShareName` must be set if an S3 prefix name is set in
+    #   `LocationARN`.
+    #
+    #    </note>
+    #
+    # @option params [Types::CacheAttributes] :cache_attributes
+    #   Refresh cache information.
+    #
     # @return [Types::CreateNFSFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateNFSFileShareOutput#file_share_arn #file_share_arn} => String
@@ -1234,6 +1281,10 @@ module Aws::StorageGateway
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     file_share_name: "FileShareName",
+    #     cache_attributes: {
+    #       cache_stale_timeout_in_seconds: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -1251,7 +1302,7 @@ module Aws::StorageGateway
 
     # Creates a Server Message Block (SMB) file share on an existing file
     # gateway. In Storage Gateway, a file share is a file system mount point
-    # backed by Amazon S3 cloud storage. Storage Gateway expose file shares
+    # backed by Amazon S3 cloud storage. Storage Gateway exposes file shares
     # using an SMB interface. This operation is only supported for file
     # gateways.
     #
@@ -1260,8 +1311,8 @@ module Aws::StorageGateway
     # is activated in the AWS Region you are creating your file gateway in.
     # If AWS STS is not activated in this AWS Region, activate it. For
     # information about how to activate AWS STS, see [Activating and
-    # Deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
-    # Access Management User Guide.*
+    # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
+    # Access Management User Guide*.
     #
     #  File gateways don't support creating hard or symbolic links on a
     # file
@@ -1279,47 +1330,57 @@ module Aws::StorageGateway
     #   The ARN of the file gateway on which you want to create a file share.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [required, String] :role
     #   The ARN of the AWS Identity and Access Management (IAM) role that a
     #   file gateway assumes when it accesses the underlying storage.
     #
     # @option params [required, String] :location_arn
-    #   The ARN of the backed storage used for storing file data.
+    #   The ARN of the backend storage used for storing file data. A prefix
+    #   name can be added to the S3 bucket name. It must end with a "/".
     #
     # @option params [String] :default_storage_class
     #   The default storage class for objects put into an Amazon S3 bucket by
-    #   the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
-    #   or `S3_ONEZONE_IA`. If this field is not populated, the default value
-    #   `S3_STANDARD` is used. Optional.
+    #   the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
+    #   Optional.
+    #
+    #   Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
+    #   `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
     #
     # @option params [String] :object_acl
-    #   A value that sets the access control list permission for objects in
-    #   the S3 bucket that a file gateway puts objects into. The default value
-    #   is "private".
+    #   A value that sets the access control list (ACL) permission for objects
+    #   in the S3 bucket that a file gateway puts objects into. The default
+    #   value is `private`.
     #
     # @option params [Boolean] :read_only
-    #   A value that sets the write status of a file share. This value is true
-    #   if the write status is read-only, and otherwise false.
+    #   A value that sets the write status of a file share. Set this value to
+    #   `true` to set the write status to read-only, otherwise set to `false`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :guess_mime_type_enabled
     #   A value that enables guessing of the MIME type for uploaded objects
-    #   based on file extensions. Set this value to true to enable MIME type
-    #   guessing, and otherwise to false. The default value is true.
+    #   based on file extensions. Set this value to `true` to enable MIME type
+    #   guessing, otherwise set to `false`. The default value is `true`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :requester_pays
     #   A value that sets who pays the cost of the request and the cost
     #   associated with data download from the S3 bucket. If this value is set
-    #   to true, the requester pays the costs. Otherwise the S3 bucket owner
-    #   pays. However, the S3 bucket owner always pays the cost of storing
-    #   data.
+    #   to `true`, the requester pays the costs; otherwise, the S3 bucket
+    #   owner pays. However, the S3 bucket owner always pays the cost of
+    #   storing data.
     #
     #   <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
     #   file share, so make sure that the configuration on the file share is
@@ -1327,43 +1388,60 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    #   Valid Values: `true` \| `false`
+    #
     # @option params [Boolean] :smbacl_enabled
-    #   Set this value to "true to enable ACL (access control list) on the
-    #   SMB file share. Set it to "false" to map file and directory
+    #   Set this value to `true` to enable access control list (ACL) on the
+    #   SMB file share. Set it to `false` to map file and directory
     #   permissions to the POSIX permissions.
     #
-    #   For more information, see
-    #   https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
-    #   in the Storage Gateway User Guide.
+    #   For more information, see [Using Microsoft Windows ACLs to control
+    #   access to an SMB file share][1] in the *AWS Storage Gateway User
+    #   Guide*.
+    #
+    #   Valid Values: `true` \| `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
     #
     # @option params [Array<String>] :admin_user_list
-    #   A list of users in the Active Directory that will be granted
+    #   A list of users or groups in the Active Directory that will be granted
     #   administrator privileges on the file share. These users can do all
-    #   file operations as the super-user.
+    #   file operations as the super-user. Acceptable formats include:
+    #   `DOMAIN\User1`, `user1`, `@group1`, and `@DOMAIN\group1`.
     #
     #   Use this option very carefully, because any user in this list can do
     #   anything they like on the file share, regardless of file permissions.
     #
     # @option params [Array<String>] :valid_user_list
     #   A list of users or groups in the Active Directory that are allowed to
-    #   access the file share. A group must be prefixed with the @ character.
-    #   For example `@group1`. Can only be set if Authentication is set to
-    #   `ActiveDirectory`.
+    #   access the file []() share. A group must be prefixed with the @
+    #   character. Acceptable formats include: `DOMAIN\User1`, `user1`,
+    #   `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is
+    #   set to `ActiveDirectory`.
     #
     # @option params [Array<String>] :invalid_user_list
     #   A list of users or groups in the Active Directory that are not allowed
     #   to access the file share. A group must be prefixed with the @
-    #   character. For example, `@group1`. Can only be set if Authentication
-    #   is set to `ActiveDirectory`.
+    #   character. Acceptable formats include: `DOMAIN\User1`, `user1`,
+    #   `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is
+    #   set to `ActiveDirectory`.
     #
     # @option params [String] :audit_destination_arn
     #   The Amazon Resource Name (ARN) of the storage used for the audit logs.
     #
     # @option params [String] :authentication
-    #   The authentication method that users use to access the file share.
+    #   The authentication method that users use to access the file share. The
+    #   default is `ActiveDirectory`.
     #
-    #   Valid values are `ActiveDirectory` or `GuestAccess`. The default is
-    #   `ActiveDirectory`.
+    #   Valid Values: `ActiveDirectory` \| `GuestAccess`
+    #
+    # @option params [String] :case_sensitivity
+    #   The case of an object name in an Amazon S3 bucket. For
+    #   `ClientSpecified`, the client determines the case sensitivity. For
+    #   `CaseSensitive`, the gateway determines the case sensitivity. The
+    #   default value is `ClientSpecified`.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to the NFS file share.
@@ -1376,6 +1454,17 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    # @option params [String] :file_share_name
+    #   The name of the file share. Optional.
+    #
+    #   <note markdown="1"> `FileShareName` must be set if an S3 prefix name is set in
+    #   `LocationARN`.
+    #
+    #    </note>
+    #
+    # @option params [Types::CacheAttributes] :cache_attributes
+    #   Refresh cache information.
+    #
     # @return [Types::CreateSMBFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateSMBFileShareOutput#file_share_arn #file_share_arn} => String
@@ -1400,12 +1489,17 @@ module Aws::StorageGateway
     #     invalid_user_list: ["FileShareUser"],
     #     audit_destination_arn: "AuditDestinationARN",
     #     authentication: "Authentication",
+    #     case_sensitivity: "ClientSpecified", # accepts ClientSpecified, CaseSensitive
     #     tags: [
     #       {
     #         key: "TagKey", # required
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     file_share_name: "FileShareName",
+    #     cache_attributes: {
+    #       cache_stale_timeout_in_seconds: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -1424,37 +1518,38 @@ module Aws::StorageGateway
     # Initiates a snapshot of a volume.
     #
     # AWS Storage Gateway provides the ability to back up point-in-time
-    # snapshots of your data to Amazon Simple Storage Service (Amazon S3)
-    # for durable off-site recovery, as well as import the data to an Amazon
+    # snapshots of your data to Amazon Simple Storage (Amazon S3) for
+    # durable off-site recovery, as well as import the data to an Amazon
     # Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud
     # (EC2). You can take snapshots of your gateway volume on a scheduled or
     # ad hoc basis. This API enables you to take an ad hoc snapshot. For
-    # more information, see [Editing a Snapshot Schedule][1].
+    # more information, see [Editing a snapshot schedule][1].
     #
-    # In the CreateSnapshot request you identify the volume by providing its
-    # Amazon Resource Name (ARN). You must also provide description for the
-    # snapshot. When AWS Storage Gateway takes the snapshot of specified
+    # In the `CreateSnapshot` request, you identify the volume by providing
+    # its Amazon Resource Name (ARN). You must also provide description for
+    # the snapshot. When AWS Storage Gateway takes the snapshot of specified
     # volume, the snapshot and description appears in the AWS Storage
-    # Gateway Console. In response, AWS Storage Gateway returns you a
+    # Gateway console. In response, AWS Storage Gateway returns you a
     # snapshot ID. You can use this snapshot ID to check the snapshot
     # progress or later use it when you want to create a volume from a
     # snapshot. This operation is only supported in stored and cached volume
     # gateway type.
     #
     # <note markdown="1"> To list or delete a snapshot, you must use the Amazon EC2 API. For
-    # more information, see DescribeSnapshots or DeleteSnapshot in the [EC2
-    # API reference][2].
+    # more information, see [DescribeSnapshots][2] or [DeleteSnapshot][3] in
+    # the *Amazon Elastic Compute Cloud API Reference*.
     #
     #  </note>
     #
     # Volume and snapshot IDs are changing to a longer length ID format. For
-    # more information, see the important note on the [Welcome][3] page.
+    # more information, see the important note on the [Welcome][4] page.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/managing-volumes.html#SchedulingSnapshot
-    # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Operations.html
-    # [3]: https://docs.aws.amazon.com/storagegateway/latest/APIReference/Welcome.html
+    # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
+    # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSnapshot.html
+    # [4]: https://docs.aws.amazon.com/storagegateway/latest/APIReference/Welcome.html
     #
     # @option params [required, String] :volume_arn
     #   The Amazon Resource Name (ARN) of the volume. Use the ListVolumes
@@ -1464,7 +1559,7 @@ module Aws::StorageGateway
     #   Textual description of the snapshot that appears in the Amazon EC2
     #   console, Elastic Block Store snapshots panel in the **Description**
     #   field, and in the AWS Storage Gateway snapshot **Details** pane,
-    #   **Description** field
+    #   **Description** field.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to a snapshot. Each tag
@@ -1543,10 +1638,16 @@ module Aws::StorageGateway
     # from a snapshot.
     #
     # <note markdown="1"> To list or delete a snapshot, you must use the Amazon EC2 API. For
-    # more information, in *Amazon Elastic Compute Cloud API Reference*.
+    # more information, see [DescribeSnapshots][1] or [DeleteSnapshot][2] in
+    # the *Amazon Elastic Compute Cloud API Reference*.
     #
     #  </note>
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
+    # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSnapshot.html
+    #
     # @option params [required, String] :volume_arn
     #   The Amazon Resource Name (ARN) of the iSCSI volume target. Use the
     #   DescribeStorediSCSIVolumes operation to return to retrieve the
@@ -1556,7 +1657,7 @@ module Aws::StorageGateway
     #   Textual description of the snapshot that appears in the Amazon EC2
     #   console, Elastic Block Store snapshots panel in the **Description**
     #   field, and in the AWS Storage Gateway snapshot **Details** pane,
-    #   **Description** field
+    #   **Description** field.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to a snapshot. Each tag
@@ -1629,7 +1730,7 @@ module Aws::StorageGateway
     # create an empty gateway volume, then any existing data on the disk is
     # erased.
     #
-    # In the request you must specify the gateway and the disk information
+    # In the request, you must specify the gateway and the disk information
     # on which you are creating the volume. In response, the gateway creates
     # the volume and returns volume information such as the volume Amazon
     # Resource Name (ARN), its size, and the iSCSI target ARN that
@@ -1652,7 +1753,7 @@ module Aws::StorageGateway
     # @option params [String] :snapshot_id
     #   The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as
     #   the new stored volume. Specify this field if you want to create the
-    #   iSCSI storage volume from a snapshot otherwise do not include this
+    #   iSCSI storage volume from a snapshot; otherwise, do not include this
     #   field. To list snapshots for your account use [DescribeSnapshots][1]
     #   in the *Amazon Elastic Compute Cloud API Reference*.
     #
@@ -1661,11 +1762,10 @@ module Aws::StorageGateway
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html
     #
     # @option params [required, Boolean] :preserve_existing_data
-    #   Specify this field as true if you want to preserve the data on the
-    #   local disk. Otherwise, specifying this field as false creates an empty
-    #   volume.
+    #   Set to true `true` if you want to preserve the data on the local disk.
+    #   Otherwise, set to `false` to create an empty volume.
     #
-    #   Valid Values: true, false
+    #   Valid Values: `true` \| `false`
     #
     # @option params [required, String] :target_name
     #   The name of the iSCSI target used by an initiator to connect to a
@@ -1686,13 +1786,16 @@ module Aws::StorageGateway
     #   Valid Values: A valid IP address.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to a stored volume. Each
@@ -1766,6 +1869,72 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Creates a new custom tape pool. You can use custom tape pool to enable
+    # tape retention lock on tapes that are archived in the custom pool.
+    #
+    # @option params [required, String] :pool_name
+    #   The name of the new custom tape pool.
+    #
+    # @option params [required, String] :storage_class
+    #   The storage class that is associated with the new custom pool. When
+    #   you use your backup application to eject the tape, the tape is
+    #   archived directly into the storage class (S3 Glacier or S3 Glacier
+    #   Deep Archive) that corresponds to the pool.
+    #
+    # @option params [String] :retention_lock_type
+    #   Tape retention lock can be configured in two modes. When configured in
+    #   governance mode, AWS accounts with specific IAM permissions are
+    #   authorized to remove the tape retention lock from archived virtual
+    #   tapes. When configured in compliance mode, the tape retention lock
+    #   cannot be removed by any user, including the root AWS account.
+    #
+    # @option params [Integer] :retention_lock_time_in_days
+    #   Tape retention lock time is set in days. Tape retention lock can be
+    #   enabled for up to 100 years (36,500 days).
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of up to 50 tags that can be assigned to tape pool. Each tag is
+    #   a key-value pair.
+    #
+    #   <note markdown="1"> Valid characters for key and value are letters, spaces, and numbers
+    #   representable in UTF-8 format, and the following special characters: +
+    #   - = . \_ : / @. The maximum length of a tag's key is 128 characters,
+    #   and the maximum length for a tag's value is 256.
+    #
+    #    </note>
+    #
+    # @return [Types::CreateTapePoolOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateTapePoolOutput#pool_arn #pool_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_tape_pool({
+    #     pool_name: "PoolName", # required
+    #     storage_class: "DEEP_ARCHIVE", # required, accepts DEEP_ARCHIVE, GLACIER
+    #     retention_lock_type: "COMPLIANCE", # accepts COMPLIANCE, GOVERNANCE, NONE
+    #     retention_lock_time_in_days: 1,
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.pool_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateTapePool AWS API Documentation
+    #
+    # @overload create_tape_pool(params = {})
+    # @param [Hash] params ({})
+    def create_tape_pool(params = {}, options = {})
+      req = build_request(:create_tape_pool, params)
+      req.send_request(options)
+    end
+
     # Creates a virtual tape by using your own barcode. You write data to
     # the virtual tape and then archive the tape. A barcode is unique and
     # cannot be reused if it has already been used on a tape. This applies
@@ -1799,22 +1968,29 @@ module Aws::StorageGateway
     #    </note>
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [String] :pool_id
     #   The ID of the pool that you want to add your tape to for archiving.
     #   The tape in this pool is archived in the S3 storage class that is
     #   associated with the pool. When you use your backup application to
     #   eject the tape, the tape is archived directly into the storage class
-    #   (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
+    #   (S3 Glacier or S3 Deep Archive) that corresponds to the pool.
+    #
+    #   Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
     #
-    #   Valid values: "GLACIER", "DEEP\_ARCHIVE"
+    # @option params [Boolean] :worm
+    #   Set to `TRUE` if the tape you are creating is to be configured as a
+    #   write-once-read-many (WORM) tape.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to a virtual tape that
@@ -1856,6 +2032,7 @@ module Aws::StorageGateway
     #     kms_encrypted: false,
     #     kms_key: "KMSKey",
     #     pool_id: "PoolId",
+    #     worm: false,
     #     tags: [
     #       {
     #         key: "TagKey", # required
@@ -1922,13 +2099,16 @@ module Aws::StorageGateway
     #    </note>
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [String] :pool_id
     #   The ID of the pool that you want to add your tape to for archiving.
@@ -1937,7 +2117,11 @@ module Aws::StorageGateway
     #   eject the tape, the tape is archived directly into the storage class
     #   (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
     #
-    #   Valid values: "GLACIER", "DEEP\_ARCHIVE"
+    #   Valid Values: `GLACIER` \| `DEEP_ARCHIVE`
+    #
+    # @option params [Boolean] :worm
+    #   Set to `TRUE` if the tape you are creating is to be configured as a
+    #   write-once-read-many (WORM) tape.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of up to 50 tags that can be assigned to a virtual tape. Each
@@ -1987,6 +2171,7 @@ module Aws::StorageGateway
     #     kms_encrypted: false,
     #     kms_key: "KMSKey",
     #     pool_id: "PoolId",
+    #     worm: false,
     #     tags: [
     #       {
     #         key: "TagKey", # required
@@ -2058,7 +2243,7 @@ module Aws::StorageGateway
     #   One of the BandwidthType values that indicates the gateway bandwidth
     #   rate limit to delete.
     #
-    #   Valid Values: `Upload`, `Download`, `All`.
+    #   Valid Values: `UPLOAD` \| `DOWNLOAD` \| `ALL`
     #
     # @return [Types::DeleteBandwidthRateLimitOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2160,11 +2345,13 @@ module Aws::StorageGateway
     #   The Amazon Resource Name (ARN) of the file share to be deleted.
     #
     # @option params [Boolean] :force_delete
-    #   If this value is set to true, the operation deletes a file share
+    #   If this value is set to `true`, the operation deletes a file share
     #   immediately and aborts all data uploads to AWS. Otherwise, the file
     #   share is not deleted until all data is uploaded to AWS. This process
     #   aborts the data upload process, and the file share enters the
-    #   FORCE\_DELETING status.
+    #   `FORCE_DELETING` status.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @return [Types::DeleteFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2207,8 +2394,8 @@ module Aws::StorageGateway
     # all remaining Amazon EBS snapshots by canceling your Amazon EC2
     # subscription.  If you prefer not to cancel your Amazon EC2
     # subscription, you can delete your snapshots using the Amazon EC2
-    # console. For more information, see the [ AWS Storage Gateway Detail
-    # Page][1].
+    # console. For more information, see the [AWS Storage Gateway detail
+    # page][1].
     #
     #
     #
@@ -2260,7 +2447,7 @@ module Aws::StorageGateway
     #
     # You can take snapshots of your gateway volumes on a scheduled or ad
     # hoc basis. This API action enables you to delete a snapshot schedule
-    # for a volume. For more information, see [Working with Snapshots][1].
+    # for a volume. For more information, see [Backing up your volumes][1].
     # In the `DeleteSnapshotSchedule` request, you identify the volume by
     # providing its Amazon Resource Name (ARN). This operation is only
     # supported in stored and cached volume gateway types.
@@ -2273,7 +2460,7 @@ module Aws::StorageGateway
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/WorkingWithSnapshots.html
+    # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/backing-up-volumes.html
     # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html
     #
     # @option params [required, String] :volume_arn
@@ -2327,6 +2514,12 @@ module Aws::StorageGateway
     # @option params [required, String] :tape_arn
     #   The Amazon Resource Name (ARN) of the virtual tape to delete.
     #
+    # @option params [Boolean] :bypass_governance_retention
+    #   Set to `TRUE` to delete an archived tape that belongs to a custom pool
+    #   with tape retention lock. Only archived tapes with tape retention lock
+    #   set to `governance` can be deleted. Archived tapes with tape retention
+    #   lock set to `compliance` can't be deleted.
+    #
     # @return [Types::DeleteTapeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteTapeOutput#tape_arn #tape_arn} => String
@@ -2351,6 +2544,7 @@ module Aws::StorageGateway
     #   resp = client.delete_tape({
     #     gateway_arn: "GatewayARN", # required
     #     tape_arn: "TapeARN", # required
+    #     bypass_governance_retention: false,
     #   })
     #
     # @example Response structure
@@ -2373,6 +2567,12 @@ module Aws::StorageGateway
     #   The Amazon Resource Name (ARN) of the virtual tape to delete from the
     #   virtual tape shelf (VTS).
     #
+    # @option params [Boolean] :bypass_governance_retention
+    #   Set to `TRUE` to delete an archived tape that belongs to a custom pool
+    #   with tape retention lock. Only archived tapes with tape retention lock
+    #   set to `governance` can be deleted. Archived tapes with tape retention
+    #   lock set to `compliance` can't be deleted.
+    #
     # @return [Types::DeleteTapeArchiveOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteTapeArchiveOutput#tape_arn #tape_arn} => String
@@ -2395,6 +2595,7 @@ module Aws::StorageGateway
     #
     #   resp = client.delete_tape_archive({
     #     tape_arn: "TapeARN", # required
+    #     bypass_governance_retention: false,
     #   })
     #
     # @example Response structure
@@ -2410,6 +2611,36 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Delete a custom tape pool. A custom tape pool can only be deleted if
+    # there are no tapes in the pool and if there are no automatic tape
+    # creation policies that reference the custom tape pool.
+    #
+    # @option params [required, String] :pool_arn
+    #   The Amazon Resource Name (ARN) of the custom tape pool to delete.
+    #
+    # @return [Types::DeleteTapePoolOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteTapePoolOutput#pool_arn #pool_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_tape_pool({
+    #     pool_arn: "PoolARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.pool_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapePool AWS API Documentation
+    #
+    # @overload delete_tape_pool(params = {})
+    # @param [Hash] params ({})
+    def delete_tape_pool(params = {}, options = {})
+      req = build_request(:delete_tape_pool, params)
+      req.send_request(options)
+    end
+
     # Deletes the specified storage volume that you previously created using
     # the CreateCachediSCSIVolume or CreateStorediSCSIVolume API. This
     # operation is only supported in the cached volume and stored volume
@@ -2513,7 +2744,7 @@ module Aws::StorageGateway
     # Returns the bandwidth rate limits of a gateway. By default, these
     # limits are not set, which means no bandwidth rate limiting is in
     # effect. This operation is supported for the stored volume, cached
-    # volume and tape gateway types.'
+    # volume, and tape gateway types.
     #
     # This operation only returns a value for a bandwidth rate limit only if
     # the limit is set. If no limits are set for the gateway, then this
@@ -2809,6 +3040,9 @@ module Aws::StorageGateway
     #   * {Types::DescribeGatewayInformationOutput#vpc_endpoint #vpc_endpoint} => String
     #   * {Types::DescribeGatewayInformationOutput#cloud_watch_log_group_arn #cloud_watch_log_group_arn} => String
     #   * {Types::DescribeGatewayInformationOutput#host_environment #host_environment} => String
+    #   * {Types::DescribeGatewayInformationOutput#endpoint_type #endpoint_type} => String
+    #   * {Types::DescribeGatewayInformationOutput#software_updates_end_date #software_updates_end_date} => String
+    #   * {Types::DescribeGatewayInformationOutput#deprecation_date #deprecation_date} => String
     #
     #
     # @example Example: To describe metadata about the gateway
@@ -2865,6 +3099,9 @@ module Aws::StorageGateway
     #   resp.vpc_endpoint #=> String
     #   resp.cloud_watch_log_group_arn #=> String
     #   resp.host_environment #=> String, one of "VMWARE", "HYPER-V", "EC2", "KVM", "OTHER"
+    #   resp.endpoint_type #=> String
+    #   resp.software_updates_end_date #=> String
+    #   resp.deprecation_date #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeGatewayInformation AWS API Documentation
     #
@@ -2980,6 +3217,8 @@ module Aws::StorageGateway
     #   resp.nfs_file_share_info_list[0].tags #=> Array
     #   resp.nfs_file_share_info_list[0].tags[0].key #=> String
     #   resp.nfs_file_share_info_list[0].tags[0].value #=> String
+    #   resp.nfs_file_share_info_list[0].file_share_name #=> String
+    #   resp.nfs_file_share_info_list[0].cache_attributes.cache_stale_timeout_in_seconds #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeNFSFileShares AWS API Documentation
     #
@@ -3034,9 +3273,12 @@ module Aws::StorageGateway
     #   resp.smb_file_share_info_list[0].invalid_user_list[0] #=> String
     #   resp.smb_file_share_info_list[0].audit_destination_arn #=> String
     #   resp.smb_file_share_info_list[0].authentication #=> String
+    #   resp.smb_file_share_info_list[0].case_sensitivity #=> String, one of "ClientSpecified", "CaseSensitive"
     #   resp.smb_file_share_info_list[0].tags #=> Array
     #   resp.smb_file_share_info_list[0].tags[0].key #=> String
     #   resp.smb_file_share_info_list[0].tags[0].value #=> String
+    #   resp.smb_file_share_info_list[0].file_share_name #=> String
+    #   resp.smb_file_share_info_list[0].cache_attributes.cache_stale_timeout_in_seconds #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSMBFileShares AWS API Documentation
     #
@@ -3152,7 +3394,7 @@ module Aws::StorageGateway
 
     # Returns the description of the gateway volumes specified in the
     # request. The list of gateway volumes in the request must be from one
-    # gateway. In the response AWS Storage Gateway returns volume
+    # gateway. In the response, AWS Storage Gateway returns volume
     # information sorted by volume ARNs. This operation is only supported in
     # stored volume gateway type.
     #
@@ -3319,6 +3561,9 @@ module Aws::StorageGateway
     #   resp.tape_archives[0].tape_used_in_bytes #=> Integer
     #   resp.tape_archives[0].kms_key #=> String
     #   resp.tape_archives[0].pool_id #=> String
+    #   resp.tape_archives[0].worm #=> Boolean
+    #   resp.tape_archives[0].retention_start_date #=> Time
+    #   resp.tape_archives[0].pool_entry_date #=> Time
     #   resp.marker #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapeArchives AWS API Documentation
@@ -3507,6 +3752,9 @@ module Aws::StorageGateway
     #   resp.tapes[0].tape_used_in_bytes #=> Integer
     #   resp.tapes[0].kms_key #=> String
     #   resp.tapes[0].pool_id #=> String
+    #   resp.tapes[0].worm #=> Boolean
+    #   resp.tapes[0].retention_start_date #=> Time
+    #   resp.tapes[0].pool_entry_date #=> Time
     #   resp.marker #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapes AWS API Documentation
@@ -3519,7 +3767,7 @@ module Aws::StorageGateway
     end
 
     # Returns information about the upload buffer of a gateway. This
-    # operation is supported for the stored volume, cached volume and tape
+    # operation is supported for the stored volume, cached volume, and tape
     # gateway types.
     #
     # The response includes disk IDs that are configured as upload buffer
@@ -3816,6 +4064,8 @@ module Aws::StorageGateway
     #   set to `false`, you must manually disconnect the iSCSI connection from
     #   the target volume.
     #
+    #   Valid Values: `true` \| `false`
+    #
     # @return [Types::DetachVolumeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetachVolumeOutput#volume_arn #volume_arn} => String
@@ -3990,6 +4240,7 @@ module Aws::StorageGateway
     #   resp.automatic_tape_creation_policy_infos[0].automatic_tape_creation_rules[0].pool_id #=> String
     #   resp.automatic_tape_creation_policy_infos[0].automatic_tape_creation_rules[0].tape_size_in_bytes #=> Integer
     #   resp.automatic_tape_creation_policy_infos[0].automatic_tape_creation_rules[0].minimum_num_tapes #=> Integer
+    #   resp.automatic_tape_creation_policy_infos[0].automatic_tape_creation_rules[0].worm #=> Boolean
     #   resp.automatic_tape_creation_policy_infos[0].gateway_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListAutomaticTapeCreationPolicies AWS API Documentation
@@ -4291,6 +4542,63 @@ module Aws::StorageGateway
       req.send_request(options)
     end
 
+    # Lists custom tape pools. You specify custom tape pools to list by
+    # specifying one or more custom tape pool Amazon Resource Names (ARNs).
+    # If you don't specify a custom tape pool ARN, the operation lists all
+    # custom tape pools.
+    #
+    # This operation supports pagination. You can optionally specify the
+    # `Limit` parameter in the body to limit the number of tape pools in the
+    # response. If the number of tape pools returned in the response is
+    # truncated, the response includes a `Marker` element that you can use
+    # in your subsequent request to retrieve the next set of tape pools.
+    #
+    # @option params [Array<String>] :pool_arns
+    #   The Amazon Resource Name (ARN) of each of the custom tape pools you
+    #   want to list. If you don't specify a custom tape pool ARN, the
+    #   response lists all custom tape pools.
+    #
+    # @option params [String] :marker
+    #   A string that indicates the position at which to begin the returned
+    #   list of tape pools.
+    #
+    # @option params [Integer] :limit
+    #   An optional number limit for the tape pools in the list returned by
+    #   this call.
+    #
+    # @return [Types::ListTapePoolsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTapePoolsOutput#pool_infos #pool_infos} => Array&lt;Types::PoolInfo&gt;
+    #   * {Types::ListTapePoolsOutput#marker #marker} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tape_pools({
+    #     pool_arns: ["PoolARN"],
+    #     marker: "Marker",
+    #     limit: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.pool_infos #=> Array
+    #   resp.pool_infos[0].pool_arn #=> String
+    #   resp.pool_infos[0].pool_name #=> String
+    #   resp.pool_infos[0].storage_class #=> String, one of "DEEP_ARCHIVE", "GLACIER"
+    #   resp.pool_infos[0].retention_lock_type #=> String, one of "COMPLIANCE", "GOVERNANCE", "NONE"
+    #   resp.pool_infos[0].retention_lock_time_in_days #=> Integer
+    #   resp.pool_infos[0].pool_status #=> String, one of "ACTIVE", "DELETED"
+    #   resp.marker #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTapePools AWS API Documentation
+    #
+    # @overload list_tape_pools(params = {})
+    # @param [Hash] params ({})
+    def list_tape_pools(params = {}, options = {})
+      req = build_request(:list_tape_pools, params)
+      req.send_request(options)
+    end
+
     # Lists virtual tapes in your virtual tape library (VTL) and your
     # virtual tape shelf (VTS). You specify the tapes to list by specifying
     # one or more tape Amazon Resource Names (ARNs). If you don't specify a
@@ -4342,6 +4650,8 @@ module Aws::StorageGateway
     #   resp.tape_infos[0].tape_status #=> String
     #   resp.tape_infos[0].gateway_arn #=> String
     #   resp.tape_infos[0].pool_id #=> String
+    #   resp.tape_infos[0].retention_start_date #=> Time
+    #   resp.tape_infos[0].pool_entry_date #=> Time
     #   resp.marker #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTapes AWS API Documentation
@@ -4565,9 +4875,12 @@ module Aws::StorageGateway
     # as Amazon SNS or AWS Lambda function. This operation is only supported
     # for file gateways.
     #
-    # For more information, see Getting File Upload Notification in the
-    # Storage Gateway User Guide
-    # (https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-upload-notification).
+    # For more information, see [Getting file upload notification][1] in the
+    # *AWS Storage Gateway User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-upload-notification
     #
     # @option params [required, String] :file_share_arn
     #   The Amazon Resource Name (ARN) of the file share.
@@ -4598,12 +4911,13 @@ module Aws::StorageGateway
     end
 
     # Refreshes the cache for the specified file share. This operation finds
-    # objects in the Amazon S3 bucket that were added, removed or replaced
+    # objects in the Amazon S3 bucket that were added, removed, or replaced
     # since the gateway last listed the bucket's contents and cached the
     # results. This operation is only supported in the file gateway type.
     # You can subscribe to be notified through an Amazon CloudWatch event
     # when your RefreshCache operation completes. For more information, see
-    # [Getting Notified About File Operations][1].
+    # [Getting notified about file operations][1] in the *AWS Storage
+    # Gateway User Guide*.
     #
     # When this API is called, it only initiates the refresh operation. When
     # the API call completes and returns a success code, it doesn't
@@ -4616,16 +4930,16 @@ module Aws::StorageGateway
     # Throttle limit: This API is asynchronous so the gateway will accept no
     # more than two refreshes at any time. We recommend using the
     # refresh-complete CloudWatch event notification before issuing
-    # additional requests. For more information, see [Getting Notified About
-    # File Operations][1].
+    # additional requests. For more information, see [Getting notified about
+    # file operations][1] in the *AWS Storage Gateway User Guide*.
     #
     # If you invoke the RefreshCache API when two requests are already being
     # processed, any new request will cause an
     # `InvalidGatewayRequestException` error because too many requests were
     # sent to the server.
     #
-    # For more information, see
-    # "https://docs.aws.amazon.com/storagegateway/latest/userguide/monitoring-file-gateway.html#get-notification".
+    # For more information, see [Getting notified about file operations][1]
+    # in the *AWS Storage Gateway User Guide*.
     #
     #
     #
@@ -4638,18 +4952,19 @@ module Aws::StorageGateway
     #   A comma-separated list of the paths of folders to refresh in the
     #   cache. The default is \[`"/"`\]. The default refreshes objects and
     #   folders at the root of the Amazon S3 bucket. If `Recursive` is set to
-    #   "true", the entire S3 bucket that the file share has access to is
+    #   `true`, the entire S3 bucket that the file share has access to is
     #   refreshed.
     #
     # @option params [Boolean] :recursive
     #   A value that specifies whether to recursively refresh folders in the
     #   cache. The refresh includes folders that were in the cache the last
     #   time the gateway listed the folder's contents. If this value set to
-    #   "true", each folder that is listed in `FolderList` is recursively
+    #   `true`, each folder that is listed in `FolderList` is recursively
     #   updated. Otherwise, subfolders listed in `FolderList` are not
     #   refreshed. Only objects that are in folders listed directly under
-    #   `FolderList` are found and used for the update. The default is
-    #   "true".
+    #   `FolderList` are found and used for the update. The default is `true`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @return [Types::RefreshCacheOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4975,7 +5290,7 @@ module Aws::StorageGateway
     #   is associated with.
     #
     # @option params [required, String] :password
-    #   The password that you want to set for your SMB Server.
+    #   The password that you want to set for your SMB server.
     #
     # @return [Types::SetSMBGuestPasswordOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5014,7 +5329,7 @@ module Aws::StorageGateway
     #  </note>
     #
     # After the gateway is shutdown, you cannot call any other API except
-    # StartGateway, DescribeGatewayInformation and ListGateways. For more
+    # StartGateway, DescribeGatewayInformation, and ListGateways. For more
     # information, see ActivateGateway. Your applications cannot read from
     # or write to the gateway's storage volumes, and there are no snapshots
     # taken.
@@ -5204,6 +5519,7 @@ module Aws::StorageGateway
     #         pool_id: "PoolId", # required
     #         tape_size_in_bytes: 1, # required
     #         minimum_num_tapes: 1, # required
+    #         worm: false,
     #       },
     #     ],
     #     gateway_arn: "GatewayARN", # required
@@ -5226,7 +5542,7 @@ module Aws::StorageGateway
     # the upload and download bandwidth rate limit or specify only one of
     # the two. If you don't set a bandwidth rate limit, the existing rate
     # limit remains. This operation is supported for the stored volume,
-    # cached volume and tape gateway types.'
+    # cached volume, and tape gateway types.
     #
     # By default, a gateway's bandwidth rate limits are not set. If you
     # don't set any limit, the gateway does not have any limitations on its
@@ -5374,7 +5690,7 @@ module Aws::StorageGateway
     # time zone. To specify which gateway to update, use the Amazon Resource
     # Name (ARN) of the gateway in your request.
     #
-    # <note markdown="1"> For Gateways activated after September 2, 2015, the gateway's ARN
+    # <note markdown="1"> For gateways activated after September 2, 2015, the gateway's ARN
     # contains the gateway ID rather than the gateway name. However,
     # changing the name of the gateway has no effect on the gateway's ARN.
     #
@@ -5395,7 +5711,7 @@ module Aws::StorageGateway
     #   The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
     #   you want to use to monitor and log events in the gateway.
     #
-    #   For more information, see [What Is Amazon CloudWatch Logs?][1].
+    #   For more information, see [What is Amazon CloudWatch Logs?][1]
     #
     #
     #
@@ -5460,8 +5776,8 @@ module Aws::StorageGateway
     # minimize the chance of any disruption to your applications by
     # increasing your iSCSI Initiators' timeouts. For more information
     # about increasing iSCSI Initiator timeouts for Windows and Linux, see
-    # [Customizing Your Windows iSCSI Settings][1] and [Customizing Your
-    # Linux iSCSI Settings][2], respectively.
+    # [Customizing your Windows iSCSI settings][1] and [Customizing your
+    # Linux iSCSI settings][2], respectively.
     #
     #
     #
@@ -5539,10 +5855,6 @@ module Aws::StorageGateway
     #   represented as an ordinal number from 1 to 28, where 1 represents the
     #   first day of the month and 28 represents the last day of the month.
     #
-    #   <note markdown="1"> This value is only available for tape and volume gateways.
-    #
-    #    </note>
-    #
     # @return [Types::UpdateMaintenanceStartTimeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateMaintenanceStartTimeOutput#gateway_arn #gateway_arn} => String
@@ -5617,56 +5929,67 @@ module Aws::StorageGateway
     #   The Amazon Resource Name (ARN) of the file share to be updated.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [Types::NFSFileShareDefaults] :nfs_file_share_defaults
     #   The default values for the file share. Optional.
     #
     # @option params [String] :default_storage_class
     #   The default storage class for objects put into an Amazon S3 bucket by
-    #   the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
-    #   or `S3_ONEZONE_IA`. If this field is not populated, the default value
-    #   `S3_STANDARD` is used. Optional.
+    #   the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
+    #   Optional.
+    #
+    #   Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
+    #   `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
     #
     # @option params [String] :object_acl
-    #   A value that sets the access control list permission for objects in
-    #   the S3 bucket that a file gateway puts objects into. The default value
-    #   is "private".
+    #   A value that sets the access control list (ACL) permission for objects
+    #   in the S3 bucket that a file gateway puts objects into. The default
+    #   value is `private`.
     #
     # @option params [Array<String>] :client_list
     #   The list of clients that are allowed to access the file gateway. The
     #   list must contain either valid IP addresses or valid CIDR blocks.
     #
     # @option params [String] :squash
-    #   The user mapped to anonymous user. Valid options are the following:
+    #   The user mapped to anonymous user.
     #
-    #   * `RootSquash` - Only root is mapped to anonymous user.
+    #   Valid values are the following:
     #
-    #   * `NoSquash` - No one is mapped to anonymous user
+    #   * `RootSquash`\: Only root is mapped to anonymous user.
     #
-    #   * `AllSquash` - Everyone is mapped to anonymous user.
+    #   * `NoSquash`\: No one is mapped to anonymous user.
+    #
+    #   * `AllSquash`\: Everyone is mapped to anonymous user.
     #
     # @option params [Boolean] :read_only
-    #   A value that sets the write status of a file share. This value is true
-    #   if the write status is read-only, and otherwise false.
+    #   A value that sets the write status of a file share. Set this value to
+    #   `true` to set the write status to read-only, otherwise set to `false`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :guess_mime_type_enabled
     #   A value that enables guessing of the MIME type for uploaded objects
-    #   based on file extensions. Set this value to true to enable MIME type
-    #   guessing, and otherwise to false. The default value is true.
+    #   based on file extensions. Set this value to `true` to enable MIME type
+    #   guessing, otherwise set to `false`. The default value is `true`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :requester_pays
     #   A value that sets who pays the cost of the request and the cost
     #   associated with data download from the S3 bucket. If this value is set
-    #   to true, the requester pays the costs. Otherwise the S3 bucket owner
-    #   pays. However, the S3 bucket owner always pays the cost of storing
-    #   data.
+    #   to `true`, the requester pays the costs; otherwise, the S3 bucket
+    #   owner pays. However, the S3 bucket owner always pays the cost of
+    #   storing data.
     #
     #   <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
     #   file share, so make sure that the configuration on the file share is
@@ -5674,6 +5997,19 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    #   Valid Values: `true` \| `false`
+    #
+    # @option params [String] :file_share_name
+    #   The name of the file share. Optional.
+    #
+    #   <note markdown="1"> `FileShareName` must be set if an S3 prefix name is set in
+    #   `LocationARN`.
+    #
+    #    </note>
+    #
+    # @option params [Types::CacheAttributes] :cache_attributes
+    #   Refresh cache information.
+    #
     # @return [Types::UpdateNFSFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateNFSFileShareOutput#file_share_arn #file_share_arn} => String
@@ -5697,6 +6033,10 @@ module Aws::StorageGateway
     #     read_only: false,
     #     guess_mime_type_enabled: false,
     #     requester_pays: false,
+    #     file_share_name: "FileShareName",
+    #     cache_attributes: {
+    #       cache_stale_timeout_in_seconds: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -5724,8 +6064,8 @@ module Aws::StorageGateway
     # is activated in the AWS Region you are creating your file gateway in.
     # If AWS STS is not activated in this AWS Region, activate it. For
     # information about how to activate AWS STS, see [Activating and
-    # Deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
-    # Access Management User Guide.*
+    # deactivating AWS STS in an AWS Region][1] in the *AWS Identity and
+    # Access Management User Guide*.
     #
     #  File gateways don't support creating hard or symbolic links on a
     # file
@@ -5740,40 +6080,49 @@ module Aws::StorageGateway
     #   update.
     #
     # @option params [Boolean] :kms_encrypted
-    #   True to use Amazon S3 server-side encryption with your own AWS KMS
-    #   key, or false to use a key managed by Amazon S3. Optional.
+    #   Set to `true` to use Amazon S3 server-side encryption with your own
+    #   AWS KMS key, or `false` to use a key managed by Amazon S3. Optional.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [String] :kms_key
-    #   The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3
-    #   server-side encryption. This value can only be set when KMSEncrypted
-    #   is true. Optional.
+    #   The Amazon Resource Name (ARN) of a symmetric customer master key
+    #   (CMK) used for Amazon S3 server-side encryption. Storage Gateway does
+    #   not support asymmetric CMKs. This value can only be set when
+    #   `KMSEncrypted` is `true`. Optional.
     #
     # @option params [String] :default_storage_class
     #   The default storage class for objects put into an Amazon S3 bucket by
-    #   the file gateway. Possible values are `S3_STANDARD`, `S3_STANDARD_IA`,
-    #   or `S3_ONEZONE_IA`. If this field is not populated, the default value
-    #   `S3_STANDARD` is used. Optional.
+    #   the file gateway. The default value is `S3_INTELLIGENT_TIERING`.
+    #   Optional.
+    #
+    #   Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \|
+    #   `S3_STANDARD_IA` \| `S3_ONEZONE_IA`
     #
     # @option params [String] :object_acl
-    #   A value that sets the access control list permission for objects in
-    #   the S3 bucket that a file gateway puts objects into. The default value
-    #   is "private".
+    #   A value that sets the access control list (ACL) permission for objects
+    #   in the S3 bucket that a file gateway puts objects into. The default
+    #   value is `private`.
     #
     # @option params [Boolean] :read_only
-    #   A value that sets the write status of a file share. This value is true
-    #   if the write status is read-only, and otherwise false.
+    #   A value that sets the write status of a file share. Set this value to
+    #   `true` to set write status to read-only, otherwise set to `false`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :guess_mime_type_enabled
     #   A value that enables guessing of the MIME type for uploaded objects
-    #   based on file extensions. Set this value to true to enable MIME type
-    #   guessing, and otherwise to false. The default value is true.
+    #   based on file extensions. Set this value to `true` to enable MIME type
+    #   guessing, otherwise set to `false`. The default value is `true`.
+    #
+    #   Valid Values: `true` \| `false`
     #
     # @option params [Boolean] :requester_pays
     #   A value that sets who pays the cost of the request and the cost
     #   associated with data download from the S3 bucket. If this value is set
-    #   to true, the requester pays the costs. Otherwise the S3 bucket owner
-    #   pays. However, the S3 bucket owner always pays the cost of storing
-    #   data.
+    #   to `true`, the requester pays the costs; otherwise, the S3 bucket
+    #   owner pays. However, the S3 bucket owner always pays the cost of
+    #   storing data.
     #
     #   <note markdown="1"> `RequesterPays` is a configuration for the S3 bucket that backs the
     #   file share, so make sure that the configuration on the file share is
@@ -5781,36 +6130,64 @@ module Aws::StorageGateway
     #
     #    </note>
     #
+    #   Valid Values: `true` \| `false`
+    #
     # @option params [Boolean] :smbacl_enabled
-    #   Set this value to "true to enable ACL (access control list) on the
-    #   SMB file share. Set it to "false" to map file and directory
+    #   Set this value to `true` to enable access control list (ACL) on the
+    #   SMB file share. Set it to `false` to map file and directory
     #   permissions to the POSIX permissions.
     #
-    #   For more information, see
-    #   https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.htmlin
-    #   the Storage Gateway User Guide.
+    #   For more information, see [Using Microsoft Windows ACLs to control
+    #   access to an SMB file share][1] in the *AWS Storage Gateway User
+    #   Guide*.
+    #
+    #   Valid Values: `true` \| `false`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html
     #
     # @option params [Array<String>] :admin_user_list
-    #   A list of users in the Active Directory that have administrator rights
-    #   to the file share. A group must be prefixed with the @ character. For
-    #   example `@group1`. Can only be set if Authentication is set to
-    #   `ActiveDirectory`.
+    #   A list of users or groups in the Active Directory that have
+    #   administrator rights to the file share. A group must be prefixed with
+    #   the @ character. Acceptable formats include: `DOMAIN\User1`, `user1`,
+    #   `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is
+    #   set to `ActiveDirectory`.
     #
     # @option params [Array<String>] :valid_user_list
     #   A list of users or groups in the Active Directory that are allowed to
     #   access the file share. A group must be prefixed with the @ character.
-    #   For example `@group1`. Can only be set if Authentication is set to
+    #   Acceptable formats include: `DOMAIN\User1`, `user1`, `@group1`, and
+    #   `@DOMAIN\group1`. Can only be set if Authentication is set to
     #   `ActiveDirectory`.
     #
     # @option params [Array<String>] :invalid_user_list
     #   A list of users or groups in the Active Directory that are not allowed
     #   to access the file share. A group must be prefixed with the @
-    #   character. For example `@group1`. Can only be set if Authentication is
+    #   character. Acceptable formats include: `DOMAIN\User1`, `user1`,
+    #   `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is
     #   set to `ActiveDirectory`.
     #
     # @option params [String] :audit_destination_arn
     #   The Amazon Resource Name (ARN) of the storage used for the audit logs.
     #
+    # @option params [String] :case_sensitivity
+    #   The case of an object name in an Amazon S3 bucket. For
+    #   `ClientSpecified`, the client determines the case sensitivity. For
+    #   `CaseSensitive`, the gateway determines the case sensitivity. The
+    #   default value is `ClientSpecified`.
+    #
+    # @option params [String] :file_share_name
+    #   The name of the file share. Optional.
+    #
+    #   <note markdown="1"> `FileShareName` must be set if an S3 prefix name is set in
+    #   `LocationARN`.
+    #
+    #    </note>
+    #
+    # @option params [Types::CacheAttributes] :cache_attributes
+    #   Refresh cache information.
+    #
     # @return [Types::UpdateSMBFileShareOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateSMBFileShareOutput#file_share_arn #file_share_arn} => String
@@ -5831,6 +6208,11 @@ module Aws::StorageGateway
     #     valid_user_list: ["FileShareUser"],
     #     invalid_user_list: ["FileShareUser"],
     #     audit_destination_arn: "AuditDestinationARN",
+    #     case_sensitivity: "ClientSpecified", # accepts ClientSpecified, CaseSensitive
+    #     file_share_name: "FileShareName",
+    #     cache_attributes: {
+    #       cache_stale_timeout_in_seconds: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -6005,7 +6387,7 @@ module Aws::StorageGateway
     # @option params [required, String] :device_type
     #   The type of medium changer you want to select.
     #
-    #   Valid Values: "STK-L700", "AWS-Gateway-VTL"
+    #   Valid Values: `STK-L700` \| `AWS-Gateway-VTL` \| `IBM-03584L32-0402`
     #
     # @return [Types::UpdateVTLDeviceTypeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6059,7 +6441,7 @@ module Aws::StorageGateway
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-storagegateway'
-      context[:gem_version] = '1.42.1'
+      context[:gem_version] = '1.47.0'
       Seahorse::Client::Request.new(handlers, context)
     end