multitenancy/smb/global-settings

Endpoint

/v1/multitenancy/smb/global-settings

GET

Retrieve global SMB configuration.

Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.

Parameters

This resource has no parameters.

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"
    }
  }
}

PUT

Set global SMB configuration.

Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.

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.

Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.

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"
    }
  }
}