BlobLeaseClient.BreakAsync Méthode

Définition

Espace de noms:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.20.0

Source:

BlobLeaseClient.cs

L’opération BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) interrompt le bail précédemment acquis de l’objet blob ou du conteneur (s’il existe).

Une fois un bail résilié, il ne peut pas être renouvelé. Toute demande autorisée peut résilier le bail ; la demande ne spécifie pas obligatoirement un ID de bail correspondant. Lorsqu’un bail est rompu, l’interruption breakPeriod de bail est autorisée à s’écouler, pendant laquelle aucune opération de bail, sauf BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) et ReleaseAsync(RequestConditions, CancellationToken) ne peut être effectuée sur l’objet blob ou le conteneur. Lorsqu'un bail est correctement résilié, la réponse indique l'intervalle en secondes avant qu'un nouveau bail puisse être acquis.

Un bail qui a été résilié peut également être libéré. Un client peut immédiatement acquérir un bail d’objet blob ou de conteneur qui a été libéré.

Pour plus d'informations, consultez la rubrique Conteneur de bail.

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))

Paramètres

breakPeriod

Nullable<TimeSpan>

Spécifie la durée proposée que le bail doit continuer avant d’être rompu, en secondes, entre 0 et 60. Cette période de résiliation n'est utilisée que si elle est plus courte que la durée du bail restante. Si elle est plus longue, la durée restante du bail est utilisée. Un nouveau bail ne sera pas disponible avant l'expiration de la période de résiliation, mais le bail peut être conservé au-delà de cette période. Si cette valeur n’est pas fournie, un bail à durée fixe s’interrompt après l’expiration de la période de bail restante et un bail infini s’interrompt immédiatement.

conditions

RequestConditions

Facultatif BlobLeaseRequestConditions pour ajouter des conditions lors de la rupture d’un bail.

cancellationToken

CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Task<Response<BlobLease>>

Response<T> décrivant le bail rompu.

Remarques

Un RequestFailedException sera levée en cas d’échec.