Fájl metaadatainak beállítása

A Set File Metadata művelet felhasználó által definiált metaadatokat állít be a megadott fájlhoz.

Protokoll rendelkezésre állása

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

Kérés

A Set File Metadata kérés a következőképpen jön létre. A HTTPS használata ajánlott.

Metódus Kérés URI-ja HTTP-verzió
PUT https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=metadata 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ési korlátozásával kapcsolatos részletekért lásd: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.

URI-paraméterek

A következő további paraméterek adhatók meg a kérelem URI-jában.

Paraméter Leírás
timeout Választható. Az időtúllépési paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása fájlszolgáltatás-műveletekhez.

Kérésfejlécek

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.
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.
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 Services verziószámozása.
x-ms-meta-name:value Választható. Beállít egy név-érték párt a fájlhoz.

A művelet minden hívása lecseréli a fájlhoz csatolt összes meglévő metaadatot. Ha az összes metaadatot el szeretné távolítani a fájlból, hívja meg ezt a műveletet metaadatfejlécek nélkül.

A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak.
x-ms-lease-id:<ID> Akkor szükséges, ha a fájl aktív bérletet kapott. A 2019-02-02-s és újabb verziókhoz érhető el.
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít 1 KiB karakterkorláttal, amely akkor lesz rögzítve az elemzési naplókban, ha engedélyezve van a tárolóelemzés naplózása. A fejléc használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által kapott kérések összevetéséhez. További információ: Az Azure Blob Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.

Állapotkód

A sikeres művelet a 200-ás á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 Description
ETag Az ETag egy olyan értéket tartalmaz, amely a fájl verzióját jelöli, idézőjelek között.
x-ms-request-id Ez a fejléc egyedileg azonosítja a kérést, amely 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 Fájl szolgáltatás verzióját jelzi.
Date vagy x-ms-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-request-server-encrypted: true/false 2017-04-17-es vagy újabb verzió. Ennek a fejlécnek az értéke akkor van beállítva, true ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal, máskülönben false .
x-ms-client-request-id Ez a fejléc a kérések és a megfelelő válaszok hibaelhárítására használható. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és az érték legfeljebb 1024 látható ASCII-karakterből áll. Ha a x-ms-client-request-id fejléc nincs jelen a kérelemben, ez a fejléc nem lesz jelen a válaszban.

Választörzs

Nincsenek.

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Set File Metadata A nem támogatott megosztási pillanatképek esetén, amely egy megosztás írásvédett másolata. A művelet megosztási pillanatképen való végrehajtására tett kísérlet 400-zal meghiúsul (InvalidQueryParameterValue)

Ha a fájlnak aktív bérlete van, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben ahhoz, hogy metaadatokat írjon a fájlba. Ha az ügyfél nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, a Fájlszolgáltatás a 412-s állapotkódot adja vissza (az előfeltétel sikertelen). Ha az ügyfél bérletazonosítót ad meg, de a fájlnak nincs aktív bérlete, akkor a Fájlszolgáltatás a 412-s állapotkódot is visszaadja (az előfeltétel sikertelen).

Lásd még

Fájlokon végzett műveletek