Dosya Özelliklerini Alma
İşlem, Get File Properties dosya için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Dosyanın içeriğini döndürmez.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Kullanılabilir |
|---|---|
| SMB |
|
| NFS |
|
İstek
İstek Get File Properties aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
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 |
İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:
| Yol bileşeni | Description |
|---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
İsteğe bağlı. Üst dizinin yolu. |
myfile |
Dosyanın adı. |
Yol adlandırma kısıtlamaları hakkında bilgi için bkz . Ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:
| Parametre | Açıklama |
|---|---|
sharesnapshot |
İsteğe bağlı. Sürüm 2017-04-17 ve üzeri.
sharesnapshot parametresi, mevcut olduğunda dosya özelliklerini sorgulamak üzere paylaşım anlık görüntüsünü belirten opak bir DateTime değeridir. |
timeout |
İsteğe bağlı.
timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama. |
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:
| İstek üst bilgisi | Açıklama |
|---|---|
| Yetkilendirme | Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-lease-id:<ID> |
İsteğe bağlı. Sürüm 2019-02-02 ve üzeri. Üst bilgi belirtilirse, işlem yalnızca dosyanın kirası şu anda etkinse ve istekte belirtilen kira kimliği dosyanın kira kimliğiyle eşleşiyorsa gerçekleştirilir. Eşleşmezse işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). |
x-ms-client-request-id |
İsteğe bağlı. Azure Depolama Analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen, 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı kurarken bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Blob Depolama. |
x-ms-file-request-intent |
Üst bilgi bir OAuth belirteci belirtiyorsa Authorization gereklidir. Kabul edilebilir değer: backup. Bu üst bilgi, üst bilgi kullanılarak Authorization yetkilendirilen Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action kimliğe atanan RBAC ilkesine eklenmişse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
Yanıt
Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında daha fazla bilgi için bkz . Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
| Yanıt üst bilgisi | Description |
|---|---|
Last-Modified |
Dosyanın en son değiştirildiği tarih ve saati döndürür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin. Dosyayı veya özelliklerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. |
x-ms-meta-name:value |
Bu dosyayla kullanıcı tanımlı meta veriler olarak ilişkili bir dizi ad-değer çifti. |
x-ms-type: <File> |
türünü Filedöndürür. Daha sonraki kullanımlar için ayrılmıştır. |
Content-Length |
Dosyanın bayt cinsinden boyutu. Bu üst bilgi, dosyayla birlikte depolanan üst bilginin değerini x-ms-content-length döndürür. |
Content-Type |
Dosya için belirtilen içerik türü. Hiçbir içerik türü belirtilmezse, varsayılan içerik türü olur application/octet-stream. |
ETag |
ETag, işlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır. |
Content-MD5 |
Content-MD5 Dosya için üst bilgi ayarlandıysa, istemcinin Content-MD5 ileti içerik bütünlüğünü denetleyebilmesi için yanıt üst bilgisi döndürülür. |
Content-Encoding |
Content-Encoding İstek üst bilgisi daha önce dosya için ayarlanmışsa, Content-Encoding değer bu üst bilgide döndürülür. |
Content-Language |
Content-Language İstek üst bilgisi daha önce dosya için ayarlanmışsa, Content-Language değer bu üst bilgide döndürülür. |
Cache-Control |
Cache-Control İstek üst bilgisi daha önce dosya için ayarlandıysa, Cache-Control değer bu üst bilgide döndürülür. |
Content-Disposition |
Üst bilgi için belirtilen değeri döndürür ve yanıtın x-ms-content-disposition nasıl işlendiğini belirtir.Yanıt Content-Disposition üst bilgisi alanı, yanıt yükünün nasıl işlendiği hakkında ek bilgiler sağlar ve bunu kullanarak ek meta veriler ekleyebilirsiniz. Örneğin, olarak ayarlandıysaattachmentContent-Disposition, kullanıcı aracısının yanıtı görüntülememesi gerektiğini, ancak bunun yerine farklı kaydet penceresini görüntülemesi gerektiğini gösterir. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği yürütmek için kullanılan hizmet sürümünü gösterir. |
Date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
x-ms-copy-completion-time:<datetime> |
Sürüm 2015-02-21 ve üzeri. Bu dosyanın hedef dosya olduğu, son denenen Dosya Kopyalama işleminin sonuç zamanı. Bu değer tamamlanan, durdurulan veya başarısız kopyalama girişiminin zamanını belirtebilir. Bu üst bilgi bir kopya bekliyorsa, bu dosya hiçbir zaman Dosya Kopyalama işleminde hedef olmadıysa veya Dosya Özelliklerini Ayarla veya Dosya Oluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra değiştirildiyse görünmez. |
x-ms-copy-status-description: <error string> |
Sürüm 2015-02-21 ve üzeri. Yalnızca başarısız olduğunda veya beklemede olduğunda x-ms-copy-status görünür. Önemli veya önemli olmayan kopyalama işlemi hatasının nedenini açıklar. Bu üst bilgi bir kopya bekliyorsa, bu dosya hiçbir zaman Dosya Kopyalama işleminde hedef olmadıysa veya Dosya Özelliklerini Ayarla veya Dosya Oluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra değiştirildiyse görünmez. |
x-ms-copy-id: <id> |
Sürüm 2015-02-21 ve üzeri. Bu dosyanın hedef dosya olduğu, son denenen Dosya Kopyalama işleminin dize tanımlayıcısı. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya Dosya Özelliklerini Ayarla veya DosyaOluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra bu dosya değiştirildiyse bu üst bilgi görüntülenmez. |
x-ms-copy-progress: <bytes copied/bytes total> |
Sürüm 2015-02-21 ve üzeri. Kopyalanan bayt sayısını ve bu dosyanın hedef dosya olduğu son Denenen Dosya Kopyalama işleminde kaynaktaki toplam bayt sayısını içerir. 0 ile kopyalanan bayt sayısı Content-Length arasında görüntüleyebilir. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya Dosya Özelliklerini Ayarla veya DosyaOluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra bu dosya değiştirildiyse bu üst bilgi görüntülenmez. |
x-ms-copy-source: url |
Sürüm 2015-02-21 ve üzeri. Bu dosyanın hedef dosya olduğu son denenen Dosya Kopyalama işleminde kullanılan kaynak dosyayı belirten en fazla 2 KB karakterlik bir URL. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya Dosya Özelliklerini Ayarla veya DosyaOluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra bu dosya değiştirildiyse bu üst bilgi görüntülenmez. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
Sürüm 2015-02-21 ve üzeri. tarafından x-ms-copy-idtanımlanan kopyalama işleminin durumu şu değerlerledir:- Başarı: Kopyalama başarıyla tamamlandı. - Bekleyen: Kopyalama işlemi devam ediyor. Aralıklı, önemli olmayan hataların kopyalama ilerlemesini engellenip engellenmediğini ancak hataya neden olup olmadığını denetleyin x-ms-copy-status-description .- Iptal: Kopyalama, Dosyayı Kopyalamayı Durdur tarafından sonlandırıldı. - Başarısız: Kopyalama başarısız oldu. Hata ayrıntıları için bkz x-ms-copy-status-description .Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya Dosya Özelliklerini Ayarla veya DosyaOluştur kullanılarak sonuçlanan Dosya Kopyalama işleminden sonra bu dosya değiştirildiyse bu üst bilgi görüntülenmez. |
x-ms-server-encrypted: true/false |
Sürüm 2017-04-17 ve üzeri. Dosya verileri ve uygulama meta verileri belirtilen algoritma kullanılarak tamamen şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Dosya şifrelenmemişse veya dosya ya da uygulama meta verilerinin yalnızca bir bölümü şifreleniyorsa değeri olarak ayarlanır false . |
x-ms-file-permission-key |
Sürüm 2019-02-02 ve üzeri. Dosyanın izninin anahtarı. |
x-ms-file-attributes |
Sürüm 2019-02-02 ve üzeri. Dosyanın dosya sistemi öznitelikleri. Daha fazla bilgi için kullanılabilir özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Sürüm 2019-02-02 ve üzeri. Bir dosyanın oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-last-write-time |
Sürüm 2019-02-02 ve üzeri. Dosyanın son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-change-time |
Sürüm 2019-02-02 ve üzeri. Dosyanın değişiklik zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-file-id |
Sürüm 2019-02-02 ve üzeri. Dosyanın dosya kimliği. |
x-ms-file-parent-id |
Sürüm 2019-02-02 ve üzeri. Dosyanın üst dosya kimliği. |
x-ms-lease-duration:infinite |
Sürüm 2019-02-02 ve üzeri. Bir dosya kiralandığında, kiralamanın sonsuz süre olduğunu belirtir. |
x-ms-lease-state:<available;leased;broken> |
Sürüm 2019-02-02 ve üzeri. Bir dosya kiralandığında, dosyanın kira durumunu belirtir. |
x-ms-lease-status:<locked;unlocked> |
Sürüm 2019-02-02 ve üzeri. Bir dosya kiralandığında, dosyanın kira durumunu belirtir. |
x-ms-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta mevcut değildir. |
Yanıt gövdesi
Yok.
Örnek yanıt
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
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.