Put Blob

  • Cikk

A Put Blob művelet létrehoz egy új blokkot, lapot vagy hozzáfűző blobot, vagy frissíti egy meglévő blokkblob tartalmát. A Put Blob művelet felülírja egy azonos nevű meglévő blob összes tartalmát.

Egy meglévő blokkblob frissítésekor felülírja a blob meglévő metaadatait. A meglévő blob tartalma felülíródik az új blob tartalmával. A részleges frissítések nem támogatottak a használatával Put Blob. A blokkblob tartalmának részleges frissítéséhez használja a Blokklista elhelyezése műveletet.

Hozzáfűző blobot csak a 2015-02-21-s és újabb verziókban hozhat létre.

Egy lapblob vagy hozzáfűző blob létrehozására irányuló hívás Put Blob csak inicializálja a blobot. Ha a blob már létezik, a tartalom törlődik. Ha tartalmat szeretne hozzáadni egy lapblobhoz, hívja meg az Oldal elhelyezése műveletet. Ha tartalmat szeretne hozzáadni egy hozzáfűző blobhoz, hívja meg a Hozzáfűzési blokk műveletet.

Kérés

A kérést a Put Blob következőképpen hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

PUT metódus kérésének URI-ja HTTP-verzió
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Emulált tárolási szolgáltatás kérése

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és a Blob-szolgáltatás portját 127.0.0.1:10000, majd az emulált tárfiók nevét:

PUT metódus kérésének URI-ja HTTP-verzió
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

A tárolóemulátor csak a 2 gibibyte-os (GiB) blobméreteket támogatja.

További információ: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg:

Paraméter Leírás
timeout Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob-szolgáltatásműveletekhez.

Kérelemfejlécek (minden blobtípus)

Az összes blobtípushoz szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:

Kérelem fejléce Leírás
Authorization Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
Date vagy x-ms-date Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba.
x-ms-version Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
Content-Length Kötelező. A kérelem hossza.

Lapblob vagy hozzáfűző blob esetén ennek a fejlécnek az értékét nullára kell állítani, mert a Put Blob csak a blob inicializálására szolgál. Ha tartalmat szeretne írni egy meglévő lapblobba, hívja a Lap elhelyezése parancsot. Ha tartalmat szeretne írni egy hozzáfűző blobba, hívja meg a Hozzáfűzési blokkot.
Content-Type Választható. A blob MIME-tartalomtípusa. Az alapértelmezett típus a .application/octet-stream
Content-Encoding Választható. Meghatározza, hogy mely tartalomkódolások lettek alkalmazva a blobra. Ez az érték akkor lesz visszaadva az ügyfélnek, ha a Blob lekérése műveletet hajtja végre a bloberőforráson. Ha ezt az értéket adja vissza, az ügyfél azt használhatja a blobtartalom dekódolásához.
Content-Language Választható. Meghatározza az erőforrás által használt természetes nyelveket.
Content-MD5 Választható. A blobtartalom MD5-kivonata. Ez a kivonat a blob integritásának ellenőrzésére szolgál az átvitel során. Ha ez a fejléc meg van adva, a társzolgáltatás ellenőrzi az elküldött kivonatot. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul.

Ha a fejléc nincs megadva a 2012-02-12-es vagy újabb verzióban, a Blob Storage létrehoz egy MD5-kivonatot.

A Blob lekérése, a Blob tulajdonságainak lekérése és a Listablobok találatai közé tartozik az MD5 kivonat.
x-ms-content-crc64 Választható. A blobtartalom CRC64-kivonata. Ez a kivonat a blob integritásának ellenőrzésére szolgál az átvitel során. Ha ez a fejléc meg van adva, a társzolgáltatás ellenőrzi az elküldött kivonatot. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul. Ez a fejléc a 2019.02.02-i és újabb verziókban támogatott.

Ha a Content-MD5 és az x-ms-content-crc64 fejléc is jelen van, a kérés 400-zal (hibás kéréssel) meghiúsul.
Cache-Control Választható. A Blob Storage tárolja ezt az értéket, de nem használja és nem módosítja.
x-ms-blob-content-type Választható. Adja meg a blob tartalomtípusát.
x-ms-blob-content-encoding Választható. Állítsa be a blob tartalomkódolását.
x-ms-blob-content-language Választható. Állítsa be a blob tartalomnyelvét.
x-ms-blob-content-md5 Választható. Állítsa be a blob MD5 kivonatát.
x-ms-blob-cache-control Választható. Beállítja a blob gyorsítótár-vezérlését.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Kötelező. Meghatározza a létrehozandó blob típusát: blokkblob, lapblob vagy hozzáfűző blob. A hozzáfűző blobok létrehozásának támogatása csak a 2015-02-21-es és újabb verziókban érhető el.
x-ms-meta-name:value Választható. A blobhoz metaadatként társított név-érték párok.

Megjegyzés: A 2009-09-19-es verziótól a metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak.
x-ms-encryption-scope Választható. A kérelem tartalmának titkosításához használandó titkosítási hatókört jelöli. Ez a fejléc a 2019-02-02-s és újabb verziókban támogatott.
x-ms-encryption-context Választható. Az alapértelmezett érték az "Üres". Ha az érték be van állítva, akkor a blobrendszer metaadatait állítja be. Maximális hossz-1024. Csak akkor érvényes, ha a fiókhoz engedélyezve van a hierarchikus névtér. Ez a fejléc a 2021-08-06-os és újabb verziókban támogatott.
x-ms-tags Választható. Beállítja a megadott lekérdezési sztring kódolású címkét a blobon. További információért tekintse meg a Megjegyzések című témakört. A 2019-12-12-es és újabb verziókban támogatott.
x-ms-lease-id:<ID> Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Ha ezt a műveletet aktív bérlettel rendelkező blobon szeretné végrehajtani, adja meg a fejléc érvényes bérletazonosítóját.
x-ms-blob-content-disposition Választható. Beállítja a blob fejlécét Content-Disposition . A 2013-08-15-ös és újabb verziókhoz érhető el.

A Content-Disposition válasz fejlécmezője további információkat közöl a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására is használható. Ha például a fejléc attachmentértéke , az azt jelzi, hogy a felhasználói ügynök nem jelenítse meg a választ. Ehelyett egy Mentés másként párbeszédpanelt kell megjelenítenie a megadott blobnéven kívül más fájlnévvel.

A Blob lekérése és a Blob tulajdonságainak lekérése művelet válasza tartalmazza a fejlécet content-disposition .
Origin Választható. Meghatározza, hogy a kérelem melyik forrásból legyen kibocsátva. Ennek a fejlécnek a jelenléte az eltérő eredetű erőforrások megosztását (CORS) eredményezi a válaszban. További információ: CORS-támogatás az Azure Storage-szolgáltatásokhoz.
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít az elemzési naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Tudnivalók a Storage Analytics naplózásáról.
x-ms-access-tier Választható. A blobon beállítandó szint. Csak a 2017-04-17-es és újabb verziójú Premium Storage-fiók lapblobok esetében. A lapblob által támogatott szintek teljes listáját lásd: Nagy teljesítményű prémium szintű tárolás és virtuális gépek felügyelt lemezei. Blokkblobok esetén csak a 2018-11-09-es és újabb verziójú blobtárolók vagy általános célú v2-fiókok támogatottak. A blokkblobszintek érvényes értékei a következők: Hot, Cool, Coldés Archive. Megjegyzés: Cold a szint a 2021-12-02-es és újabb verziókban támogatott. A blokkblobok rétegzésével kapcsolatos részletes információkért lásd: Gyakori elérésű, ritka elérésű és archív tárolási szintek.
x-ms-immutability-policy-until-date 2020-06-12-es és újabb verzió. Megadja a blobon beállítandó adatmegőrzési dátumot. Ez az a dátum, amíg a blob nem módosítható vagy törölhető. RFC1123 formátumot követi.
x-ms-immutability-policy-mode 2020-06-12-es és újabb verzió. Meghatározza a blobon beállítandó módosíthatatlansági szabályzatmódot. Az érvényes értékek a következők: unlocked és locked. A használatával unlockeda felhasználók módosíthatják a házirendet a megőrzési dátum növelésével vagy csökkentésével. A használata lockedesetén ezek a műveletek tiltottak.
x-ms-legal-hold 2020-06-12-es és újabb verzió. Megadja a blobon beállítandó jogi célú visszatartást. Az érvényes értékek a következők: true és false.
x-ms-expiry-option Választható. 2023-08-03-es és újabb verzió. Megadja a kérelem lejárati dátumának beállítását. További információ: ExpiryOption. Ez a fejléc érvényes a hierarchikus névtérrel rendelkező fiókokra.
x-ms-expiry-time Választható. 2023-08-03-es és újabb verzió. Megadja, hogy a blob mikor járjon le. A lejárati dátum formátuma a következő szerint változik: x-ms-expiry-option. További információ: ExpiryOption. Ez a fejléc érvényes a hierarchikus névtérrel rendelkező fiókokra.

Ez a művelet a feltételes fejlécek használatát is támogatja a blob írásához, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.

Kérelemfejlécek (csak lapblobok esetén)

A csak lapblobokon végzett műveletekre vonatkozó kérelemfejléceket az alábbi táblázat ismerteti:

Kérelem fejléce Leírás
x-ms-blob-content-length: bytes Lapblobokhoz szükséges. Ez a fejléc határozza meg az oldalblob maximális méretét, legfeljebb 8 terabájtig (TiB). Az oldalblob méretét egy 512 bájtos határhoz kell igazítani.

Ha ez a fejléc blokkblobhoz vagy hozzáfűző blobhoz van megadva, a Blob Storage a 400 -os állapotkódot adja vissza (hibás kérés).
x-ms-blob-sequence-number: <num> Választható. Csak lapblobok esetén van beállítva. A sorszám egy felhasználó által vezérelt érték, amellyel nyomon követheti a kéréseket. A sorszám értéke 0 és 2^63 – 1 között lehet. Az alapértelmezett érték a 0.
x-ms-access-tier 2017-04-17-es és újabb verzió. Csak prémium szintű tárfiókban lévő lapblobok esetén. Meghatározza a blobon beállítandó szintet. A támogatott szintek teljes listájáért lásd: Nagy teljesítményű prémium szintű tárolás és felügyelt lemezek virtuális gépekhez.
x-ms-client-request-id Ez a fejléc a kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor az nem jelenik meg a válaszban.

Kérelemfejlécek (ügyfél által biztosított titkosítási kulcsok)

A 2019-02-02-es verziótól a következő fejlécek adhatók meg a blob ügyfél által megadott kulccsal történő titkosítására irányuló kérelemben. Az ügyfél által megadott kulccsal (és a megfelelő fejléckészlettel) történő titkosítás nem kötelező.

Kérelem fejléce Leírás
x-ms-encryption-key Kötelező. A Base64 kódolású AES-256 titkosítási kulcs.
x-ms-encryption-key-sha256 Kötelező. A titkosítási kulcs Base64 kódolású SHA256 kivonata.
x-ms-encryption-algorithm: AES256 Kötelező. Megadja a titkosításhoz használandó algoritmust. A fejléc értékének a következőnek kell lennie AES256: .

A kérés törzse

Blokkblobok esetén a kérelemtörzs tartalmazza a blob tartalmát.

Lapblob vagy hozzáfűző blob esetén a kérelemtörzs üres.

Mintakérés

Az alábbi példa egy blokkblob létrehozására vonatkozó kérést mutat be:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Ez a mintakérés létrehoz egy lapblobot, és a maximális méretét 1024 bájtként adja meg. Ha tartalmat szeretne hozzáadni egy lapblobhoz, fel kell hívnia az Oldal elhelyezése parancsot:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Ez a mintakérés egy hozzáfűző blobot hoz létre. Ha tartalmat szeretne hozzáadni a hozzáfűző blobhoz, hívja meg a Hozzáfűző blokkot:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Állapotkód

A sikeres művelet a 201-et (Létrehozva) állapotkódot adja vissza.

További információ az állapotkódokról: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc Description
ETag Olyan értéket tartalmaz, amellyel az ügyfél feltételes PUT műveleteket hajthat végre a If-Match kérelemfejléc használatával. Ha a kérelem verziója 2011-08-18 vagy újabb, az ETag érték idézőjelek közé kerül.
Last-Modified A blob utolsó módosításának dátuma/időpontja. A dátumformátum az RFC 1123-at követi. További információ: Dátum-/időértékek ábrázolása fejlécekben.

A blob írási műveletei (beleértve a blob metaadatainak vagy tulajdonságainak frissítéseit is) módosítják a blob utolsó módosítási időpontját.
Content-MD5 Visszaküldött egy blokkblobot, hogy az ügyfél ellenőrizhesse az üzenet tartalmának integritását. A Content-MD5 visszaadott értéket a Blob Storage számítja ki. A 2012-02-12-es és újabb verziókban a rendszer akkor is visszaadja ezt a fejlécet, ha a kérés nem tartalmaz Content-MD5 vagy x-ms-blob-content-md5 fejléceket.
x-ms-content-crc64 Visszaküldött egy blokkblobot, hogy az ügyfél ellenőrizhesse az üzenettartalom integritását. A x-ms-content-crc64 visszaadott értéket a Blob Storage számítja ki. Ez a fejléc mindig a 2019-02-02-es verziótól lesz visszaadva.
x-ms-request-id Egyedileg azonosítja a végrehajtott kérést, és segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása.
x-ms-version A kérés végrehajtásához használt Blob Storage-verziót jelzi. A 2009-09-19-es és újabb verzióval kapcsolatos kérések visszaadva.
Date A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
Access-Control-Allow-Origin Akkor adja vissza, ha a kérelem tartalmaz fejlécet Origin , és a CORS engedélyezve van egy megfelelő szabmánnyal. Ez a fejléc visszaadja a forráskérés fejlécének értékét, ha van egyezés.
Access-Control-Expose-Headers Akkor adja vissza, ha a kérelem tartalmaz fejlécet Origin , és a CORS engedélyezve van egy megfelelő szabmánnyal. Azon válaszfejlécek listáját adja vissza, amelyeket elérhetővé kell tenni az ügyfélnek vagy a kérés kiállítójának.
Access-Control-Allow-Credentials Akkor adja vissza, ha a kérelem tartalmaz egy fejlécet Origin , és a CORS engedélyezve van egy olyan egyező szabánnyal, amely nem engedélyezi az összes forrást. Ez a fejléc igaz értékre van állítva.
x-ms-request-server-encrypted: true/false 2015-12-11-es és újabb verziók. Ennek a fejlécnek az értéke akkor van beállítva, true ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. Ellenkező esetben az érték .false
x-ms-encryption-key-sha256 2019-02-02-es és újabb verzió. Akkor adja vissza, ha a kérés ügyfél által megadott kulcsot használt a titkosításhoz, hogy az ügyfél a megadott kulccsal biztosítsa a kérés tartalmának sikeres titkosítását.
x-ms-encryption-scope 2019-02-02-es és újabb verzió. Akkor adja vissza, ha a kérés titkosítási hatókört használt, hogy az ügyfél a titkosítási hatókör használatával biztosítsa a kérés tartalmának sikeres titkosítását.
x-ms-version-id: <DateTime> 2019-12-12-es és újabb verzió. Ez a fejléc egy átlátszatlan DateTime értéket ad vissza, amely egyedileg azonosítja a blobot. Ennek a fejlécnek az értéke a blob verzióját jelzi, és a blob elérésére irányuló későbbi kérésekben is használható.

Választörzs

Nincsenek.

Mintaválasz

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Put Blob alábbiak szerint engedélyezheti.

Ha egy kérés címkéket ad meg a x-ms-tags kérelem fejlécével, a hívónak meg kell felelnie a Blobcímkék beállítása művelet engedélyezési követelményeinek.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Put Blob műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Megjegyzések

Blob létrehozásakor a fejléc értékének x-ms-blob-type megadásával meg kell adnia, hogy blokkblobról, hozzáfűző blobról vagy lapblobról van-e szó. A blob létrehozása után a blob típusa csak akkor módosítható, ha törölték és újra létrehozták.

Az alábbi táblázat a maximálisan engedélyezett blokk- és blobméreteket ismerteti szolgáltatásverzió szerint:

Szolgáltatás verziója Maximális blokkméret (a használatával Put Block) Maximális blobméret (a használatával Put Block List) Maximális blobméret egyetlen írási művelettel (a használatával Put Blob)
2019-12-12-es és újabb verziók 4000 mebájt (MiB) Körülbelül 190,7 TiB (4000 MiB × 50 000 blokk) 5000 MiB
2016-05-31-2019-07-07 verzió 100 MiB Körülbelül 4,75 TiB (100 MiB × 50 000 blokk) 256 MiB
2016-05-31-nél korábbi verziók 4 MiB Körülbelül 195 GiB (4 MiB × 50 000 blokk) 64 MiB

Ha olyan blokkblobot próbál feltölteni, amely nagyobb, mint az adott szolgáltatásverzió megengedett maximális mérete, vagy egy 8 TiB-nál nagyobb lapblobot próbál feltölteni, a szolgáltatás a 413-es állapotkódot adja vissza (a kérelem entitása túl nagy). A Blob Storage további információkat is ad vissza a válaszban szereplő hibáról, beleértve a maximálisan megengedett blobméretet is bájtban.

Új lapblob létrehozásához először inicializálja a blobot a meghívásával Put Blob, majd adja meg a maximális méretét, legfeljebb 8 TiB-ig. Lapblob létrehozásakor ne tartalmazzon tartalmat a kérelem törzsében. A blob létrehozása után hívja fel az Put Page függvényt a blob tartalom hozzáadásához vagy módosításához.

Új hozzáfűző blob létrehozásához hívja Put Blob meg a 0 bájtos tartalomhosszúságú blobot. A hozzáfűző blob létrehozása után hívja meg a Hozzáfűző blokkot , hogy tartalmat adjon hozzá a végéhez.

Ha egy azonos nevű meglévő blob felülírására hívja meg a meghívást Put Blob , az eredeti blobhoz társított pillanatképek megmaradnak. A társított pillanatképek eltávolításához először hívja meg a Blob törlése parancsot, majd hívja Put Blob meg újra a blobot.

Egyéni blobtulajdonságok

A blobok egyéni (fejléceken keresztül beállított) tulajdonságokkal rendelkeznek, amelyekkel a szabványos HTTP-fejlécekhez társított értékeket tárolhatja. Ezt követően elolvashatja ezeket az értékeket a Blob tulajdonságainak lekérése meghívásával, vagy módosíthatja őket a Blobtulajdonságok beállítása meghívásával. Az egyéni tulajdonságfejlécek és a megfelelő szabványos HTTP-fejlécek az alábbi táblázatban találhatók:

HTTP-fejléc Egyéni blobtulajdonság fejléce
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

A tulajdonságértékek blobokkal való beállításának vagy megőrzésének szemantikája a következő:

  • Ha az ügyfél egyéni tulajdonságfejlécet ad meg az előtag által jelzett módon, ezt az x-ms-blob értéket a blob tárolja.

  • Ha az ügyfél egy szabványos HTTP-fejlécet ad meg, az egyéni tulajdonság fejlécét azonban nem, akkor az érték a blobhoz társított megfelelő egyéni tulajdonságban lesz tárolva, és a hívása Get Blob Propertiesadja vissza. Ha például az ügyfél beállítja a Content-Type kérelem fejlécét, az érték a blob tulajdonságában x-ms-blob-content-type lesz tárolva.

  • Ha az ügyfél ugyanarra a kérelemre a standard HTTP-fejlécet és a megfelelő tulajdonságfejlécet is beállítja, a PUT kérés a standard HTTP-fejléchez megadott értéket használja, de az egyéni tulajdonságfejléchez megadott érték megmarad a blobban, és a későbbi GET-kérések visszaadják.

Ha a x-ms-tags fejlécben címkék vannak megadva, akkor a lekérdezési sztringet kódolni kell. A címkekulcsoknak és -értékeknek meg kell felelniük a következőben Set Blob Tagsmeghatározott elnevezési és hosszkövetelményeknek: . Emellett a x-ms-tags fejléc legfeljebb 2 kb címkét tartalmazhat. Ha további címkékre van szükség, használja a Blobcímkék beállítása műveletet.

Ha a blob rendelkezik aktív bérlettel, az ügyfélnek érvényes bérletazonosítót kell megadnia a blob felülírására irányuló kérelemhez. Ha az ügyfél nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, a Blob Storage a 412-ös állapotkódot adja vissza (az előfeltétel sikertelen). Ha az ügyfél megad egy bérletazonosítót, de a blobnak nincs aktív bérlete, a Blob Storage a 412-ös állapotkódot is visszaadja (az előfeltétel sikertelen). Ha az ügyfél egy még nem létező blob bérletazonosítóját adja meg, a Blob Storage a 2013-08-15-es és újabb verzióval kapcsolatos kérések esetében a 412-es állapotkódot adja vissza (az előfeltétel sikertelen). A 2013-08-15-nél korábbi verziók esetén a Blob Storage a 201 (Létrehozva) állapotkódot adja vissza.

Ha egy meglévő, aktív bérlettel rendelkező blobot felülír egy Put Blob művelet, a bérlet a frissített blobon marad, amíg el nem jár vagy fel nem szabadul.

Egy Put Blob művelet végrehajtása MiB-enként 10 percet vehet igénybe. Ha a művelet átlagosan 10 percnél tovább tart MiB-enként, a művelet túllépi az időkorlátot.

A archive blob felülírása meghiúsul, és egy hot vagy cool blob felülírása örökli a szintet a régi blobtól, ha x-ms-access-tier nincs megadva fejléc.

ExpiryOption

Az alábbi értékeket elküldheti fejlécként x-ms-expiry-option . Ez a fejléc nem különbözteti meg a kis- és nagybetűt.

Lejárati beállítás Description
RelativeToNow Beállítja a lejárati dátumot az aktuális időponthoz viszonyítva. x-ms-expiry-time A jelenlegi időponttól eltelt ezredmásodpercek számaként kell megadni.
Absolute x-ms-expiry-time abszolút időként kell megadni, RFC 1123 formátumban.
NeverExpire Beállítja, hogy a blob soha ne járjon le, vagy eltávolítja az aktuális lejárati dátumot. x-ms-expiry-time nem szabad megadni.

A lejárati dátum blobokon való beállításának szemantikája a következő:

  • Set Expiry csak egy blobon állítható be, könyvtárban nem.
  • Set ExpiryexpiryTime a múltban nem engedélyezett.
  • ExpiryTime értéke nem adható meg expiryOptionNever.

Számlázás

A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Put Blob mutatja be:

Művelet Tárfiók típusa Számlázási kategória
Put Blob Prémium szintű blokkblob
Standard általános célú v2
Standard általános célú v1		 Írási műveletek

A megadott számlázási kategória díjszabásáról a Azure Blob Storage Díjszabás című témakörben talál további információt.

Lásd még

Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok
Blobszolgáltatás hibakódjai
Időtúllépések beállítása blobszolgáltatás-műveletekhez