ShareLeaseClient.Acquire(Nullable<TimeSpan>, CancellationToken) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The Acquire(Nullable<TimeSpan>, CancellationToken) operation acquires a lease on the file.
If the file does not have an active lease, the File service creates a lease on the file and returns it. If the file has an active lease, you can only request a new lease using the active lease ID as LeaseId
public virtual Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease> Acquire (TimeSpan? duration = default, System.Threading.CancellationToken cancellationToken = default);abstract member Acquire : Nullable<TimeSpan> * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease>
override this.Acquire : Nullable<TimeSpan> * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileLease>Public Overridable Function Acquire (Optional duration As Nullable(Of TimeSpan) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of ShareFileLease)Parameters
Specifies the duration of the lease, in seconds, or specify InfiniteLeaseDuration for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. Files only support infinite lease. A lease duration cannot be changed using RenewAsync(CancellationToken) or ChangeAsync(String, CancellationToken).
Optional CancellationToken to propagate notifications that the operation should be cancelled.- cancellationToken
- CancellationToken
Returns
A Response<T> describing the lease.
Remarks
A RequestFailedException will be thrown if a failure occurs.
Applies to
Azure SDK for .NET