Dosyayı Al

İşlem, Get File sistemden bir dosyayı okuyor veya indirir; meta verileri ve özellikleri dahil. Bu işlem, 2025-05-05 ve sonraki sürümlerde NFS protokolü etkin Dosya Paylaşımları için desteklenmektedir.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü	Mevcut
SMB
NFS

İstek

İstek Get File şu şekilde oluşturulmuştur. HTTPS kullanmanızı öneririz.

Yöntem	İstenilen URI	HTTP sürümü
GET	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1

Talep URI'sinde gösterilen yol bileşenlerini kendi bileşenlerinizle değiştirin, aşağıdaki gibi:

Yol bileşeni	Description
myaccount	Depolama hesabınızın adı.
myshare	Dosya paylaşımınızın adı.
mydirectorypath	Optional. Dizine giden yol.
myfile	Dosyanın adı.

Yol isimlendirme kısıtlamaları hakkında bilgi için İsim ve referans paylaşımları, dizinler, dosyalar ve meta veriler bölümlerine bakınız.

URI parametreleri

Talep URI'sinde aşağıdaki ek parametreler belirtilebilir:

Parametre	Description
timeout	Optional. Parametre timeout saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Files işlemleri için zaman aşımını belirleyin.

İstek başlıkları

Gerekli ve isteğe bağlı istek başlıkları aşağıdaki tablolarda açıklanmıştır:

Yaygın istek başlıkları

İstek başlığı	Description
Authorization	Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
Date veya x-ms-date	Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
x-ms-version	Tüm yetkili talepler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem, 2025-05-05 ve sonraki sürümlerde NFS protokolü etkin Dosya Paylaşımları için desteklenmektedir. Daha fazla bilgi için bkz . Azure Depolama hizmetleri için sürüm oluşturma.
Range	Optional. Dosya verisini yalnızca belirtilen bayt aralığından döndürür.
x-ms-range	Optional. Dosya verisini yalnızca belirtilen bayt aralığından döndürür. Eğer her ikisi Range de belirtilirse x-ms-range , hizmet 'nin değerini x-ms-rangekullanır. Eğer hiçbiri belirtilmezse, tüm dosya içeriği geri gönderilir. Daha fazla bilgi için Azure Files işlemleri için aralık başlığını belirt bölümünü belirle.
x-ms-range-get-content-md5: true	Optional. Bu başlık true ayarlandığında ve başlıkla birlikte Range belirtildiğinde, hizmet aralığın MD5 hash'ini döndürür, tabii aralık 4 mebibayttan (MiB) küçük veya daha az olduğunda. Bu başlık başlık olmadan Range belirtilirse, hizmet durum kodu 400 (Kötü İstek) döner. Bu başlık aralık 4 MiB büyüklüğünü aştığında ayarlanırsa true , hizmet durum kodu 400 (Kötü İstek) döner.
x-ms-lease-id:<ID>	Optional. 2019-02-02 ve sonrası sürümler. Başlık belirtilmişse, işlem yalnızca dosyanın kirası şu anda aktifse ve istekte belirtilen kira kimliği dosyanın kira kimliğiyle eşleşiyorsa gerçekleştirilir. Aksi takdirde, işlem durum kodu 412 (Ön Koşul Başarısız Oldu) ile başarısız olur. Dosya NFS protokolü etkin olan bir Dosya Paylaşımı üzerinde bulunuyorsa bu başlık göz ardı edilir ve bu dosya kiralamalarını desteklemez.
x-ms-client-request-id	Optional. Günlük kaydı yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinliklerini sunucunun aldığı isteklerle ilişkilendirmek için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Dosyalar.
x-ms-file-request-intent	Başlık OAuth tokenı belirtiyorsa Authorization gereklidir. Kabul edilebilir değer .backup Bu başlık, başlık kullanılarak yetkilendirilen Authorization kimliğe atanan RBAC politikasında yer alıyorsa or Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ile onaylanması gerektiğini belirtirMicrosoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action. 2022-11-02 ve sonrasında mevcut olan sürümler.
x-ms-allow-trailing-dot: { <Boolean> }	Optional. 2022-11-02 ve sonrası sürümler. Boolean değeri, istek URL'sinde bulunan bir noktanın kesilip kesilmemesi gerektiğini belirtir. Hedef NFS protokolü etkin olan bir Dosya Paylaşımı'nda bulunuyorsa bu başlık göz ardı edilir; bu protokol varsayılan olarak noktayı destekliyor. Daha fazla bilgi için Paylaşımların, dizinlerin, dosyaların ve metaverilerin adlandırılması ve referansı bölümüne bakınız.
x-ms-structured-body	Optional. 2025-01-05 ve sonrası sürümler. Belirtilirse, hizmet dosya içeriğini yapılandırılmış gövde formatında kodlanmış olarak döndürecektir. Bu başlığın değeri, mesaj şeması versiyonu ve özelliklerini içerir. Şu anda desteklenen XSM/1.0; properties=crc64tek değer , yanıtın kodlanmış mesajda crc64 kontrol toplamı segmentlerini kullanacağını gösterir. Değer bu değerle eşleşmezse, işlem hata kodu 400 (Kötü İstek) ile başarısız olur.

SMB sadece başlık talep ediyor

Yok.

NFS sadece başlık talep ediyor

Yok.

İstek içeriği

Yok.

Yanıt

Yanıt, bir HTTP durum kodu, bir dizi yanıt başlığı ve dosyanın içeriğini içeren yanıt gövdesini içerir.

Durum kodu

Başarılı bir işlem durum kodu 200 (OK) döndürür. Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt başlıkları

Bu operasyonun yanıtı, aşağıdaki tablolardaki başlıkları içerir. Yanıt, ek standart HTTP başlıkları da içerebilir. Tüm standart başlıklar HTTP/1.1 protokol belirtimine uygundur.

Yaygın yanıt başlıkları

Yanıt üst bilgisi	Description
Last-Modified	Dosyanın en son değiştirildiği tarih ve saati döndürüyor. Tarih biçimi RFC 1123'e uygundur. Daha fazla bilgi için bkz. Tarih/saat değerlerini başlıklarda temsil et. 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.
Content-Length	Yanıt gövdesinde bulunan bayt sayısı.
Content-Type	Dosya için belirtilen içerik türü. Varsayılan içerik türü şeklindedir application/octet-stream.
Content-Range	İstemci dosyanın bir alt kümesini talep ederek Range talep başlığını ayarlayarak geri dönen bayt aralığı.
ETag	Operasyonları koşullu olarak gerçekleştirebileceğiniz bir değer içerir. Değer tırnak içinde eklenmiştir.
Content-MD5	Dosyada MD5 hash varsa ve tam dosyayı okumak isteniliyorsa, bu yanıt başlığı geri döner, böylece istemci mesaj içeriğinin bütünlüğünü kontrol edebilir. Eğer talep belirli bir aralığı okunacaksa ve bu x-ms-range-get-content-md5 aralık , olarak ayarlanmışsa true, talep aralığı için MD5 hash'i döner; tabii ki aralık boyutu 4 MiB'den az veya eşit ise. Bu koşul kümelerinden hiçbiri ise true, başlık için bir değer döndürülmez Content-MD5 . Eğer x-ms-range-get-content-md5 aralık başlığı olmadan belirtilirse, hizmet durum kodu 400 (Kötü İsti) döndürür. Eğer x-ms-range-get-content-md5 aralık 4 MiB'yi aştığında ayarlanırsa true , hizmet durum kodu 400 (Kötü İstek) döner.
Content-Encoding	İstek başlığı için belirtilen Content-Encoding değeri döndürür.
Content-Language	İstek başlığı için belirtilen Content-Language değeri döndürür.
Cache-Control	Dosya için önceden belirtilmişse geri döner.
Content-Disposition	Başlık için x-ms-content-disposition belirtilen değeri döndürür ve yanıtın nasıl işleneceğini belirtir. Yanıt başlığı alanı Content-Disposition , yanıt yükünün nasıl işleneceğine dair ek bilgi verir ve ayrıca ek meta veriler eklemek için de kullanılabilir. Örneğin, eğer ayarlıysa attachment, Content-Disposition user-agent'in yanıtı göstermemesi yerine bir Kaydet penceresi göstermesi gerektiğini gösterir.
x-ms-request-id	Yapılan talebi benzersiz şekilde tanımlar ve isteği sorun gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlem sorunlarını giderme.
x-ms-version	İsteği yürütmek için kullanılan servis sürümü.
Accept-Ranges: bytes	Hizmetin kısmi dosya içeriği isteklerini desteklediğini gösterir.
Date	Date
x-ms-copy-completion-time:<datetime>	2015-02-21 ve sonrası sürümler. Bu dosyanın hedef dosya olduğu son deneme Dosya Kopyalama işleminin sonuç zamanı. Bu değer tamamlanan, durdurulan veya başarısız kopyalama girişiminin zamanını belirtebilir. Bu başlık, bir kopya beklemekteyse, bu dosya Kopyalama işleminde hiç hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Oluştur Dosyası kullanan tamamlanmış bir Kopyalama işleminden sonra değiştirilmişse, bu başlık görünmez.
x-ms-copy-status-description: <error string>	2015-02-21 ve sonrası sürümler. Sadece x-ms-copy-statusbaşarısız veya beklediğinde görünür. Ölümcül veya ölümcül olmayan bir kopya operasyonu başarısızlığının nedenini tanımlar. Bu başlık, bu dosya hiç Kopya Dosyası işleminde hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Dosya Oluştur (Dosya Oluştur) kullanılarak tamamlanan bir Kopyalama işleminden sonra değiştirildiyse bu başlık görünmez.
x-ms-copy-id: <id>	2015-02-21 ve sonrası sürümler. Son deneme Dosyayı Kopyalama işlemi için bu dosyanın hedef dosyası olduğu dize tanımlayıcısı. Bu başlık, dosya hiç Kopyalama Dosyası işleminde hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Dosya Oluştur (Dosya Oluştur) kullanılarak tamamlanan bir Kopyalama işleminden sonra değiştirildiyse bu başlık görünmez.
x-ms-copy-progress: <bytes copied/bytes total>	2015-02-21 ve sonrası sürümler. Kopyalanan bayt sayısını ve bu dosyanın hedef dosya olduğu son deneme Dosya Kopyalama işleminde kaynaktaki toplam baytları içerir. 0'dan kopyalanan Content-Length bayt sayısına kadar gösterilebilir. Bu başlık, bu dosya hiç Kopya Dosyası işleminde hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Dosya Oluştur (Dosya Oluştur) kullanılarak tamamlanan bir Kopyalama işleminden sonra değiştirildiyse bu başlık görünmez.
x-ms-copy-source: url	2015-02-21 ve sonrası sürümler. En fazla 2 KB uzunluğunda bir URL, son denemede kullanılan kaynak dosyayı belirtir; bu dosya hedef dosya olarak kullanılır. Bu başlık, bu dosya Kopyalama işleminde hiç hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Oluştur Dosyası kullanan tamamlanmış bir Kopyalama işleminden sonra değiştirildiyse görünmez.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed>	2015-02-21 ve sonrası sürümler. Kopyalama işleminin şu değerlerle tanımlanan x-ms-copy-iddurumu: - pending: Kopya devam ediyor. Aralıklı, ölümcül olmayan hataların kopyalama ilerlemesini engelleyip engellemediğini ama başarısızlığa neden olmadığını kontrol x-ms-copy-status-description edin. - success: Kopya başarıyla tamamlandı. - aborted: Kopya, Kopya Dosyasını İptal Etme ile sonlandırıldı. - failed: Kopya başarısız oldu. Arıza detayları için bakınız x-ms-copy-status-description . Bu başlık, bu dosya hiç Kopya Dosyası işleminde hedef olmamışsa veya Dosya Özelliklerini Düzenle veya Dosya Oluştur (Dosyayı Oluştur) kullanılarak tamamlanmış bir Kopyalama işleminden sonra değiştirildiyse bu başlık görünmez.
x-ms-content-md5	2016-05-31 sürümü itibarıyla, dosyanın MD5 hash'ı varsa ve istek bir aralık başlığı (range veya x-ms-range) içeriyorsa, bu yanıt başlığı tüm dosyanın MD5 değerinin değeriyle döner. Bu değer, istenen aralıktan hesaplanan başlıkta döndürülen Content-MD5 değere eşit olabilir ya da olmayabilir.
x-ms-server-encrypted: true/false	2017-04-17 ve sonrası sürüm. Bu başlığın true değeri, dosya verisi ve uygulama meta verileri belirtilen algoritma kullanılarak tamamen şifrelenmişse ayarlanır. Dosya şifrelenmemişse veya dosya/uygulama meta verilerinin sadece bazı bölümleri şifrelenmişse, değer olarak ayarlanır false.
x-ms-file-creation-time	Dosyanın oluşturulma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-last-write-time	Dosyanın son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-change-time	Dosyanın değişim zamanı özelliğini temsil eden UTC tarihi/saati olan değer.
x-ms-file-file-id	Dosyanın dosya kimliği.
x-ms-file-parent-id	Dosyanın ana dosya kimliği.
x-ms-lease-duration:infinite	2019-02-02 ve sonrası sürümler. Bir dosya kiralandığında, kira sözleşmesinin sonsuz süreli olduğunu belirtir.
x-ms-lease-state: <available, leased, broken>	2019-02-02 ve sonrası sürümler. Bir dosya kiralandığında, dosyanın kira durumunu belirtir.
x-ms-lease-status: <locked, unlocked>	2019-02-02 ve sonrası sürümler. Bir dosya kiralandığında, dosyanın kira durumu belirtilir.
x-ms-client-request-id	İstekleri ve ilgili yanıtlarını gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz.

Sadece SMB yanıt başlıkları

Yanıt üst bilgisi	Description
x-ms-file-permission-key	2019-02-02 ve sonrası sürümler. Dosyanın izin anahtarı.
x-ms-file-attributes	2019-02-02 ve sonrası sürümler. Dosyanın dosya sistemi öznitelikleri. Daha fazla bilgi için mevcut özellikler listesine bakınız.

NFS'ye sadece yanıt başlıkları

Yanıt üst bilgisi	Description
x-ms-mode	2025-05-05 ve sonrası sürümler. Dosyanın modu. Bakız: POSIX dosya izinleri (mod).
x-ms-owner	2025-05-05 ve sonrası sürümler. Dosya sahibinin kullanıcı tanımlayıcısı (UID).
x-ms-group	2025-05-05 ve sonrası sürümler. Dosya sahibinin grup tanımlayıcısı (GID).
x-ms-link-count	2025-05-05 ve sonrası sürümler. Dosyanın bağlantı sayısı.

Yanıt başlıkları (yapılandırılmış gövde)

2025-01-05 sürümünden itibaren, istek geçerli x-ms-structured-body bir başlık gönderirse aşağıdaki başlıklar geri gönderilecektir.

Yanıt üst bilgisi	Description
Content-Length	Kodlanan yanıtın uzunluğu (sadece geri dönen dosya içeriğinin uzunluğu değil) olacaktır.
x-ms-structured-body	Bu başlığın değeri, talebe gönderilen değere eşittir ve şu anda bu değer olarak olmalıdır XSM/1.0; properties=crc64.
x-ms-structured-content-length	Bu başlığın değeri, geri dönen dosya içeriğinin uzunluğudur ve mesaj kodlaması nedeniyle her zaman başlık Content-Length değerinden daha küçük olacaktır.

Yanıtın içeriği

Yanıt gövdesi dosyanın içeriğini içerir.

Ö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

Authorization

Sadece hesap sahibi bu işlemi çağırabilir.

Dosya sistemi özellikleri

Özellik	Win32 dosya özniteliği	Definition
ReadOnly	FILE_ATTRIBUTE_READONLY	Sadece okunabilir bir dosya. Uygulamalar dosyayı okuyabilir ama ona yazamaz veya silemez.
Gizli	FILE_ATTRIBUTE_HIDDEN	Dosya gizli. Sıradan bir dizin listesinde yer almıyor.
System	FILE_ATTRIBUTE_SYSTEM	İşletim sisteminin bir parçasını kullandığı veya yalnızca kullandığı bir dosya.
Hiç kimse	FILE_ATTRIBUTE_NORMAL	Başka öznitelikleri ayarlanmamış bir dosya. Bu özellik yalnızca tek başına kullanıldığında geçerlidir.
Arşiv	FILE_ATTRIBUTE_ARCHIVE	Arşiv dosyası olan bir dosya. Uygulamalar genellikle bu özniteliği dosyaları yedekleme veya kaldırma için işaretlemek için kullanır.
Temporary	Geçici Dosya Özelliği	Geçici depolama için kullanılan bir dosya.
Offline	FILE_ATTRIBUTE_OFFLINE	Bir dosyanın verileri hemen erişilebilir değildir. Bu dosya sistemi özniteliği, öncelikle Windows ile uyumluluk sağlamak amacıyla sunulmuştur. Azure Files çevrimdışı depolama seçeneklerini desteklemiyor.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	Dosya, içerik indeksleme servisi tarafından indekslenmeyecek.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	Kullanıcı veri akışı arka plan veri bütünlüğü tarayıcısı tarafından okunmamalıdır. Bu dosya sistemi özniteliği, öncelikle Windows ile uyumluluk sağlamak amacıyla sunulmuştur.

POSIX dosya izinleri (mod)

POSIX dosya izinleri ya sayısal olarak 12 bitlik sayısal sekizli formatta ya da sembolik "rwx" formatında belirtilebilir. Examples:

• "0644" veya "rw-r--r--": Kullanıcı (dosya sahibi) okuma, yazma iznine sahiptir. Grup okuma izni aldı. Diğerleri ise okuma izni aldı.
• "0755" veya "rwxr-xr-x": Kullanıcı (dosya sahibi) okuma, yazma ve çalıştırma iznine sahiptir. Grup okuma ve yürütme izni aldı. Diğerleri ise iznini okuyup uyguladı.

Sayısal sekizlik formatı

En düşük dereceden üç sekizlik sayı, sahip/kullanıcı, grup ve diğerlerinin izinlerini temsil eder ve '4' (Okuma), '2' (Yazma), '1' (Yürüt) bitli kombinasyonlarıyla oluşturulan sekizli sayı (0-7) ile belirtilir. En yüksek dereceden sekizlik sayı (0-7), '4' (SetUID), '2' (SetGID), '1' (StickyBit) izinlerinin kombinasyonunu göstermek için kullanılır.

Biçim	İzin
0700	Kullanıcı (dosya sahibi) okuma, yazma ve çalıştırma iznine sahiptir.
0400	Kullanıcı okuma iznine sahiptir.
0200	Kullanıcı yazma iznine sahiptir.
0100	Kullanıcı çalıştırma iznine sahip.
0070	Grup okuma, yazma ve yürütme iznine sahiptir.
0040	Grup okuma izni aldı.
0020	Grubun yazma izni var.
0010	Grup yürütme iznine sahip.
0007	Diğerleri ise okuma, yazma ve yürütme iznini aldı.
0004	Diğerleri ise okuma izni aldı.
0002	Diğerlerinin yazı izni var.
0001	Diğerlerinin ise yürütme izni var.
4000	Dosyada etkili kullanıcı kimliği ayarlayın.
2000	Dosyada etkili grup kimliği ayarlayın.
1000	Dosyanın yalnızca dosya sahibi, dizin sahibi veya kök kullanıcı tarafından silinebileceğini veya yeniden adlandırılabileceğini gösterecek şekilde ayarlandı.

Sembolik "rwx" formatı

Sahip/kullanıcı, grup ve diğerleri için izinler, 'r' (Oku), 'w' (Yazma) ve 'x' (Yürüt) karakterlerinin birleşimi kullanılarak belirtilir.

Biçim	İzin
rwx------	Kullanıcı (dosya sahibi) okuma, yazma ve çalıştırma iznine sahiptir.
r--------	Kullanıcı okuma iznine sahiptir.
-W-------	Kullanıcı yazma iznine sahiptir.
--x------	Kullanıcı çalıştırma iznine sahip.
---rwx---	Grup okuma, yazma ve yürütme iznine sahiptir.
---r-----	Grup okuma izni aldı.
----w----	Grubun yazma izni var.
-----x---	Grup yürütme iznine sahip.
------rwx	Diğerleri ise okuma, yazma ve yürütme iznini aldı.
------r--	Diğerleri ise okuma izni aldı.
-------w-	Diğerlerinin yazı izni var.
--------x	Diğerlerinin ise yürütme izni var.

Açıklamalar

Henüz içerik olmayan veya onaylanmış bir aralık üzerinden arama Get File yapmak o baytlar için geri döner 0 .

Aralık belirtilmemiş bir şekilde çağrı Get File yaparsanız, hizmet bayt aralığını başlık için belirtilen x-ms-content-length değere kadar döndürür. İçerik eksikliği olan aralıklar için servis bu baytlar için geri dönüyor 0 .

Bir Get File operasyonun tamamlanması için MiB başına iki dakika izin verilir. Ortalama zaman aşımında MiB başına iki dakikadan uzun süren işlemler.

Ayrıca bakınız

Dosyalar üzerindeki İşlemler