Put Block List

Cikk
02/03/2024

A Put Block List művelet a blobot alkotó blokkazonosítók listájának megadásával ír egy blobot. Ha blob részeként szeretne írni, a blokkot sikeresen meg kell írni a kiszolgálóra egy korábbi Put Block műveletben.

A blob frissítéséhez hívhatja Put Block List meg, ha csak azokat a blokkokat tölti fel, amelyek módosultak, majd véglegesíti az új és a meglévő blokkokat együtt. Ehhez megadhatja, hogy véglegesítse-e a blokkot a véglegesített blokklistából vagy a véglegesítetlen blokklistából, vagy véglegesítse a blokk legutóbb feltöltött verzióját, attól függően, hogy melyik listához tartozik.

Kérés

A kérést a Put Block List 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?comp=blocklist`	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?comp=blocklist`	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-ján a következő további paramétereket adhatja 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érésfejlécek

A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:

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 tartalmának hossza bájtban. Ez a fejléc a blokkok listájának tartalomhosszára vonatkozik, nem magára a blobra.
`Content-MD5`	Választható. A kérelem tartalmának MD5 kivonata. Ez a kivonat a kérelem tartalmának sértetlenségének ellenőrzésére szolgál az átvitel során. 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 kérelem tartalmához van társítva, és nem magának a blobnak a tartalmával.
`x-ms-content-crc64`	Választható. A kérelem tartalmának CRC64-kivonata. Ez a kivonat a kérelem tartalmának sértetlenségének ellenőrzésére szolgál az átvitel során. 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 kérelem tartalmához van társítva, és nem magának a blobnak a tartalmával. 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. Ez a fejléc a 2019-02-02-es és újabb verzióban támogatott.
`x-ms-blob-cache-control`	Választható. Beállítja a blob gyorsítótár-vezérlését. Ha ez a tulajdonság meg van adva, a blob tárolja, és olvasási kéréssel adja vissza. Ha a tulajdonság nincs megadva a kéréssel, a blob számára törlődik, ha a kérés sikeres.
`x-ms-blob-content-type`	Választható. Beállítja a blob tartalomtípusát. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel adja vissza. Ha a tartalomtípus nincs megadva, az alapértelmezett típusra van állítva, amely a következő `application/octet-stream`: .
`x-ms-blob-content-encoding`	Választható. Beállítja a blob tartalomkódolását. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel adja vissza. Ha a tulajdonság nincs megadva a kéréssel, a blob számára törlődik, ha a kérés sikeres.
`x-ms-blob-content-language`	Választható. Beállítja a blob tartalomnyelvét. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel adja vissza. Ha a tulajdonság nincs megadva a kéréssel, a blob számára törlődik, ha a kérés sikeres.
`x-ms-blob-content-md5`	Választható. A blobtartalom MD5-kivonata. Ez a kivonat nincs érvényesítve, mert az egyes blokkok kivonatai az egyes blokkok feltöltésekor lettek érvényesítve. A Blob lekérése művelet ennek a fejlécnek az értékét adja vissza a Content-MD5 válaszfejlécben. Ha ez a tulajdonság nincs megadva a kéréssel, a blob számára törlődik, ha a kérés sikeres.
`x-ms-meta-name:value`	Választható. A blobhoz társított, felhasználó által definiált név-érték párok. 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 blob titkosításához használandó titkosítási hatókört jelöli. Ennek az értéknek meg kell egyeznie az összes véglegesített blokk titkosításához használt titkosítási hatókörrel. Ez a fejléc a 2019-02-02-es és újabb verzióban 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ót a Megjegyzések szakaszban talál. 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-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a tárolóelemzési 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.
`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` fejlécmező további információkat nyújt a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására használható. Ha például a értékre `attachment`van állítva, ez a fejléc azt jelzi, hogy a felhasználó-ügynök nem jelenítheti meg a választ, hanem a Mentés másként párbeszédpanelt kell megjelenítenie. A Blob lekérése és a Blob tulajdonságainak lekérése művelet válasza tartalmazza a tartalomeloszlási fejlécet.
`x-ms-access-tier`	Választható. 2018-11-09-es és újabb verzió. A blobon beállítani kívánt szintet jelzi. Blokkblobok esetén ez a fejléc csak a 2018-11-09-es és újabb verziójú blobtárolókban vagy általános célú v2-fiókokban támogatott. 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` Az `unlocked` érték azt jelzi, hogy 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. Az `locked` érték azt jelzi, hogy 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ó. Megadja a kérelem lejárati dátumának beállítását, lásd: Lejárati idő. 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. A `expiryTime` blobon már megtalálható fájl nem törlődik, ha a kérés nem tartalmaz új értéket `expiryTime`

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

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

A 2019-02-02-es verziótól a következő fejléceket adhatja meg a blob ügyfél által megadott kulccsal történő titkosítására vonatkozó 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álni kívánt algoritmust. A fejléc értékének a következőnek kell lennie `AES256`: .

A kérés törzse

A kérelem törzsében megadhatja azt a blokklistát, amelyet a Blob Storage-nak ellenőriznie kell a kért blokkot. Ily módon a meglévő blobokat úgy frissítheti, hogy az egyes blokkokat beszúrja, lecseréli vagy törli ahelyett, hogy újra betölti a teljes blobot. Miután feltöltötte a módosított blokkokat vagy blokkokat, véglegesítheti a blob új verzióját az új blokkok és a megtartani kívánt meglévő blokkok véglegesítésével.

Blob frissítéséhez megadhatja, hogy a szolgáltatásnak először a véglegesített blokklistában, a nem véglegesített blokklistában vagy a véglegesített blokklistában kell keresnie egy blokkazonosítót. A használni kívánt megközelítés megadásához adja meg a kérelem törzsében található megfelelő XML-elemben található blokkazonosítót az alábbiak szerint:

Adja meg a blokkazonosítót az Committed elemen belül, amely azt jelzi, hogy a Blob Storage-nak csak a megnevezett blokk véglegesített blokklistájában kell keresnie. Ha a blokk nem található a véglegesített blokklistában, az nem a blob részeként van megírva, és a Blob Storage a 400-as állapotkódot adja vissza (hibás kérés).
Adja meg az elemen belüli Uncommitted blokkazonosítót, amely azt jelzi, hogy a Blob Storage csak a megnevezett blokk nem véglegesített blokklistájában kereshet. Ha a blokk nem található a nem véglegesített blokklistában, akkor nem a blob részeként van megírva, és a Blob Storage a 400-as állapotkódot adja vissza (hibás kérés).
Adja meg a blokkazonosítót az Latest elemen belül, hogy jelezze, hogy a Blob Storage-nak először a nem véglegesített blokklistában kell keresnie. Ha a blokk megtalálható a nem véglegesített listában, a blokk legújabb verziója, és a blobba kell írni. Ha a blokk nem található a véglegesítetlen listában, a szolgáltatásnak keresnie kell a véglegesített blokkok listájában a megnevezett blokkot, és ha megtalálta, írja be a blokkot a blobba.

Az ehhez a verzióhoz Put Block List tartozó kérelemtörzs a következő XML-formátumot használja:

<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Committed>first-base64-encoded-block-id</Committed>  
  <Uncommitted>second-base64-encoded-block-id</Uncommitted>  
  <Latest>third-base64-encoded-block-id</Latest>  
  ...  
</BlockList>

Mintakérés

A bemutatásához Put Block Listtegyük fel, hogy feltöltött három blokkot, amelyeket most véglegesíteni szeretne. Az alábbi példa egy új blobot véglegesíti, jelezve, hogy a felsorolt blokkok legújabb verzióját kell használni. Nem szükséges tudni, hogy ezek a blokkok már véglegesítve lettek-e.

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Latest>AAAAAA==</Latest>  
  <Latest>AQAAAA==</Latest>  
  <Latest>AZAAAA==</Latest>  
</BlockList>

Ezután tegyük fel, hogy frissíteni szeretné a blobot. Az új blob a következő módosításokat hajtja végre:

Egy új blokk azonosítóval ANAAAA==. Ezt a blokkot először fel kell tölteni a Put Block hívásával, és a nem véglegesített blokklistában jelenik meg, amíg a hívás a következőre Put Block Listnem kerül: .
A blokk frissített verziója azonosítóval AZAAAA==. Ezt a blokkot először fel kell tölteni a Put Block hívásával, és a nem véglegesített blokklistában jelenik meg, amíg a hívás a következőre Put Block Listnem kerül: .
A blokk eltávolítása az azonosítóval AAAAAA==. Mivel ez a blokk nem szerepel a következő hívásban Put Block List, a blokk gyakorlatilag el lesz távolítva a blobból.

Az alábbi példa a blob frissítésére irányuló Put Block List hívást mutatja be:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2009 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Uncommitted>ANAAAA==</Uncommitted>  
  <Committed>AQAAAA==</Committed>  
  <Uncommitted>AZAAAA==</Uncommitted>  
</BlockList>

Reagálás

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

Állapotkód

A sikeres művelet a 201-ben létrehozott á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.

Reagálás	Leírások
`ETag`	Az entitáscímke olyan értéket tartalmaz, amellyel az ügyfél feltételes `GET/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éke 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. Minden olyan művelet, amely módosítja a blobot, beleértve a blob metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a blob utolsó módosítási időpontját.
`Content-MD5`	Visszaadva, hogy az ügyfél ellenőrizni tudja az üzenettartalom integritását. Ez a fejléc a kérelem tartalmára hivatkozik (ebben az esetben a blokkok listájára, és nem magának a blobnak a tartalmára). A 2019-02-02-es és újabb verziók esetében a rendszer csak akkor adja vissza ezt a fejlécet, ha a kérelemhez ez a fejléc tartozik.
`x-ms-content-crc64`	A 2019-02-02-es és újabb verzió esetén a rendszer visszaadja ezt a fejlécet, hogy az ügyfél ellenőrizhesse az üzenettartalom integritását. Ez a fejléc a kérelem tartalmára hivatkozik (ebben az esetben a blokkok listájára, és nem magának a blobnak a tartalmára). Ez a fejléc akkor jelenik meg, ha `Content-md5` a fejléc nincs jelen a kérelemben.
`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 Blob Storage azon verziója, amely a kérés végrehajtásához használatos. Ezt a fejlécet a rendszer a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén adja vissza.
`Date`	A szolgáltatás által létrehozott UTC dátum/idő érték, amely jelzi a válasz indításának időpontját.
`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 értékre `false`van állítva.
`x-ms-encryption-key-sha256`	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a kérés ügyfél által biztosított kulcsot használt a titkosításhoz, így az ügyfél a megadott kulccsal biztosíthatja a kérés tartalmának sikeres titkosítását.
`x-ms-encryption-scope`	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a kérelem titkosítási hatókört használt, így az ügyfél meggyőződhet arról, hogy a kérés tartalma sikeresen titkosítva van a titkosítási hatókör használatával.
`x-ms-version-id: <DateTime>`	2019-12-12-es és újabb verzió. 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ó.
`x-ms-client-request-id`	A kérések és a hozzájuk tartozó 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 szerepel a válaszban.

Mintaválasz

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-content-crc64: 77uWZTolTHU  
Date: Sun, 25 Sep 2011 00:17:44 GMT  
ETag: “0x8CB172A360EC34B”  
Last-Modified: Sun, 25 Sep 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
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 Block List 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 Block List műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet: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.

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Az SAS-sel részletesen szabályozhatja, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és mennyi ideig érvényes az SAS.

A Put Block List művelet háromféle közös hozzáférésű jogosultságkódot támogat: felhasználódelegálási SAS, szolgáltatás SAS és fiók SAS.

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, ami könnyebben feltörhető. Ha az alkalmazás kialakítása közös hozzáférésű jogosultságkódokat igényel, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználódelegálási SAS-t, ha lehetséges.

Ha a tárfiók esetében nincs engedélyezve a megosztott kulcshoz való hozzáférés, a blobtárolónak küldött kérések esetén a szolgáltatás SAS-jogkivonata vagy a fiók SAS-jogkivonata nem lesz engedélyezve. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Felhasználódelegálási SAS

A felhasználódelegálási SAS-t Microsoft Entra hitelesítő adatok és az SAS-hez megadott engedélyek védik.

Put Block List A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához írási (w) engedély szükséges a felhasználódelegálási SAS-jogkivonat részeként.

További információ a felhasználódelegálási SAS-ről: Felhasználódelegálási SAS létrehozása.

Szolgáltatási SAS

A szolgáltatás SAS-jének védelme a tárfiók kulccsal történik. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a Blob Storage-ban delegálja az erőforrásokhoz való hozzáférést.

Put Block List A művelet tárolóhoz vagy bloberőforráshoz delegált SAS-jogkivonattal történő meghívásához írási (w) engedély szükséges a szolgáltatás SAS-jogkivonatának részeként.

További információ a szolgáltatás SAS-járól: Szolgáltatás SAS létrehozása.

Fiók SAS-fiókja

A fiók SAS-jének védelme a tárfiók kulcsával történik. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt hozzáférést. A szolgáltatáson vagy a felhasználódelegálási SAS-en keresztül elérhető összes művelet fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket jelzi, amelyet a hozzáférés delegálásakor kell megadni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Put Block List	Blob (b)	Objektum (o)	Írás (w)

További információ a fiók SAS-járól: Fiók SAS létrehozása.

Megjegyzések

A Put Block List művelet kikényszeríti a blokkok blob létrehozásához való kombinálásának sorrendjét.

Ugyanazt a blokkazonosítót többször is meg lehet adni a blokkok listájában. Ha egy blokkazonosító többször van megadva, az a végleges véglegesített blob blokklistájában szereplő egyes helyek bájttartományát jelöli. Ha egy blokkazonosító többször is megjelenik a listában, a blokkazonosító mindkét példányát ugyanabban a blokklistában kell megadni. Más szóval mindkét példányt meg kell adni az elemen, az Committed elemen Uncommitted vagy az elemen Latest belül.

A használatával Put Block Listúgy módosíthatja a meglévő blobot, hogy egyes blokkokat szúr be, frissít vagy töröl anélkül, hogy újra fel kellene töltenie a teljes blobot. Új blob létrehozásához vagy egy meglévő blob tartalmának frissítéséhez az aktuális véglegesített blokklistából és a nem véglegesített blokklistából is megadhat blokkazonosítókat. Ily módon frissíthet egy blobot úgy, hogy megad néhány új blokkot a nem véglegesített blokkok listájából, a többit pedig a véglegesített blokkok listájából, amelyek már a meglévő blob részét képezik.

Ha egy blokkazonosító van megadva az Latest elemben, és ugyanaz a blokkazonosító létezik a véglegesített és a nem véglegesített blokklistákban is, Put Block List véglegesíti a blokkot a nem véglegesített blokklistából. Ha a blokkazonosító létezik a véglegesített blokklistában, de nem szerepel a véglegesítetlen blokklistában, Put Block List véglegesíti a blokkot a véglegesített blokklistából.

A blokkblobok minden blokkja eltérő méretű lehet. A blokkblobok legfeljebb 50 000 véglegesített blokkot tartalmazhatnak. A blobhoz társítható nem véglegesített blokkok maximális száma 100 000.

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 terabájt (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 egy meglévő blob frissítésére hív, Put Block List a blob meglévő tulajdonságai és metaadatai felülíródnak. A meglévő pillanatképek azonban megmaradnak a blobban. A feltételes kérelemfejlécekkel csak akkor hajthatja végre a műveletet, ha egy adott feltétel teljesül.

Ha a Put Block List művelet egy hiányzó blokk miatt meghiúsul, fel kell töltenie a hiányzó blokkot.

A nem véglegesített blokkok szemétként lesznek összegyűjtve, ha az utolsó sikeres Put Block műveletet követő egy héten belül nem történik sikeres hívás a blobra Put Block vagy Put Block List a blobra. Ha a Put Blob meghívása a blobon történik, a nem véglegesített blokkok szemétgyűjtést hajtanak ki.

Ha a x-ms-tags fejlécben címkék vannak megadva, akkor a lekérdezési sztring kódoltnak kell lennie. A címkekulcsoknak és -értékeknek meg kell felelniük az elnevezésre és a hosszra vonatkozó követelményeknek, a következőben meghatározottak szerint Set Blob Tags: . Ezenkívül a x-ms-tags fejléc legfeljebb 2 KiB méretű címkéket 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érletmel, az ügyfélnek érvényes bérletazonosítót kell megadnia a blokklista véglegesítésére 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 bérletazonosítót ad meg, 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 olyan blob bérletazonosítóját adja meg, amely még nem létezik, a Blob Storage a 2013-08-15-es vagy újabb verzióval kapcsolatos kérések esetében a 412-es állapotkódot adja vissza (előfeltétele nem sikerült). A korábbi verziók esetében a Blob Storage a 201-ben (Létrehozva) állapotkódot adja vissza.

Ha a blob aktív bérletet ad meg, és ön meghívja Put Block List a blob frissítésére, a bérlet megmarad a frissített blobon.

Put Block List csak a blokkblobokra vonatkozik. Egy lapblob hívása Put Block List a 400-ás állapotkódot (hibás kérés) eredményezi.

Az archivált 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 az x-ms-access-tier fejléc nincs megadva.

Számlázás

A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. 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 Block List mutatja be:

Művelet	Tárfiók típusa	Számlázási kategória
Put Block List	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ával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.

Lásd még

Blokkblobok, hozzáfűző blobok és lapblobok ismertetése
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