Dapatkan Properti File
Operasi Get File Properties mengembalikan semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk file tersebut. Ini tidak mengembalikan konten file. Operasi ini didukung dalam versi 2025-05-05 dan yang lebih baru untuk Berbagi File dengan protokol NFS diaktifkan.
Ketersediaan protokol
| Protokol berbagi file yang diaktifkan | Tersedia |
|---|---|
| SMB |
|
| NFS |
|
Minta
Permintaan Get File Properties dibangun sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS.
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime> |
HTTP/1.1 |
Ganti komponen jalur yang ditampilkan dalam URI permintaan dengan milik Anda sendiri, sebagai berikut:
| Komponen jalur | Deskripsi |
|---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. |
mydirectorypath |
Fakultatif. Jalur ke direktori induk. |
myfile |
Nama file. |
Untuk informasi tentang pembatasan penamaan jalur, lihat Nama dan berbagi referensi, direktori, file, dan metadata.
Parameter URI
Parameter tambahan berikut dapat ditentukan pada URI permintaan:
| Parameter | Deskripsi |
|---|---|
sharesnapshot |
Fakultatif. Versi 2017-04-17 dan yang lebih baru. Parameter sharesnapshot adalah nilai DateTime buram yang, saat ada, menentukan rekam jepret berbagi untuk dikueri untuk properti file. |
timeout |
Fakultatif. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi Azure Files. |
Header permintaan
Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:
Header permintaan umum
| Header permintaan | Deskripsi |
|---|---|
| Otorisasi | Diperlukan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
Date atau x-ms-date |
Diperlukan. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
x-ms-version |
Diperlukan untuk semua permintaan yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Operasi ini didukung dalam versi 2025-05-05 dan yang lebih baru untuk Berbagi File dengan protokol NFS diaktifkan. Untuk informasi selengkapnya, lihat Penerapan Versi untuk layanan Azure Storage. |
x-ms-lease-id:<ID> |
Fakultatif. Versi 2019-02-02 dan yang lebih baru. Jika header ditentukan, operasi dilakukan hanya jika sewa file saat ini aktif dan ID sewa yang ditentukan dalam permintaan cocok dengan ID sewa file. Jika tidak cocok, operasi gagal dengan kode status 412 (Prasyarat Gagal). Header ini diabaikan jika file terletak di Berbagi File dengan protokol NFS diaktifkan, yang tidak mendukung sewa file. |
x-ms-client-request-id |
Fakultatif. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB), yang dicatat dalam log analitik saat pengelogan Azure Storage Analytics diaktifkan. Kami sangat menyarankan Anda menggunakan header ini saat Anda menghubungkan aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Memantau Azure Blob Storage. |
x-ms-file-request-intent |
Diperlukan jika header Authorization menentukan token OAuth. Nilai yang dapat diterima backup. Header ini menentukan bahwa Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action atau Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action harus diberikan jika disertakan dalam kebijakan RBAC yang ditetapkan ke identitas yang diotorisasi menggunakan header Authorization. Tersedia untuk versi 2022-11-02 dan yang lebih baru. |
x-ms-allow-trailing-dot: { <Boolean> } |
Fakultatif. Versi 2022-11-02 dan yang lebih baru. Nilai Boolean menentukan apakah titik berikutnya yang ada dalam url permintaan harus dipangkas atau tidak. Header ini diabaikan jika target terletak di Berbagi File dengan protokol NFS diaktifkan, yang mendukung titik berikutnya secara default. Untuk informasi selengkapnya, lihat Penamaan dan referensi berbagi, direktori, file, dan metadata. |
Header permintaan hanya SMB
Tidak.
Header permintaan NFS saja
Tidak.
Isi permintaan
Tidak.
Jawaban
Respons mencakup kode status HTTP dan sekumpulan header respons.
Kode status
Operasi yang berhasil mengembalikan kode status 200 (OK). Untuk informasi tentang kode status, lihat Status dan kode kesalahan.
Header respons
Respons untuk operasi ini mencakup header dalam tabel berikut. Respons juga dapat menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .
Header respons umum
| Header respons | Deskripsi |
|---|---|
Last-Modified |
Mengembalikan tanggal dan waktu saat file terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header. Setiap operasi yang memodifikasi file atau propertinya memperbarui waktu modifikasi terakhir. |
x-ms-meta-name:value |
Sekumpulan pasangan nama-nilai yang terkait dengan file ini sebagai metadata yang ditentukan pengguna. |
x-ms-type: <File> |
Mengembalikan jenis File. Dicadangkan untuk digunakan di masa mendatang. |
Content-Length |
Ukuran file dalam byte. Header ini mengembalikan nilai header x-ms-content-length yang disimpan dengan file . |
Content-Type |
Tipe konten yang ditentukan untuk file. Jika tidak ada tipe konten yang ditentukan, tipe konten default application/octet-stream. |
ETag |
ETag berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Nilai diapit dalam tanda kutip. |
Content-MD5 |
Jika header Content-MD5 telah diatur untuk file, header respons Content-MD5 dikembalikan sehingga klien dapat memeriksa integritas konten pesan. |
Content-Encoding |
Jika header permintaan Content-Encoding sebelumnya telah ditetapkan untuk file, nilai Content-Encoding dikembalikan di header ini. |
Content-Language |
Jika header permintaan Content-Language sebelumnya telah ditetapkan untuk file, nilai Content-Language dikembalikan di header ini. |
Cache-Control |
Jika header permintaan Cache-Control sebelumnya telah ditetapkan untuk file, nilai Cache-Control dikembalikan di header ini. |
Content-Disposition |
Mengembalikan nilai yang ditentukan untuk header x-ms-content-disposition dan menentukan cara memproses respons.Bidang header respons Content-Disposition menyampaikan informasi tambahan tentang cara memproses payload respons, dan Anda dapat menggunakannya untuk melampirkan metadata tambahan. Misalnya, jika diatur ke attachment, Content-Disposition menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, tetapi harus menampilkan jendela Simpan Sebagai sebagai gantinya. |
x-ms-request-id |
Secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API. |
x-ms-version |
Menunjukkan versi layanan yang digunakan untuk menjalankan permintaan. |
Date |
Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu ketika respons dimulai. |
x-ms-copy-completion-time:<datetime> |
Versi 2015-02-21 dan yang lebih baru. Waktu kesimpulan dari upaya terakhir salin file operasi di mana file ini adalah file tujuan. Nilai ini dapat menentukan waktu upaya penyalinan yang selesai, dibatalkan, atau gagal. Header ini tidak muncul jika salinan tertunda, jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-copy-status-description: <error string> |
Versi 2015-02-21 dan yang lebih baru. Muncul hanya ketika x-ms-copy-statusgagal atau tertunda . Ini menjelaskan penyebab kegagalan operasi penyalinan fatal atau non-fatal. Header ini tidak muncul jika salinan tertunda, jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-copy-id: <id> |
Versi 2015-02-21 dan yang lebih baru. Pengidentifikasi string untuk operasi Salin File terakhir di mana file ini adalah file tujuan. Header ini tidak muncul jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-copy-progress: <bytes copied/bytes total> |
Versi 2015-02-21 dan yang lebih baru. Berisi jumlah byte yang disalin dan total byte dalam sumber dalam upaya terakhir Salin File operasi di mana file ini adalah file tujuan. Dapat memperlihatkan antara 0 dan jumlah byte Content-Length yang disalin. Header ini tidak muncul jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-copy-source: url |
Versi 2015-02-21 dan yang lebih baru. URL hingga 2 KB karakter yang menentukan file sumber yang digunakan dalam operasi Salin File terakhir di mana file ini adalah file tujuan. Header ini tidak muncul jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
Versi 2015-02-21 dan yang lebih baru. Status operasi salin yang diidentifikasi oleh x-ms-copy-id, dengan nilai-nilai ini:- berhasil: salinan berhasil diselesaikan. - tertunda: salinan sedang berlangsung. Periksa x-ms-copy-status-description apakah kesalahan non-fatal yang terputus-putus menghambat kemajuan penyalinan tetapi tidak menyebabkan kegagalan.- dibatalkan: Salinan diakhir oleh Batalkan Salin File. - gagal: Penyalinan gagal. Lihat x-ms-copy-status-description untuk detail kegagalan.Header ini tidak muncul jika file ini belum pernah menjadi tujuan dalam operasi Salin File, atau jika file ini telah dimodifikasi setelah operasi Salin File dengan menggunakan Atur Properti File atau Buat File. |
x-ms-server-encrypted: true/false |
Versi 2017-04-17 dan yang lebih baru. Nilai header ini diatur ke true jika data file dan metadata aplikasi sepenuhnya dienkripsi dengan menggunakan algoritma yang ditentukan. Nilai diatur ke false jika file tidak terenkripsi, atau jika hanya bagian dari metadata file atau aplikasi yang dienkripsi. |
x-ms-file-creation-time |
Versi 2019-02-02 dan yang lebih baru. Nilai tanggal/waktu UTC yang mewakili properti waktu pembuatan untuk file. |
x-ms-file-last-write-time |
Versi 2019-02-02 dan yang lebih baru. Nilai tanggal/waktu UTC yang mewakili properti waktu tulis terakhir untuk file. |
x-ms-file-change-time |
Versi 2019-02-02 dan yang lebih baru. Nilai tanggal/waktu UTC yang mewakili properti waktu perubahan untuk file. |
x-ms-file-file-id |
Versi 2019-02-02 dan yang lebih baru. ID file file. |
x-ms-file-parent-id |
Versi 2019-02-02 dan yang lebih baru. ID file induk file. |
x-ms-lease-duration:infinite |
Versi 2019-02-02 dan yang lebih baru. Ketika file disewakan, menentukan bahwa sewa memiliki durasi tak terbatas. |
x-ms-lease-state:<available;leased;broken> |
Versi 2019-02-02 dan yang lebih baru. Ketika file disewakan, menentukan status sewa file. |
x-ms-lease-status:<locked;unlocked> |
Versi 2019-02-02 dan yang lebih baru. Ketika file disewakan, menentukan status sewa file. |
x-ms-client-request-id |
Dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai header x-ms-client-request-id jika ada dalam permintaan dan nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header tersebut tidak ada dalam respons. |
Header respons SMB saja
| Header respons | Deskripsi |
|---|---|
x-ms-file-permission-key |
Versi 2019-02-02 dan yang lebih baru. Kunci izin file. |
x-ms-file-attributes |
Versi 2019-02-02 dan yang lebih baru. Atribut sistem file file. Untuk informasi selengkapnya, lihat daftar atribut yang tersedia. |
Header respons NFS saja
| Header respons | Deskripsi |
|---|---|
x-ms-mode |
Versi 2025-05-05 dan yang lebih baru. Mode file. Lihat izin file POSIX (mode). |
x-ms-owner |
Versi 2025-05-05 dan yang lebih baru. Pengidentifikasi pengguna (UID) pemilik file. |
x-ms-group |
Versi 2025-05-05 dan yang lebih baru. Pengidentifikasi grup (GID) pemilik file. |
x-ms-link-count |
Versi 2025-05-05 dan yang lebih baru. Jumlah tautan file. |
x-ms-file-file-type |
Versi 2025-05-05 dan yang lebih baru. Jenis file, nilai yang mungkin adalah: Regular, Symlink. |
Isi respons
Tidak.
Sampel respons
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-version: 2019-02-02
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>
x-ms-lease-duration: infinite
x-ms-lease-state: leased
x-ms-lease-status: locked
Otorisasi
Hanya pemilik akun yang dapat memanggil operasi ini.
Atribut sistem file
| Atribut | Atribut file Win32 | Definisi |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | File yang bersifat baca-saja. Aplikasi dapat membaca file, tetapi tidak dapat menulis atau menghapusnya. |
| Sembunyi | FILE_ATTRIBUTE_HIDDEN | File disembunyikan. Ini tidak termasuk dalam daftar direktori biasa. |
| Sistem | FILE_ATTRIBUTE_SYSTEM | File yang digunakan sistem operasi sebagai bagian dari, atau digunakan secara eksklusif. |
| Tidak | FILE_ATTRIBUTE_NORMAL | File yang tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid saat digunakan sendiri. |
| Mengarsipkan | FILE_ATTRIBUTE_ARCHIVE | File yang merupakan file arsip. Aplikasi biasanya menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan. |
| Sementara | FILE_ATTRIBUTE_TEMPORARY | File yang sedang digunakan untuk penyimpanan sementara. |
| Luring | FILE_ATTRIBUTE_OFFLINE | Data file tidak segera tersedia. Atribut sistem file ini disajikan terutama untuk memberikan kompatibilitas dengan Windows. Azure Files tidak mendukung opsi penyimpanan offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | File tidak akan diindeks oleh layanan pengindeksan konten. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Aliran data pengguna tidak akan dibaca oleh pemindai integritas data latar belakang. Atribut sistem file ini disajikan terutama untuk memberikan kompatibilitas dengan Windows. |
Izin file POSIX (mode)
Izin file POSIX dapat ditentukan baik secara numerik dalam format oktal numerik 12-bit atau dalam format "rwx" simbolis. Contoh:
- "0644" atau "rw-r--r--": Pengguna (pemilik file) telah membaca, menulis izin. Grup memiliki izin baca. Yang lain memiliki izin baca.
- "0755" atau "rwxr-xr-x": Pengguna (pemilik file) telah membaca, menulis, dan menjalankan izin. Grup memiliki izin baca dan jalankan. Yang lain memiliki izin baca dan jalankan.
Format oktal numerik
Tiga angka oktal urutan terendah mewakili izin untuk pemilik/pengguna, grup, dan lainnya dan ditunjukkan menggunakan angka oktal (0-7), yang dibentuk menggunakan kombinasi bitwise '4' (Baca), '2' (Tulis), '1' (Jalankan). Angka oktal urutan tertinggi (0-7) digunakan untuk menunjukkan kombinasi izin '4' (SetUID), '2' (SetGID), '1' (StickyBit).
| Format | Izin |
|---|---|
| 0700 | Pengguna (pemilik file) telah membaca, menulis, dan menjalankan izin. |
| 0400 | Pengguna memiliki izin baca. |
| 0200 | Pengguna memiliki izin menulis. |
| 0100 | Pengguna telah menjalankan izin. |
| 0070 | Grup telah membaca, menulis, dan menjalankan izin. |
| 0040 | Grup memiliki izin baca. |
| 0020 | Grup memiliki izin tulis. |
| 0010 | Grup memiliki izin eksekusi. |
| 0007 | Orang lain telah membaca, menulis, dan menjalankan izin. |
| 0004 | Yang lain memiliki izin baca. |
| 0002 | Yang lain memiliki izin menulis. |
| 0001 | Yang lain memiliki izin eksekusi. |
| 4000 | Atur ID pengguna yang efektif pada file. |
| 2000 | Atur ID grup yang efektif pada file. |
| 1000 | Atur untuk menunjukkan bahwa file dapat dihapus atau diganti namanya hanya oleh pemilik file, pemilik direktori, atau pengguna root. |
Format "rwx" simbolis
Izin untuk pemilik/pengguna, grup, dan lainnya ditunjukkan menggunakan kombinasi karakter 'r' (Baca), 'w' (Tulis), dan 'x' (Jalankan).
| Format | Izin |
|---|---|
| rwx------ | Pengguna (pemilik file) telah membaca, menulis, dan menjalankan izin. |
| r-------- | Pengguna memiliki izin baca. |
| -w------- | Pengguna memiliki izin menulis. |
| --x------ | Pengguna telah menjalankan izin. |
| ---rwx--- | Grup telah membaca, menulis, dan menjalankan izin. |
| ---r----- | Grup memiliki izin baca. |
| -------- | Grup memiliki izin tulis. |
| -----x--- | Grup memiliki izin eksekusi. |
| ------rwx | Orang lain telah membaca, menulis, dan menjalankan izin. |
| ------r- | Yang lain memiliki izin baca. |
| -------w- | Yang lain memiliki izin menulis. |
| --------x | Yang lain memiliki izin eksekusi. |
Lihat juga
Operasi pada File