BlobLeaseClient.BreakAsync Methode

Definition

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paket:

Azure.Storage.Blobs v12.20.0

Quelle:

BlobLeaseClient.cs

Der BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) Vorgang unterbricht die zuvor erworbene Lease des Blobs oder Containers (sofern vorhanden).

Nachdem eine Lease unterbrochen wurde, kann sie nicht verlängert werden. Die Lease kann von jeder autorisierten Anforderung unterbrochen werden. In der Anforderung muss keine übereinstimmende Lease-ID angegeben werden. Wenn eine Lease unterbrochen wird, kann die Leaseunterbrechung breakPeriod verstreichen, während derer kein Leasevorgang außer BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) und ReleaseAsync(RequestConditions, CancellationToken) für das Blob oder Container ausgeführt werden kann. Wenn eine Lease erfolgreich unterbrochen wurde, gibt die Antwort das Intervall in Sekunden an, bis eine neue Lease abgerufen werden kann.

Eine Lease, die unterbrochen wurde, kann auch freigegeben werden. Ein Client kann sofort eine freigegebene Blob- oder Containerlease abrufen.

Weitere Informationen finden Sie unter Leasecontainer.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobLease>> BreakAsync (TimeSpan? breakPeriod = default, Azure.RequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member BreakAsync : Nullable<TimeSpan> * Azure.RequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobLease>>
override this.BreakAsync : Nullable<TimeSpan> * Azure.RequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobLease>>

Public Overridable Function BreakAsync (Optional breakPeriod As Nullable(Of TimeSpan) = Nothing, Optional conditions As RequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobLease))

Parameter

breakPeriod

Nullable<TimeSpan>

Gibt die vorgeschlagene Dauer an, für die die Lease fortgesetzt werden soll, bevor sie unterbrochen wird( in Sekunden) zwischen 0 und 60. Dieser Unterbrechungszeitraum wird nur verwendet, wenn er kürzer als die verbleibende Zeit für die Lease ist. Ist er länger, wird die verbleibende Zeit für die Lease verwendet. Eine neue Lease ist erst verfügbar, wenn der Unterbrechungszeitraum abgelaufen ist. Allerdings ist es möglich, dass die Lease länger als der Unterbrechungszeitraum beibehalten wird. Wenn dieser Wert nicht angegeben wird, wird ein Lease mit fester Dauer nach Ablauf des verbleibenden Leasezeitraums unterbrochen, und eine unbegrenzte Lease bricht sofort.

conditions

RequestConditions

Optional BlobLeaseRequestConditions , um Bedingungen für das Unterbrechen einer Lease hinzuzufügen.

cancellationToken

CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Task<Response<BlobLease>>

Ein Response<T> , der die fehlerhafte Lease beschreibt.

Hinweise

Ein RequestFailedException wird ausgelöst, wenn ein Fehler auftritt.