Fogópontok kényszerítve
A Force Close Handles művelet bezár egy könyvtárban vagy fájlban megnyitott fogópontot vagy fogópontot. Támogatja egy fájl vagy könyvtár leíróazonosítója által megadott egyetlen leíró bezárását. Az erőforráson megnyitott összes fogópont bezárását is támogatja. Opcionálisan támogatja a rekurzívan záró leírókat az alforrásokon, ha az erőforrás könyvtár.
Ezt a műveletet a Listafogantyúk mellett használja a műveleteket letiltó leírók kényszerítésére, például címtár átnevezésére. Előfordulhat, hogy az SMB-ügyfelek kiszivárogtak vagy elveszítették a fogópontok nyomát. A művelet ügyféloldali hatással van a bezárt leíróra, beleértve a felhasználó által látható hibákat is, amelyek a fájlok olvasási vagy írási sikertelen kísérletei miatt jelentkeznek. Ez a művelet nem helyettesíti vagy alternatíva az SMB-munkamenetek bezárását.
Ez a művelet a 2018-11-09-es és újabb verzióban érhető el.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Force Close Handles kérés a következőképpen jön létre. Javasoljuk, hogy HTTPS-t használjon.
| Módszer | URI kérése | HTTP-verzió |
|---|---|---|
| HELYEZ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
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. |
mydirectorypath |
Szabadon választható. A könyvtár elérési útja. |
myfileordirectory |
A fájl vagy könyvtár neve. |
Az útvonalelnevezési korlátozásokról további információt Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
URI-paraméterek
Az URI-n a következő további paramétereket adhatja meg:
| Paraméter | Leírás |
|---|---|
timeout |
Szabadon választható. Másodpercben kifejezve. További információ: Fájlszolgáltatás-műveletek időtúllépéseinek beállítása. |
marker |
Szabadon választható. Sztringérték, amely a következő Force Close Handles művelettel bezárandó fogópontok pozícióját azonosítja. A művelet egy jelölőértéket ad vissza a válasz törzsében, ha több fogópontot kell bezárni. A jelölő értéke ezután egy későbbi hívásban használható a következő fogópontok bezárásához.A jelölő értéke átlátszatlan az ügyfél számára. |
sharesnapshot |
Szabadon választható. Átlátszatlan dátum/idő érték. Ha jelen van, megadja a leírók listájához lekérdezendő megosztási pillanatképet. |
Kérelemfejlécek
Az alábbi táblázat a szükséges és választható kérelemfejléceket ismerteti:
| Kérelem fejléce | Leírás |
|---|---|
Authorization |
Szükséges. 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 |
Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-. |
x-ms-version |
Minden engedélyezett kéréshez kötelező, de névtelen kérésekhez nem kötelező. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
Szabadon 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. |
x-ms-handle-id |
Szükséges. Megadja a bezárandó leíróazonosítót. Az összes fogópont megadásához használjon csillagot (*) helyettesítő karaktersorozatként. |
x-ms-recursive |
Szabadon választható. Logikai érték, amely meghatározza, hogy a műveletet az URI-ban megadott könyvtár fájljaira és alkönyvtáraira is alkalmazni kell-e. |
x-ms-file-request-intent |
Kötelező, ha Authorization fejléc OAuth-jogkivonatot ad meg. Az elfogadható érték backup. Ez a fejléc azt határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action meg kell adni, ha azok szerepelnek a Authorization fejléc használatával 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> } |
Szabadon 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 levágható-e vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
Kérelem törzse
Egyik sem.
Válasz
A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy XML formátumú választörzset.
Állapotkód
A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.
Válaszfejlécek
A műveletre adott válasz az alábbi táblázatban szereplő 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 .
Gyakori fejlécek
| Válaszfejléc | Leírás |
|---|---|
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést. Ezzel 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ót jelzi. |
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-marker |
A következő bezárandó fogópontot ismerteti. Ez a sztring akkor jelenik meg, ha több fogópontot kell bezárni a kérés teljesítéséhez. A sztring a további kérésekben a fennmaradó fogópontok kényszerítésére szolgál. A x-ms-marker hiánya azt jelzi, hogy az összes releváns leíró bezárult. |
x-ms-number-of-handles-closed |
A bezárt fogópontok számát jelzi. |
x-ms-number-of-handles-failed |
A nem bezárt leírók számát jelzi. |
x-ms-client-request-id |
A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek az élőfejnek az é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álasz törzse
Üres.
Felhatalmazás
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha a kérések feldolgozása során nem zárnak le leírókat (például a megadott x-ms-handle-id érték érvénytelen leírót ad meg, vagy a megadott fájlban vagy könyvtárban nem találhatók nyitott leírók), 200 (OK) állapotválaszt kap a x-ms-number-of-handles-closed=0.
A x-ms-recursive fejléc csak könyvtárakra érvényes. Ha egy fájlhoz adja meg, 400-ra (rossz kérelem) fog kapni választ.
Előfordulhat, hogy a FILE_FLAG_DELETE_ON_CLOSE megnyitott leíró kényszerített bezárása nem eredményezi a fájl törlését.
listaleírók a x-ms-handle-id szolgáltatásoldali leíróazonosítót adja vissza. Ez a leíróazonosító eltér az SMB vagy egy alkalmazás által fenntartott megfelelő ügyféloldali leírótól.