Get Blob Properties

Cikk
02/13/2024

A Get Blob Properties művelet a blob összes felhasználó által definiált metaadatát, szabványos HTTP-tulajdonságát és rendszertulajdonságát adja vissza. Nem adja vissza a blob tartalmát.

Kérés

A kérést a Get Blob Properties 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.

HEAD metódus kérésének URI-ja	HTTP-verzió
`https://myaccount.blob.core.windows.net/mycontainer/myblob` `https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>`	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 Azure Blob Storage portot 127.0.0.1:10000, majd az emulált tárfiók nevét:

HEAD metódus kérésének URI-ja	HTTP-verzió
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

További információ: Az Azure Storage Emulator használata fejlesztéshez és tesztelé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 a lekérendő blob verzióját adja meg.
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása a Blob Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a 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é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 Properties` 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 Properties` művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
`x-ms-upn`	Választható. 2020-06-12-es és újabb verzió. Érvényes a hierarchikus névtérrel rendelkező fiókokhoz. Ha a visszaadott `x-ms-owner` felhasználói identitásértékek igazak, Microsoft Entra objektumazonosítókból egyszerű felhasználónevekké alakulnak át. Ha az értékek hamisak, a rendszer Microsoft Entra objektumazonosítóként adja vissza őket. Az alapértelmezett érték: hamis. Vegye figyelembe, hogy a csoport- és alkalmazásobjektum-azonosítók nincsenek lefordítva, mert nem rendelkeznek egyedi felhasználóbarát névvel.
`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 rendszer akkor rögzít az elemzési naplókban, ha engedélyezve van a tárolóelemzési naplózás. Erősen javasoljuk, hogy ezt a fejlécet használja, amikor az ügyféloldali tevékenységeket a kiszolgáló által fogadott kérésekkel korrelálja. További információ: Az Azure Storage Analytics naplózása.

Ez a művelet feltételes fejlécek használatát is támogatja blobtulajdonságok és metaadatok visszaadá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 (ü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 blobot korábban ügyfél által megadott kulccsal titkosítottak, ezeket a fejléceket fel kell vennie 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.

További információ az állapotkódokról: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz tartalmazza a fejléceket az alábbi táblázatban. 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
`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.
`x-ms-creation-time`	2017-11-09-es és újabb verzió. A blob létrehozá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.
`x-ms-meta-name:value`	A blobhoz társított, felhasználó által megadott metaadatoknak megfelelő név-érték párok halmaza.
`x-ms-tag-count`	2019-12-12-es és újabb verzió. Ha a blob tartalmaz címkéket, a blobban tárolt címkék számát adja vissza. Ez a fejléc nem jelenik meg, ha nincsenek címkék a blobon.
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	A blob típusa.
`x-ms-copy-completion-time:<datetime>`	2012-02-12-es és újabb verzió. Annak a legutóbbi kísérletnek `Copy Blob` a befejezési ideje, amelyben ez a blob volt a célblob. Ez az érték megadhatja a befejezett, megszakított vagy sikertelen másolási kísérletek időpontját. Ez a fejléc nem jelenik meg, ha egy másolat függőben van, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha a blobot módosították egy befejezett `Copy Blob` művelet után, amely a következőt használja `Set Blob Properties`: , `Put Blob`vagy `Put Block List`.
`x-ms-copy-status-description: <error string>`	2012-02-12-es és újabb verzió. Csak akkor jelenik meg, ha `x-ms-copy-status` vagy `failedpending`. Ismerteti a végzetes vagy nem végzetes másolási művelet hibájának okát. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha ezt a blobot módosították egy `Copy BlobSet Blob Properties`, vagy `Put BlobPut Block List`.
`x-ms-copy-id: <id>`	2012-02-12-es és újabb verzió. Az utolsó megkísérelt `Copy Blob` művelet sztringazonosítója, ahol ez a blob volt a célblob. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha ezt a blobot módosították egy `Copy BlobSet Blob Properties`, vagy `Put BlobPut Block List`.
`x-ms-copy-progress: <bytes copied/bytes total>`	2012-02-12-es és újabb verzió. A legutóbb megkísérelt `Copy Blob` művelet forrásában lévő másolt bájtok számát és összes bájtját tartalmazza, ahol ez a blob volt a célblob. A 0-tól a másolt bájtokig `Content-Length` megjeleníthető. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha ezt a blobot módosították egy `Copy BlobSet Blob Properties`, vagy `Put BlobPut Block List`.
`x-ms-copy-source: url`	2012-02-12-es és újabb verzió. Egy legfeljebb 2 KiB hosszúságú URL-cím, amely megadja az utolsó kísérletben `Copy Blob` használt forrásblobot, ahol ez a blob volt a célblob. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha ezt a blobot módosították egy `Copy BlobSet Blob Properties`, vagy `Put BlobPut Block List`.
`x-ms-copy-status: <pending \\| success \\| aborted \\| failed>`	2012-02-12-es és újabb verzió. Az x-ms-copy-id által azonosított másolási művelet állapota az alábbi értékekkel: - `success`: A másolás sikeresen befejeződött. - `pending`: A másolás folyamatban van. Ellenőrizze, hogy `x-ms-copy-status-description` az időszakos, nem végzetes hibák akadályozzák-e a másolás folyamatát, de ne okozzon hibát. - `aborted`: A másolás a következővel fejeződött be `Abort Copy Blob`: . - `failed`: A másolás nem sikerült. Tekintse meg `x-ms-copy-status-description` a hiba részleteit. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy `Copy Blob` műveletben, vagy ha ezt a blobot módosították egy , `Copy BlobSet Blob Properties`vagy `Put BlobPut Block List`.
`x-ms-incremental-copy: true`	2016-05-31-es és újabb verzió. Akkor tartalmazza, ha a blob növekményes másolási blob.
`x-ms-copy-destination-snapshot:<datetime>`	2016-05-31-es és újabb verzió. Akkor szerepel benne, ha a blob növekményes másolási blob vagy növekményes másolási pillanatkép, ha `x-ms-copy-status` sikeres. A blob utolsó sikeres növekményes másolási pillanatképének pillanatkép-ideje.
`x-ms-lease-duration: <infinite \\| fixed>`	Blob bérlete esetén meghatározza, hogy a bérlet végtelen vagy rögzített időtartamú-e. A 2012-02-12-es és újabb verziót használó kérésekhez tartozik.
`x-ms-lease-state: <available \\| leased \\| expired \\| breaking \\| broken>`	A blob bérletállapota. A 2012-02-12-es és újabb verziót használó kérésekhez tartozik.
`x-ms-lease-status:<locked\\| unlocked>`	A blob bérletállapota.
`Content-Length`	A blob mérete bájtban. Lapblob esetén ez a fejléc a blobban tárolt fejléc értékét `x-ms-blob-content-length` adja vissza.
`Content-Type`	A blobhoz megadott tartalomtípus. Ha nincs megadva tartalomtípus, az alapértelmezett tartalomtípus a .`application/octet-stream`
`Etag`	Az ETag egy 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éke idézőjelek közé kerül.
`Content-MD5`	Ha a `Content-MD5` blob fejléce be van állítva, a rendszer visszaadja ezt a válaszfejlécet, hogy az ügyfél ellenőrizhesse az üzenettartalom integritását. A 2012-02-12-es és újabb verzióban akkor is beállítja a blokkblob MD5-értékét, `Put Blob` ha a `Put Blob` kérés nem tartalmaz MD5-fejlécet.
`Content-Encoding`	Ha a `Content-Encoding` kérelem fejléce korábban be van állítva a blobhoz, akkor a rendszer ezt az értéket adja vissza ebben a fejlécben.
`Content-Language`	Ha a `Content-Language` kérelem fejléce korábban be van állítva a blobhoz, akkor a rendszer ezt az értéket adja vissza ebben a fejlécben.
`Content-Disposition`	Ha a `Content-Disposition` kérelem fejléce korábban be van állítva a blobhoz, a rendszer ezt az értéket adja vissza ebben a fejlécben a 2013-08-15-ös és újabb verzióval kapcsolatos kérések esetén. 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 is használható. Ha például a fejléc `attachment`értéke , az azt jelzi, hogy a felhasználó-ügynök nem jelenítse meg a választ, hanem a Mentés másként párbeszédpanelt.
`Cache-Control`	Ha a `Cache-Control` kérelem fejléce korábban be van állítva a blobhoz, akkor a rendszer ezt az értéket adja vissza ebben a fejlécben.
`x-ms-blob-sequence-number`	Egy lapblob aktuális sorszáma. Ez a fejléc nem jelenik meg blokkblobok vagy hozzáfűző blobok esetén. Ez a fejléc nem jelenik meg blokkblobok esetén.
`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.
`Accept-Ranges: bytes`	Azt jelzi, hogy a szolgáltatás támogatja a részleges blobtartalomra vonatkozó kéréseket. A 2013-08-15-ös és újabb verzióval küldött kérelmekhez tartozik.
`x-ms-blob-committed-block-count`	A blobban található véglegesített blokkok száma. Ez a fejléc csak hozzáfűző blobokhoz lesz visszaadva.
`x-ms-server-encrypted: true/false`	2015-12-11-es és újabb verzió. Ennek a fejlécnek az értéke akkor `true` van beállítva, ha a blobadatok és az alkalmazás metaadatai teljes mértékben titkosítva vannak a megadott algoritmus használatával. Ellenkező esetben az érték `false` értéke (ha a blob titkosítatlan, vagy ha csak a blob/alkalmazás metaadatainak egyes részei vannak titkosítva).
`x-ms-encryption-key-sha256`	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a blob ügyfél által megadott kulccsal van titkosítva.
`x-ms-encryption-context`	2021-08-06-os és újabb verzió. Ha a titkosítási környezet tulajdonságértéke be van állítva, akkor a beállított értéket adja vissza. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz.
`x-ms-encryption-scope`	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a blob titkosítási hatókörrel van titkosítva.
`x-ms-access-tier`	2017-04-17-es és újabb verzió. A Blob Storage-fiókban vagy általános célú v2-fiókban lévő blokkblobok Premium Storage fiókján vagy rétegén található lapblob szintje. Az engedélyezett prémium szintű lapblobszintek listáját a virtuális gépek nagy teljesítményű Premium Storage és felügyelt lemezei című témakörben találja. Blob Storage- vagy általános célú v2-fiók esetén az érvényes értékek 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 standard blobfiók blokkblobszintű 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-access-tier-inferred: true`	2017-04-17-es és újabb verzió. Lapblobok csak Premium Storage fiókban. Ha a hozzáférési szint nincs explicit módon beállítva a blobon, a réteg a tartalom hossza alapján lesz kikövetkeztetett, és ezt a fejlécet a rendszer a következő értékkel `true`adja vissza: . Blob Storage-beli blokkblobok vagy általános célú v2-fiók esetén, ha a blob nem rendelkezik a hozzáférési szint beállításával, a réteget a tárfiók tulajdonságaiból vonhatja le. Ez a fejléc csak akkor van beállítva, ha a blokkblobszint kikövetked.
`x-ms-archive-status`	2017-04-17-es és újabb verzió. Blob Storage- vagy általános célú v2-fiók esetén az érvényes értékek a következők `rehydrate-pending-to-hot`: , `rehydrate-pending-to-cool`és `rehydrate-pending-to-cold`. Ha a blob rehidratálva van, és hiányos, a rendszer ezt a fejlécet adja vissza, amely mindkettő azt jelzi, hogy a rehidratát függőben van, és megjeleníti a célszintet. A standard blobfiók blokkblobszintű 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-access-tier-change-time`	2017-04-17-es és újabb verzió. Azt jelzi, hogy a réteg mikor módosult utoljára az objektumon. Ez a fejléc csak akkor lesz visszaadva, ha a blokkblobon valaha beállítottak egy szintet. 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 standard blobfiók blokkblobszintű rétegzésével kapcsolatos további információkért lásd: Gyakori elérésű, ritka elérésű és archív tárolási szintek.
`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-karakterből áll. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, akkor ez a fejléc nem szerepel a válaszban.
`x-ms-rehydrate-priority`	2019-12-12-es és újabb verzió. Ha egy objektum rehidratálásra vár, akkor a rendszer ezt a fejlécet rehidratálás prioritással adja vissza. Az érvényes értékek a következők: `High`/`Standard`. A standard blobfiók blokkblobszintű 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-or-{policy-id}_{rule-id}`	A 2019-12-12-es és újabb verziók csak blokkblobok esetén térnek vissza. `policy-id` egy GUID-érték, amely egy objektumreplikációs szabályzat azonosítóját jelöli a tárfiókon. `rule-id` egy GUID-érték, amely a blobtárolóban lévő szabályzatszabály azonosítóját jelöli. Ha a fiók engedélyezve van `ObjectReplication`, ennek a fejlécnek az értéke a megadott szabályzat- és szabályazonosítókkal rendelkező blob replikációs állapotát jelöli( vagy `completefailed`).
`x-ms-or-policy-id`	A 2019-12-12-es és újabb verziók csak blokkblobok esetén térnek vissza. Ha a fiók engedélyezve van `ObjectReplication`, a fejléc értéke a replikációt szabályozó szabályzatot jelöli.
`x-ms-last-access-time`	2020-02-10-es és újabb verzió. Azt jelzi, hogy mikor fértek hozzá utoljára a blob adatai a tárfiók legutóbbi hozzáférési időkövető szabályzata alapján. A rendszer nem adja vissza a fejlécet, ha a tárfiók nem rendelkezik utolsó hozzáférési időkövetési szabályzattal, vagy a szabályzat le van tiltva. A tárfiók utolsó hozzáférési idejének nyomon követésére vonatkozó szabályzat beállításáról a Blob Storage API-t ismertető cikkben talál további információt.
`x-ms-blob-sealed`	A 2019-12-12-es és újabb verziók csak hozzáfűző blobokhoz ad vissza eredményt. Ha a hozzáfűző blobot lezárták, az érték igaz lesz. További információ: Hozzáfűző blobzár
`x-ms-immutability-policy-until-date`	2020-06-12-es és újabb verzió. A blobon beállított "adatmegőrzési dátum" értékét adja meg. Ez az a dátum, amíg a blob nem módosítható vagy törölhető. Csak akkor adja vissza, ha a blobon módosíthatatlansági szabályzat van beállítva. A fejléc értéke RFC1123 formátum.
`x-ms-immutability-policy-mode: unlocked/locked`	2020-06-12-es és újabb verzió. Az immutability policy mód, amelyet akkor ad vissza, ha a blobon módosíthatatlansági szabályzat van beállítva. Az értékek a következők `unlocked`/`locked`: . `unlocked` azt jelzi, hogy a felhasználó módosíthatja a szabályzatot a megőrzési dátum növelésével vagy csökkentésével. `locked` azt jelzi, hogy ezek a műveletek tiltottak.
`x-ms-legal-hold: true/false`	2020-06-12-es és újabb verzió. Ez a fejléc nem jelenik meg, ha nincs jogi célú visszatartás a blobon. A fejléc értéke igaz értékre van állítva, ha a blob jogi célú visszatartást tartalmaz, és értéke igaz. Ellenkező esetben az érték false (hamis) értékre van állítva, ha a blob jogi célú visszatartást és hamis értéket tartalmaz.
`x-ms-owner`	2020-06-12-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. A fájl vagy könyvtár tulajdonos felhasználóját adja vissza.
`x-ms-group`	2020-06-12-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. A fájl vagy könyvtár tulajdonoscsoportját adja vissza.
`x-ms-permissions`	2020-06-12-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. A felhasználóhoz, csoporthoz és más fájlokhoz vagy címtárhoz beállított engedélyeket adja vissza. Minden egyes engedély [r,w,x,-]{3} formátumban van.
`x-ms-resource-type`	2020-10-02-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. Az elérési út erőforrástípusát adja vissza, amely lehet `file` vagy `directory`.
`x-ms-expiry-time`	2020-02-10-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. A blobon beállított lejárati időt adja vissza. A rendszer csak azokhoz a fájlokhoz ad vissza eredményt, amelyek lejárati ideje be van állítva.

Választörzs

Nincsenek.

Mintaválasz

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

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 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 Get Blob Properties műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Legkevésbé emelt szintű beépített szerepkör:Storage-blobadatok olvasója

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.

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. Az SAS-sel részletesen szabályozhatja, 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 mennyi ideig érvényes az SAS.

A Get Blob Properties művelet háromféle közös hozzáférésű jogosultságkódot támogat: felhasználódelegálási SAS, szolgáltatás SAS és fiók SAS.

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, ami könnyebben feltörhető. Ha az alkalmazás kialakítása közös hozzáférésű jogosultságkódokat igényel, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználódelegálási SAS-t, ha lehetséges.

Ha a tárfiók esetében nincs engedélyezve a megosztott kulcshoz való hozzáférés, a blobtárolónak küldött 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ódelegálási SAS

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

Get Blob Properties A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a felhasználódelegálási SAS-jogkivonat részeként.

További információ a felhasználódelegálási SAS-ről: Felhasználódelegálási SAS létrehozása.

Szolgáltatási SAS

A szolgáltatás SAS-jének védelme a tárfiók kulccsal történik. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a Blob Storage-ban delegálja az erőforrásokhoz való hozzáférést.

Get Blob Properties A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a szolgáltatás SAS-jogkivonatának részeként.

További információ a szolgáltatás SAS-járól: Szolgáltatás SAS létrehozása.

Fiók SAS-fiókja

A fiók SAS-jének védelme a tárfiók kulcsával történik. 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ó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 kell megadni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Get Blob Properties	Blob (b)	Objektum (o)	Olvasás (r)

További információ a fiók SAS-járól: Fiók SAS létrehozása.

Megjegyzések

Annak megállapításához, hogy egy Copy Blob művelet befejeződött-e, először ellenőrizze, hogy a x-ms-copy-id fejléc értéke megegyezik-e az eredeti hívás Copy Blobáltal megadott másolási azonosítóval. Egyezés biztosítja, hogy egy másik alkalmazás ne szakítsa meg a másolatot, és ne kezdjen el egy új Copy Blob műveletet. Ezután keresse meg a fejlécet x-ms-copy-status: success . Ne feledje azonban, hogy a blobon végzett összes írási művelet , kivéve Leasea , Put Pageés Put Block a műveletek minden x-ms-copy-* tulajdonságát eltávolítja a blobból. Ezeket a tulajdonságokat a 2012-02-12-nél korábbi verziót használó műveletek sem másolják Copy Blob .

x-ms-copy-status-description további információt tartalmaz a Copy Blob hibáról. Az x-ms-copy-status-description értékeket a következő táblázat ismerteti:

Összetevő	Leírás
HTTP-állapotkód	Egy standard 3 számjegyű egész szám, amely megadja a hibát.
Hibakód	Az Azure által az ErrorCode> elemben <megadott hibát leíró kulcsszó. Ha nem <jelenik meg ErrorCode> elem, a rendszer egy szabványos hibaszöveggel rendelkező kulcsszót használ, amely a HTTP-specifikációban szereplő 3 jegyű HTTP-állapotkódhoz van társítva. További információ: Common REST API hibakódok.
Tájékoztatás	A hiba részletes leírása idézőjelek közé zárva.

A x-ms-copy-status gyakori hibaforgatókönyvek és x-ms-copy-status-description -értékek az alábbi táblázatban találhatók:

Fontos

Az alábbi hibaleírások figyelmeztetés nélkül is változhatnak, akár verziómódosítás nélkül is, így előfordulhat, hogy a szöveg nem pontosan egyezik meg.

Eset	x-ms-copy-status érték	x-ms-copy-status-description érték
A másolási művelet sikeresen befejeződött.	sikeres	üres
A felhasználó megszakította a másolási műveletet, mielőtt befejeződött volna.	Megszakadt	üres
Hiba történt, amikor egy másolási művelet közben olvas a forrásblobból, de a művelet újra meg fog próbálkozni.	függőben	502 BadGateway "Újrapróbálkozható hibát észlelt a forrás beolvasásakor. Újra próbálkozik. Hiba időpontja: <idő>"
Hiba történt egy másolási művelet célblobjára való íráskor, de a művelet újra meg fog próbálkozni.	függőben	500 InternalServerError "Újrapróbálkozható hibát észlelt. Újra próbálkozik. Hiba időpontja: <idő>"
Helyreállíthatatlan hiba történt egy másolási művelet forrásblobjából való olvasáskor.	sikertelen	404 ResourceNotFound "A másolás nem sikerült a forrás beolvasásakor". Megjegyzés: Amikor a szolgáltatás ezt a mögöttes hibát jelenti, az <errorCode> elemben jelenik `ResourceNotFound` meg. Ha a válaszban nem <jelenik meg ErrorCode> elem, akkor a HTTP-állapot szabványos sztringje jelenik meg, például `NotFound`: .
Az összes másolási műveletet korlátozó időtúllépési időszak. (Az időtúllépési időszak jelenleg két hét.)	sikertelen	500 OperationCancelled "A másolat túllépte a megengedett maximális időt."
A másolási művelet túl gyakran meghiúsult a forrásból való olvasáskor, és nem felelt meg a sikeres kísérletek minimális arányának. (Ez az időtúllépés megakadályozza, hogy két héttel a sikertelenség előtt újrapróbálkozzon egy nagyon gyenge forrással.	sikertelen	500 OperationCancelled "A másolat nem sikerült a forrás beolvasásakor".

x-ms-last-access-time nyomon követi a blob adatainak elérésének időpontját a tárfiók legutóbbi hozzáférési időkövető szabályzata alapján. A blob metaadatainak elérése nem változtatja meg az utolsó hozzáférési idejét.

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

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

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