Fájltulajdonságok lekérése

Cikk
02/14/2024

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 `File`adja 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-status`sikertelen 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-id`má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