Dosya Al
İşlem, Get File meta verileri ve özellikleri de dahil olmak üzere sistemden bir dosyayı okur veya indirir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Kullanılabilir |
|---|---|
| SMB |  |
| NFS |  |
İstek
İstek Get File aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
GET |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
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ı. 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 |
|---|---|
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 |
|---|---|
Authorization |
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. |
Range |
İsteğe bağlı. Yalnızca belirtilen bayt aralığındaki dosya verilerini döndürür. |
x-ms-range |
İsteğe bağlı. Yalnızca belirtilen bayt aralığındaki dosya verilerini döndürür. hem x-ms-range hem de Range belirtilirse, hizmet değerini x-ms-rangekullanır. Hiçbiri belirtilmezse, dosya içeriğinin tamamı döndürülür. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için aralık üst bilgisini belirtme. |
x-ms-range-get-content-md5: true |
İsteğe bağlı. Bu üst bilgi olarak ayarlandığında true ve üst bilgiyle Range birlikte belirtildiğinde, aralık boyutu 4 mebibayttan (MiB) küçük veya buna eşit olduğu sürece hizmet aralık için MD5 karması döndürür.Bu üst bilgi üst bilgi olmadan Range belirtilirse, hizmet 400 (Hatalı İstek) durum kodunu döndürür.Bu üst bilgi, aralık boyutu 4 MiB'yi aştığında olarak ayarlanırsa true , hizmet 400 (Hatalı İstek) durum kodunu döndürür. |
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. Aksi takdirde 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ı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Dosyalar. |
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, yanıt üst bilgileri kümesi ve dosyanın içeriğini içeren yanıt gövdesini içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında 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 tarihi 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. |
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 istek üst bilgisini ayarlayarak Range dosyanın bir alt kümesini isterse döndürülen bayt aralığı. |
ETag |
İş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 |
Dosyanın MD5 karması varsa ve istek dosyanın tamamını okumaksa, istemcinin ileti içerik bütünlüğünü denetleyebilmesi için bu yanıt üst bilgisi döndürülür. İstek belirli bir aralığı okumak içinse ve x-ms-range-get-content-md5 değeri olarak ayarlandıysa true, aralık boyutu 4 MiB'den küçük veya buna eşit olduğu sürece, istek aralık için bir MD5 karması döndürür.Bu koşul kümelerinden hiçbiri değilse true, üst bilgi için Content-MD5 hiçbir değer döndürülür.Aralık üst bilgisi olmadan belirtilirse x-ms-range-get-content-md5 , hizmet 400 (Hatalı İstek) durum kodunu döndürür.Aralık 4 MiB'yi aştığında olarak ayarlanırsa x-ms-range-get-content-md5true , hizmet 400 (Hatalı İstek) durum kodunu döndürür. |
Content-Encoding |
İstek üst bilgisi için Content-Encoding belirtilen değeri döndürür. |
Content-Language |
İstek üst bilgisi için Content-Language belirtilen değeri döndürür. |
Cache-Control |
Daha önce dosya için belirtilmişse 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 ek meta veriler eklemek için de kullanılabilir. Örneğin, olarak ayarlandıysaattachmentContent-Disposition, kullanıcı aracısının yanıtı görüntülememesi gerektiğini, 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ü. |
Accept-Ranges: bytes |
Hizmetin kısmi dosya içeriği isteklerini desteklediğini gösterir. |
Date |
Date |
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'u kullanan 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. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya DosyaÖzelliklerini Ayarla veya Dosya Oluştur'u kullanan sonuçlanan Dosya Kopyala işleminden sonra değiştirilmişse bu üst bilgi 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ı. Bu üst bilgi, dosya hiçbir zaman Dosya Kopyalama işleminde hedef olmadıysa veya Dosya Özelliklerini Ayarla veya Dosya Oluştur'u kullanan sonuçlanan Dosya Kopyalama işleminden sonra değiştirildiyse görünmez. |
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 Dosya Kopyalama işlemindeki kaynaktaki toplam bayt sayısını içerir. 0'dan kopyalanan Content-Length bayt sayısına kadar gösterebilir. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya DosyaÖzelliklerini Ayarla veya Dosya Oluştur'u kullanan sonuçlanan Dosya Kopyala işleminden sonra değiştirilmişse bu üst bilgi görünmez. |
x-ms-copy-source: url |
Sürüm 2015-02-21 ve üzeri. Bu dosyanın hedef dosya olduğu en son denenen Dosya Kopyalama işleminde kullanılan kaynak dosyayı belirten en fazla 2 KB uzunluğunda bir URL. Dosya Kopyala işleminde bu dosya hiç hedef olmadıysa veya DosyaÖzelliklerini Ayarla veya Dosya Oluştur'u kullanan sonuçlanan Dosya Kopyala işleminden sonra değiştirilmişse 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:- pending: 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 .- success: Kopyalama başarıyla tamamlandı.- aborted: Kopyalama, Kopyalamayı Durdur tarafından sonlandırıldı.- failed: 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 Dosya Oluştur'ukullanan dosya kopyalama işlemi tamamlandıktan sonra değiştirildiyse bu üst bilgi görüntülenmez. |
x-ms-content-md5 |
2016-05-31 sürümünden itibaren, dosyanın MD5 karması varsa ve istek bir aralık üst bilgisi (range veya x-ms-range) içeriyorsa, bu yanıt üst bilgisi tüm dosyanın MD5 değerinin değeriyle döndürülür. Bu değer, istenen aralıktan hesaplanan üst bilgide Content-MD5 döndürülen değere eşit olabilir veya olmayabilir. |
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/uygulama meta verilerinin yalnızca bazı bölümleri şifreleniyorsa, değer olarak falseayarlanır. |
x-ms-file-permission-key |
Dosyanın izninin anahtarı. |
x-ms-file-attributes |
Dosyadaki dosya sistemi öznitelikleri. Daha fazla bilgi için kullanılabilir özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Dosyanın oluşturma 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şiklik zamanı özelliğini temsil eden değerin UTC tarihi/saati. |
x-ms-file-file-id |
Dosyanın dosya kimliği. |
x-ms-file-parent-id |
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
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
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Henüz içeriği olmayan veya temizlenmiş bir aralık üzerinden yapılan çağrı Get File , bu baytlar için döndürülüyor 0 .
Hiçbir aralık belirtilmemiş olarak çağırırsanız Get File , hizmet üst bilgi için x-ms-content-length belirtilen değere kadar bayt aralığını döndürür. İçerik içermeyen aralıklar için hizmet, bu baytlar için döndürür 0 .
Bir Get File işlemin MiB başına iki dakika tamamlanmasına izin verilir. MiB başına ortalama iki dakikadan daha uzun süre alan işlemler zaman aşımına uğradı.