Put Block List

Cikk
07/10/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 a használatával 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. Ez a fejléc a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén jelenik meg.
`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ó. 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 a következőre `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érelem ügyfél által megadott kulcsot használt a titkosításhoz, így az ügyfél a megadott kulccsal meggyőződhet arról, hogy a kérés tartalma sikeresen titkosítva van.
`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érelem 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. A fejléc é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` 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, akkor nem jelenik meg 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-ban bármilyen adathozzáférési művelet meghívásához engedélyezésre van szükség. A műveletet az Put Block List alábbiak szerint engedélyezheti.

Ha egy kérelem a x-ms-tags kérelem fejlécét tartalmazó címkéket ad meg, 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 azt javasolja, hogy Microsoft Entra ID felügyelt identitásokkal engedélyezze az Azure Storage-ra irányuló kéréseket. Microsoft Entra ID a megosztott kulcs engedélyezéséhez képest kiváló biztonságot és könnyű használatot biztosít.

Az Azure Storage támogatja az 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 biztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással szembeni 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: Blobok hozzáférésének engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban felsoroljuk azt az RBAC-műveletet, amely a művelet meghívásához Put Block List szükséges Microsoft Entra felhasználóhoz, csoporthoz, felügyelt identitáshoz vagy szolgáltatásnévhez, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Legkevésbé emelt szintű beépített szerepkör:Storage-blobadatok közreműködője

A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt az Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshez című témakörben talál.

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. Sas esetén részletes vezérléssel rendelkezik arról, 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 hogy az SAS mennyi ideig érvényes.

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

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, amelyek könnyebben sérülhetnek. Ha az alkalmazás kialakításához közös hozzáférésű jogosultságkódra van szükség, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználói delegálási SAS-t, ha lehetséges.

Ha a megosztott kulcs hozzáférése nincs engedélyezve a tárfiókhoz, a Blob Storage-ra irányuló 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ói delegálási SAS

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

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

A felhasználói delegálási SAS-ről a felhasználói delegálási SAS Létrehozás című témakörben olvashat bővebben.

Szolgáltatás SAS

A szolgáltatás SAS-t a tárfiókkulcs védi. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a blobtárolóban delegálja a hozzáférést egy erőforráshoz.

A Put Block List műveletet tárolóba vagy bloberőforrásba delegált SAS-jogkivonat használatával 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.

A szolgáltatás SAS-járól további információt a szolgáltatás SAS-Létrehozás című témakörben talál.

Fiók SAS-fiókja

A fiók SAS-jének biztonságát a tárfiókkulcs biztosítja. 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ói 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 meg kell adni:

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)

A fiók SAS-járól további információt a fiók SAS-Létrehozás című témakörben talál.

Megjegyzések

A Put Block List művelet kikényszeríti azt a sorrendet, amelyben a blokkokat egyesíteni kell egy blob létrehozásához.

Ugyanazt a blokkazonosítót többször is meg lehet adni a blokkok listájában. Ha egy blokkazonosító több alkalommal van megadva, az a végleges véglegesített blob blokklistájában szereplő helyeken lévő bájtok tartomá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 beszúrja, frissíti vagy törli az egyes blokkokat anélkül, hogy újra fel kellene töltenie a teljes blobot. Új blob létrehozásához vagy meglévő blob tartalmának frissítéséhez az aktuális véglegesített blokklistából és a véglegesítetlen 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ó megtalálható 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 a szolgáltatásverzió szerint:

Szolgáltatás verziója	Maximális blokkméret (keresztül `Put Block`)	Maximális blobméret (keresztül `Put Block List`)	Maximális blobméret egyetlen írási művelettel (keresztül `Put Blob`)
2019-12-12-es és újabb verzió	4000 mebibyte (MiB)	Körülbelül 190,7 terabájt (TiB) (4000 MiB × 50 000 blokk)	5000 MiB
2016-05-31-2019-07-07-i verziók	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ívja meg a hívást Put Block List , a rendszer felülírja a blob meglévő tulajdonságait és metaadatait. A meglévő pillanatképek azonban megmaradnak a blobban. A feltételes kérelem fejlécével 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ésre kerülnek.

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 az elnevezési és hosszúsági követelményeknek a következőben meghatározottak szerint Set Blob Tags: . Emellett 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 aktív bérletet tartalmaz, az ügyfélnek érvényes bérletazonosítót kell megadnia a blokklista véglegesítésére irányuló kérelemben. 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 vagy újabb verzióra irányuló kérések esetében a 412-es állapotkódot adja vissza (az előfeltétel sikertelen). A korábbi verziók esetében a Blob Storage a 201 (Létrehozva) állapotkódot adja vissza.

Ha a blob rendelkezik aktív bérlettal, és Ön meghívja Put Block List a blob frissítését, a bérlet megmarad a frissített blobon.

Put Block List csak a blokkblobokra vonatkozik. Egy Put Block List lapblob hívása a 400-ra (hibás kérelem) vonatkozó állapotkódot 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 nincs megadva az x-ms-access-tier fejléc.

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

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

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