Fájl másolásának megszakítása
A Abort Copy File művelet megszakít egy függőben lévő Copy File műveletet, és nulla hosszúságú és teljes metaadatokat tartalmazó célfájlt hagy. Ezt a műveletet a 2015-02-21-es és újabb verzió támogatja az engedélyezett SMB protokollal rendelkező fájlmegosztások esetében, és a 2025-05-05-ös és újabb verzió támogatja az NFS protokollt használó fájlmegosztások esetében.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Abort Copy File kérés a következőképpen jön létre. Javasoljuk, hogy HTTPS-t használjon.
A 2013-08-15-ös verziótól kezdve megadhat egy közös hozzáférési aláírást a célfájlhoz, ha az ugyanabban a fiókban található, mint a forrásfájl. A 2015-04-05-ös verziótól kezdve megadhatja a célfájl közös hozzáférésű jogosultságkódját is, ha az egy másik tárfiókban található.
| Módszer | URI kérése | HTTP-verzió |
|---|---|---|
| HELYEZ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy©id=<id> |
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 szülőkönyvtár elérési útja. |
myfile |
A fájl 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
A kérelem URI-ján a következő további paramétert adhatja meg.
| Paraméter | Leírás |
|---|---|
timeout |
Szabadon választható. Az időtúllépési paraméter másodpercben van kifejezve. További információ: Azure Files-műveletek időtúllépéseinek beállítása. |
Kérelemfejlécek
A szükséges és nem kötelező kérelemfejléceket az alábbi táblázatok ismertetik:
Gyakori kérésfejlécek
| 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 szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ezt a műveletet a 2015-02-21-es és újabb verzió támogatja az engedélyezett SMB protokollal rendelkező fájlmegosztások esetében, és a 2025-05-05-ös és újabb verzió támogatja az NFS protokollt használó fájlmegosztások esetében. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-copy-action:abort |
Szükséges. |
x-ms-lease-id:<ID> |
Akkor szükséges, ha a célfájl aktív bérletet kapott. A 2019-02-02-s és újabb verziókhoz érhető el. Ez a fejléc figyelmen kívül lesz hagyva, ha a célfájl engedélyezett NFS protokollal rendelkező fájlmegosztáson található, amely nem támogatja a fájlbérleteket. |
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. További információ: Monitor Azure Files. |
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. Ez a fejléc figyelmen kívül lesz hagyva, ha a cél olyan fájlmegosztáson található, amelyen engedélyezve van az NFS protokoll, amely alapértelmezés szerint támogatja a záró pont használatát. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
Csak SMB-kérésfejlécek
Egyik sem.
Csak NFS-kérelemfejlécek
Egyik sem.
Kérelem törzse
Egyik sem.
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 204-ben (tartalom nélkül) visszaadott á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ázatok fejléceit 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 válaszfejlécek
| Válaszfejléc | Leírás |
|---|---|
x-ms-request-id |
Ez a fejléc egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. |
x-ms-version |
A kérés futtatásához használt Azure Files-verziót jelzi. |
Date vagy x-ms-date |
UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket. |
x-ms-client-request-id |
Ezzel a fejlécmel elháríthatja a kéréseket és a megfelelő válaszokat. 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. Az érték legfeljebb 1024 látható ASCII-karakter lehet. 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. |
Csak SMB-válaszfejlécek
Egyik sem.
Csak NFS-válaszfejlécek
Egyik sem.
Válasz törzse
Egyik sem.
Felhatalmazás
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha megszakít egy függőben lévő Copy File műveletet, a célfájl x-ms-copy-status fejléce abortedlesz beállítva. A másolási művelet megszakítása nulla hosszúságú célfájlt eredményez. A célfájl metaadatai azonban átmásolják az új értékeket a forrásblobból vagy a fájlból, vagy explicit módon be lesz állítva a Copy File művelethívásban.
Csak függőben lévő másolási műveletet szakíthat meg. A befejezett vagy sikertelen másolat visszavonása ütközési hibát eredményez. A másolási művelet helytelen másolási azonosítóval történő megszakítása ütközési hibát is eredményez.