FileService Sınıf
Sunucu İleti Bloğu (SMB) protokolü, bugün şirket içinde kullanılan tercih edilen dosya paylaşımı protokolüdür. Microsoft Azure Dosya hizmeti, müşterilerin SMB istemci uygulamalarını yeniden yazmak zorunda kalmadan Azure'ın Hizmet Olarak Bulut Altyapısı (IaaS) SMB'sinin kullanılabilirliğini ve ölçeklenebilirliğini kullanmasına olanak tanır.
Azure Dosya hizmeti ayrıca genellikle karmaşık olan ve yüklenmesi, yapılandırılması ve çalıştırılması pahalı olan geleneksel Doğrudan Bağlı Depolama (DAS) ve Depolama Alanı Ağı (SAN) çözümlerine cazip bir alternatif sunar.
- Devralma
-
FileService
Oluşturucu
FileService(account_name=None, account_key=None, sas_token=None, protocol='https', endpoint_suffix='core.windows.net', request_session=None, connection_string=None, socket_timeout=None)
Parametreler
- account_name
- str
Depolama hesabı adı. Bu, bir hesap anahtarıyla imzalanan isteklerin kimliğini doğrulamak ve depolama uç noktasını oluşturmak için kullanılır. Bir bağlantı dizesi verilmediği sürece gereklidir.
- account_key
- str
Depolama hesabı anahtarı. Bu, paylaşılan anahtar kimlik doğrulaması için kullanılır.
- sas_token
- str
Hesap anahtarı yerine isteklerin kimliğini doğrulamak için kullanılacak paylaşılan erişim imzası belirteci. Hesap anahtarı ve sas belirteci belirtilirse, imzalamak için hesap anahtarı kullanılır.
- protocol
- str
İstekler için kullanılacak protokol. Varsayılan olarak https kullanılır.
- endpoint_suffix
- str
Url'nin ana bilgisayar temel bileşeni, hesap adı çıkar. Varsayılan olarak Azure (core.windows.net). Çin bulutunu (core.chinacloudapi.cn) kullanmak için bunu geçersiz kılın.
- request_session
- <xref:requests.Session>
Http istekleri için kullanılacak oturum nesnesi.
- connection_string
- str
Belirtilirse, istek oturumu dışındaki tüm parametreleri geçersiz kılar. bağlantı dizesi biçimi için bkzhttp://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/.
- socket_timeout
- int
Belirtilirse, bu varsayılan yuva zaman aşımını geçersiz kılar. Belirtilen zaman aşımı saniye cinsindendir. Varsayılan değer için bkz. _constants.py DEFAULT_SOCKET_TIMEOUT.
Değişkenler
- MAX_SINGLE_GET_SIZE
- int
max_connections 1'den büyükse, ilk aralığın boyutu get_file_to_* yöntemler tarafından gerçekleştirilir. Dosya bundan küçükse daha az veri döndürülür.
- MAX_CHUNK_GET_SIZE
- int
Sonraki aralığın boyutu, max_connections 1'den büyükse ve dosya MAX_SINGLE_GET_SIZE büyükse get_file_to_* yöntemler tarafından gerçekleştirilir. Dosyanın geri kalanı bundan küçükse daha az veri döndürülür. Bu değer 4 MB'tan büyük olarak ayarlanırsa, content_validation etkinleştirilirse bir hata oluşturur. Ancak, content_validation istenmiyorsa 4 MB'tan büyük bir boyut en uygun olabilir. Bunu 4 MB'ın altına ayarlamak önerilmez.
- MAX_RANGE_SIZE
- int
create_file_from_* yöntemleri tarafından yer alan aralıkların boyutu. Daha az veri sağlanırsa daha küçük aralıklar konulabilir. Hizmetin desteklediği maksimum aralık boyutu 4 MB'tır.
Yöntemler
abort_copy_file |
Bekleyen bir copy_file işlemini durdurur ve hedef dosyayı sıfır uzunlukta ve tam meta verilerle bırakır. |
clear_range |
Belirtilen aralığı temizler ve bu aralık için depolama alanında kullanılan alanı serbest bırakır. |
close_handles |
Dizindeki veya belirtilen paylaşım altındaki bir dosyadaki açık tanıtıcıları kapatmak için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm tanıtıcılar kapatıldığında durur. Elde edilen değerler, her işlemde kapatılan tanıtıcıların sayısını temsil eder. |
copy_file |
Dosyayı zaman uyumsuz olarak kopyalar. Bu işlem, kopyalama işlemini denetlemek veya durdurmak için kullanabileceğiniz bir kopyalama kimliği de dahil olmak üzere bir kopyalama işlemi özellikleri nesnesi döndürür. Dosya hizmeti, dosyaları en iyi çaba temelinde kopyalar. Hedef dosya varsa, üzerine yazılır. Kopyalama işlemi devam ederken hedef dosya değiştirilemez. |
create_directory |
Belirtilen paylaşım veya üst dizin altında yeni bir dizin oluşturur. Aynı ada sahip dizin zaten varsa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_on_exists için True değerini belirtin. |
create_file |
Yeni bir dosya oluşturur. Otomatik öbekleme ve ilerleme bildirimleriyle büyük dosyaların oluşturulmasını ve karşıya yüklenmesini işleyen üst düzey işlevler için bkz. create_file_from_*. |
create_file_from_bytes |
Bir bayt dizisinden yeni bir dosya oluşturur veya otomatik öbekleme ve ilerleme durumu bildirimleriyle var olan bir dosyanın içeriğini güncelleştirir. |
create_file_from_path |
Yerel dosya yolundan yeni bir Azure dosyası oluşturur veya var olan bir dosyanın içeriğini otomatik öbekleme ve ilerleme durumu bildirimleriyle güncelleştirir. |
create_file_from_stream |
Bir dosyadan/akıştan yeni bir dosya oluşturur veya otomatik öbekleme ve ilerleme durumu bildirimleriyle var olan bir dosyanın içeriğini güncelleştirir. |
create_file_from_text |
str/unicode'dan yeni bir dosya oluşturur veya var olan bir dosyanın içeriğini otomatik öbekleme ve ilerleme bildirimleriyle güncelleştirir. |
create_permission_for_share |
Paylaşım düzeyinde bir izin (güvenlik tanımlayıcısı) oluşturun. Bu 'izin' paylaşımdaki dosyalar/dizinler için kullanılabilir. Bir 'izin' zaten varsa anahtarını döndürür, aksi takdirde paylaşım düzeyinde yeni bir izin oluşturur ve anahtarını döndürür. :, bir dosya izin anahtarı döndürür :rtype str |
create_share |
Belirtilen hesap altında yeni bir paylaşım oluşturur. Aynı ada sahip paylaşım zaten varsa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutuldu. Özel durumu ortaya çıkarmak için fail_on_exists için True değerini belirtin. |
delete_directory |
Belirtilen boş dizini siler. Dizinin silinebilmesi için önce boş olması gerektiğini unutmayın. Boş olmayan dizinleri silme girişimi başarısız olur. Dizin yoksa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_not_exist için True değerini belirtin. |
delete_file |
Belirtilen dosyayı silinmek üzere işaretler. Dosya daha sonra çöp toplama sırasında silinir. |
delete_share |
Belirtilen paylaşımı silinmek üzere işaretler. Paylaşım yoksa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_not_exist için True değerini belirtin. |
exists |
Yalnızca paylaşım adı verildiğinde paylaşımın var olup olmadığını gösteren bir boole döndürür. directory_name özelse dizinin var olup olmadığını belirten bir boole değeri döndürülür. file_name de belirtilirse, dosyanın var olup olmadığını belirten bir boole değeri döndürülür. |
extract_date_and_request_id | |
generate_account_shared_access_signature |
Dosya hizmeti için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın. |
generate_file_shared_access_signature |
Dosya için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın. |
generate_share_shared_access_signature |
Paylaşım için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın. |
get_directory_metadata |
Belirtilen dizin için kullanıcı tanımlı tüm meta verileri döndürür. |
get_directory_properties |
Belirtilen dizin için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler dizinin dosya listesini içermez. |
get_file_metadata |
Belirtilen dosya için kullanıcı tanımlı tüm meta verileri döndürür. |
get_file_properties |
Dosya için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. ve FileProperties meta veri diktesinin File bir örneğini döndürür. |
get_file_service_properties |
Azure Depolama Analizi dahil olmak üzere depolama hesabının Dosya hizmetinin özelliklerini alır. |
get_file_to_bytes |
Otomatik öbekleme ve ilerleme bildirimleri içeren bir bayt dizisi olarak bir dosya indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini File döndürür. |
get_file_to_path |
Otomatik öbekleme ve ilerleme bildirimleriyle bir dosyayı dosya yoluna indirir. Özellikleri ve meta verileri olan bir Dosya örneği döndürür. |
get_file_to_stream |
Otomatik öbekleme ve ilerleme bildirimleri içeren bir dosyayı akışa indirir. Özellikleri ve meta verileri olan bir örneğini File döndürür. |
get_file_to_text |
Dosyayı otomatik öbekleme ve ilerleme bildirimleriyle unicode metin olarak indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini File döndürür. |
get_permission_for_share |
Paylaşım düzeyinde bir izin (güvenlik tanımlayıcısı) oluşturun. Bu 'izin' paylaşımdaki dosyalar/dizinler için kullanılabilir. Bir 'izin' zaten varsa anahtarını döndürür, aksi takdirde paylaşım düzeyinde yeni bir izin oluşturur ve anahtarını döndürür. :bir dosya izni (taşınabilir SDDL) döndürür :rtype str |
get_share_acl |
Belirtilen paylaşım için izinleri alır. |
get_share_metadata |
Belirtilen paylaşım için kullanıcı tanımlı tüm meta verileri döndürür. |
get_share_properties |
Belirtilen paylaşım için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler, paylaşımların dosya veya dizin listesini içermez. |
get_share_stats |
Paylaşımda depolanan verilerin yaklaşık boyutunu alır ve en yakın gigabayta yuvarlanır. Bu değerin yakın zamanda oluşturulan veya yakın zamanda yeniden boyutlandırılan tüm dosyaları içeremediğini unutmayın. |
get_share_stats_in_bytes |
Paylaşımda depolanan verilerin bayt cinsinden yaklaşık boyutunu alır. Bu değerin yakın zamanda oluşturulan veya yakın zamanda yeniden boyutlandırılan tüm dosyaları içeremediğini unutmayın. |
list_directories_and_files |
Belirtilen paylaşım altındaki dizinleri ve dosyaları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm dizinler ve dosyalar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve paylaşımda bu sayıdan fazla dosya ve dizin varsa, oluşturucunun tamamlandığında doldurulmuş bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
list_handles |
Bir dizindeki veya belirtilen paylaşımın altındaki bir dosyadaki açık tanıtıcıları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm tanıtıcılar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve paylaşımda bu sayıdan fazla dosya ve dizin varsa, oluşturucunun tamamlandığında doldurulmuş bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
list_ranges |
Bir dosya için geçerli aralıkları alır. |
list_shares |
Belirtilen hesabın altındaki paylaşımları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm paylaşımlar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve hesap bu sayıdan daha fazla paylaşıma sahipse, oluşturucunun tamamlandığında doldurulan bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
make_file_url |
Bir dosyaya erişmek için URL'yi oluşturur. |
resize_file |
Bir dosyayı belirtilen boyuta yeniden boyutlandırıyor. Belirtilen bayt değeri dosyanın geçerli boyutundan küçükse, belirtilen bayt değerinin üzerindeki tüm aralıklar temizlenir. |
set_directory_metadata |
Belirtilen dizin için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, dizinine eklenmiş olan tüm meta verilerin yerini alır. Dizinden tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın. |
set_directory_properties | |
set_file_metadata |
Belirtilen dosya için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. |
set_file_properties |
Dosyadaki sistem özelliklerini ayarlar. content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır. |
set_file_service_properties |
Azure Depolama Analizi dahil olmak üzere depolama hesabının Dosya hizmetinin özelliklerini ayarlar. Bir öğe (örn. HourMetrics) Yok olarak bırakılırsa, bu işlev için hizmette var olan ayarlar korunur. |
set_proxy |
HTTP CONNECT Tüneli için ara sunucu ana bilgisayarını ve bağlantı noktasını ayarlar. |
set_share_acl |
Paylaşılan Erişim İmzaları ile kullanılabilecek belirtilen paylaşım veya depolanmış erişim ilkeleri için izinleri ayarlar. |
set_share_metadata |
Belirtilen paylaşım için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, paylaşıma eklenmiş olan tüm meta verilerin yerini alır. Paylaşımdaki tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın. |
set_share_properties |
Belirtilen paylaşım için hizmet tanımlı özellikleri ayarlar. |
snapshot_share |
Belirtilen hesap altında mevcut bir paylaşımın anlık görüntüsünü oluşturur. |
update_range |
İstek gövdesi tarafından belirtilen baytları belirtilen aralığa yazar. |
update_range_from_file_url |
Bir Azure Dosya uç noktasındaki baytları başka bir Azure Dosya uç noktasının belirtilen aralığına yazar. |
abort_copy_file
Bekleyen bir copy_file işlemini durdurur ve hedef dosyayı sıfır uzunlukta ve tam meta verilerle bırakır.
abort_copy_file(share_name, directory_name, file_name, copy_id, timeout=None)
Parametreler
clear_range
Belirtilen aralığı temizler ve bu aralık için depolama alanında kullanılan alanı serbest bırakır.
clear_range(share_name, directory_name, file_name, start_range, end_range, timeout=None)
Parametreler
- start_range
- int
Dosyanın bir bölümünü temizlemek için kullanılacak bayt aralığının başlangıcı. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü temizlemek için kullanılacak bayt aralığı sonu. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
close_handles
Dizindeki veya belirtilen paylaşım altındaki bir dosyadaki açık tanıtıcıları kapatmak için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm tanıtıcılar kapatıldığında durur. Elde edilen değerler, her işlemde kapatılan tanıtıcıların sayısını temsil eder.
close_handles(share_name, directory_name=None, file_name=None, recursive=None, handle_id=None, marker=None, snapshot=None, timeout=None)
Parametreler
- recursive
- bool
İşlemin URI'de belirtilen dizine, dosyalarına, alt dizinlerine ve dosyalarına uygulanıp uygulanacağını belirten Boole değeri.
- handle_id
- str
Gereklidir. Kapatılacak dosya veya dizinde açılan tanıtıcı kimliğini belirtir. Astrix ('*'), tüm tanıtıcıları belirten bir joker karakterdir.
- marker
- str
Opak bir devamlılık belirteci. Bu değer, önceki bir oluşturucu nesnesinin kapanış tutamaçlarını tamamlamadıysa next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan tanıtıcıları kapatmaya başlar.
copy_file
Dosyayı zaman uyumsuz olarak kopyalar. Bu işlem, kopyalama işlemini denetlemek veya durdurmak için kullanabileceğiniz bir kopyalama kimliği de dahil olmak üzere bir kopyalama işlemi özellikleri nesnesi döndürür. Dosya hizmeti, dosyaları en iyi çaba temelinde kopyalar.
Hedef dosya varsa, üzerine yazılır. Kopyalama işlemi devam ederken hedef dosya değiştirilemez.
copy_file(share_name, directory_name, file_name, copy_source, metadata=None, timeout=None)
Parametreler
- file_name
- str
Hedef dosyanın adı. Hedef dosya varsa, üzerine yazılır. Aksi takdirde oluşturulur.
- copy_source
- str
Azure dosyasını veya blobu belirten en fazla 2 KB uzunluğunda bir URL. Değer, istek URI'sinde göründüğü gibi URL ile kodlanmış olmalıdır. Kaynak başka bir hesaptaysa, kaynağın ortak olması veya paylaşılan erişim imzası aracılığıyla kimliğinin doğrulanması gerekir. Kaynak genelse kimlik doğrulaması gerekmez. Örnekler: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. Ad-değer çifti belirtilmezse, işlem meta verileri kaynak blobdan veya dosyadan hedef dosyaya kopyalar. Bir veya daha fazla ad-değer çifti belirtilirse, hedef dosya belirtilen meta verilerle oluşturulur ve meta veriler kaynak blobdan veya dosyadan kopyalanmaz.
Döndürülenler
Durum, kaynak ve kimlik gibi işlem özelliklerini kopyalayın.
Dönüş türü
create_directory
Belirtilen paylaşım veya üst dizin altında yeni bir dizin oluşturur. Aynı ada sahip dizin zaten varsa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_on_exists için True değerini belirtin.
create_directory(share_name, directory_name, metadata=None, fail_on_exist=False, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
Paylaşımla meta veri olarak ilişkilendirilecek name_value çiftleri olan bir dikte. Örnek:{'Category':'test'}
- fail_on_exist
- bool
dizin mevcut olduğunda özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
Döndürülenler
Dizin oluşturulduysa True, dizin zaten varsa False.
Dönüş türü
create_file
Yeni bir dosya oluşturur.
Otomatik öbekleme ve ilerleme bildirimleriyle büyük dosyaların oluşturulmasını ve karşıya yüklenmesini işleyen üst düzey işlevler için bkz. create_file_from_*.
create_file(share_name, directory_name, file_name, content_length, content_settings=None, metadata=None, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
Dosyayla meta veri olarak ilişkili ad-değer çiftleri.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
create_file_from_bytes
Bir bayt dizisinden yeni bir dosya oluşturur veya otomatik öbekleme ve ilerleme durumu bildirimleriyle var olan bir dosyanın içeriğini güncelleştirir.
create_file_from_bytes(share_name, directory_name, file_name, file, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
- count
- int
Karşıya yüklenecek bayt sayısı. Dizinden başlayarak tüm baytları karşıya yüklemek için Yok veya negatif değer olarak ayarlayın.
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
Dosyayla meta veri olarak ilişkili ad-değer çiftleri.
- validate_content
- bool
True ise, dosyanın her aralığı için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Bu MD5 karması dosyayla birlikte depolanmaz.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam dosya boyutudur veya toplam boyutu bilinmiyorsa Hiçbiri olur.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
create_file_from_path
Yerel dosya yolundan yeni bir Azure dosyası oluşturur veya var olan bir dosyanın içeriğini otomatik öbekleme ve ilerleme durumu bildirimleriyle güncelleştirir.
create_file_from_path(share_name, directory_name, file_name, local_file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>, timeout=None)
Parametreler
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
Dosyayla meta veri olarak ilişkili ad-değer çiftleri.
- validate_content
- bool
True ise, dosyanın her aralığı için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Bu MD5 karması dosyayla birlikte depolanmaz.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam dosya boyutudur veya toplam boyutu bilinmiyorsa Hiçbiri olur.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
create_file_from_stream
Bir dosyadan/akıştan yeni bir dosya oluşturur veya otomatik öbekleme ve ilerleme durumu bildirimleriyle var olan bir dosyanın içeriğini güncelleştirir.
create_file_from_stream(share_name, directory_name, file_name, stream, count, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
- count
- int
Akıştan okunacak bayt sayısı. Bu gereklidir, sayı bilinmiyorsa dosya oluşturulamaz.
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
Dosyayla meta veri olarak ilişkili ad-değer çiftleri.
- validate_content
- bool
True ise, dosyanın her aralığı için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Bu MD5 karması dosyayla birlikte depolanmaz.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam dosya boyutudur veya toplam boyutu bilinmiyorsa Hiçbiri olur.
- max_connections
- int
Kullanılacak en fazla paralel bağlantı sayısı. Paralel karşıya yüklemenin akışın aranabilir olmasını gerektirdiğini unutmayın.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
create_file_from_text
str/unicode'dan yeni bir dosya oluşturur veya var olan bir dosyanın içeriğini otomatik öbekleme ve ilerleme bildirimleriyle güncelleştirir.
create_file_from_text(share_name, directory_name, file_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
Dosyayla meta veri olarak ilişkili ad-değer çiftleri.
- validate_content
- bool
True ise, dosyanın her aralığı için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Bu MD5 karması dosyayla birlikte depolanmaz.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
create_permission_for_share
Paylaşım düzeyinde bir izin (güvenlik tanımlayıcısı) oluşturun. Bu 'izin' paylaşımdaki dosyalar/dizinler için kullanılabilir. Bir 'izin' zaten varsa anahtarını döndürür, aksi takdirde paylaşım düzeyinde yeni bir izin oluşturur ve anahtarını döndürür.
:, bir dosya izin anahtarı döndürür :rtype str
create_permission_for_share(share_name, file_permission, timeout=None)
Parametreler
- share_name
Paylaşım adı.
- file_permission
Dosya izni, Taşınabilir SDDL
- timeout
Zaman aşımı parametresi saniye cinsinden ifade edilir.
create_share
Belirtilen hesap altında yeni bir paylaşım oluşturur. Aynı ada sahip paylaşım zaten varsa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutuldu. Özel durumu ortaya çıkarmak için fail_on_exists için True değerini belirtin.
create_share(share_name, metadata=None, quota=None, fail_on_exist=False, timeout=None)
Parametreler
Paylaşımı meta veri olarak ilişkilendirmek için name_value çiftleri olan bir dikte. Örnek:{'Category':'test'}
- quota
- int
Paylaşımın en büyük boyutunu gigabayt cinsinden belirtir. 0'dan büyük ve 5 TB'tan küçük veya buna eşit olmalıdır (5120).
- fail_on_exist
- bool
Paylaşım mevcut olduğunda özel durum oluşturup oluşturmayacağını belirtin. Varsayılan olarak false.
Döndürülenler
Paylaşım oluşturulduysa True, paylaşım zaten varsa False.
Dönüş türü
delete_directory
Belirtilen boş dizini siler. Dizinin silinebilmesi için önce boş olması gerektiğini unutmayın. Boş olmayan dizinleri silme girişimi başarısız olur.
Dizin yoksa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_not_exist için True değerini belirtin.
delete_directory(share_name, directory_name, fail_not_exist=False, timeout=None)
Parametreler
- fail_not_exist
- bool
Dizin mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin.
Döndürülenler
Dizin silinirse True, aksi takdirde False.
Dönüş türü
delete_file
Belirtilen dosyayı silinmek üzere işaretler. Dosya daha sonra çöp toplama sırasında silinir.
delete_file(share_name, directory_name, file_name, timeout=None)
Parametreler
delete_share
Belirtilen paylaşımı silinmek üzere işaretler. Paylaşım yoksa, işlem hizmette başarısız olur. Varsayılan olarak, özel durum istemci tarafından yutılır. Özel durumu ortaya çıkarmak için fail_not_exist için True değerini belirtin.
delete_share(share_name, fail_not_exist=False, timeout=None, snapshot=None, delete_snapshots=None)
Parametreler
- fail_not_exist
- bool
Paylaşım mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false.
- snapshot
- str
Varsa anlık görüntü sürümünü temsil eden bir dize. Yalnızca belirli bir anlık görüntüyü silmek için bu bağımsız değişkeni belirtin. delete_snapshots belirtildiyse Hiçbiri olmalıdır.
- delete_snapshots
- DeleteSnapshot
Anlık görüntüleri olan bir paylaşımı silmek için bunun DeleteSnapshot.Include olarak belirtilmesi gerekir.
Döndürülenler
Paylaşım silinirse Doğru, Yanlış paylaşım mevcut değildir.
Dönüş türü
exists
Yalnızca paylaşım adı verildiğinde paylaşımın var olup olmadığını gösteren bir boole döndürür. directory_name özelse dizinin var olup olmadığını belirten bir boole değeri döndürülür. file_name de belirtilirse, dosyanın var olup olmadığını belirten bir boole değeri döndürülür.
exists(share_name, directory_name=None, file_name=None, timeout=None, snapshot=None)
Parametreler
Döndürülenler
Kaynağın var olup olmadığını gösteren boole değeri.
Dönüş türü
extract_date_and_request_id
static extract_date_and_request_id(retry_context)
Parametreler
- retry_context
generate_account_shared_access_signature
Dosya hizmeti için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)
Parametreler
- resource_types
- <xref:ResourceTypes>
Hesap SAS'siyle erişilebilen kaynak türlerini belirtir.
- permission
- <xref:AccountPermissions>
Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı izinler tarafından izin verilen işlemlerle sınırlıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz olduğu saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- ip
- str
İsteklerin kabul edildiği bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Olası değerler hem HTTPS hem de HTTP (https,http) veya yalnızca HTTPS (https) değerleridir. Varsayılan değer https,http'dir. Yalnızca HTTP'nin izin verilen bir değer olmadığını unutmayın.
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
generate_file_shared_access_signature
Dosya için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın.
generate_file_shared_access_signature(share_name, directory_name=None, file_name=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)
Parametreler
- directory_name
- str
Dizinin adı. Dizinler için SAS belirteçleri oluşturulamadığı için bu parametrenin yalnızca file_name sağlandığında mevcut olması gerekir.
- permission
- FilePermissions
Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı izinler tarafından izin verilen işlemlerle sınırlıdır. İzinler okuma, oluşturma, yazma, silme, listeleme sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz olduğu saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- id
- str
Depolanmış erişim ilkesiyle bağıntılı 64 karakter uzunluğunda benzersiz bir değer. Depolanan erişim ilkesi oluşturmak için set_file_service_properties kullanın.
- ip
- str
İsteklerin kabul edildiği bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Olası değerler hem HTTPS hem de HTTP (https,http) veya yalnızca HTTPS (https) değerleridir. Varsayılan değer https,http'dir. Yalnızca HTTP'nin izin verilen bir değer olmadığını unutmayın.
- cache_control
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.
- content_disposition
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Disposition için yanıt üst bilgisi değeri.
- content_encoding
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.
- content_language
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.
- content_type
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Type için yanıt üst bilgisi değeri.
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
generate_share_shared_access_signature
Paylaşım için paylaşılan erişim imzası oluşturur. Döndürülen imzayı FileService'in sas_token parametresiyle kullanın.
generate_share_shared_access_signature(share_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)
Parametreler
- permission
- SharePermissions
Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı izinler tarafından izin verilen işlemlerle sınırlıdır. İzinler okuma, oluşturma, yazma, silme, listeleme sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz olduğu saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- id
- str
Depolanmış erişim ilkesiyle bağıntılı 64 karakter uzunluğunda benzersiz bir değer. Depolanan erişim ilkesi oluşturmak için kullanın set_share_acl.
- ip
- str
İsteklerin kabul edildiği bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Olası değerler hem HTTPS hem de HTTP (https,http) veya yalnızca HTTPS (https) değerleridir. Varsayılan değer https,http'dir. Yalnızca HTTP'nin izin verilen bir değer olmadığını unutmayın.
- cache_control
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.
- content_disposition
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Disposition için yanıt üst bilgisi değeri.
- content_encoding
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.
- content_language
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.
- content_type
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Type için yanıt üst bilgisi değeri.
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
get_directory_metadata
Belirtilen dizin için kullanıcı tanımlı tüm meta verileri döndürür.
get_directory_metadata(share_name, directory_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
Dizin meta veri adını ve değer çiftlerini temsil eden sözlük.
Dönüş türü
get_directory_properties
Belirtilen dizin için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler dizinin dosya listesini içermez.
get_directory_properties(share_name, directory_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
bir dizin nesnesi içinde belirtilen dizin için özellikler.
Dönüş türü
get_file_metadata
Belirtilen dosya için kullanıcı tanımlı tüm meta verileri döndürür.
get_file_metadata(share_name, directory_name, file_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
Dosya meta veri adını ve değer çiftlerini temsil eden sözlük.
Dönüş türü
get_file_properties
Dosya için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. ve FileProperties meta veri diktesinin File bir örneğini döndürür.
get_file_properties(share_name, directory_name, file_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
özellikleri ve meta verileri içeren bir dosya nesnesi.
Dönüş türü
get_file_service_properties
Azure Depolama Analizi dahil olmak üzere depolama hesabının Dosya hizmetinin özelliklerini alır.
get_file_service_properties(timeout=None)
Parametreler
Döndürülenler
Dosya hizmeti özellikleri.
Dönüş türü
get_file_to_bytes
Otomatik öbekleme ve ilerleme bildirimleri içeren bir bayt dizisi olarak bir dosya indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini File döndürür.
get_file_to_bytes(share_name, directory_name, file_name, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)
Parametreler
- start_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. end_range verilmezse, start_range sonraki tüm baytlar indirilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığı sonu. end_range verilirse start_range sağlanmalıdır. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- validate_content
- bool
true olarak ayarlanırsa, dosyanın alınan her bölümü için bir MD5 karması doğrular. Https yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Hizmetin yalnızca 4 MB veya daha az öbekler için işlem MD5'leri döndüreceğini unutmayın, böylece ilk alma isteği kendi boyutunda olur. Kendini değil MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmış bir hata oluşturulur. MD5 işlem süresini aldığından ve öbek boyutunun azalması nedeniyle daha fazla istek yapılması gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme durumu için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa dosyanın boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa, ilk alma işlemi ilk kendisi için yapılır. dosyanın baytlarını MAX_SINGLE_GET_SIZE. Dosyanın tamamı buysa, yöntemi bu noktada döndürür. Aksi takdirde, max_connections eşit iş parçacığı sayısını kullanarak kalan verileri paralel olarak indirir. Her öbek kendi boyutunda olacaktır. MAX_CHUNK_GET_SIZE. 1 olarak ayarlanırsa tek bir büyük alma isteği yapılır. Bu genellikle önerilmez, ancak çok az iş parçacığı kullanılması gerekiyorsa, ağ istekleri çok pahalıysa veya aranamaz bir akış paralel indirmeyi engelliyorsa kullanılabilir. Dosya eşzamanlı olarak bölünmezliği zorunlu kılacak şekilde değiştiriliyorsa veya max_connections 1'den büyükse boş dosyalar için fazladan istek gerektiğinden birçok dosyanın boş olması bekleniyorsa bu da değerli olabilir.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özelliklere, içeriğe ve meta verilere sahip bir Dosya.
Dönüş türü
get_file_to_path
Otomatik öbekleme ve ilerleme bildirimleriyle bir dosyayı dosya yoluna indirir. Özellikleri ve meta verileri olan bir Dosya örneği döndürür.
get_file_to_path(share_name, directory_name, file_name, file_path, open_mode='wb', start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)
Parametreler
- open_mode
- str
Dosyayı açarken kullanılacak mod. Yalnızca ekleme open_mode belirtilmesinin paralel indirmeyi engellediğini unutmayın. Bu nedenle, bu open_mode kullanılıyorsa max_connections 1 olarak ayarlanmalıdır.
- start_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. end_range verilmezse, start_range sonraki tüm baytlar indirilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığı sonu. end_range verilirse start_range sağlanmalıdır. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- validate_content
- bool
true olarak ayarlanırsa, dosyanın alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa dosyanın boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Dosyanın baytlarını MAX_SINGLE_GET_SIZE. Bu dosyanın tamamıysa, yöntemi bu noktada döndürür. Aksi takdirde, max_connections eşit iş parçacığı sayısını kullanarak kalan verileri paralel olarak indirir. Her öbek kendi boyutunda olacaktır. MAX_CHUNK_GET_SIZE. 1 olarak ayarlanırsa tek bir büyük get isteği yapılır. Bu genellikle önerilmez, ancak çok az iş parçacığı kullanılması gerekiyorsa, ağ istekleri çok pahalıysa veya aranamaz bir akış paralel indirmeyi engelliyorsa kullanılabilir. Dosya eş zamanlı olarak bölünmezliği zorunlu kılacak şekilde değiştiriliyorsa veya max_connections 1'den büyükse boş dosyalar için ek istek gerektiğinden çok sayıda dosyanın boş olması bekleniyorsa bu da değerli olabilir.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikler ve meta veriler içeren bir Dosya.
Dönüş türü
get_file_to_stream
Otomatik öbekleme ve ilerleme bildirimleri içeren bir dosyayı akışa indirir. Özellikleri ve meta verileri olan bir örneğini File döndürür.
get_file_to_stream(share_name, directory_name, file_name, stream, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)
Parametreler
- start_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. end_range verilmezse, start_range sonraki tüm baytlar indirilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığı sonu. end_range verilirse start_range sağlanmalıdır. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- validate_content
- bool
true olarak ayarlanırsa, dosyanın alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa dosyanın boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Dosyanın baytlarını MAX_SINGLE_GET_SIZE. Bu dosyanın tamamıysa, yöntemi bu noktada döndürür. Aksi takdirde, max_connections eşit iş parçacığı sayısını kullanarak kalan verileri paralel olarak indirir. Her öbek kendi boyutunda olacaktır. MAX_CHUNK_GET_SIZE. 1 olarak ayarlanırsa tek bir büyük get isteği yapılır. Bu genellikle önerilmez, ancak çok az iş parçacığı kullanılması gerekiyorsa, ağ istekleri çok pahalıysa veya aranamaz bir akış paralel indirmeyi engelliyorsa kullanılabilir. Dosya eş zamanlı olarak bölünmezliği zorunlu kılacak şekilde değiştiriliyorsa veya max_connections 1'den büyükse boş dosyalar için ek istek gerektiğinden çok sayıda dosyanın boş olması bekleniyorsa bu da değerli olabilir.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikler ve meta veriler içeren bir Dosya.
Dönüş türü
get_file_to_text
Dosyayı otomatik öbekleme ve ilerleme bildirimleriyle unicode metin olarak indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini File döndürür.
get_file_to_text(share_name, directory_name, file_name, encoding='utf-8', start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)
Parametreler
- encoding
- str
Dosya verilerinin kodunu çözerken kullanılacak Python kodlaması.
- start_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. end_range verilmezse, start_range sonraki tüm baytlar indirilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü indirmek için kullanılacak bayt aralığı sonu. end_range verilirse start_range sağlanmalıdır. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- validate_content
- bool
true olarak ayarlanırsa, dosyanın alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa dosyanın boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Dosyanın baytlarını MAX_SINGLE_GET_SIZE. Bu dosyanın tamamıysa, yöntemi bu noktada döndürür. Aksi takdirde, max_connections eşit iş parçacığı sayısını kullanarak kalan verileri paralel olarak indirir. Her öbek kendi boyutunda olacaktır. MAX_CHUNK_GET_SIZE. 1 olarak ayarlanırsa tek bir büyük get isteği yapılır. Bu genellikle önerilmez, ancak çok az iş parçacığı kullanılması gerekiyorsa, ağ istekleri çok pahalıysa veya aranamaz bir akış paralel indirmeyi engelliyorsa kullanılabilir. Dosya eş zamanlı olarak bölünmezliği zorunlu kılacak şekilde değiştiriliyorsa veya max_connections 1'den büyükse boş dosyalar için ek istek gerektiğinden çok sayıda dosyanın boş olması bekleniyorsa bu da değerli olabilir.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özelliklere, içeriğe ve meta verilere sahip bir Dosya.
Dönüş türü
get_permission_for_share
Paylaşım düzeyinde bir izin (güvenlik tanımlayıcısı) oluşturun. Bu 'izin' paylaşımdaki dosyalar/dizinler için kullanılabilir. Bir 'izin' zaten varsa anahtarını döndürür, aksi takdirde paylaşım düzeyinde yeni bir izin oluşturur ve anahtarını döndürür.
:bir dosya izni (taşınabilir SDDL) döndürür :rtype str
get_permission_for_share(share_name, file_permission_key, timeout=None)
Parametreler
- share_name
Paylaşım adı.
- file_permission_key
Alınacak dosya izninin anahtarı
- timeout
Zaman aşımı parametresi saniye cinsinden ifade edilir.
get_share_acl
Belirtilen paylaşım için izinleri alır.
get_share_acl(share_name, timeout=None)
Parametreler
Döndürülenler
Paylaşımla ilişkilendirilmiş erişim ilkeleri sözlüğü.
Dönüş türü
get_share_metadata
Belirtilen paylaşım için kullanıcı tanımlı tüm meta verileri döndürür.
get_share_metadata(share_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
Paylaşım meta veri adını, değer çiftlerini temsil eden sözlük.
Dönüş türü
get_share_properties
Belirtilen paylaşım için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler, paylaşımların dosya veya dizin listesini içermez.
get_share_properties(share_name, timeout=None, snapshot=None)
Parametreler
Döndürülenler
Özellikleri ve meta verileri kullanıma sunan paylaşım.
Dönüş türü
get_share_stats
Paylaşımda depolanan verilerin yaklaşık boyutunu alır ve en yakın gigabayta yuvarlanır.
Bu değerin yakın zamanda oluşturulan veya yakın zamanda yeniden boyutlandırılan tüm dosyaları içeremediğini unutmayın.
get_share_stats(share_name, timeout=None)
Parametreler
Döndürülenler
paylaşımda depolanan verilerin yaklaşık boyutu.
Dönüş türü
get_share_stats_in_bytes
Paylaşımda depolanan verilerin bayt cinsinden yaklaşık boyutunu alır.
Bu değerin yakın zamanda oluşturulan veya yakın zamanda yeniden boyutlandırılan tüm dosyaları içeremediğini unutmayın.
get_share_stats_in_bytes(share_name, timeout=None)
Parametreler
Döndürülenler
paylaşımda depolanan verilerin yaklaşık boyutu.
Dönüş türü
list_directories_and_files
Belirtilen paylaşım altındaki dizinleri ve dosyaları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm dizinler ve dosyalar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve paylaşımda bu sayıdan fazla dosya ve dizin varsa, oluşturucunun tamamlandığında doldurulmuş bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_directories_and_files(share_name, directory_name=None, num_results=None, marker=None, timeout=None, prefix=None, snapshot=None)
Parametreler
- num_results
- int
Tüm dizin öğeleri dahil olmak üzere döndürülecek en fazla dosya sayısını belirtir. İstek num_results belirtmezse veya 5.000'den büyük bir değer belirtirse, sunucu en fazla 5.000 öğe döndürür. num_results sıfırdan küçük veya sıfıra eşit bir değere ayarlanması hata yanıt kodu 400 (Hatalı İstek) ile sonuçlanır.
- marker
- str
Opak bir devamlılık belirteci. Bu değer, num_results belirtildiyse ve bu oluşturucu sonuçları listelemeyi bitirdiyse, önceki bir oluşturucu nesnesinin next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan sonuç döndürmeye başlar.
- prefix
- str
Yalnızca belirtilen ön eke sahip dosyaları ve/veya dizinleri listeleyin.
list_handles
Bir dizindeki veya belirtilen paylaşımın altındaki bir dosyadaki açık tanıtıcıları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm tanıtıcılar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve paylaşımda bu sayıdan fazla dosya ve dizin varsa, oluşturucunun tamamlandığında doldurulmuş bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_handles(share_name, directory_name=None, file_name=None, recursive=None, max_results=None, marker=None, snapshot=None, timeout=None)
Parametreler
- recursive
- bool
İşlemin URI'de belirtilen dizine, dosyalarına, alt dizinlerine ve dosyalarına uygulanıp uygulanacağını belirten Boole değeri.
- max_results
- int
Döndürülecek dosya ve/veya dizinlerde alınan en fazla tanıtıcı sayısını belirtir. İstek max_results belirtmezse veya 5.000'den büyük bir değer belirtirse, sunucu en fazla 5.000 öğe döndürür. max_results sıfırdan küçük veya sıfıra eşit bir değere ayarlanması hata yanıt kodu 400 (Hatalı İstek) ile sonuçlanır.
- marker
- str
Opak bir devamlılık belirteci. Bu değer, max_results belirtildiyse ve bu oluşturucu sonuçları listelemeyi bitirdiyse, önceki bir oluşturucu nesnesinin next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan sonuç döndürmeye başlar.
list_ranges
Bir dosya için geçerli aralıkları alır.
list_ranges(share_name, directory_name, file_name, start_range=None, end_range=None, timeout=None, snapshot=None)
Parametreler
- start_range
- int
Aralıkların listelendiği baytların başlangıç uzaklığını belirtir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Aralıkların listelendiği baytların bitiş uzaklığını belirtir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
Döndürülenler
geçerli aralıkların listesi
Dönüş türü
list_shares
Belirtilen hesabın altındaki paylaşımları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gevşek bir şekilde izler ve tüm paylaşımlar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve hesap bu sayıdan daha fazla paylaşıma sahipse, oluşturucunun tamamlandığında doldurulan bir next_marker alanı olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_shares(prefix=None, marker=None, num_results=None, include_metadata=False, timeout=None, include_snapshots=False)
Parametreler
- prefix
- str
Sonuçları yalnızca adları belirtilen ön ek ile başlayan paylaşımları döndürecek şekilde filtreler.
- include_metadata
- bool
Yanıtta paylaşım meta verilerinin döndürüldüğünü belirtir.
- marker
- str
Opak bir devamlılık belirteci. Bu değer, num_results belirtildiyse ve bu oluşturucu sonuçları listelemeyi bitirdiyse, önceki bir oluşturucu nesnesinin next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan sonuç döndürmeye başlar.
- include_snapshots
- bool
Yanıtta paylaşım anlık görüntülerinin döndürüldüğünü belirtir.
make_file_url
Bir dosyaya erişmek için URL'yi oluşturur.
make_file_url(share_name, directory_name, file_name, protocol=None, sas_token=None)
Parametreler
- protocol
- str
Kullanılacak protokol: 'http' veya 'https'. Belirtilmezse, FileService başlatıldığında belirtilen protokolü kullanır.
- sas_token
- str
generate_shared_access_signature ile oluşturulan paylaşılan erişim imzası belirteci.
Döndürülenler
dosya erişim URL'si.
Dönüş türü
resize_file
Bir dosyayı belirtilen boyuta yeniden boyutlandırıyor. Belirtilen bayt değeri dosyanın geçerli boyutundan küçükse, belirtilen bayt değerinin üzerindeki tüm aralıklar temizlenir.
resize_file(share_name, directory_name, file_name, content_length, timeout=None)
Parametreler
set_directory_metadata
Belirtilen dizin için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, dizinine eklenmiş olan tüm meta verilerin yerini alır. Dizinden tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın.
set_directory_metadata(share_name, directory_name, metadata=None, timeout=None)
Parametreler
Dizinle meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'}
set_directory_properties
set_directory_properties(share_name, directory_name, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>, timeout=None)
Parametreler
- share_name
Paylaşımın adı
- directory_name
Dizinin adı
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
set_file_metadata
Belirtilen dosya için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar.
set_file_metadata(share_name, directory_name, file_name, metadata=None, timeout=None)
Parametreler
Ad ve değer çiftlerini içeren dikte. Bu işleme yapılan her çağrı, dosyaya eklenmiş olan tüm meta verilerin yerini alır. Dosyadan tüm meta verileri kaldırmak için meta veri üst bilgileri olmadan bu işlemi çağırın.
set_file_properties
Dosyadaki sistem özelliklerini ayarlar. content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır.
set_file_properties(share_name, directory_name, file_name, content_settings, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)
Parametreler
- content_settings
- ContentSettings
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
- smb_properties
- SMBProperties
SMB ile ilgili dosya özelliklerini ayarlar
set_file_service_properties
Azure Depolama Analizi dahil olmak üzere depolama hesabının Dosya hizmetinin özelliklerini ayarlar. Bir öğe (örn. HourMetrics) Yok olarak bırakılırsa, bu işlev için hizmette var olan ayarlar korunur.
set_file_service_properties(hour_metrics=None, minute_metrics=None, cors=None, timeout=None)
Parametreler
- hour_metrics
- <xref:Metrics>
Saatlik ölçüm ayarları, dosyalar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
- minute_metrics
- <xref:Metrics>
Dakika ölçüm ayarları, dosyalar için her dakika için istek istatistikleri sağlar.
- cors
- list(CorsRule)
Listeye en fazla beş CorsRule öğesi ekleyebilirsiniz. Boş bir liste belirtilirse tüm CORS kuralları silinir ve hizmet için CORS devre dışı bırakılır.
set_proxy
HTTP CONNECT Tüneli için ara sunucu ana bilgisayarını ve bağlantı noktasını ayarlar.
set_proxy(host, port, user=None, password=None)
Parametreler
set_share_acl
Paylaşılan Erişim İmzaları ile kullanılabilecek belirtilen paylaşım veya depolanmış erişim ilkeleri için izinleri ayarlar.
set_share_acl(share_name, signed_identifiers=None, timeout=None)
Parametreler
- signed_identifiers
- dict(str, AccessPolicy)
Paylaşımla ilişkilendirilecek erişim ilkeleri sözlüğü. Sözlük en fazla 5 öğe içerebilir. Boş bir sözlük, hizmette ayarlanan erişim ilkelerini temizler.
set_share_metadata
Belirtilen paylaşım için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, paylaşıma eklenmiş olan tüm meta verilerin yerini alır. Paylaşımdaki tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın.
set_share_metadata(share_name, metadata=None, timeout=None)
Parametreler
Paylaşımla meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'}
set_share_properties
Belirtilen paylaşım için hizmet tanımlı özellikleri ayarlar.
set_share_properties(share_name, quota, timeout=None)
Parametreler
- quota
- int
Paylaşımın en büyük boyutunu gigabayt cinsinden belirtir. 0'dan büyük ve 5 TB'dan (5120 GB) küçük veya buna eşit olmalıdır.
snapshot_share
Belirtilen hesap altında mevcut bir paylaşımın anlık görüntüsünü oluşturur.
snapshot_share(share_name, metadata=None, quota=None, timeout=None)
Parametreler
- metadata
- <xref:<xref:a dict> of <xref:str to str:>>
Paylaşımla meta veri olarak ilişkilendirilecek name_value çiftleri olan bir dikte. Örnek:{'Category':'test'}
- quota
- int
Paylaşımın en büyük boyutunu gigabayt cinsinden belirtir. 0'dan büyük ve 5 TB'dan küçük veya buna eşit olmalıdır (5120).
Döndürülenler
anlık görüntü özellikleri
Dönüş türü
update_range
İstek gövdesi tarafından belirtilen baytları belirtilen aralığa yazar.
update_range(share_name, directory_name, file_name, data, start_range, end_range, validate_content=False, timeout=None)
Parametreler
- start_range
- int
Dosyanın bir bölümünü güncelleştirmek için kullanılacak bayt aralığının başlangıcı. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü güncelleştirmek için kullanılacak bayt aralığı sonu. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- validate_content
- bool
True ise, sayfa içeriğinin bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması dosyayla birlikte depolanmaz.
update_range_from_file_url
Bir Azure Dosya uç noktasındaki baytları başka bir Azure Dosya uç noktasının belirtilen aralığına yazar.
update_range_from_file_url(share_name, directory_name, file_name, start_range, end_range, source, source_start_range, timeout=None)
Parametreler
- start_range
- int
Dosyanın bir bölümünü güncelleştirmek için kullanılacak bayt aralığının başlangıcı. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- end_range
- int
Dosyanın bir bölümünü güncelleştirmek için kullanılacak bayt aralığı sonu. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
- source
- str
Azure dosyasını veya blobu belirten en fazla 2 KB uzunluğunda bir URL. Değer, istek URI'sinde göründüğü gibi URL ile kodlanmış olmalıdır. Kaynak başka bir hesaptaysa, kaynağın ortak olması veya paylaşılan erişim imzası aracılığıyla kimliğinin doğrulanması gerekir. Kaynak genelse kimlik doğrulaması gerekmez. Örnekler: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken
- source_start_range
- int
Dosyanın bir bölümünü güncelleştirmek için kullanılacak bayt aralığının başlangıcı. Aralığın boyutu 4 MB'a kadar olabilir. start_range ve end_range parametreleri dahil edilir. Örneğin: start_range=0, end_range=511 ilk 512 bayt dosyayı indirir.
Öznitelikler
protocol
request_session
socket_timeout
MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 8388608
MAX_RANGE_SIZE
MAX_RANGE_SIZE = 4194304
MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
Azure SDK for Python
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin