BlobServiceClient Osztály

Egy ügyfél, amely a blobszolgáltatással a fiók szintjén kommunikál.

Ez az ügyfél műveleteket biztosít a fióktulajdonságok lekéréséhez és konfigurálásához, valamint a fiókon belüli tárolók létrehozásához és törléséhez. Egy adott tárolóhoz vagy blobhoz kapcsolódó műveletek esetén az entitások ügyfelei a get_client függvényekkel is lekérhetők.

További választható konfigurációért kattintson ide.

Öröklődés

azure.storage.blob._shared.base_client.StorageAccountHostsMixin

BlobServiceClient

azure.storage.blob._encryption.StorageEncryptionMixin

BlobServiceClient

Konstruktor

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

Paraméterek

account_url

str

Kötelező

A Blob Storage-fiók URL-címe. Az URL-cím elérési útjában szereplő egyéb entitások (például tároló vagy blob) elvetve lesznek. Ez az URL opcionálisan hitelesíthető SAS-jogkivonattal.

credential

alapértelmezett érték: None

A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a fiók URL-címe már rendelkezik SAS-jogkivonattal. Az érték lehet SAS-jogkivonat-sztring, egy AzureSasCredential vagy AzureNamedKeyCredential példánya az azure.core.credentials-ből, egy fiók megosztott hozzáférési kulcsa vagy az azure.identity tokencredentials osztályának egy példánya. Ha az erőforrás URI-ja már tartalmaz SAS-jogkivonatot, a rendszer ezt figyelmen kívül hagyja egy explicit hitelesítő adat javára.

• kivéve az AzureSasCredential esetében, ahol az ütköző SAS-jogkivonatok ValueError értéket fognak létrehozni. Ha azureNamedKeyCredential-példányt használ, a "név" a tárfiók neve, a "kulcs" pedig a tárfiók kulcsa.

api_version

str

A kérésekhez használandó Storage API-verzió. Az alapértelmezett érték az aktuális SDK-val kompatibilis legújabb szolgáltatásverzió. A régebbi verzióra való beállítás csökkentett funkciókompatibilitást eredményezhet.

Új a 12.2.0-s verzióban.

secondary_hostname

str

A másodlagos végpont állomásneve.

max_block_size

int

A blokkblobok adattömbökben való feltöltésének maximális adatmennyisége. Alapértelmezés szerint 4*1024*1024 vagy 4 MB.

max_single_put_size

int

Ha a blob mérete kisebb vagy egyenlő max_single_put_size, akkor a blob feltöltése csak egy HTTP PUT kéréssel történik. Ha a blob mérete nagyobb, mint max_single_put_size, a blob adattömbökbe lesz feltöltve. Alapértelmezés szerint 64*1024*1024 vagy 64 MB.

min_large_block_upload_threshold

int

A blokkblob feltöltésekor a memóriahatékony algoritmus használatához szükséges minimális adattömbméret. Alapértelmezés szerint 4*1024*1024+1.

use_byte_buffer

bool

Használjon bájtpuffert a blokkblobok feltöltéséhez. Alapértelmezés szerint Hamis.

max_page_size

int

Az oldalblobok feltöltésének maximális adattömbmérete. Alapértelmezés szerint 4*1024*1024 vagy 4 MB.

max_single_get_size

int

Az egyetlen hívásban letöltendő blob maximális mérete, a túllépett rész adattömbökben lesz letöltve (párhuzamos lehet). Alapértelmezés szerint 32*1024*1024 vagy 32 MB.

max_chunk_get_size

int

A blob letöltéséhez használt maximális adattömbméret. Alapértelmezés szerint 4*1024*1024 vagy 4 MB.

Metódusok

close	Ezzel a módszerrel zárja be az ügyfél által megnyitott szoftvercsatornákat. A környezetkezelővel való használathoz nem szükséges használni.
create_container	Létrehoz egy új tárolót a megadott fiók alatt. Ha az azonos nevű tároló már létezik, létrejön egy ResourceExistsError. Ez a metódus egy ügyfelet ad vissza, amellyel az újonnan létrehozott tárolót használhatja.
delete_container	Megjelöli a megadott tárolót törlésre. A tároló és a benne található blobok később törlődnek a szemétgyűjtés során. Ha a tároló nem található, létrejön egy ResourceNotFoundError.
find_blobs_by_tags	A Blobok szűrése művelet lehetővé teszi, hogy a hívók az összes olyan tárolóban listáztassák a blobokat, amelyek címkéi megegyeznek egy adott keresési kifejezéssel. A szűrőblobok a tárfiók összes tárolójában keresnek, de a kifejezésen belül egyetlen tárolóra is kiterjedhetnek.
from_connection_string	BlobServiceClient létrehozása kapcsolati sztringből.
get_account_information	Lekéri a tárfiókkal kapcsolatos információkat. Az információk akkor is lekérhetők, ha a felhasználó SAS-sel rendelkezik egy tárolóhoz vagy blobhoz. A visszaadott szótárban szereplő kulcsok közé tartozik a "sku_name" és a "account_kind".
get_blob_client	Kérje le az ügyfelet, hogy használja a megadott blobot. A blobnak még nem kell léteznie.
get_container_client	Kérje le az ügyfelet, hogy kommunikáljon a megadott tárolóval. A tárolónak még nem kell léteznie.
get_service_properties	Lekéri egy tárfiók Blob szolgáltatásának tulajdonságait, beleértve az Azure Storage Analytics.
get_service_stats	Lekéri a Blob szolgáltatás replikációval kapcsolatos statisztikáit. Ez csak akkor érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókban. A georedundáns replikációval az Azure Storage két helyen tartja tartósan az adatokat. Az Azure Storage mindkét helyen folyamatosan több kifogástalan állapotú replikát tart fenn az adatokból. Az adatok olvasási, létrehozási, frissítési vagy törlési helye az elsődleges tárfiók helye. Az elsődleges hely a fiók létrehozásakor kiválasztott régióban található a klasszikus Azure Azure-portálon keresztül, például az USA északi középső régiója. Az adatok replikálásának helye a másodlagos hely. A másodlagos hely automatikusan meg lesz határozva az elsődleges hely alapján; egy második adatközpontban található, amely ugyanabban a régióban található, mint az elsődleges hely. Az írásvédett hozzáférés a másodlagos helyről érhető el, ha az írásvédett georedundáns replikáció engedélyezve van a tárfiókban.
get_user_delegation_key	Szerezzen be egy felhasználódelegálási kulcsot SAS-jogkivonatok aláírása céljából. A kérés sikeres végrehajtásához jelen kell lennie egy jogkivonat hitelesítő adatainak a szolgáltatásobjektumon.
list_containers	Egy generátort ad vissza a megadott fiókban lévő tárolók listázásához. A generátor lazán követi a szolgáltatás által visszaadott folytatási jogkivonatokat, és leáll az összes tároló visszaadásakor.
set_service_properties	Beállítja a tárfiók Blob szolgáltatásának tulajdonságait, beleértve az Azure Storage Analytics. Ha egy elem (például analytics_logging) Nincs értéken marad, a szolgáltatás meglévő beállításai megmaradnak a funkcióhoz.
undelete_container	Helyreállíthatóan törölt tároló visszaállítása. A művelet csak akkor lesz sikeres, ha a törlési adatmegőrzési szabályzatban megadott számú napon belül használják. A 12.4.0-s verzió újdonságai: Ez a művelet a "2019-12-12" API-verzióban jelent meg.

close

Ezzel a módszerrel zárja be az ügyfél által megnyitott szoftvercsatornákat. A környezetkezelővel való használathoz nem szükséges használni.

close()

create_container

Létrehoz egy új tárolót a megadott fiók alatt.

Ha az azonos nevű tároló már létezik, létrejön egy ResourceExistsError. Ez a metódus egy ügyfelet ad vissza, amellyel az újonnan létrehozott tárolót használhatja.

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

Paraméterek

name

str

Kötelező

A létrehozandó tároló neve.

metadata

dict(str, str)

Kötelező

Egy név-érték párokkal rendelkező diktálás, amely metaadatként társítja a tárolót. Példa: {'Category':'test'}

public_access

str vagy PublicAccess

Kötelező

A lehetséges értékek a következők: "tároló", "blob".

container_encryption_scope

dict vagy ContainerEncryptionScope

Megadja a tárolón beállítandó alapértelmezett titkosítási hatókört, és az összes jövőbeli íráshoz használható.

Új a 12.2.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Visszatérési típus

ContainerClient

delete_container

Megjelöli a megadott tárolót törlésre.

A tároló és a benne található blobok később törlődnek a szemétgyűjtés során. Ha a tároló nem található, létrejön egy ResourceNotFoundError.

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

Paraméterek

container

str vagy ContainerProperties

Kötelező

A törölni kívánt tároló. Ez lehet a tároló neve vagy a ContainerProperties példánya.

lease

Kötelező

Ha meg van adva, delete_container csak akkor sikerül, ha a tároló bérlete aktív, és megfelel ennek az azonosítónak. Akkor szükséges, ha a tároló rendelkezik aktív bérletel.

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

etag

str

ETag-érték vagy helyettesítő karakter (*). Annak ellenőrzésére szolgál, hogy az erőforrás megváltozott-e, és a match_condition paraméter által megadott feltételnek megfelelően jár-e el.

match_condition

MatchConditions

Az etagen használni kívánt egyeztetési feltétel.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Visszatérési típus

None

find_blobs_by_tags

A Blobok szűrése művelet lehetővé teszi, hogy a hívók az összes olyan tárolóban listáztassák a blobokat, amelyek címkéi megegyeznek egy adott keresési kifejezéssel. A szűrőblobok a tárfiók összes tárolójában keresnek, de a kifejezésen belül egyetlen tárolóra is kiterjedhetnek.

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

Paraméterek

filter_expression

str

Kötelező

Az a kifejezés, amely megkeresi azokat a blobokat, amelyek címkéi megegyeznek a megadott feltétellel. például: ""yourtagname"='firsttag' és "yourtagname2"='secondtag'" Tároló megadásához például. "@container='containerName' és "Name"='C'"

results_per_page

int

Oldalszámozáskor az oldalenkénti maximális eredmény.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

A BlobProperties iterable (automatikus lapozás) válasza.

Visszatérési típus

ItemPaged[FilteredBlob]

from_connection_string

BlobServiceClient létrehozása kapcsolati sztringből.

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

Paraméterek

conn_str

str

Kötelező

Egy Azure Storage-fiókra kapcsolati sztring.

credential

alapértelmezett érték: None

A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a fiók URL-címe már rendelkezik SAS-jogkivonattal, vagy a kapcsolati sztring már rendelkezik közös hozzáférési kulcsértékekkel. Az érték lehet SAS-jogkivonat-sztring, az AzureSasCredential vagy az AzureNamedKeyCredential példánya az azure.core.credentials-ből, egy fiók megosztott hozzáférési kulcsa vagy az azure.identity tokencredentials osztályának egy példánya. Az itt megadott hitelesítő adatok elsőbbséget élveznek a kapcsolati sztring. Ha az AzureNamedKeyCredential egy példányát használja, a "name" legyen a tárfiók neve, a "kulcs" pedig a tárfiók kulcsa.

Válaszok

Egy Blob-szolgáltatásügyfél.

Visszatérési típus

BlobServiceClient

get_account_information

Lekéri a tárfiókkal kapcsolatos információkat.

Az információk akkor is lekérhetők, ha a felhasználó SAS-sel rendelkezik egy tárolóhoz vagy blobhoz. A visszaadott szótárban szereplő kulcsok közé tartozik a "sku_name" és a "account_kind".

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

Válaszok

A fiókadatok (termékváltozat és fióktípus) diktálása.

Visszatérési típus

dict(str, str)

get_blob_client

Kérje le az ügyfelet, hogy használja a megadott blobot.

A blobnak még nem kell léteznie.

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

Paraméterek

container

str vagy ContainerProperties

Kötelező

A tároló, amelyben a blob található. Ez lehet a tároló neve vagy a ContainerProperties egy példánya.

blob

str vagy BlobProperties

Kötelező

Az a blob, amellyel kommunikálni szeretne. Ez lehet a blob neve vagy a BlobProperties egy példánya.

snapshot

str vagy dict(str, Any)

alapértelmezett érték: None

Az opcionális blobpillanatkép, amelyen működni szeretne. Ez lehet a pillanatkép azonosítója, vagy a által visszaadott create_snapshotszótárkimenet.

version_id

str

A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a blob azon verzióját, amelyen működni kíván.

Válaszok

Egy BlobClient.

Visszatérési típus

BlobClient

get_container_client

Kérje le az ügyfelet, hogy kommunikáljon a megadott tárolóval.

A tárolónak még nem kell léteznie.

get_container_client(container: ContainerProperties | str) -> ContainerClient

Paraméterek

container

str vagy ContainerProperties

Kötelező

A tároló. Ez lehet a tároló neve vagy a ContainerProperties egy példánya.

Válaszok

Egy ContainerClient.

Visszatérési típus

ContainerClient

get_service_properties

Lekéri egy tárfiók Blob szolgáltatásának tulajdonságait, beleértve az Azure Storage Analytics.

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

Paraméterek

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

Blobszolgáltatás-tulajdonságokat, például elemzési naplózást, óra/perc metrikákat, cors-szabályokat stb. tartalmazó objektum.

Visszatérési típus

Dict[str, Any]

get_service_stats

Lekéri a Blob szolgáltatás replikációval kapcsolatos statisztikáit.

Ez csak akkor érhető el, ha az olvasási hozzáférés georedundáns replikációja engedélyezve van a tárfiókban.

A georedundáns replikációval az Azure Storage két helyen tartja tartósan az adatokat. Az Azure Storage mindkét helyen folyamatosan több kifogástalan állapotú replikát tart fenn az adatokból. Az adatok olvasási, létrehozási, frissítési vagy törlési helye az elsődleges tárfiók helye. Az elsődleges hely a fiók létrehozásakor kiválasztott régióban található a klasszikus Azure Azure-portálon keresztül, például az USA északi középső régiója. Az adatok replikálásának helye a másodlagos hely. A másodlagos hely automatikusan meg lesz határozva az elsődleges hely alapján; egy második adatközpontban található, amely ugyanabban a régióban található, mint az elsődleges hely. Az írásvédett hozzáférés a másodlagos helyről érhető el, ha az írásvédett georedundáns replikáció engedélyezve van a tárfiókban.

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

Paraméterek

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

A blobszolgáltatás statisztikái.

Visszatérési típus

Dict[str, Any]

get_user_delegation_key

Szerezzen be egy felhasználódelegálási kulcsot SAS-jogkivonatok aláírása céljából. A kérés sikeres végrehajtásához jelen kell lennie egy jogkivonat hitelesítő adatainak a szolgáltatásobjektumon.

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

Paraméterek

key_start_time

datetime

Kötelező

DateTime érték. Azt jelzi, hogy mikor válik érvényessé a kulcs.

key_expiry_time

datetime

Kötelező

DateTime érték. Azt jelzi, hogy a kulcs mikor áll le.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

A felhasználódelegálási kulcs.

Visszatérési típus

UserDelegationKey

list_containers

Egy generátort ad vissza a megadott fiókban lévő tárolók listázásához.

A generátor lazán követi a szolgáltatás által visszaadott folytatási jogkivonatokat, és leáll az összes tároló visszaadásakor.

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

Paraméterek

name_starts_with

str

Kötelező

Az eredményeket úgy szűri, hogy csak azokat a tárolókat adja vissza, amelyeknek a neve a megadott előtaggal kezdődik.

include_metadata

bool

Kötelező

Megadja, hogy a válaszban visszaadandó tároló-metaadatok. Az alapértelmezett érték a Hamis.

include_deleted

bool

Megadja, hogy a törölt tárolók vissza legyenek adva a válaszban. Ez a tároló-visszaállítást engedélyező fiókhoz tartozik. Az alapértelmezett érték a Hamis. .. versionadded:: 12.4.0

include_system

bool

A rendszertárolók belefoglalását jelölő. .. versionadded:: 12.10.0

results_per_page

int

Az API-hívásonként lekérhető tárolónevek maximális száma. Ha a kérés nem adja meg, a kiszolgáló legfeljebb 5000 elemet ad vissza.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

A ContainerProperties iterable (automatikus lapozás) eleme.

Visszatérési típus

ItemPaged[ContainerProperties]

set_service_properties

Beállítja a tárfiók Blob szolgáltatásának tulajdonságait, beleértve az Azure Storage Analytics.

Ha egy elem (például analytics_logging) Nincs értéken marad, a szolgáltatás meglévő beállításai megmaradnak a funkcióhoz.

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

Paraméterek

analytics_logging

BlobAnalyticsLogging

Kötelező

Az Azure Analytics naplózási beállításainak csoportosítása.

hour_metrics

Metrics

Kötelező

Az órametrikák beállításai az API-k szerint csoportosított kérelemstatisztikák összegzését biztosítják a blobok óránkénti összesítésében.

minute_metrics

Metrics

Kötelező

A percmetrikák beállításai a blobok minden percére vonatkozóan kérésstatisztikát biztosítanak.

cors

list[CorsRule]

Kötelező

A listában legfeljebb öt CorsRule-elem szerepelhet. Ha egy üres lista van megadva, az összes CORS-szabály törlődik, és a CORS le lesz tiltva a szolgáltatáshoz.

target_version

str

Kötelező

Azt az alapértelmezett verziót jelzi, amelyet a kérelmekhez használni kell, ha a bejövő kérés verziója nincs megadva.

delete_retention_policy

RetentionPolicy

Kötelező

A törlési adatmegőrzési szabályzat határozza meg, hogy meg kívánja-e őrizni a törölt blobokat. A blobok megtartandó napjainak és verzióinak számát is meghatározza.

static_website

StaticWebsite

Kötelező

Megadja, hogy a statikus webhely szolgáltatás engedélyezve van-e, és ha igen, akkor az indexdokumentumot és a 404-et használó hibadokumentumot jelzi.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Visszatérési típus

None

undelete_container

Helyreállíthatóan törölt tároló visszaállítása.

A művelet csak akkor lesz sikeres, ha a törlési adatmegőrzési szabályzatban megadott számú napon belül használják.

A 12.4.0-s verzió újdonságai: Ez a művelet a "2019-12-12" API-verzióban jelent meg.

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

Paraméterek

deleted_container_name

str

Kötelező

Megadja a visszaállítani kívánt törölt tároló nevét.

deleted_container_version

str

Kötelező

A visszaállítandó törölt tároló verzióját adja meg.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időkorlátok konfigurálását itt találja.

Válaszok

A nem törölt ContainerClient.

Visszatérési típus

ContainerClient

Attribútumok

api_version

A kérésekhez használt Storage API verziója.

location_mode

Az ügyfél által jelenleg használt hely mód.

Alapértelmezés szerint ez lesz az "elsődleges". A beállítások közé tartozik az "elsődleges" és a "másodlagos".

primary_endpoint

A teljes elsődleges végpont URL-címe.

primary_hostname

Az elsődleges végpont állomásneve.

secondary_endpoint

A teljes másodlagos végpont URL-címe, ha konfigurálva van.

Ha nem érhető el, a rendszer létrehoz egy ValueError értéket. Másodlagos állomásnév explicit megadásához használja az opcionális secondary_hostname kulcsszóargumentumot a példányosításkor.

Kivételek

ValueError

secondary_hostname

A másodlagos végpont állomásneve.

Ha nem érhető el, ez Nem lesz. Másodlagos állomásnév explicit megadásához használja az opcionális secondary_hostname kulcsszóargumentumot a példányosításkor.

url

Az entitás teljes végponti URL-címe, beleértve az SAS-jogkivonatot is, ha használják.

Ez lehet az elsődleges végpont vagy a másodlagos végpont az aktuálistól location_modefüggően. :returns: Az entitás teljes végponti URL-címe, beleértve az SAS-jogkivonatot is, ha használják. :rtype: str