ShareClient.CreatePermissionAsync(String, CancellationToken) Method

Definition

Creates a permission (a security descriptor) at the share level. The created security descriptor can be used for the files/directories in the share.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.PermissionInfo>> CreatePermissionAsync (string permission, System.Threading.CancellationToken cancellationToken = default);
abstract member CreatePermissionAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.PermissionInfo>>
override this.CreatePermissionAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.PermissionInfo>>
Public Overridable Function CreatePermissionAsync (permission As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of PermissionInfo))

Parameters

permission
String

File permission in the Security Descriptor Definition Language (SDDL). SDDL must have an owner, group, and discretionary access control list (DACL). The provided SDDL string format of the security descriptor should not have domain relative identifier (like 'DU', 'DA', 'DD' etc) in it.

cancellationToken
CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

A Response<T> with ID of the newly created file permission.

Applies to