Path - Read
Membaca File
Membaca konten file. Untuk operasi baca, permintaan rentang didukung. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET 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 |
---|---|---|---|
Range |
string |
Header permintaan Rentang HTTP menentukan satu atau beberapa rentang byte sumber daya yang akan diambil. |
|
x-ms-lease-id |
string |
Pilihan. 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: |
|
x-ms-range-get-content-md5 |
boolean |
Opsional. Ketika header ini diatur ke "true" dan ditentukan bersama dengan header Rentang, layanan mengembalikan hash MD5 untuk rentang, selama rentangnya berukuran kurang dari atau sama dengan 4MB. Jika header ini ditentukan tanpa header Rentang, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header ini diatur ke true saat rentang melebihi ukuran 4 MB, layanan mengembalikan kode status 400 (Permintaan Buruk). |
|
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 |
file |
Ok Media Types: "application/json", "application/octet-stream", "text/plain" Header
|
Other Status Codes |
file |
Konten parsial Media Types: "application/json", "application/octet-stream", "text/plain" Header
|
Other Status Codes |
Terjadi kesalahan. Kemungkinan status HTTP, kode, dan string pesan tercantum di bawah ini:
Media Types: "application/json", "application/octet-stream", "text/plain" Header
|
Definisi
Nama | Deskripsi |
---|---|
Data |
|
Error |
Objek respons kesalahan layanan. |
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. |