azure.storage.blob.BlobClient class

Devam eden kopyalama işlemini iptal edin.

Bu, sıfır uzunlukta ve tam meta veri içeren bir hedef blob bırakır. Kopyalama işlemi zaten sona erdiyse bu bir hataya neden olur.

abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

Parametreler

copy_id: str veya BlobProperties

Gerekli

Durdurulacak kopyalama işlemi. Bu bir kimlik dizesi veya BlobProperties örneği olabilir.

Dönüş türü

None

Yeni kiralama isteğinde bulunur.

Blob etkin bir kiraya sahip değilse, Blob Hizmeti blob üzerinde bir kira oluşturur ve yeni bir kira döndürür.

acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient

Parametreler

lease_duration: int

Gerekli

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).

lease_id: str

Gerekli

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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

BlobLeaseClient nesnesi.

Dönüş türü

BlobLeaseClient

Mevcut ekleme blobunun sonuna yeni bir veri bloğu işler.

append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parametreler

data: bytes veya str veya Iterable

Gerekli

Bloğun içeriği. Bu bayt, metin, yinelenebilir veya dosya benzeri bir nesne olabilir.

length: int

Gerekli

Bloğun bayt cinsinden boyutu.

validate_content: bool

True ise, blok içeriğinin MD5 karması hesaplanır. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz.

maxsize_condition: int

İsteğe bağlı koşullu üst bilgi. Ekleme blobu için izin verilen bayt cinsinden maksimum uzunluk. Ekleme Bloğu işlemi blob'un bu sınırı aşmasına neden olacaksa veya blob boyutu bu üst bilgide belirtilen değerden daha büyükse istek MaxBlobSizeConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

appendpos_condition: int

İsteğe bağlı koşullu üst bilgi, yalnızca Ekleme Bloğu işlemi için kullanılır. Karşılaştırılması gereken bayt uzaklığını gösteren bir sayı. Ekleme Bloğu yalnızca ekleme konumu bu sayıya eşitse başarılı olur. Aksi takdirde, istek AppendPositionConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

encoding: str

Varsayılan olarak UTF-8'e ayarlanır.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsam geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag, son değiştirme, ekleme uzaklığı, işlenen blok sayısı).

Dönüş türü

dict(str, Any)

İçeriğin bir kaynak URL'den okunduğu blobun parçası olarak işlenecek yeni bir blok oluşturur.

append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parametreler

copy_source_url: str

Gerekli

Kaynak verilerin URL'si. Genel olan veya paylaşılan erişim imzası eklenmiş olan herhangi bir Azure Blobu veya Dosyasını işaret edebilir.

source_offset: int

Gerekli

Bu, kopyalama kaynağından alınması gereken bayt aralığının (dahil) başlangıcını gösterir.

source_length: int

Gerekli

Bu, kopyalama kaynağından alınması gereken bayt aralığının sonunu gösterir.

source_content_md5: bytearray

Verilirse, hizmet blok içeriğinin MD5 karması hesaplar ve bu değerle karşılaştırır.

maxsize_condition: int

İsteğe bağlı koşullu üst bilgi. Ekleme blobu için izin verilen bayt cinsinden maksimum uzunluk. Ekleme Bloğu işlemi blob'un bu sınırı aşmasına neden olacaksa veya blob boyutu bu üst bilgide belirtilen değerden daha büyükse istek MaxBlobSizeConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

appendpos_condition: int

İsteğe bağlı koşullu üst bilgi, yalnızca Ekleme Bloğu işlemi için kullanılır. Karşılaştırılması gereken bayt uzaklığını gösteren sayı. Ekleme Bloğu yalnızca ekleme konumu bu sayıya eşitse başarılı olur. Aksi takdirde, istek AppendPositionConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

Hedef ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak hedef eşleşme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

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. İşlemi yalnızca kaynak kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi belirtin.

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. İşlemi yalnızca kaynak kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

source_etag: str

Kaynak ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

source_match_condition: MatchConditions

Etag üzerinde kullanılacak kaynak eşleştirme koşulu.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsam geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

source_authorization: str

Kaynak bloba erişmek için istemci gizli dizisini kullanarak hizmet sorumlusu olarak kimlik doğrulaması yapın. source_authorization dizesinin ön ekinin "taşıyıcı" olduğundan emin olun.

Bir sayfa aralığını temizler.

clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

offset: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt aralığının başlangıcı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modülü olmalıdır.

length: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt sayısı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modülü olmalıdır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

if_sequence_number_lte: int

Blob'un sıra numarası belirtilen değerden küçük veya buna eşitse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_lt: int

Blob'un sıra numarası belirtilen değerden küçükse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_eq: int

Blob'un sıra numarası belirtilen değere eşitse istek devam eder; aksi takdirde başarısız 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict(str, Any)

Bu yöntem, istemci tarafından açılan yuvaları kapatmaktır. Bağlam yöneticisi ile kullanılırken kullanılması gerekmez.

close()

Yürütme Bloğu Listesi işlemi, blobu oluşturan blok kimliklerinin listesini belirterek bir blob yazar.

commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

Parametreler

block_list: list

Gerekli

Blockblobs listesi.

content_settings: ContentSettings

Gerekli

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türünü, kodlamayı, dili, eğilimi, md5'i ve önbellek denetimini ayarlamak için kullanılır.

metadata: dict[str, str]

Gerekli

Blob ile meta veri olarak ilişkili ad-değer çiftleri.

tags: dict(str, str)

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta üst üste (:), eşittir (=), alt çizgi (_)

Sürüm 12.4.0'da yeni.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

immutability_policy: ImmutabilityPolicy

Bir blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

legal_hold: bool

Blobda yasal bir saklama ayarlanmalıysa belirtilir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

validate_content: bool

True ise, sayfa içeriğinin bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından, https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz.

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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip hedef blob üzerinde çalışacak bir SQL where yan tümcesi belirtin.

Sürüm 12.4.0'da yeni.

standard_blob_tier: StandardBlobTier

Blobu ayarlanacağı standart blob katmanı değeri. Kitaplığın bu sürümü için bu yalnızca standart depolama hesaplarında blok blobları için geçerlidir.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsam geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict(str, Any)

Yeni bir Ekleme Blobu oluşturur. Bu işlem yeni bir 0 uzunluklu ekleme blobu oluşturur. Yeni başlatılan ekleme blobuyla mevcut blobların içeriğinin üzerine yazılır. Ekleme blob'una içerik eklemek için veya append_block_from_url yöntemini çağırınappend_block.

create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

content_settings: ContentSettings

Gerekli

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türünü, kodlamayı, dili, eğilimi, md5'i ve önbellek denetimini ayarlamak için kullanılır.

metadata: dict(str, str)

Gerekli

Blob ile meta veri olarak ilişkili ad-değer çiftleri.

tags: dict(str, str)

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta üst üste (:), eşittir (=), alt çizgi (_)

Sürüm 12.4.0'da yeni.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

immutability_policy: ImmutabilityPolicy

Bir blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

legal_hold: bool

Blobda yasal bir saklama ayarlanmalıysa belirtilir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict[str, Any]

Belirtilen boyutta yeni bir Sayfa Blobu oluşturur.

create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]

Parametreler

size: int

Gerekli

Bu, sayfa blobu için en fazla 1 TB boyutu belirtir. Sayfa blobu boyutu 512 baytlık bir sınıra hizalanmalıdır.

content_settings: ContentSettings

Gerekli

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türü, kodlama, dil, bırakma, md5 ve önbellek denetimini ayarlamak için kullanılır.

metadata: dict(str, str)

Gerekli

Blob ile meta veri olarak ilişkili ad-değer çiftleri.

premium_page_blob_tier: PremiumPageBlobTier

Gerekli

Blobu ayarlanacağı sayfa blobu katmanı değeri. Katman, blobun boyutuyla ve izin verilen IOPS sayısıyla ilişkilidir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir.

tags: dict(str, str)

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta (:), eşittir (=), alt çizgi (_)

Sürüm 12.4.0'da yeni.

sequence_number: int

Yalnızca Sayfa blobları için. Sıra numarası, istekleri izlemek için kullanabileceğiniz kullanıcı tarafından denetlenen bir değerdir. Sıra numarasının değeri 0 ile 2^63 - 1 arasında olmalıdır. Varsayılan değer 0'dır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

immutability_policy: ImmutabilityPolicy

Blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

legal_hold: bool

Blob üzerinde yasal bir saklamanın ayarlanması gerekiyorsa belirtilir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict[str, Any]

Blobun anlık görüntüsünü oluşturur.

Anlık görüntü, bir blobun belirli bir noktada alınan salt okunur bir sürümüdür. Okunabilir, kopyalanabilir veya silinebilir, ancak değiştirilemez. Anlık görüntüler, bir blobu anında göründüğü şekilde yedeklemek için bir yol sağlar.

Bir blobun anlık görüntüsü, anlık görüntünün alındığı temel blobla aynı ada sahiptir ve anlık görüntünün alındığı saati belirten bir DateTime değeri eklenir.

create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

metadata: dict(str, str)

Gerekli

Blob ile meta veri olarak ilişkili ad-değer çiftleri.

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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip hedef blob üzerinde çalışacak bir SQL where yan tümcesi belirtin.

Sürüm 12.4.0'da yeni.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Anlık Görüntü Kimliği, Etag ve son değiştirme).

Dönüş türü

dict[str, Any]

Belirtilen blobu 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. delete_blob() işlemiyle ikisini de aynı anda silebilirsiniz.

Hizmet için silme bekletme ilkesi etkinleştirildiyse, bu işlem blobu geçici olarak siler ve blobu belirtilen sayıda gün boyunca saklar. Belirtilen gün sayısından sonra, blobun verileri çöp toplama sırasında hizmetten kaldırılır. Geçici olarak silinen bloba include=['deleted'] seçeneği belirterek list_blobs erişilebilir. Geçici olarak silinen blob, işlem kullanılarak <xref:azure.storage.blob.undelete> geri yüklenebilir.

delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

Parametreler

delete_snapshots: str

Gerekli

Blobda ilişkili anlık görüntüler varsa gereklidir. Değerlere şunlar dahildir:

"only": Yalnızca blob anlık görüntülerini siler.
"include": Blobu tüm anlık görüntülerle birlikte siler.

version_id: str

sürüm kimliği parametresi, mevcut olduğunda silinecek blobun sürümünü belirten opak bir DateTime değeridir.

Sürüm 12.4.0'da yeni.

Bu anahtar sözcük bağımsız değişkeni '2019-12-12' API sürümünde sunulmuştur.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Belirtilirse, delete_blob yalnızca blob kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Dönüş türü

None

Değişmezlik İlkesini Sil işlemi blobdaki değişmezlik ilkesini siler.

Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.

delete_immutability_policy(**kwargs: Any) -> None

Parametreler

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob etiketlerinin anahtar değer çiftleri.

Dönüş türü

Dict[str, str]

StorageStreamDownloader'a bir blob indirir. Readall() yöntemi tüm içeriği okumak için kullanılmalıdır veya blobu akışa indirmek için readinto() kullanılmalıdır. chunks() kullanmak, kullanıcının öbeklerdeki içerik üzerinde yineleme yapmasına olanak tanıyan bir yineleyici döndürür.

download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

Parametreler

offset: int

Gerekli

Blobun bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. Uzunluk sağlanmışsa ayarlanmalıdır.

length: int

Gerekli

Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdır.

version_id: str

sürüm kimliği parametresi, mevcut olduğunda indirilmesi gereken blobun sürümünü belirten opak bir DateTime değeridir.

Sürüm 12.4.0'da yeni.

Bu anahtar sözcük bağımsız değişkeni '2019-12-12' API sürümünde sunulmuştur.

validate_content: bool

True ise, blobun her bir öbeği için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından, https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz. Ayrıca etkinleştirilirse bellek açısından verimli karşıya yükleme algoritmasının kullanılmayacağını unutmayın çünkü MD5 karması hesaplaması blokların tamamını arabelleğe almayı gerektirir ve bunu yapmak bellek açısından verimli algoritmanın amacını alt eder.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Belirtilirse, download_blob yalnızca blob kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

max_concurrency: int

İndirilmesi gereken paralel bağlantı sayısı.

encoding: str

İndirilen baytların kodunu çözmek için kodlama. Varsayılan değer Yok,yani kod çözme yok şeklindedir.

progress_hook: Callable[[int, int], None]

Uzun süre çalışan bir indirme işleminin ilerleme durumunu izlemek için geri arama. İmza işlevidir (current: int, total: int), burada geçerli, şimdiye kadar aktarılan bayt sayısı ve toplam indirmenin toplam boyutudur.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın. Bu yöntem hizmete birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır. Azure hizmetine birden çok çağrı yapılır ve zaman aşımı her çağrıya ayrı ayrı uygulanır.

Döndürülenler

Akış nesnesi (StorageStreamDownloader)

Dönüş türü

StorageStreamDownloader

Tanımlı parametrelerle bir blob varsa True döndürür ve aksi takdirde False döndürür.

exists(**kwargs: Any) -> bool

Parametreler

version_id: str

sürüm kimliği parametresi, mevcut olduğunda blobun mevcut olup olmadığını denetlemek için blobun sürümünü belirten opak bir DateTime değeridir.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

boolean

Dönüş türü

bool

Blob URL'sinden BlobClient oluşturun. Bu, blob adında '/' bulunan özelleştirilmiş blob URL'lerini desteklemez.

from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self

Parametreler

blob_url: str

Gerekli

Kullanıldıysa SAS belirteci ve anlık görüntü dahil olmak üzere Blob'un tam uç nokta URL'si. Bu, geçerli location_mode bağlı olarak birincil uç nokta veya ikincil uç nokta olabilir.

credential: Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

varsayılan değer: None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Hesap URL'sinde zaten bir SAS belirteci varsa veya bağlantı dizesi zaten paylaşılan erişim anahtarı değerleri varsa bu isteğe bağlıdır. Değer bir SAS belirteci dizesi, azure.core.credentials öğesinden azureSasCredential veya AzureNamedKeyCredential örneği, hesap paylaşılan erişim anahtarı veya azure.identity'den TokenCredentials sınıfının bir örneği olabilir. Kaynak URI'sinde zaten bir SAS belirteci varsa, bu açık bir kimlik bilgisi için yoksayılır

ancak çakışan SAS belirteçlerinin bir ValueError oluşturacağı AzureSasCredential durumu dışında. AzureNamedKeyCredential örneği kullanılıyorsa depolama hesabı adı "name" ve depolama hesabı anahtarı "anahtar" olmalıdır.

snapshot: str

varsayılan değer: None

Üzerinde çalışılan isteğe bağlı blob anlık görüntüsü. Bu anlık görüntü kimliği dizesi veya içinden create_snapshotdöndürülen yanıt olabilir. Belirtilirse, bu url'deki anlık görüntüyü geçersiz kılar.

version_id: str

Sürüm kimliği parametresi, mevcut olduğunda üzerinde çalışacak blobun sürümünü belirten opak bir DateTime değeridir.

Döndürülenler

Blob istemcisi.

Dönüş türü

BlobClient

Bağlantı Dizesinden BlobClient oluşturun.

from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametreler

conn_str: str

Gerekli

Azure Depolama hesabına bağlantı dizesi.

container_name: str

Gerekli

Blob için kapsayıcı adı.

blob_name: str

Gerekli

Etkileşim kurulacak blobun adı.

snapshot: str

varsayılan değer: None

Üzerinde çalışılan isteğe bağlı blob anlık görüntüsü. Bu anlık görüntü kimliği dizesi veya içinden create_snapshotdöndürülen yanıt olabilir.

credential: Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

varsayılan değer: None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Hesap URL'sinde zaten bir SAS belirteci varsa veya bağlantı dizesi zaten paylaşılan erişim anahtarı değerleri varsa bu isteğe bağlıdır. Değer bir SAS belirteci dizesi, azure.core.credentials öğesinden azureSasCredential veya AzureNamedKeyCredential örneği, hesap paylaşılan erişim anahtarı veya azure.identity'den TokenCredentials sınıfının bir örneği olabilir. Burada sağlanan kimlik bilgileri, bağlantı dizesi kimlik bilgilerine göre önceliklidir. AzureNamedKeyCredential örneği kullanılıyorsa depolama hesabı adı "name" ve depolama hesabı anahtarı "anahtar" olmalıdır.

version_id: str

Sürüm kimliği parametresi, mevcut olduğunda üzerinde çalışacak blobun sürümünü belirten opak bir DateTime değeridir.

Döndürülenler

Blob istemcisi.

Dönüş türü

BlobClient

Blob'un bulunduğu depolama hesabıyla ilgili bilgileri alır.

Bilgiler, kullanıcının bir kapsayıcıya veya bloba sas'sı varsa da alınabilir. Döndürülen sözlükteki anahtarlar 'sku_name' ve 'account_kind' içerir.

get_account_information(**kwargs: Any) -> Dict[str, str]

Döndürülenler

Hesap bilgilerinin bir diktesi (SKU ve hesap türü).

Dönüş türü

dict(str, str)

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.

get_blob_properties(**kwargs: Any) -> BlobProperties

Parametreler

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

version_id: str

sürüm kimliği parametresi, mevcut olduğunda özellikleri almak için blobun sürümünü belirten opak bir DateTime değeridir.

Sürüm 12.4.0'da yeni.

Bu anahtar sözcük bağımsız değişkeni '2019-12-12' API sürümünde sunulmuştur.

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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

BlobProperties

Dönüş türü

BlobProperties

Etiketleri Al işlemi, kullanıcıların blob veya belirli bir blob sürümü ya da anlık görüntü üzerinde etiket almasına olanak tanır.

Sürüm 12.4.0'da yeni eklendi: Bu işlem '2019-12-12' API sürümünde kullanıma sunulmuştur.

get_blob_tags(**kwargs: Any) -> Dict[str, str]

Parametreler

version_id: str

sürüm kimliği parametresi, mevcut olduğunda etiket eklenecek blobun sürümünü belirten opak bir DateTime değeridir.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip hedef blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob etiketlerinin anahtar değer çiftleri.

Dönüş türü

Dict[str, str]

Blok Listesini Al işlemi, bir blok blobunun parçası olarak karşıya yüklenen blokların listesini alır.

get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

Parametreler

block_list_type: str

Gerekli

İşlenen bloklar listesinin mi, kaydedilmemiş blokların listesinin mi yoksa her iki listenin birlikte mi döndürülmeyeceğini belirtir. Olası değerler şunlardır: 'committed', 'uncommitted', 'all'

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip hedef blob üzerinde çalışacak bir SQL where yan tümcesi belirtin.

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

İki listeden oluşan bir demet - işlenen ve kaydedilmemiş bloklar

Dönüş türü

tuple(list(BlobBlock), list(BlobBlock))

Yönetilen disk veya anlık görüntü için geçerli sayfa aralıklarının listesini döndürür.

Not

Bu işlem yalnızca yönetilen disk hesapları için kullanılabilir.

Sürüm 12.2.0'da yeni eklendi: Bu işlem '2019-07-07' API sürümünde kullanıma sunulmuştur.

get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parametreler

previous_snapshot_url

Gerekli

Yönetilen diskin önceki anlık görüntüsünün URL'sini belirtir. Yanıt yalnızca hedef blob ile önceki anlık görüntüsü arasında değiştirilmiş sayfaları içerir.

offset: int

Gerekli

Geçerli sayfa aralıklarını almak için kullanılacak bayt aralığının başlangıcı. Uzunluk verilmezse, uzaklık sonrasındaki tüm baytlar aranacaktır. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

length: int

Gerekli

Geçerli sayfa aralıklarını almak için kullanılacak bayt sayısı. Uzunluk verilirse uzaklık sağlanmalıdır. Bu aralık, uzaklık başlangıcından belirtilen uzunluğa kadar geçerli sayfa aralıkları döndürür. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

'start' ve 'end' anahtarlarına sahip sözlükler olarak iki sayfa aralığı listesi. İlk öğe doldurulmuş sayfa aralıklarıdır, 2. öğe sayfa aralıkları temizlenir.

Dönüş türü

tuple(list(dict(str, str), list(dict(str, str))

KULLANIMDAN KALDıRILDI: Sayfa Blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür.

get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parametreler

offset: int

Gerekli

Geçerli sayfa aralıklarını almak için kullanılacak bayt aralığının başlangıcı. Uzunluk verilmezse, uzaklık sonrasındaki tüm baytlar aranacaktır. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

length: int

Gerekli

Geçerli sayfa aralıklarını almak için kullanılacak bayt sayısı. Uzunluk verilirse uzaklık sağlanmalıdır. Bu aralık, uzaklık başlangıcından belirtilen uzunluğa kadar geçerli sayfa aralıkları döndürür. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

previous_snapshot_diff: str

Gerekli

Daha yeni bir anlık görüntüyle veya geçerli blobla karşılaştırılacak önceki bir blob anlık görüntüsünü belirten opak bir DateTime değeri içeren snapshot diff parametresi.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

'start' ve 'end' anahtarlarına sahip sözlükler olarak iki sayfa aralığı listesi. İlk öğe doldurulmuş sayfa aralıklarıdır, 2. öğe sayfa aralıkları temizlenir.

Dönüş türü

tuple(list(dict(str, str), list(dict(str, str))

Sayfa Blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür. previous_snapshot belirtilirse, sonuç hedef blob ile önceki anlık görüntü arasındaki değişikliklerin farkını gösterir.

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]

Parametreler

offset: int

Geçerli sayfa aralıklarını almak için kullanılacak bayt aralığının başlangıcı. Uzunluk verilmezse, uzaklık sonrasındaki tüm baytlar aranacaktır. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

length: int

Geçerli sayfa aralıklarını almak için kullanılacak bayt sayısı. Uzunluk verilirse uzaklık sağlanmalıdır. Bu aralık, uzaklık başlangıcından belirtilen uzunluğa kadar geçerli sayfa aralıkları döndürür. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

previous_snapshot: str veya Dict[str, Any]

Yanıtın yalnızca hedef blob ile önceki anlık görüntü arasında değiştirilmiş sayfaları içereceğini belirten bir anlık görüntü değeri. Değiştirilen sayfalar hem güncelleştirilmiş hem de temizlenmiş sayfaları içerir. previous_snapshot tarafından belirtilen anlık görüntü ikiden eski olduğu sürece hedef blob bir anlık görüntü olabilir.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

results_per_page: int

API çağrısı başına alınacak en fazla sayfa aralığı sayısı.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

PageRange'in yinelenebilir (otomatik sayfalama).

Dönüş türü

ItemPaged[PageRange]

Kullanıcıların basit sorgu ifadeleri sağlayarak blob/veya blob anlık görüntü verilerini seçmesini/yansıtmasını sağlar. Bu işlemler bir BlobQueryReader döndürür; kullanıcıların sorgu verilerini almak için readall() veya readinto() kullanması gerekir.

query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader

Parametreler

query_expression: str

Gerekli

Gereklidir. bir sorgu deyimi. Diğer ayrıntılar için bkz: https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

on_error: Callable[BlobQueryError]

Hizmet tarafından döndürülen işleme hatalarında çağrılacak bir işlev.

blob_format: DelimitedTextDialect veya DelimitedJsonDialect veya QuickQueryDialect veya str

İsteğe bağlı. Blobda depolanan verilerin seri hale getirilmesini tanımlar. Varsayılan değer, blob verilerini varsayılan diyalektte biçimlendirilmiş CSV verileri olarak işlemektir. Bu, özel bir DelimitedTextDialect veya DelimitedJsonDialect veya "ParquetDialect" (dize veya sabit listesi olarak geçirilir) ile geçersiz kılınabilir. Bu diyalektler ilgili sınıfları, QuickQueryDialect sabit listesi veya dize olarak geçirilebilir

output_format: DelimitedTextDialect veya DelimitedJsonDialect veya list[ArrowDialect] veya QuickQueryDialect veya str

İsteğe bağlı. Veri akışı için çıkış serileştirmesini tanımlar. Varsayılan olarak veriler blobda gösterildiği gibi döndürülür (Parquet biçimleri varsayılan olarak DelimitedTextDialect olarak ayarlanır). Çıkış biçimi sağlanarak blob verileri bu profile göre yeniden biçimlendirilir. Bu değer, DelimitedTextDialect veya DelimitedJsonDialect veya ArrowDialect olabilir. Bu diyalektler ilgili sınıfları, QuickQueryDialect sabit listesi veya dize olarak geçirilebilir

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Akış nesnesi (BlobQueryReader)

Dönüş türü

BlobQueryReader

Sayfa blobunu belirtilen boyuta yeniden boyutlandırıyor.

Belirtilen değer blobun geçerli boyutundan küçükse, belirtilen değerin üzerindeki tüm sayfalar temizlenir.

resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

size: int

Gerekli

Blobu yeniden boyutlandırmak için kullanılan boyut. Sayfa blobu için boyut üst sınırı 1 TB'a kadardır. Sayfa blobu boyutu 512 baytlık bir sınıra hizalanmalıdır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

premium_page_blob_tier: PremiumPageBlobTier

Blobu ayarlanacağı sayfa blobu katmanı değeri. Katman, blobun boyutuyla ve izin verilen IOPS sayısıyla ilişkilidir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict(str, Any)

Seal işlemi, Ekleme Blobunu salt okunur hale getirmek için mühürler.

Sürüm 12.4.0'da yeni.

seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]

Parametreler

appendpos_condition: int

İsteğe bağlı koşullu üst bilgi, yalnızca Ekleme Bloğu işlemi için kullanılır. Karşılaştırılması gereken bayt uzaklığını gösteren sayı. Ekleme Bloğu yalnızca ekleme konumu bu sayıya eşitse başarılı olur. Aksi takdirde, istek AppendPositionConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag, son değiştirme, ekleme uzaklığı, işlenen blok sayısı).

Dönüş türü

dict(str, Any)

Blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar.

set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

metadata: dict(str, str)

Gerekli

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.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)

Etiketleri Ayarla işlemi, kullanıcıların blob veya belirli bir blob sürümünde etiket ayarlamasına olanak tanır, ancak anlık görüntü ayarlamaz. Bu işleme yapılan her çağrı, bloba eklenen tüm mevcut etiketlerin yerini alır. Blobdaki tüm etiketleri kaldırmak için etiket ayarsız olarak bu işlemi çağırın.

Sürüm 12.4.0'da yeni eklendi: Bu işlem '2019-12-12' API sürümünde kullanıma sunulmuştur.

set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

Parametreler

tags: dict(str, str)

Gerekli

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta (:), eşittir (=), alt çizgi (_)

version_id: str

version id parametresi, mevcut olduğunda etiket eklenecek blobun sürümünü belirten opak bir DateTime değeridir.

validate_content: bool

True ise, etiket içeriğinin MD5 karması hesaplanır. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip hedef blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)

Dönüş türü

Dict[str, Any]

Blob üzerindeki sistem özelliklerini ayarlar.

content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

Parametreler

content_settings: ContentSettings

Gerekli

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türü, kodlama, dil, bırakma, md5 ve önbellek denetimini ayarlamak için kullanılır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)

Dönüş türü

Dict[str, Any]

Değişmezlik İlkesiNi Ayarla işlemi blob üzerinde değişmezlik ilkesini ayarlar.

Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.

set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

Parametreler

immutability_policy: ImmutabilityPolicy

Gerekli

Blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob etiketlerinin anahtar değer çiftleri.

Dönüş türü

Dict[str, str]

Yasal Saklamayı Ayarla işlemi blob üzerinde yasal bir saklama ayarlar.

Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.

set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

Parametreler

legal_hold: bool

Gerekli

Blob üzerinde yasal bir saklamanın ayarlanması gerekiyorsa belirtilir.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob etiketlerinin anahtar değer çiftleri.

Dönüş türü

Dict[str, Union[str, datetime, bool]]

Blob üzerindeki sayfa blob katmanlarını ayarlar. Bu API yalnızca premium hesaplardaki sayfa blobları için desteklenir.

set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

Parametreler

premium_page_blob_tier: PremiumPageBlobTier

Gerekli

Blobu ayarlanacağı sayfa blobu katmanı değeri. Katman, blobun boyutuyla ve izin verilen IOPS sayısıyla ilişkilidir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

Dönüş türü

None

Blob dizisi numarasını ayarlar.

set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

sequence_number_action: str

Gerekli

Bu özellik, hizmetin blob'un sıra numarasını nasıl değiştirmesi gerektiğini gösterir. Daha fazla bilgi edinmek için bkz. SequenceNumberAction.

sequence_number: str

Gerekli

Bu özellik blob'un sıra numarasını ayarlar. Sıra numarası, istekleri izlemek ve eşzamanlılık sorunlarını yönetmek için kullanabileceğiniz kullanıcı tarafından denetlenen bir özelliktir.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict(str, Any)

Bu işlem katmanı bir blok blobu üzerinde ayarlar.

Blok blobu katmanı Sık Erişimli/Seyrek Erişimli/Arşiv depolama türünü belirler. Bu işlem blob'un ETag'ini güncelleştirmez.

set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

Parametreler

standard_blob_tier: str veya StandardBlobTier

Gerekli

Blobda ayarlanacak katmanı gösterir. Seçenekler arasında 'Sık Erişimli', 'Seyrek Erişimli', 'Arşiv' bulunur. Sık erişim katmanı, sık erişilen verileri depolamak için iyileştirilmiştir. Seyrek erişimli depolama katmanı, seyrek erişilen ve en az bir ay saklanan verileri depolamak için iyileştirilmiştir. Arşiv katmanı, seyrek erişilen ve esnek gecikme süresi gereksinimleriyle en az altı ay boyunca depolanan verileri depolamak için iyileştirilmiştir.

rehydrate_priority: RehydratePriority

Arşivlenmiş blobu yeniden doldurma önceliğini gösterir

version_id: str

version id parametresi, mevcut olduğunda indirilmesi gereken blobun sürümünü belirten opak bir DateTime değeridir.

Sürüm 12.4.0'da yeni.

Bu anahtar sözcük bağımsız değişkeni '2019-12-12' API sürümünde sunulmuştur.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

Dönüş türü

None

Blobun parçası olarak işlenecek yeni bir blok oluşturur.

stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]

Parametreler

block_id: str

Gerekli

Bloğu tanımlayan bir dize değeri. Dizenin boyutu 64 bayttan küçük veya buna eşit olmalıdır. Belirli bir blob için block_id her blok için aynı boyutta olmalıdır.

data

Gerekli

Blob verileri.

length: int

Gerekli

Bloğun boyutu.

validate_content: bool

True ise blobun her bir öbeği için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz. Ayrıca etkinleştirilirse bellek açısından verimli karşıya yükleme algoritmasının kullanılmayacağını unutmayın çünkü MD5 karmasının hesaplanması tüm blokları arabelleğe almayı gerektirir ve bunu yapmak bellek açısından verimli algoritmanın amacını alt eder.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

encoding: str

Varsayılan olarak UTF-8'i kullanır.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob özelliği diktesi.

Dönüş türü

dict[str, Any]

İçeriğin url'den okunduğu bir blobun parçası olarak işlenecek yeni bir blok oluşturur.

stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]

Parametreler

block_id: str

Gerekli

Bloğu tanımlayan bir dize değeri. Dizenin boyutu 64 bayttan küçük veya buna eşit olmalıdır. Belirli bir blob için block_id her blok için aynı boyutta olmalıdır.

source_url: str

Gerekli

The URL.

source_offset: int

Gerekli

Blok için kullanılacak bayt aralığının başlangıcı. Kaynak uzunluğu sağlanmışsa ayarlanmalıdır.

source_length: int

Gerekli

Bloğun bayt cinsinden boyutu.

source_content_md5: bytearray

Gerekli

Kopyalama kaynağından okunması gereken bayt aralığı için hesaplanan md5 değerini belirtin.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

source_authorization: str

Kaynak bloba erişmek için istemci gizli dizisini kullanarak hizmet sorumlusu olarak kimlik doğrulaması yapın. source_authorization dizesinin ön ekinin "taşıyıcı" olduğundan emin olun.

Döndürülenler

Blob özelliği diktesi.

Dönüş türü

dict[str, Any]

Verilen URL'den bir blob kopyalar.

Bu işlem, kopyalama işleminin durumunu denetlemek veya durdurmak için kullanılabilecek copy_status ve copy_id içeren bir sözlük döndürür. copy_status , kopya zaman uyumlu olarak tamamlandıysa 'başarılı' veya kopya zaman uyumsuz olarak başlatıldıysa 'beklemede' olur. Zaman uyumsuz kopyalar için, yöntemi yoklama ve kopyalama durumu denetlenerek get_blob_properties durum denetlenebilir. Kopyayı zaman uyumlu olmaya zorlamak için requires_sync True olarak ayarlayın. 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 blobla 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.

start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]

Parametreler

source_url: str

Gerekli

Dosya veya blob 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/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata: dict(str, str)

Gerekli

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.

incremental_copy: bool

Gerekli

Kaynak sayfa blobunun anlık görüntüsünü bir hedef sayfa blob'una kopyalar. Anlık görüntü, yalnızca daha önce kopyalanan anlık görüntü arasındaki değişiklik değişiklikleri hedefe aktarılacak şekilde kopyalanır. Kopyalanan anlık görüntüler özgün anlık görüntünün tam kopyalarıdır ve her zamanki gibi okunabilir veya kopyalanabilir. Varsayılan değer False'tur.

tags: dict(str, str) veya Literal["COPY"]

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta (:), eşittir (=), alt çizgi (_).

Bunun yerine (büyük/küçük harfe duyarlı) değişmez değeri "COPY" kaynak blobdan etiketleri kopyalamak için geçirilebilir. Bu seçenek yalnızca incremental_copy=Yanlış ve requires_sync=Doğru olduğunda kullanılabilir.

Sürüm 12.4.0'da yeni.

immutability_policy: ImmutabilityPolicy

Blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

legal_hold: bool

Blob üzerinde yasal bir saklamanın ayarlanması gerekiyorsa belirtilir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

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_etag: str

Kaynak ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

source_match_condition: MatchConditions

Etag'de kullanılacak kaynak eşleştirme koşulu.

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.

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.

etag: str

Hedef ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak hedef eşleşme koşulu.

destination_lease: BlobLeaseClient veya 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: BlobLeaseClient veya 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.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

premium_page_blob_tier: PremiumPageBlobTier

Blobu ayarlanacağı sayfa blobu katmanı değeri. Katman, blobun boyutuyla ve izin verilen IOPS sayısıyla ilişkilidir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir.

standard_blob_tier: StandardBlobTier

Blobu ayarlanacağı standart blob katmanı değeri. Kitaplığın bu sürümü için bu yalnızca standart depolama hesaplarında blok blobları için geçerlidir.

rehydrate_priority: RehydratePriority

Arşivlenmiş blobu yeniden doldurma önceliğini gösterir

seal_destination_blob: bool

Hedef ekleme blobunu mühürleyin. Bu işlem yalnızca ekleme blobu içindir.

Sürüm 12.4.0'da yeni.

requires_sync: bool

Kopyalama tamamlanana kadar hizmetin yanıt döndürmemesi için zorlar.

source_authorization: str

Kaynak bloba erişmek için istemci gizli dizisini kullanarak hizmet sorumlusu olarak kimlik doğrulaması yapın. source_authorization dizesinin ön ekinin "taşıyıcı" olduğundan emin olun. Bu seçenek yalnızca incremental_copy False ve requires_sync True olarak ayarlandığında kullanılabilir.

Sürüm 12.9.0'da yeni.

encryption_scope: str

Eşitlenen kopyalanan blobdaki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.10.0'da yeni.

Döndürülenler

Kopyalama özelliklerinin sözlüğü (etag, last_modified, copy_id, copy_status).

Dönüş türü

dict[str, Union[str, datetime]]

Geçici olarak silinen blobları veya anlık görüntüleri geri yükler.

İşlem yalnızca silme bekletme ilkesinde ayarlanan belirtilen gün sayısı içinde kullanıldığında başarılı olur.

Blob sürümü oluşturma etkinleştirildiyse, temel blob bu yöntem kullanılarak geri yüklenemez. Bunun yerine geçerli sürüme yükseltmek istediğiniz blob sürümünün URL'siyle kullanın start_copy_from_url .

undelete_blob(**kwargs: Any) -> None

Parametreler

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Dönüş türü

None

Otomatik öbekleme ile bir veri kaynağından yeni bir blob oluşturur.

upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]

Parametreler

data

Gerekli

Karşıya yüklenecek blob verileri.

blob_type: BlobType

Gerekli

Blobun türü. Bu BlockBlob, PageBlob veya AppendBlob olabilir. Varsayılan değer BlockBlob'dur.

length: int

Gerekli

Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdır.

metadata: dict(str, str)

Gerekli

Blob ile meta veri olarak ilişkili ad-değer çiftleri.

tags: dict(str, str)

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta üst üste (:), eşittir (=), alt çizgi (_)

Sürüm 12.4.0'da yeni.

overwrite: bool

Karşıya yüklenecek blob'un geçerli verilerin üzerine yazıp yazmaması gerekir. True ise, upload_blob var olan verilerin üzerine yazar. False olarak ayarlanırsa işlem ResourceExistsError ile başarısız olur. Yukarıdakilerin istisnası Ekleme blob türleridir: False olarak ayarlanırsa ve veriler zaten varsa, bir hata oluşmaz ve veriler mevcut bloba eklenir. Overwrite=True olarak ayarlanırsa, mevcut ekleme blobu silinir ve yeni bir blob oluşturulur. Varsayılan değer False'tur.

content_settings: ContentSettings

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türünü, kodlamayı, dili, eğilimi, md5'i ve önbellek denetimini ayarlamak için kullanılır.

validate_content: bool

True ise, blobun her bir öbeği için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından, https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz. Ayrıca etkinleştirilirse bellek açısından verimli karşıya yükleme algoritmasının kullanılmayacağını unutmayın çünkü MD5 karması hesaplaması blokların tamamını arabelleğe almayı gerektirir ve bunu yapmak bellek açısından verimli algoritmanın amacını alt eder.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Belirtilirse, upload_blob yalnızca blob kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

premium_page_blob_tier: PremiumPageBlobTier

Blobu ayarlanacağı sayfa blobu katmanı değeri. Katman, blobun boyutuyla ve izin verilen IOPS sayısıyla ilişkilidir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir.

standard_blob_tier: StandardBlobTier

Blobu ayarlanacağı standart blob katmanı değeri. Kitaplığın bu sürümü için bu yalnızca standart depolama hesaplarında blok blobları için geçerlidir.

immutability_policy: ImmutabilityPolicy

Bir blobun, blob anlık görüntüsünün veya blob sürümünün değişmezlik ilkesini belirtir. Şu anda upload_blob() API'sinin bu parametresi yalnızca BlockBlob içindir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

legal_hold: bool

Blobda yasal bir saklama ayarlanmalıysa belirtilir. Şu anda upload_blob() API'sinin bu parametresi yalnızca BlockBlob içindir.

Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.

maxsize_condition: int

İsteğe bağlı koşullu üst bilgi. Ekleme blobu için izin verilen bayt cinsinden maksimum uzunluk. Ekleme Bloğu işlemi blob'un bu sınırı aşmasına neden olacaksa veya blob boyutu bu üst bilgide belirtilen değerden daha büyükse istek MaxBlobSizeConditionNotMet hatasıyla başarısız olur (HTTP durum kodu 412 - Önkoşul Başarısız oldu).

max_concurrency: int

Blob boyutu 64 MB'ı aştığında kullanılacak en fazla paralel bağlantı sayısı.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsam geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

encoding: str

Varsayılan olarak UTF-8'e ayarlanır.

progress_hook: Callable[[int, Optional[int]], None]

Uzun süre çalışan bir karşıya yüklemenin ilerleme durumunu izlemek için geri arama. İmza işlevidir (geçerli: int, toplam: İsteğe bağlı[int]), burada geçerli, şu ana kadar aktarılan bayt sayısıdır ve toplam blobun boyutudur veya boyut bilinmiyorsa Hiçbiri olur.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmiyor veya doğrulanmıyor. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın. Bu yöntem hizmete birden çok çağrı yapabilir ve zaman aşımı her çağrıya ayrı ayrı uygulanır.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)

Dönüş türü

dict[str, Any]

Blobun içeriğinin belirli bir URL'den okunduğu yeni bir Blok Blobu oluşturur. Mevcut blobun içeriğinin üzerine yeni blob yazılır.

upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]

Parametreler

source_url: str

Gerekli

Dosya veya blob 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/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

overwrite: bool

Karşıya yüklenecek blob'un geçerli verilerin üzerine yazıp yazmaması gerekir. True ise, upload_blob var olan verilerin üzerine yazar. False olarak ayarlanırsa işlem ResourceExistsError ile başarısız olur.

include_source_blob_properties: bool

Kaynak blobdaki özelliklerin kopyalanması gerekip gerekmediğini gösterir. Varsayılan değer True'dır.

tags: dict(str, str)

Blobla etiket olarak ilişkili ad-değer çiftleri. Etiketler büyük/küçük harfe duyarlıdır. Etiket kümesi en fazla 10 etiket içerebilir. Etiket anahtarları 1 ile 128 karakter arasında, etiket değerleri ise 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri şunlardır: küçük ve büyük harf, basamak (0-9), boşluk ( >><<), artı (+), eksi (-), nokta (.), solidus (/), iki nokta (:), eşittir (=), alt çizgi (_)

source_content_md5: bytearray

Kaynak baytların bütünlüğünü doğrulamak için kullanılan md5'i belirtin.

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. İşlemi yalnızca kaynak kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi belirtin.

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. yalnızca kaynak kaynak belirtilen tarih/saatten sonra değiştirilmediyse işlemi gerçekleştirmek için bu üst bilgiyi belirtin.

source_etag: str

Kaynak ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

source_match_condition: MatchConditions

Etag'de kullanılacak kaynak eşleştirme koşulu.

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.

etag: str

Hedef ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak hedef eşleşme koşulu.

destination_lease: BlobLeaseClient veya 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).

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

content_settings: ContentSettings

Blob özelliklerini ayarlamak için kullanılan ContentSettings nesnesi. İçerik türü, kodlama, dil, bırakma, md5 ve önbellek denetimini ayarlamak için kullanılır.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

standard_blob_tier: StandardBlobTier

Blobu ayarlanacağı standart blob katmanı değeri. Kitaplığın bu sürümü için bu yalnızca standart depolama hesaplarında blok blobları için geçerlidir.

source_authorization: str

Kaynak bloba erişmek için istemci gizli dizisini kullanarak hizmet sorumlusu olarak kimlik doğrulaması yapın. source_authorization dizesinin ön ekinin "taşıyıcı" olduğundan emin olun.

Sayfaları Karşıya Yükleme işlemi, sayfa blobuna bir dizi sayfa yazar.

upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

Parametreler

page: bytes

Gerekli

Sayfanın içeriği.

offset: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt aralığının başlangıcı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

length: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt sayısı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

validate_content: bool

True ise, sayfa içeriğinin MD5 karması hesaplanır. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https (varsayılan) zaten doğrulandığından https yerine http kullanılıyorsa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz.

if_sequence_number_lte: int

Blob'un sıra numarası belirtilen değerden küçük veya buna eşitse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_lt: int

Blob'un sıra numarası belirtilen değerden küçükse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_eq: int

Blob'un sıra numarası belirtilen değere eşitse istek devam eder; aksi takdirde başarısız 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.

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.

etag: str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

encoding: str

Varsayılan olarak UTF-8'i kullanır.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob tarafından güncelleştirilmiş özellik diktesi (Etag ve son değiştirme).

Dönüş türü

dict(str, Any)

Sayfaları Karşıya Yükle işlemi, içeriklerin URL'den okunduğu sayfa blob'larına bir sayfa aralığı yazar.

upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

Parametreler

source_url: str

Gerekli

Kaynak verilerin URL'si. Ortak olan veya paylaşılan erişim imzası eklenmiş olan herhangi bir Azure Blobu veya Dosyasını işaret edebilir.

offset: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt aralığının başlangıcı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

length: int

Gerekli

Blobun bir bölümüne yazmak için kullanılacak bayt sayısı. Sayfalar 512 baytlık sınırlarla hizalanmalıdır, başlangıç uzaklığı 512 modulu olmalı ve uzunluk 512 modulu olmalıdır.

source_offset: int

Gerekli

Bu, kopyalama kaynağından alınması gereken bayt (dahil) aralığının başlangıcını gösterir. Hizmet, hedef aralıkla (uzunluk uzaklığı) aynı sayıda bayt okur.

source_content_md5: bytes

Verilirse, hizmet blok içeriğinin MD5 karması hesaplar ve bu değerle karşılaştırır.

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. İşlemi yalnızca kaynak kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi belirtin.

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. yalnızca kaynak kaynak belirtilen tarih/saatten sonra değiştirilmediyse işlemi gerçekleştirmek için bu üst bilgiyi belirtin.

source_etag: str

Kaynak ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

source_match_condition: MatchConditions

Etag'de kullanılacak kaynak eşleştirme koşulu.

lease: BlobLeaseClient veya str

Blob etkin bir kiraya sahipse gereklidir. Değer bir BlobLeaseClient nesnesi veya dize olarak kira kimliği olabilir.

if_sequence_number_lte: int

Blob'un sıra numarası belirtilen değerden küçük veya buna eşitse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_lt: int

Blob'un sıra numarası belirtilen değerden küçükse istek devam eder; aksi takdirde başarısız olur.

if_sequence_number_eq: int

Blob'un sıra numarası belirtilen değere eşitse istek devam eder; aksi takdirde başarısız 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.

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.

etag: str

Hedef ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition: MatchConditions

Etag'de kullanılacak hedef eşleşme koşulu.

if_tags_match_condition: str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

cpk: CustomerProvidedEncryptionKey

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.

encryption_scope: str

Hizmet üzerindeki verileri şifrelemek için kullanılan önceden tanımlanmış bir şifreleme kapsamı. Yönetim API'sini kullanarak bir şifreleme kapsamı oluşturulabilir ve burada ada göre başvurulabilir. Kapsayıcıda varsayılan bir şifreleme kapsamı tanımlanmışsa, kapsayıcı düzeyi kapsamı geçersiz kılmalara izin verecek şekilde yapılandırılmışsa bu değer bunu geçersiz kılar. Aksi takdirde bir hata oluşur.

Sürüm 12.2.0'da yeni.

timeout: int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

source_authorization: str

Kaynak bloba erişmek için istemci gizli dizisini kullanarak hizmet sorumlusu olarak kimlik doğrulaması yapın. source_authorization dizesinin ön ekinin "taşıyıcı" olduğundan emin olun.

İstekler için kullanılan Depolama API'sinin sürümü.

İstemcinin şu anda kullandığı konum modu.

Varsayılan olarak bu "birincil" olur. Seçenekler arasında "birincil" ve "ikincil" bulunur.

Tam birincil uç nokta URL'si.

Birincil uç noktanın ana bilgisayar adı.

Yapılandırıldıysa tam ikincil uç nokta URL'si.

Kullanılamıyorsa bir ValueError oluşturulur. İkincil ana bilgisayar adını açıkça belirtmek için, örneklemede isteğe bağlı secondary_hostname anahtar sözcük bağımsız değişkenini kullanın.

Özel durumlar

ValueError

İkincil uç noktanın ana bilgisayar adı.

Kullanılamıyorsa, bu Yok olur. İkincil ana bilgisayar adını açıkça belirtmek için, örneklemede isteğe bağlı secondary_hostname anahtar sözcük bağımsız değişkenini kullanın.

Kullanılırsa SAS belirteci de dahil olmak üzere bu varlığın tam uç nokta URL'si.

Bu birincil uç nokta veya geçerli location_modeöğesine bağlı olarak ikincil uç nokta olabilir. :returns: Kullanıldıysa SAS belirteci de dahil olmak üzere bu varlığa ilişkin tam uç nokta URL'si. :rtype: str

abort_copy	Devam eden kopyalama işlemini iptal edin. Bu, sıfır uzunlukta ve tam meta veri içeren bir hedef blob bırakır. Kopyalama işlemi zaten sona erdiyse bu bir hataya neden olur.
acquire_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 döndürür.
append_block	Mevcut ekleme blobunun sonuna yeni bir veri bloğu işler.
append_block_from_url	İçeriğin bir kaynak URL'den okunduğu blobun parçası olarak işlenecek yeni bir blok oluşturur.
clear_page	Bir sayfa aralığını temizler.
close	Bu yöntem, istemci tarafından açılan yuvaları kapatmaktır. Bağlam yöneticisi ile kullanılırken kullanılması gerekmez.
commit_block_list	Yürütme Bloğu Listesi işlemi, blobu oluşturan blok kimliklerinin listesini belirterek bir blob yazar.
create_append_blob	Yeni bir Ekleme Blobu oluşturur. Bu işlem yeni bir 0 uzunluklu ekleme blobu oluşturur. Yeni başlatılan ekleme blobuyla mevcut blobların içeriğinin üzerine yazılır. Ekleme blob'una içerik eklemek için veya append_block_from_url yöntemini çağırınappend_block.
create_page_blob	Belirtilen boyutta yeni bir Sayfa Blobu oluşturur.
create_snapshot	Blobun anlık görüntüsünü oluşturur. Anlık görüntü, bir blobun belirli bir noktada alınan salt okunur bir sürümüdür. Okunabilir, kopyalanabilir veya silinebilir, ancak değiştirilemez. Anlık görüntüler, bir blobu anında göründüğü şekilde yedeklemek için bir yol sağlar. Bir blobun anlık görüntüsü, anlık görüntünün alındığı temel blobla aynı ada sahiptir ve anlık görüntünün alındığı saati belirten bir DateTime değeri eklenir.
delete_blob	Belirtilen blobu 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. delete_blob() işlemiyle ikisini de aynı anda silebilirsiniz. Hizmet için silme bekletme ilkesi etkinleştirildiyse, bu işlem blobu geçici olarak siler ve blobu belirtilen sayıda gün boyunca saklar. Belirtilen gün sayısından sonra, blobun verileri çöp toplama sırasında hizmetten kaldırılır. Geçici olarak silinen bloba include=['deleted'] seçeneği belirterek list_blobs erişilebilir. Geçici olarak silinen blob, işlem kullanılarak <xref:azure.storage.blob.undelete> geri yüklenebilir.
delete_immutability_policy	Değişmezlik İlkesini Sil işlemi blobdaki değişmezlik ilkesini siler. Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.
download_blob	StorageStreamDownloader'a bir blob indirir. Readall() yöntemi tüm içeriği okumak için kullanılmalıdır veya blobu akışa indirmek için readinto() kullanılmalıdır. chunks() kullanmak, kullanıcının öbeklerdeki içerik üzerinde yineleme yapmasına olanak tanıyan bir yineleyici döndürür.
exists	Tanımlı parametrelerle bir blob varsa True döndürür ve aksi takdirde False döndürür.
from_blob_url	Blob URL'sinden BlobClient oluşturun. Bu, blob adında '/' bulunan özelleştirilmiş blob URL'lerini desteklemez.
from_connection_string	Bağlantı Dizesinden BlobClient oluşturun.
get_account_information	Blob'un bulunduğu depolama hesabıyla ilgili bilgileri alır. Bilgiler, kullanıcının bir kapsayıcıya veya bloba sas'sı varsa da alınabilir. Döndürülen sözlükteki anahtarlar 'sku_name' ve 'account_kind' içerir.
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.
get_blob_tags	Etiketleri Al işlemi, kullanıcıların blob veya belirli bir blob sürümü ya da anlık görüntü üzerinde etiket almasına olanak tanır. Sürüm 12.4.0'da yeni eklendi: Bu işlem '2019-12-12' API sürümünde kullanıma sunulmuştur.
get_block_list	Blok Listesini Al işlemi, bir blok blobunun parçası olarak karşıya yüklenen blokların listesini alır.
get_page_range_diff_for_managed_disk	Yönetilen disk veya anlık görüntü için geçerli sayfa aralıklarının listesini döndürür. Not Bu işlem yalnızca yönetilen disk hesapları için kullanılabilir. Sürüm 12.2.0'da yeni eklendi: Bu işlem '2019-07-07' API sürümünde kullanıma sunulmuştur.
get_page_ranges	KULLANIMDAN KALDıRILDI: Sayfa Blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür.
list_page_ranges	Sayfa Blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür. previous_snapshot belirtilirse, sonuç hedef blob ile önceki anlık görüntü arasındaki değişikliklerin farkını gösterir.
query_blob	Kullanıcıların basit sorgu ifadeleri sağlayarak blob/veya blob anlık görüntü verilerini seçmesini/yansıtmasını sağlar. Bu işlemler bir BlobQueryReader döndürür; kullanıcıların sorgu verilerini almak için readall() veya readinto() kullanması gerekir.
resize_blob	Sayfa blobunu belirtilen boyuta yeniden boyutlandırıyor. Belirtilen değer blobun geçerli boyutundan küçükse, belirtilen değerin üzerindeki tüm sayfalar temizlenir.
seal_append_blob	Seal işlemi, Ekleme Blobunu salt okunur hale getirmek için mühürler. Sürüm 12.4.0'da yeni.
set_blob_metadata	Blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar.
set_blob_tags	Etiketleri Ayarla işlemi, kullanıcıların blob veya belirli bir blob sürümünde etiket ayarlamasına olanak tanır, ancak anlık görüntü ayarlamaz. Bu işleme yapılan her çağrı, bloba eklenen tüm mevcut etiketlerin yerini alır. Blobdaki tüm etiketleri kaldırmak için etiket ayarsız olarak bu işlemi çağırın. Sürüm 12.4.0'da yeni eklendi: Bu işlem '2019-12-12' API sürümünde kullanıma sunulmuştur.
set_http_headers	Blob üzerindeki sistem özelliklerini ayarlar. content_settings için bir özellik ayarlanırsa, tüm özellikler geçersiz kılınacaktır.
set_immutability_policy	Değişmezlik İlkesiNi Ayarla işlemi blob üzerinde değişmezlik ilkesini ayarlar. Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.
set_legal_hold	Yasal Saklamayı Ayarla işlemi blob üzerinde yasal bir saklama ayarlar. Sürüm 12.10.0'da yeni eklendi: Bu işlem '2020-10-02' API sürümünde kullanıma sunulmuştur.
set_premium_page_blob_tier	Blob üzerindeki sayfa blob katmanlarını ayarlar. Bu API yalnızca premium hesaplardaki sayfa blobları için desteklenir.
set_sequence_number	Blob dizisi numarasını ayarlar.
set_standard_blob_tier	Bu işlem katmanı bir blok blobu üzerinde ayarlar. Blok blobu katmanı Sık Erişimli/Seyrek Erişimli/Arşiv depolama türünü belirler. Bu işlem blob'un ETag'ini güncelleştirmez.
stage_block	Blobun parçası olarak işlenecek yeni bir blok oluşturur.
stage_block_from_url	İçeriğin url'den okunduğu bir blobun parçası olarak işlenecek yeni bir blok oluşturur.
start_copy_from_url	Verilen URL'den bir blob kopyalar. Bu işlem, kopyalama işleminin durumunu denetlemek veya durdurmak için kullanılabilecek copy_status ve copy_id içeren bir sözlük döndürür. copy_status , kopya zaman uyumlu olarak tamamlandıysa 'başarılı' veya kopya zaman uyumsuz olarak başlatıldıysa 'beklemede' olur. Zaman uyumsuz kopyalar için, yöntemi yoklama ve kopyalama durumu denetlenerek get_blob_properties durum denetlenebilir. Kopyayı zaman uyumlu olmaya zorlamak için requires_sync True olarak ayarlayın. 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 blobla 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.
undelete_blob	Geçici olarak silinen blobları veya anlık görüntüleri geri yükler. İşlem yalnızca silme bekletme ilkesinde ayarlanan belirtilen gün sayısı içinde kullanıldığında başarılı olur. Blob sürümü oluşturma etkinleştirildiyse, temel blob bu yöntem kullanılarak geri yüklenemez. Bunun yerine geçerli sürüme yükseltmek istediğiniz blob sürümünün URL'siyle kullanın start_copy_from_url .
upload_blob	Otomatik öbekleme ile bir veri kaynağından yeni bir blob oluşturur.
upload_blob_from_url	Blobun içeriğinin belirli bir URL'den okunduğu yeni bir Blok Blobu oluşturur. Mevcut blobun içeriğinin üzerine yeni blob yazılır.
upload_page	Sayfaları Karşıya Yükleme işlemi, sayfa blobuna bir dizi sayfa yazar.
upload_pages_from_url	Sayfaları Karşıya Yükle işlemi, içeriklerin URL'den okunduğu sayfa blob'larına bir sayfa aralığı yazar.

BlobClient Sınıf

Oluşturucu

Parametreler

Yöntemler

abort_copy

Parametreler

Dönüş türü

acquire_lease

Parametreler

Döndürülenler

Dönüş türü

append_block

Parametreler

Döndürülenler

Dönüş türü

append_block_from_url

Parametreler

clear_page

Parametreler

Döndürülenler

Dönüş türü

close

commit_block_list

Parametreler

Döndürülenler

Dönüş türü

create_append_blob

Parametreler

Döndürülenler

Dönüş türü

create_page_blob

Parametreler

Döndürülenler

Dönüş türü

create_snapshot

Parametreler

Döndürülenler

Dönüş türü

delete_blob

Parametreler

Dönüş türü

delete_immutability_policy

Parametreler

Döndürülenler

Dönüş türü

download_blob

Parametreler

Döndürülenler

Dönüş türü

exists

Parametreler

Döndürülenler

Dönüş türü

from_blob_url

Parametreler

Döndürülenler

Dönüş türü

from_connection_string

Parametreler

Döndürülenler

Dönüş türü

get_account_information

Döndürülenler

Dönüş türü

get_blob_properties

Parametreler

Döndürülenler

Dönüş türü

get_blob_tags

Parametreler

Döndürülenler

Dönüş türü

get_block_list

Parametreler

Döndürülenler

Dönüş türü

get_page_range_diff_for_managed_disk

Parametreler

Döndürülenler

Dönüş türü