BlobClient Osztály
Egy ügyfél, amely egy adott blobot használ, bár ez a blob még nem létezik.
További választható konfigurációért kattintson ide.
- Öröklődés
-
azure.storage.blob._shared.base_client.StorageAccountHostsMixinBlobClientazure.storage.blob._encryption.StorageEncryptionMixinBlobClient
Konstruktor
BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)
Paraméterek
- account_url
- str
A tárfiók URI-ja. A blob teljes URI-jának megfelelő ügyfél létrehozásához használja a from_blob_url classmethod parancsot.
- blob_name
- str
Annak a blobnak a neve, amellyel kommunikálni szeretne. Ha meg van adva, ez az érték felülbírálja a blob URL-címében megadott blobértéket.
- snapshot
- str
Az opcionális blobpillanatkép, amelyen működni szeretne. Ez lehet a pillanatkép-azonosító sztringje vagy a válasza.create_snapshot
- credential
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, 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.
- 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.
A 12.2.0-s verzió újdonságai.
- secondary_hostname
- str
A másodlagos végpont állomásneve.
- max_block_size
- int
A blokkblobok adattömbökbe való feltöltésének maximális adattömbmérete.
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 csak egy HTTP PUT kéréssel lesz feltöltve. Ha a blob mérete nagyobb, mint max_single_put_size, a blob darabokban lesz feltöltve. Alapértelmezés szerint 64*1024*1024
vagy 64 MB.
- min_large_block_upload_threshold
- int
A memóriahatékony algoritmus használatához szükséges minimális adattömbméret blokkblobok feltöltésekor. 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
A blobok egyetlen hívásban való letöltésének maximális mérete, a túllépett rész adattömbökbe lesz letöltve (párhuzamos is lehet). Alapértelmezés szerint 32*1024*1024
vagy 32 MB.
- max_chunk_get_size
- int
A blobok letöltéséhez használt maximális adattömbméret. Alapértelmezés szerint 4*1024*1024
vagy 4 MB.
- 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.
Metódusok
abort_copy |
Megszakított egy folyamatban lévő másolási műveletet. Ez egy nulla hosszúságú és teljes metaadatokat tartalmazó célblobot hagy. Ez hibát jelez, ha a másolási művelet már befejeződött. |
acquire_lease |
Új bérletet kér. Ha a blobnak nincs aktív bérlete, a Blob szolgáltatás létrehoz egy bérletet a blobon, és új bérletet ad vissza. |
append_block |
Új adatblokkot véglegesíti a meglévő hozzáfűző blob végéig. |
append_block_from_url |
Létrehoz egy új blokkot, amely egy blob részeként véglegesítendő, ahol a tartalom egy forrás URL-címről lesz beolvasva. |
clear_page |
Egy oldaltartomány törlése. |
close |
Ezzel a módszerrel zárja be az ügyfél által megnyitott szoftvercsatornákat. Környezetkezelővel való használathoz nem szükséges használni. |
commit_block_list |
A Blokklista véglegesítése művelet egy blobot ír a blobokat alkotó blokkazonosítók listájának megadásával. |
create_append_blob |
Létrehoz egy új hozzáfűző blobot. Ez a művelet létrehoz egy új, 0 hosszúságú hozzáfűző blobot. A meglévő blobok tartalmát felülírja az újonnan inicializált hozzáfűző blob. Ha tartalmat szeretne hozzáadni a hozzáfűző blobhoz, hívja meg a vagy append_block_from_url a metódustappend_block. |
create_page_blob |
Létrehoz egy új lapblobot a megadott méretben. |
create_snapshot |
Pillanatképet hoz létre a blobról. A pillanatkép egy adott időpontban készített blob írásvédett verziója. Olvasható, másolható vagy törölhető, de nem módosítható. A pillanatképek lehetővé teszik a blobok biztonsági mentését, amint az egy adott pillanatban megjelenik. A blobok pillanatképének neve megegyezik a pillanatkép készítésének alapjául szolgáló blob nevével, és egy DateTime érték van hozzáfűzve, amely jelzi a pillanatkép készítésének időpontját. |
delete_blob |
Megjelöli a megadott blobot a törléshez. A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. A delete_blob() művelettel egyidejűleg mindkettő törölhető. Ha a szolgáltatásnál engedélyezve van a törlési adatmegőrzési szabályzat, akkor ez a művelet helyreállítható módon törli a blobot, és egy megadott számú napig megőrzi a blobot. A megadott számú nap elteltével a blob adatai el lesznek távolítva a szolgáltatásból a szemétgyűjtés során. A helyreállíthatóan törölt blob az include=[deleted] beállítás megadásával érhető ellist_blobs. A helyreállíthatóan törölt blobok a művelettel <xref:azure.storage.blob.undelete> állíthatók vissza. |
delete_immutability_policy |
Az Immutability Policy törlése művelet törli a blob módosíthatatlansági szabályzatát. Új a 12.10.0-s verzióban: Ezt a műveletet a "2020-10-02" API-verzióban vezettük be. |
download_blob |
Letölt egy blobot a StorageStreamDownloaderbe. A readall() metódust kell használni az összes tartalom olvasásához, vagy a blob streambe való letöltéséhez a readinto() metódust kell használni. Az adattömbök() használatával egy iterátort ad vissza, amely lehetővé teszi a felhasználó számára, hogy az adattömbök tartalma fölött iteráljon. |
exists |
Igaz értéket ad vissza, ha egy blob létezik a megadott paraméterekkel, és máskülönben Hamis értéket ad vissza. |
from_blob_url |
BlobClient létrehozása blob URL-címből. Ez nem támogatja a "/" blobnévvel rendelkező testre szabott blob URL-címet. |
from_connection_string |
BlobClient létrehozása kapcsolati sztringből. |
get_account_information |
Lekéri az ahhoz a tárfiókhoz kapcsolódó információkat, amelyben a blob található. 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 található kulcsok közé tartozik a "sku_name" és a "account_kind". |
get_blob_properties |
A blob összes felhasználó által definiált metaadatát, szabványos HTTP-tulajdonságát és rendszertulajdonságát adja vissza. Nem adja vissza a blob tartalmát. |
get_blob_tags |
A Címkék lekérése művelettel a felhasználók címkéket kérhetnek le egy blob vagy adott blobverzió vagy pillanatkép alapján. Új a 12.4.0-s verzióban: Ezt a műveletet a "2019-12-12" API-verzióban vezettük be. |
get_block_list |
A Blokklista lekérése művelet lekéri a blokkblob részeként feltöltött blokkok listáját. |
get_page_range_diff_for_managed_disk |
Egy felügyelt lemez vagy pillanatkép érvényes oldaltartományainak listáját adja vissza. Megjegyzés Ez a művelet csak felügyelt lemezfiókokhoz érhető el. Új a 12.2.0-s verzióban: Ezt a műveletet a "2019-07-07" API-verzióban vezettük be. |
get_page_ranges |
ELAVULT: Egy lapblob érvényes oldaltartományainak vagy egy lapblob pillanatképének listáját adja vissza. |
list_page_ranges |
Egy lapblob érvényes oldaltartományainak listáját vagy egy lapblob pillanatképét adja vissza. Ha previous_snapshot van megadva, az eredmény a célblob és az előző pillanatkép közötti változások eltérése lesz. |
query_blob |
Egyszerű lekérdezési kifejezések megadásával lehetővé teszi a felhasználók számára a blobok/vagy blobok pillanatkép-adatainak kiválasztását/kivetítét. Ez a művelet egy BlobQueryReadert ad vissza, a felhasználóknak a readall() vagy a readinto() függvényt kell használniuk a lekérdezési adatok lekéréséhez. |
resize_blob |
Átméretez egy lapblobot a megadott méretre. Ha a megadott érték kisebb, mint a blob aktuális mérete, akkor a megadott érték feletti összes oldal törlődik. |
seal_append_blob |
A Seal művelet lezárja a hozzáfűző blobot, hogy írásvédetté tegye. Új a 12.4.0-s verzióban. |
set_blob_metadata |
A blob felhasználó által definiált metaadatait egy vagy több név-érték párként állítja be. |
set_blob_tags |
A Címkék beállítása művelet lehetővé teszi, hogy a felhasználók címkéket állítsanak be egy blob- vagy egy adott blobverzióra, de pillanatképet nem. A művelet minden hívása lecseréli a blobhoz csatolt összes meglévő címkét. Ha az összes címkét el szeretné távolítani a blobból, hívja meg ezt a műveletet címkék nélkül. Új a 12.4.0-s verzióban: Ezt a műveletet a "2019-12-12" API-verzióban vezettük be. |
set_http_headers |
Beállítja a rendszer tulajdonságait a blobon. Ha az content_settings egy tulajdonság van beállítva, az összes tulajdonság felül lesz bírálva. |
set_immutability_policy |
Az Immutability Policy beállítása művelet beállítja a blob megváltoztathatatlansági szabályzatát. Új a 12.10.0-s verzióban: Ezt a műveletet a "2020-10-02" API-verzióban vezettük be. |
set_legal_hold |
A Jogi célú visszatartás beállítása művelet jogi célú visszatartást állít be a blobon. Újdonság a 12.10.0-s verzióban: Ez a művelet a "2020-10-02" API-verzióban jelent meg. |
set_premium_page_blob_tier |
Beállítja a blob lapblobszintjeinek beállítását. Ez az API csak prémium szintű fiókok lapblobjainak esetében támogatott. |
set_sequence_number |
Beállítja a blobsorozat számát. |
set_standard_blob_tier |
Ez a művelet beállítja a réteget egy blokkblobon. A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét. |
stage_block |
Létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve. |
stage_block_from_url |
Létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve, ahol a tartalom egy URL-címről lesz beolvasva. |
start_copy_from_url |
Blob másolása a megadott URL-címről. Ez a művelet egy copy_status és copy_id tartalmazó szótárat ad vissza, amely a másolási művelet állapotának ellenőrzésére vagy megszakítására használható. copy_status "sikeres" lesz, ha a másolat szinkronban fejeződött be, vagy "függőben" lesz, ha a másolatot aszinkron módon indították el. Az aszinkron másolatok esetében az állapot a metódus lekérdezésével és a get_blob_properties másolás állapotának ellenőrzésével ellenőrizhető. Állítsa requires_sync Igaz értékre, hogy a másolat szinkronra legyen kényszerítve. A Blob szolgáltatás a lehető legjobb erőfeszítéssel másolja a blobokat. A másolási művelet forrásblobja lehet blokkblob, hozzáfűző blob vagy lapblob. Ha a célblob már létezik, annak a forrásblob típusával megegyező típusúnak kell lennie. A meglévő célblobok felülíródnak. A célblob nem módosítható másolási művelet közben. Lapblobból való másoláskor a Blob szolgáltatás létrehoz egy céloldali blobot a forrásblob hosszából, amely kezdetben az összes nullát tartalmazza. Ezután a forráslaptartományok enumerálva lesznek, a nem üres tartományok pedig ki lesznek másolva. Blokkblob vagy hozzáfűző blob esetén a Blob szolgáltatás létrehoz egy véglegesített, nulla hosszúságú blobot, mielőtt visszatér a műveletből. Blokkblobból történő másoláskor a rendszer az összes véglegesített blokkot és azok blokkazonosítóját másolja. A nem véglegesített blokkok nem lesznek másolva. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámtal fog rendelkezni, mint a forrás. Ha hozzáfűző blobból másol, a program az összes véglegesített blokkot átmásolja. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámtal fog rendelkezni, mint a forrás. |
undelete_blob |
Helyreállíthatóan törölt blobok vagy pillanatképek 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. Ha a blobok verziószámozása engedélyezve van, az alapblob nem állítható vissza ezzel a módszerrel. Ehelyett használja start_copy_from_url annak a blobverziónak az URL-címét, amelyet elő szeretne léptetni az aktuális verzióra. |
upload_blob |
Új blobot hoz létre egy adatforrásból automatikus adattömbökkel. |
upload_blob_from_url |
Létrehoz egy új blokkblobot, amelyben a blob tartalma egy adott URL-címről lesz beolvasva. A meglévő blob tartalma felülíródik az új blobgal. |
upload_page |
A Lapok feltöltése művelet oldaltartományt ír egy lapblobba. |
upload_pages_from_url |
A Lapok feltöltése művelet egy oldaltartományt ír egy lapblobba, ahol a tartalom egy URL-címről van beolvasva. |
abort_copy
Megszakított egy folyamatban lévő másolási műveletet.
Ez egy nulla hosszúságú és teljes metaadatokat tartalmazó célblobot hagy. Ez hibát jelez, ha a másolási művelet már befejeződött.
abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None
Paraméterek
- copy_id
- str vagy BlobProperties
A másolási művelet megszakítása. Ez lehet egy azonosító sztring, vagy a BlobProperties egy példánya.
Visszatérési típus
acquire_lease
Új bérletet kér.
Ha a blobnak nincs aktív bérlete, a Blob szolgáltatás létrehoz egy bérletet a blobon, és új bérletet ad vissza.
acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient
Paraméterek
- lease_duration
- int
Megadja a bérlet időtartamát másodpercben vagy negatív (-1) egy olyan bérlet esetén, amely soha nem jár le. A nem végtelen bérlet 15 és 60 másodperc között lehet. A bérlet időtartama nem módosítható megújítással vagy módosítással. Az alapértelmezett érték -1 (végtelen bérlet).
- lease_id
- str
Javasolt bérletazonosító GUID sztringformátumban. A Blob Service 400-et (érvénytelen kérést) ad vissza, ha a javasolt bérletazonosító nem a megfelelő formátumban van.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
Egy BlobLeaseClient objektum.
Visszatérési típus
append_block
Új adatblokkot véglegesíti a meglévő hozzáfűző blob végéig.
append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]
Paraméterek
A blokk tartalma. Ez lehet bájt, szöveg, iterálási vagy fájlszerű objektum.
- validate_content
- bool
Ha igaz, kiszámítja a blokktartalom MD5-kivonatát. 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 https helyett HTTP-t használ, mivel a https (alapértelmezett) már érvényesíti. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva.
- maxsize_condition
- int
Nem kötelező feltételes fejléc. A hozzáfűző blob megengedett maximális hossza bájtban. Ha a Hozzáfűzési blokk művelet miatt a blob túllépné ezt a korlátot, vagy ha a blob mérete már nagyobb, mint az ebben a fejlécben megadott érték, a kérés MaxBlobSizeConditionNotMet hibával meghiúsul (HTTP-állapotkód: 412 – Az előfeltétel sikertelen).
- appendpos_condition
- int
Nem kötelező feltételes fejléc, amely csak a Hozzáfűzési blokk művelethez használható. Az összehasonlítandó bájteltolást jelző szám. A hozzáfűzési blokk csak akkor lesz sikeres, ha a hozzáfűzési pozíció egyenlő ezzel a számmal. Ha nem, a kérés a AppendPositionConditionNotMet hibával hiúsul meg (HTTP-állapotkód: 412 – Precondition Failed).
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
- encoding
- str
Alapértelmezés szerint UTF-8.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
Válaszok
Blob által frissített tulajdonságdikt (Etag, utolsó módosítás, hozzáfűzés eltolása, véglegesített blokkok száma).
Visszatérési típus
append_block_from_url
Létrehoz egy új blokkot, amely egy blob részeként véglegesítendő, ahol a tartalom egy forrás URL-címről lesz beolvasva.
append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]
Paraméterek
- copy_source_url
- str
A forrásadatok URL-címe. Bármely olyan Azure-blobra vagy fájlra mutathat, amely nyilvános, vagy amelyhez egy közös hozzáférésű jogosultságkód van csatolva.
- source_offset
- int
Ez a másolási forrásból átveendő bájttartomány kezdetét jelzi (a bájtokat is beleértve).
- source_content_md5
- bytearray
Ha meg van adva, a szolgáltatás kiszámítja a blokktartalom MD5 kivonatát, és összehasonlítja ezt az értéket.
- maxsize_condition
- int
Nem kötelező feltételes fejléc. A hozzáfűző blob számára engedélyezett bájtok maximális hossza. Ha a Hozzáfűzési blokk művelet miatt a blob túllépi ezt a korlátot, vagy ha a blob mérete már nagyobb, mint az ebben a fejlécben megadott érték, a kérés MaxBlobSizeConditionNotMet hibával meghiúsul (HTTP-állapotkód: 412 – Az előfeltétele nem sikerült).
- appendpos_condition
- int
Nem kötelező feltételes fejléc, amely csak a Hozzáfűzési blokk művelethez használható. Az összehasonlítandó bájteltolást jelző szám. A hozzáfűzési blokk csak akkor lesz sikeres, ha a hozzáfűzési pozíció egyenlő ezzel a számmal. Ha nem, a kérés a AppendPositionConditionNotMet hibával hiúsul meg (HTTP-állapotkód: 412 – Precondition Failed).
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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
A cél ETag értéke vagy a 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 célegyeztetés feltétele.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
- source_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 a forráserőforrás a megadott időpont óta módosult.
- source_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 a forráserőforrás nem lett módosítva a megadott dátum/idő óta.
- source_etag
- str
A forrás ETag értéke vagy a 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.
- source_match_condition
- MatchConditions
Az etagen használni kívánt forrásegyeztetés feltétele.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
- source_authorization
- str
Hitelesítés szolgáltatásnévként ügyfélkód használatával egy forrásblob eléréséhez. Győződjön meg arról, hogy a "tulajdonos" a source_authorization sztring előtagja.
clear_page
Egy oldaltartomány törlése.
clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- offset
- int
A blob egy szakaszára való íráshoz használandó bájttartomány kezdete. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
A blob egy szakaszára való íráshoz használandó bájtok száma. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- if_sequence_number_lte
- int
Ha a blob sorszáma kisebb vagy egyenlő a megadott értékkel, a kérés folytatódik; ellenkező esetben meghiúsul.
- if_sequence_number_lt
- int
Ha a blob sorszáma kisebb a megadott értéknél, a kérés folytatódik; ellenkező esetben sikertelen lesz.
- if_sequence_number_eq
- int
Ha a blob sorszáma megegyezik a megadott értékkel, a kérés folytatódik; ellenkező esetben sikertelen lesz.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- 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
Blob által frissített tulajdonságindex (Etag és utolsó módosítás).
Visszatérési típus
close
Ezzel a módszerrel zárja be az ügyfél által megnyitott szoftvercsatornákat. Környezetkezelővel való használathoz nem szükséges használni.
close()
commit_block_list
A Blokklista véglegesítése művelet egy blobot ír a blobokat alkotó blokkazonosítók listájának megadásával.
commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]
Paraméterek
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűt.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkekulcsok legfeljebb 128 karakter hosszúságúak lehetnek, a címkeértékek pedig 0 és 256 karakter között lehetnek.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzásjel (_)
A 12.4.0-s verzió újdonsága.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- immutability_policy
- ImmutabilityPolicy
Egy blob, blobpillanatkép vagy blobverzió módosíthatatlansági szabályzatát határozza meg.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- legal_hold
- bool
Meg van adva, ha jogi célú visszatartást kell beállítani a blobon.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- validate_content
- bool
Ha igaz, kiszámítja az oldal tartalmának MD5-kivonatát. 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 https helyett HTTP-t használ, mivel a https (alapértelmezett) már érvényesíti. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező célblobon működjenek.
A 12.4.0-s verzió újdonsága.
- standard_blob_tier
- StandardBlobTier
Egy standard blobszint-érték, amely a blobot értékre állítja. A kódtár ezen verziójára ez csak a standard tárfiókokon található blokkblobokra vonatkozik.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat gombra. Ha a tárolóban alapértelmezett titkosítási hatókör van meghatározva, ez az érték felülbírálja azt, ha a tárolószintű hatókör úgy van konfigurálva, hogy engedélyezze a felülbírálásokat. Ellenkező esetben hiba lép fel.
A 12.2.0-s verzió újdonságai.
- 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
Blob által frissített tulajdonságindex (Etag és utolsó módosítás).
Visszatérési típus
create_append_blob
Létrehoz egy új hozzáfűző blobot. Ez a művelet létrehoz egy új, 0 hosszúságú hozzáfűző blobot. A meglévő blobok tartalmát felülírja az újonnan inicializált hozzáfűző blob. Ha tartalmat szeretne hozzáadni a hozzáfűző blobhoz, hívja meg a vagy append_block_from_url a metódustappend_block.
create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűt.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkekulcsok legfeljebb 128 karakter hosszúságúak lehetnek, a címkeértékek pedig 0 és 256 karakter között lehetnek.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzásjel (_)
A 12.4.0-s verzió újdonsága.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- immutability_policy
- ImmutabilityPolicy
Egy blob, blobpillanatkép vagy blobverzió módosíthatatlansági szabályzatát határozza meg.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- legal_hold
- bool
Meg van adva, ha jogi célú visszatartást kell beállítani a blobon.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
Válaszok
Blob-frissített tulajdonságdikt (Etag és utolsó módosítás).
Visszatérési típus
create_page_blob
Létrehoz egy új lapblobot a megadott méretben.
create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]
Paraméterek
- size
- int
Ez az oldalblob maximális méretét adja meg, legfeljebb 1 TB-ot. Az oldalblob méretét egy 512 bájtos határhoz kell igazítani.
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
- premium_page_blob_tier
- PremiumPageBlobTier
Egy lapblobszint-érték, amely a blob értékét állítja be. A szint a blob méretével és az engedélyezett IOPS számával korrelál. Ez csak a prémium szintű tárfiókokon található lapblobokra vonatkozik.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűket.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkebillentyűknek 1 és 128 karakter közöttinek, a címkeértéknek pedig 0 és 256 karakter közöttinek kell lennie.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzás (_)
Új a 12.4.0-s verzióban.
- sequence_number
- int
Csak lapblobok esetén. A sorszám egy felhasználó által vezérelt érték, amellyel nyomon követheti a kéréseket. A sorszám értéke 0 és 2^63 – 1 között lehet. Az alapértelmezett érték 0.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- immutability_policy
- ImmutabilityPolicy
Meghatározza a blob, a blob pillanatképe vagy a blobverzió módosíthatósági szabályzatát.
Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
- legal_hold
- bool
Megadva, ha a blobon jogi célú visszatartást kell beállítani.
Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
- 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.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
Válaszok
Blob-frissített tulajdonságdikt (Etag és utolsó módosítás).
Visszatérési típus
create_snapshot
Pillanatképet hoz létre a blobról.
A pillanatkép egy adott időpontban készített blob írásvédett verziója. Olvasható, másolható vagy törölhető, de nem módosítható. A pillanatképek lehetővé teszik a blobok biztonsági mentését, amint az egy adott pillanatban megjelenik.
A blobok pillanatképének neve megegyezik a pillanatkép készítésének alapjául szolgáló blob nevével, és egy DateTime érték van hozzáfűzve, amely jelzi a pillanatkép készítésének időpontját.
create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező célblobon működik.
Új a 12.4.0-s verzióban.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
Válaszok
Blob-frissített tulajdonságdikt (pillanatkép-azonosító, Etag és utolsó módosítás).
Visszatérési típus
delete_blob
Megjelöli a megadott blobot a törléshez.
A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. A delete_blob() művelettel egyidejűleg mindkettő törölhető.
Ha a szolgáltatásnál engedélyezve van a törlési adatmegőrzési szabályzat, akkor ez a művelet helyreállítható módon törli a blobot, és egy megadott számú napig megőrzi a blobot. A megadott számú nap elteltével a blob adatai el lesznek távolítva a szolgáltatásból a szemétgyűjtés során. A helyreállíthatóan törölt blob az include=[deleted] beállítás megadásával érhető ellist_blobs. A helyreállíthatóan törölt blobok a művelettel <xref:azure.storage.blob.undelete> állíthatók vissza.
delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None
Paraméterek
- delete_snapshots
- str
Akkor szükséges, ha a blobhoz társított pillanatképek tartoznak. Az értékek többek között az alábbiak lehetnek:
"csak": Csak a blobok pillanatképeit törli.
"include": Törli a blobot és az összes pillanatképet.
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a törölni kívánt blob verzióját.
Új a 12.4.0-s verzióban.
Ez a kulcsszóargumentum a "2019-12-12" API-verzióban lett bevezetve.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Ha meg van adva, delete_blob csak akkor sikerül, ha a blob bérlete aktív, és megfelel ennek az azonosítónak. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.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
delete_immutability_policy
Az Immutability Policy törlése művelet törli a blob módosíthatatlansági szabályzatát.
Új a 12.10.0-s verzióban: Ezt a műveletet a "2020-10-02" API-verzióban vezettük be.
delete_immutability_policy(**kwargs: Any) -> None
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őtúllépések konfigurálásához lásd itt.
Válaszok
Blobcímkék kulcsértékpárjai.
Visszatérési típus
download_blob
Letölt egy blobot a StorageStreamDownloaderbe. A readall() metódust kell használni az összes tartalom olvasásához, vagy a blob streambe való letöltéséhez a readinto() metódust kell használni. Az adattömbök() használatával egy iterátort ad vissza, amely lehetővé teszi a felhasználó számára, hogy az adattömbök tartalma fölött iteráljon.
download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]
Paraméterek
- offset
- int
A blob egy szakaszának letöltéséhez használandó bájttartomány kezdete. Meg kell adni, ha a hossz meg van adva.
- 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.
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a letöltendő blob verzióját.
Új a 12.4.0-s verzióban.
Ez a kulcsszóargumentum a "2019-12-12" API-verzióban lett bevezetve.
- 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 a 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 algoritmust nem fogja használni a rendszer, mert az MD5-kivonat kiszámításához teljes blokkok pufferelése szükséges, és ez nem teszi lehetővé a memóriahatékony algoritmus célját.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Ha meg van adva, download_blob csak akkor lesz sikeres, ha a blob bérlete aktív, és megfelel ennek az azonosítónak. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- max_concurrency
- int
Azoknak a párhuzamos kapcsolatoknak a száma, amelyekkel le kell tölteni.
- encoding
- str
Kódolás a letöltött bájtok dekódolásához. Az alapértelmezett érték Nincs, azaz nincs dekódolás.
Visszahívás egy hosszú ideig futó letöltés előrehaladásának nyomon követéséhez. Az aláírás függvény (current: int, total: int), ahol az aktuális az eddig átvitt bájtok száma, az összeg pedig a letöltés teljes mérete.
- 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. Ez a metódus több hívást is indíthat a szolgáltatáshoz, és az időtúllépés minden hívásra külön-külön érvényes lesz. több hívás az Azure-szolgáltatásba, és az időtúllépés minden hívásra külön-külön érvényes.
Válaszok
Streamobjektum (StorageStreamDownloader)
Visszatérési típus
exists
Igaz értéket ad vissza, ha egy blob létezik a megadott paraméterekkel, és máskülönben Hamis értéket ad vissza.
exists(**kwargs: Any) -> bool
Paraméterek
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a blob verzióját annak ellenőrzéséhez, hogy létezik-e.
- 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.
Válaszok
boolean
Visszatérési típus
from_blob_url
BlobClient létrehozása blob URL-címből. Ez nem támogatja a "/" blobnévvel rendelkező testre szabott blob URL-címet.
from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self
Paraméterek
- blob_url
- str
A blob teljes végponti URL-címe, beleértve az SAS-jogkivonatot és a pillanatképet is, ha használják. Ez lehet az elsődleges végpont vagy a másodlagos végpont az aktuális location_mode függően.
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
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 karakterlánc már rendelkezik közös hozzáférési kulcsértékekkel. 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.
- snapshot
- str
Az opcionális blob-pillanatkép, amelyen működni szeretne. Ez lehet a pillanatkép-azonosító sztringje vagy a következőtől create_snapshotkapott válasz: . Ha meg van adva, ez felülbírálja a pillanatképet az URL-címben.
- 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 szeretne.
Válaszok
Blobügyfél.
Visszatérési típus
from_connection_string
BlobClient létrehozása kapcsolati sztringből.
from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self
Paraméterek
- snapshot
- str
Az opcionális blob-pillanatkép, amelyen működni szeretne. Ez lehet a pillanatkép-azonosító sztringje vagy a következőtől create_snapshotkapott válasz: .
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
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 karakterlánc már rendelkezik közös hozzáférési kulcsértékekkel. 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. Az itt megadott hitelesítő adatok elsőbbséget élveznek a kapcsolati karakterlánc. Ha azureNamedKeyCredential-példányt használ, a "név" a tárfiók neve, a "kulcs" pedig a tárfiók kulcsa.
- 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 szeretne.
Válaszok
Blobügyfél.
Visszatérési típus
get_account_information
Lekéri az ahhoz a tárfiókhoz kapcsolódó információkat, amelyben a blob található.
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 található 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ók típusa) diktálása.
Visszatérési típus
get_blob_properties
A blob összes felhasználó által definiált metaadatát, szabványos HTTP-tulajdonságát és rendszertulajdonságát adja vissza. Nem adja vissza a blob tartalmát.
get_blob_properties(**kwargs: Any) -> BlobProperties
Paraméterek
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a blob verzióját a tulajdonságok lekéréséhez.
Új a 12.4.0-s verzióban.
Ez a kulcsszóargumentum a "2019-12-12" API-verzióban lett bevezetve.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- 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.
Válaszok
BlobProperties
Visszatérési típus
get_blob_tags
A Címkék lekérése művelettel a felhasználók címkéket kérhetnek le egy blob vagy adott blobverzió vagy pillanatkép alapján.
Új a 12.4.0-s verzióban: Ezt a műveletet a "2019-12-12" API-verzióban vezettük be.
get_blob_tags(**kwargs: Any) -> Dict[str, str]
Paraméterek
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a blob azon verzióját, amelyhez címkéket szeretne hozzáadni.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező célblobon működik.
például: "\"tagname\"='my tag'"
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
Válaszok
Blobcímkék kulcsértékpárjai.
Visszatérési típus
get_block_list
A Blokklista lekérése művelet lekéri a blokkblob részeként feltöltött blokkok listáját.
get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]
Paraméterek
- block_list_type
- str
Meghatározza, hogy a véglegesített blokkok listáját, a véglegesítetlen blokkok listáját vagy mindkét listát együtt adja-e vissza. Lehetséges értékek: "véglegesített", "uncommitted", "all"
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező célblobon működik.
Új a 12.4.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.
Válaszok
Két lista rekordja – véglegesített és nem véglegesített blokkok
Visszatérési típus
get_page_range_diff_for_managed_disk
Egy felügyelt lemez vagy pillanatkép érvényes oldaltartományainak listáját adja vissza.
Megjegyzés
Ez a művelet csak felügyelt lemezfiókokhoz érhető el.
Új a 12.2.0-s verzióban: Ezt a műveletet a "2019-07-07" API-verzióban vezettük be.
get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]
Paraméterek
- previous_snapshot_url
A felügyelt lemez egy korábbi pillanatképének URL-címét adja meg. A válasz csak a célblob és az előző pillanatkép között módosított lapokat tartalmazza.
- offset
- int
Az érvényes oldaltartományok lekéréséhez használandó bájttartomány kezdete. Ha nincs megadva hossz, a rendszer az eltolás utáni összes bájtot megkeresi. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
Érvényes oldaltartományok lekéréséhez használandó bájtok száma. Ha a hossz meg van adva, eltolást kell megadni. Ez a tartomány érvényes oldaltartományokat ad vissza az eltolás kezdetétől a megadott hosszig. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
Válaszok
Az oldaltartományok két listájának rekordja szótárként a "start" és a "end" billentyűvel. Az első elem a kitöltött oldaltartományok, a második elem pedig az oldaltartományok törlése.
Visszatérési típus
get_page_ranges
ELAVULT: Egy lapblob érvényes oldaltartományainak vagy egy lapblob pillanatképének listáját adja vissza.
get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]
Paraméterek
- offset
- int
Az érvényes oldaltartományok lekéréséhez használandó bájttartomány kezdete. Ha nincs megadva hossz, a rendszer az eltolás utáni összes bájtot megkeresi. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
Érvényes oldaltartományok lekéréséhez használandó bájtok száma. Ha a hossz meg van adva, eltolást kell megadni. Ez a tartomány érvényes oldaltartományokat ad vissza az eltolás kezdetétől a megadott hosszig. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- previous_snapshot_diff
- str
A pillanatkép-diff paraméter, amely egy átlátszatlan DateTime értéket tartalmaz, amely egy korábbi blob-pillanatképet határoz meg, amelyet egy újabb pillanatképhez vagy az aktuális blobhoz kell hasonlítani.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.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.
Válaszok
Az oldaltartományok két listájának rekordja szótárként a "start" és a "end" billentyűvel. Az első elem a kitöltött oldaltartományok, a második elem pedig az oldaltartományok törlése.
Visszatérési típus
list_page_ranges
Egy lapblob érvényes oldaltartományainak listáját vagy egy lapblob pillanatképét adja vissza. Ha previous_snapshot van megadva, az eredmény a célblob és az előző pillanatkép közötti változások eltérése lesz.
list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]
Paraméterek
- offset
- int
Az érvényes oldaltartományok lekéréséhez használandó bájttartomány kezdete. Ha nincs megadva hossz, a rendszer az eltolás utáni összes bájtot megkeresi. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
Érvényes oldaltartományok lekéréséhez használandó bájtok száma. Ha a hossz meg van adva, eltolást kell megadni. Ez a tartomány érvényes oldaltartományokat ad vissza az eltolás kezdetétől a megadott hosszig. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
Egy pillanatkép-érték, amely meghatározza, hogy a válasz csak a célblob és az előző pillanatkép között módosított oldalakat tartalmazza. A módosított lapok tartalmazzák a frissített és a törölt oldalakat is. A célblob lehet egy pillanatkép, feltéve, hogy a previous_snapshot által megadott pillanatkép a kettő közül a régebbi.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
- results_per_page
- int
Az API-hívásonként lekérhető oldaltartományok maximális száma.
- 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.
Válaszok
A PageRange iterable (automatikus lapozása).
Visszatérési típus
query_blob
Egyszerű lekérdezési kifejezések megadásával lehetővé teszi a felhasználók számára a blobok/vagy blobok pillanatkép-adatainak kiválasztását/kivetítét. Ez a művelet egy BlobQueryReadert ad vissza, a felhasználóknak a readall() vagy a readinto() függvényt kell használniuk a lekérdezési adatok lekéréséhez.
query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader
Paraméterek
- query_expression
- str
Kötelező. egy lekérdezési utasítást. További információ: https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.
- on_error
- Callable[BlobQueryError]
A szolgáltatás által visszaadott feldolgozási hibák esetén meghívandó függvény.
- blob_format
- DelimitedTextDialect vagy DelimitedJsonDialect vagy QuickQueryDialect vagy str
Választható. Meghatározza a blobban jelenleg tárolt adatok szerializálását. Az alapértelmezett beállítás a blobadatok CSV-adatokként való kezelése az alapértelmezett dialektusban. Ez felülbírálható egyéni DelimitedTextDialect, DelimitedJsonDialect vagy "ParquetDialect" (sztringként vagy számként átadva). Ezek a dialektusok átadhatók a megfelelő osztályokon, a QuickQueryDialect enumeráláson vagy sztringként
- output_format
- DelimitedTextDialect vagy DelimitedJsonDialect vagy list[ArrowDialect] vagy QuickQueryDialect vagy str
Választható. Meghatározza az adatfolyam kimeneti szerializálását. Alapértelmezés szerint az adatok a blobban való ábrázolásuknak megfelelően lesznek visszaadva (parquet formátumok alapértelmezés szerint DelimitedTextDialect). A kimeneti formátum megadásával a blobadatok ennek a profilnak megfelelően lesznek újraformálva. Ez az érték lehet DelimitedTextDialect, DelimitedJsonDialect vagy ArrowDialect. Ezek a dialektusok átadhatók a megfelelő osztályokon, a QuickQueryDialect enumeráláson vagy sztringként
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- 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
Streamelési objektum (BlobQueryReader)
Visszatérési típus
resize_blob
Átméretez egy lapblobot a megadott méretre.
Ha a megadott érték kisebb, mint a blob aktuális mérete, akkor a megadott érték feletti összes oldal törlődik.
resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- size
- int
A blob átméretezéséhez használt méret. Egy lapblob maximális mérete legfeljebb 1 TB lehet. Az oldalblob méretét egy 512 bájtos határhoz kell igazítani.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- premium_page_blob_tier
- PremiumPageBlobTier
Egy lapblobréteg-érték, amely a blobot értékre állítja. A szint a blob méretével és az engedélyezett IOPS számával korrelál. Ez csak a prémium szintű tárfiókokban található lapblobokra vonatkozik.
- 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
Blob által frissített tulajdonságindex (Etag és utolsó módosítás).
Visszatérési típus
seal_append_blob
A Seal művelet lezárja a hozzáfűző blobot, hogy írásvédetté tegye.
Új a 12.4.0-s verzióban.
seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]
Paraméterek
- appendpos_condition
- int
Nem kötelező feltételes fejléc, amely csak a Hozzáfűzési blokk művelethez használható. Az összehasonlítandó bájteltolást jelző szám. A hozzáfűzési blokk csak akkor lesz sikeres, ha a hozzáfűzési pozíció egyenlő ezzel a számmal. Ha nem, a kérés a AppendPositionConditionNotMet hibával hiúsul meg (HTTP-állapotkód: 412 – Az előfeltétel sikertelen).
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezé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őkorlátok konfigurálását itt találja.
Válaszok
Blob által frissített tulajdonságindex (Etag, utolsó módosítás, hozzáfűzési eltolás, véglegesített blokkok száma).
Visszatérési típus
set_blob_metadata
A blob felhasználó által definiált metaadatait egy vagy több név-érték párként állítja be.
set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
Név- és értékpárokat tartalmazó diktálás. A művelet minden hívása lecseréli a blobhoz csatolt összes meglévő metaadatot. Ha az összes metaadatot el szeretné távolítani a blobból, hívja meg ezt a műveletet metaadatfejlécek nélkül.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
Válaszok
Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)
set_blob_tags
A Címkék beállítása művelet lehetővé teszi, hogy a felhasználók címkéket állítsanak be egy blob- vagy egy adott blobverzióra, de pillanatképet nem. A művelet minden hívása lecseréli a blobhoz csatolt összes meglévő címkét. Ha az összes címkét el szeretné távolítani a blobból, hívja meg ezt a műveletet címkék nélkül.
Új a 12.4.0-s verzióban: Ezt a műveletet a "2019-12-12" API-verzióban vezettük be.
set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]
Paraméterek
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűket.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkebillentyűknek 1 és 128 karakter közöttinek, a címkeértéknek pedig 0 és 256 karakter közöttinek kell lennie.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzás (_)
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a blob azon verzióját, amelyhez címkéket szeretne hozzáadni.
- validate_content
- bool
Ha igaz, kiszámítja a címkék tartalmának MD5 kivonatát. 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 a 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező célblobon működik.
például: "\"tagname\"='my tag'"
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
Válaszok
Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)
Visszatérési típus
set_http_headers
Beállítja a rendszer tulajdonságait a blobon.
Ha az content_settings egy tulajdonság van beállítva, az összes tulajdonság felül lesz bírálva.
set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None
Paraméterek
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.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.
Válaszok
Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)
Visszatérési típus
set_immutability_policy
Az Immutability Policy beállítása művelet beállítja a blob megváltoztathatatlansági szabályzatát.
Új a 12.10.0-s verzióban: Ezt a műveletet a "2020-10-02" API-verzióban vezettük be.
set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]
Paraméterek
- immutability_policy
- ImmutabilityPolicy
Meghatározza a blob, a blob pillanatképe vagy a blobverzió módosíthatósági szabályzatát.
Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
- 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.
Válaszok
Blobcímkék kulcsértékpárjai.
Visszatérési típus
set_legal_hold
A Jogi célú visszatartás beállítása művelet jogi célú visszatartást állít be a blobon.
Újdonság a 12.10.0-s verzióban: Ez a művelet a "2020-10-02" API-verzióban jelent meg.
set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]
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 blobcímkék kulcsértékpárjai.
Visszatérési típus
set_premium_page_blob_tier
Beállítja a blob lapblobszintjeinek beállítását. Ez az API csak prémium szintű fiókok lapblobjainak esetében támogatott.
set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None
Paraméterek
- premium_page_blob_tier
- PremiumPageBlobTier
Egy lapblobréteg-érték, amely a blobot értékre állítja. A szint a blob méretével és az engedélyezett IOPS számával korrelál. Ez csak a prémium szintű tárfiókokban található lapblobokra vonatkozik.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
Visszatérési típus
set_sequence_number
Beállítja a blobsorozat számát.
set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- sequence_number_action
- str
Ez a tulajdonság azt jelzi, hogy a szolgáltatásnak hogyan kell módosítania a blob sorszámát. További információ: SequenceNumberAction.
- sequence_number
- str
Ez a tulajdonság beállítja a blob sorszámát. A sorszám egy felhasználó által vezérelt tulajdonság, amellyel nyomon követheti a kéréseket, és kezelheti az egyidejűségi problémákat.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
Blob által frissített tulajdonságindex (Etag és utolsó módosítás).
Visszatérési típus
set_standard_blob_tier
Ez a művelet beállítja a réteget egy blokkblobon.
A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét.
set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None
Paraméterek
- standard_blob_tier
- str vagy StandardBlobTier
A blobon beállítandó szintet jelzi. A lehetőségek közé tartozik a "Gyakori elérésű", a "Ritka elérésű" és az "Archív". A gyakori elérésű szint a gyakran használt adatok tárolására van optimalizálva. A ritka elérésű tárolási szint olyan adatok tárolására van optimalizálva, amelyekhez legalább egy hónapig ritkán férnek hozzá és tárolnak. Az archív szint olyan adatok tárolására van optimalizálva, amelyek ritkán érhetők el és legalább hat hónapig tárolhatók rugalmas késési követelményekkel.
- rehydrate_priority
- RehydratePriority
Azt a prioritást jelzi, amellyel egy archivált blobot rehidratálhat
- version_id
- str
A verzióazonosító paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a letölteni kívánt blob verzióját.
A 12.4.0-s verzió újdonsága.
Ez a kulcsszóargumentum a "2019-12-12" API-verzióban jelent meg.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
Visszatérési típus
stage_block
Létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve.
stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]
Paraméterek
- block_id
- str
A blokkot azonosító sztringérték. A sztringnek 64 bájtnál kisebbnek vagy egyenlőnek kell lennie. Egy adott blob esetében a block_id minden blokkhoz azonos méretűnek kell lennie.
- data
A blobadatok.
- 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 https helyett HTTP-t használ, 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, mert az MD5-kivonat 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.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- encoding
- str
Alapértelmezés szerint UTF-8.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat gombra. Ha a tárolóban alapértelmezett titkosítási hatókör van meghatározva, ez az érték felülbírálja azt, ha a tárolószintű hatókör úgy van konfigurálva, hogy engedélyezze a felülbírálásokat. Ellenkező esetben hiba lép fel.
A 12.2.0-s verzió újdonságai.
- 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
Blob tulajdonság dict.
Visszatérési típus
stage_block_from_url
Létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve, ahol a tartalom egy URL-címről lesz beolvasva.
stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]
Paraméterek
- block_id
- str
A blokkot azonosító sztringérték. A sztringnek 64 bájtnál kisebbnek vagy egyenlőnek kell lennie. Egy adott blob esetében a block_id minden blokkhoz azonos méretűnek kell lennie.
- source_offset
- int
A blokkhoz használandó bájttartomány kezdete. Meg kell adni, ha a forrás hossza meg van adva.
- source_content_md5
- bytearray
Adja meg a másolási forrásból beolvasandó bájtok tartományához számított md5 értéket.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Ú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.
- source_authorization
- str
Hitelesítés szolgáltatásnévként ügyfélkód használatával egy forrásblob eléréséhez. Győződjön meg arról, hogy a "tulajdonos" a source_authorization sztring előtagja.
Válaszok
Blob tulajdonság diktál.
Visszatérési típus
start_copy_from_url
Blob másolása a megadott URL-címről.
Ez a művelet egy copy_status és copy_id tartalmazó szótárat ad vissza, amely a másolási művelet állapotának ellenőrzésére vagy megszakítására használható. copy_status "sikeres" lesz, ha a másolat szinkronban fejeződött be, vagy "függőben" lesz, ha a másolatot aszinkron módon indították el. Az aszinkron másolatok esetében az állapot a metódus lekérdezésével és a get_blob_properties másolás állapotának ellenőrzésével ellenőrizhető. Állítsa requires_sync Igaz értékre, hogy a másolat szinkronra legyen kényszerítve. A Blob szolgáltatás a lehető legjobb erőfeszítéssel másolja a blobokat.
A másolási művelet forrásblobja lehet blokkblob, hozzáfűző blob vagy lapblob. Ha a célblob már létezik, annak a forrásblob típusával megegyező típusúnak kell lennie. A meglévő célblobok felülíródnak. A célblob nem módosítható másolási művelet közben.
Lapblobból való másoláskor a Blob szolgáltatás létrehoz egy céloldali blobot a forrásblob hosszából, amely kezdetben az összes nullát tartalmazza. Ezután a forráslaptartományok enumerálva lesznek, a nem üres tartományok pedig ki lesznek másolva.
Blokkblob vagy hozzáfűző blob esetén a Blob szolgáltatás létrehoz egy véglegesített, nulla hosszúságú blobot, mielőtt visszatér a műveletből. Blokkblobból történő másoláskor a rendszer az összes véglegesített blokkot és azok blokkazonosítóját másolja. A nem véglegesített blokkok nem lesznek másolva. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámtal fog rendelkezni, mint a forrás.
Ha hozzáfűző blobból másol, a program az összes véglegesített blokkot átmásolja. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámtal fog rendelkezni, mint a forrás.
start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]
Paraméterek
- source_url
- str
Egy legfeljebb 2 KB hosszúságú URL-cím, amely egy fájlt vagy blobot határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogy az a kérés URI-jában is megjelenik. Ha a forrás egy másik fiókban található, a forrásnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell hitelesítenie. Ha a forrás nyilvános, nincs szükség hitelesítésre. Példák: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
A blobhoz metaadatként társított név-érték párok. Ha nincs megadva név-érték pár, a művelet a metaadatokat a forrásblobból vagy fájlból a célblobba másolja. Ha egy vagy több név-érték pár van megadva, a célblob a megadott metaadatokkal jön létre, és a metaadatok nem lesznek átmásolva a forrásblobból vagy fájlból.
- incremental_copy
- bool
Másolja a forrásoldali blob pillanatképét egy céllapblobba. A rendszer úgy másolja a pillanatképet, hogy a rendszer csak a korábban másolt pillanatkép közötti különbségváltozásokat továbbítja a célhelyre. A másolt pillanatképek az eredeti pillanatkép teljes másolatai, és a szokásos módon olvashatók vagy másolhatók. Alapértelmezés szerint Hamis.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűket.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkebillentyűknek 1 és 128 karakter közöttinek, a címkeértéknek pedig 0 és 256 karakter közöttinek kell lennie.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzás (_).
A (kis- és nagybetűktől megkülönböztetett) "COPY" literál helyett át lehet adni a címkék másolásához a forrásblobból. Ez a beállítás csak akkor érhető el , ha incremental_copy=Hamis és requires_sync=Igaz.
Új a 12.4.0-s verzióban.
- immutability_policy
- ImmutabilityPolicy
Meghatározza a blob, a blob pillanatképe vagy a blobverzió módosíthatósági szabályzatát.
Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
- legal_hold
- bool
Megadva, ha a blobon jogi célú visszatartást kell beállítani.
Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.
- source_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 feltételes fejlécet csak akkor adja meg a blob másolásához, ha a forrásblob a megadott dátum/idő óta módosult.
- source_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 feltételes fejlécet csak akkor adja meg a blob másolásához, ha a forrásblob a megadott dátum/idő óta nem lett módosítva.
- source_etag
- str
A forrás ETag értéke vagy a 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.
- source_match_condition
- MatchConditions
Az etagen használni kívánt forrásegyeztetés feltétele.
- 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. Adja meg ezt a feltételes fejlécet a blob másolásához, ha a célblob a megadott dátum/idő óta módosult. Ha a célblob nem lett módosítva, a Blob szolgáltatás a 412-s állapotkódot adja vissza (az előfeltétel sikertelen).
- 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. Adja meg ezt a feltételes fejlécet a blob másolásához, ha a célblob nem lett módosítva a megadott dátum/idő óta. Ha a célblob módosult, a Blob szolgáltatás a 412-s állapotkódot adja vissza (az előfeltétel sikertelen).
- etag
- str
A cél ETag értéke vagy a 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 célegyeztetés feltétele.
- destination_lease
- BlobLeaseClient vagy str
A fejléchez megadott bérletazonosítónak meg kell egyeznie a célblob bérletazonosítójával. Ha a kérelem nem tartalmazza a bérletazonosítót, vagy érvénytelen, a művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
- source_lease
- BlobLeaseClient vagy str
Ezt csak akkor adja meg a Blob másolása művelet végrehajtásához, ha a megadott bérletazonosító megegyezik a forrásblob aktív bérletazonosítójával.
- 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.
- premium_page_blob_tier
- PremiumPageBlobTier
Egy lapblobszint-érték, amely a blob értékét állítja be. A szint a blob méretével és az engedélyezett IOPS számával korrelál. Ez csak a prémium szintű tárfiókokon található lapblobokra vonatkozik.
- standard_blob_tier
- StandardBlobTier
Standard blobszint-érték a blob értékének beállításához. A kódtár ezen verziójához ez csak a standard tárfiókokon lévő blobok blokkolására vonatkozik.
- rehydrate_priority
- RehydratePriority
Azt a prioritást jelzi, amellyel egy archivált blobot rehidratálhat
- seal_destination_blob
- bool
Zárja le a cél hozzáfűző blobot. Ez a művelet csak hozzáfűző blobhoz használható.
Új a 12.4.0-s verzióban.
- requires_sync
- bool
Kényszeríti, hogy a szolgáltatás ne adjon vissza választ, amíg a másolat be nem fejeződik.
- source_authorization
- str
Hitelesítés szolgáltatásnévként ügyfélkód használatával egy forrásblob eléréséhez. Győződjön meg arról, hogy a "tulajdonos" a source_authorization sztring előtagja. Ez a beállítás csak akkor érhető el , ha incremental_copy Értéke Hamis, requires_sync értéke Igaz.
Új a 12.9.0-s verzióban.
- encryption_scope
- str
Egy előre definiált titkosítási hatókör, amellyel titkosíthatók a szinkronizált blob adatai. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
Új a 12.10.0-s verzióban.
Válaszok
A másolási tulajdonságok szótára (etag, last_modified, copy_id, copy_status).
Visszatérési típus
undelete_blob
Helyreállíthatóan törölt blobok vagy pillanatképek 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.
Ha a blobok verziószámozása engedélyezve van, az alapblob nem állítható vissza ezzel a módszerrel. Ehelyett használja start_copy_from_url annak a blobverziónak az URL-címét, amelyet elő szeretne léptetni az aktuális verzióra.
undelete_blob(**kwargs: Any) -> None
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.
Visszatérési típus
upload_blob
Új blobot hoz létre egy adatforrásból automatikus adattömbökkel.
upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]
Paraméterek
- data
A feltöltendő blobadatok.
- blob_type
- BlobType
A blob típusa. Ez lehet BlockBlob, PageBlob vagy AppendBlob. Az alapértelmezett érték a BlockBlob.
- 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.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűt.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkekulcsok legfeljebb 128 karakter hosszúságúak lehetnek, a címkeértékek pedig 0 és 256 karakter között lehetnek.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzásjel (_)
A 12.4.0-s verzió újdonsága.
- overwrite
- bool
Azt határozza meg, hogy a feltöltendő blob felülírja-e az aktuális adatokat. Ha igaz, upload_blob felülírja a meglévő adatokat. Ha False (Hamis) értékre van állítva, a művelet ResourceExistsError értékkel meghiúsul. A fentiek alól kivételt képeznek a Hozzáfűző blobtípusok: ha False (Hamis) értékre van állítva, és az adatok már léteznek, a rendszer nem ad hibát, és az adatok hozzá lesznek fűzve a meglévő blobhoz. Ha a set overwrite=True értékre van állítva, akkor a meglévő hozzáfűző blob törlődik, és létrejön egy új. Alapértelmezés szerint Hamis.
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
- 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 https helyett HTTP-t használ, 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, mert az MD5-kivonat 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.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Ha meg van adva, upload_blob csak akkor lesz sikeres, ha a blob bérlete aktív, és megfelel ennek az azonosítónak. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.
- match_condition
- MatchConditions
Az etagen használandó egyezési feltétel.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- premium_page_blob_tier
- PremiumPageBlobTier
Egy lapblobréteg-érték, amely a blobot értékre állítja. A szint a blob méretével és az engedélyezett IOPS számával korrelál. Ez csak a prémium szintű tárfiókokban található lapblobokra vonatkozik.
- standard_blob_tier
- StandardBlobTier
Egy standard blobszint-érték, amely a blobot értékre állítja. A kódtár ezen verziójára ez csak a standard tárfiókokon található blokkblobokra vonatkozik.
- immutability_policy
- ImmutabilityPolicy
Egy blob, blobpillanatkép vagy blobverzió módosíthatatlansági szabályzatát határozza meg. A upload_blob() API paramétere jelenleg csak a BlockBlobhoz használható.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- legal_hold
- bool
Meg van adva, ha jogi célú visszatartást kell beállítani a blobon. A upload_blob() API paramétere jelenleg csak a BlockBlobhoz használható.
Újdonság a 12.10.0-s verzióban: Ez a 2020-10-02 API-verzióban jelent meg.
- maxsize_condition
- int
Nem kötelező feltételes fejléc. A hozzáfűző blob megengedett maximális hossza bájtban. Ha a Hozzáfűzési blokk művelet miatt a blob túllépné ezt a korlátot, vagy ha a blob mérete már nagyobb, mint az ebben a fejlécben megadott érték, a kérés MaxBlobSizeConditionNotMet hibával meghiúsul (HTTP-állapotkód: 412 – Az előfeltétel sikertelen).
- max_concurrency
- int
A párhuzamos kapcsolatok maximális száma, ha a blob mérete meghaladja a 64 MB-ot.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat gombra. Ha a tárolóban alapértelmezett titkosítási hatókör van meghatározva, ez az érték felülbírálja azt, ha a tárolószintű hatókör úgy van konfigurálva, hogy engedélyezze a felülbírálásokat. Ellenkező esetben hiba lép fel.
A 12.2.0-s verzió újdonságai.
- encoding
- str
Alapértelmezés szerint UTF-8.
Visszahívás egy hosszú ideig futó feltöltés előrehaladásának nyomon követéséhez. Az aláírás függvény(aktuális: int, összeg: Nem kötelező[int]), ahol az aktuális az eddig átvitt bájtok száma, az összeg pedig a blob mérete vagy Nincs, ha a méret ismeretlen.
- 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. Ez a metódus több hívást is indíthat a szolgáltatáshoz, és az időtúllépés minden hívásra külön-külön érvényes lesz.
Válaszok
Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)
Visszatérési típus
upload_blob_from_url
Létrehoz egy új blokkblobot, amelyben a blob tartalma egy adott URL-címről lesz beolvasva. A meglévő blob tartalma felülíródik az új blobgal.
upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]
Paraméterek
- source_url
- str
Egy legfeljebb 2 KB hosszúságú URL-cím, amely egy fájlt vagy blobot határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogy az a kérés URI-jában is megjelenik. Ha a forrás egy másik fiókban található, a forrásnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell hitelesítenie. Ha a forrás nyilvános, nincs szükség hitelesítésre. Példák: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
- overwrite
- bool
Azt jelzi, hogy a feltöltendő blob felülírja-e az aktuális adatokat. Ha igaz, upload_blob felülírja a meglévő adatokat. Ha False (Hamis) értékre van állítva, a művelet a ResourceExistsError művelettel meghiúsul.
- include_source_blob_properties
- bool
Azt jelzi, hogy a forrásblob tulajdonságait át kell-e másolni. Alapértelmezés szerint Igaz.
A blobhoz címkeként társított név-érték párok. A címkék megkülönböztetik a kis- és nagybetűket.
A címkekészlet legfeljebb 10 címkét tartalmazhat. A címkebillentyűknek 1 és 128 karakter közöttinek, a címkeértéknek pedig 0 és 256 karakter közöttinek kell lennie.
Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz ( >>
<<), plusz (+), mínusz (-), pont (.), solidus (/), kettőspont (:), egyenlőség (=), aláhúzás (_)
- source_content_md5
- bytearray
Adja meg a forrásbájtok integritásának ellenőrzéséhez használt md5 értéket.
- source_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 a forráserőforrás a megadott időpont óta módosult.
- source_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 a forráserőforrás nem lett módosítva a megadott dátum/idő óta.
- source_etag
- str
A forrás ETag értéke vagy a 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.
- source_match_condition
- MatchConditions
Az etagen használni kívánt forrásegyeztetés feltétele.
- 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
A cél ETag értéke vagy a 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 célegyeztetés feltétele.
- destination_lease
- BlobLeaseClient vagy str
A fejléchez megadott bérletazonosítónak meg kell egyeznie a célblob bérletazonosítójával. Ha a kérelem nem tartalmazza a bérletazonosítót, vagy érvénytelen, a művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
- 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.
- content_settings
- ContentSettings
A blobtulajdonságok beállításához használt ContentSettings objektum. A tartalomtípus, a kódolás, a nyelv, a diszpozíció, az md5 és a gyorsítótár-vezérlés beállítására szolgál.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat rá. Ha a tárolóban alapértelmezett titkosítási hatókör van definiálva, ez az érték felülbírálja azt, ha a tárolószintű hatókör a felülbírálások engedélyezésére van konfigurálva. Ellenkező esetben hibaüzenet jelenik meg.
- standard_blob_tier
- StandardBlobTier
Standard blobszint-érték a blob értékének beállításához. A kódtár ezen verziójához ez csak a standard tárfiókokon lévő blobok blokkolására vonatkozik.
- source_authorization
- str
Hitelesítés szolgáltatásnévként ügyfélkód használatával egy forrásblob eléréséhez. Győződjön meg arról, hogy a "tulajdonos" a source_authorization sztring előtagja.
upload_page
A Lapok feltöltése művelet oldaltartományt ír egy lapblobba.
upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]
Paraméterek
- offset
- int
A blob egy szakaszára való íráshoz használandó bájttartomány kezdete. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
A blob egy szakaszára való íráshoz használandó bájtok száma. Az oldalakat 512 bájtos határokkal kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként a bérletazonosító.
- validate_content
- bool
Ha igaz, kiszámítja a lap tartalmának MD5 kivonatát. 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 a 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.
- if_sequence_number_lte
- int
Ha a blob sorszáma kisebb vagy egyenlő a megadott értékkel, a kérés folytatódik; ellenkező esetben meghiúsul.
- if_sequence_number_lt
- int
Ha a blob sorszáma kisebb a megadott értéknél, a kérés folytatódik; ellenkező esetben meghiúsul.
- if_sequence_number_eq
- int
Ha a blob sorszáma megegyezik a megadott értékkel, a kérés folytatódik; ellenkező esetben meghiúsul.
- 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.
- if_tags_match_condition
- str
Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik.
például: "\"tagname\"='my tag'"
Új a 12.4.0-s verzióban.
A szolgáltatás oldalán lévő adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat gombra. Ha a tárolóban alapértelmezett titkosítási hatókör van meghatározva, ez az érték felülbírálja azt, ha a tárolószintű hatókör úgy van konfigurálva, hogy engedélyezze a felülbírálásokat. Ellenkező esetben hiba lép fel.
A 12.2.0-s verzió újdonságai.
- encoding
- str
Alapértelmezés szerint UTF-8.
- 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
Blob által frissített tulajdonságindex (Etag és utolsó módosítás).
Visszatérési típus
upload_pages_from_url
A Lapok feltöltése művelet egy oldaltartományt ír egy lapblobba, ahol a tartalom egy URL-címről van beolvasva.
upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]
Paraméterek
- source_url
- str
A forrásadatok URL-címe. Bármely olyan Azure-blobra vagy fájlra mutathat, amely nyilvános, vagy amelyhez közös hozzáférésű jogosultságkód van csatolva.
- offset
- int
A blob egy szakaszára való íráshoz használandó bájttartomány kezdete. Az oldalakat 512 bájtos határokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- length
- int
A blob egy szakaszára való íráshoz használandó bájtok száma. Az oldalakat 512 bájtos határokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.
- source_offset
- int
Ez a másolási forrásból átveendő bájttartomány kezdetét jelzi (a bájtokat is beleértve). A szolgáltatás ugyanannyi bájtot olvas be, mint a céltartomány (hosszeltolás).
- source_content_md5
- bytes
Ha meg van adva, a szolgáltatás kiszámítja a blokktartalom MD5-kivonatát, és összehasonlítja ezt az értéket.
- source_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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha a forráserőforrás a megadott időpont óta módosult.
- source_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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha a forráserőforrás nem lett módosítva a megadott dátum/idő óta.
- source_etag
- str
A forrás ETag értéke vagy a 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 működik-e.
- source_match_condition
- MatchConditions
A forrásegyeztetés feltétele, amelyet az etagen kell használni.
- lease
- BlobLeaseClient vagy str
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Az érték lehet BlobLeaseClient objektum vagy sztringként megadott bérletazonosító.
- if_sequence_number_lte
- int
Ha a blob sorszáma kisebb vagy egyenlő a megadott értékkel, a kérés folytatódik; ellenkező esetben sikertelen lesz.
- if_sequence_number_lt
- int
Ha a blob sorszáma kisebb a megadott értéknél, a kérés folytatódik; ellenkező esetben sikertelen lesz.
- if_sequence_number_eq
- int
Ha a blob sorszáma megegyezik a megadott értékkel, a kérés folytatódik; ellenkező esetben sikertelen lesz.
- 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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
A cél ETag értéke vagy a 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 működik-e.
- match_condition
- MatchConditions
A célegyeztetés feltétele, amelyet az etagen kell használni.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
A szolgáltatásoldali adatokat a megadott kulccsal titkosítja. Az ügyfél által megadott kulcsokat HTTPS-en keresztül kell használni. Mivel maga a titkosítási kulcs szerepel a kérelemben, biztonságos kapcsolatot kell létesíteni a kulcs átviteléhez.
- encryption_scope
- str
A szolgáltatásban lévő adatok titkosításához használt előre definiált titkosítási hatókör. A titkosítási hatókör a Felügyeleti API használatával hozható létre, és itt név alapján hivatkozhat gombra. Ha a tárolóban alapértelmezett titkosítási hatókör van meghatározva, ez az érték felülbírálja azt, ha a tárolószintű hatókör úgy van konfigurálva, hogy engedélyezze a felülbírálásokat. Ellenkező esetben hiba lép fel.
A 12.2.0-s verzió újdonságai.
- 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.
- source_authorization
- str
Hitelesítés szolgáltatásnévként egy titkos ügyfélkód használatával egy forrásblob eléréséhez. Győződjön meg arról, hogy a "tulajdonos" a source_authorization sztring előtagja.
Attribútumok
api_version
A Kérésekhez használt Storage API verziója.
location_mode
Az ügyfél által jelenleg használt helyalapú mód.
Alapértelmezés szerint ez az "elsődleges" lesz. A lehetőségek 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
Ha konfigurálva van, a teljes másodlagos végpont URL-címe.
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
secondary_hostname
A másodlagos végpont állomásneve.
Ha nem érhető el, akkor a Nincs érték jelenik meg. 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
Azure SDK for Python
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: