BlobServiceClient Sınıf

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.

Devralma

azure.storage.blob._shared.base_client_async.AsyncStorageAccountHostsMixin

BlobServiceClient

azure.storage.blob._blob_service_client.BlobServiceClient

BlobServiceClient

azure.storage.blob._encryption.StorageEncryptionMixin

BlobServiceClient

Oluşturucu

BlobServiceClient(account_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | AsyncTokenCredential | None = None, **kwargs: Any)

Parametreler

account_url

str

Gerekli

Blob depolama hesabının URL'si. URL yolunda bulunan diğer varlıklar (örneğin kapsayıcı veya blob) atılır. Bu URL isteğe bağlı olarak bir SAS belirteci ile doğrulanabilir.

credential

varsayılan değer: None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Hesap 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.

api_version

str

İstekler için kullanılacak Depolama API'sinin sürümü. Varsayılan değer, geçerli SDK ile uyumlu en son hizmet sürümüdür. Eski bir sürüme ayar yapmak özellik uyumluluğunu azaltabilir.

Sürüm 12.2.0'da yeni.

secondary_hostname

str

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

max_block_size

int

Blok blobunu öbeklere yüklemek için en büyük öbek boyutu. Varsayılan olarak 4*1024*1024 veya 4 MB'tır.

max_single_put_size

int

Blob boyutu max_single_put_size küçük veya eşitse, blob yalnızca bir http PUT isteğiyle karşıya yüklenir. Blob boyutu max_single_put_size'den büyükse blob öbekler halinde karşıya yüklenir. Varsayılan olarak 64*1024*1024 veya 64 MB'tır.

min_large_block_upload_threshold

int

Blok blobunu karşıya yüklerken bellek açısından verimli algoritmayı kullanmak için gereken en düşük öbek boyutu. Varsayılan değer: 4*1024*1024+1.

use_byte_buffer

bool

Blok blobu karşıya yüklemeleri için bayt arabelleği kullanın. Varsayılan değer False'tur.

max_page_size

int

Sayfa blobunu karşıya yüklemek için en büyük öbek boyutu. Varsayılan olarak 4*1024*1024 veya 4 MB'tır.

max_single_get_size

int

Tek bir çağrıda indirilecek blob için boyut üst sınırı; aşılan bölüm öbekler halinde indirilir (paralel olabilir). Varsayılan olarak 32*1024*1024 veya 32 MB'tır.

max_chunk_get_size

int

Blob indirmek için kullanılan en büyük öbek boyutu. Varsayılan olarak 4*1024*1024 veya 4 MB'tır.

Yöntemler

close	Bu yöntem, istemci tarafından açılan yuvaları kapatmaktır. Bağlam yöneticisi ile kullanılırken kullanılması gerekmez.
create_container	Belirtilen hesap altında yeni bir kapsayıcı oluşturur. Aynı ada sahip kapsayıcı zaten varsa bir ResourceExistsError oluşturulur. Bu yöntem, yeni oluşturulan kapsayıcıyla etkileşim kuracak bir istemci döndürür.
delete_container	Belirtilen kapsayıcıyı silinmek üzere işaretler. Kapsayıcı ve içindeki tüm bloblar daha sonra çöp toplama sırasında silinir. Kapsayıcı bulunamazsa bir ResourceNotFoundError oluşturulur.
find_blobs_by_tags	Blobları Filtrele işlemi, çağıranların etiketleri belirli bir arama ifadesiyle eşleşen tüm kapsayıcılardaki blobları listelemesini sağlar. Filtre blobları, bir depolama hesabı içindeki tüm kapsayıcılarda arama yapabilir ancak ifadenin kapsamı tek bir kapsayıcı olarak değiştirilebilir.
from_connection_string	Bağlantı Dizesinden BlobServiceClient oluşturun.
get_account_information	Depolama hesabıyla ilgili bilgileri alır. Bilgiler, kullanıcının bir kapsayıcı veya blob için SAS'sine sahip olması durumunda da alınabilir. Döndürülen sözlükteki anahtarlar 'sku_name' ve 'account_kind' içerir.
get_blob_client	Belirtilen blobla etkileşime geçmek için bir istemci alın. Blob zaten mevcut değil.
get_container_client	Belirtilen kapsayıcıyla etkileşime geçmek için bir istemci alın. Kapsayıcının zaten mevcut olması gerekmez.
get_service_properties	Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini alır.
get_service_stats	Blob hizmeti için çoğaltmayla ilgili istatistikleri alır. Yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde kullanılabilir. Coğrafi olarak yedekli çoğaltma ile Azure Depolama, verilerinizi iki konumda dayanıklı tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını korur. Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Klasik Azure portalı aracılığıyla hesap oluştururken seçtiğiniz bölgede (örneğin, Orta Kuzey ABD) bulunur. Verilerinizin çoğaltıldığı konum ikincil konumdur. İkincil konum, birincil konumuna göre otomatik olarak belirlenir; birincil konumla aynı bölgede bulunan ikinci bir veri merkezindedir. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir.
get_user_delegation_key	SAS belirteçlerini imzalama amacıyla bir kullanıcı temsilcisi anahtarı alın. Bu isteğin başarılı olması için hizmet nesnesinde bir belirteç kimlik bilgisi bulunmalıdır.
list_containers	Belirtilen hesabın altındaki kapsayıcıları listelemek için bir oluşturucu döndürür. Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gizlice izler ve tüm kapsayıcılar döndürdüğünde durur.
set_service_properties	Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini ayarlar. Bir öğe (örneğin analytics_logging) Yok olarak bırakılırsa, söz konusu işlev için hizmette var olan ayarlar korunur.
undelete_container	Geçici olarak silinen kapsayıcıyı geri yükler. İşlem yalnızca silme bekletme ilkesinde ayarlanan belirtilen gün sayısı içinde kullanıldığında başarılı olur. Sürüm 12.4.0'da yeni eklendi: Bu işlem '2019-12-12' API sürümünde kullanıma sunulmuştur.

close

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

async close()

create_container

Belirtilen hesap altında yeni bir kapsayıcı oluşturur.

Aynı ada sahip kapsayıcı zaten varsa bir ResourceExistsError oluşturulur. Bu yöntem, yeni oluşturulan kapsayıcıyla etkileşim kuracak bir istemci döndürür.

async create_container(name: str, metadata: Dict[str, str] | None = None, public_access: PublicAccess | str | None = None, **kwargs) -> ContainerClient

Parametreler

name

str

Gerekli

Oluşturulacak kapsayıcının adı.

metadata

dict(str, str)

Gerekli

Kapsayıcıyla meta veri olarak ilişkilendirilecek ad-değer çiftlerine sahip bir dikte. Örnek: {'Category':'test'}

public_access

str veya PublicAccess

Gerekli

Olası değerler şunlardır: 'kapsayıcı', 'blob'.

container_encryption_scope

dict veya ContainerEncryptionScope

Kapsayıcıda ayarlanıp gelecekteki tüm yazma işlemleri için kullanılacak varsayılan şifreleme kapsamını belirtir.

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önüş türü

ContainerClient

delete_container

Belirtilen kapsayıcıyı silinmek üzere işaretler.

Kapsayıcı ve içindeki tüm bloblar daha sonra çöp toplama sırasında silinir. Kapsayıcı bulunamazsa bir ResourceNotFoundError oluşturulur.

async delete_container(container: ContainerProperties | str, lease: BlobLeaseClient | str | None = None, **kwargs) -> None

Parametreler

container

str veya ContainerProperties

Gerekli

Silinecek kapsayıcı. Bu kapsayıcının adı veya ContainerProperties örneği olabilir.

lease

Gerekli

Belirtilirse, delete_container yalnızca kapsayıcının kirası etkinse ve bu kimlikle eşleşiyorsa başarılı olur. Kapsayıcının etkin bir kirası varsa gereklidir.

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. İş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önüş türü

None

find_blobs_by_tags

Blobları Filtrele işlemi, çağıranların etiketleri belirli bir arama ifadesiyle eşleşen tüm kapsayıcılardaki blobları listelemesini sağlar. Filtre blobları, bir depolama hesabı içindeki tüm kapsayıcılarda arama yapabilir ancak ifadenin kapsamı tek bir kapsayıcı olarak değiştirilebilir.

find_blobs_by_tags(filter_expression: str, **kwargs: Any) -> AsyncItemPaged[FilteredBlob]

Parametreler

filter_expression

str

Gerekli

Etiketleri belirtilen koşulla eşleşen blobları bulma ifadesi. Örneğin ""yourtagname"='firsttag' and "yourtagname2"='secondtag'" Kapsayıcı belirtmek için, örneğin. "@container='containerName' ve "Name"='C'"

results_per_page

int

Sayfalandırma sırasında sayfa başına en yüksek sonuç.

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'in yinelenebilir (otomatik sayfalama) yanıtı.

Dönüş türü

AsyncItemPaged[FilteredBlob]

from_connection_string

Bağlantı Dizesinden BlobServiceClient oluşturun.

from_connection_string(conn_str: str, 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.

credential

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ı dizesinde 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ı dizesindeki kimlik bilgilerine göre önceliklidir. AzureNamedKeyCredential örneğini kullanıyorsanız depolama hesabı adı "name" ve depolama hesabı anahtarı "anahtar" olmalıdır.

Döndürülenler

Blob hizmeti istemcisi.

Dönüş türü

BlobServiceClient

get_account_information

Depolama hesabıyla ilgili bilgileri alır.

Bilgiler, kullanıcının bir kapsayıcı veya blob için SAS'sine sahip olması durumunda da alınabilir. Döndürülen sözlükteki anahtarlar 'sku_name' ve 'account_kind' içerir.

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

Döndürülenler

Hesap bilgilerinin bir dict'i (SKU ve hesap türü).

Dönüş türü

dict(str, str)

get_blob_client

Belirtilen blobla etkileşime geçmek için bir istemci alın.

Blob zaten mevcut değil.

get_blob_client(container: ContainerProperties | str, blob: BlobProperties | str, snapshot: Dict[str, Any] | str | None = None, *, version_id: str | None = None) -> BlobClient

Parametreler

container

str veya ContainerProperties

Gerekli

Blob'un içinde olduğu kapsayıcı. Bu kapsayıcının adı veya ContainerProperties örneği olabilir.

blob

str veya BlobProperties

Gerekli

Etkileşim kurulacak blob. Bu blobun adı veya BlobProperties örneği olabilir.

snapshot

str veya dict(str, Any)

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ünün kimliği veya tarafından create_snapshotdöndürülen bir sözlük çıktısı olabilir.

version_id

str

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

Döndürülenler

A BlobClient.

Dönüş türü

BlobClient

get_container_client

Belirtilen kapsayıcıyla etkileşime geçmek için bir istemci alın.

Kapsayıcının zaten mevcut olması gerekmez.

get_container_client(container: ContainerProperties | str) -> ContainerClient

Parametreler

container

str veya ContainerProperties

Gerekli

Kapsayıcı. Bu kapsayıcının adı veya ContainerProperties örneği olabilir.

Döndürülenler

Bir ContainerClient.

Dönüş türü

ContainerClient

get_service_properties

Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini alır.

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

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 izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Analiz günlüğü, saat/dakika ölçümleri, cors kuralları vb. gibi blob hizmeti özelliklerini içeren bir nesne.

Dönüş türü

Dict[str, Any]

get_service_stats

Blob hizmeti için çoğaltmayla ilgili istatistikleri alır.

Yalnızca depolama hesabı için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde kullanılabilir.

Coğrafi olarak yedekli çoğaltma ile Azure Depolama, verilerinizi iki konumda dayanıklı tutar. Her iki konumda da Azure Depolama sürekli olarak verilerinizin birden çok iyi durumdaki çoğaltmasını korur. Verileri okuduğunuz, oluşturduğunuz, güncelleştirdiğiniz veya sildiğiniz konum birincil depolama hesabı konumudur. Birincil konum, Azure Yönetimi Klasik Azure portalı aracılığıyla hesap oluştururken seçtiğiniz bölgede (örneğin, Orta Kuzey ABD) bulunur. Verilerinizin çoğaltıldığı konum ikincil konumdur. İkincil konum, birincil konumuna göre otomatik olarak belirlenir; birincil konumla aynı bölgede bulunan ikinci bir veri merkezindedir. Depolama hesabınız için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiyse, ikincil konumdan salt okunur erişim kullanılabilir.

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

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 izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Blob hizmeti istatistikleri.

Dönüş türü

Dict[str, Any]

get_user_delegation_key

SAS belirteçlerini imzalama amacıyla bir kullanıcı temsilcisi anahtarı alın. Bu isteğin başarılı olması için hizmet nesnesinde bir belirteç kimlik bilgisi bulunmalıdır.

async get_user_delegation_key(key_start_time: datetime, key_expiry_time: datetime, **kwargs: Any) -> UserDelegationKey

Parametreler

key_start_time

datetime

Gerekli

Bir DateTime değeri. Anahtarın ne zaman geçerli olduğunu gösterir.

key_expiry_time

datetime

Gerekli

Bir DateTime değeri. Anahtarın geçerli olmayı ne zaman durdurdığını gösterir.

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

Kullanıcı temsilcisi anahtarı.

Dönüş türü

UserDelegationKey

list_containers

Belirtilen hesabın altındaki kapsayıcıları listelemek için bir oluşturucu döndürür.

Oluşturucu, hizmet tarafından döndürülen devamlılık belirteçlerini gizlice izler ve tüm kapsayıcılar döndürdüğünde durur.

list_containers(name_starts_with: str | None = None, include_metadata: bool | None = False, **kwargs) -> AsyncItemPaged[ContainerProperties]

Parametreler

name_starts_with

str

Gerekli

Sonuçları yalnızca adları belirtilen ön ek ile başlayan kapsayıcıları döndürecek şekilde filtreler.

include_metadata

bool

Gerekli

Yanıtta döndürülecek kapsayıcı meta verilerini belirtir. Varsayılan değer False'tur.

include_deleted

bool

Silinen kapsayıcıların yanıtta döndürüleceklerini belirtir. Bu, kapsayıcı geri yükleme özelliğinin etkinleştirildiği hesap içindir. Varsayılan değer False'tur. .. versionadded:: 12.4.0

include_system

bool

Sistem kapsayıcılarının dahil edilmesi gerektiğini belirten bayrak. .. versionadded:: 12.10.0

results_per_page

int

API çağrısı başına alınacak kapsayıcı adı sayısı üst sınırı. İstek belirtmezse sunucu en fazla 5.000 öğe döndürü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

ContainerProperties'in yinelenebilir (otomatik sayfalama).

Dönüş türü

AsyncItemPaged[ContainerProperties]

set_service_properties

Azure Depolama Analizi dahil olmak üzere depolama hesabının Blob hizmetinin özelliklerini ayarlar.

Bir öğe (örneğin analytics_logging) Yok olarak bırakılırsa, söz konusu işlev için hizmette var olan ayarlar korunur.

async set_service_properties(analytics_logging: BlobAnalyticsLogging | None = None, hour_metrics: Metrics | None = None, minute_metrics: Metrics | None = None, cors: List[CorsRule] | None = None, target_version: str | None = None, delete_retention_policy: RetentionPolicy | None = None, static_website: StaticWebsite | None = None, **kwargs) -> None

Parametreler

analytics_logging

BlobAnalyticsLogging

Gerekli

Azure Analytics Günlük ayarlarını gruplandırın.

hour_metrics

Metrics

Gerekli

Saatlik ölçüm ayarları, bloblar için saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.

minute_metrics

Metrics

Gerekli

Dakika ölçüm ayarları bloblar için her dakika için istek istatistikleri sağlar.

cors

list[CorsRule]

Gerekli

Listeye en fazla beş CorsRule öğesi ekleyebilirsiniz. Boş bir liste belirtilirse, tüm CORS kuralları silinir ve hizmet için CORS devre dışı bırakılır.

target_version

str

Gerekli

Gelen isteğin sürümü belirtilmezse istekler için kullanılacak varsayılan sürümü gösterir.

delete_retention_policy

RetentionPolicy

Gerekli

Silme bekletme ilkesi silinen blobların tutulup tutulmayacağını belirtir. Ayrıca blobun tutulacak gün sayısını ve sürümlerini belirtir.

static_website

StaticWebsite

Gerekli

Statik web sitesi özelliğinin etkinleştirilip etkinleştirilmediğini belirtir ve evet ise, kullanılacak dizin belgesini ve 404 hata belgesini gösterir.

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önüş türü

None

undelete_container

Geçici olarak silinen kapsayıcıyı geri yükler.

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

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

async undelete_container(deleted_container_name: str, deleted_container_version: str, **kwargs: Any) -> ContainerClient

Parametreler

deleted_container_name

str

Gerekli

Geri yükleneceği silinen kapsayıcının adını belirtir.

deleted_container_version

str

Gerekli

Geri yükleneceği silinen kapsayıcının sürümünü belirtir.

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

Kurtarılan geçici olarak silinen ContainerClient.

Dönüş türü

ContainerClient

Öznitelikler

api_version

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

location_mode

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

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

primary_endpoint

Tam birincil uç nokta URL'si.

primary_hostname

Birincil uç noktanın ana bilgisayar adı.

secondary_endpoint

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

Kullanılabilir değilse 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

secondary_hostname

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

url

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

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