{"description":"api_smb_settings","type":"object","properties":{"session_encryption":{"type":"string","enum":["NONE","PREFERRED","REQUIRED"],"description":"Session-level encryption setting.:\n * `NONE` - SMB_SESSION_ENCRYPTION_SETTING_NONE,\n * `PREFERRED` - SMB_SESSION_ENCRYPTION_SETTING_PREFERRED,\n * `REQUIRED` - SMB_SESSION_ENCRYPTION_SETTING_REQUIRED"},"supported_dialects":{"type":"array","items":{"type":"string","enum":["SMB2_DIALECT_2_002","SMB2_DIALECT_2_1","SMB2_DIALECT_3_0","SMB2_DIALECT_3_11"],"description":"supported_dialects:\n * `SMB2_DIALECT_2_002` - API_SMB2_DIALECT_2_002,\n * `SMB2_DIALECT_2_1` - API_SMB2_DIALECT_2_1,\n * `SMB2_DIALECT_3_0` - API_SMB2_DIALECT_3_0,\n * `SMB2_DIALECT_3_11` - API_SMB2_DIALECT_3_11"}},"hide_shares_from_unauthorized_users":{"description":"If share permissions deny a logged in user access to a share, that share will not be visible in the share listing.","type":"boolean"},"hide_shares_from_unauthorized_hosts":{"description":"If share permissions deny a connected host access to a share, that share will not be visible in the share listing.","type":"boolean"},"snapshot_directory_mode":{"type":"string","enum":["VISIBLE","HIDDEN","DISABLED"],"description":"Whether the special .snapshot directory should be visible or accessible.:\n * `DISABLED` - SNAPSHOT_METADIR_DISABLED,\n * `HIDDEN` - SNAPSHOT_METADIR_HIDDEN,\n * `VISIBLE` - SNAPSHOT_METADIR_VISIBLE"},"bypass_traverse_checking":{"description":"Skip directory traversal checking for all users.","type":"boolean"},"signing_required":{"description":"Requires messages from non-guest users to be signed.","type":"boolean"}}}
PUT
Set global SMB configuration.
Parameters
Name
Description
Required
If-Match
ETag for expected version
No
Request
Schema
{"description":"api_smb_settings","type":"object","properties":{"session_encryption":{"type":"string","enum":["NONE","PREFERRED","REQUIRED"],"description":"Session-level encryption setting.:\n * `NONE` - SMB_SESSION_ENCRYPTION_SETTING_NONE,\n * `PREFERRED` - SMB_SESSION_ENCRYPTION_SETTING_PREFERRED,\n * `REQUIRED` - SMB_SESSION_ENCRYPTION_SETTING_REQUIRED"},"supported_dialects":{"type":"array","items":{"type":"string","enum":["SMB2_DIALECT_2_002","SMB2_DIALECT_2_1","SMB2_DIALECT_3_0","SMB2_DIALECT_3_11"],"description":"supported_dialects:\n * `SMB2_DIALECT_2_002` - API_SMB2_DIALECT_2_002,\n * `SMB2_DIALECT_2_1` - API_SMB2_DIALECT_2_1,\n * `SMB2_DIALECT_3_0` - API_SMB2_DIALECT_3_0,\n * `SMB2_DIALECT_3_11` - API_SMB2_DIALECT_3_11"}},"hide_shares_from_unauthorized_users":{"description":"If share permissions deny a logged in user access to a share, that share will not be visible in the share listing.","type":"boolean"},"hide_shares_from_unauthorized_hosts":{"description":"If share permissions deny a connected host access to a share, that share will not be visible in the share listing.","type":"boolean"},"snapshot_directory_mode":{"type":"string","enum":["VISIBLE","HIDDEN","DISABLED"],"description":"Whether the special .snapshot directory should be visible or accessible.:\n * `DISABLED` - SNAPSHOT_METADIR_DISABLED,\n * `HIDDEN` - SNAPSHOT_METADIR_HIDDEN,\n * `VISIBLE` - SNAPSHOT_METADIR_VISIBLE"},"bypass_traverse_checking":{"description":"Skip directory traversal checking for all users.","type":"boolean"},"signing_required":{"description":"Requires messages from non-guest users to be signed.","type":"boolean"}}}
Response
Codes
Code
Description
200
Return value on success
Schema
{"description":"api_smb_settings","type":"object","properties":{"session_encryption":{"type":"string","enum":["NONE","PREFERRED","REQUIRED"],"description":"Session-level encryption setting.:\n * `NONE` - SMB_SESSION_ENCRYPTION_SETTING_NONE,\n * `PREFERRED` - SMB_SESSION_ENCRYPTION_SETTING_PREFERRED,\n * `REQUIRED` - SMB_SESSION_ENCRYPTION_SETTING_REQUIRED"},"supported_dialects":{"type":"array","items":{"type":"string","enum":["SMB2_DIALECT_2_002","SMB2_DIALECT_2_1","SMB2_DIALECT_3_0","SMB2_DIALECT_3_11"],"description":"supported_dialects:\n * `SMB2_DIALECT_2_002` - API_SMB2_DIALECT_2_002,\n * `SMB2_DIALECT_2_1` - API_SMB2_DIALECT_2_1,\n * `SMB2_DIALECT_3_0` - API_SMB2_DIALECT_3_0,\n * `SMB2_DIALECT_3_11` - API_SMB2_DIALECT_3_11"}},"hide_shares_from_unauthorized_users":{"description":"If share permissions deny a logged in user access to a share, that share will not be visible in the share listing.","type":"boolean"},"hide_shares_from_unauthorized_hosts":{"description":"If share permissions deny a connected host access to a share, that share will not be visible in the share listing.","type":"boolean"},"snapshot_directory_mode":{"type":"string","enum":["VISIBLE","HIDDEN","DISABLED"],"description":"Whether the special .snapshot directory should be visible or accessible.:\n * `DISABLED` - SNAPSHOT_METADIR_DISABLED,\n * `HIDDEN` - SNAPSHOT_METADIR_HIDDEN,\n * `VISIBLE` - SNAPSHOT_METADIR_VISIBLE"},"bypass_traverse_checking":{"description":"Skip directory traversal checking for all users.","type":"boolean"},"signing_required":{"description":"Requires messages from non-guest users to be signed.","type":"boolean"}}}
PATCH
Modify global SMB configuration.
Parameters
Name
Description
Required
If-Match
ETag for expected version
No
Request
Schema
{"description":"api_smb_settings_patch","type":"object","properties":{"session_encryption":{"type":"string","enum":["NONE","PREFERRED","REQUIRED"],"description":"Session-level encryption setting.:\n * `NONE` - SMB_SESSION_ENCRYPTION_SETTING_NONE,\n * `PREFERRED` - SMB_SESSION_ENCRYPTION_SETTING_PREFERRED,\n * `REQUIRED` - SMB_SESSION_ENCRYPTION_SETTING_REQUIRED"},"supported_dialects":{"type":"array","items":{"type":"string","enum":["SMB2_DIALECT_2_002","SMB2_DIALECT_2_1","SMB2_DIALECT_3_0","SMB2_DIALECT_3_11"],"description":"supported_dialects:\n * `SMB2_DIALECT_2_002` - API_SMB2_DIALECT_2_002,\n * `SMB2_DIALECT_2_1` - API_SMB2_DIALECT_2_1,\n * `SMB2_DIALECT_3_0` - API_SMB2_DIALECT_3_0,\n * `SMB2_DIALECT_3_11` - API_SMB2_DIALECT_3_11"}},"hide_shares_from_unauthorized_users":{"description":"If share permissions deny a logged in user access to a share, that share will not be visible in the share listing.","type":"boolean"},"hide_shares_from_unauthorized_hosts":{"description":"If share permissions deny a connected host access to a share, that share will not be visible in the share listing.","type":"boolean"},"snapshot_directory_mode":{"type":"string","enum":["VISIBLE","HIDDEN","DISABLED"],"description":"Whether the special .snapshot directory should be visible or accessible.:\n * `DISABLED` - SNAPSHOT_METADIR_DISABLED,\n * `HIDDEN` - SNAPSHOT_METADIR_HIDDEN,\n * `VISIBLE` - SNAPSHOT_METADIR_VISIBLE"},"bypass_traverse_checking":{"description":"Skip directory traversal checking for all users.","type":"boolean"},"signing_required":{"description":"Requires messages from non-guest users to be signed.","type":"boolean"}}}
Response
Codes
Code
Description
200
Return value on success
Schema
{"description":"api_smb_settings","type":"object","properties":{"session_encryption":{"type":"string","enum":["NONE","PREFERRED","REQUIRED"],"description":"Session-level encryption setting.:\n * `NONE` - SMB_SESSION_ENCRYPTION_SETTING_NONE,\n * `PREFERRED` - SMB_SESSION_ENCRYPTION_SETTING_PREFERRED,\n * `REQUIRED` - SMB_SESSION_ENCRYPTION_SETTING_REQUIRED"},"supported_dialects":{"type":"array","items":{"type":"string","enum":["SMB2_DIALECT_2_002","SMB2_DIALECT_2_1","SMB2_DIALECT_3_0","SMB2_DIALECT_3_11"],"description":"supported_dialects:\n * `SMB2_DIALECT_2_002` - API_SMB2_DIALECT_2_002,\n * `SMB2_DIALECT_2_1` - API_SMB2_DIALECT_2_1,\n * `SMB2_DIALECT_3_0` - API_SMB2_DIALECT_3_0,\n * `SMB2_DIALECT_3_11` - API_SMB2_DIALECT_3_11"}},"hide_shares_from_unauthorized_users":{"description":"If share permissions deny a logged in user access to a share, that share will not be visible in the share listing.","type":"boolean"},"hide_shares_from_unauthorized_hosts":{"description":"If share permissions deny a connected host access to a share, that share will not be visible in the share listing.","type":"boolean"},"snapshot_directory_mode":{"type":"string","enum":["VISIBLE","HIDDEN","DISABLED"],"description":"Whether the special .snapshot directory should be visible or accessible.:\n * `DISABLED` - SNAPSHOT_METADIR_DISABLED,\n * `HIDDEN` - SNAPSHOT_METADIR_HIDDEN,\n * `VISIBLE` - SNAPSHOT_METADIR_VISIBLE"},"bypass_traverse_checking":{"description":"Skip directory traversal checking for all users.","type":"boolean"},"signing_required":{"description":"Requires messages from non-guest users to be signed.","type":"boolean"}}}
