Put Blob
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 teljes tartalmát.
Meglévő blokkblob frissítésekkor 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 következővel: 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 a blobot inicializálja. 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 az Put Blob
alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:
PUT metóduskérés 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óduskérés URI-ja | HTTP-verzió |
---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
HTTP/1.1 |
A storage emulator csak a legfeljebb 2 gibibájtos (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érelemfejlé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érelmek 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érelmek engedélyezése az Azure Storage-ba. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használandó 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, mivel a Put Blob csak a blob inicializálására használható. Ha tartalmat szeretne írni egy meglévő lapblobba, hívja meg az Oldal 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 következő: application/octet-stream . |
Content-Encoding |
Választható. Meghatározza, hogy mely tartalomkódolások lettek alkalmazva a blobra. Ezt az értéket a rendszer akkor adja vissza az ügyfélnek, ha a Blob lekérése műveletet a bloberőforráson hajtja végre. Ha ezt az értéket adja vissza, az ügyfél felhasználhatja a blob tartalmának dekódolására. |
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árolási szolgáltatás ellenőrzi a kapott kivonatot az elküldöttel szemben. Ha a két kivonat nem egyezik, a művelet a 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árolási szolgáltatás ellenőrzi a kapott kivonatot az elküldöttel szemben. Ha a két kivonat nem egyezik, a művelet a 400-es hibakóddal (hibás kérelem) meghiúsul. Ez a fejléc a 02-02-2019-s é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. A BlockBlob esetében ez a fejléc elsőbbséget Content-MD5 élvez a blob integritásának ellenőrzésekor az átvitel során. A PageBlob és a AppendBlob esetében ez a fejléc közvetlenül beállítja a blob MD5-kivonatát. |
x-ms-blob-cache-control |
Választható. Beállítja a blob gyorsítótár-vezérlőjét. |
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> |
Kötelező. Megadja 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 jelzi. 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, a blobrendszer metaadatait állítja be. Maximális hossz-1024. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. 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éinek a blobon. További információké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álaszfejléc mező további információkat nyújt 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ó-ügynök nem jelenítse meg a választ. Ehelyett meg kell jelennie egy Mentés másként párbeszédpanelnek 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 származik. Ennek a fejlécnek a jelenléte a válasz forrásközi erőforrás-megosztási (CORS-) fejléceit eredményezi. 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 kibibájtos (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ítani kívánt szint. Csak a 2017-04-17-es és újabb verziójú Premium Storage-fiók lapblobok esetében. A lapblobok által 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 (VM-ekhez). 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ók esetében 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 és locked a.unlocked A használatával unlocked a felhasználók módosíthatják a szabályzatot a megőrzési dátum növelésével vagy csökkentésével. A használatával locked ezek a műveletek tiltottak. |
x-ms-legal-hold |
2020-06-12-es és újabb verzió. Megadja a blobon beállítandó jogi visszatartást. Az érvényes értékek a és false a.true |
x-ms-expiry-option |
Választható. 2023-08-03-es és újabb verzió. A kérelem lejárati dátumának beállítását adja meg. 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ó. Meghatározza, 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 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érésfejléceket a következő 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 az oldalblob maximális méretét adja meg, 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-ás állapotkódot adja vissza (hibás kérés). |
x-ms-blob-sequence-number: <num> |
Választható. Csak oldalblobok 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ékének 0 és 2^63 – 1 közöttinek kell lennie. Az alapértelmezett érték a 0. |
x-ms-access-tier |
2017-04-17-es és újabb verzió. Csak prémium szintű tárfiókon lévő lapblobok esetén. Meghatározza a blobon beállítani kívánt szintet. A támogatott szintek teljes listáját 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 kapcsolódó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, é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, az nem jelenik meg a válaszban. |
Kérelemfejlécek (ügyfél által megadott 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 vonatkozó kérésben. 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álni kívánt 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 irányuló 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, hívja meg 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 létrehoz egy hozzáfűző blobot. 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.
Fontos
A Microsoft a Microsoft Entra ID felügyelt identitásokkal való használatát javasolja az Azure Storage felé irányuló kérések engedélyezéséhez. Microsoft Entra ID a megosztott kulcsos hitelesítéshez képest kiemelkedő biztonságot és könnyű használatot biztosít.
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, felügyelt identitás vagy szolgáltatásnév meghívja a műveletet, valamint a legkevésbé emelt jogosultságú beépített Azure RBAC-szerepkört, amely tartalmazza ezt a Put Blob
műveletet:
-
Azure RBAC-művelet:
- Létrehozás új blokkblob: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Létrehozás meglévő blokkblob új vagy felülírása: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Legkevésbé kiemelt beépített szerepkör:Storage-blobadatok közreműködője
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 Properties
adja vissza. Ha például az ügyfél beállítja aContent-Type
kérelem fejlécét, az érték a blob tulajdonságábanx-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 Tags
meghatá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 Expiry
expiryTime
a múltban nem engedélyezett. -
ExpiryTime
értéke nem adható megexpiryOption
Never
.
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-nak
Állapot- és hibakódok
Blob szolgáltatás hibakódjai
Időtúllépések beállítása blobszolgáltatás-műveletekhez