Get Blob Properties
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/myblobhttps://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 Létrehozás egy blob pillanatképét. |
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 igaz, a , x-ms-group és x-ms-acl válaszfejlécekben x-ms-ownervisszaadott felhasználói identitásértékek Microsoft Entra objektumazonosítókból egyszerű felhasználónevekké alakulnak át. Ha az érték hamis, a függvény 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 blobon 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 egy befejezett, megszakított vagy sikertelen másolási kísérlet 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 ezt a blobot módosították egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után. |
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. Egy végzetes vagy nem végzetes másolási művelet hibájának okát ismerteti. 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 egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után módosították. |
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 egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után módosították. |
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 és bájtok teljes számát tartalmazza, ahol ez a blob volt a célblob. 0-tól másolt bájtig Content-Length jeleníthető meg. 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 egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után módosították. |
x-ms-copy-source: url |
2012-02-12-es és újabb verzió. Legfeljebb 2 kib hosszúságú URL-cím, amely az utolsó kísérlet Copy Blob során használt forrásblobot adja meg, 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 egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után módosították. |
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 előrehaladását, de ne okozzon hibát.- aborted: A másolás befejeződött a következővel Abort Copy Blob: .- failed: A másolás nem sikerült. A hiba részleteiért lásd x-ms-copy-status-description : .Ez a fejléc nem jelenik meg, ha ez a blob soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot egy , Put Blobvagy Put Block Listparancsot használó Set Blob Propertiesbefejezett Copy Blob művelet után módosították. |
x-ms-incremental-copy: true |
2016-05-31-es és újabb verzió. Belefoglalva, ha a blob növekményes másolási blob. |
x-ms-copy-destination-snapshot:<datetime> |
2016-05-31-es és újabb verzió. Belefoglalva, 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ések esetén is tartalmazza. |
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ések esetén is tartalmazza. |
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 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. |
Content-MD5 |
Ha a Content-MD5 blob fejléce be van állítva, a rendszer ezt a válaszfejlécet adja vissza, hogy az ügyfél ellenőrizni tudja az üzenet tartalomintegritását.A 2012-02-12-es és újabb verziókban 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 már be van állítva a blobhoz, a rendszer ezt az értéket adja vissza ebben a fejlécben. |
Content-Language |
Ha a Content-Language kérelem fejléce korábban már be van állítva a blobhoz, a rendszer ezt az értéket adja vissza ebben a fejlécben. |
Content-Disposition |
Ha a Content-Disposition kérés fejléce korábban már 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ójú kérések esetében.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 fejléc értékre attachmentvan állítva, az azt jelzi, hogy a felhasználói ü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 már be van állítva a blobhoz, a rendszer ezt az értéket adja vissza ebben a fejlécben. |
x-ms-blob-sequence-number |
Az oldalblob aktuális sorszáma. Ez a fejléc nem jelenik meg blokkblobok vagy hozzáfűző blobok esetében. 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. Ezt a fejlécet a rendszer a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén adja vissza. Ez a fejléc a megadott verzió nélküli névtelen kérések esetén is megjelenik, ha a tároló nyilvános hozzáférésre lett megjelölve a Blob Storage 2009-09-19-es verziójával. |
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érésekhez 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ók. 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 algoritmussal. Ellenkező esetben az érték értékre false van állítva (ha a blob titkosítatlan, vagy ha a blob/alkalmazás metaadatainak csak 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 fiókhoz engedélyezve van a hierarchikus névtér. |
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ó. Egy Premium Storage-fiók lapblobjának szintje vagy blokkblob szintje egy Blob Storage-fiókban vagy általános célú v2-fiókban. Az engedélyezett prémium szintű lapblobszintek listáját lásd: Nagy teljesítményű Premium Storage és felügyelt lemezek virtuális gépekhez. 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ókban 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ó. Csak Premium Storage fiókban lévő lapblobok esetén. Ha a hozzáférési szint nincs explicit módon beállítva a blobon, a réteg a tartalomhossza alapján lesz kikövetkeztetve, és ezt a fejlécet a rendszer a következő értékkel trueadja vissza: . A Blob Storage-ban vagy egy általános célú v2-fiókban található blokkblobok esetében, ha a blob nem rendelkezik a hozzáférési szinttel, a tárfiók tulajdonságaiból következtethet a rétegre. Ez a fejléc csak akkor van beállítva, ha a blokkblobszintre következtetnek. |
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 nem teljes, 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 blokkblob rétege valaha is be lett állítva. 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 a hierarchikus névtérrel rendelkező fiókok esetében. 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 a hierarchikus névtérrel rendelkező fiókok esetében. A fájl vagy könyvtár tulajdonoscsoportját adja vissza. |
x-ms-permissions |
2020-06-12-es és újabb verzió. Csak a hierarchikus névtérrel rendelkező fiókok esetében. 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 formátuma [r,w,x,-]{3} . |
x-ms-acl |
2023-11-03-es és újabb verzió. Csak a hierarchikus névtérrel rendelkező fiókok esetében. A felhasználó,csoport és más fájlokhoz vagy címtárakhoz beállított hozzáférési és alapértelmezett hozzáférés-vezérlési lista kombinált listáját adja vissza. Minden hozzáférés-vezérlési bejegyzés (ACE) egy hatókörből, egy típusból, egy felhasználó- vagy csoportazonosítóból és a formátumú [scope]:[type]:[id]:[permissions]engedélyekből áll. A default hatókör azt jelzi, hogy az ACE egy könyvtár alapértelmezett ACL-jéhez tartozik; ellenkező esetben a hatókör implicit, az ACE pedig a hozzáférési ACL-hez tartozik. Minden egyes engedély formátuma [r,w,x,-]{3} . |
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.
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 Get Blob Properties 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.
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. Az egyezés biztosítja, hogy egy másik alkalmazás ne szakítsa meg a másolatot, és ne indítson el egy új Copy Blob műveletet. Ezután keresse meg a fejlécet x-ms-copy-status: success . Vegye figyelembe azonban, hogy egy blob összes írási művelete a , Put Pagea és Put Block a kivételével Leaseminden tulajdonságot eltávolít x-ms-copy-* 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 az alábbi táblázat ismerteti:
| Összetevő | Leírás |
|---|---|
| HTTP-állapotkód | Egy standard 3 jegyű egész szám, amely megadja a hibát. |
| Hibakód | Egy kulcsszó, amely leírja az Azure által az <ErrorCode> elemben megadott hibát. Ha nem <jelenik meg ErrorCode> elem, a rendszer a HTTP-specifikációban szereplő 3 jegyű HTTP-állapotkódhoz társított szabványos hibaszöveggel rendelkező kulcsszót használja. További információ: Gyakori REST API-hibakódok. |
| Tájékoztatás | A hiba részletes leírása idézőjelek között. |
A x-ms-copy-status gyakori hibaforgatókönyvek és x-ms-copy-status-description -értékek leírását az alábbi táblázat ismerteti:
Fontos
Az alábbi hibaleírások figyelmeztetés nélkül, akár verziómódosítás nélkül is változhatnak, így előfordulhat, hogy a szöveg nem pontosan egyezik.
| 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 a forrásblobból való olvasáskor egy másolási művelet során, de a rendszer újra meg fogja próbálni a műveletet. | függőben | 502 BadGateway "Újrapróbálkozható hiba történt a forrás olvasásakor. Újra próbálkozik. A 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 lesz próbálva. | függőben | 500 InternalServerError "Újrapróbálkozható hiba történt. Újra próbálkozik. A hiba időpontja: <idő>" |
| Helyreállíthatatlan hiba történt egy másolási művelet forrásblobjából való beolvasáskor. | sikertelen | 404 ResourceNotFound "A másolás nem sikerült a forrás olvasásakor". Megjegyzés: Ha a szolgáltatás ezt a mögöttes ResourceNotFound hibát jelenti, az <ErrorCode> elemben tér vissza. Ha nem <jelenik meg ErrorCode> elem a válaszban, a HTTP-állapot szabványos sztringje jelenik meg, például NotFound: . |
| Az összes másolási műveletet korlátozó időkorlát. (Az időtúllépési időszak jelenleg két hét.) | sikertelen | 500 OperationCancelled "A másolat túllépte a maximálisan engedélyezett 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ési 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 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 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á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