Címtár metaadatainak beállítása

Cikk
03/29/2023

A Set Directory Metadata művelet felhasználó által definiált metaadatokat állít be a megadott könyvtárhoz. Ez a művelet a 2015-02-21-es és újabb verziókban érhető el.

Protokoll rendelkezésre állása

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

Kérés

Metódus	Kérés URI-ja	HTTP-verzió
PUT	`https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory& 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ő	Leírás
`myaccount`	A tárfiók neve.
`myshare`	A fájlmegosztás neve.
`myparentdirectorypath`	Választható. A szülőkönyvtár elérési útja.
`mydirectory`	A könyvtár 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-jában a következő további paramétereket adhatja 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 fájlszolgáltatás-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. Ez a művelet csak a 2015-02-21-es és újabb verziókban érhető el. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-meta-name:value`	Választható. Beállítja a könyvtár név-érték párját. A művelet minden hívása lecseréli a címtárhoz csatolt összes meglévő metaadatot. Ha az összes metaadatot el szeretné távolítani a címtárbó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-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 egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Á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 tartalmaz. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Leírás
`ETag`	A könyvtár verzióját képviselő értéket tartalmaz. Az érték idézőjelek közé van zárva.
`x-ms-request-id`	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ájlszolgáltatás-verzió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 és újabb verziók. Ennek a fejlécnek az értéke akkor `true` van beállítva, ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. Ellenkező esetben az érték értékre `false`van állítva.
`x-ms-client-request-id`	A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc é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-karaktert tartalmaz. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, akkor az nem jelenik meg a válaszban.

Választörzs