class Aws::StorageGateway::Types::UpdateSMBFileShareInput
@note When making an API call, you may pass UpdateSMBFileShareInput
data as a hash: { file_share_arn: "FileShareARN", # required kms_encrypted: false, kms_key: "KMSKey", default_storage_class: "StorageClass", object_acl: "private", # accepts private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control, aws-exec-read read_only: false, guess_mime_type_enabled: false, requester_pays: false, smbacl_enabled: false, access_based_enumeration: false, admin_user_list: ["UserListUser"], valid_user_list: ["UserListUser"], invalid_user_list: ["UserListUser"], audit_destination_arn: "AuditDestinationARN", case_sensitivity: "ClientSpecified", # accepts ClientSpecified, CaseSensitive file_share_name: "FileShareName", cache_attributes: { cache_stale_timeout_in_seconds: 1, }, notification_policy: "NotificationPolicy", oplocks_enabled: false, }
@!attribute [rw] file_share_arn
The Amazon Resource Name (ARN) of the SMB file share that you want to update. @return [String]
@!attribute [rw] kms_encrypted
Set to `true` to use Amazon S3 server-side encryption with your own KMS key, or `false` to use a key managed by Amazon S3. Optional. Valid Values: `true` \| `false` @return [Boolean]
@!attribute [rw] kms_key
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. @return [String]
@!attribute [rw] default_storage_class
The default storage class for objects put into an Amazon S3 bucket by the S3 File Gateway. The default value is `S3_INTELLIGENT_TIERING`. Optional. Valid Values: `S3_STANDARD` \| `S3_INTELLIGENT_TIERING` \| `S3_STANDARD_IA` \| `S3_ONEZONE_IA` @return [String]
@!attribute [rw] object_acl
A value that sets the access control list (ACL) permission for objects in the S3 bucket that a S3 File Gateway puts objects into. The default value is `private`. @return [String]
@!attribute [rw] read_only
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` @return [Boolean]
@!attribute [rw] 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, otherwise set to `false`. The default value is `true`. Valid Values: `true` \| `false` @return [Boolean]
@!attribute [rw] 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. <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 the same as the S3 bucket configuration. </note> Valid Values: `true` \| `false` @return [Boolean]
@!attribute [rw] smbacl_enabled
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 [Using Microsoft Windows ACLs to control access to an SMB file share][1] in the *Storage Gateway User Guide*. Valid Values: `true` \| `false` [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html @return [Boolean]
@!attribute [rw] access_based_enumeration
The files and folders on this share will only be visible to users with read access. @return [Boolean]
@!attribute [rw] admin_user_list
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`. @return [Array<String>]
@!attribute [rw] 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. Acceptable formats include: `DOMAIN\User1`, `user1`, `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is set to `ActiveDirectory`. @return [Array<String>]
@!attribute [rw] 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. Acceptable formats include: `DOMAIN\User1`, `user1`, `@group1`, and `@DOMAIN\group1`. Can only be set if Authentication is set to `ActiveDirectory`. @return [Array<String>]
@!attribute [rw] audit_destination_arn
The Amazon Resource Name (ARN) of the storage used for audit logs. @return [String]
@!attribute [rw] 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`. @return [String]
@!attribute [rw] 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> @return [String]
@!attribute [rw] cache_attributes
Specifies refresh cache information for the file share. @return [Types::CacheAttributes]
@!attribute [rw] notification_policy
The notification policy of the file share. `SettlingTimeInSeconds` controls the number of seconds to wait after the last point in time a client wrote to a file before generating an `ObjectUploaded` notification. Because clients can make many small writes to files, it's best to set this parameter for as long as possible to avoid generating multiple notifications for the same file in a small time period. <note markdown="1"> `SettlingTimeInSeconds` has no effect on the timing of the object uploading to Amazon S3, only the timing of the notification. </note> The following example sets `NotificationPolicy` on with `SettlingTimeInSeconds` set to 60. `\{"Upload": \{"SettlingTimeInSeconds": 60\}\}` The following example sets `NotificationPolicy` off. `\{\}` @return [String]
@!attribute [rw] oplocks_enabled
Specifies whether opportunistic locking is enabled for the SMB file share. <note markdown="1"> Enabling opportunistic locking on case-sensitive shares is not recommended for workloads that involve access to files with the same name in different case. </note> Valid Values: `true` \| `false` @return [Boolean]
@see docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateSMBFileShareInput AWS API Documentation
Constants
- SENSITIVE