aio Paket

Sınıflar

BlobClient	Belirli bir blobla etkileşime geçmek için bir istemci, ancak bu blob henüz mevcut olmayabilir.
BlobLeaseClient	Yeni bir BlobLeaseClient oluşturur. Bu istemci bir BlobClient veya ContainerClient üzerinde kiralama işlemleri sağlar.
BlobPrefix	Blob özelliklerinin Yinelenebilir olması. Sınırlayıcı kullanıldığında walk_blobs döndürülür. Sanal blob dizini olarak düşünülebilir.
BlobServiceClient	Blob Hizmeti ile hesap düzeyinde etkileşime geçmek için bir istemci. Bu istemci hesap özelliklerini alıp yapılandırmanın yanı sıra hesap içinde kapsayıcıları listeleme, oluşturma ve silme işlemlerini sağlar. Belirli bir kapsayıcı veya blobla ilgili işlemler için, bu varlıklara yönelik istemciler get_client işlevleri kullanılarak da alınabilir.
ContainerClient	Belirli bir kapsayıcıyla etkileşime geçmek için bir istemci, ancak bu kapsayıcı henüz mevcut olmayabilir. Bu kapsayıcıdaki belirli bir blobla ilgili işlemler için blob istemcisi işlevi kullanılarak get_blob_client alınabilir.
ExponentialRetry	Üstel yeniden deneme. Üstel yeniden deneme nesnesi oluşturur. initial_backoff ilk yeniden deneme için kullanılır. Sonraki yeniden denemeler initial_backoff + increment_power^retry_count saniye sonra yeniden denenir. Örneğin, varsayılan olarak ilk yeniden deneme 15 saniye sonra, saniye (15+3^1) = 18 saniye ve üçüncü sonra (15+3^2) = 24 saniye sonra gerçekleşir.
LinearRetry	Doğrusal yeniden deneme. Doğrusal yeniden deneme nesnesi oluşturur.
StorageStreamDownloader	Azure Depolama'dan indirebileceğiniz bir akış nesnesi.

İşlevler

download_blob_from_url

Blobun içeriğini yerel bir dosyaya veya akışa indirin.

async download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Parametreler

blob_url

str

Gerekli

Blob için tam URI. Buna sas belirteci de dahil olabilir.

output

str veya <xref:<xref:writable stream>>

Gerekli

Verilerin indirileceği yer. Bu, yazılacak bir dosya yolu veya yazılacak açık bir GÇ tanıtıcısı olabilir.

credential

varsayılan değer: None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Blob URL'sinde zaten bir SAS belirteci varsa veya blob genelse 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.

overwrite

bool

Zaten varsa yerel dosyanın üzerine yazılıp yazılmayacağı. Varsayılan değer False'tur . Bu durumda, dosya zaten varsa bir ValueError oluşturulur. True olarak ayarlanırsa, var olan dosyaya yazma girişiminde bulunulacaktır. Bir akış tanıtıcısı geçirilirse, bu değer yoksayılır.

max_concurrency

int

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

offset

int

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

Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdı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 yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, 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.

Dönüş türü

None

upload_blob_to_url

Verileri belirli bir URL'ye yükleme

Veriler blok blobu olarak karşıya yüklenir.

param str blob_url: Blob için tam URI. Buna sas belirteci de dahil olabilir.

param data: Karşıya yüklenecek veriler. Bu bayt, metin, yinelenebilir veya dosya benzeri bir nesne olabilir.

tür verileri: bayt veya str veya Yinelenebilir

async upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> dict[str, Any]

Parametreler

credential

varsayılan değer: None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Blob URL'sinde zaten bir SAS belirteci 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.

paramtype kimlik bilgisi: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long

anahtar sözcük bool üzerine yazma: Karşıya yüklenecek blob'un geçerli verilerin üzerine yazıp yazmayacağı. True ise, upload_blob_to_url var olan verilerin üzerine yazar. False olarak ayarlanırsa işlem ResourceExistsError ile başarısız olur.

anahtar sözcük int max_concurrency: İndirilmesi gereken paralel bağlantı sayısı.

anahtar sözcük int uzunluğu: Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdır.

anahtar sözcük dict(str,str) meta verileri: Blobla meta veri olarak ilişkili ad-değer çiftleri.

anahtar sözcük bool validate_content: 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 yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, 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.

anahtar sözcük str kodlaması: Metin giriş olarak sağlandığında kullanılacak kodlama. Varsayılan olarak UTF-8'e ayarlanır.

döndürür: Blob ile güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)

rtype: dict(str, Any)

blob_url

data