Endpoint
/v3/smb/shares/{share_id}
GET
Retrieve the specified SMB share. Refer to the 'Modify SMB Share' method for a description of the returned fields. Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
Parameters
Name | Description | Required |
---|---|---|
share_id |
The unique ID of the SMB share. | Yes |
Response
Codes
Code | Description |
---|---|
200 | Return value on success |
Schema
{
"description": "api_smb_share_v3",
"type": "object",
"properties": {
"id": {
"description": "The unique ID of the SMB share",
"type": "string"
},
"share_name": {
"description": "The SMB share name",
"type": "string"
},
"tenant_id": {
"description": "The tenant ID of the tenant that the SMB share is a part of",
"type": "number"
},
"fs_path": {
"description": "The filesystem path to SMB share",
"type": "string"
},
"description": {
"description": "Description of this SMB share",
"type": "string"
},
"permissions": {
"type": "array",
"items": {
"description": "The access control list (ACL) for this SMB share",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"trustee": {
"description": "User/group to apply the permissions entry to",
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"LOCAL",
"API_NULL_DOMAIN",
"WORLD",
"POSIX_USER",
"POSIX_GROUP",
"ACTIVE_DIRECTORY",
"API_INVALID_DOMAIN",
"API_RESERVED_DOMAIN",
"API_INTERNAL_DOMAIN",
"API_OPERATOR_DOMAIN",
"API_CREATOR_DOMAIN"
],
"description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
},
"auth_id": {
"description": "auth_id",
"type": "string"
},
"uid": {
"description": "uid",
"type": "number"
},
"gid": {
"description": "gid",
"type": "number"
},
"sid": {
"description": "sid",
"type": "string"
},
"name": {
"description": "name",
"type": "string"
}
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"network_permissions": {
"type": "array",
"items": {
"description": "The network access control list (ACL) for this SMB share. If not specified, the default is to allow any host.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"address_ranges": {
"type": "array",
"items": {
"description": "IP address ranges to apply permissions to. Empty means all hosts.",
"type": "string"
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"access_based_enumeration_enabled": {
"description": "Enable Access-based Enumeration on this SMB share",
"type": "boolean"
},
"default_file_create_mode": {
"description": "Default POSIX file create mode bits on this SMB share (octal, default 0644 if this field is empty)",
"type": "string"
},
"default_directory_create_mode": {
"description": "Default POSIX directory create mode bits on this SMB share (octal, default 0755 if this field is empty)",
"type": "string"
},
"require_encryption": {
"description": "Require all traffic to this share to be encrypted. Clients without encryption capabilities will not be able to connect. Default is false if this field is empty.",
"type": "boolean"
}
}
}
PUT
Modify an SMB share's options. Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
Parameters
Name | Description | Required |
---|---|---|
share_id |
The unique ID of the SMB share. | Yes |
allow-fs-path-create |
Specifies whether the file system path can be created if it does not already exist. | No |
If-Match |
ETag for expected version | No |
Request
Schema
{
"description": "api_smb_share_v3",
"type": "object",
"properties": {
"id": {
"description": "The unique ID of the SMB share",
"type": "string"
},
"share_name": {
"description": "The SMB share name",
"type": "string"
},
"tenant_id": {
"description": "The tenant ID of the tenant that the SMB share is a part of",
"type": "number"
},
"fs_path": {
"description": "The filesystem path to SMB share",
"type": "string"
},
"description": {
"description": "Description of this SMB share",
"type": "string"
},
"permissions": {
"type": "array",
"items": {
"description": "The access control list (ACL) for this SMB share",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"trustee": {
"description": "User/group to apply the permissions entry to",
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"LOCAL",
"API_NULL_DOMAIN",
"WORLD",
"POSIX_USER",
"POSIX_GROUP",
"ACTIVE_DIRECTORY",
"API_INVALID_DOMAIN",
"API_RESERVED_DOMAIN",
"API_INTERNAL_DOMAIN",
"API_OPERATOR_DOMAIN",
"API_CREATOR_DOMAIN"
],
"description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
},
"auth_id": {
"description": "auth_id",
"type": "string"
},
"uid": {
"description": "uid",
"type": "number"
},
"gid": {
"description": "gid",
"type": "number"
},
"sid": {
"description": "sid",
"type": "string"
},
"name": {
"description": "name",
"type": "string"
}
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"network_permissions": {
"type": "array",
"items": {
"description": "The network access control list (ACL) for this SMB share. If not specified, the default is to allow any host.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"address_ranges": {
"type": "array",
"items": {
"description": "IP address ranges to apply permissions to. Empty means all hosts.",
"type": "string"
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"access_based_enumeration_enabled": {
"description": "Enable Access-based Enumeration on this SMB share",
"type": "boolean"
},
"default_file_create_mode": {
"description": "Default POSIX file create mode bits on this SMB share (octal, default 0644 if this field is empty)",
"type": "string"
},
"default_directory_create_mode": {
"description": "Default POSIX directory create mode bits on this SMB share (octal, default 0755 if this field is empty)",
"type": "string"
},
"require_encryption": {
"description": "Require all traffic to this share to be encrypted. Clients without encryption capabilities will not be able to connect. Default is false if this field is empty.",
"type": "boolean"
}
}
}
Response
Codes
Code | Description |
---|---|
200 | Return value on success |
Schema
{
"description": "api_smb_share_v3",
"type": "object",
"properties": {
"id": {
"description": "The unique ID of the SMB share",
"type": "string"
},
"share_name": {
"description": "The SMB share name",
"type": "string"
},
"tenant_id": {
"description": "The tenant ID of the tenant that the SMB share is a part of",
"type": "number"
},
"fs_path": {
"description": "The filesystem path to SMB share",
"type": "string"
},
"description": {
"description": "Description of this SMB share",
"type": "string"
},
"permissions": {
"type": "array",
"items": {
"description": "The access control list (ACL) for this SMB share",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"trustee": {
"description": "User/group to apply the permissions entry to",
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"LOCAL",
"API_NULL_DOMAIN",
"WORLD",
"POSIX_USER",
"POSIX_GROUP",
"ACTIVE_DIRECTORY",
"API_INVALID_DOMAIN",
"API_RESERVED_DOMAIN",
"API_INTERNAL_DOMAIN",
"API_OPERATOR_DOMAIN",
"API_CREATOR_DOMAIN"
],
"description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
},
"auth_id": {
"description": "auth_id",
"type": "string"
},
"uid": {
"description": "uid",
"type": "number"
},
"gid": {
"description": "gid",
"type": "number"
},
"sid": {
"description": "sid",
"type": "string"
},
"name": {
"description": "name",
"type": "string"
}
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"network_permissions": {
"type": "array",
"items": {
"description": "The network access control list (ACL) for this SMB share. If not specified, the default is to allow any host.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"address_ranges": {
"type": "array",
"items": {
"description": "IP address ranges to apply permissions to. Empty means all hosts.",
"type": "string"
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"access_based_enumeration_enabled": {
"description": "Enable Access-based Enumeration on this SMB share",
"type": "boolean"
},
"default_file_create_mode": {
"description": "Default POSIX file create mode bits on this SMB share (octal, default 0644 if this field is empty)",
"type": "string"
},
"default_directory_create_mode": {
"description": "Default POSIX directory create mode bits on this SMB share (octal, default 0755 if this field is empty)",
"type": "string"
},
"require_encryption": {
"description": "Require all traffic to this share to be encrypted. Clients without encryption capabilities will not be able to connect. Default is false if this field is empty.",
"type": "boolean"
}
}
}
DELETE
Delete an SMB share. Not undoable. Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
Parameters
Name | Description | Required |
---|---|---|
share_id |
The unique ID of the SMB share. | Yes |
If-Match |
ETag for expected version | No |
Response
Codes
Code | Description |
---|---|
200 | Return value on success |
PATCH
Modify select fields in an SMB share. Important
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
This preview REST API is under development. Its functionality or backwards compatibility can change without notice.
Parameters
Name | Description | Required |
---|---|---|
share_id |
The unique ID of the SMB share. | Yes |
allow-fs-path-create |
Specifies whether the file system path can be created if it does not already exist. | No |
If-Match |
ETag for expected version | No |
Request
Schema
{
"description": "api_smb_share_v3",
"type": "object",
"properties": {
"id": {
"description": "The unique ID of the SMB share",
"type": "string"
},
"share_name": {
"description": "The SMB share name",
"type": "string"
},
"tenant_id": {
"description": "The tenant ID of the tenant that the SMB share is a part of",
"type": "number"
},
"fs_path": {
"description": "The filesystem path to SMB share",
"type": "string"
},
"description": {
"description": "Description of this SMB share",
"type": "string"
},
"permissions": {
"type": "array",
"items": {
"description": "The access control list (ACL) for this SMB share",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"trustee": {
"description": "User/group to apply the permissions entry to",
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"LOCAL",
"API_NULL_DOMAIN",
"WORLD",
"POSIX_USER",
"POSIX_GROUP",
"ACTIVE_DIRECTORY",
"API_INVALID_DOMAIN",
"API_RESERVED_DOMAIN",
"API_INTERNAL_DOMAIN",
"API_OPERATOR_DOMAIN",
"API_CREATOR_DOMAIN"
],
"description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
},
"auth_id": {
"description": "auth_id",
"type": "string"
},
"uid": {
"description": "uid",
"type": "number"
},
"gid": {
"description": "gid",
"type": "number"
},
"sid": {
"description": "sid",
"type": "string"
},
"name": {
"description": "name",
"type": "string"
}
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"network_permissions": {
"type": "array",
"items": {
"description": "The network access control list (ACL) for this SMB share. If not specified, the default is to allow any host.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"address_ranges": {
"type": "array",
"items": {
"description": "IP address ranges to apply permissions to. Empty means all hosts.",
"type": "string"
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"access_based_enumeration_enabled": {
"description": "Enable Access-based Enumeration on this SMB share",
"type": "boolean"
},
"default_file_create_mode": {
"description": "Default POSIX file create mode bits on this SMB share (octal, default 0644 if this field is empty)",
"type": "string"
},
"default_directory_create_mode": {
"description": "Default POSIX directory create mode bits on this SMB share (octal, default 0755 if this field is empty)",
"type": "string"
},
"require_encryption": {
"description": "Require all traffic to this share to be encrypted. Clients without encryption capabilities will not be able to connect. Default is false if this field is empty.",
"type": "boolean"
}
}
}
Response
Codes
Code | Description |
---|---|
200 | Return value on success |
Schema
{
"description": "api_smb_share_v3",
"type": "object",
"properties": {
"id": {
"description": "The unique ID of the SMB share",
"type": "string"
},
"share_name": {
"description": "The SMB share name",
"type": "string"
},
"tenant_id": {
"description": "The tenant ID of the tenant that the SMB share is a part of",
"type": "number"
},
"fs_path": {
"description": "The filesystem path to SMB share",
"type": "string"
},
"description": {
"description": "Description of this SMB share",
"type": "string"
},
"permissions": {
"type": "array",
"items": {
"description": "The access control list (ACL) for this SMB share",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"trustee": {
"description": "User/group to apply the permissions entry to",
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"LOCAL",
"API_NULL_DOMAIN",
"WORLD",
"POSIX_USER",
"POSIX_GROUP",
"ACTIVE_DIRECTORY",
"API_INVALID_DOMAIN",
"API_RESERVED_DOMAIN",
"API_INTERNAL_DOMAIN",
"API_OPERATOR_DOMAIN",
"API_CREATOR_DOMAIN"
],
"description": "domain:\n * `ACTIVE_DIRECTORY` - ACTIVE_DIRECTORY,\n * `API_CREATOR_DOMAIN` - API_CREATOR_DOMAIN,\n * `API_INTERNAL_DOMAIN` - API_INTERNAL_DOMAIN,\n * `API_INVALID_DOMAIN` - API_INVALID_DOMAIN,\n * `API_NULL_DOMAIN` - API_NULL_DOMAIN,\n * `API_OPERATOR_DOMAIN` - API_OPERATOR_DOMAIN,\n * `API_RESERVED_DOMAIN` - API_RESERVED_DOMAIN,\n * `LOCAL` - LOCAL,\n * `POSIX_GROUP` - POSIX_GROUP,\n * `POSIX_USER` - POSIX_USER,\n * `WORLD` - WORLD"
},
"auth_id": {
"description": "auth_id",
"type": "string"
},
"uid": {
"description": "uid",
"type": "number"
},
"gid": {
"description": "gid",
"type": "number"
},
"sid": {
"description": "sid",
"type": "string"
},
"name": {
"description": "name",
"type": "string"
}
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"network_permissions": {
"type": "array",
"items": {
"description": "The network access control list (ACL) for this SMB share. If not specified, the default is to allow any host.",
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"ALLOWED",
"DENIED"
],
"description": "Type of permissions entry (ALLOWED or DENIED):\n * `ALLOWED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_ALLOWED,\n * `DENIED` - API_SMB_SHARE_PERMISSIONS_ENTRY_TYPE_DENIED"
},
"address_ranges": {
"type": "array",
"items": {
"description": "IP address ranges to apply permissions to. Empty means all hosts.",
"type": "string"
}
},
"rights": {
"description": "Rights pertaining to the permissions entry",
"type": "array",
"items": {
"type": "string",
"enum": [
"READ",
"WRITE",
"CHANGE_PERMISSIONS",
"ALL",
"READ_DATA",
"READ_EA",
"READ_ATTR",
"READ_ACL",
"WRITE_EA",
"WRITE_ATTR",
"WRITE_ACL",
"CHANGE_OWNER",
"WRITE_GROUP",
"DELETE",
"EXECUTE",
"MODIFY",
"EXTEND",
"ADD_FILE",
"ADD_SUBDIR",
"DELETE_CHILD",
"SYNCHRONIZE"
],
"description": "Rights pertaining to the permissions entry:\n * `ADD_FILE` - File creation access,\n * `ADD_SUBDIR` - Directory creation access,\n * `ALL` - All access rights,\n * `CHANGE_OWNER` - Owner write access,\n * `CHANGE_PERMISSIONS` - Rights to change permissions on file objects,\n * `DELETE` - Delete access,\n * `DELETE_CHILD` - Delete from directory access,\n * `EXECUTE` - Execute access,\n * `EXTEND` - File extension access,\n * `MODIFY` - File modification access,\n * `READ` - Read access rights,\n * `READ_ACL` - ACL read access,\n * `READ_ATTR` - Attribute read access,\n * `READ_DATA` - File read access,\n * `READ_EA` - Extended attribute read access,\n * `SYNCHRONIZE` - File synchronize access,\n * `WRITE` - Write access rights,\n * `WRITE_ACL` - ACL write access,\n * `WRITE_ATTR` - Attribute write access,\n * `WRITE_EA` - Extended attribute write access,\n * `WRITE_GROUP` - Group write access"
}
}
}
}
},
"access_based_enumeration_enabled": {
"description": "Enable Access-based Enumeration on this SMB share",
"type": "boolean"
},
"default_file_create_mode": {
"description": "Default POSIX file create mode bits on this SMB share (octal, default 0644 if this field is empty)",
"type": "string"
},
"default_directory_create_mode": {
"description": "Default POSIX directory create mode bits on this SMB share (octal, default 0755 if this field is empty)",
"type": "string"
},
"require_encryption": {
"description": "Require all traffic to this share to be encrypted. Clients without encryption capabilities will not be able to connect. Default is false if this field is empty.",
"type": "boolean"
}
}
}