Dosya Al

Makale
03/29/2023

İş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-range`kullanı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ıysa`attachmentContent-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-id`tanı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 `false`ayarlanı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ı.

Ayrıca bkz.

Azure Dosyalar üzerinde işlemler

Aracılığıyla paylaş