BlobLeaseClient.BreakAsync Método

Definição

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Pacote:

Azure.Storage.Blobs v12.20.0

Origem:

BlobLeaseClient.cs

A BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) operação interrompe a concessão adquirida anteriormente do blob ou do contêiner (se existir).

Uma vez interrompida a concessão, não é possível renová-la. Qualquer solicitação autorizada pode interromper a concessão; a solicitação não precisa especificar uma ID de concessão correspondente. Quando uma concessão é interrompida, a quebra breakPeriod de concessão tem permissão para decorrer, durante o qual nenhuma operação de concessão, exceto BreakAsync(Nullable<TimeSpan>, RequestConditions, CancellationToken) e ReleaseAsync(RequestConditions, CancellationToken) pode ser executada no blob ou contêiner. Quando uma concessão é interrompida com êxito, a resposta indica o intervalo em segundos até que uma nova concessão possa ser adquirida.

A concessão que foi interrompida também pode ser liberada. Um cliente pode adquirir imediatamente um blob ou concessão de contêiner que foi liberado.

Para obter mais informações, consulte Contêiner de Concessão.

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

Parâmetros

breakPeriod

Nullable<TimeSpan>

Especifica a duração proposta que a concessão deve continuar antes de ser interrompida, em segundos, entre 0 e 60. Esse ponto de interrupção é usado somente se for menor do que o tempo restante da concessão. Se for mais longo, o tempo restante da concessão será usado. Uma nova concessão só estará disponível após a expiração do ponto de interrupção, mas a concessão poderá ser mantida por mais tempo do que o período de interrupção. Se esse valor não for fornecido, uma concessão de duração fixa será interrompida após o período de concessão restante e uma concessão infinita será interrompida imediatamente.

conditions

RequestConditions

Opcional BlobLeaseRequestConditions para adicionar condições para interromper uma concessão.

cancellationToken

CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Task<Response<BlobLease>>

Um Response<T> que descreve a concessão quebrada.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.