Metaadatok megosztása
A Set Share Metadata
művelet egy vagy több felhasználó által definiált név/érték párt állít be a megadott megosztáshoz. Bár ez a művelet teljes mértékben támogatott, ez egy örökölt felügyeleti művelet. Javasoljuk, hogy inkább a Tárolási erőforrás-szolgáltató (Microsoft.Storage) által biztosított Fájlmegosztások – Frissítés műveletet használja. Ha többet szeretne megtudni az erőforrások tárerőforrás-szolgáltatóval történő programozott használatáról FileShare
, tekintse meg a Fájlmegosztási erőforrásokon végzett műveleteket ismertető cikket.
Protokoll rendelkezésre állása
Engedélyezett fájlmegosztási protokoll | Elérhető |
---|---|
SMB | |
NFS |
Kérés
A kérést az Set Share Metadata
alábbiak szerint hozza létre. A HTTPS használatát javasoljuk. Cserélje le a myaccount kifejezést a tárfiók nevére.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&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. |
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érelem URI-ján a következő további paramétereket adhatja meg:
Paraméter | Leírás |
---|---|
timeout |
Választható. Másodpercben kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez. |
Kérésfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket 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. |
x-ms-meta-name:value |
Választható. A megosztás metaadatait tartalmazó név-érték pár. A művelet minden hívása lecseréli a megosztáshoz csatolt összes meglévő metaadatot. Ha az összes metaadatot el szeretné távolítani a megosztásbó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 Storage Analytics 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 Blob Storage figyelése. |
x-ms-lease-id:<ID> |
Kötelező, ha a célfájlmegosztás aktív bérletet kapott. A 2020-02-10-es és újabb verziókhoz érhető el. Ha a kérelem nem tartalmazza a bérletazonosítót, vagy nem érvényes, a művelet a 412-ös állapotkóddal meghiúsul (az előfeltétel sikertelen). Ha ez a fejléc meg van adva, és a célfájlmegosztásnak jelenleg nincs aktív bérlete, a művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen). |
A kérés törzse
Nincsenek.
Mintakérés
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
Válaszfejléc | Description |
---|---|
Last-Modified |
A megosztás 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 megosztást vagy annak tulajdonságait, frissíti az utolsó módosítás időpontját. A fájlokon végzett műveletek nincsenek hatással a megosztás utolsó módosításának időpontjára. |
ETag |
A megosztás verzióját idézőjelek közé jelölő értéket tartalmaz. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést. Segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Azure Files verzióját jelzi. |
Date vagy x-ms-date |
UTC dátum/idő érték, amely azt az időpontot jelzi, amikor a szolgáltatás elküldte a választ. |
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 fejléc értékével, ha az szerepel a kérelemben, é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
A hívás Set Share Metadata
felülírja a megosztáshoz társított összes meglévő metaadatot. Egyéni név-érték pár nem módosítható.
A megosztások metaadatait a létrehozáskor is beállíthatja a Megosztás létrehozása művelet részeként.
A hívás Set Share Metadata
frissíti a ETag
megosztás és Last-Modified-Time
a tulajdonságait.
Set Share Metadata
megosztási pillanatképek esetében nem támogatott. A művelet megosztási pillanatképen való végrehajtására tett kísérlet a 400-as állapotkóddal (InvalidQueryParameterValue) meghiúsul. A művelet részeként Snapshot Share
a megosztási pillanatkép metaadatait a létrehozáskor állíthatja be.