Fájl beolvasása
A Get File művelet beolvas vagy letölt egy fájlt a rendszerből, beleértve annak metaadatait és tulajdonságait.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Elérhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Get File kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon.
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
GET |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Cserélje le a kérelem URI-jában látható elérésiút-összetevőket a sajátjára, az alábbiak szerint:
| Elérésiút-összetevő | Leírás |
|---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
mydirectorypath |
Választható. A könyvtár elérési útja. |
myfile |
A fájl neve. |
Az elérési utak elnevezésére vonatkozó korlátozásokkal kapcsolatos információkért lásd: Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatok.
URI-paraméterek
A kérelem URI-ja a következő további paramétereket határozhatja 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 Azure Files műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázat 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. |
Range |
Választható. Csak a megadott bájttartományból ad vissza fájladatokat. |
x-ms-range |
Választható. Csak a megadott bájttartományból ad vissza fájladatokat. Ha a és x-ms-range a érték is Range meg van adva, a szolgáltatás a értékét x-ms-rangehasználja. Ha egyik sincs megadva, a rendszer a teljes fájltartalmat adja vissza. További információért lásd: Tartományfejléc megadása Azure Files műveletekhez. |
x-ms-range-get-content-md5: true |
Választható. Ha ez a fejléc értékre true van állítva, és a Range fejlécgel együtt van megadva, a szolgáltatás visszaadja a tartomány MD5 kivonatát, feltéve, hogy a tartomány kisebb vagy egyenlő 4 bájtnál (MiB).Ha ez a fejléc a Range fejléc nélkül van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés).Ha ez a fejléc akkor van beállítva true , ha a tartomány mérete meghaladja a 4 MiB-t, a szolgáltatás a 400-es állapotkódot adja vissza (hibás kérés). |
x-ms-lease-id:<ID> |
Választható. 2019-02-02-es és újabb verzió. Ha a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha a fájl bérlete jelenleg aktív, és a kérelemben megadott bérletazonosító megegyezik a fájl bérletazonosítójával. Ellenkező esetben a művelet a 412-s állapotkóddal meghiúsul (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 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 Files figyelése. |
x-ms-file-request-intent |
Kötelező, ha Authorization a fejléc OAuth-jogkivonatot ad meg. Elfogadható érték: backup. Ez a fejléc határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action értéket kell megadni, ha szerepelnek a fejléc használatával Authorization engedélyezett identitáshoz rendelt RBAC-szabályzatban. A 2022-11-02-es és újabb verziókhoz érhető el. |
x-ms-allow-trailing-dot: { <Boolean> } |
Választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a kérelem URL-címében található záró pont legyen-e levágva vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés törzse
Nincsenek.
Reagálás
A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és a válasz törzsét, amely tartalmazza a fájl tartalmát.
Állapotkód
A sikeres művelet a 200 -os állapotkódot adja vissza (OK).
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 | Leírás |
|---|---|
Last-Modified |
A fájl utolsó módosításának dátumát és időpontját adja vissza. 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 fájlt vagy annak tulajdonságait, frissíti az utolsó módosítás időpontját. |
x-ms-meta-name:value |
A fájlhoz felhasználó által definiált metaadatokként társított név-érték párok halmaza. |
Content-Length |
A válasz törzsében található bájtok száma. |
Content-Type |
A fájlhoz megadott tartalomtípus. Az alapértelmezett tartalomtípus: application/octet-stream. |
Content-Range |
A visszaadott bájtok tartománya, ha az ügyfél a kérelem fejlécének beállításával kérte a Range fájl egy részhalmazát. |
ETag |
Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé van zárva. |
Content-MD5 |
Ha a fájl MD5-kivonattal rendelkezik, és a kérés a teljes fájl olvasása, a rendszer ezt a válaszfejlécet adja vissza, hogy az ügyfél ellenőrizni tudja az üzenettartalom integritását. Ha a kérelem egy megadott tartomány beolvasására szolgál, és a x-ms-range-get-content-md5 értéke true, a kérelem egy MD5-kivonatot ad vissza a tartományhoz, feltéve, hogy a tartomány mérete kisebb vagy egyenlő 4 MiB-nél.Ha egyik feltételkészlet sem az true, a fejléchez Content-MD5 nem ad vissza értéket.Ha x-ms-range-get-content-md5 a tartományfejléc nélkül van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérelem).Ha x-ms-range-get-content-md5 a tartomány 4 MiB-t meghaladó értékre van állítva true , a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérelem). |
Content-Encoding |
A kérelemfejléchez Content-Encoding megadott értéket adja vissza. |
Content-Language |
A kérelemfejléchez Content-Language megadott értéket adja vissza. |
Cache-Control |
A rendszer akkor adja vissza, ha korábban meg lett adva a fájlhoz. |
Content-Disposition |
A fejléchez x-ms-content-disposition megadott értéket adja vissza, és megadja a válasz feldolgozásának módját.A Content-Disposition válaszfejléc mező további információkat nyújt 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 attachmentContent-Disposition van állítva, az azt jelzi, hogy a felhasználó-ügynöknek nem kell megjelenítenie a választ, hanem egy Mentés másként ablakot kell megjelenítenie. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és 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 szolgáltatásverzió. |
Accept-Ranges: bytes |
Azt jelzi, hogy a szolgáltatás támogatja a részleges fájltartalomra vonatkozó kéréseket. |
Date |
Date |
x-ms-copy-completion-time:<datetime> |
2015-02-21-es és újabb verzió. Az utolsó fájlmásolási művelet befejezési ideje, ahol ez a fájl volt a célfájl. 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 fájl még soha nem volt a cél egy Fájl másolása műveletben, vagy ha a fájlt módosították egy befejezett Fájl másolása művelet után, amely a Fájltulajdonságok beállítása vagy a Fájl létrehozása műveletet használta. |
x-ms-copy-status-description: <error string> |
2015-02-21-es és újabb verzió. Csak akkor jelenik meg, ha x-ms-copy-statussikertelen vagy függőben van. 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 fájl még soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájlt módosították egy befejezett Fájl másolása művelet után, amely a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása műveletet használta. |
x-ms-copy-id: <id> |
2015-02-21-es és újabb verzió. Az utolsó fájlmásolási művelet sztringazonosítója, ahol ez a fájl volt a célfájl. Ez a fejléc nem jelenik meg, ha a fájl soha nem volt a cél egy Fájl másolása műveletben, vagy ha a fájlt módosították egy befejezett Fájl másolása művelet után, amely a Fájltulajdonságok beállítása vagy a Fájl létrehozása műveletet használta. |
x-ms-copy-progress: <bytes copied/bytes total> |
2015-02-21-es és újabb verzió. A másolt bájtok számát és a forrásban lévő összes bájtot tartalmazza az utolsó fájlmásolási kísérletben, ahol ez a fájl volt a célfájl. Megjeleníthető 0-tól a másolt Content-Length bájtok számig. Ez a fejléc nem jelenik meg, ha ez a fájl még soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájlt módosították egy befejezett Fájl másolása művelet után, amely a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása műveletet használta. |
x-ms-copy-source: url |
2015-02-21-es és újabb verzió. Legfeljebb 2 KB hosszúságú URL-cím, amely meghatározza azt a forrásfájlt, amelyet az utolsó fájlmásolási kísérlet során használt, ahol ez a fájl volt a célfájl. Ez a fejléc nem jelenik meg, ha ez a fájl még soha nem volt cél a Fájl másolása műveletben, vagy ha a fájlt módosították a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása műveletet használó befejezett Fájlmásolás művelet után. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
2015-02-21-es és újabb verzió. A által azonosított x-ms-copy-idmásolási művelet állapota az alábbi értékekkel:- 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.- success: A másolás sikeresen befejeződött.- aborted: A másolást a fájl másolásának megszakítása fejezte be.- 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 fájl még soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájlt módosították a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása műveletet használó befejezett Fájlmásolás művelet után. |
x-ms-content-md5 |
A 2016-05-31-es verziótól kezdve, ha a fájl MD5 kivonattal rendelkezik, és ha a kérelem tartományfejlécet (range vagy x-ms-range) tartalmaz, akkor a rendszer ezt a válaszfejlécet adja vissza a teljes fájl MD5 értékével. Ez az érték lehet vagy nem egyenlő a fejlécben Content-MD5 visszaadott értékkel, amely a kért tartományból lesz kiszámítva. |
x-ms-server-encrypted: true/false |
2017-04-17-es és újabb verzió. Ennek a fejlécnek az értéke akkor van beállítva, true ha a fájladatok és az alkalmazás metaadatai teljes mértékben titkosítva vannak a megadott algoritmus használatával. Ha a fájl titkosítatlan, vagy ha csak a fájl/alkalmazás metaadatainak egy része van titkosítva, akkor az érték a következőre falsevan állítva: . |
x-ms-file-permission-key |
A fájl engedélyének kulcsa. |
x-ms-file-attributes |
A fájl fájlrendszerattribútumai. További információt az elérhető attribútumok listájában talál. |
x-ms-file-creation-time |
A fájl létrehozási idő tulajdonságát képviselő UTC dátum/idő érték. |
x-ms-file-last-write-time |
Az UTC dátum/idő értéke, amely a fájl utolsó írási idejének tulajdonságát jelöli. |
x-ms-file-change-time |
A fájl változási idő tulajdonságát képviselő UTC dátum/idő. |
x-ms-file-file-id |
A fájl fájlazonosítója. |
x-ms-file-parent-id |
A fájl szülőfájl-azonosítója. |
x-ms-lease-duration:infinite |
2019-02-02-es és újabb verzió. Ha egy fájlt bérletbe ad, megadja, hogy a bérlet végtelen időtartamú legyen. |
x-ms-lease-state: <available, leased, broken> |
2019-02-02-es és újabb verzió. Amikor egy fájlt bérletbe ad, a fájl bérletállapotát adja meg. |
x-ms-lease-status: <locked, unlocked> |
2019-02-02-es és újabb verzió. Amikor egy fájlt bérletbe ad, megadja a fájl bérletének állapotát. |
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-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor nem jelenik meg a válaszban. |
Választörzs
A válasz törzse tartalmazza a fájl tartalmát.
Mintaválasz
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-version: 2019-02-02
Server: Windows-Azure-File/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>
x-ms-lease-duration: infinite
x-ms-lease-state: leased
x-ms-lease-status: locked
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha olyan tartományt hív Get File át, amely még nem rendelkezik tartalommal, vagy amely nincs törölve, a bájtok visszaadása 0 .
Ha a híváshoz Get File nincs megadva tartomány, a szolgáltatás a bájttartományt adja vissza a fejléchez megadott értékig x-ms-content-length . A tartalommal nem rendelkező tartományok esetében a szolgáltatás ezekért a bájtokért 0 tér vissza.
MiB-enként Get File két percnyi művelet végezhető el. A MiB-nként átlagosan két percnél hosszabb ideig futó műveletek időtúllépést fognak végrehajtani.