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

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 az alábbiak szerint hozható 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?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 gazdanevét és a Blob Storage-portot , 127.0.0.1:10000majd 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?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 nem kötelező 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é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.
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 Blobtulajdonságok lekérése tová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 Blobtulajdonságok lekérése tová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 Blobtulajdonságok lekérése tová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 Blobtulajdonságok lekérése tová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 Blobtulajdonságok lekérése tová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 kibibyte (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ó: Azure Blob Storage figyelése.
x-ms-blob-content-disposition Választható. Beállítja a blob fejlécét Content-Disposition . A 2013-08-15-ös és újabb verziókhoz érhető el.

A Content-Disposition válasz fejlécmezője további információkat közöl a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására is használható. Ha például a é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 legyen kibocsátva. Ennek a fejlécnek a jelenléte eltérő eredetű erőforrás-megosztási fejléceket eredményez a válaszban. További információ: CORS (eltérő eredetű erőforrások megosztása) támogatása az Azure Storage-szolgáltatásokhoz.

Ez a művelet a 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érés).
x-ms-sequence-number-action: {max, update, increment} Nem kötelező, de kötelező, ha a x-ms-blob-sequence-number kérelem fejléce be van állítva. Ez a tulajdonság csak lapblobokra vonatkozik.

Ez a tulajdonság azt jelzi, hogy a szolgáltatásnak hogyan kell módosítania a blob sorszámát. A tulajdonsághoz adja meg az alábbi lehetőségek egyikét:

- max: Beállítja a sorszámot a kérésben szereplő érték és a blob számára 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-zel növeli. Ha ezt a beállítást adja meg, ne tartalmazza a értéket x-ms-blob-sequence-number header. 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ókért lásd az Oldal elhelyezése műveletet.

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.

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 Set Blob Properties 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érés csak x-ms-blob-sequence-number a vagy x-ms-content-lengtha é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 esetében ez 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 bizonyos tulajdonságokat úgy, hogy lekérdezési paramétereket ad meg a közös hozzáférésű jogosultságkód részeként. Ezek 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ás.

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