BaseBlobService Sınıf
Bu, Blob kaynaklarını yöneten ana sınıftır.
Blob hizmeti, metin ve ikili verileri bulutta blob olarak depolar. Blob hizmeti şu üç kaynağı sunar: depolama hesabı, kapsayıcılar ve bloblar. Depolama hesabınızda kapsayıcılar blob kümelerini düzenlemek için bir yol sağlar. Daha fazla bilgi için lütfen bkz: https://msdn.microsoft.com/en-us/library/azure/ee691964.aspx
:type ~azure.storage.common.TokenCredential
- Devralma
-
BaseBlobService
Oluşturucu
BaseBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)Parametreler
- account_name
- str
Depolama hesabı adı. Bu, bir hesap anahtarıyla imzalanan isteklerin kimliğini doğrulamak ve depolama uç noktasını oluşturmak için kullanılır. Bir bağlantı dizesi verilmediği veya anonim kimlik doğrulaması ile özel bir etki alanı kullanılmadığı sürece gereklidir.
- account_key
- str
Depolama hesabı anahtarı. Bu, paylaşılan anahtar kimlik doğrulaması için kullanılır. Hesap anahtarı veya sas belirteci belirtilmezse anonim erişim kullanılır.
- sas_token
- str
Hesap anahtarı yerine isteklerin kimliğini doğrulamak için kullanılacak paylaşılan erişim imzası belirteci. Hesap anahtarı ve sas belirteci belirtilirse, imzalamak için hesap anahtarı kullanılır. Hiçbiri belirtilmezse anonim erişim kullanılır.
- is_emulated
- bool
Öykünücünün kullanılıp kullanılmaydığı. Varsayılan değer False'tur. Belirtilirse, bağlantı dizesi ve istek oturumu dışındaki tüm parametreleri geçersiz kılar.
- protocol
- str
İstekler için kullanılacak protokol. Varsayılan olarak https kullanılır.
- endpoint_suffix
- str
Url'nin ana bilgisayar temel bileşeni, hesap adı çıkar. Varsayılan olarak Azure (core.windows.net). Çin bulutunu (core.chinacloudapi.cn) kullanmak için bunu geçersiz kılın.
- custom_domain
- str
Kullanılacak özel etki alanı. Bu, Azure Portal'da ayarlanabilir. Örneğin, 'www.mydomain.com'.
- request_session
- <xref:requests.Session>
Http istekleri için kullanılacak oturum nesnesi.
- connection_string
- str
Belirtilirse, istek oturumu dışındaki tüm parametreleri geçersiz kılar. bağlantı dizesi biçimi için bkz.http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/
- socket_timeout
- int
Belirtilirse, bu varsayılan yuva zaman aşımını geçersiz kılar. Belirtilen zaman aşımı saniye cinsindendir. Varsayılan değer için bkz. _constants.py DEFAULT_SOCKET_TIMEOUT.
- token_credential
HTTPS isteklerinin kimliğini doğrulamak için kullanılan belirteç kimlik bilgisi. Belirteç değeri, süresi dolmadan önce güncelleştirilmelidir.
Değişkenler
- MAX_SINGLE_GET_SIZE
- int
max_connections 1'den büyükse, ilk aralığın boyutu get_blob_to_* yöntemleri tarafından gerçekleştirilir. Blob 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 blob MAX_SINGLE_GET_SIZE büyükse get_blob_to_* yöntemleri tarafından gerçekleştirilir. Blobun 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.
- key_encryption_key
- object
Anahtar-şifreleme anahtarı isteğe bağlı olarak kullanıcı tarafından sağlanır. Sağlanırsa, desteklenen yöntemlerde şifrelemek/şifresini çözmek için kullanılır. Şifre çözme gerektiren yöntemler için key_encryption_key VEYA çözümleyici sağlanmalıdır. Her ikisi de sağlanırsa, çözümleyici öncelikli olur. Şifreleme gerektiren API'ler için aşağıdaki yöntemleri uygulamalıdır: wrap_key(anahtar)–belirtilen anahtarı (bayt) kullanıcının seçtiği bir algoritma kullanarak sarmalar. Şifrelenmiş anahtarı bayt olarak döndürür. get_key_wrap_algorithm()–belirtilen simetrik anahtarı sarmalamada kullanılan algoritmayı döndürür. get_kid()–bu anahtar-şifreleme anahtarı için bir dize anahtarı kimliği döndürür. Şifre çözme gerektiren API'ler için aşağıdaki yöntemleri uygulamalıdır: unwrap_key(anahtar, algoritma)– belirtilen simetrik anahtarın çizilmemiş biçimini dize belirtilen algoritmayı kullanarak döndürür. get_kid()–bu anahtar-şifreleme anahtarı için bir dize anahtarı kimliği döndürür.
- key_resolver_function
- kid) (<xref:function>
Kullanıcı tarafından isteğe bağlı olarak sağlanan anahtarları çözümlemeye ilişkin bir işlev. Sağlanırsa, desteklenen yöntemlerde şifreyi çözmek için kullanılır. Şifre çözme gerektiren yöntemler için key_encryption_key VEYA çözümleyici sağlanmalıdır. Her ikisi de sağlanırsa, çözümleyici öncelikli olur. Yukarıda tanımlanan arabirimi uygulayan bir anahtar-şifreleme anahtarı döndürmek için çocuk dizesini kullanır.
- require_encryption
- bool
Tüm iletilerin kuyruğa başarıyla yüklendiğinden ve kuyruktan başarıyla indirilip okunanların sunucudayken şifrelenmesini/şifrelenmesini sağlamak için ayarlanabilen bir bayrak. Bu bayrak ayarlanırsa şifreleme/şifre çözme için gerekli tüm parametreler sağlanmalıdır. key_encryption_key ve çözümleyici ile ilgili yukarıdaki açıklamalara bakın.
Yöntemler
| abort_copy_blob |
Bekleyen bir copy_blob işlemini durdurur ve hedef blobu sıfır uzunlukta ve tam meta veriyle bırakır. |
| acquire_blob_lease |
Yeni kiralama isteğinde bulunur. Blob etkin bir kiraya sahip değilse, Blob hizmeti blob üzerinde bir kira oluşturur ve yeni bir kira kimliği döndürür. |
| acquire_container_lease |
Yeni kiralama isteğinde bulunur. Kapsayıcının etkin kiralaması yoksa, Blob hizmeti kapsayıcıda bir kira oluşturur ve yeni bir kira kimliği döndürür. |
| batch_delete_blobs |
Birden çok blob silme isteği toplu işlemi gönderir. Blob silme yöntemi belirtilen blobu veya anlık görüntüyü siler. Bir blobu sildiğinizde tüm anlık görüntülerinin de silindiğini unutmayın. Daha fazla bilgi için bkz. https://docs.microsoft.com/rest/api/storageservices/delete-blob. |
| break_blob_lease |
Blob etkin bir kiraya sahipse kirayı bozar. Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca blob üzerinde kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir. Bozulan bir kiralama da serbest bırakılabilir; bu durumda başka bir istemci blob üzerinde kirayı hemen alabilir. |
| break_container_lease |
Kapsayıcının etkin bir kirası varsa kirayı sonlandırın. Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca kapsayıcıda kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir. |
| change_blob_lease |
Etkin kiralamanın kira kimliğini değiştirir. Bir değişiklik geçerli kira kimliğini ve yeni bir kira kimliğini içermelidir. |
| change_container_lease |
Etkin kiralamanın kira kimliğini değiştirin. Bir değişiklik geçerli kira kimliğini ve yeni bir kira kimliğini içermelidir. |
| copy_blob |
Blobu 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. Blob hizmeti blobları en iyi çaba temelinde kopyalar. Kopyalama işleminin kaynak blobu blok blobu, ekleme blobu veya sayfa blobu olabilir. Hedef blob zaten varsa, kaynak blob ile aynı blob türünde olmalıdır. Mevcut tüm hedef blobların üzerine yazılır. Kopyalama işlemi devam ederken hedef blob değiştirilemez. Bir sayfa blobundan kopyalama yaparken, Blob hizmeti başlangıçta tüm sıfırları içeren kaynak blobun uzunluğunda bir hedef sayfa blobu oluşturur. Ardından kaynak sayfa aralıkları numaralandırılır ve boş olmayan aralıklar kopyalanır. Blok blobu veya ekleme blobu için Blob hizmeti, bu işlemden dönmeden önce sıfır uzunlukta kaydedilmiş bir blob oluşturur. Blok blobundan kopyalarken, işlenen tüm bloklar ve blok kimlikleri kopyalanır. Kaydedilmemiş bloklar kopyalanmaz. Kopyalama işleminin sonunda hedef blob, kaynakla aynı kaydedilmiş blok sayısına sahip olur. Ekleme blobundan kopyalarken, işlenen tüm bloklar kopyalanır. Kopyalama işleminin sonunda hedef blob, kaynakla aynı kaydedilmiş blok sayısına sahip olur. Tüm blob türleri için, kopyalama işleminin durumunu denetlemek için hedef blob üzerindeki get_blob_properties çağırabilirsiniz. Kopyalama tamamlandığında son blob işlenir. |
| create_container |
Belirtilen hesap altında yeni bir kapsayıcı oluşturur. Aynı ada sahip kapsayıcı zaten varsa, fail_on_exist True olduğunda işlem başarısız olur. |
| delete_blob |
Belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir. Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz. Hizmet için silme bekletme ilkesi etkinleştirilirse, bu işlem blobu veya anlık görüntüyü geçici olarak siler ve blobu veya anlık görüntüyü belirtilen gün sayısı boyunca korur. Belirtilen gün sayısından sonra, blobun verileri çöp toplama sırasında hizmetten kaldırılır. Geçici olarak silinen bloba veya anlık görüntüye include=Include.Deleted seçeneğini belirten Liste Blobları API'sini kullanarak erişilebilir. Geçici olarak silinen blob veya anlık görüntü Geri Yükleme API'si kullanılarak geri yüklenebilir. |
| delete_container |
Belirtilen kapsayıcıyı silinmek üzere işaretler. Kapsayıcı ve içindeki tüm bloblar daha sonra çöp toplama sırasında silinir. |
| exists |
Kapsayıcının var olup olmadığını belirten bir boole değeri (blob_name None ise) veya blob'un var olup olmadığını gösteren bir boole değeri döndürür. |
| extract_date_and_request_id | |
| generate_account_shared_access_signature |
Blob hizmeti için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın. |
| generate_blob_shared_access_signature |
Blob veya anlık görüntülerinden biri için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın. |
| generate_container_shared_access_signature |
Kapsayıcı için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın. |
| get_blob_account_information |
Depolama hesabıyla ilgili bilgileri alır. Bilgiler, kullanıcının bir kapsayıcı veya blob için SAS'sine sahip olması durumunda da alınabilir. |
| get_blob_metadata |
Belirtilen blob veya anlık görüntü için kullanıcı tanımlı tüm meta verileri döndürür. |
| get_blob_properties |
Blob için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Blobun içeriğini döndürmez. ve ile BlobProperties bir meta veri diktesi döndürürBlob. |
| get_blob_service_properties |
Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini alır. |
| get_blob_service_stats |
Blob hizmeti için çoğaltmayla ilgili istatistikleri alır. Yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde kullanılabilir. Coğrafi olarak yedekli çoğaltma ile Azure Depolama, verilerinizi iki konumda dayanıklı tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını korur. Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Klasik Azure portalı aracılığıyla hesap oluştururken seçtiğiniz bölgede (örneğin, Orta Kuzey ABD) bulunur. Verilerinizin çoğaltıldığı konum ikincil konumdur. İkincil konum, birincil konumuna göre otomatik olarak belirlenir; birincil konumla aynı bölgede bulunan ikinci bir veri merkezindedir. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir. |
| get_blob_to_bytes |
Otomatik öbekleme ve ilerleme bildirimleriyle bir bayt dizisi olarak bir blob indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini Blob döndürür. |
| get_blob_to_path |
Otomatik öbekleme ve ilerleme bildirimleriyle bir blobu dosya yoluna indirir. Özellikleri ve meta verileri olan bir örneğini Blob döndürür. |
| get_blob_to_stream |
Otomatik öbekleme ve ilerleme bildirimleriyle bir blobu akışa indirir. Özellikleri ve meta verileri olan bir örneğini Blob döndürür. |
| get_blob_to_text |
Blobu otomatik öbekleme ve ilerleme bildirimleriyle unicode metin olarak indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini Blob döndürür. |
| get_container_acl |
Belirtilen kapsayıcının izinlerini alır. İzinler, kapsayıcı verilerine genel olarak erişilip erişilemeyeceğini gösterir. |
| get_container_metadata |
Belirtilen kapsayıcı için kullanıcı tanımlı tüm meta verileri döndürür. |
| get_container_properties |
Belirtilen kapsayıcı için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler kapsayıcının blob listesini içermez. |
| get_user_delegation_key |
SAS belirteçlerini imzalama amacıyla bir kullanıcı temsilcisi anahtarı alın. Bu isteğin başarılı olması için hizmet nesnesinde bir belirteç kimlik bilgisi bulunmalıdır. |
| list_blob_names |
Belirtilen kapsayıcının altındaki blob adlarını listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini yavaş bir şekilde izler ve tüm bloblar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve hesapta bu sayıdan daha fazla blob varsa, oluşturucu tamamlandığında doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
| list_blobs |
Belirtilen kapsayıcının altındaki blobları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini yavaş bir şekilde izler ve tüm bloblar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve hesapta bu sayıdan daha fazla blob varsa, oluşturucu tamamlandığında doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
| list_containers |
Belirtilen hesabın altındaki kapsayı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 gizlice izler ve tüm kapsayıcılar döndürdüğünde veya num_results ulaşıldığında durur. num_results belirtilirse ve hesap bu sayıdan daha fazla kapsayıcıya sahipse, oluşturucu tamamlandıktan sonra doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir. |
| make_blob_url |
Bloba erişmek için url'yi oluşturur. |
| make_container_url |
Kapsayıcıya erişmek için url'yi oluşturur. |
| release_blob_lease |
Kirayı serbest bırakır. İstekte belirtilen kira kimliği blobla ilişkiliyle eşleşiyorsa kira serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin blob için kirayı hemen almasını sağlar. |
| release_container_lease |
Kirayı serbest bırakın. lease_id belirtilen kapsayıcıyla ilişkili eşleşmeler varsa kiralama serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin kapsayıcının kirasını hemen almasını sağlar. |
| renew_blob_lease |
Kirayı yeniler. İstekte belirtilen kira kimliği blobla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın süresi dolduğundan bu yana blob değiştirilmediği veya yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır. |
| renew_container_lease |
Kirayı yeniler. Belirtilen kira kimliği kapsayıcıyla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın sona erme tarihinden sonra kapsayıcı yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır. |
| set_blob_metadata |
Belirtilen blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. |
| set_blob_properties |
Blob üzerindeki sistem özelliklerini ayarlar. content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır. |
| set_blob_service_properties |
Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini ayarlar. Bir öğe (örn. Günlük) Yok olarak bırakılırsa, hizmette söz konusu işlevselliğin mevcut ayarları korunur. |
| set_container_acl |
Paylaşılan Erişim İmzaları ile kullanılabilecek belirtilen kapsayıcı veya depolanmış erişim ilkeleri için izinleri ayarlar. İzinler, bir kapsayıcıdaki bloblara genel olarak erişilip erişilemeyeceğini gösterir. |
| set_container_metadata |
Belirtilen kapsayıcı için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, kapsayıcıya eklenen tüm mevcut meta verilerin yerini alır. Kapsayıcıdan tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın. |
| set_proxy |
HTTP CONNECT Tüneli için ara sunucu ana bilgisayarını ve bağlantı noktasını ayarlar. |
| snapshot_blob |
Blobun salt okunur anlık görüntüsünü oluşturur. |
| undelete_blob |
Silinmemiş Blob işlemi, geçici olarak silinen blobun veya anlık görüntünün içeriğini ve meta verilerini geri yükler. Geçici olarak silinmeyen bir blob veya anlık görüntünün silinmesini kaldırma girişimi herhangi bir değişiklik yapılmadan başarılı olur. |
abort_copy_blob
Bekleyen bir copy_blob işlemini durdurur ve hedef blobu sıfır uzunlukta ve tam meta veriyle bırakır.
abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)Parametreler
acquire_blob_lease
Yeni kiralama isteğinde bulunur. Blob etkin bir kiraya sahip değilse, Blob hizmeti blob üzerinde bir kira oluşturur ve yeni bir kira kimliği döndürür.
acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- lease_duration
- int
Süresi hiç dolmamış bir kiralama için kiranın süresini saniye cinsinden veya negatif bir (-1) olarak belirtir. Sonsuz olmayan kiralama 15 ile 60 saniye arasında olabilir. Kiralama süresi yenileme veya değiştirme kullanılarak değiştirilemez. Varsayılan değer -1'dir (sonsuz kiralama).
- proposed_lease_id
- str
GUID dize biçiminde önerilen kira kimliği. Önerilen kira kimliği doğru biçimde değilse Blob hizmeti 400 (Geçersiz istek) döndürür.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Döndürülenler
Str
acquire_container_lease
Yeni kiralama isteğinde bulunur. Kapsayıcının etkin kiralaması yoksa, Blob hizmeti kapsayıcıda bir kira oluşturur ve yeni bir kira kimliği döndürür.
acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- lease_duration
- int
Süresi hiç dolmamış bir kiralama için kiranın süresini saniye cinsinden veya negatif bir (-1) olarak belirtir. Sonsuz olmayan kiralama 15 ile 60 saniye arasında olabilir. Kiralama süresi yenileme veya değiştirme kullanılarak değiştirilemez. Varsayılan değer -1'dir (sonsuz kiralama).
- proposed_lease_id
- str
GUID dize biçiminde önerilen kira kimliği. Önerilen kira kimliği doğru biçimde değilse Blob hizmeti 400 (Geçersiz istek) döndürür.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
Döndürülenler
Str
batch_delete_blobs
Birden çok blob silme isteği toplu işlemi gönderir.
Blob silme yöntemi belirtilen blobu veya anlık görüntüyü siler. Bir blobu sildiğinizde tüm anlık görüntülerinin de silindiğini unutmayın. Daha fazla bilgi için bkz. https://docs.microsoft.com/rest/api/storageservices/delete-blob.
batch_delete_blobs(batch_delete_sub_requests, timeout=None)Parametreler
- batch_delete_sub_requests
- list(BatchDeleteSubRequest)
Blob, toplu olarak gönderme isteklerini siler.
Döndürülenler
ayrıştırılmış toplu silme HTTP yanıtı
Dönüş türü
break_blob_lease
Blob etkin bir kiraya sahipse kirayı bozar. Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca blob üzerinde kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir.
Bozulan bir kiralama da serbest bırakılabilir; bu durumda başka bir istemci blob üzerinde kirayı hemen alabilir.
break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- lease_break_period
- int
Kesme işlemi için bu, kiranın bozulmadan önce 0 ile 60 saniye arasında devam etmesi için önerilen saniye süresidir. Bu kesme dönemi yalnızca kirada kalan süreden kısaysa kullanılır. Daha uzunsa, kirada kalan süre kullanılır. Kesme süresi dolmadan önce yeni bir kira kullanılamaz, ancak kiralama kesme döneminden daha uzun süre tutulabilir. Bu üst bilgi bir kesme işlemiyle birlikte görünmüyorsa, kalan kiralama dönemi geçtikten sonra sabit süreli kiralama bozulur ve sonsuz kiralama hemen sona erer.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Döndürülenler
int
break_container_lease
Kapsayıcının etkin bir kirası varsa kirayı sonlandırın. Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca kapsayıcıda kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir.
break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- lease_break_period
- int
Bu, kiranın bozulmadan önce 0 ile 60 saniye arasında devam etmesi için önerilen saniye süresidir. Bu kesme dönemi yalnızca kirada kalan süreden kısaysa kullanılır. Daha uzunsa, kirada kalan süre kullanılır. Kesme süresi dolmadan önce yeni bir kira kullanılamaz, ancak kiralama kesme döneminden daha uzun süre tutulabilir. Bu üst bilgi bir kesme işlemiyle birlikte görünmüyorsa, kalan kiralama dönemi geçtikten sonra sabit süreli kiralama bozulur ve sonsuz kiralama hemen sona erer.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
Döndürülenler
int
change_blob_lease
Etkin kiralamanın kira kimliğini değiştirir. Bir değişiklik geçerli kira kimliğini ve yeni bir kira kimliğini içermelidir.
change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- proposed_lease_id
- str
GUID dize biçiminde önerilen kira kimliği. Önerilen kira kimliği doğru biçimde değilse Blob hizmeti 400 (Geçersiz istek) döndürür.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
change_container_lease
Etkin kiralamanın kira kimliğini değiştirin. Bir değişiklik geçerli kira kimliğini ve yeni bir kira kimliğini içermelidir.
change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- proposed_lease_id
- str
GUID dize biçiminde önerilen kira kimliği. Önerilen kira kimliği doğru biçimde değilse Blob hizmeti 400 (Geçersiz istek) döndürür.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
copy_blob
Blobu 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. Blob hizmeti blobları en iyi çaba temelinde kopyalar.
Kopyalama işleminin kaynak blobu blok blobu, ekleme blobu veya sayfa blobu olabilir. Hedef blob zaten varsa, kaynak blob ile aynı blob türünde olmalıdır. Mevcut tüm hedef blobların üzerine yazılır. Kopyalama işlemi devam ederken hedef blob değiştirilemez.
Bir sayfa blobundan kopyalama yaparken, Blob hizmeti başlangıçta tüm sıfırları içeren kaynak blobun uzunluğunda bir hedef sayfa blobu oluşturur. Ardından kaynak sayfa aralıkları numaralandırılır ve boş olmayan aralıklar kopyalanır.
Blok blobu veya ekleme blobu için Blob hizmeti, bu işlemden dönmeden önce sıfır uzunlukta kaydedilmiş bir blob oluşturur. Blok blobundan kopyalarken, işlenen tüm bloklar ve blok kimlikleri kopyalanır. Kaydedilmemiş bloklar kopyalanmaz. Kopyalama işleminin sonunda hedef blob, kaynakla aynı kaydedilmiş blok sayısına sahip olur.
Ekleme blobundan kopyalarken, işlenen tüm bloklar kopyalanır. Kopyalama işleminin sonunda hedef blob, kaynakla aynı kaydedilmiş blok sayısına sahip olur.
Tüm blob türleri için, kopyalama işleminin durumunu denetlemek için hedef blob üzerindeki get_blob_properties çağırabilirsiniz. Kopyalama tamamlandığında son blob işlenir.
copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None)Parametreler
- blob_name
- str
Hedef blobun adı. Hedef blob varsa üzerine yazılır. Aksi takdirde oluşturulur.
- copy_source
- str
Azure dosyasını veya blobu belirten en fazla 2 KB uzunluğunda bir URL. Değer, istek URI'sinde göründüğü gibi URL ile kodlanmış olmalıdır. Kaynak başka bir hesaptaysa, kaynağın ortak olması veya paylaşılan erişim imzası aracılığıyla kimlik doğrulamasından geçirilmesi gerekir. Kaynak genel ise kimlik doğrulaması gerekmez. Örnekler: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
Blob ile meta veri olarak ilişkili ad-değer çiftleri. Hiçbir ad-değer çifti belirtilmezse, işlem meta verileri kaynak blobdan veya dosyadan hedef bloba kopyalar. Bir veya daha fazla ad-değer çifti belirtilirse, hedef blob belirtilen meta verilerle oluşturulur ve meta veriler kaynak blobdan veya dosyadan kopyalanmaz.
- source_if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Blobu kopyalamak için bu koşullu üst bilgiyi belirtin; yalnızca kaynak blob belirtilen tarih/saatten sonra değiştirilmişse.
- source_if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Blobu kopyalamak için bu koşullu üst bilgiyi yalnızca kaynak blob belirtilen tarih/saatten sonra değiştirilmediyse belirtin.
- source_if_match
- <xref:ETag>
ETag değeri veya joker karakter (*). Kaynak blobu kopyalamak için yalnızca ETag değeri belirtilen değerle eşleşiyorsa bu koşullu üst bilgiyi belirtin. ETag değerleri eşleşmiyorsa Blob hizmeti 412 (Önkoşul Başarısız) durum kodunu döndürür. Kaynak bir Azure Dosyası ise bu üst bilgi belirtilemez.
- source_if_none_match
- <xref:ETag>
ETag değeri veya joker karakter (*). Yalnızca ETag değeri belirtilen değerle eşleşmiyorsa blobu kopyalamak için bu koşullu üst bilgiyi belirtin. Değerler aynıysa Blob hizmeti 412 (Önkoşul Başarısız) durum kodunu döndürür. Kaynak bir Azure Dosyası ise bu üst bilgi belirtilemez.
- destination_if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Blobu kopyalamak için bu koşullu üst bilgiyi belirtin; yalnızca hedef blob belirtilen tarih/saatten sonra değiştirilmişse. Hedef blob değiştirilmediyse Blob hizmeti 412 (Önkoşul Başarısız) durum kodunu döndürür.
- destination_if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Blobu kopyalamak için bu koşullu üst bilgiyi belirtin; yalnızca hedef blob belirtilen tarih/saatten sonra değiştirilmediyse. Hedef blob değiştirildiyse Blob hizmeti 412 (Önkoşul Başarısız) durum kodunu döndürür.
- destination_if_match
- <xref:ETag>
ETag değeri veya joker karakter (*). Blobu kopyalamak için bu koşullu üst bilgi için yalnızca belirtilen ETag değerinin mevcut bir hedef blob için ETag değeriyle eşleşmesi durumunda bir ETag değeri belirtin. Hedef blob için ETag, If-Match için belirtilen ETag ile eşleşmiyorsa Blob hizmeti 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
- destination_if_none_match
- <xref:ETag>
ETag değeri veya joker karakter (). Yalnızca belirtilen ETag değeri hedef blob için ETag değeriyle eşleşmiyorsa blobu kopyalamak için bu koşullu üst bilgi için bir ETag değeri belirtin. yalnızca hedef blob yoksa işlemi gerçekleştirmek için joker karakteri () belirtin. Belirtilen koşul karşılanmazsa Blob hizmeti 412 (Önkoşul Başarısız) durum kodunu döndürür.
- destination_lease_id
- str
Bu üst bilgi için belirtilen kira kimliği, hedef blobun kira kimliğiyle eşleşmelidir. İstek kira kimliğini içermiyorsa veya geçerli değilse, işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu).
- source_lease_id
- str
Blobu Kopyala işlemini gerçekleştirmek için bunu yalnızca verilen kira kimliği kaynak blobun etkin kira kimliğiyle eşleşiyorsa belirtin.
Döndürülenler
Durum, kaynak ve kimlik gibi işlem özelliklerini kopyalayın.
Dönüş türü
create_container
Belirtilen hesap altında yeni bir kapsayıcı oluşturur. Aynı ada sahip kapsayıcı zaten varsa, fail_on_exist True olduğunda işlem başarısız olur.
create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)Parametreler
- container_name
- str
Oluşturulacak kapsayıcının adı. Kapsayıcı adı yalnızca küçük harfler, sayılar ve kısa çizgiler içerebilir ve bir harf veya sayı ile başlamalıdır. Her kısa çizginin önünde ve arkasında kısa çizgi dışında bir karakter bulunmalıdır. Ad da 3 ile 63 karakter uzunluğunda olmalıdır.
Kapsayıcıyla meta veri olarak ilişkilendirilecek name_value çiftleri içeren bir dikte. Örnek:{'Category':'test'}
- fail_on_exist
- bool
Kapsayıcı mevcut olduğunda özel durum oluşturup oluşturmayacağını belirtin.
Döndürülenler
Kapsayıcı oluşturulduysa True, kapsayıcı zaten varsa False.
Dönüş türü
delete_blob
Belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir.
Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz.
Hizmet için silme bekletme ilkesi etkinleştirilirse, bu işlem blobu veya anlık görüntüyü geçici olarak siler ve blobu veya anlık görüntüyü belirtilen gün sayısı boyunca korur. Belirtilen gün sayısından sonra, blobun verileri çöp toplama sırasında hizmetten kaldırılır. Geçici olarak silinen bloba veya anlık görüntüye include=Include.Deleted seçeneğini belirten Liste Blobları API'sini kullanarak erişilebilir. Geçici olarak silinen blob veya anlık görüntü Geri Yükleme API'si kullanılarak geri yüklenebilir.
delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- snapshot
- str
snapshot parametresi, mevcut olduğunda silinecek blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- delete_snapshots
- DeleteSnapshot
Blobda ilişkili anlık görüntüler varsa gereklidir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
delete_container
Belirtilen kapsayıcıyı silinmek üzere işaretler. Kapsayıcı ve içindeki tüm bloblar daha sonra çöp toplama sırasında silinir.
delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- fail_not_exist
- bool
Kapsayıcı mevcut olmadığında özel durum oluşturup oluşturmayacağını belirtin.
- lease_id
- str
Belirtilirse, delete_container yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşirse başarılı olur. Kapsayıcının etkin bir kirası varsa gereklidir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
Döndürülenler
Kapsayıcı silinirse True, False kapsayıcısı yoktur.
Dönüş türü
exists
Kapsayıcının var olup olmadığını belirten bir boole değeri (blob_name None ise) veya blob'un var olup olmadığını gösteren bir boole değeri döndürür.
exists(container_name, blob_name=None, snapshot=None, timeout=None)Parametreler
- snapshot
- str
snapshot parametresi, mevcut olduğunda anlık görüntüyü belirten opak bir DateTime değeridir.
Döndürülenler
Kaynağın var olup olmadığını gösteren boole değeri.
Dönüş türü
extract_date_and_request_id
static extract_date_and_request_id(retry_context)Parametreler
- retry_context
generate_account_shared_access_signature
Blob hizmeti için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)Parametreler
- resource_types
- <xref:ResourceTypes>
Hesap SAS'siyle erişilebilen kaynak türlerini belirtir.
- permission
- <xref:AccountPermissions>
Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı, izinler tarafından izin verilen işlemlerle sınırlıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz hale geldiği saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- ip
- str
İsteklerin kabul etmek için bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https,http'dir. Olası değerler için bkz Protocol . .
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
generate_blob_shared_access_signature
Blob veya anlık görüntülerinden biri için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın.
generate_blob_shared_access_signature(container_name, blob_name, snapshot=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, user_delegation_key=None)Parametreler
- snapshot
- str
snapshot parametresi, mevcut olduğunda izin vermek için blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- permission
- BlobPermissions
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, yazma, silme, listeleme sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz hale geldiği saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- id
- str
Depolanan 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_container_acl.
- ip
- str
İsteklerin kabul etmek için bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https,http'dir. Olası değerler için bkz Protocol . .
- cache_control
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.
- content_disposition
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Disposition için yanıt üst bilgisi değeri.
- content_encoding
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.
- content_language
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.
- content_type
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Type için yanıt üst bilgisi değeri.
- user_delegation_key
- UserDelegationKey
Kullanıcı, hesap anahtarı yerine bir kullanıcı temsilcisi anahtarı geçirebilir. AAD kimliğiyle kimlik doğrulaması yaparak hizmetten kullanıcı temsilcisi anahtarı alınabilir; bu, get_user_delegation_key çağrılarak gerçekleştirilebilir. Mevcut olduğunda, SAS bunun yerine kullanıcı temsilcisi anahtarıyla imzalanır.
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
generate_container_shared_access_signature
Kapsayıcı için paylaşılan erişim imzası oluşturur. Döndürülen imzayı herhangi bir BlobService'in sas_token parametresiyle kullanın.
generate_container_shared_access_signature(container_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, user_delegation_key=None)Parametreler
- permission
- ContainerPermissions
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, yazma, silme, listeleme sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.
Paylaşılan erişim imzasının geçersiz hale geldiği saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.
- id
- str
Depolanan erişim ilkesiyle bağıntılı 64 karakter uzunluğunda benzersiz bir değer. Depolanan erişim ilkesi oluşturmak için set_blob_service_properties kullanın.
- ip
- str
İsteklerin kabul etmek için bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin SAS üzerinde sip=168.1.5.65 veya sip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.
- protocol
- str
Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https,http'dir. Olası değerler için bkz Protocol . .
- cache_control
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.
- content_disposition
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Disposition için yanıt üst bilgisi değeri.
- content_encoding
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.
- content_language
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.
- content_type
- str
Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Type için yanıt üst bilgisi değeri.
- user_delegation_key
- UserDelegationKey
Kullanıcı, hesap anahtarı yerine bir kullanıcı temsilcisi anahtarı geçirebilir. AAD kimliğiyle kimlik doğrulaması yaparak hizmetten kullanıcı temsilcisi anahtarı alınabilir; bu, get_user_delegation_key çağrılarak gerçekleştirilebilir. Mevcut olduğunda, SAS bunun yerine kullanıcı temsilcisi anahtarıyla imzalanır.
Döndürülenler
Paylaşılan Erişim İmzası (sas) belirteci.
Dönüş türü
get_blob_account_information
Depolama hesabıyla ilgili bilgileri alır. Bilgiler, kullanıcının bir kapsayıcı veya blob için SAS'sine sahip olması durumunda da alınabilir.
get_blob_account_information(container_name=None, blob_name=None, timeout=None)Parametreler
- container_name
- str
Mevcut kapsayıcının adı. İsteğe bağlı olarak, belirli bir kapsayıcı veya blob için SAS belirteci kullanmadığınız sürece (bu durumda gereklidir).
- blob_name
- str
Mevcut blobun adı. İsteğe bağlı olarak, belirli bir blob için SAS belirteci kullanmadığınız sürece bu durum gereklidir.
Döndürülenler
get_blob_metadata
Belirtilen blob veya anlık görüntü için kullanıcı tanımlı tüm meta verileri döndürür.
get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- snapshot
- str
snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir değerdir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
Döndürülenler
Blob meta veri adını ve değer çiftlerini temsil eden bir sözlük.
Dönüş türü
get_blob_properties
Blob için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Blobun içeriğini döndürmez. ve ile BlobProperties bir meta veri diktesi döndürürBlob.
get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- snapshot
- str
Snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
Döndürülenler
özellikleri ve meta verileri içeren bir blob nesnesi.
Dönüş türü
get_blob_service_properties
Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini alır.
get_blob_service_properties(timeout=None)Parametreler
Döndürülenler
Ekli target_version özelliğine sahip blob ServiceProperties .
get_blob_service_stats
Blob hizmeti için çoğaltmayla ilgili istatistikleri alır. Yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde kullanılabilir.
Coğrafi olarak yedekli çoğaltma ile Azure Depolama, verilerinizi iki konumda dayanıklı tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını korur. Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Klasik Azure portalı aracılığıyla hesap oluştururken seçtiğiniz bölgede (örneğin, Orta Kuzey ABD) bulunur. Verilerinizin çoğaltıldığı konum ikincil konumdur. İkincil konum, birincil konumuna göre otomatik olarak belirlenir; birincil konumla aynı bölgede bulunan ikinci bir veri merkezindedir. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir.
get_blob_service_stats(timeout=None)Parametreler
Döndürülenler
Blob hizmeti istatistikleri.
Dönüş türü
get_blob_to_bytes
Otomatik öbekleme ve ilerleme bildirimleriyle bir bayt dizisi olarak bir blob indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini Blob döndürür.
get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- snapshot
- str
Snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- start_range
- int
Blobun 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 blobu indirir.
- end_range
- int
Blobun 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 blobu indirir.
- validate_content
- bool
true olarak ayarlanırsa blobun alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa blobun boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Blobun baytlarını MAX_SINGLE_GET_SIZE. Bu blob'un 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. Max_connections 1'den büyükse boş bloblar için ek istek gerektiğinden birçok blob'un boş olması bekleniyorsa da bu yararlı olabilir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikleri ve meta verileri olan bir Blob. max_connections 1'den büyükse content_md5 (blobda ayarlandıysa) döndürülmeyecek. Bu değere ihtiyacınız varsa get_blob_properties kullanın veya max_connections 1 olarak ayarlayın.
Dönüş türü
get_blob_to_path
Otomatik öbekleme ve ilerleme bildirimleriyle bir blobu dosya yoluna indirir. Özellikleri ve meta verileri olan bir örneğini Blob döndürür.
get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- open_mode
- str
Dosyayı açarken kullanılacak mod. Yalnızca ekleme open_mode belirtilmesinin paralel indirmeyi engellediğini unutmayın. Bu nedenle, bu open_mode kullanılıyorsa max_connections 1 olarak ayarlanmalıdır.
- snapshot
- str
Snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- start_range
- int
Blobun 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 blobu indirir.
- end_range
- int
Blobun 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 blobu indirir.
- validate_content
- bool
true olarak ayarlanırsa blobun alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa blobun boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Blobun baytlarını MAX_SINGLE_GET_SIZE. Bu blob'un 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. Max_connections 1'den büyükse boş bloblar için ek istek gerektiğinden birçok blob'un boş olması bekleniyorsa da bu yararlı olabilir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikleri ve meta verileri olan bir Blob. max_connections 1'den büyükse content_md5 (blobda ayarlandıysa) döndürülmeyecek. Bu değere ihtiyacınız varsa get_blob_properties kullanın veya max_connections 1 olarak ayarlayın.
Dönüş türü
get_blob_to_stream
Otomatik öbekleme ve ilerleme bildirimleriyle bir blobu akışa indirir. Özellikleri ve meta verileri olan bir örneğini Blob döndürür.
get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- snapshot
- str
Snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- start_range
- int
Blobun 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 blobu indirir.
- end_range
- int
Blobun 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 blobu indirir.
- validate_content
- bool
true olarak ayarlanırsa blobun alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa blobun boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Blobun baytlarını MAX_SINGLE_GET_SIZE. Bu blob'un 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. Max_connections 1'den büyükse boş bloblar için ek istek gerektiğinden birçok blob'un boş olması bekleniyorsa da bu yararlı olabilir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikleri ve meta verileri olan bir Blob. max_connections 1'den büyükse content_md5 (blobda ayarlandıysa) döndürülmeyecek. Bu değere ihtiyacınız varsa get_blob_properties kullanın veya max_connections 1 olarak ayarlayın.
Dönüş türü
get_blob_to_text
Blobu otomatik öbekleme ve ilerleme bildirimleriyle unicode metin olarak indirir. Özellikleri, meta verileri ve içeriği olan bir örneğini Blob döndürür.
get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- encoding
- str
Blob verilerinin kodunu çözerken kullanılacak Python kodlaması.
- snapshot
- str
Snapshot parametresi, mevcut olduğunda alınacak blob anlık görüntüsünü belirten opak bir DateTime değeridir.
- start_range
- int
Blobun 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 blobu indirir.
- end_range
- int
Blobun 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 blobu indirir.
- validate_content
- bool
true olarak ayarlanırsa blobun alınan her bölümü için bir MD5 karması doğrular. Https (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Hizmetin yalnızca 4 MB veya daha küçük öbekler için işlem MD5'leri döndüreceğini, dolayısıyla ilk alma isteğinin kendi boyutunda olacağını unutmayın. Kendi yerine MAX_CHUNK_GET_SIZE. MAX_SINGLE_GET_SIZE. Eğer kendi kendine. MAX_CHUNK_GET_SIZE 4 MB'tan büyük olarak ayarlanmışsa hata oluşur. MD5 hesaplama işlemi zaman aldığından ve öbek boyutunun azalması nedeniyle daha fazla isteğin gerçeklenmesi gerektiğinden gecikme süresinde bir miktar artış olabilir.
- progress_callback
- <xref:func>(<xref:current>, <xref:total>)
İmza işlevi (geçerli, toplam) ile ilerleme için geri çağırma; burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam ise biliniyorsa blobun boyutudur.
- max_connections
- int
2 veya daha büyük olarak ayarlanırsa ilk alma işlemi ilk kendisi için yapılır. Blobun baytlarını MAX_SINGLE_GET_SIZE. Bu blob'un 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. Max_connections 1'den büyükse boş bloblar için ek istek gerektiğinden birçok blob'un boş olması bekleniyorsa da bu yararlı olabilir.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verilerin şifresini verilen anahtarla çözer. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
- timeout
- int
Zaman aşımı parametresi saniye cinsinden ifade edilir. Bu yöntem Azure hizmetine birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.
Döndürülenler
Özellikleri ve meta verileri olan bir Blob. max_connections 1'den büyükse content_md5 (blobda ayarlandıysa) döndürülmeyecek. Bu değere ihtiyacınız varsa get_blob_properties kullanın veya max_connections 1 olarak ayarlayın.
Dönüş türü
get_container_acl
Belirtilen kapsayıcının izinlerini alır. İzinler, kapsayıcı verilerine genel olarak erişilip erişilemeyeceğini gösterir.
get_container_acl(container_name, lease_id=None, timeout=None)Parametreler
- lease_id
Belirtilirse, get_container_acl yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur.
Döndürülenler
Kapsayıcıyla ilişkili erişim ilkeleri sözlüğü. genel erişim açıksa str to AccessPolicy ve public_access özelliğinin diktesi
get_container_metadata
Belirtilen kapsayıcı için kullanıcı tanımlı tüm meta verileri döndürür.
get_container_metadata(container_name, lease_id=None, timeout=None)Parametreler
- lease_id
- str
Belirtilirse, get_container_metadata yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur.
Döndürülenler
Kapsayıcı meta veri adını, değer çiftlerini temsil eden bir sözlük.
Dönüş türü
get_container_properties
Belirtilen kapsayıcı için tüm kullanıcı tanımlı meta verileri ve sistem özelliklerini döndürür. Döndürülen veriler kapsayıcının blob listesini içermez.
get_container_properties(container_name, lease_id=None, timeout=None)Parametreler
- lease_id
- str
Belirtilirse, get_container_properties yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur.
Döndürülenler
bir kapsayıcı nesnesi içinde belirtilen kapsayıcının özellikleri.
Dönüş türü
get_user_delegation_key
SAS belirteçlerini imzalama amacıyla bir kullanıcı temsilcisi anahtarı alın. Bu isteğin başarılı olması için hizmet nesnesinde bir belirteç kimlik bilgisi bulunmalıdır.
get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)Parametreler
- key_expiry_time
- datetime
Bir DateTime değeri. Anahtarın geçerli olmayı ne zaman durdurdığını gösterir.
Döndürülenler
Kullanıcı temsilcisi anahtarı.
Dönüş türü
list_blob_names
Belirtilen kapsayıcının altındaki blob adlarını listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini yavaş bir şekilde izler ve tüm bloblar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve hesapta bu sayıdan daha fazla blob varsa, oluşturucu tamamlandığında doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametreler
- prefix
- str
Sonuçları yalnızca adları belirtilen ön ek ile başlayan blobları döndürecek şekilde filtreler.
- num_results
- int
Tüm <xref:azure.storage.blob.baseblobservice.BlobPrefix> öğeler dahil olmak üzere döndürülecek en fazla blob 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.
- include
- Include
Yanıta eklenecek bir veya daha fazla ek veri kümesini belirtir.
- delimiter
- str
İstek bu parametreyi içerdiğinde, işlem sonuç listesinde, adları sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan tüm bloblar için yer tutucu işlevi gören bir öğe döndürür BlobPrefix . Sınırlayıcı tek bir karakter veya dize olabilir.
- marker
- str
Donuk bir devamlılık belirteci. Bu değer, num_results belirtildiyse ve oluşturucu sonuçları listelemeyi tamamladıysa, önceki bir oluşturucu nesnesinin next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan sonuç döndürmeye başlar.
list_blobs
Belirtilen kapsayıcının altındaki blobları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini yavaş bir şekilde izler ve tüm bloblar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve hesapta bu sayıdan daha fazla blob varsa, oluşturucu tamamlandığında doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)Parametreler
- prefix
- str
Sonuçları yalnızca adları belirtilen ön ek ile başlayan blobları döndürecek şekilde filtreler.
- num_results
- int
Tüm <xref:azure.storage.blob.baseblobservice.BlobPrefix> öğeler dahil olmak üzere döndürülecek en fazla blob 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.
- include
- Include
Yanıta eklenecek bir veya daha fazla ek veri kümesini belirtir.
- delimiter
- str
İstek bu parametreyi içerdiğinde, işlem sonuç listesinde, adları sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan tüm bloblar için yer tutucu işlevi gören bir öğe döndürür BlobPrefix . Sınırlayıcı tek bir karakter veya dize olabilir.
- marker
- str
Donuk bir devamlılık belirteci. Bu değer, num_results belirtildiyse ve oluşturucu sonuçları listelemeyi tamamladıysa, önceki bir oluşturucu nesnesinin next_marker alanından alınabilir. Belirtilirse, bu oluşturucu önceki oluşturucunun durduğu noktadan sonuç döndürmeye başlar.
list_containers
Belirtilen hesabın altındaki kapsayı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 gizlice izler ve tüm kapsayıcılar döndürdüğünde veya num_results ulaşıldığında durur.
num_results belirtilirse ve hesap bu sayıdan daha fazla kapsayıcıya sahipse, oluşturucu tamamlandıktan sonra doldurulan bir next_marker alanına sahip olur. Bu işaretçi, daha fazla sonuç isteniyorsa yeni bir oluşturucu oluşturmak için kullanılabilir.
list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)Parametreler
- prefix
- str
Sonuçları yalnızca adları belirtilen ön ek ile başlayan kapsayıcıları döndürecek şekilde filtreler.
- num_results
- int
Döndürülecek kapsayıcı sayısı üst sınırını belirtir. Tek bir liste isteği en fazla 1000 oluşturucu ve potansiyel olarak ek yeniden göndermeler almak için izlenmesi gereken bir devamlılık belirteci döndürebilir.
- include_metadata
- bool
Yanıtta kapsayıcı meta verilerinin döndürüldüğünü belirtir.
- marker
- str
Donuk bir devamlılık belirteci. Bu değer, num_results belirtildiyse ve oluşturucu sonuçları listelemeyi tamamladıysa, ö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.
make_blob_url
Bloba erişmek için url'yi oluşturur.
make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)Parametreler
- protocol
- str
Kullanılacak protokol: 'http' veya 'https'. Belirtilmezse, BaseBlobService başlatıldığında belirtilen protokolü kullanır.
- sas_token
- str
generate_shared_access_signature ile oluşturulan paylaşılan erişim imzası belirteci.
- snapshot
- str
Anlık görüntüyü benzersiz olarak tanımlayan bir dize değeri. Bu sorgu parametresinin değeri anlık görüntü sürümünü gösterir.
Döndürülenler
blob erişim URL'si.
Dönüş türü
make_container_url
Kapsayıcıya erişmek için url'yi oluşturur.
make_container_url(container_name, protocol=None, sas_token=None)Parametreler
- protocol
- str
Kullanılacak protokol: 'http' veya 'https'. Belirtilmezse, BaseBlobService başlatıldığında belirtilen protokolü kullanır.
- sas_token
- str
generate_shared_access_signature ile oluşturulan paylaşılan erişim imzası belirteci.
Döndürülenler
kapsayıcı erişim URL'si.
Dönüş türü
release_blob_lease
Kirayı serbest bırakır. İstekte belirtilen kira kimliği blobla ilişkiliyle eşleşiyorsa kira serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin blob için kirayı hemen almasını sağlar.
release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
release_container_lease
Kirayı serbest bırakın. lease_id belirtilen kapsayıcıyla ilişkili eşleşmeler varsa kiralama serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin kapsayıcının kirasını hemen almasını sağlar.
release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
renew_blob_lease
Kirayı yeniler. İstekte belirtilen kira kimliği blobla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın süresi dolduğundan bu yana blob değiştirilmediği veya yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır.
renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)Parametreler
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Döndürülenler
Str
renew_container_lease
Kirayı yeniler. Belirtilen kira kimliği kapsayıcıyla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın sona erme tarihinden sonra kapsayıcı yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır.
renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
Döndürülenler
Str
set_blob_metadata
Belirtilen blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar.
set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
Ad ve değer çiftlerini içeren dikte. Bu işleme yapılan her çağrı, bloba eklenmiş olan tüm meta verilerin yerini alır. Blobdan tüm meta verileri kaldırmak için, meta veri üst bilgisi olmadan bu işlemi çağırın.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verileri verilen anahtarla şifreler. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
Döndürülenler
Güncelleştirilmiş Blob için ETag ve son değiştirilen özellikler
Dönüş türü
set_blob_properties
Blob üzerindeki sistem özelliklerini ayarlar. content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır.
set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)Parametreler
- content_settings
- ContentSettings
Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verileri verilen anahtarla şifreler. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
Döndürülenler
Güncelleştirilmiş Blob için ETag ve son değiştirilen özellikler
Dönüş türü
set_blob_service_properties
Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini ayarlar. Bir öğe (örn. Günlük) Yok olarak bırakılırsa, hizmette söz konusu işlevselliğin mevcut ayarları korunur.
set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)Parametreler
- hour_metrics
- Metrics
Saatlik ölçüm ayarları, bloblar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
- minute_metrics
- Metrics
Dakika ölçüm ayarları bloblar için her dakika için istek istatistikleri sağlar.
- cors
- list(CorsRule)
Listeye en fazla beş CorsRule öğesi ekleyebilirsiniz. Boş bir liste belirtilirse, tüm CORS kuralları silinir ve hizmet için CORS devre dışı bırakılır.
- target_version
- str
Gelen isteğin sürümü belirtilmezse istekler için kullanılacak varsayılan sürümü gösterir.
- delete_retention_policy
- DeleteRetentionPolicy
Silme bekletme ilkesi silinen blobların tutulup tutulmayacağını belirtir. Ayrıca blobun tutulacak gün sayısını ve sürümlerini belirtir.
- static_website
- StaticWebsite
Statik web sitesi özelliğinin etkinleştirilip etkinleştirilmediğini belirtir ve evet ise, kullanılacak dizin belgesini ve 404 hata belgesini gösterir.
set_container_acl
Paylaşılan Erişim İmzaları ile kullanılabilecek belirtilen kapsayıcı veya depolanmış erişim ilkeleri için izinleri ayarlar. İzinler, bir kapsayıcıdaki bloblara genel olarak erişilip erişilemeyeceğini gösterir.
set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)Parametreler
- signed_identifiers
- dict(str, AccessPolicy)
Kapsayıcıyla 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.
- lease_id
- str
Belirtilirse, set_container_acl yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşirse başarılı olur.
- if_modified_since
- datetime
Tarih saat değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmişse işlemi gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Tarih saat değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
Döndürülenler
Güncelleştirilmiş Kapsayıcı için ETag ve son değiştirilen özellikler
Dönüş türü
set_container_metadata
Belirtilen kapsayıcı için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar. Bu işleme yapılan her çağrı, kapsayıcıya eklenen tüm mevcut meta verilerin yerini alır. Kapsayıcıdan tüm meta verileri kaldırmak için, meta veri diktesi olmadan bu işlemi çağırın.
set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)Parametreler
Kapsayıcıyla meta veri olarak ilişkilendirilecek ad-değer çiftlerini içeren bir dikte. Örnek: {'category':'test'}
- lease_id
- str
Belirtilirse, set_container_metadata yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
Döndürülenler
Güncelleştirilmiş Kapsayıcı için ETag ve son değiştirilen özellikler
Dönüş türü
set_proxy
HTTP CONNECT Tüneli için ara sunucu ana bilgisayarını ve bağlantı noktasını ayarlar.
set_proxy(host, port, user=None, password=None)Parametreler
snapshot_blob
Blobun salt okunur anlık görüntüsünü oluşturur.
snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)Parametreler
Blobla ilişkilendirilmiş kullanıcı tanımlı ad-değer çiftini belirtir. Hiçbir ad-değer çifti belirtilmezse, işlem temel blob meta verilerini anlık görüntüye kopyalar. Bir veya daha fazla ad-değer çifti belirtilirse, anlık görüntü belirtilen meta verilerle oluşturulur ve meta veriler temel blobdan kopyalanmaz.
- if_modified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. Bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.
- if_unmodified_since
- datetime
Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.
- if_match
- str
ETag değeri veya joker karakter (*). İşlemi yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa gerçekleştirmek için bu üst bilgiyi belirtin.
- if_none_match
- str
ETag değeri veya joker karakter (). yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. yalnızca kaynak yoksa işlemi gerçekleştirmek ve varsa işlemi başarısız yapmak için joker karakteri () belirtin.
Hizmet tarafındaki verileri verilen anahtarla şifreler. Müşteri tarafından sağlanan anahtarların kullanımı HTTPS üzerinden yapılmalıdır. İstekte şifreleme anahtarının kendisi sağlandığından, anahtarı aktarmak için güvenli bir bağlantı kurulmalıdır.
Döndürülenler
anlık görüntü özellikleri
Dönüş türü
undelete_blob
Silinmemiş Blob işlemi, geçici olarak silinen blobun veya anlık görüntünün içeriğini ve meta verilerini geri yükler. Geçici olarak silinmeyen bir blob veya anlık görüntünün silinmesini kaldırma girişimi herhangi bir değişiklik yapılmadan başarılı olur.
undelete_blob(container_name, blob_name, timeout=None)Parametreler
Öznitelikler
protocol
request_session
socket_timeout
MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
Azure SDK for Python
Geri Bildirim
Ç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. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin