Path - Lease
Chemin du bail
Créez et gérez un bail pour restreindre l’accès en écriture et supprimer l’accès au chemin d’accès. Cette opération prend en charge les requêtes HTTP conditionnelles. Pour plus d’informations, consultez Spécification des en-têtes conditionnels pour les opérations du service Blob.
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte de stockage Azure. |
dns
|
path | True |
string |
Suffixe DNS pour le point de terminaison Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identificateur du système de fichiers. Modèle d’expression régulière: |
path
|
path | True |
string |
Chemin d’accès au fichier ou au répertoire. |
timeout
|
query |
integer int32 |
Valeur de délai d’expiration d’opération facultative en secondes. La période commence lorsque la demande est reçue par le service. Si la valeur du délai d’expiration s’écoule avant la fin de l’opération, l’opération échoue. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
x-ms-lease-action | True |
Il existe cinq actions de bail : « acquérir », « arrêter », « modifier », « renouveler » et « libérer ». Utilisez « acquire » et spécifiez « x-ms-proposed-lease-id » et « x-ms-lease-duration » pour acquérir un nouveau bail. Utilisez « break » pour rompre un bail existant. Lorsqu’un bail est rompu, la période d’interruption de bail est autorisée à s’écouler, pendant laquelle aucune opération de bail, à l’exception de l’interruption et de la libération, ne peut être effectuée dans le dossier. Lorsqu'un bail est correctement résilié, la réponse indique l'intervalle en secondes avant qu'un nouveau bail puisse être acquis. Utilisez « change » et spécifiez l’ID de bail actuel dans « x-ms-lease-id » et le nouvel ID de bail dans « x-ms-proposed-lease-id » pour modifier l’ID de bail d’un bail actif. Utilisez « renew » et spécifiez « x-ms-lease-id » pour renouveler un bail existant. Utilisez « release » et spécifiez « x-ms-lease-id » pour libérer un bail. |
|
x-ms-lease-duration |
integer int32 |
La durée du bail est requise pour acquérir un bail et spécifie la durée du bail en secondes. La durée du bail doit être comprise entre 15 et 60 secondes ou -1 pour un bail infini. |
|
x-ms-lease-break-period |
integer int32 |
La durée de la période d’interruption de bail est facultative pour rompre un bail et spécifie la période d’arrêt du bail en secondes. La durée de l’arrêt de bail doit être comprise entre 0 et 60 secondes. |
|
x-ms-lease-id |
string |
Obligatoire lorsque « x-ms-lease-action » est « renew », « change » ou « release ». Pour les actions de renouvellement et de mise en production, cela doit correspondre à l’ID de bail actuel. Modèle d’expression régulière: |
|
x-ms-proposed-lease-id |
string |
Obligatoire lorsque « x-ms-lease-action » est « acquire » ou « change ». Un bail sera acquis avec cet ID de bail si l’opération réussit. Modèle d’expression régulière: |
|
If-Match |
string |
facultatif. Spécifiez une valeur ETag. Spécifiez cet en-tête pour exécuter l'opération uniquement si l'ETag de la ressource correspond à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-None-Match |
string |
facultatif. Valeur ETag ou valeur générique spéciale (« * »). Spécifiez cet en-tête pour exécuter l'opération uniquement si l'ETag de la ressource ne correspond pas à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-Modified-Since |
string |
facultatif. Valeur de date et heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource a été modifiée depuis la date et l’heure spécifiées. |
|
If-Unmodified-Since |
string |
facultatif. Valeur de date et heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource n’a pas été modifiée depuis la date et l’heure spécifiées. |
|
x-ms-client-request-id |
string |
Un UUID enregistré dans les journaux d’analyse pour la résolution des problèmes et la corrélation. Modèle d’expression régulière: |
|
x-ms-date |
string |
Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Cela est obligatoire lors de l’utilisation de l’autorisation de clé partagée. |
|
x-ms-version |
string |
Spécifie la version du protocole REST utilisé pour le traitement de la demande. Cela est obligatoire lors de l’utilisation de l’autorisation de clé partagée. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
L’action « renouveler », « modifier » ou « libérer » a réussi. En-têtes
|
|
201 Created |
Un nouveau bail a été créé. L’action « acquérir » a réussi. En-têtes
|
|
202 Accepted |
L’action de « rupture » du bail a réussi. En-têtes
|
|
Other Status Codes |
Une erreur est survenue. Les status HTTP possibles, le code et les chaînes de message sont répertoriés ci-dessous :
En-têtes
|
Définitions
Nom | Description |
---|---|
Data |
|
Error |
Objet de réponse d’erreur de service. |
Path |
Il existe cinq actions de bail : « acquérir », « arrêter », « modifier », « renouveler » et « libérer ». Utilisez « acquire » et spécifiez « x-ms-proposed-lease-id » et « x-ms-lease-duration » pour acquérir un nouveau bail. Utilisez « break » pour rompre un bail existant. Lorsqu’un bail est rompu, la période d’interruption de bail est autorisée à s’écouler, pendant laquelle aucune opération de bail, à l’exception de l’interruption et de la libération, ne peut être effectuée dans le dossier. Lorsqu'un bail est correctement résilié, la réponse indique l'intervalle en secondes avant qu'un nouveau bail puisse être acquis. Utilisez « change » et spécifiez l’ID de bail actuel dans « x-ms-lease-id » et le nouvel ID de bail dans « x-ms-proposed-lease-id » pour modifier l’ID de bail d’un bail actif. Utilisez « renew » et spécifiez « x-ms-lease-id » pour renouveler un bail existant. Utilisez « release » et spécifiez « x-ms-lease-id » pour libérer un bail. |
DataLakeStorageError
Nom | Type | Description |
---|---|---|
error |
Objet de réponse d’erreur de service. |
Error
Objet de réponse d’erreur de service.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur du service. |
message |
string |
Message d’erreur du service. |
PathLeaseAction
Il existe cinq actions de bail : « acquérir », « arrêter », « modifier », « renouveler » et « libérer ». Utilisez « acquire » et spécifiez « x-ms-proposed-lease-id » et « x-ms-lease-duration » pour acquérir un nouveau bail. Utilisez « break » pour rompre un bail existant. Lorsqu’un bail est rompu, la période d’interruption de bail est autorisée à s’écouler, pendant laquelle aucune opération de bail, à l’exception de l’interruption et de la libération, ne peut être effectuée dans le dossier. Lorsqu'un bail est correctement résilié, la réponse indique l'intervalle en secondes avant qu'un nouveau bail puisse être acquis. Utilisez « change » et spécifiez l’ID de bail actuel dans « x-ms-lease-id » et le nouvel ID de bail dans « x-ms-proposed-lease-id » pour modifier l’ID de bail d’un bail actif. Utilisez « renew » et spécifiez « x-ms-lease-id » pour renouveler un bail existant. Utilisez « release » et spécifiez « x-ms-lease-id » pour libérer un bail.
Nom | Type | Description |
---|---|---|
acquire |
string |
|
break |
string |
|
change |
string |
|
release |
string |
|
renew |
string |