powerscale.SmbShare
Explore with Pulumi AI
This resource is used to manage the SMB share entity on PowerScale array. PowerScale SMB shares provide clients network access to file system resources on the cluster. We can Create, Update and Delete the SMB share using this resource. We can also import an existing SMB Share from PowerScale array.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as powerscale from "@pulumi/powerscale";
// PowerScale SMB shares provide clients network access to file system resources on the cluster
const shareExample = new powerscale.SmbShare("shareExample", {
path: "/ifs/smb_share_example",
permissions: [{
permission: "full",
permissionType: "allow",
trustee: {
id: "SID:S-1-1-0",
name: "Everyone",
type: "wellknown",
},
}],
});
import pulumi
import pulumi_powerscale as powerscale
# PowerScale SMB shares provide clients network access to file system resources on the cluster
share_example = powerscale.SmbShare("shareExample",
path="/ifs/smb_share_example",
permissions=[{
"permission": "full",
"permission_type": "allow",
"trustee": {
"id": "SID:S-1-1-0",
"name": "Everyone",
"type": "wellknown",
},
}])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/powerscale/powerscale"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// PowerScale SMB shares provide clients network access to file system resources on the cluster
_, err := powerscale.NewSmbShare(ctx, "shareExample", &powerscale.SmbShareArgs{
Path: pulumi.String("/ifs/smb_share_example"),
Permissions: powerscale.SmbSharePermissionArray{
&powerscale.SmbSharePermissionArgs{
Permission: pulumi.String("full"),
PermissionType: pulumi.String("allow"),
Trustee: &powerscale.SmbSharePermissionTrusteeArgs{
Id: pulumi.String("SID:S-1-1-0"),
Name: pulumi.String("Everyone"),
Type: pulumi.String("wellknown"),
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Powerscale = Pulumi.Powerscale;
return await Deployment.RunAsync(() =>
{
// PowerScale SMB shares provide clients network access to file system resources on the cluster
var shareExample = new Powerscale.SmbShare("shareExample", new()
{
Path = "/ifs/smb_share_example",
Permissions = new[]
{
new Powerscale.Inputs.SmbSharePermissionArgs
{
Permission = "full",
PermissionType = "allow",
Trustee = new Powerscale.Inputs.SmbSharePermissionTrusteeArgs
{
Id = "SID:S-1-1-0",
Name = "Everyone",
Type = "wellknown",
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.powerscale.SmbShare;
import com.pulumi.powerscale.SmbShareArgs;
import com.pulumi.powerscale.inputs.SmbSharePermissionArgs;
import com.pulumi.powerscale.inputs.SmbSharePermissionTrusteeArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
// PowerScale SMB shares provide clients network access to file system resources on the cluster
var shareExample = new SmbShare("shareExample", SmbShareArgs.builder()
.path("/ifs/smb_share_example")
.permissions(SmbSharePermissionArgs.builder()
.permission("full")
.permissionType("allow")
.trustee(SmbSharePermissionTrusteeArgs.builder()
.id("SID:S-1-1-0")
.name("Everyone")
.type("wellknown")
.build())
.build())
.build());
}
}
resources:
# PowerScale SMB shares provide clients network access to file system resources on the cluster
shareExample:
type: powerscale:SmbShare
properties:
path: /ifs/smb_share_example
permissions:
- permission: full
permissionType: allow
trustee:
id: SID:S-1-1-0
name: Everyone
type: wellknown
Create SmbShare Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new SmbShare(name: string, args: SmbShareArgs, opts?: CustomResourceOptions);
@overload
def SmbShare(resource_name: str,
args: SmbShareArgs,
opts: Optional[ResourceOptions] = None)
@overload
def SmbShare(resource_name: str,
opts: Optional[ResourceOptions] = None,
path: Optional[str] = None,
permissions: Optional[Sequence[SmbSharePermissionArgs]] = None,
file_filtering_enabled: Optional[bool] = None,
hide_dot_files: Optional[bool] = None,
allow_variable_expansion: Optional[bool] = None,
auto_create_directory: Optional[bool] = None,
browsable: Optional[bool] = None,
ca_timeout: Optional[float] = None,
ca_write_integrity: Optional[str] = None,
change_notify: Optional[str] = None,
create_path: Optional[bool] = None,
host_acls: Optional[Sequence[str]] = None,
csc_policy: Optional[str] = None,
description: Optional[str] = None,
directory_create_mask: Optional[float] = None,
directory_create_mode: Optional[float] = None,
file_create_mask: Optional[float] = None,
file_create_mode: Optional[float] = None,
file_filter_extensions: Optional[Sequence[str]] = None,
file_filter_type: Optional[str] = None,
allow_execute_always: Optional[bool] = None,
access_based_enumeration: Optional[bool] = None,
create_permissions: Optional[str] = None,
impersonate_guest: Optional[str] = None,
impersonate_user: Optional[str] = None,
inheritable_path_acl: Optional[bool] = None,
mangle_byte_start: Optional[float] = None,
mangle_maps: Optional[Sequence[str]] = None,
name: Optional[str] = None,
ntfs_acl_support: Optional[bool] = None,
oplocks: Optional[bool] = None,
allow_delete_readonly: Optional[bool] = None,
access_based_enumeration_root_only: Optional[bool] = None,
run_as_roots: Optional[Sequence[SmbShareRunAsRootArgs]] = None,
smb3_encryption_enabled: Optional[bool] = None,
sparse_file: Optional[bool] = None,
strict_ca_lockout: Optional[bool] = None,
strict_flush: Optional[bool] = None,
strict_locking: Optional[bool] = None,
zone: Optional[str] = None)
func NewSmbShare(ctx *Context, name string, args SmbShareArgs, opts ...ResourceOption) (*SmbShare, error)
public SmbShare(string name, SmbShareArgs args, CustomResourceOptions? opts = null)
public SmbShare(String name, SmbShareArgs args)
public SmbShare(String name, SmbShareArgs args, CustomResourceOptions options)
type: powerscale:SmbShare
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args SmbShareArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args SmbShareArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args SmbShareArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SmbShareArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SmbShareArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var smbShareResource = new Powerscale.SmbShare("smbShareResource", new()
{
Path = "string",
Permissions = new[]
{
new Powerscale.Inputs.SmbSharePermissionArgs
{
Permission = "string",
PermissionType = "string",
Trustee = new Powerscale.Inputs.SmbSharePermissionTrusteeArgs
{
Id = "string",
Name = "string",
Type = "string",
},
},
},
FileFilteringEnabled = false,
HideDotFiles = false,
AllowVariableExpansion = false,
AutoCreateDirectory = false,
Browsable = false,
CaTimeout = 0,
CaWriteIntegrity = "string",
ChangeNotify = "string",
CreatePath = false,
HostAcls = new[]
{
"string",
},
CscPolicy = "string",
Description = "string",
DirectoryCreateMask = 0,
DirectoryCreateMode = 0,
FileCreateMask = 0,
FileCreateMode = 0,
FileFilterExtensions = new[]
{
"string",
},
FileFilterType = "string",
AllowExecuteAlways = false,
AccessBasedEnumeration = false,
CreatePermissions = "string",
ImpersonateGuest = "string",
ImpersonateUser = "string",
InheritablePathAcl = false,
MangleByteStart = 0,
MangleMaps = new[]
{
"string",
},
Name = "string",
NtfsAclSupport = false,
Oplocks = false,
AllowDeleteReadonly = false,
AccessBasedEnumerationRootOnly = false,
RunAsRoots = new[]
{
new Powerscale.Inputs.SmbShareRunAsRootArgs
{
Id = "string",
Name = "string",
Type = "string",
},
},
Smb3EncryptionEnabled = false,
SparseFile = false,
StrictCaLockout = false,
StrictFlush = false,
StrictLocking = false,
Zone = "string",
});
example, err := powerscale.NewSmbShare(ctx, "smbShareResource", &powerscale.SmbShareArgs{
Path: pulumi.String("string"),
Permissions: powerscale.SmbSharePermissionArray{
&powerscale.SmbSharePermissionArgs{
Permission: pulumi.String("string"),
PermissionType: pulumi.String("string"),
Trustee: &powerscale.SmbSharePermissionTrusteeArgs{
Id: pulumi.String("string"),
Name: pulumi.String("string"),
Type: pulumi.String("string"),
},
},
},
FileFilteringEnabled: pulumi.Bool(false),
HideDotFiles: pulumi.Bool(false),
AllowVariableExpansion: pulumi.Bool(false),
AutoCreateDirectory: pulumi.Bool(false),
Browsable: pulumi.Bool(false),
CaTimeout: pulumi.Float64(0),
CaWriteIntegrity: pulumi.String("string"),
ChangeNotify: pulumi.String("string"),
CreatePath: pulumi.Bool(false),
HostAcls: pulumi.StringArray{
pulumi.String("string"),
},
CscPolicy: pulumi.String("string"),
Description: pulumi.String("string"),
DirectoryCreateMask: pulumi.Float64(0),
DirectoryCreateMode: pulumi.Float64(0),
FileCreateMask: pulumi.Float64(0),
FileCreateMode: pulumi.Float64(0),
FileFilterExtensions: pulumi.StringArray{
pulumi.String("string"),
},
FileFilterType: pulumi.String("string"),
AllowExecuteAlways: pulumi.Bool(false),
AccessBasedEnumeration: pulumi.Bool(false),
CreatePermissions: pulumi.String("string"),
ImpersonateGuest: pulumi.String("string"),
ImpersonateUser: pulumi.String("string"),
InheritablePathAcl: pulumi.Bool(false),
MangleByteStart: pulumi.Float64(0),
MangleMaps: pulumi.StringArray{
pulumi.String("string"),
},
Name: pulumi.String("string"),
NtfsAclSupport: pulumi.Bool(false),
Oplocks: pulumi.Bool(false),
AllowDeleteReadonly: pulumi.Bool(false),
AccessBasedEnumerationRootOnly: pulumi.Bool(false),
RunAsRoots: powerscale.SmbShareRunAsRootArray{
&powerscale.SmbShareRunAsRootArgs{
Id: pulumi.String("string"),
Name: pulumi.String("string"),
Type: pulumi.String("string"),
},
},
Smb3EncryptionEnabled: pulumi.Bool(false),
SparseFile: pulumi.Bool(false),
StrictCaLockout: pulumi.Bool(false),
StrictFlush: pulumi.Bool(false),
StrictLocking: pulumi.Bool(false),
Zone: pulumi.String("string"),
})
var smbShareResource = new SmbShare("smbShareResource", SmbShareArgs.builder()
.path("string")
.permissions(SmbSharePermissionArgs.builder()
.permission("string")
.permissionType("string")
.trustee(SmbSharePermissionTrusteeArgs.builder()
.id("string")
.name("string")
.type("string")
.build())
.build())
.fileFilteringEnabled(false)
.hideDotFiles(false)
.allowVariableExpansion(false)
.autoCreateDirectory(false)
.browsable(false)
.caTimeout(0)
.caWriteIntegrity("string")
.changeNotify("string")
.createPath(false)
.hostAcls("string")
.cscPolicy("string")
.description("string")
.directoryCreateMask(0)
.directoryCreateMode(0)
.fileCreateMask(0)
.fileCreateMode(0)
.fileFilterExtensions("string")
.fileFilterType("string")
.allowExecuteAlways(false)
.accessBasedEnumeration(false)
.createPermissions("string")
.impersonateGuest("string")
.impersonateUser("string")
.inheritablePathAcl(false)
.mangleByteStart(0)
.mangleMaps("string")
.name("string")
.ntfsAclSupport(false)
.oplocks(false)
.allowDeleteReadonly(false)
.accessBasedEnumerationRootOnly(false)
.runAsRoots(SmbShareRunAsRootArgs.builder()
.id("string")
.name("string")
.type("string")
.build())
.smb3EncryptionEnabled(false)
.sparseFile(false)
.strictCaLockout(false)
.strictFlush(false)
.strictLocking(false)
.zone("string")
.build());
smb_share_resource = powerscale.SmbShare("smbShareResource",
path="string",
permissions=[{
"permission": "string",
"permission_type": "string",
"trustee": {
"id": "string",
"name": "string",
"type": "string",
},
}],
file_filtering_enabled=False,
hide_dot_files=False,
allow_variable_expansion=False,
auto_create_directory=False,
browsable=False,
ca_timeout=0,
ca_write_integrity="string",
change_notify="string",
create_path=False,
host_acls=["string"],
csc_policy="string",
description="string",
directory_create_mask=0,
directory_create_mode=0,
file_create_mask=0,
file_create_mode=0,
file_filter_extensions=["string"],
file_filter_type="string",
allow_execute_always=False,
access_based_enumeration=False,
create_permissions="string",
impersonate_guest="string",
impersonate_user="string",
inheritable_path_acl=False,
mangle_byte_start=0,
mangle_maps=["string"],
name="string",
ntfs_acl_support=False,
oplocks=False,
allow_delete_readonly=False,
access_based_enumeration_root_only=False,
run_as_roots=[{
"id": "string",
"name": "string",
"type": "string",
}],
smb3_encryption_enabled=False,
sparse_file=False,
strict_ca_lockout=False,
strict_flush=False,
strict_locking=False,
zone="string")
const smbShareResource = new powerscale.SmbShare("smbShareResource", {
path: "string",
permissions: [{
permission: "string",
permissionType: "string",
trustee: {
id: "string",
name: "string",
type: "string",
},
}],
fileFilteringEnabled: false,
hideDotFiles: false,
allowVariableExpansion: false,
autoCreateDirectory: false,
browsable: false,
caTimeout: 0,
caWriteIntegrity: "string",
changeNotify: "string",
createPath: false,
hostAcls: ["string"],
cscPolicy: "string",
description: "string",
directoryCreateMask: 0,
directoryCreateMode: 0,
fileCreateMask: 0,
fileCreateMode: 0,
fileFilterExtensions: ["string"],
fileFilterType: "string",
allowExecuteAlways: false,
accessBasedEnumeration: false,
createPermissions: "string",
impersonateGuest: "string",
impersonateUser: "string",
inheritablePathAcl: false,
mangleByteStart: 0,
mangleMaps: ["string"],
name: "string",
ntfsAclSupport: false,
oplocks: false,
allowDeleteReadonly: false,
accessBasedEnumerationRootOnly: false,
runAsRoots: [{
id: "string",
name: "string",
type: "string",
}],
smb3EncryptionEnabled: false,
sparseFile: false,
strictCaLockout: false,
strictFlush: false,
strictLocking: false,
zone: "string",
});
type: powerscale:SmbShare
properties:
accessBasedEnumeration: false
accessBasedEnumerationRootOnly: false
allowDeleteReadonly: false
allowExecuteAlways: false
allowVariableExpansion: false
autoCreateDirectory: false
browsable: false
caTimeout: 0
caWriteIntegrity: string
changeNotify: string
createPath: false
createPermissions: string
cscPolicy: string
description: string
directoryCreateMask: 0
directoryCreateMode: 0
fileCreateMask: 0
fileCreateMode: 0
fileFilterExtensions:
- string
fileFilterType: string
fileFilteringEnabled: false
hideDotFiles: false
hostAcls:
- string
impersonateGuest: string
impersonateUser: string
inheritablePathAcl: false
mangleByteStart: 0
mangleMaps:
- string
name: string
ntfsAclSupport: false
oplocks: false
path: string
permissions:
- permission: string
permissionType: string
trustee:
id: string
name: string
type: string
runAsRoots:
- id: string
name: string
type: string
smb3EncryptionEnabled: false
sparseFile: false
strictCaLockout: false
strictFlush: false
strictLocking: false
zone: string
SmbShare Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The SmbShare resource accepts the following input properties:
- Path string
- Path of share within /ifs.
- Permissions
List<Smb
Share Permission> - Specifies an ordered list of permission modifications.
- Access
Based boolEnumeration - Only enumerate files and folders the requesting user has access to.
- Access
Based boolEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- Allow
Delete boolReadonly - Allow deletion of read-only files in the share.
- Allow
Execute boolAlways - Allows users to execute files they have read rights for.
- Allow
Variable boolExpansion - Allow automatic expansion of variables for home directories.
- Auto
Create boolDirectory - Automatically create home directories.
- Browsable bool
- Share is visible in net view and the browse list.
- Ca
Timeout double - Persistent open timeout for the share.
- Ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- Change
Notify string - Level of change notification alerts on the share.
- Create
Path bool - Create path if does not exist.
- Create
Permissions string - Create permissions for new files and directories in share.
- Csc
Policy string - Client-side caching policy for the shares.
- Description string
- Description for this SMB share.
- Directory
Create doubleMask - Directory create mask bits.
- Directory
Create doubleMode - Directory create mode bits.
- File
Create doubleMask - File create mask bits.
- File
Create doubleMode - File create mode bits.
- File
Filter List<string>Extensions - Specifies the list of file extensions.
- File
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- File
Filtering boolEnabled - Enables file filtering on this zone.
- Hide
Dot boolFiles - Hide files and directories that begin with a period '.'.
- Host
Acls List<string> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- Impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- Impersonate
User string - User account to be used as guest account.
- Inheritable
Path boolAcl - Set the inheritable ACL on the share path.
- Mangle
Byte doubleStart - Specifies the wchar_t starting point for automatic byte mangling.
- Mangle
Maps List<string> - Character mangle map.
- Name string
- Share name.
- Ntfs
Acl boolSupport - Support NTFS ACLs on files and directories.
- Oplocks bool
- Support oplocks.
- Run
As List<SmbRoots Share Run As Root> - Allow account to run as root.
- Smb3Encryption
Enabled bool - Enables SMB3 encryption for the share.
- Sparse
File bool - Enables sparse file.
- Strict
Ca boolLockout - Specifies if persistent opens would do strict lockout on the share.
- Strict
Flush bool - Handle SMB flush operations.
- Strict
Locking bool - Specifies whether byte range locks contend against SMB I/O.
- Zone string
- Name of the access zone to which to move this SMB share.
- Path string
- Path of share within /ifs.
- Permissions
[]Smb
Share Permission Args - Specifies an ordered list of permission modifications.
- Access
Based boolEnumeration - Only enumerate files and folders the requesting user has access to.
- Access
Based boolEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- Allow
Delete boolReadonly - Allow deletion of read-only files in the share.
- Allow
Execute boolAlways - Allows users to execute files they have read rights for.
- Allow
Variable boolExpansion - Allow automatic expansion of variables for home directories.
- Auto
Create boolDirectory - Automatically create home directories.
- Browsable bool
- Share is visible in net view and the browse list.
- Ca
Timeout float64 - Persistent open timeout for the share.
- Ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- Change
Notify string - Level of change notification alerts on the share.
- Create
Path bool - Create path if does not exist.
- Create
Permissions string - Create permissions for new files and directories in share.
- Csc
Policy string - Client-side caching policy for the shares.
- Description string
- Description for this SMB share.
- Directory
Create float64Mask - Directory create mask bits.
- Directory
Create float64Mode - Directory create mode bits.
- File
Create float64Mask - File create mask bits.
- File
Create float64Mode - File create mode bits.
- File
Filter []stringExtensions - Specifies the list of file extensions.
- File
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- File
Filtering boolEnabled - Enables file filtering on this zone.
- Hide
Dot boolFiles - Hide files and directories that begin with a period '.'.
- Host
Acls []string - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- Impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- Impersonate
User string - User account to be used as guest account.
- Inheritable
Path boolAcl - Set the inheritable ACL on the share path.
- Mangle
Byte float64Start - Specifies the wchar_t starting point for automatic byte mangling.
- Mangle
Maps []string - Character mangle map.
- Name string
- Share name.
- Ntfs
Acl boolSupport - Support NTFS ACLs on files and directories.
- Oplocks bool
- Support oplocks.
- Run
As []SmbRoots Share Run As Root Args - Allow account to run as root.
- Smb3Encryption
Enabled bool - Enables SMB3 encryption for the share.
- Sparse
File bool - Enables sparse file.
- Strict
Ca boolLockout - Specifies if persistent opens would do strict lockout on the share.
- Strict
Flush bool - Handle SMB flush operations.
- Strict
Locking bool - Specifies whether byte range locks contend against SMB I/O.
- Zone string
- Name of the access zone to which to move this SMB share.
- path String
- Path of share within /ifs.
- permissions
List<Smb
Share Permission> - Specifies an ordered list of permission modifications.
- access
Based BooleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based BooleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete BooleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute BooleanAlways - Allows users to execute files they have read rights for.
- allow
Variable BooleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create BooleanDirectory - Automatically create home directories.
- browsable Boolean
- Share is visible in net view and the browse list.
- ca
Timeout Double - Persistent open timeout for the share.
- ca
Write StringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify String - Level of change notification alerts on the share.
- create
Path Boolean - Create path if does not exist.
- create
Permissions String - Create permissions for new files and directories in share.
- csc
Policy String - Client-side caching policy for the shares.
- description String
- Description for this SMB share.
- directory
Create DoubleMask - Directory create mask bits.
- directory
Create DoubleMode - Directory create mode bits.
- file
Create DoubleMask - File create mask bits.
- file
Create DoubleMode - File create mode bits.
- file
Filter List<String>Extensions - Specifies the list of file extensions.
- file
Filter StringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering BooleanEnabled - Enables file filtering on this zone.
- hide
Dot BooleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls List<String> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest String - Specify the condition in which user access is done as the guest account.
- impersonate
User String - User account to be used as guest account.
- inheritable
Path BooleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte DoubleStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps List<String> - Character mangle map.
- name String
- Share name.
- ntfs
Acl BooleanSupport - Support NTFS ACLs on files and directories.
- oplocks Boolean
- Support oplocks.
- run
As List<SmbRoots Share Run As Root> - Allow account to run as root.
- smb3Encryption
Enabled Boolean - Enables SMB3 encryption for the share.
- sparse
File Boolean - Enables sparse file.
- strict
Ca BooleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush Boolean - Handle SMB flush operations.
- strict
Locking Boolean - Specifies whether byte range locks contend against SMB I/O.
- zone String
- Name of the access zone to which to move this SMB share.
- path string
- Path of share within /ifs.
- permissions
Smb
Share Permission[] - Specifies an ordered list of permission modifications.
- access
Based booleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based booleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete booleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute booleanAlways - Allows users to execute files they have read rights for.
- allow
Variable booleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create booleanDirectory - Automatically create home directories.
- browsable boolean
- Share is visible in net view and the browse list.
- ca
Timeout number - Persistent open timeout for the share.
- ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify string - Level of change notification alerts on the share.
- create
Path boolean - Create path if does not exist.
- create
Permissions string - Create permissions for new files and directories in share.
- csc
Policy string - Client-side caching policy for the shares.
- description string
- Description for this SMB share.
- directory
Create numberMask - Directory create mask bits.
- directory
Create numberMode - Directory create mode bits.
- file
Create numberMask - File create mask bits.
- file
Create numberMode - File create mode bits.
- file
Filter string[]Extensions - Specifies the list of file extensions.
- file
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering booleanEnabled - Enables file filtering on this zone.
- hide
Dot booleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls string[] - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- impersonate
User string - User account to be used as guest account.
- inheritable
Path booleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte numberStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps string[] - Character mangle map.
- name string
- Share name.
- ntfs
Acl booleanSupport - Support NTFS ACLs on files and directories.
- oplocks boolean
- Support oplocks.
- run
As SmbRoots Share Run As Root[] - Allow account to run as root.
- smb3Encryption
Enabled boolean - Enables SMB3 encryption for the share.
- sparse
File boolean - Enables sparse file.
- strict
Ca booleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush boolean - Handle SMB flush operations.
- strict
Locking boolean - Specifies whether byte range locks contend against SMB I/O.
- zone string
- Name of the access zone to which to move this SMB share.
- path str
- Path of share within /ifs.
- permissions
Sequence[Smb
Share Permission Args] - Specifies an ordered list of permission modifications.
- access_
based_ boolenumeration - Only enumerate files and folders the requesting user has access to.
- access_
based_ boolenumeration_ root_ only - Access-based enumeration on only the root directory of the share.
- allow_
delete_ boolreadonly - Allow deletion of read-only files in the share.
- allow_
execute_ boolalways - Allows users to execute files they have read rights for.
- allow_
variable_ boolexpansion - Allow automatic expansion of variables for home directories.
- auto_
create_ booldirectory - Automatically create home directories.
- browsable bool
- Share is visible in net view and the browse list.
- ca_
timeout float - Persistent open timeout for the share.
- ca_
write_ strintegrity - Specify the level of write-integrity on continuously available shares.
- change_
notify str - Level of change notification alerts on the share.
- create_
path bool - Create path if does not exist.
- create_
permissions str - Create permissions for new files and directories in share.
- csc_
policy str - Client-side caching policy for the shares.
- description str
- Description for this SMB share.
- directory_
create_ floatmask - Directory create mask bits.
- directory_
create_ floatmode - Directory create mode bits.
- file_
create_ floatmask - File create mask bits.
- file_
create_ floatmode - File create mode bits.
- file_
filter_ Sequence[str]extensions - Specifies the list of file extensions.
- file_
filter_ strtype - Specifies if filter list is for deny or allow. Default is deny.
- file_
filtering_ boolenabled - Enables file filtering on this zone.
- hide_
dot_ boolfiles - Hide files and directories that begin with a period '.'.
- host_
acls Sequence[str] - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate_
guest str - Specify the condition in which user access is done as the guest account.
- impersonate_
user str - User account to be used as guest account.
- inheritable_
path_ boolacl - Set the inheritable ACL on the share path.
- mangle_
byte_ floatstart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle_
maps Sequence[str] - Character mangle map.
- name str
- Share name.
- ntfs_
acl_ boolsupport - Support NTFS ACLs on files and directories.
- oplocks bool
- Support oplocks.
- run_
as_ Sequence[Smbroots Share Run As Root Args] - Allow account to run as root.
- smb3_
encryption_ boolenabled - Enables SMB3 encryption for the share.
- sparse_
file bool - Enables sparse file.
- strict_
ca_ boollockout - Specifies if persistent opens would do strict lockout on the share.
- strict_
flush bool - Handle SMB flush operations.
- strict_
locking bool - Specifies whether byte range locks contend against SMB I/O.
- zone str
- Name of the access zone to which to move this SMB share.
- path String
- Path of share within /ifs.
- permissions List<Property Map>
- Specifies an ordered list of permission modifications.
- access
Based BooleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based BooleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete BooleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute BooleanAlways - Allows users to execute files they have read rights for.
- allow
Variable BooleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create BooleanDirectory - Automatically create home directories.
- browsable Boolean
- Share is visible in net view and the browse list.
- ca
Timeout Number - Persistent open timeout for the share.
- ca
Write StringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify String - Level of change notification alerts on the share.
- create
Path Boolean - Create path if does not exist.
- create
Permissions String - Create permissions for new files and directories in share.
- csc
Policy String - Client-side caching policy for the shares.
- description String
- Description for this SMB share.
- directory
Create NumberMask - Directory create mask bits.
- directory
Create NumberMode - Directory create mode bits.
- file
Create NumberMask - File create mask bits.
- file
Create NumberMode - File create mode bits.
- file
Filter List<String>Extensions - Specifies the list of file extensions.
- file
Filter StringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering BooleanEnabled - Enables file filtering on this zone.
- hide
Dot BooleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls List<String> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest String - Specify the condition in which user access is done as the guest account.
- impersonate
User String - User account to be used as guest account.
- inheritable
Path BooleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte NumberStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps List<String> - Character mangle map.
- name String
- Share name.
- ntfs
Acl BooleanSupport - Support NTFS ACLs on files and directories.
- oplocks Boolean
- Support oplocks.
- run
As List<Property Map>Roots - Allow account to run as root.
- smb3Encryption
Enabled Boolean - Enables SMB3 encryption for the share.
- sparse
File Boolean - Enables sparse file.
- strict
Ca BooleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush Boolean - Handle SMB flush operations.
- strict
Locking Boolean - Specifies whether byte range locks contend against SMB I/O.
- zone String
- Name of the access zone to which to move this SMB share.
Outputs
All input properties are implicitly available as output properties. Additionally, the SmbShare resource produces the following output properties:
- Continuously
Available bool - Specify if persistent opens are allowed on the share.
- Id string
- The provider-assigned unique ID for this managed resource.
- Zid double
- Numeric ID of the access zone which contains this SMB share.
- Continuously
Available bool - Specify if persistent opens are allowed on the share.
- Id string
- The provider-assigned unique ID for this managed resource.
- Zid float64
- Numeric ID of the access zone which contains this SMB share.
- continuously
Available Boolean - Specify if persistent opens are allowed on the share.
- id String
- The provider-assigned unique ID for this managed resource.
- zid Double
- Numeric ID of the access zone which contains this SMB share.
- continuously
Available boolean - Specify if persistent opens are allowed on the share.
- id string
- The provider-assigned unique ID for this managed resource.
- zid number
- Numeric ID of the access zone which contains this SMB share.
- continuously_
available bool - Specify if persistent opens are allowed on the share.
- id str
- The provider-assigned unique ID for this managed resource.
- zid float
- Numeric ID of the access zone which contains this SMB share.
- continuously
Available Boolean - Specify if persistent opens are allowed on the share.
- id String
- The provider-assigned unique ID for this managed resource.
- zid Number
- Numeric ID of the access zone which contains this SMB share.
Look up Existing SmbShare Resource
Get an existing SmbShare resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: SmbShareState, opts?: CustomResourceOptions): SmbShare
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
access_based_enumeration: Optional[bool] = None,
access_based_enumeration_root_only: Optional[bool] = None,
allow_delete_readonly: Optional[bool] = None,
allow_execute_always: Optional[bool] = None,
allow_variable_expansion: Optional[bool] = None,
auto_create_directory: Optional[bool] = None,
browsable: Optional[bool] = None,
ca_timeout: Optional[float] = None,
ca_write_integrity: Optional[str] = None,
change_notify: Optional[str] = None,
continuously_available: Optional[bool] = None,
create_path: Optional[bool] = None,
create_permissions: Optional[str] = None,
csc_policy: Optional[str] = None,
description: Optional[str] = None,
directory_create_mask: Optional[float] = None,
directory_create_mode: Optional[float] = None,
file_create_mask: Optional[float] = None,
file_create_mode: Optional[float] = None,
file_filter_extensions: Optional[Sequence[str]] = None,
file_filter_type: Optional[str] = None,
file_filtering_enabled: Optional[bool] = None,
hide_dot_files: Optional[bool] = None,
host_acls: Optional[Sequence[str]] = None,
impersonate_guest: Optional[str] = None,
impersonate_user: Optional[str] = None,
inheritable_path_acl: Optional[bool] = None,
mangle_byte_start: Optional[float] = None,
mangle_maps: Optional[Sequence[str]] = None,
name: Optional[str] = None,
ntfs_acl_support: Optional[bool] = None,
oplocks: Optional[bool] = None,
path: Optional[str] = None,
permissions: Optional[Sequence[SmbSharePermissionArgs]] = None,
run_as_roots: Optional[Sequence[SmbShareRunAsRootArgs]] = None,
smb3_encryption_enabled: Optional[bool] = None,
sparse_file: Optional[bool] = None,
strict_ca_lockout: Optional[bool] = None,
strict_flush: Optional[bool] = None,
strict_locking: Optional[bool] = None,
zid: Optional[float] = None,
zone: Optional[str] = None) -> SmbShare
func GetSmbShare(ctx *Context, name string, id IDInput, state *SmbShareState, opts ...ResourceOption) (*SmbShare, error)
public static SmbShare Get(string name, Input<string> id, SmbShareState? state, CustomResourceOptions? opts = null)
public static SmbShare get(String name, Output<String> id, SmbShareState state, CustomResourceOptions options)
resources: _: type: powerscale:SmbShare get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Access
Based boolEnumeration - Only enumerate files and folders the requesting user has access to.
- Access
Based boolEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- Allow
Delete boolReadonly - Allow deletion of read-only files in the share.
- Allow
Execute boolAlways - Allows users to execute files they have read rights for.
- Allow
Variable boolExpansion - Allow automatic expansion of variables for home directories.
- Auto
Create boolDirectory - Automatically create home directories.
- Browsable bool
- Share is visible in net view and the browse list.
- Ca
Timeout double - Persistent open timeout for the share.
- Ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- Change
Notify string - Level of change notification alerts on the share.
- Continuously
Available bool - Specify if persistent opens are allowed on the share.
- Create
Path bool - Create path if does not exist.
- Create
Permissions string - Create permissions for new files and directories in share.
- Csc
Policy string - Client-side caching policy for the shares.
- Description string
- Description for this SMB share.
- Directory
Create doubleMask - Directory create mask bits.
- Directory
Create doubleMode - Directory create mode bits.
- File
Create doubleMask - File create mask bits.
- File
Create doubleMode - File create mode bits.
- File
Filter List<string>Extensions - Specifies the list of file extensions.
- File
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- File
Filtering boolEnabled - Enables file filtering on this zone.
- Hide
Dot boolFiles - Hide files and directories that begin with a period '.'.
- Host
Acls List<string> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- Impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- Impersonate
User string - User account to be used as guest account.
- Inheritable
Path boolAcl - Set the inheritable ACL on the share path.
- Mangle
Byte doubleStart - Specifies the wchar_t starting point for automatic byte mangling.
- Mangle
Maps List<string> - Character mangle map.
- Name string
- Share name.
- Ntfs
Acl boolSupport - Support NTFS ACLs on files and directories.
- Oplocks bool
- Support oplocks.
- Path string
- Path of share within /ifs.
- Permissions
List<Smb
Share Permission> - Specifies an ordered list of permission modifications.
- Run
As List<SmbRoots Share Run As Root> - Allow account to run as root.
- Smb3Encryption
Enabled bool - Enables SMB3 encryption for the share.
- Sparse
File bool - Enables sparse file.
- Strict
Ca boolLockout - Specifies if persistent opens would do strict lockout on the share.
- Strict
Flush bool - Handle SMB flush operations.
- Strict
Locking bool - Specifies whether byte range locks contend against SMB I/O.
- Zid double
- Numeric ID of the access zone which contains this SMB share.
- Zone string
- Name of the access zone to which to move this SMB share.
- Access
Based boolEnumeration - Only enumerate files and folders the requesting user has access to.
- Access
Based boolEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- Allow
Delete boolReadonly - Allow deletion of read-only files in the share.
- Allow
Execute boolAlways - Allows users to execute files they have read rights for.
- Allow
Variable boolExpansion - Allow automatic expansion of variables for home directories.
- Auto
Create boolDirectory - Automatically create home directories.
- Browsable bool
- Share is visible in net view and the browse list.
- Ca
Timeout float64 - Persistent open timeout for the share.
- Ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- Change
Notify string - Level of change notification alerts on the share.
- Continuously
Available bool - Specify if persistent opens are allowed on the share.
- Create
Path bool - Create path if does not exist.
- Create
Permissions string - Create permissions for new files and directories in share.
- Csc
Policy string - Client-side caching policy for the shares.
- Description string
- Description for this SMB share.
- Directory
Create float64Mask - Directory create mask bits.
- Directory
Create float64Mode - Directory create mode bits.
- File
Create float64Mask - File create mask bits.
- File
Create float64Mode - File create mode bits.
- File
Filter []stringExtensions - Specifies the list of file extensions.
- File
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- File
Filtering boolEnabled - Enables file filtering on this zone.
- Hide
Dot boolFiles - Hide files and directories that begin with a period '.'.
- Host
Acls []string - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- Impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- Impersonate
User string - User account to be used as guest account.
- Inheritable
Path boolAcl - Set the inheritable ACL on the share path.
- Mangle
Byte float64Start - Specifies the wchar_t starting point for automatic byte mangling.
- Mangle
Maps []string - Character mangle map.
- Name string
- Share name.
- Ntfs
Acl boolSupport - Support NTFS ACLs on files and directories.
- Oplocks bool
- Support oplocks.
- Path string
- Path of share within /ifs.
- Permissions
[]Smb
Share Permission Args - Specifies an ordered list of permission modifications.
- Run
As []SmbRoots Share Run As Root Args - Allow account to run as root.
- Smb3Encryption
Enabled bool - Enables SMB3 encryption for the share.
- Sparse
File bool - Enables sparse file.
- Strict
Ca boolLockout - Specifies if persistent opens would do strict lockout on the share.
- Strict
Flush bool - Handle SMB flush operations.
- Strict
Locking bool - Specifies whether byte range locks contend against SMB I/O.
- Zid float64
- Numeric ID of the access zone which contains this SMB share.
- Zone string
- Name of the access zone to which to move this SMB share.
- access
Based BooleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based BooleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete BooleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute BooleanAlways - Allows users to execute files they have read rights for.
- allow
Variable BooleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create BooleanDirectory - Automatically create home directories.
- browsable Boolean
- Share is visible in net view and the browse list.
- ca
Timeout Double - Persistent open timeout for the share.
- ca
Write StringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify String - Level of change notification alerts on the share.
- continuously
Available Boolean - Specify if persistent opens are allowed on the share.
- create
Path Boolean - Create path if does not exist.
- create
Permissions String - Create permissions for new files and directories in share.
- csc
Policy String - Client-side caching policy for the shares.
- description String
- Description for this SMB share.
- directory
Create DoubleMask - Directory create mask bits.
- directory
Create DoubleMode - Directory create mode bits.
- file
Create DoubleMask - File create mask bits.
- file
Create DoubleMode - File create mode bits.
- file
Filter List<String>Extensions - Specifies the list of file extensions.
- file
Filter StringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering BooleanEnabled - Enables file filtering on this zone.
- hide
Dot BooleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls List<String> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest String - Specify the condition in which user access is done as the guest account.
- impersonate
User String - User account to be used as guest account.
- inheritable
Path BooleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte DoubleStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps List<String> - Character mangle map.
- name String
- Share name.
- ntfs
Acl BooleanSupport - Support NTFS ACLs on files and directories.
- oplocks Boolean
- Support oplocks.
- path String
- Path of share within /ifs.
- permissions
List<Smb
Share Permission> - Specifies an ordered list of permission modifications.
- run
As List<SmbRoots Share Run As Root> - Allow account to run as root.
- smb3Encryption
Enabled Boolean - Enables SMB3 encryption for the share.
- sparse
File Boolean - Enables sparse file.
- strict
Ca BooleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush Boolean - Handle SMB flush operations.
- strict
Locking Boolean - Specifies whether byte range locks contend against SMB I/O.
- zid Double
- Numeric ID of the access zone which contains this SMB share.
- zone String
- Name of the access zone to which to move this SMB share.
- access
Based booleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based booleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete booleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute booleanAlways - Allows users to execute files they have read rights for.
- allow
Variable booleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create booleanDirectory - Automatically create home directories.
- browsable boolean
- Share is visible in net view and the browse list.
- ca
Timeout number - Persistent open timeout for the share.
- ca
Write stringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify string - Level of change notification alerts on the share.
- continuously
Available boolean - Specify if persistent opens are allowed on the share.
- create
Path boolean - Create path if does not exist.
- create
Permissions string - Create permissions for new files and directories in share.
- csc
Policy string - Client-side caching policy for the shares.
- description string
- Description for this SMB share.
- directory
Create numberMask - Directory create mask bits.
- directory
Create numberMode - Directory create mode bits.
- file
Create numberMask - File create mask bits.
- file
Create numberMode - File create mode bits.
- file
Filter string[]Extensions - Specifies the list of file extensions.
- file
Filter stringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering booleanEnabled - Enables file filtering on this zone.
- hide
Dot booleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls string[] - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest string - Specify the condition in which user access is done as the guest account.
- impersonate
User string - User account to be used as guest account.
- inheritable
Path booleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte numberStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps string[] - Character mangle map.
- name string
- Share name.
- ntfs
Acl booleanSupport - Support NTFS ACLs on files and directories.
- oplocks boolean
- Support oplocks.
- path string
- Path of share within /ifs.
- permissions
Smb
Share Permission[] - Specifies an ordered list of permission modifications.
- run
As SmbRoots Share Run As Root[] - Allow account to run as root.
- smb3Encryption
Enabled boolean - Enables SMB3 encryption for the share.
- sparse
File boolean - Enables sparse file.
- strict
Ca booleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush boolean - Handle SMB flush operations.
- strict
Locking boolean - Specifies whether byte range locks contend against SMB I/O.
- zid number
- Numeric ID of the access zone which contains this SMB share.
- zone string
- Name of the access zone to which to move this SMB share.
- access_
based_ boolenumeration - Only enumerate files and folders the requesting user has access to.
- access_
based_ boolenumeration_ root_ only - Access-based enumeration on only the root directory of the share.
- allow_
delete_ boolreadonly - Allow deletion of read-only files in the share.
- allow_
execute_ boolalways - Allows users to execute files they have read rights for.
- allow_
variable_ boolexpansion - Allow automatic expansion of variables for home directories.
- auto_
create_ booldirectory - Automatically create home directories.
- browsable bool
- Share is visible in net view and the browse list.
- ca_
timeout float - Persistent open timeout for the share.
- ca_
write_ strintegrity - Specify the level of write-integrity on continuously available shares.
- change_
notify str - Level of change notification alerts on the share.
- continuously_
available bool - Specify if persistent opens are allowed on the share.
- create_
path bool - Create path if does not exist.
- create_
permissions str - Create permissions for new files and directories in share.
- csc_
policy str - Client-side caching policy for the shares.
- description str
- Description for this SMB share.
- directory_
create_ floatmask - Directory create mask bits.
- directory_
create_ floatmode - Directory create mode bits.
- file_
create_ floatmask - File create mask bits.
- file_
create_ floatmode - File create mode bits.
- file_
filter_ Sequence[str]extensions - Specifies the list of file extensions.
- file_
filter_ strtype - Specifies if filter list is for deny or allow. Default is deny.
- file_
filtering_ boolenabled - Enables file filtering on this zone.
- hide_
dot_ boolfiles - Hide files and directories that begin with a period '.'.
- host_
acls Sequence[str] - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate_
guest str - Specify the condition in which user access is done as the guest account.
- impersonate_
user str - User account to be used as guest account.
- inheritable_
path_ boolacl - Set the inheritable ACL on the share path.
- mangle_
byte_ floatstart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle_
maps Sequence[str] - Character mangle map.
- name str
- Share name.
- ntfs_
acl_ boolsupport - Support NTFS ACLs on files and directories.
- oplocks bool
- Support oplocks.
- path str
- Path of share within /ifs.
- permissions
Sequence[Smb
Share Permission Args] - Specifies an ordered list of permission modifications.
- run_
as_ Sequence[Smbroots Share Run As Root Args] - Allow account to run as root.
- smb3_
encryption_ boolenabled - Enables SMB3 encryption for the share.
- sparse_
file bool - Enables sparse file.
- strict_
ca_ boollockout - Specifies if persistent opens would do strict lockout on the share.
- strict_
flush bool - Handle SMB flush operations.
- strict_
locking bool - Specifies whether byte range locks contend against SMB I/O.
- zid float
- Numeric ID of the access zone which contains this SMB share.
- zone str
- Name of the access zone to which to move this SMB share.
- access
Based BooleanEnumeration - Only enumerate files and folders the requesting user has access to.
- access
Based BooleanEnumeration Root Only - Access-based enumeration on only the root directory of the share.
- allow
Delete BooleanReadonly - Allow deletion of read-only files in the share.
- allow
Execute BooleanAlways - Allows users to execute files they have read rights for.
- allow
Variable BooleanExpansion - Allow automatic expansion of variables for home directories.
- auto
Create BooleanDirectory - Automatically create home directories.
- browsable Boolean
- Share is visible in net view and the browse list.
- ca
Timeout Number - Persistent open timeout for the share.
- ca
Write StringIntegrity - Specify the level of write-integrity on continuously available shares.
- change
Notify String - Level of change notification alerts on the share.
- continuously
Available Boolean - Specify if persistent opens are allowed on the share.
- create
Path Boolean - Create path if does not exist.
- create
Permissions String - Create permissions for new files and directories in share.
- csc
Policy String - Client-side caching policy for the shares.
- description String
- Description for this SMB share.
- directory
Create NumberMask - Directory create mask bits.
- directory
Create NumberMode - Directory create mode bits.
- file
Create NumberMask - File create mask bits.
- file
Create NumberMode - File create mode bits.
- file
Filter List<String>Extensions - Specifies the list of file extensions.
- file
Filter StringType - Specifies if filter list is for deny or allow. Default is deny.
- file
Filtering BooleanEnabled - Enables file filtering on this zone.
- hide
Dot BooleanFiles - Hide files and directories that begin with a period '.'.
- host
Acls List<String> - An ACL expressing which hosts are allowed access. A deny clause must be the final entry.
- impersonate
Guest String - Specify the condition in which user access is done as the guest account.
- impersonate
User String - User account to be used as guest account.
- inheritable
Path BooleanAcl - Set the inheritable ACL on the share path.
- mangle
Byte NumberStart - Specifies the wchar_t starting point for automatic byte mangling.
- mangle
Maps List<String> - Character mangle map.
- name String
- Share name.
- ntfs
Acl BooleanSupport - Support NTFS ACLs on files and directories.
- oplocks Boolean
- Support oplocks.
- path String
- Path of share within /ifs.
- permissions List<Property Map>
- Specifies an ordered list of permission modifications.
- run
As List<Property Map>Roots - Allow account to run as root.
- smb3Encryption
Enabled Boolean - Enables SMB3 encryption for the share.
- sparse
File Boolean - Enables sparse file.
- strict
Ca BooleanLockout - Specifies if persistent opens would do strict lockout on the share.
- strict
Flush Boolean - Handle SMB flush operations.
- strict
Locking Boolean - Specifies whether byte range locks contend against SMB I/O.
- zid Number
- Numeric ID of the access zone which contains this SMB share.
- zone String
- Name of the access zone to which to move this SMB share.
Supporting Types
SmbSharePermission, SmbSharePermissionArgs
- Permission string
- Specifies the file system rights that are allowed or denied.
- Permission
Type string - Determines whether the permission is allowed or denied.
- Trustee
Smb
Share Permission Trustee - Specifies the persona of the file group.
- Permission string
- Specifies the file system rights that are allowed or denied.
- Permission
Type string - Determines whether the permission is allowed or denied.
- Trustee
Smb
Share Permission Trustee - Specifies the persona of the file group.
- permission String
- Specifies the file system rights that are allowed or denied.
- permission
Type String - Determines whether the permission is allowed or denied.
- trustee
Smb
Share Permission Trustee - Specifies the persona of the file group.
- permission string
- Specifies the file system rights that are allowed or denied.
- permission
Type string - Determines whether the permission is allowed or denied.
- trustee
Smb
Share Permission Trustee - Specifies the persona of the file group.
- permission str
- Specifies the file system rights that are allowed or denied.
- permission_
type str - Determines whether the permission is allowed or denied.
- trustee
Smb
Share Permission Trustee - Specifies the persona of the file group.
- permission String
- Specifies the file system rights that are allowed or denied.
- permission
Type String - Determines whether the permission is allowed or denied.
- trustee Property Map
- Specifies the persona of the file group.
SmbSharePermissionTrustee, SmbSharePermissionTrusteeArgs
SmbShareRunAsRoot, SmbShareRunAsRootArgs
Import
Copyright (c) 2023-2024 Dell Inc., or its subsidiaries. All Rights Reserved.
Licensed under the Mozilla Public License Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://mozilla.org/MPL/2.0/
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
The command is
$ pulumi import powerscale:index/smbShare:SmbShare share_example [<zoneID>]:<name>
Example 1:
$ pulumi import powerscale:index/smbShare:SmbShare share_example example_share
Example 2:
$ pulumi import powerscale:index/smbShare:SmbShare share_example zone_id:example_share
after running this command, populate the name field and other required parameters in the config file to start managing this resource.
Note: running “terraform show” after importing shows the current config/state of the resource. You can copy/paste that config to make it easier to manage the resource.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- powerscale dell/terraform-provider-powerscale
- License
- Notes
- This Pulumi package is based on the
powerscale
Terraform Provider.