blob Paket

Paketler

aio

Sınıflar

AccessPolicy	Küme tarafından kullanılan Erişim İlkesi sınıfı ve her hizmette erişim ilkesi yöntemleri alın. Depolanan erişim ilkesi, ilişkili olduğu Paylaşılan Erişim İmzaları için başlangıç saatini, süre sonunu ve izinleri belirtebilir. Kaynağınıza erişimi nasıl denetlemek istediğinize bağlı olarak, bu parametrelerin tümünü depolanan erişim ilkesi içinde belirtebilir ve Paylaşılan Erişim İmzası URL'sinden atlayabilirsiniz. Bunu yapmak, ilişkili imzanın davranışını istediğiniz zaman değiştirmenize ve iptal edebilmenize olanak sağlar. Alternatif olarak, depolanan erişim ilkesinde bir veya daha fazla erişim ilkesi parametresini ve URL'de diğerlerini belirtebilirsiniz. Son olarak, URL'de tüm parametreleri belirtebilirsiniz. Bu durumda, saklı erişim ilkesini kullanarak imzayı iptal edebilir, ancak davranışını değiştiremezsiniz. Paylaşılan Erişim İmzası ve depolanmış erişim ilkesi birlikte imzanın kimliğini doğrulamak için gereken tüm alanları içermelidir. Gerekli alanlar eksikse istek başarısız olur. Benzer şekilde, bir alan hem Paylaşılan Erişim İmzası URL'sinde hem de depolanmış erişim ilkesinde belirtilirse, istek 400 (Hatalı İstek) durum koduyla başarısız olur.
AccountSasPermissions	ResourceTypes generate_account_sas işleviyle ve set_*_acl ile kullanılan AccessPolicies için kullanılacak sınıf. Kaynak erişimi vermek için kullanılabilecek iki tür SAS vardır. Bunlardan biri, belirli bir kaynağa (kaynağa özgü) erişim vermektir. Bir diğeri de belirli bir hesap için hizmetin tamamına erişim vermek ve burada bulunan permalara göre belirli işlemlere izin vermektir.
ArrowDialect	alanı. Azure'a göndermek için tüm gerekli parametrelerin doldurulması gerekir.
BlobAnalyticsLogging	Azure Analytics Günlük ayarları.
BlobBlock	BlockBlob Block sınıfı.
BlobClient	Belirli bir blobla etkileşime geçmek için bir istemci, ancak bu blob henüz mevcut olmayabilir. Daha fazla isteğe bağlı yapılandırma için lütfen buraya tıklayın.
BlobLeaseClient	Yeni bir BlobLeaseClient oluşturur. Bu istemci bir BlobClient veya ContainerClient üzerinde kiralama işlemleri sağlar.
BlobPrefix	Blob özelliklerinin Yinelenebilir bir örneği. Sınırlayıcı kullanıldığında walk_blobs döndürülür. Sanal blob dizini olarak düşünülebilir.
BlobProperties	Blob Özellikleri.
BlobQueryError	Hata, hızlı sorgu işlemi sırasında oluştu.
BlobQueryReader	Sorgu sonuçlarını okumak için bir akış nesnesi.
BlobSasPermissions	İşlevle generate_blob_sas kullanılacak BlobSasPermissions sınıfı.
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ı listelemek, oluşturmak ve silmek için işlemler sağlar. Belirli bir kapsayıcı veya blobla ilgili işlemler için bu varlıklara yönelik istemciler de get_client işlevleri kullanılarak alınabilir. Daha fazla isteğe bağlı yapılandırma için lütfen buraya tıklayın.
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ı içindeki belirli bir blobla ilgili işlemler için bir blob istemcisi işlevi kullanılarak get_blob_client alınabilir. Daha fazla isteğe bağlı yapılandırma için lütfen buraya tıklayın.
ContainerEncryptionScope	Kapsayıcı için varsayılan şifreleme kapsamı yapılandırması. Bu kapsam kapsayıcı içindeki gelecekteki tüm yazma işlemleri için örtük olarak kullanılır, ancak blob işlemi başına geçersiz kılınabilir. Sürüm 12.2.0'da yeni.
ContainerProperties	Blob kapsayıcının özellikler sınıfı. Döndürülen ContainerProperties örnekler bu değerleri bir sözlük arabirimi aracılığıyla kullanıma sunar, örneğin: container_props["last_modified"]. Ayrıca kapsayıcı adı olarak container_props["name"]da kullanılabilir.
ContainerSasPermissions	işleviyle ve ile generate_container_sas kullanılan AccessPolicies için kullanılacak ContainerSasPermissions set_container_access_policysınıfı.
ContentSettings	Blobun içerik ayarları.
CopyProperties	Blob Kopyalama Özellikleri. Bu blob bir Blobu Kopyalama işleminde hiç hedef olmadıysa veya örneğin Blob Özelliklerini Ayarla, Blobu Karşıya Yükle veya İşleme Bloğu Listesi'ni kullanarak sonlandırılan Bir Blobu Kopyala işleminden sonra değiştirilmişse bu özellikler Hiçbiri olur.
CorsRule	CORS, başka bir etki alanındaki kaynaklara erişmek için bir etki alanı altında çalışan bir web uygulamasını etkinleştiren bir HTTP özelliğidir. Web tarayıcıları, bir web sayfasının API'leri farklı etki alanından çağırmasını engelleyen, aynı çıkış noktası ilkesi olarak bilinen bir güvenlik kısıtlaması uygular. CORS, bir etki alanına (çıkış noktası etki alanı) başka etki alanındaki API'leri çağırmasına izin veren güvenli bir yol sağlar.
CustomerProvidedEncryptionKey	Azure Depolama'daki tüm veriler, hesap düzeyinde bir şifreleme anahtarı kullanılarak bekleme durumunda şifrelenir. 2018-06-17 ve daha yeni sürümlerde, depolama hizmetine yönelik isteklerde AES-256 şifreleme anahtarı sağlayarak blob içeriğini ve blob başına uygulama meta verilerini şifrelemek için kullanılan anahtarı yönetebilirsiniz. Müşteri tarafından sağlanan bir anahtar kullandığınızda, Azure Depolama anahtarınızı yönetmez veya kalıcı hale gelmez. Bir bloba veri yazarken, sağlanan anahtar verilerinizi diske yazmadan önce şifrelemek için kullanılır. Şifreleme anahtarının SHA-256 karması blob içeriğiyle birlikte yazılır ve bloba yönelik sonraki tüm işlemlerin aynı şifreleme anahtarını kullandığını doğrulamak için kullanılır. Bu karma, şifreleme anahtarını almak veya blob içeriğinin şifresini çözmek için kullanılamaz. Bir blobu okurken, diskten okuduktan sonra verilerinizin şifresini çözmek için sağlanan anahtar kullanılır. Her iki durumda da, şifreleme veya şifre çözme işlemi tamamlandıktan sonra sağlanan şifreleme anahtarı güvenli bir şekilde atılır.
DelimitedJsonDialect	Blob veri sorgusu için giriş veya çıkış JSON serileştirmesini tanımlar. anahtar sözcük str sınırlayıcısı: Satır ayırıcı karakteri, varsayılan değer ' '
DelimitedTextDialect	Blob sorgu isteği için sınırlandırılmış (CSV) giriş veya çıkış serileştirmesini tanımlar.
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.
FilteredBlob	Filtre Blobları API çağrısından blob bilgileri.
ImmutabilityPolicy	Blob, blob anlık görüntüsü veya blob sürümünün değişmezlik ilkesini ayarlamak için isteğe bağlı parametreler. Sürüm 12.10.0'da yeni eklendi: Bu, '2020-10-02' API sürümünde kullanıma sunulmuştur.
LeaseProperties	Blob Kiralama Özellikleri.
LinearRetry	Doğrusal yeniden deneme. Doğrusal yeniden deneme nesnesi oluşturur.
LocationMode	İsteğin gönderileceği konumu belirtir. Bu mod yalnızca ikincil okuma erişimine izin veren RA-GRS hesapları için geçerlidir. Diğer tüm hesap türleri BİRİnCİl kullanmalıdır.
Metrics	Bloblar için saatlik veya dakikalık toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özeti.
ObjectReplicationPolicy	Bloba uygulanan ilke kimliği ve kural kimlikleri.
ObjectReplicationRule	Bloba uygulanan ilke kimliği ve kural kimlikleri.
PageRange	Sayfa blobu için Sayfa Aralığı.
PartialBatchErrorException	Toplu işlemlerde kısmi bir hata var.
ResourceTypes	Hesap SAS'siyle erişilebilen kaynak türlerini belirtir.
RetentionPolicy	İlişkili verilerin ne kadar süreyle kalıcı olması gerektiğini belirleyen bekletme ilkesi.
StaticWebsite	Bir hesabın statik web sitesi barındırmasını sağlayan özellikler.
StorageStreamDownloader	Azure Depolama'dan indirebileceğiniz bir akış nesnesi.
UserDelegationKey	Kullanıcıya Azure Active Directory erişim belirtecine göre Azure Depolama tarafından sağlanan bir kullanıcı temsilcisi anahtarını temsil eder. Kullanıcının bu nesneyle etkileşim kurması gerekmediğinden alanlar basit dizeler olarak kaydedilir; kullanıcı, tanımlama SAS'sini oluşturmak için bunu doğru API'ye geçirebilir.

Numaralandırmalar

ArrowType
BlobImmutabilityPolicyMode	Blobda ayarlanacağı değişmezlik ilkesi modunu belirtir. "Mutable" yalnızca hizmet tarafından döndürülebilir, "Mutable" olarak ayarlanmayın.
BlobType
BlockState	Blok blobu blok türleri.
PremiumPageBlobTier	Blobu ayarlanacağı sayfa blobu katmanını belirtir. Bu yalnızca premium depolama hesaplarında sayfa blobları için geçerlidir. PageBlobTier başına ilgili IOPS ve aktarım hızı hakkında ayrıntılı bilgi için lütfen şu sayfaya göz atın: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets
PublicAccess	Kapsayıcıdaki verilere genel olarak erişilip erişilemeyeceğini ve erişim düzeyini belirtir.
QuickQueryDialect	Hızlı sorgu giriş/çıkış diyalektini belirtir.
RehydratePriority	Bir nesne yeniden doldurma bekleme durumundaysa, bu üst bilgi yeniden doldurma önceliğiyle döndürülür. Geçerli değerler Yüksek ve Standart'tır.
SequenceNumberAction	Sıra numarası eylemleri.
StandardBlobTier	Blobu ayarlanacağı blob katmanını belirtir. Bu yalnızca standart depolama hesaplarında blok blobları için geçerlidir.
StorageErrorCode

İşlevler

download_blob_from_url

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

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. Bu, sas belirteci de içerebilir.

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 durum açık bir kimlik bilgisi lehine yoksayılır

• Çakışan SAS belirteçlerinin bir ValueError oluşturacağı AzureSasCredential durumu dışında. AzureNamedKeyCredential örneğini kullanıyorsanız 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ış tutamacı 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 (varsayılan) olarak https yerine http kullanıldığında zaten doğrulanacaksa bu, kablodaki bitflip'leri algılamak için öncelikli olarak değerlidir. Bu MD5 karması 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.

Dönüş türü

None

generate_account_sas

Blob hizmeti için paylaşılan erişim imzası oluşturur.

Döndürülen imzayı herhangi bir BlobServiceClient, ContainerClient veya BlobClient'ın kimlik bilgisi parametresiyle kullanın.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parametreler

account_name

str

Gerekli

Paylaşılan erişim imzasını oluşturmak için kullanılan depolama hesabı adı.

account_key

str

Gerekli

Paylaşılan erişim imzasını oluşturmak için paylaşılan anahtar veya erişim anahtarı olarak da adlandırılan hesap anahtarı.

resource_types

str veya ResourceTypes

Gerekli

Hesap SAS'siyle erişilebilen kaynak türlerini belirtir.

permission

str veya AccountSasPermissions

Gerekli

Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı, izinler tarafından izin verilen işlemlerle sınırlıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.

expiry

datetime veya str

Gerekli

Paylaşılan erişim imzasının geçersiz hale geldiği saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

start

datetime veya str

varsayılan değer: None

Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

ip

str

varsayılan değer: None

İsteklerin kabul etmek için bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde ip=168.1.5.65 veya ip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.

protocol

str

Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https'dir.

encryption_scope

str

Tüm yazma işlemlerinin hizmet şifreli olması için yapılan bir isteğin şifreleme kapsamını belirtir.

Döndürülenler

Paylaşılan Erişim İmzası (sas) belirteci.

Dönüş türü

str

generate_blob_sas

Blob için paylaşılan erişim imzası oluşturur.

Döndürülen imzayı herhangi bir BlobServiceClient, ContainerClient veya BlobClient'ın kimlik bilgisi parametresiyle kullanın.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametreler

account_name

str

Gerekli

Paylaşılan erişim imzasını oluşturmak için kullanılan depolama hesabı adı.

container_name

str

Gerekli

Kapsayıcının adı.

blob_name

str

Gerekli

Blobun adı.

snapshot

str

varsayılan değer: None

İsteğe bağlı blob anlık görüntü kimliği.

account_key

str

varsayılan değer: None

Paylaşılan erişim imzasını oluşturmak için paylaşılan anahtar veya erişim anahtarı olarak da adlandırılan hesap anahtarı. account_key veya user_delegation_key belirtilmelidir.

user_delegation_key

UserDelegationKey

varsayılan değer: None

Kullanıcı, hesap paylaşılan anahtarı yerine bir kullanıcı temsilci anahtarı geçirebilir. AAD kimliğiyle kimlik doğrulaması yaparak hizmetten kullanıcı temsilcisi anahtarı alınabilir; bu, çağrılarak get_user_delegation_keygerçekleştirilebilir. Mevcut olduğunda, SAS bunun yerine kullanıcı temsilcisi anahtarıyla imzalanır.

permission

str veya BlobSasPermissions

varsayılan değer: None

Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı, izinler tarafından izin verilen işlemlerle sınırlıdır. İzinler racwdxytmei olarak sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.

expiry

datetime veya str

varsayılan değer: None

Paylaşılan erişim imzasının geçersiz hale geldiği saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

start

datetime veya str

varsayılan değer: None

Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

policy_id

str

varsayılan değer: None

Depolanan erişim ilkesiyle bağıntılı 64 karakter uzunluğunda benzersiz bir değer. Depolanan erişim ilkesi oluşturmak için kullanın set_container_access_policy.

ip

str

varsayılan değer: None

İsteklerin kabul etmek için bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde ip=168.1.5.65 veya ip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.

version_id

str

İsteğe bağlı blob sürümü kimliği. Bu parametre yalnızca sürüm oluşturma özellikli Depolama hesapları için geçerlidir. 'versionid' sorgu parametresinin çıkış SAS'sine dahil edilmediğini unutmayın. Bu nedenle, çıkış SAS'sini kullanarak belirli bir sürümde çalışırken api'lere 'version_id' parametresini sağlayın.

Sürüm 12.4.0'da yeni eklendi: Bu anahtar sözcük bağımsız değişkeni '2019-12-12' API sürümünde kullanıma sunulmuştur.

protocol

str

Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https'dir.

cache_control

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.

content_disposition

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Disposition için yanıt üst bilgisi değeri.

content_encoding

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.

content_language

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.

content_type

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Type için yanıt üst bilgisi değeri.

encryption_scope

str

Tüm yazma işlemlerinin hizmet şifreli olması için yapılan bir isteğin şifreleme kapsamını belirtir.

correlation_id

str

Depolama denetim günlüklerini SAS'yi oluşturan ve dağıtan sorumlu tarafından kullanılan denetim günlükleriyle ilişkilendirmek için bağıntı kimliği. Bu yalnızca temsilci anahtarıyla SAS oluşturulurken kullanılabilir.

Döndürülenler

Paylaşılan Erişim İmzası (sas) belirteci.

Dönüş türü

str

generate_container_sas

Kapsayıcı için paylaşılan erişim imzası oluşturur.

Döndürülen imzayı herhangi bir BlobServiceClient, ContainerClient veya BlobClient kimlik bilgisi parametresiyle kullanın.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametreler

account_name

str

Gerekli

Paylaşılan erişim imzasını oluşturmak için kullanılan depolama hesabı adı.

container_name

str

Gerekli

Kapsayıcının adı.

account_key

str

varsayılan değer: None

Paylaşılan erişim imzasını oluşturmak için paylaşılan anahtar veya erişim anahtarı olarak da adlandırılan hesap anahtarı. account_key veya user_delegation_key belirtilmelidir.

user_delegation_key

UserDelegationKey

varsayılan değer: None

Kullanıcı, hesap paylaşılan anahtarı yerine bir kullanıcı temsilci anahtarı geçirebilir. AAD kimliğiyle kimlik doğrulaması yaparak hizmetten kullanıcı temsilcisi anahtarı alınabilir; bu, çağrılarak get_user_delegation_keygerçekleştirilebilir. Mevcut olduğunda, SAS bunun yerine kullanıcı temsilcisi anahtarıyla imzalanır.

permission

str veya ContainerSasPermissions

varsayılan değer: None

Paylaşılan erişim imzası ile ilişkili izinler. Kullanıcı izinler tarafından izin verilen işlemlerle sınırlıdır. İzinler racwdxyltfmei olarak sıralanmalıdır. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır.

expiry

datetime veya str

varsayılan değer: None

Paylaşılan erişim imzasının geçersiz olduğu saat. Bu alanı içeren bir depolanmış erişim ilkesine başvuruda bulunarak bir kimlik verilmediği sürece gereklidir. İlişkili bir depolanmış erişim ilkesinde belirtilmişse bu alan atlanmalıdır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

start

datetime veya str

varsayılan değer: None

Paylaşılan erişim imzasının geçerli olduğu saat. Belirtilmezse, bu çağrının başlangıç saatinin depolama hizmetinin isteği aldığı zaman olduğu varsayılır. Azure her zaman değerleri UTC'ye dönüştürür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır.

policy_id

str

varsayılan değer: None

Depolanmış erişim ilkesiyle bağıntılı 64 karakter uzunluğunda benzersiz bir değer. Depolanan erişim ilkesi oluşturmak için kullanın set_container_access_policy.

ip

str

varsayılan değer: None

İsteklerin kabul edildiği bir IP adresi veya IP adresi aralığı belirtir. İsteğin kaynaklandığı IP adresi SAS belirtecinde belirtilen IP adresi veya adres aralığıyla eşleşmiyorsa, isteğin kimliği doğrulanmaz. Örneğin, SAS üzerinde ip=168.1.5.65 veya ip=168.1.5.60-168.1.5.70 belirtilmesi isteği bu IP adresleriyle kısıtlar.

protocol

str

Yapılan istek için izin verilen protokolü belirtir. Varsayılan değer https'dir.

cache_control

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.

content_disposition

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Disposition için yanıt üst bilgisi değeri.

content_encoding

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Encoding için yanıt üst bilgisi değeri.

content_language

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde Content-Language için yanıt üst bilgisi değeri.

content_type

str

Bu paylaşılan erişim imzası kullanılarak kaynağa erişildiğinde content-Type için yanıt üst bilgisi değeri.

encryption_scope

str

Tüm yazma işlemlerinin hizmet şifrelenmiş olması için yapılan bir isteğin şifreleme kapsamını belirtir.

correlation_id

str

Depolama denetim günlüklerini SAS'yi oluşturan ve dağıtan sorumlu tarafından kullanılan denetim günlükleriyle ilişkilendirmek için bağıntı kimliği. Bu yalnızca temsilci anahtarıyla SAS oluşturulurken kullanılabilir.

Döndürülenler

Paylaşılan Erişim İmzası (sas) belirteci.

Dönüş türü

str

upload_blob_to_url

Verileri belirli bir URL'ye yükleme

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

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

blob_url

str

Gerekli

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

data

bytes veya str veya Iterable

Gerekli

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

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.

overwrite

bool

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

max_concurrency

int

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

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.

metadata

dict(str,str)

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

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.

encoding

str

Metin giriş olarak sağlandığında kullanılacak kodlama. Varsayılan olarak UTF-8'e ayarlanır.

Döndürülenler

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

Dönüş türü

dict(str, Any)