Blobtulajdonságok beállítása
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: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?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 attachment van á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 increment van á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-action együ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:
- 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.
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ékremax
állítja ax-ms-sequence-number-action
értéket, és megadja ax-ms-blob-sequence-number
fejléc értékét.A kérés a értékét értékre
x-ms-sequence-number-action
increment
á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 vagyx-ms-content-length
a é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.