Fájltulajdonságok lekérése

A Get File Properties művelet visszaadja a fájl összes felhasználó által definiált metaadatait, szabványos HTTP-tulajdonságait és rendszertulajdonságait. Nem adja vissza a fájl tartalmát.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll	Elérhető
SMB
NFS

Kérés

A Get File Properties kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon.

Metódus	Kérés URI-ja	HTTP-verzió
HEAD	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1
HEAD	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>	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ő	Description
myaccount	A tárfiók neve.
myshare	A fájlmegosztás neve.
mydirectorypath	Választható. A szülő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
sharesnapshot	Választható. 2017-04-17-es és újabb verzió. A sharesnapshot paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a fájltulajdonságok lekérdezéséhez szükséges megosztási pillanatképet.
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
Engedélyezés	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-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. Ha nem egyezik, a 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 kibibyte (KiB) karakterkorláttal, amelyet az Azure Storage Analytics naplózásának engedélyezésekor rögzít a rendszer az elemzési naplókban. Erősen ajánlott ezt a fejlécet használni, ha az ügyféloldali tevékenységeket a kiszolgáló által fogadott kérésekkel korrelálja. További információ: Azure Blob Storage 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 azt adja 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 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.

Válaszfejléc	Description
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.
x-ms-type: <File>	A típust Fileadja vissza. Jövőbeli használatra fenntartva.
Content-Length	A fájl mérete bájtban. Ez a fejléc a fájlban tárolt fejléc értékét x-ms-content-length adja vissza.
Content-Type	A fájlhoz 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. Az érték idézőjelek közé van zárva.
Content-MD5	Ha a Content-MD5 fájl fejléce be van állítva, a rendszer visszaadja a Content-MD5 válaszfejlécet, hogy az ügyfél ellenőrizni tudja az üzenet tartalomintegritását.
Content-Encoding	Ha a Content-Encoding kérelem fejléce korábban már be van állítva a fájlhoz, a rendszer ebben a fejlécben adja vissza az Content-Encoding értéket.
Content-Language	Ha a Content-Language kérelem fejléce korábban már be van állítva a fájlhoz, a rendszer ebben a fejlécben adja vissza az Content-Language értéket.
Cache-Control	Ha a Cache-Control kérelem fejléce korábban be van állítva a fájlhoz, a rendszer ebben a fejlécben adja vissza az Cache-Control értéket.
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 kellene 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ót jelzi.
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-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 cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
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 egy másolat függőben van, ha ez a fájl még soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
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 ez a fájl soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
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 abban az utolsó fájlmásolási kísérletben, amelyben ez a fájl volt a célfájl. 0 és a másolt bájtok Content-Length száma között jelenik meg. Ez a fejléc nem jelenik meg, ha ez a fájl soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
x-ms-copy-source: url	2015-02-21-es és újabb verzió. Legfeljebb 2 KB karakterből álló URL-cím, amely megadja 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 soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
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: - Siker: A másolás sikeresen befejeződött. - Függőben lévő: 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. - Megszakadt: A másolást a fájl másolásának megszakítása fejezte be. - Nem sikerült: 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 soha nem volt cél egy Fájl másolása műveletben, vagy ha a fájl a Fájl tulajdonságainak beállítása vagy a Fájl létrehozása művelettel végzett befejezett Fájlmásolási művelet után módosult.
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. Az érték értéke, false ha a fájl titkosítatlan, vagy ha csak a fájl vagy az alkalmazás metaadatainak egy része van titkosítva.
x-ms-file-permission-key	2019-02-02-es és újabb verzió. A fájl engedélyének kulcsa.
x-ms-file-attributes	2019-02-02-es és újabb verzió. A fájl fájlrendszer-attribútumai. További információt az elérhető attribútumok listájában talál.
x-ms-file-creation-time	2019-02-02-es és újabb verzió. A fájl létrehozási idő tulajdonságát képviselő UTC dátum/idő érték.
x-ms-file-last-write-time	2019-02-02-es és újabb verzió. 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	2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, amely a fájl változási idő tulajdonságát jelöli.
x-ms-file-file-id	2019-02-02-es és újabb verzió. A fájl fájlazonosítója.
x-ms-file-parent-id	2019-02-02-es és újabb verzió. 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 kapcsolódó 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

Nincsenek.

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.

Lásd még

Műveletek a Azure Files