azure.storage.blob.aio.BlobClient class

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.

async abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

Paraméterek

copy_id: str vagy BlobProperties

Kötelező

A másolási művelet megszakítása. Ez lehet egy azonosító vagy egy BlobProperties-példány.

Visszatérési típus

None

Új bérletet kér.

Ha a blob nem rendelkezik aktív bérletekkel, a Blob Service létrehoz egy bérletet a blobon, és új bérletet ad vissza.

async acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient

Paraméterek

lease_duration: int

Kötelező

Megadja a bérlet időtartamát másodpercben, vagy negatívat (-1) egy olyan bérlethez, 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

Kötelező

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átumú.

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

BlobLeaseClient objektum.

Visszatérési típus

BlobLeaseClient

Új adatblokkot véglegesíti a meglévő hozzáfűző blob végéig.

async append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Paraméterek

data

Kötelező

A blokk tartalma.

length: int

Kötelező

A blokk mérete bájtban.

validate_content: bool

Ha igaz, a blokktartalom MD5-kivonatát számítja ki. 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.

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

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.

cpk: CustomerProvidedEncryptionKey

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

dict(str, Any)

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.

async 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

Kötelező

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

Kötelező

Ez a másolási forrásból átveendő bájttartomány kezdetét jelzi (a bájtokat is beleértve).

source_length: int

Kötelező

Ez a másolási forrásból átveendő bájttartomány végét jelzi.

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.

cpk: CustomerProvidedEncryptionKey

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.

Egy oldaltartomány törlése.

async clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

Paraméterek

offset: int

Kötelező

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

Kötelező

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

cpk: CustomerProvidedEncryptionKey

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

dict(str, Any)

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.

async close()

A Blokklista véglegesítése művelet egy blobot ír a blobokat alkotó blokkazonosítók listájának megadásával.

async 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

block_list: list

Kötelező

A Blockblobs listája.

content_settings: ContentSettings

Kötelező

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.

metadata: dict[str, str]

Kötelező

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

tags: dict(str, str)

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ő blobon működjön. például: "\"tagname\"='my tag'"

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.

cpk: CustomerProvidedEncryptionKey

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

dict(str, Any)

Létrehoz egy új hozzáfűző blobot. Ez a művelet egy új, 0 hosszúságú hozzáfűző blobot hoz létre. 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 az vagy append_block_from_url metódustappend_block.

async 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

Kötelező

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.

metadata: dict(str, str)

Kötelező

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

tags: dict(str, str)

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.

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.

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.

cpk: CustomerProvidedEncryptionKey

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

dict[str, Any]

Létrehoz egy új lapblobot a megadott méretben.

async 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

Kötelező

Ez határozza meg az oldalblob maximális méretét, legfeljebb 1 TB-ig. Az oldalblob méretét egy 512 bájtos határhoz kell igazítani.

content_settings: ContentSettings

Kötelező

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.

metadata: dict(str, str)

Kötelező

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

premium_page_blob_tier: PremiumPageBlobTier

Kötelező

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.

tags: dict(str, str)

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.

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ékének 0 és 2^63 – 1 közé kell esnie. 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 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 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.

cpk: CustomerProvidedEncryptionKey

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

dict[str, Any]

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.

async create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Paraméterek

metadata: dict(str, str)

Kötelező

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

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.

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

cpk: CustomerProvidedEncryptionKey

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ő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

dict[str, Any]

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.aio.undelete> állíthatók vissza.

async delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

Paraméterek

delete_snapshots: str

Kötelező

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

None

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.

async 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

Dict[str, str]

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. A chunks() használatával egy aszinkron iterátort ad vissza, amely lehetővé teszi a felhasználó számára, hogy az adattömbökben lévő tartalom fölé iteráljon.

async download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

Paraméterek

offset: int

Kötelező

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

Kötelező

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.

cpk: CustomerProvidedEncryptionKey

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.

progress_hook: Callable[[int, int], Awaitable[None]]

Aszinkron 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

StorageStreamDownloader

Igaz értéket ad vissza, ha egy blob létezik a megadott paraméterekkel, és máskülönben Hamis értéket ad vissza.

async 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

bool

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

Kötelező

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:./>

alapértelmezett érték: None

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

alapértelmezett érték: None

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

BlobClient

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

conn_str: str

Kötelező

Egy Azure Storage-fiókhoz kapcsolati karakterlánc.

container_name: str

Kötelező

A blob tárolóneve.

blob_name: str

Kötelező

Annak a blobnak a neve, amellyel kommunikálni szeretne.

snapshot: str

alapértelmezett érték: None

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:./>

alapértelmezett érték: None

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

BlobClient

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

async get_account_information(**kwargs: int | None) -> Dict[str, str]

Válaszok

A fiókadatok (termékváltozat és fiók típusa) diktálása.

Visszatérési típus

dict(str, str)

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.

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

cpk: CustomerProvidedEncryptionKey

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

BlobProperties

A Címkék lekérése művelet lehetővé teszi, hogy a felhasználók címkéket kérjenek le egy blob vagy adott blobverzió esetében, de pillanatképet nem.

Új a 12.4.0-s verzióban: Ezt a műveletet a "2019-12-12" API-verzióban vezettük be.

async 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ő blobokon 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

Dict[str, str]

A Blokklista lekérése művelet lekéri a blokkblob részeként feltöltött blokkok listáját.

async get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

Paraméterek

block_list_type: str

Kötelező

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ő 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

Két lista rekordja – véglegesített és nem véglegesített blokkok

Visszatérési típus

tuple(list(BlobBlock), list(BlobBlock))

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.

A 12.2.0-s verzió újdonságai: Ezt a műveletet az API 2019-07-07-es verziójában vezettük be.

async 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

Kötelező

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

Kötelező

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árokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.

length: int

Kötelező

É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árokhoz 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 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

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

tuple(list(dict(str, str), list(dict(str, str))

ELAVULT: Egy lapblob érvényes oldaltartományainak listáját vagy egy lapblob pillanatképét adja vissza.

async 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

Kötelező

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árokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.

length: int

Kötelező

É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árokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.

previous_snapshot_diff: str

Kötelező

A snapshot diff paraméter, amely egy átlátszatlan DateTime értéket tartalmaz, amely egy korábbi blobpillanatké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 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

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

tuple(list(dict(str, str), list(dict(str, str))

Egy oldalblob é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 elváltozása lesz.

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> AsyncItemPaged[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árokhoz 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árokhoz kell igazítani, a kezdő eltolásnak 512-nek kell lennie, a hossznak pedig 512-nek kell lennie.

previous_snapshot: str vagy Dict[str, Any]

Egy pillanatkép-érték, amely azt határozza meg, hogy a válasz csak a célblob és az előző pillanatkép között módosított lapokat tartalmazza. A módosított lapok közé tartoznak a frissített és a törölt lapok is. A célblob lehet egy pillanatkép, ha az 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 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.

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őkorlátok konfigurálását itt találja.

Válaszok

A PageRange iterable (automatikus lapozás) eleme.

Visszatérési típus

ItemPaged[PageRange]

Egyszerű lekérdezési kifejezések megadásával lehetővé teszi a felhasználók számára a blob-/vagy blob-pillanatkép-adatok kiválasztását/projektet. Ez a művelet 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ő

Kötelező. lekérdezési utasítás. 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. Ezt felül lehet bírálni egyéni DelimitedTextDialect vagy DelimitedJsonDialect vagy "ParquetDialect" (sztringként vagy számként átadva). Ezek a dialektusok átadhatók a megfelelő osztályokon, a QuickQueryDialect enumerálásán 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 megjelenített módon lesznek visszaadva (a Parquet formátum alapértelmezés szerint DelimitedTextDialect). A kimeneti formátum megadásával a blobadatok a profilnak megfelelően lesznek újraformálva. Ez az érték lehet DelimitedTextDialect vagy DelimitedJsonDialect vagy ArrowDialect. Ezek a dialektusok átadhatók a megfelelő osztályokon, a QuickQueryDialect enumerálásán 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 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.

cpk: CustomerProvidedEncryptionKey

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

Streamelési objektum (BlobQueryReader)

Visszatérési típus

BlobQueryReader

Á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 lap törlődik.

async resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

Paraméterek

size: int

Kötelező

A blob átméretezéséhez használt méret. Az oldalblobok 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 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.

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.

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

dict(str, Any)

A Seal művelet lezárja a hozzáfűző blobot, hogy írásvédetté tegye.

A 12.4.0-s verzió újdonsága.

async 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 – 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.

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

dict(str, Any)

A blob felhasználó által definiált metaadatait egy vagy több név-érték párként állítja be.

async set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Paraméterek

metadata: dict(str, str)

Kötelező

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

cpk: CustomerProvidedEncryptionKey

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)

A Címkék beállítása művelettel a felhasználók címkéket állíthatnak be egy blobon vagy adott blobverzión, a pillanatképet azonban 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 úgy, hogy nincs beállítva címke.

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

async set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

Paraméterek

tags: dict(str, str)

Kötelező

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 (_)

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.

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 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_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'"

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

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

Dict[str, Any]

Beállítja a blob rendszertulajdonságokat.

Ha az content_settings egy tulajdonság van beállítva, az összes tulajdonság felül lesz bírálva.

async set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

Paraméterek

content_settings: ContentSettings

Kötelező

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

Dict[str, Any]

Az Immutability Policy beállítása művelet beállítja a blob módosíthatatlansági szabályzatát.

Újdonság a 12.10.0-s verzióban: Ez a művelet a "2020-10-02" API-verzióban jelent meg.

async set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

Paraméterek

immutability_policy: ImmutabilityPolicy

Kötelező

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.

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

Dict[str, str]

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.

async set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

Paraméterek

legal_hold: bool

Kötelező

Meg van adva, ha jogi célú visszatartást kell beállítani a blobon.

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

Dict[str, Union[str, datetime, bool]]

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.

async set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

Paraméterek

premium_page_blob_tier: PremiumPageBlobTier

Kötelező

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

None

Beállítja a blobsorozat számát.

async set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs) -> Dict[str, str | datetime]

Paraméterek

sequence_number_action: str

Kötelező

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

Kötelező

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

dict(str, Any)

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.

async set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

Paraméterek

standard_blob_tier: str vagy StandardBlobTier

Kötelező

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

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

None

Létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve.

async stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> None

Paraméterek

block_id: str

Kötelező

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

Kötelező

A blobadatok.

length: int

Kötelező

A blokk mérete.

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.

cpk: CustomerProvidedEncryptionKey

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.

Visszatérési típus

None

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.

async 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) -> None

Paraméterek

block_id: str

Kötelező

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_url: str

Kötelező

Az URL-cím.

source_offset: int

Kötelező

A blokkhoz használandó bájttartomány kezdete. Meg kell adni, ha a forrás hossza meg van adva.

source_length: int

Kötelező

A blokk mérete bájtban.

source_content_md5: bytearray

Kötelező

Adja meg a másolási forrásból beolvasandó bájttartományhoz 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 megadott bérletazonosító.

cpk: CustomerProvidedEncryptionKey

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.

Visszatérési típus

None

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 akkor lesz "sikeres", ha a másolat szinkronban fejeződött be, vagy "függőben" van, ha a másolat aszinkron módon lett elindítva. 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 szinkron legyen. A Blob szolgáltatás a legjobb munkamennyiség alapján 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ó, amíg a másolási művelet folyamatban van.

Lapblobból való másoláskor a Blob szolgáltatás létrehoz egy céllapblobot a forrásblob hosszából, amely kezdetben az összes nullát tartalmazza. Ezután a forráslaptartományok felsorolása és a nem üres tartományok másolása.

Blokkblob vagy hozzáfűző blob esetén a Blob szolgáltatás nulla hosszúságú végleges blobot hoz létre, mielőtt visszatér ebből a műveletből. Blokkblobból történő másoláskor a rendszer minden véglegesített blokkot és azok blokkazonosítóját átmá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ámú lesz, mint a forrás.

A hozzáfűző blobból történő másoláskor a program minden véglegesített blokkot átmásol. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámú lesz, mint a forrás.

async 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

Kötelező

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

metadata: dict(str, str)

Kötelező

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

Kötelező

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.

tags: dict(str, str) vagy Literal["COPY"]

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.

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.

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

dict[str, Union[str, datetime]]

Helyreállítja a helyreállíthatóan törölt blobokat vagy pillanatképeket.

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

Ha a blobverziózás 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 mozdítani az aktuális verzióra.

async 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őtúllépések konfigurálásához lásd itt.

Visszatérési típus

None

Új blobot hoz létre egy adatforrásból automatikus adattömbökkel.

async upload_blob(data: bytes | str | Iterable | AsyncIterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]

Paraméterek

data

Kötelező

A feltöltendő blobadatok.

blob_type: BlobType

Kötelező

A blob típusa. Ez lehet BlockBlob, PageBlob vagy AppendBlob. Az alapértelmezett érték a BlockBlob.

length: int

Kötelező

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

metadata: dict(str, str)

Kötelező

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

tags: dict(str, str)

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.

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. A fentiek alól kivételt képeznek a Hozzáfűző blobtípusok: ha a False (Hamis) értékre van állítva, és az adatok már léteznek, a rendszer nem hoz létre hibát, és az adatok hozzá lesznek fűzve a meglévő blobhoz. Ha az overwrite=True értéket állítja be, 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, 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

Ha meg van adva, upload_blob csak akkor lesz sikeres, ha a blob bérlete aktív, és megfelel ennek az azonosítónak. Akkor szükséges, ha a blob rendelkezik aktív bérlettal.

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.

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.

immutability_policy: ImmutabilityPolicy

Meghatározza a blob, a blob pillanatképe vagy a blobverzió módosíthatósági szabályzatát. A upload_blob() API paramétere jelenleg csak a BlockBlobhoz tartozik.

Ú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. A upload_blob() API paramétere jelenleg csak a BlockBlobhoz tartozik.

Új a 12.10.0-s verzióban: Ezt az API 2020-10-02-es verziójában vezettük be.

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.

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

max_concurrency: int

A párhuzamos kapcsolatok maximális száma, ha a blob mérete meghaladja a 64 MB-ot.

cpk: CustomerProvidedEncryptionKey

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.

encoding: str

Alapértelmezés szerint UTF-8.

progress_hook: Callable[[int, Optional[int]], Awaitable[None]]

Aszinkron 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 (current: int, total: Optional[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. 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

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

Visszatérési típus

dict[str, Any]

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.

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

Paraméterek

source_url: str

Kötelező

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.

tags: dict(str, str)

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.

cpk: CustomerProvidedEncryptionKey

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.

A Lapok feltöltése művelet oldaltartományt ír egy lapblobba.

async upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

Paraméterek

page: bytes

Kötelező

A lap tartalma.

offset: int

Kötelező

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

Kötelező

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.

cpk: CustomerProvidedEncryptionKey

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

dict(str, Any)

A Lapok feltöltése művelet egy oldaltartományt ír egy lapblobba, ahol a tartalom egy URL-címről van beolvasva.

async upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

Paraméterek

source_url: str

Kötelező

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

Kötelező

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

Kötelező

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

Kötelező

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.

cpk: CustomerProvidedEncryptionKey

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.

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

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

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

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

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

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

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

Kivételek

ValueError

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

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

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

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 blob nem rendelkezik aktív bérletekkel, a Blob Service 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 egy új, 0 hosszúságú hozzáfűző blobot hoz létre. 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 az vagy append_block_from_url 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.aio.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. A chunks() használatával egy aszinkron iterátort ad vissza, amely lehetővé teszi a felhasználó számára, hogy az adattömbökben lévő tartalom fölé 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űvelet lehetővé teszi, hogy a felhasználók címkéket kérjenek le egy blob vagy adott blobverzió esetében, de pillanatképet nem. Ú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. A 12.2.0-s verzió újdonságai: Ezt a műveletet az API 2019-07-07-es verziójában vezettük be.
get_page_ranges	ELAVULT: Egy lapblob érvényes oldaltartományainak listáját vagy egy lapblob pillanatképét adja vissza.
list_page_ranges	Egy oldalblob é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 elváltozása lesz.
query_blob	Egyszerű lekérdezési kifejezések megadásával lehetővé teszi a felhasználók számára a blob-/vagy blob-pillanatkép-adatok kiválasztását/projektet. Ez a művelet 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 lap törlődik.
seal_append_blob	A Seal művelet lezárja a hozzáfűző blobot, hogy írásvédetté tegye. A 12.4.0-s verzió újdonsága.
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űvelettel a felhasználók címkéket állíthatnak be egy blobon vagy adott blobverzión, a pillanatképet azonban 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 úgy, hogy nincs beállítva címke. A 12.4.0-s verzió újdonságai: Ez a művelet a "2019-12-12" API-verzióban jelent meg.
set_http_headers	Beállítja a blob rendszertulajdonságokat. 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 módosíthatatlansági szabályzatát. Ú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	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 akkor lesz "sikeres", ha a másolat szinkronban fejeződött be, vagy "függőben" van, ha a másolat aszinkron módon lett elindítva. 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 szinkron legyen. A Blob szolgáltatás a legjobb munkamennyiség alapján 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ó, amíg a másolási művelet folyamatban van. Lapblobból való másoláskor a Blob szolgáltatás létrehoz egy céllapblobot a forrásblob hosszából, amely kezdetben az összes nullát tartalmazza. Ezután a forráslaptartományok felsorolása és a nem üres tartományok másolása. Blokkblob vagy hozzáfűző blob esetén a Blob szolgáltatás nulla hosszúságú végleges blobot hoz létre, mielőtt visszatér ebből a műveletből. Blokkblobból történő másoláskor a rendszer minden véglegesített blokkot és azok blokkazonosítóját átmá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ámú lesz, mint a forrás. A hozzáfűző blobból történő másoláskor a program minden véglegesített blokkot átmásol. A másolási művelet végén a célblob ugyanazzal a véglegesített blokkszámú lesz, mint a forrás.
undelete_blob	Helyreállítja a helyreállíthatóan törölt blobokat vagy pillanatképeket. A művelet csak akkor lesz sikeres, ha a törlési megőrzési szabályzatban megadott számú napon belül használja. Ha a blobverziózás 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 mozdítani 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.

Megosztás a következőn keresztül:

BlobClient Osztály

Konstruktor

Paraméterek

Metódusok

abort_copy

Paraméterek

Visszatérési típus

acquire_lease

Paraméterek

Válaszok

Visszatérési típus

append_block

Paraméterek

Válaszok

Visszatérési típus

append_block_from_url

Paraméterek

clear_page

Paraméterek

Válaszok

Visszatérési típus

close

commit_block_list

Paraméterek

Válaszok

Visszatérési típus

create_append_blob

Paraméterek

Válaszok

Visszatérési típus

create_page_blob

Paraméterek

Válaszok

Visszatérési típus

create_snapshot

Paraméterek

Válaszok

Visszatérési típus

delete_blob

Paraméterek

Visszatérési típus

delete_immutability_policy

Paraméterek

Válaszok

Visszatérési típus

download_blob

Paraméterek

Válaszok

Visszatérési típus

exists

Paraméterek

Válaszok

Visszatérési típus

from_blob_url

Paraméterek

Válaszok

Visszatérési típus

from_connection_string

Paraméterek

Válaszok

Visszatérési típus

get_account_information

Válaszok

Visszatérési típus

get_blob_properties

Paraméterek

Válaszok

Visszatérési típus

get_blob_tags

Paraméterek

Válaszok

Visszatérési típus

get_block_list

Paraméterek

Válaszok

Visszatérési típus

get_page_range_diff_for_managed_disk

Paraméterek

Válaszok