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

StorageClient

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

Name	Description
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. varsayılan değer: None
account_key	str Depolama hesabı anahtarı. Bu, paylaşılan anahtar kimlik doğrulaması için kullanılır. varsayılan değer: None
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. varsayılan değer: None
protocol	str İstekler için kullanılacak protokol. Varsayılan olarak https kullanılır. varsayılan değer: https
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. varsayılan değer: core.windows.net
request_session	<xref:requests.Session> Http istekleri için kullanılacak oturum nesnesi. varsayılan değer: None
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/. varsayılan değer: None
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. varsayılan değer: None

Değişkenler

Name	Description
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

Name	Description
share_name Gerekli	str Hedef paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Hedef dosyanın adı.
copy_id Gerekli	str Özgün copy_file işleminin copy.id sağlanan kopya tanımlayıcısı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
start_range Gerekli	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 Gerekli	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.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name	str Dizinin yolu. varsayılan değer: None
file_name	str Mevcut dosyanın adı. varsayılan değer: None
recursive	bool İşlemin URI'de belirtilen dizine, dosyalarına, alt dizinlerine ve dosyalarına uygulanıp uygulanacağını belirten Boole değeri. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Hedef paylaşımın adı. Paylaşım mevcut olmalıdır.
directory_name Gerekli	str Hedef dizinin adı. Dizinin var olması gerekir.
file_name Gerekli	str Hedef dosyanın adı. Hedef dosya varsa, üzerine yazılır. Aksi takdirde oluşturulur.
copy_source Gerekli	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
metadata	dict(str, str)<xref:./> 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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
CopyProperties	Durum, kaynak ve kimlik gibi işlem özelliklerini kopyalayın.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Üst dizinin yolu da dahil olmak üzere oluşturulacak dizinin adı.
metadata	dict(str, str)<xref::> Paylaşımla meta veri olarak ilişkilendirilecek name_value çiftleri olan bir dikte. Örnek:{'Category':'test'} varsayılan değer: None
fail_on_exist	bool dizin mevcut olduğunda özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
smb_properties	SMBProperties SMB ile ilgili dosya özelliklerini ayarlar
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
bool	Dizin oluşturulduysa True, dizin zaten varsa False.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Oluşturulacak veya güncelleştirilecek dosyanın adı.
content_length Gerekli	int Dosyanın bayt cinsinden uzunluğu.
content_settings	ContentSettings Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
metadata	dict(str, str) Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
smb_properties	SMBProperties SMB ile ilgili dosya özelliklerini ayarlar
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Oluşturulacak veya güncelleştirilecek dosyanın adı.
file Gerekli	str Dosyanın bayt dizisi olarak içeriği.
index	int Bayt dizisindeki dizini başlatın. varsayılan değer: 0
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. varsayılan değer: None
content_settings	ContentSettings Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
metadata	dict(str, str) Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
max_connections	int Kullanılacak en fazla paralel bağlantı sayısı. varsayılan değer: 2
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
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. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Oluşturulacak veya güncelleştirilecek dosyanın adı.
local_file_path Gerekli	str Dosya içeriği olarak karşıya yüklenecek yerel dosyanın yolu.
content_settings	ContentSettings Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
metadata	dict(str, str) Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
max_connections	int Kullanılacak en fazla paralel bağlantı sayısı. varsayılan değer: 2
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
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. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Oluşturulacak veya güncelleştirilecek dosyanın adı.
stream Gerekli	IOBase Dosya içeriği olarak karşıya yüklenecek dosya/akış açıldı.
count Gerekli	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. varsayılan değer: None
metadata	dict(str, str) Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
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. varsayılan değer: 2
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
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. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Oluşturulacak veya güncelleştirilecek dosyanın adı.
text Gerekli	str Dosyaya yüklenecek metin.
encoding	str Metni baytlara dönüştürmek için kullanılacak Python kodlaması. varsayılan değer: utf-8
content_settings	ContentSettings Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
metadata	dict(str, str) Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
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. varsayılan değer: False
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
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. varsayılan değer: None

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

Name	Description
share_name Gerekli	Paylaşım adı.
file_permission Gerekli	Dosya izni, Taşınabilir SDDL
timeout	Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Oluşturulacak paylaşımın adı.
metadata	dict(str, str) Paylaşımı meta veri olarak ilişkilendirmek için name_value çiftleri olan bir dikte. Örnek:{'Category':'test'} varsayılan değer: None
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). varsayılan değer: None
fail_on_exist	bool Paylaşım mevcut olduğunda özel durum oluşturup oluşturmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
bool	Paylaşım oluşturulduysa True, paylaşım zaten varsa False.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Üst dizinin yolu da dahil olmak üzere silinecek dizinin adı.
fail_not_exist	bool Dizin mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin. varsayılan değer: False
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
bool	Dizin silinirse True, aksi takdirde False.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Silinecek paylaşımın adı.
fail_not_exist	bool Paylaşım mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
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. varsayılan değer: None
delete_snapshots	DeleteSnapshot Anlık görüntüleri olan bir paylaşımı silmek için bunun DeleteSnapshot.Include olarak belirtilmesi gerekir. varsayılan değer: None

Döndürülenler

Tür	Description
bool	Paylaşım silinirse Doğru, Yanlış paylaşım mevcut değildir.

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

Name	Description
share_name Gerekli	str Paylaşımın adı.
directory_name	str Bir dizinin yolu. varsayılan değer: None
file_name	str Dosyanın adı. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
bool	Kaynağın var olup olmadığını gösteren boole değeri.

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parametreler

Name	Description
retry_context Gerekli

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

Name	Description
resource_types Gerekli	<xref:ResourceTypes> Hesap SAS'siyle erişilebilen kaynak türlerini belirtir.
permission Gerekli	<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.
expiry Gerekli	datetime veya str 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.
start	datetime veya str 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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None

Döndürülenler

Tür	Description
str	Paylaşılan Erişim İmzası (sas) belirteci.

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

Name	Description
share_name Gerekli	str Paylaşımın adı.
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. varsayılan değer: None
file_name	str Dosyanın adı. varsayılan değer: None
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. varsayılan değer: None
expiry	datetime veya str 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. varsayılan değer: None
start	datetime veya str 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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None

Döndürülenler

Tür	Description
str	Paylaşılan Erişim İmzası (sas) belirteci.

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

Name	Description
share_name Gerekli	str Paylaşımın adı.
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. varsayılan değer: None
expiry	datetime veya str 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. varsayılan değer: None
start	datetime veya str 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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None

Döndürülenler

Tür	Description
str	Paylaşılan Erişim İmzası (sas) belirteci.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
dict(str, str)	Dizin meta veri adını ve değer çiftlerini temsil eden sözlük.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Var olan bir dizinin yolu.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
Directory	bir dizin nesnesi içinde belirtilen dizin için özellikler.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
dict(str, str)	Dosya meta veri adını ve değer çiftlerini temsil eden sözlük.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
File	özellikleri ve meta verileri içeren bir dosya nesnesi.

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

Name	Description
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
ServiceProperties	Dosya hizmeti özellikleri.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
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. varsayılan değer: 2
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
File	Özelliklere, içeriğe ve meta verilere sahip bir Dosya.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
file_path Gerekli	str Yazacak dosyanın yolu.
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. varsayılan değer: wb
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
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. varsayılan değer: 2
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
File	Özellikler ve meta veriler içeren bir Dosya.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Varolan dosyanın adı.
stream Gerekli	IOBase Yazacak dosya/akış açıldı.
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
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. varsayılan değer: 2
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
File	Özellikler ve meta veriler içeren bir Dosya.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Varolan dosyanın adı.
encoding	str Dosya verilerinin kodunu çözerken kullanılacak Python kodlaması. varsayılan değer: utf-8
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. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: False
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. varsayılan değer: None
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. varsayılan değer: 2
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
File	Özelliklere, içeriğe ve meta verilere sahip bir Dosya.

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

Name	Description
share_name Gerekli	Paylaşım adı.
file_permission_key Gerekli	Alınacak dosya izninin anahtarı
timeout	Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

get_share_acl

Belirtilen paylaşım için izinleri alır.

get_share_acl(share_name, timeout=None)

Parametreler

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
dict(str, AccessPolicy)	Paylaşımla ilişkilendirilmiş erişim ilkeleri sözlüğü.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
dict(str, str)	Paylaşım meta veri adını, değer çiftlerini temsil eden sözlük.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
Share	Özellikleri ve meta verileri kullanıma sunan paylaşım.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
int	paylaşımda depolanan verilerin yaklaşık boyutu.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
int	paylaşımda depolanan verilerin yaklaşık boyutu.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name	str Dizinin yolu. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
prefix	str Yalnızca belirtilen ön eke sahip dosyaları ve/veya dizinleri listeleyin. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name	str Dizinin yolu. varsayılan değer: None
file_name	str Mevcut dosyanın adı. varsayılan değer: None
recursive	bool İşlemin URI'de belirtilen dizine, dosyalarına, alt dizinlerine ve dosyalarına uygulanıp uygulanacağını belirten Boole değeri. varsayılan değer: None
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. varsayılan değer: None
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. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
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. varsayılan değer: None
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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
snapshot	str Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None

Döndürülenler

Tür	Description
<xref:a> list <xref:of> FileRange	geçerli aralıkların listesi

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

Name	Description
prefix	str Sonuçları yalnızca adları belirtilen ön ek ile başlayan paylaşımları döndürecek şekilde filtreler. varsayılan değer: None
num_results	int Döndürülecek en fazla paylaşım sayısını belirtir. varsayılan değer: None
include_metadata	bool Yanıtta paylaşım meta verilerinin döndürüldüğünü belirtir. varsayılan değer: False
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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
include_snapshots	bool Yanıtta paylaşım anlık görüntülerinin döndürüldüğünü belirtir. varsayılan değer: False

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

Name	Description
share_name Gerekli	str Paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Dosyanın adı.
protocol	str Kullanılacak protokol: 'http' veya 'https'. Belirtilmezse, FileService başlatıldığında belirtilen protokolü kullanır. varsayılan değer: None
sas_token	str generate_shared_access_signature ile oluşturulan paylaşılan erişim imzası belirteci. varsayılan değer: None

Döndürülenler

Tür	Description
str	dosya erişim URL'si.

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
content_length Gerekli	int Dosyanın yeniden boyutlandırılası uzunluk.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
metadata	dict(str, str)<xref:./> Dizinle meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'} varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

set_directory_properties

set_directory_properties(share_name, directory_name, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>, timeout=None)

Parametreler

Name	Description
share_name Gerekli	Paylaşımın adı
directory_name Gerekli	Dizinin adı
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
smb_properties	SMBProperties SMB ile ilgili dosya özelliklerini ayarlar
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
metadata	dict(str, str) 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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
content_settings Gerekli	ContentSettings Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
file_permission	str Dosya izni, taşınabilir bir SDDL varsayılan değer: None
smb_properties	SMBProperties SMB ile ilgili dosya özelliklerini ayarlar
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
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. varsayılan değer: None
minute_metrics	<xref:Metrics> Dakika ölçüm ayarları, dosyalar için her dakika için istek istatistikleri sağlar. varsayılan değer: None
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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
host Gerekli	str Ara sunucu adresi. Örneğin: '192.168.0.100'
port Gerekli	int Ara sunucu bağlantı noktası. Örn: 6000
user	str Proxy yetkilendirmesi için kullanıcı. varsayılan değer: None
password	str Proxy yetkilendirme parolası. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
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. varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
metadata	dict(str, str) Paylaşımla meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'} varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

set_share_properties

Belirtilen paylaşım için hizmet tanımlı özellikleri ayarlar.

set_share_properties(share_name, quota, timeout=None)

Parametreler

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
quota Gerekli	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.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Anlık görüntüsünün oluşturulacağı paylaşımın adı.
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'} varsayılan değer: None
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). varsayılan değer: None
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Döndürülenler

Tür	Description
Share	anlık görüntü özellikleri

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
data Gerekli	bytes Aralığın içeriği.
start_range Gerekli	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 Gerekli	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. varsayılan değer: False
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

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

Name	Description
share_name Gerekli	str Mevcut paylaşımın adı.
directory_name Gerekli	str Dizinin yolu.
file_name Gerekli	str Mevcut dosyanın adı.
start_range Gerekli	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 Gerekli	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 Gerekli	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 Gerekli	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.
timeout	int Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None

Ö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