blob Paket

  • Başvuru

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)