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
Name | Description |
---|---|
account_name
|
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
|
Depolama hesabı anahtarı. Bu, paylaşılan anahtar kimlik doğrulaması için kullanılır. varsayılan değer: None
|
sas_token
|
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
|
İstekler için kullanılacak protokol. Varsayılan olarak https kullanılır. varsayılan değer: https
|
endpoint_suffix
|
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
|
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
|
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
|
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
|
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
|
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
|
Hedef paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Hedef dosyanın adı. |
copy_id
Gerekli
|
Özgün copy_file işleminin copy.id sağlanan kopya tanımlayıcısı. |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
start_range
Gerekli
|
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
|
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
|
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
|
Mevcut paylaşımın adı. |
directory_name
|
Dizinin yolu. varsayılan değer: None
|
file_name
|
Mevcut dosyanın adı. varsayılan değer: None
|
recursive
|
İş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
|
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
|
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
|
Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None
|
timeout
|
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
|
Hedef paylaşımın adı. Paylaşım mevcut olmalıdır. |
directory_name
Gerekli
|
Hedef dizinin adı. Dizinin var olması gerekir. |
file_name
Gerekli
|
Hedef dosyanın adı. Hedef dosya varsa, üzerine yazılır. Aksi takdirde oluşturulur. |
copy_source
Gerekli
|
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
|
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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Üst dizinin yolu da dahil olmak üzere oluşturulacak dizinin adı. |
metadata
|
Paylaşımla meta veri olarak ilişkilendirilecek name_value çiftleri olan bir dikte. Örnek:{'Category':'test'} varsayılan değer: None
|
fail_on_exist
|
dizin mevcut olduğunda özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
|
file_permission
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Oluşturulacak veya güncelleştirilecek dosyanın adı. |
content_length
Gerekli
|
Dosyanın bayt cinsinden uzunluğu. |
content_settings
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
|
metadata
|
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
|
file_permission
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Oluşturulacak veya güncelleştirilecek dosyanın adı. |
file
Gerekli
|
Dosyanın bayt dizisi olarak içeriği. |
index
|
Bayt dizisindeki dizini başlatın. varsayılan değer: 0
|
count
|
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
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
|
metadata
|
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
|
validate_content
|
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
|
Kullanılacak en fazla paralel bağlantı sayısı. varsayılan değer: 2
|
file_permission
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Oluşturulacak veya güncelleştirilecek dosyanın adı. |
local_file_path
Gerekli
|
Dosya içeriği olarak karşıya yüklenecek yerel dosyanın yolu. |
content_settings
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
|
metadata
|
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
|
validate_content
|
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
|
Kullanılacak en fazla paralel bağlantı sayısı. varsayılan değer: 2
|
file_permission
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Oluşturulacak veya güncelleştirilecek dosyanın adı. |
stream
Gerekli
|
Dosya içeriği olarak karşıya yüklenecek dosya/akış açıldı. |
count
Gerekli
|
Akıştan okunacak bayt sayısı. Bu gereklidir, sayı bilinmiyorsa dosya oluşturulamaz. |
content_settings
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
|
metadata
|
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
|
validate_content
|
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
|
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
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Oluşturulacak veya güncelleştirilecek dosyanın adı. |
text
Gerekli
|
Dosyaya yüklenecek metin. |
encoding
|
Metni baytlara dönüştürmek için kullanılacak Python kodlaması. varsayılan değer: utf-8
|
content_settings
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. varsayılan değer: None
|
metadata
|
Dosyayla meta veri olarak ilişkili ad-değer çiftleri. varsayılan değer: None
|
validate_content
|
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
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Oluşturulacak paylaşımın adı. |
metadata
|
Paylaşımı meta veri olarak ilişkilendirmek için name_value çiftleri olan bir dikte. Örnek:{'Category':'test'} varsayılan değer: None
|
quota
|
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
|
Paylaşım mevcut olduğunda özel durum oluşturup oluşturmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
|
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Üst dizinin yolu da dahil olmak üzere silinecek dizinin adı. |
fail_not_exist
|
Dizin mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin. varsayılan değer: False
|
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
timeout
|
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
|
Silinecek paylaşımın adı. |
fail_not_exist
|
Paylaşım mevcut olmadığında özel durum oluşturulup oluşturulmayacağını belirtin. Varsayılan olarak false. varsayılan değer: False
|
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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
|
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 |
---|---|
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
|
Paylaşımın adı. |
directory_name
|
Bir dizinin yolu. varsayılan değer: None
|
file_name
|
Dosyanın adı. varsayılan değer: None
|
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
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
|
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
|
İ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
|
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 |
---|---|
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
|
Paylaşımın adı. |
directory_name
|
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
|
Dosyanın adı. varsayılan değer: None
|
permission
|
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
|
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
|
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
|
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
|
İ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
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
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
|
Paylaşımın adı. |
permission
|
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
|
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
|
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
|
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
|
İ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
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Var olan bir dizinin yolu. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
ö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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
start_range
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
Ö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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
file_path
Gerekli
|
Yazacak dosyanın yolu. |
open_mode
|
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
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
Ö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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Varolan dosyanın adı. |
stream
Gerekli
|
Yazacak dosya/akış açıldı. |
start_range
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
Ö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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Varolan dosyanın adı. |
encoding
|
Dosya verilerinin kodunu çözerken kullanılacak Python kodlaması. varsayılan değer: utf-8
|
start_range
|
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
|
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
|
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
|
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
|
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
|
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 |
---|---|
Ö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
|
Mevcut paylaşımın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
Ö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
|
Mevcut paylaşımın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
timeout
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
|
Dizinin yolu. varsayılan değer: None
|
num_results
|
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
|
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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
prefix
|
Yalnızca belirtilen ön eke sahip dosyaları ve/veya dizinleri listeleyin. varsayılan değer: None
|
snapshot
|
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
|
Mevcut paylaşımın adı. |
directory_name
|
Dizinin yolu. varsayılan değer: None
|
file_name
|
Mevcut dosyanın adı. varsayılan değer: None
|
recursive
|
İş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
|
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
|
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
|
Varsa anlık görüntü sürümünü temsil eden bir dize. varsayılan değer: None
|
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
start_range
|
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
|
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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
snapshot
|
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 |
---|---|
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
|
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
|
Döndürülecek en fazla paylaşım sayısını belirtir. varsayılan değer: None
|
include_metadata
|
Yanıtta paylaşım meta verilerinin döndürüldüğünü belirtir. varsayılan değer: False
|
marker
|
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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
include_snapshots
|
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
|
Paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Dosyanın adı. |
protocol
|
Kullanılacak protokol: 'http' veya 'https'. Belirtilmezse, FileService başlatıldığında belirtilen protokolü kullanır. varsayılan değer: None
|
sas_token
|
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 |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
content_length
Gerekli
|
Dosyanın yeniden boyutlandırılası uzunluk. |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
metadata
|
Dizinle meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'} varsayılan değer: None
|
timeout
|
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
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
metadata
|
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
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
content_settings
Gerekli
|
Dosya özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. |
file_permission
|
Dosya izni, taşınabilir bir SDDL varsayılan değer: None
|
smb_properties
|
SMB ile ilgili dosya özelliklerini ayarlar |
timeout
|
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
|
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
|
Ara sunucu adresi. Örneğin: '192.168.0.100' |
port
Gerekli
|
Ara sunucu bağlantı noktası. Örn: 6000 |
user
|
Proxy yetkilendirmesi için kullanıcı. varsayılan değer: None
|
password
|
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
|
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
|
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
|
Mevcut paylaşımın adı. |
metadata
|
Paylaşımla meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'} varsayılan değer: None
|
timeout
|
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
|
Mevcut paylaşımın adı. |
quota
Gerekli
|
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
|
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
|
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
|
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
|
Zaman aşımı parametresi saniye cinsinden ifade edilir. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
data
Gerekli
|
Aralığın içeriği. |
start_range
Gerekli
|
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
|
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
|
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
|
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
|
Mevcut paylaşımın adı. |
directory_name
Gerekli
|
Dizinin yolu. |
file_name
Gerekli
|
Mevcut dosyanın adı. |
start_range
Gerekli
|
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
|
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
|
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
|
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
|
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
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