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 |
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
- output
- str vagy <xref:<xref:writable stream.>>
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
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
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_key
- str
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
Megadja a fiók SAS-jével elérhető erőforrástípusokat.
- permission
- str vagy AccountSasPermissions
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.
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.
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
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
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_key
- str
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
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
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.
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.
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
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
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
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_key
- str
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
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
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.
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.
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
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
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
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
A feltöltendő adatok. Ez lehet bájt, szöveg, iterálási vagy fájlszerű objektum.
- credential
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.
- 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
Azure SDK for Python