blob Csomag

Csomagok

aio

Osztályok

AccessPolicy	Hozzáférési szabályzatosztály, amelyet a készlet használ, és lekérheti a hozzáférési szabályzat metódusát az egyes szolgáltatásokban. A tárolt hozzáférési szabályzatok megadhatja a kezdési időpontot, a lejárati időt és az engedélyeket azokhoz a közös hozzáférésű jogosultságkódokhoz, amelyekkel társítva van. Attól függően, hogy hogyan szeretné szabályozni az erőforráshoz való hozzáférést, megadhatja az összes paramétert a tárolt hozzáférési szabályzatban, és kihagyhatja őket a közös hozzáférésű jogosultságkód URL-címéből. Így bármikor módosíthatja a társított aláírás viselkedését, valamint visszavonhatja azt. Vagy megadhatja a hozzáférési szabályzat egy vagy több paraméterét a tárolt hozzáférési szabályzatban, a többit pedig az URL-címen. Végül megadhatja az URL-cím összes paraméterét. Ebben az esetben a tárolt hozzáférési szabályzattal visszavonhatja az aláírást, de nem módosíthatja annak viselkedését. A közös hozzáférésű jogosultságkódnak és a tárolt hozzáférési szabályzatnak együtt tartalmaznia kell az aláírás hitelesítéséhez szükséges összes mezőt. Ha a szükséges mezők hiányoznak, a kérés sikertelen lesz. Hasonlóképpen, ha egy mező meg van adva a közös hozzáférésű jogosultságkód URL-címében és a tárolt hozzáférési szabályzatban is, a kérés a 400-ás állapotkóddal (Hibás kérés) meghiúsul.
AccountSasPermissions	ResourceTypes osztályt generate_account_sas függvényhez és a set_*_acl használt AccessPolicies osztályhoz. Az SAS-nek két típusa van, amelyek erőforrás-hozzáférés megadására használhatók. Az egyik, hogy hozzáférést ad egy adott erőforráshoz (erőforrás-specifikus). A másik az, hogy hozzáférést ad a teljes szolgáltatáshoz egy adott fiókhoz, és engedélyezi bizonyos műveleteket az itt található permek alapján.
ArrowDialect	egy nyílséma mezője. Az Azure-ba való küldéshez minden szükséges paramétert fel kell tölteni.
BlobAnalyticsLogging	Az Azure Analytics naplózási beállításai.
BlobBlock	BlockBlob Blokkosztály.
BlobClient	Egy adott blobgal kommunikáló ügyfél, bár előfordulhat, hogy ez a blob még nem létezik. További választható konfigurációért kattintson ide.
BlobLeaseClient	Létrehoz egy új BlobLeaseClientet. Ez az ügyfél bérletműveleteket biztosít BlobClient vagy ContainerClient rendszeren.
BlobPrefix	Blobtulajdonságok Iterable tulajdonsága. Ha elválasztót használ, walk_blobs adja vissza. Virtuális blobkönyvtárként is felfogható.
BlobProperties	Blob tulajdonságai.
BlobQueryError	A hiba a gyors lekérdezési művelet során történt.
BlobQueryReader	Streamelési objektum a lekérdezés eredményeinek olvasásához.
BlobSasPermissions	A függvényhez generate_blob_sas használandó BlobSasPermissions osztály.
BlobServiceClient	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 listázásához, 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ények használatával is lekérhetők. További választható konfigurációért kattintson ide.
ContainerClient	Egy adott tárolóval kommunikáló ügyfél, bár előfordulhat, hogy ez a tároló még nem létezik. A tárolón belül egy adott blobhoz kapcsolódó műveletek esetén a blobügyfél lekérhető a get_blob_client függvénnyel. További választható konfigurációért kattintson ide.
ContainerEncryptionScope	A tároló alapértelmezett titkosítási hatókör-konfigurációja. Ezt a hatókört implicit módon használják a tárolón belüli összes jövőbeli íráshoz, de blobműveletenként felülbíráltatható. Új a 12.2.0-s verzióban.
ContainerProperties	A Blob-tároló tulajdonságosztálya. A visszaadott ContainerProperties példányok ezeket az értékeket egy szótári felületen teszik elérhetővé, például: container_props["last_modified"]. Emellett a tároló neve a következő néven érhető el: container_props["name"].
ContainerSasPermissions	ContainerSasPermissions osztály, amelyet a függvénnyel és a generate_container_sas paranccsal használt AccessPolicies osztályhoz set_container_access_policykell használni.
ContentSettings	A blob tartalombeállításai.
CopyProperties	Blobmásolási tulajdonságok. Ezek a tulajdonságok Nem lesznek , ha ez a blob még soha nem volt cél egy Blob másolása műveletben, vagy ha ezt a blobot módosították egy befejezett Blob másolása művelet után, például blobtulajdonságok beállítása, blob feltöltése vagy véglegesítési blokklista használatával.
CorsRule	A CORS egy olyan HTTP-szolgáltatás, amely egy adott tartományban futó webalkalmazás számára teszi lehetővé, hogy hozzáférjen egy másik tartomány erőforrásaihoz. A webböngészők azonoseredet-szabálynak nevezett biztonsági korlátozással akadályozzák meg, hogy egy adott weblap más tartományokból hívjon meg API-kat. A CORS biztonságos megoldást nyújt arra, hogy a forrástartományból más tartományokban lévő API-k legyenek meghívhatók.
CustomerProvidedEncryptionKey	Az Azure Storage összes adata inaktív állapotban van titkosítva egy fiókszintű titkosítási kulccsal. A 2018-06-17-s és újabb verziókban a blobok tartalmának és az alkalmazás metaadatainak blobonkénti titkosításához használt kulcsot úgy kezelheti, hogy AES-256 titkosítási kulcsot biztosít a tárolási szolgáltatásnak küldött kérésekben. Ha ügyfél által megadott kulcsot használ, az Azure Storage nem kezeli vagy megőrzi a kulcsot. Amikor adatokat ír egy blobba, a megadott kulccsal titkosítja az adatokat, mielőtt lemezre íratja azokat. A titkosítási kulcs SHA-256 kivonata a blob tartalma mellett van megírva, és annak ellenőrzésére szolgál, hogy a blobon végzett minden további művelet ugyanazt a titkosítási kulcsot használja-e. Ez a kivonat nem használható a titkosítási kulcs lekérésére vagy a blob tartalmának visszafejtésére. Blob olvasásakor a megadott kulccsal visszafejtheti az adatokat a lemezről való olvasás után. Mindkét esetben a rendszer a titkosítási vagy visszafejtési folyamat befejeződése után biztonságosan elveti a megadott titkosítási kulcsot.
DelimitedJsonDialect	Meghatározza a blobadatok lekérdezésének bemeneti vagy kimeneti JSON-szerializálását. keyword str határoló: A sorelválasztó karakter, az alapértelmezett érték a " '
DelimitedTextDialect	Meghatározza a blob-lekérdezési kérések bemenetének vagy kimenetének (CSV) szerializálását.
ExponentialRetry	Exponenciális újrapróbálkozás. Exponenciális újrapróbálkozási objektumot épít ki. Az első újrapróbálkozáshoz a initial_backoff használja a rendszer. Az ezt követő újrapróbálkozások initial_backoff + increment_power^retry_count másodperc után újrapróbálkoznak.
FilteredBlob	Blobadatok egy Filter Blobs API-hívásból.
ImmutabilityPolicy	Nem kötelező paraméterek a blob, a blob pillanatképe vagy a blobverzió módosíthatósági szabályzatának beállításához. Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
LeaseProperties	Blobbérlet tulajdonságai.
LinearRetry	Lineáris újrapróbálkozás. Lineáris újrapróbálkozás objektumot hoz létre.
LocationMode	Meghatározza, hogy a kérést a rendszer hol küldje el. Ez a mód csak azokra az RA-GRS-fiókokra vonatkozik, amelyek lehetővé teszik a másodlagos olvasási hozzáférést. Minden más fióktípusnak ELSŐDLEGESet kell használnia.
Metrics	A kérésstatisztikák összegzése API-k szerint, a blobok óránkénti vagy percenkénti összesítésében.
ObjectReplicationPolicy	Egy blobra alkalmazott szabályzatazonosító és szabályazonosítók.
ObjectReplicationRule	Egy blobra alkalmazott szabályzatazonosító és szabályazonosítók.
PageRange	Oldalblob oldaltartománya.
PartialBatchErrorException	Részleges hiba történt a kötegelt műveletekben.
ResourceTypes	Meghatározza a fiók SAS-jével elérhető erőforrástípusokat.
RetentionPolicy	Az adatmegőrzési szabályzat, amely meghatározza, hogy a társított adatok mennyi ideig legyenek megőrzve.
StaticWebsite	Azok a tulajdonságok, amelyek lehetővé teszik, hogy egy fiók statikus webhelyet üzemeltetjen.
StorageStreamDownloader	Streamelési objektum, amely letölthető az Azure Storage-ból.
UserDelegationKey	Egy felhasználódelegálási kulcsot jelöl, amelyet az Azure Storage biztosít a felhasználónak az Azure Active Directory hozzáférési jogkivonata alapján. A mezőket egyszerű sztringekként menti a rendszer, mivel a felhasználónak nem kell használnia ezt az objektumot; az azonosító SAS létrehozásához a felhasználó egyszerűen átadhatja azt a megfelelő API-nak.

Enumerációk

ArrowType
BlobImmutabilityPolicyMode	Meghatározza a blobon beállítandó módosíthatatlansági szabályzatmódot. A "Mutable" csak szolgáltatás által adható vissza, nem állítható be "Mutable" értékre.
BlobType
BlockState	Blokkblobblokktípusok.
PremiumPageBlobTier	Megadja azt a lapblobszintet, amelybe a blobot be szeretné állítani. Ez csak a prémium szintű tárfiókokon található lapblobokra vonatkozik. Tekintse meg a következőt: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets részletes információkért a megfelelő IOPS-ról és a PageBlobTier-nkénti átviteli sebességről.
PublicAccess	Meghatározza, hogy a tárolóban lévő adatok nyilvánosan elérhetők-e, és hogy a hozzáférési szint is elérhető-e.
QuickQueryDialect	A gyors lekérdezés bemeneti/kimeneti dialektusát adja meg.
RehydratePriority	Ha egy objektum rehidratálási függő állapotban van, akkor ezt a fejlécet a rehidratálás prioritásával adja vissza a függvény. Az érvényes értékek a Magas és a Standard.
SequenceNumberAction	Sorszámműveletek.
StandardBlobTier	Megadja azt a blobszintet, amelybe a blobot be szeretné állítani. Ez csak a standard tárfiókokon lévő blokkblobokra vonatkozik.
StorageErrorCode

Függvények

download_blob_from_url

Töltse le egy blob tartalmát egy helyi fájlba vagy streambe.

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

Paraméterek

blob_url

str

Kötelező

A blob teljes URI-ja. Ez sas-jogkivonatot is tartalmazhat.

output

str vagy <xref:<xref:writable stream.>>

Kötelező

Ahová az adatokat le kell tölteni. Ez lehet egy fájl elérési útja, amelybe írni szeretne, vagy egy nyitott I/O-leíró, amelybe írni szeretne.

credential

alapértelmezett érték: None

A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a blob URL-címe már rendelkezik SAS-jogkivonattal, vagy a blob nyilvános. 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. 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 mellett.

• kivéve az AzureSasCredential esetében, ahol az ütköző SAS-jogkivonatok ValueError értéket fognak létrehozni. 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.

overwrite

bool

Felülírja-e a helyi fájlt, ha már létezik. Az alapértelmezett érték Hamis – ebben az esetben egy ValueError érték jelenik meg, ha a fájl már létezik. Ha igaz értékre van állítva, a rendszer megkísérel írni a meglévő fájlba. Ha egy streamfogantyút ad át, a rendszer figyelmen kívül hagyja ezt az értéket.

max_concurrency

int

Azoknak a párhuzamos kapcsolatoknak a száma, amelyekkel le kell tölteni.

offset

int

A blob egy szakaszának letöltéséhez használandó bájttartomány kezdete. Ha a hossz meg van adva, be kell állítani.

length

int

A streamből beolvasandó bájtok száma. Ez nem kötelező, de az optimális teljesítmény érdekében kell megadni.

validate_content

bool

Ha igaz, kiszámít egy MD5-kivonatot a blob minden egyes darabjára. A tárolási szolgáltatás ellenőrzi annak a tartalomnak a kivonatát, amely az elküldött kivonattal érkezett. Ez elsősorban akkor hasznos, ha bitflipeket észlel a vezetéken, ha a https helyett http-t használ, mivel a https (alapértelmezett) már érvényesíthető. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva. Azt is vegye figyelembe, hogy ha engedélyezve van, a memóriahatékony feltöltési algoritmus nem lesz használva, mivel az MD5 kivonatának kiszámításához teljes blokkok pufferelésére van szükség, és ez nem teszi lehetővé a memóriahatékony algoritmus használatát.

Visszatérési típus

None

generate_account_sas

Létrehoz egy közös hozzáférésű jogosultságkódot a blobszolgáltatáshoz.

Használja a visszaadott aláírást bármely BlobServiceClient, ContainerClient vagy BlobClient hitelesítőadat-paraméterével.

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

Paraméterek

account_name

str

Kötelező

A közös hozzáférésű jogosultságkód létrehozásához használt tárfióknév.

account_key

str

Kötelező

A közös hozzáférésű jogosultságkód létrehozásához a fiókkulcs, más néven megosztott kulcs vagy hozzáférési kulcs.

resource_types

str vagy ResourceTypes

Kötelező

Megadja a fiók SAS-jével elérhető erőforrástípusokat.

permission

str vagy AccountSasPermissions

Kötelező

A közös hozzáférésű jogosultságkódhoz társított engedélyek. A felhasználó az engedélyek által engedélyezett műveletekre korlátozódik. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva.

expiry

datetime vagy str

Kötelező

A közös hozzáférésű jogosultságkód érvénytelenné válásának időpontja. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva. Az Azure mindig UTC értékké konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti.

start

datetime vagy str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód érvényességének időpontja. Ha nincs megadva, a rendszer feltételezi, hogy a hívás indítási ideje az az időpont, amikor a storage szolgáltatás megkapja a kérést. Az Azure mindig UTC értékké konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti.

ip

str

alapértelmezett érték: None

Megadja azt az IP-címet vagy IP-címtartományt, amelyből a kéréseket fogadni szeretné. Ha az IP-cím, amelyről a kérés származik, nem egyezik az SAS-jogkivonatban megadott IP-címmel vagy címtartománysal, a kérés nem lesz hitelesítve. Ha például az IP=168.1.5.65 vagy az ip=168.1.5.60-168.1.5.70 értéket adja meg az SAS-en, akkor a kérés az adott IP-címekre lesz korlátozva.

protocol

str

Meghatározza, hogy egy kéréshez mely protokoll engedélyezett. Az alapértelmezett érték a https.

encryption_scope

str

Megadja egy kérés titkosítási hatókörét, hogy az összes írási művelet szolgáltatás titkosítva legyen.

Válaszok

Közös hozzáférésű jogosultságkód (sas) jogkivonat.

Visszatérési típus

str

generate_blob_sas

Létrehoz egy közös hozzáférésű jogosultságkódot egy blobhoz.

Használja a visszaadott aláírást bármely BlobServiceClient, ContainerClient vagy BlobClient hitelesítőadat-paraméterével.

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

Paraméterek

account_name

str

Kötelező

A közös hozzáférésű jogosultságkód létrehozásához használt tárfióknév.

container_name

str

Kötelező

A tároló neve.

blob_name

str

Kötelező

A blob neve.

snapshot

str

alapértelmezett érték: None

Egy nem kötelező blobpillanatkép-azonosító.

account_key

str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód létrehozásához a fiókkulcs, más néven megosztott kulcs vagy hozzáférési kulcs. Meg kell adni account_key vagy user_delegation_key .

user_delegation_key

UserDelegationKey

alapértelmezett érték: None

A megosztott fiókkulcs helyett a felhasználó átadhat egy felhasználódelegálási kulcsot. A felhasználódelegálási kulcs AAD-identitással történő hitelesítéssel szerezhető be a szolgáltatásból; ez a meghívásával get_user_delegation_keyvalósítható meg. Ha jelen van, az SAS alá van írva a felhasználódelegálási kulccsal.

permission

str vagy BlobSasPermissions

alapértelmezett érték: None

A közös hozzáférésű jogosultságkódhoz társított engedélyek. A felhasználó az engedélyek által engedélyezett műveletekre korlátozódik. Az engedélyeket racwdxytmei sorrendbe kell rendezni. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva.

expiry

datetime vagy str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód érvénytelenné válásának időpontja. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva. Az Azure mindig UTC értékké konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti.

start

datetime vagy str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód érvényességének időpontja. Ha nincs megadva, a rendszer feltételezi, hogy a hívás indítási ideje az az időpont, amikor a storage szolgáltatás megkapja a kérést. Az Azure mindig UTC értékké konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti.

policy_id

str

alapértelmezett érték: None

Egy legfeljebb 64 karakter hosszúságú egyedi érték, amely egy tárolt hozzáférési szabályzattal korrelál. Tárolt hozzáférési szabályzat létrehozásához használja a következőt set_container_access_policy: .

ip

str

alapértelmezett érték: None

Megadja azt az IP-címet vagy IP-címtartományt, amelyből a kéréseket fogadni szeretné. Ha az IP-cím, amelyről a kérés származik, nem egyezik az SAS-jogkivonatban megadott IP-címmel vagy címtartománysal, a kérés nem lesz hitelesítve. Ha például az IP=168.1.5.65 vagy az ip=168.1.5.60-168.1.5.70 értéket adja meg az SAS-en, akkor a kérés az adott IP-címekre lesz korlátozva.

version_id

str

Egy nem kötelező blobverzió-azonosító. Ez a paraméter csak verziószámozásra képes Tárfiókok esetén alkalmazható. Vegye figyelembe, hogy a "versionid" lekérdezési paraméter nem szerepel a kimeneti SAS-ben. Ezért adja meg a "version_id" paramétert bármely API-nak, amikor a kimeneti SAS-t használja egy adott verzión való működéshez.

A 12.4.0-s verzió újdonsága: Ez a kulcsszóargumentum a "2019-12-12" API-verzióban jelent meg.

protocol

str

Meghatározza, hogy egy kéréshez mely protokoll engedélyezett. Az alapértelmezett érték a https.

cache_control

str

Válaszfejléc értéke Cache-Control, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal érik el.

content_disposition

str

A Content-Disposition válaszfejléc-értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal érik el.

content_encoding

str

A Content-Encoding válaszfejlécének értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal érik el.

content_language

str

A Content-Language válaszfejléc-értéke, ha az erőforráshoz ezzel a közös hozzáférésű jogosultságkóddal fér hozzá.

content_type

str

A Content-Type válaszfejléc-értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal érik el.

encryption_scope

str

Megadja egy kérés titkosítási hatókörét, hogy az összes írási művelet szolgáltatás titkosítva legyen.

correlation_id

str

A tárolónaplók és az SAS-t létrehozó és terjesztő rendszerbiztonsági tag által használt naplók korrelációs azonosítója. Ez csak delegálási kulccsal rendelkező SAS létrehozásakor használható.

Válaszok

Közös hozzáférésű jogosultságkód (sas) jogkivonat.

Visszatérési típus

str

generate_container_sas

Létrehoz egy megosztott hozzáférési aláírást egy tárolóhoz.

Használja a visszaadott aláírást bármely BlobServiceClient, ContainerClient vagy BlobClient hitelesítőadat-paraméterével.

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

Paraméterek

account_name

str

Kötelező

A közös hozzáférésű jogosultságkód létrehozásához használt tárfióknév.

container_name

str

Kötelező

A tároló neve.

account_key

str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód létrehozásához a fiókkulcs, más néven megosztott kulcs vagy hozzáférési kulcs. Meg kell adni account_key vagy user_delegation_key .

user_delegation_key

UserDelegationKey

alapértelmezett érték: None

A megosztott fiókkulcs helyett a felhasználó átadhat egy felhasználódelegálási kulcsot. A felhasználódelegálási kulcs AAD-identitással történő hitelesítéssel szerezhető be a szolgáltatásból; ez a meghívásával get_user_delegation_keyvalósítható meg. Ha jelen van, az SAS alá van írva a felhasználódelegálási kulccsal.

permission

str vagy ContainerSasPermissions

alapértelmezett érték: None

A közös hozzáférésű jogosultságkódhoz társított engedélyek. A felhasználó az engedélyek által engedélyezett műveletekre korlátozódik. Engedélyeket kell rendelni racwdxyltfmei. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva.

expiry

datetime vagy str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód érvénytelenné válásának időpontja. Kötelező, hacsak nincs megadva azonosító, amely a mezőt tartalmazó tárolt hozzáférési szabályzatra hivatkozik. Ezt a mezőt ki kell hagyni, ha egy társított tárolt hozzáférési szabályzatban van megadva. Az Azure mindig UTC-vé konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez.

start

datetime vagy str

alapértelmezett érték: None

A közös hozzáférésű jogosultságkód érvényességének időpontja. Ha nincs megadva, a rendszer feltételezi, hogy a hívás kezdési időpontja az az idő, amikor a társzolgáltatás megkapja a kérést. Az Azure mindig UTC-vé konvertálja az értékeket. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez.

policy_id

str

alapértelmezett érték: None

Egy legfeljebb 64 karakter hosszúságú egyedi érték, amely egy tárolt hozzáférési szabályzattal korrelál. Tárolt hozzáférési szabályzat létrehozásához használja a következőt set_container_access_policy: .

ip

str

alapértelmezett érték: None

Olyan IP-címet vagy IP-címtartományt ad meg, amelyből a kéréseket fogadni szeretné. Ha az IP-cím, amelyről a kérelem származik, nem egyezik meg az SAS-jogkivonaton megadott IP-címmel vagy címtartománynal, a kérés nem hitelesítve lesz. Ha például ip=168.1.5.65 vagy ip=168.1.5.60-168.1.5.70 értéket ad meg az SAS-en, a kérést az adott IP-címekre korlátozza.

protocol

str

Meghatározza a kérelemhez engedélyezett protokollt. Az alapértelmezett érték https.

cache_control

str

Válaszfejléc értéke Cache-Control, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal éri el.

content_disposition

str

A Content-Disposition válaszfejléc-értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal éri el.

content_encoding

str

A tartalomkódolás válaszfejlécének értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal éri el.

content_language

str

A Content-Language válaszfejlécének értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal éri el.

content_type

str

A Content-Type válaszfejlécének értéke, ha az erőforrást ezzel a közös hozzáférésű jogosultságkóddal éri el.

encryption_scope

str

Megadja egy kérés titkosítási hatókörét, hogy az összes írási művelet szolgáltatással legyen titkosítva.

correlation_id

str

A tároló auditnaplóinak korrelációazonosítója az SAS-t létrehozó és terjesztő rendszerbiztonsági tag által használt naplókkal. Ez csak delegálási kulccsal rendelkező SAS létrehozásakor használható.

Válaszok

Közös hozzáférésű jogosultságkód (sas) jogkivonat.

Visszatérési típus

str

upload_blob_to_url

Adatok feltöltése egy adott URL-címre

Az adatok blokkblobként lesznek feltöltve.

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]

Paraméterek

blob_url

str

Kötelező

A blob teljes URI-ja. Ez sas-jogkivonatot is tartalmazhat.

data

bytes vagy str vagy Iterable

Kötelező

A feltöltendő adatok. Ez lehet bájt, szöveg, iterálási vagy fájlszerű objektum.

credential

alapértelmezett érték: None

A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a blob 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.

overwrite

bool

Azt jelzi, hogy a feltöltendő blob felülírja-e az aktuális adatokat. Ha igaz, upload_blob_to_url felülírja a meglévő adatokat. Ha False (Hamis) értékre van állítva, a művelet resourceExistsError értékkel meghiúsul.

max_concurrency

int

Azoknak a párhuzamos kapcsolatoknak a száma, amelyekkel le kell tölteni.

length

int

A streamből beolvasandó bájtok száma. Ez nem kötelező, de az optimális teljesítmény érdekében kell megadni.

metadata

dict(str,str)

A blobhoz metaadatként társított név-érték párok.

validate_content

bool

Ha igaz, egy MD5-kivonatot számít ki a blob minden egyes darabjára. A tárolási szolgáltatás ellenőrzi az elküldött kivonattal érkezett tartalom kivonatát. Ez elsősorban akkor hasznos, ha bitflipeket észlel a vezetéken, ha http-t használ https helyett, mivel a https (alapértelmezett) már érvényesíti. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva. Azt is vegye figyelembe, hogy ha engedélyezve van, a memóriahatékony feltöltési algoritmus nem lesz használva, mivel az MD5 kivonatának kiszámításához teljes blokkokat kell pufferelni, és ez megakadályozza a memóriahatékony algoritmus célját.

encoding

str

Kódolás, ha a szöveg bemenetként van megadva. Alapértelmezés szerint UTF-8.

Válaszok

Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)

Visszatérési típus

dict(str, Any)