Path - Get Properties
Dapatkan Properti | Dapatkan Status | Dapatkan Daftar Access Control | Periksa Akses
Dapatkan Properti mengembalikan semua sistem dan properti yang ditentukan pengguna untuk jalur. Dapatkan Status mengembalikan semua properti yang ditentukan sistem untuk jalur. Dapatkan Daftar Access Control mengembalikan daftar kontrol akses untuk jalur. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&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. |
action
|
query |
Pilihan. Jika nilainya adalah "getStatus" hanya properti yang ditentukan sistem untuk jalur yang dikembalikan. Jika nilainya adalah "getAccessControl" daftar kontrol akses dikembalikan di header respons (Namespace Hierarkis harus diaktifkan untuk akun), jika tidak, properti dikembalikan. |
||
fs
|
query |
string |
Diperlukan hanya untuk memeriksa tindakan akses. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Operasi sistem file baca/tulis/jalankan dalam bentuk string, cocok dengan pola regex '[rwx-]{3}' |
|
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. |
|
upn
|
query |
boolean |
Opsional. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Jika "true", nilai identitas pengguna yang dikembalikan di header respons x-ms-owner, x-ms-group, dan x-ms-acl akan diubah dari ID Objek Azure Active Directory menjadi Nama Utama Pengguna. Jika "false", nilai akan dikembalikan sebagai ID Objek Azure Active Directory. Nilai defaultnya adalah false. Perhatikan bahwa ID Objek grup dan aplikasi tidak diterjemahkan karena tidak memiliki nama ramah yang unik. |
Header Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
x-ms-lease-id |
string |
Opsional. Jika header ini ditentukan, operasi akan dilakukan hanya jika kedua kondisi berikut terpenuhi: i) sewa jalur saat ini aktif dan ii) ID sewa yang ditentukan dalam permintaan cocok dengan jalur. 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-encryption-key |
string |
Pilihan. Kunci enkripsi AES-256 yang dikodekan Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opsional. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opsional. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus AES256. |
|
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 |
Mengembalikan semua properti untuk file atau direktori. 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 |
Pilihan. Jika nilainya adalah "getStatus" hanya properti yang ditentukan sistem untuk jalur yang dikembalikan. Jika nilainya adalah "getAccessControl" daftar kontrol akses dikembalikan di header respons (Namespace Hierarkis harus diaktifkan untuk akun), jika tidak, properti dikembalikan. |
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. |
PathGetPropertiesAction
Pilihan. Jika nilainya adalah "getStatus" hanya properti yang ditentukan sistem untuk jalur yang dikembalikan. Jika nilainya adalah "getAccessControl" daftar kontrol akses dikembalikan di header respons (Namespace Hierarkis harus diaktifkan untuk akun), jika tidak, properti dikembalikan.
Nama | Jenis | Deskripsi |
---|---|---|
checkAccess |
string |
|
getAccessControl |
string |
|
getStatus |
string |