Path - Lease
Jalur Sewa
Buat dan kelola sewa untuk membatasi akses tulis dan hapus ke jalur. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun Azure Storage. |
dns
|
path | True |
string |
Akhiran DNS untuk titik akhir Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Pengidentifikasi sistem file. Pola regex: |
path
|
path | True |
string |
Jalur file atau direktori. |
timeout
|
query |
integer int32 |
Nilai batas waktu operasi opsional dalam hitung detik. Periode dimulai ketika permintaan diterima oleh layanan. Jika nilai batas waktu berlalu sebelum operasi selesai, operasi gagal. |
Header Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
x-ms-lease-action | True |
Ada lima tindakan sewa: "acquire", "break", "change", "renew", dan "release". Gunakan "acquire" dan tentukan "x-ms-proposed-lease-id" dan "x-ms-lease-duration" untuk memperoleh sewa baru. Gunakan "jeda" untuk memutuskan sewa yang ada. Ketika sewa rusak, periode jeda sewa diizinkan untuk berlalu, selama waktu itu tidak ada operasi sewa kecuali jeda dan rilis dapat dilakukan pada file. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh. Gunakan "ubah" dan tentukan ID sewa saat ini di "x-ms-lease-id" dan ID sewa baru di "x-ms-proposed-lease-id" untuk mengubah ID sewa aktif. Gunakan "perbarui" dan tentukan "x-ms-lease-id" untuk memperbarui sewa yang ada. Gunakan "rilis" dan tentukan "x-ms-lease-id" untuk merilis sewa. |
|
x-ms-lease-duration |
integer int32 |
Durasi sewa diperlukan untuk memperoleh sewa, dan menentukan durasi sewa dalam hitungan detik. Durasi sewa harus antara 15 dan 60 detik atau -1 untuk sewa tak terbatas. |
|
x-ms-lease-break-period |
integer int32 |
Durasi periode jeda sewa bersifat opsional untuk memutuskan sewa, dan menentukan periode jeda sewa dalam hitungan detik. Durasi jeda sewa harus antara 0 dan 60 detik. |
|
x-ms-lease-id |
string |
Diperlukan ketika "x-ms-lease-action" adalah "renew", "change" atau "release". Untuk tindakan perpanjangan dan rilis, ini harus cocok dengan ID sewa saat ini. Pola regex: |
|
x-ms-proposed-lease-id |
string |
Diperlukan ketika "x-ms-lease-action" adalah "acquire" atau "change". Sewa akan diperoleh dengan ID sewa ini jika operasi berhasil. Pola regex: |
|
If-Match |
string |
Pilihan. Nilai ETag. Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-None-Match |
string |
Pilihan. Nilai ETag atau nilai wildcard khusus ("*"). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-Modified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
If-Unmodified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
x-ms-client-request-id |
string |
UUID yang dicatat dalam log analitik untuk pemecahan masalah dan korelasi. Pola regex: |
|
x-ms-date |
string |
Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
|
x-ms-version |
string |
Menentukan versi protokol REST yang digunakan untuk memproses permintaan. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Tindakan "perbarui", "ubah" atau "rilis" berhasil. Header
|
|
201 Created |
Sewa baru telah dibuat. Tindakan "acquire" berhasil. Header
|
|
202 Accepted |
Tindakan sewa "putus" berhasil. Header
|
|
Other Status Codes |
Terjadi kesalahan. Kemungkinan status HTTP, kode, dan string pesan tercantum di bawah ini:
Header
|
Definisi
Nama | Deskripsi |
---|---|
Data |
|
Error |
Objek respons kesalahan layanan. |
Path |
Ada lima tindakan sewa: "acquire", "break", "change", "renew", dan "release". Gunakan "acquire" dan tentukan "x-ms-proposed-lease-id" dan "x-ms-lease-duration" untuk memperoleh sewa baru. Gunakan "jeda" untuk memutuskan sewa yang ada. Ketika sewa rusak, periode jeda sewa diizinkan untuk berlalu, selama waktu itu tidak ada operasi sewa kecuali jeda dan rilis dapat dilakukan pada file. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh. Gunakan "ubah" dan tentukan ID sewa saat ini di "x-ms-lease-id" dan ID sewa baru di "x-ms-proposed-lease-id" untuk mengubah ID sewa aktif. Gunakan "perbarui" dan tentukan "x-ms-lease-id" untuk memperbarui sewa yang ada. Gunakan "rilis" dan tentukan "x-ms-lease-id" untuk merilis sewa. |
DataLakeStorageError
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek respons kesalahan layanan. |
Error
Objek respons kesalahan layanan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan layanan. |
message |
string |
Pesan kesalahan layanan. |
PathLeaseAction
Ada lima tindakan sewa: "acquire", "break", "change", "renew", dan "release". Gunakan "acquire" dan tentukan "x-ms-proposed-lease-id" dan "x-ms-lease-duration" untuk memperoleh sewa baru. Gunakan "jeda" untuk memutuskan sewa yang ada. Ketika sewa rusak, periode jeda sewa diizinkan untuk berlalu, selama waktu itu tidak ada operasi sewa kecuali jeda dan rilis dapat dilakukan pada file. Ketika sewa berhasil rusak, respons menunjukkan interval dalam hitungan detik sampai sewa baru dapat diperoleh. Gunakan "ubah" dan tentukan ID sewa saat ini di "x-ms-lease-id" dan ID sewa baru di "x-ms-proposed-lease-id" untuk mengubah ID sewa aktif. Gunakan "perbarui" dan tentukan "x-ms-lease-id" untuk memperbarui sewa yang ada. Gunakan "rilis" dan tentukan "x-ms-lease-id" untuk merilis sewa.
Nama | Jenis | Deskripsi |
---|---|---|
acquire |
string |
|
break |
string |
|
change |
string |
|
release |
string |
|
renew |
string |