Blob metaadatainak lekérése

  • Cikk

A Get Blob Metadata művelet a megadott blob vagy pillanatkép összes felhasználó által definiált metaadatait adja vissza.

Kérés

A kérést a Get Blob Metadata következőképpen hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount nevet a tárfiók nevére.

GET vagy HEAD metódus kérésének URI-ja HTTP-verzió
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&versionid=<DateTime>		 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 Azure Blob Storage portot 127.0.0.1:10000, majd az emulált tárfiók nevét:

GET vagy HEAD metódus kérésének URI-ja HTTP-verzió
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata 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
snapshot Választható. A pillanatkép paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a lekérendő blob-pillanatképet. A blob-pillanatképek használatával kapcsolatos további információkért lásd: Blob pillanatképének létrehozása.
versionid Választható. 2019-12-12-es és újabb verzió. A versionid paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a lekérendő blob verzióját.
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é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. Névtelen kérések esetén nem kötelező. 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-lease-id:<ID> Választható. Ha ez a fejléc meg van adva, a Get Blob Metadata művelet csak akkor lesz végrehajtva, ha az alábbi feltételek teljesülnek:

- A blob bérlete jelenleg aktív.
– A kérelemben megadott bérletazonosító megegyezik a blob bérletazonosítójával.

Ha valamelyik feltétel nem teljesül, a kérés meghiúsul, és a Get Blob Metadata művelet a 412-s állapotkóddal hiúsul meg (az előfeltétel sikertelen).
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.

Ez a művelet feltételes fejlécek használatát is támogatja a blob metaadat-műveletének lekéré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 kérelemben egy ügyfél által megadott kulccsal titkosított blob olvasására. Az ügyfél által megadott kulccsal (és a megfelelő fejléckészlettel) történő titkosítás nem kötelező. Ha egy blob korábban ügyfél által megadott kulccsal lett titkosítva, ezeket a fejléceket fel kell venni a kérelembe, hogy az olvasási művelet sikeresen befejeződjön.

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 Választható. 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

Nincsenek.

Reagálás

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

Állapotkód

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

Az állapotkódokkal kapcsolatos információkért lásd: Á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.

Válaszfejléc Description
x-ms-meta-name:value A tároló metaadat-értékét adja vissza.
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.
ETag A blob ETagje. Ha a kérelem verziója 2011-08-18 vagy újabb, az ETag értéke idézőjelek közé kerül.
x-ms-request-id Ez a fejléc 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 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.

Ez a fejléc egy megadott verzió nélküli névtelen kérés esetén is vissza lesz adva, ha a tárolót a Blob Storage 2009-09-19-es verziójával jelölték meg nyilvános hozzáférésre.
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.
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-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, a fejléc 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 Get Blob Metadata 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 Get Blob Metadata 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

Nincsenek. A számlázással kapcsolatos információkért tekintse meg a művelet költségekre gyakorolt hatásának részleteit.

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 Get Blob Metadata mutatja be:

Művelet Tárfiók típusa Számlázási kategória
Blob metaadatainak lekérése Prémium szintű blokkblob
Standard általános célú v2		 Egyéb műveletek
Blob metaadatainak lekérése Standard általános célú v1 Olvasá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

Kérések engedélyezése az Azure Storage-nak
Állapot- és hibakódok
Blob Storage-hibakódok