Blobtulajdonságok beállítása

  • Cikk

A Set Blob Properties művelet beállítja a rendszer tulajdonságait a blobon.

Kérés

A Set Blob Properties kérelem a következőképpen hozható 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=properties HTTP/1.1

Emulált tárolási szolgáltatás URI-ja

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 Storage-portot 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=properties HTTP/1.1

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 Storage-műveletekhez.

Kérelemfejlécek (minden blobtípus)

Az alábbi táblázat az összes blobtípushoz szükséges és opcionális kérelemfejléceket 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.
x-ms-blob-cache-control Választható. Módosítja a blob gyorsítótár-vezérlési sztringét.

Ha ez a tulajdonság nincs megadva a kérelemben, a blob tulajdonsága törlődik. A Blob tulajdonságainak lekérése későbbi hívásai nem adják vissza ezt a tulajdonságot, hacsak nincs explicit módon beállítva a blobon.
x-ms-blob-content-type Választható. Beállítja a blob tartalomtípusát.

Ha ez a tulajdonság nincs megadva a kérelemben, a blob tulajdonsága törlődik. A Blob tulajdonságainak lekérése későbbi hívásai nem adják vissza ezt a tulajdonságot, hacsak nincs explicit módon beállítva a blobon.
x-ms-blob-content-md5 Választható. Beállítja a blob MD5 kivonatát.

Ha ez a tulajdonság nincs megadva a kérelemben, a blob tulajdonsága törlődik. A Blob tulajdonságainak lekérése későbbi hívásai nem adják vissza ezt a tulajdonságot, hacsak nincs explicit módon beállítva a blobon.
x-ms-blob-content-encoding Választható. Beállítja a blob tartalomkódolását.

Ha ez a tulajdonság nincs megadva a kérelemben, a blob tulajdonsága törlődik. A Blob tulajdonságainak lekérése későbbi hívásai nem adják vissza ezt a tulajdonságot, hacsak nincs explicit módon beállítva a blobon.
x-ms-blob-content-language Választható. Beállítja a blob tartalomnyelvét.

Ha ez a tulajdonság nincs megadva a kérelemben, a blob tulajdonsága törlődik. A Blob tulajdonságainak lekérése későbbi hívásai nem adják vissza ezt a tulajdonságot, hacsak nincs explicit módon beállítva a blobon.
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 naplózás konfigurálásakor rögzít a 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ó: Monitorozási Azure Blob Storage.
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 közöl 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 attachmentvan állítva, az azt jelzi, hogy a felhasználói ügynöknek nem kell megjelenítenie a választ, hanem 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 származik. Ennek a fejlécnek a jelenléte a válasz forrásközi erőforrás-megosztási fejléceit eredményezi. További információ: CORS (forrásközi erőforrás-megosztás) támogatása az Azure Storage-szolgáltatásokhoz.

Ez a művelet feltételes fejlécek használatát is támogatja a blobtulajdonságok beállítá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)

Az alábbi táblázat azokat a kérésfejléceket ismerteti, amelyek csak a lapblobok műveleteire vonatkoznak:

Kérelem fejléce Leírás
x-ms-blob-content-length: byte value Választható. Átméretez egy lapblobot a megadott méretre. Ha a megadott érték kisebb, mint a blob aktuális mérete, a megadott értéknél nagyobb értékekkel rendelkező összes lapblob törlődik.

Ez a tulajdonság nem használható blokkblob vagy hozzáfűző blob méretének módosítására. Ha ezt a tulajdonságot blokkblobra vagy hozzáfűző blobra állítja be, a 400-ás állapotkódot adja vissza (hibás kérelem).
x-ms-sequence-number-action: {max, update, increment} Nem kötelező, de kötelező, ha a x-ms-blob-sequence-number fejléc be van állítva a kéréshez. Ez a tulajdonság csak lapblobokra vonatkozik.

Ez a tulajdonság azt jelzi, hogy a szolgáltatás hogyan módosítsa a blob sorszámát. Adja meg a következő lehetőségek egyikét ehhez a tulajdonsághoz:

- max: Beállítja a sorszámot a kérelemben szereplő érték és a blobhoz jelenleg tárolt érték magasabb értékére.
- update: Beállítja a sorszámot a kérelemben szereplő értékre.
- increment: A sorszám értékét 1-gyel növeli. Ha ezt a beállítást adja meg, ne tartalmazza a x-ms-blob-sequence-number headerértéket. Ezzel visszaadja a 400-ás állapotkódot (hibás kérés).
x-ms-blob-sequence-number: <num> Nem kötelező, de kötelező, ha a x-ms-sequence-number-action tulajdonság értéke max vagy update. Ez a tulajdonság csak lapblobokra vonatkozik.

A tulajdonság beállítja a blob sorszámát. A sorszám egy felhasználó által vezérelt tulajdonság, amellyel nyomon követheti a kéréseket és kezelheti az egyidejűségi problémákat. További információt az Oldal elhelyezése műveletben talál.

Ezzel a tulajdonsággal x-ms-sequence-number-action együtt frissítheti a blob sorszámát a kérelemben megadott vagy a blobban jelenleg tárolt értékek megadott értékére vagy magasabb értékére. Ezt a fejlécet nem szabad megadni, ha x-ms-sequence-number-action a értékre incrementvan állítva, ebben az esetben a szolgáltatás automatikusan eggyel növeli a sorszámot.

Ha a sorszámot egy ön által választott értékre szeretné állítani, ezt a tulajdonságot a kérelemben a következővel x-ms-sequence-number-actionegyütt kell megadni: .

A kérés törzse

Nincsenek.

Reagálás

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

Állapotkód

A sikeres művelet a 200 -os állapotkódot adja vissza (OK).

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.

Syntax Description
ETag Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez . 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.
x-ms-blob-sequence-number Ha a blob egy lapblob, a függvény ezzel a fejléccel adja vissza a blob aktuális sorszámát.
x-ms-request-id Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. 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. 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 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. Ha van egyezés, ez a fejléc a forráskérés fejlécének értékét adja vissza.
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. A fejléc a következőre lesz állítva: true.
x-ms-client-request-id 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.

Választörzs

Nincsenek.

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 Set Blob Properties alábbiak szerint engedélyezheti.

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 Set Blob Properties 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

A blob tulajdonságainak frissítésére szolgáló szemantikák a következők:

  • A lapblob sorszáma csak akkor frissül, ha a kérés megfelel az alábbi feltételek valamelyikének:

    • A kérés a vagy updateértékre max állítja a x-ms-sequence-number-action értéket, és megadja a x-ms-blob-sequence-number fejléc értékét.

    • A kérés a értékét értékre x-ms-sequence-number-actionincrementállítja, ami azt jelzi, hogy a szolgáltatásnak eggyel kell növelnie a sorszámot.

  • Az oldalblobok mérete csak akkor módosul, ha a kérelem a fejléc értékét x-ms-content-length adja meg.

  • Ha módosítani szeretné egy lapblob méretét egy prémium szintű tárfiókban, az új méret nem haladhatja meg a meglévő szint által engedélyezett tartalomhosszt. A blob átméretezése előtt hívja meg a Set Blob Tier (Blobszint beállítása ) elemet. A szintek és az engedélyezett tartalomhosszok listáját lásd: Nagy teljesítményű prémium szintű tárolás és felügyelt lemezek virtuális gépekhez.

  • Ha egy kérelem csak x-ms-blob-sequence-number a vagy x-ms-content-lengthértéket állítja be, a blob többi tulajdonsága sem módosul.

  • Ha a kérelemben az alábbi tulajdonságok közül egy vagy több van beállítva, az összes tulajdonság együtt van beállítva. Ha egy tulajdonsághoz nem ad meg értéket, ha legalább az egyik be van állítva, akkor a blob számára a tulajdonság törlődik.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Megjegyzés

Közös hozzáférésű jogosultságkód (SAS) esetén felülbírálhatja a blobhoz tárolt egyes tulajdonságokat úgy, hogy a lekérdezési paramétereket a közös hozzáférésű jogosultságkód részeként adja meg. Ezek a tulajdonságok közé tartoznak a cache-control, content-type, content-encoding, content-languageés content-disposition tulajdonságok. További információ: Szolgáltatás SAS létrehozása.

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 Set Blob Properties mutatja be:

Művelet Tárfiók típusa Számlázási kategória
Blobtulajdonságok beállítása Prémium szintű blokkblob
Standard általános célú v2		 Egyéb műveletek
Blobtulajdonságok beállítása 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