DataLakeLeaseClient.Acquire Méthode

Définition

Espace de noms:

Azure.Storage.Files.DataLake

Assembly:

Azure.Storage.Files.DataLake.dll

Paquet:

Azure.Storage.Files.DataLake v12.18.0

Source:

DataLakeLeaseClient.cs

L’opération Acquire(TimeSpan, RequestConditions, CancellationToken) acquiert un bail sur le chemin d’accès ou le système de fichiers. Le bail duration doit être compris entre 15 et 60 secondes, ou infini (-1).

Si le système de fichiers n’a pas de bail actif, le service Data Lake crée un bail sur le chemin d’accès ou le système de fichiers et le retourne. Si le système de fichiers a un bail actif, vous pouvez uniquement demander un nouveau bail à l’aide de l’ID de bail actif comme LeaseId, mais vous pouvez spécifier un nouveau duration.

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

public virtual Azure.Response<Azure.Storage.Files.DataLake.Models.DataLakeLease> Acquire (TimeSpan duration, Azure.RequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member Acquire : TimeSpan * Azure.RequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.DataLake.Models.DataLakeLease>
override this.Acquire : TimeSpan * Azure.RequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.DataLake.Models.DataLakeLease>

Public Overridable Function Acquire (duration As TimeSpan, Optional conditions As RequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of DataLakeLease)

Paramètres

duration

TimeSpan

Spécifie la durée du bail, en secondes, ou spécifie InfiniteLeaseDuration pour un bail qui n’expire jamais. Un bail qui n'est pas infini peut durer entre 15 et 60 secondes. Une durée de bail ne peut pas être modifiée en utilisant RenewAsync(RequestConditions, CancellationToken) ou ChangeAsync(String, RequestConditions, CancellationToken).

conditions

RequestConditions

Facultatif RequestConditions pour ajouter des conditions lors de l’acquisition d’un bail.

cancellationToken

CancellationToken

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

Retours

Response<DataLakeLease>

Response<T> décrivant le bail.

Remarques

Un RequestFailedException est levée si une défaillance se produit.