Megosztási tulajdonságok beállítása
A Set Share Properties művelet beállítja a megadott Azure-fájlmegosztás tulajdonságait. 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 Properties alábbiak szerint hozhatja 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=properties |
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ában 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 az 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-share-quota |
Választható. A 2015-02-21-es és újabb verziókban támogatott. A megosztás maximális méretét adja meg gibibájtban (GiB). |
x-ms-access-tier |
Választható. A 2019-12-12-es és újabb verziókban támogatott. Megadja a megosztás hozzáférési szintjét. Az érvényes értékek a következők: TransactionOptimized, Hotés Cool. A fájlmegosztások rétegzésével kapcsolatos részletes információkért tekintse meg az Azure Files tárolási rétegeit ismertető cikket. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Választható. A 2020-02-10-es és újabb verziókban támogatott. Megadja a megosztás gyökérszintű összevonási viselkedését, ha az NFS engedélyezve van.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Választható. A 2024-08-04-es és újabb verziókban támogatott. Meghatározza, hogy a pillanatkép virtuális könyvtára elérhető legyen-e a megosztási csatlakoztatási pont gyökerénél, ha az NFS engedélyezve van. |
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óiban. 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ó: Az Azure Blob Storage monitorozása. |
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=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
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őjeles sztringként képviselő értéket tartalmaz. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést. A kérés hibaelhárításához is használhatja. 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ó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 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-karakter. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban. |
Választörzs
Nincsenek.
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A megosztási kvóta beállításával kapcsolatos további információkért lásd: Megosztás létrehozása.
Ha a megosztási kvótát kisebbre állítja, mint a megosztáson lévő adatok mérete, a művelet sikeres lesz. Azonban nem tud további adatokat hozzáadni a megosztáshoz, amíg a megosztáson lévő adatok mennyisége nem csökken a kvóta alá. A fájlok törlésével vagy tömörítésével csökkentheti az adatok mennyiségét.
Set Share Properties megosztási pillanatképek esetében nem támogatott. A megosztási pillanatképen végrehajtott művelet végrehajtása a 400-as állapotkóddal (InvalidQueryParameterValue) meghiúsul.
Ha beállítja az x-ms-enable-snapshot-virtual-directory-access fejlécet az NFS-megosztásokhoz, csatlakoztassa újra a megosztást a frissített viselkedés megfigyeléséhez.