Share via


ShareClient.GetPermissionAsync Method

Definition

Gets the file permission in Security Descriptor Definition Language (SDDL). Note that this API is not applicable for Share Snapshots.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFilePermission>> GetPermissionAsync (string filePermissionKey, Azure.Storage.Files.Shares.Models.FilePermissionFormat? filePermissionFormat = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetPermissionAsync : string * Nullable<Azure.Storage.Files.Shares.Models.FilePermissionFormat> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFilePermission>>
override this.GetPermissionAsync : string * Nullable<Azure.Storage.Files.Shares.Models.FilePermissionFormat> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareFilePermission>>
Public Overridable Function GetPermissionAsync (filePermissionKey As String, Optional filePermissionFormat As Nullable(Of FilePermissionFormat) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of ShareFilePermission))

Parameters

filePermissionKey
String

The file permission key.

filePermissionFormat
Nullable<FilePermissionFormat>

Optional. Available for version 2024-11-04 and later. Specifies the format in which the permission is returned. If filePermissionFormat is unspecified or explicityly set to Sddl, the permission will be returned in SSDL format. If filePermissionFormat is explicity set to Binary, the permission is returned as a base64 string representing the binary encoding of the permission in self-relative format.

cancellationToken
CancellationToken

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

Returns

A Response<T> file permission.

Applies to