Tartomány elhelyezése URL-címről
A Put Range From URL művelet létrehoz egy új, véglegesítendő tartományt egy olyan fájl részeként, amelyben a tartalom egy URL-címről lesz beolvasva. Ezt a műveletet a 2019-02-02-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 protokollal rendelkező fájlmegosztások esetében.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Put Range From URL 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/myfile?comp=range |
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 a Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatokcímű témakörben talál.
URI-paraméterek
| Paraméter | Leírás |
|---|---|
timeout |
Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása az Azure Files-műveletekhez. |
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ót Az Azure Storage- kéréseinek engedélyezése című témakörben talál. |
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 2019-02-02-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 protokollal rendelkező fájlmegosztások esetében. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-copy-source:name |
Szükséges. Megadja a forrásfájl URL-címét. Az érték legfeljebb 2 KiB hosszúságú URL-cím lehet, amely egy fájlt határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogyan az egy kérelem URI-jában jelenik meg. A forrásfájlnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell rendelkeznie. Ha a forrásfájl nyilvános, a művelet végrehajtásához nincs szükség engedélyezésre. Íme néhány példa a forrásobjektum URL-címére:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Szabadon választható. Megadja a másolási forrás engedélyezési sémát és aláírást. További információ: Kérelmek engedélyezése az Azure Storage-. A Microsoft Entra csak a séma tulajdonosát támogatja. Ez a fejléc a 2020-10-02-es és újabb verziókban támogatott. |
x-ms-write: { update } |
Szükséges. Csak updatekell megadnia. A kérés meghiúsul, ha clearvan meghívva. A update érték a kérelem törzse által megadott bájtokat írja a megadott tartományokba. |
Range vagy x-ms-range |
Szükséges. Szükség van Range vagy x-ms-range.Megadja az írandó bájtok tartományát. A tartomány kezdetét és végét is meg kell adni. Ezt a fejlécet a HTTP/1.1 protokoll specifikációjahatározza meg. Frissítési művelet esetén a tartomány legfeljebb 4 MiB méretű lehet. Az Azure Files csak egyetlen bájttartományt fogad el a Range és x-ms-range fejlécekhez, és a bájttartományt a következő formátumban kell megadni: bytes=startByte-endByte.Ha Range és x-ms-range is meg van adva, a szolgáltatás a x-ms-rangeértékét használja. További információ: Az Azure Files-műveletek tartományfejlécének megadása. |
x-ms-source-range |
Szükséges. A forrásból beolvasandó bájtok tartományát adja meg. A tartomány kezdetét és végét is meg kell adni. Az Azure Files csak egyetlen bájttartományt fogad el a Range és x-ms-range fejlécekhez, és a bájttartományt a következő formátumban kell megadni: bytes=startByte-endByte.A forrástartomány mérete legfeljebb 4 MiB lehet. Ha a forrástartomány mérete meghaladja a 4 MiB-t, az Azure Files a 413-es állapotkódot adja vissza (a kérelem entitása túl nagy). Ha a forrástartomány mérete nem egyezik a tartomány (céltartomány) méretével, a szolgáltatás a 400-es állapotkódot adja vissza (hibás kérelem). |
Content-Length |
Szükséges. A kérelem törzsében továbbított bájtok számát adja meg. A fejléc értékét 0értékre kell állítani. Ha a hossz nem 0, a művelet a 400-ás állapotkóddal (hibás kérelem) meghiúsul. |
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-source-content-crc64 |
Szabadon választható. A megadott tartomány CRC64 kivonata az URI-tól. Ez a kivonat a tartomány integritásának ellenőrzésére szolgál az adatok URI-ból való átvitele során. Ha ez a fejléc meg van adva, az Azure Files összehasonlítja a másolási forrásból érkezett tartalom kivonatát ezzel a fejlécértékkel. Megjegyzés: Ezt a CRC64 kivonatot nem tárolja a fájl. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul. |
x-ms-source-if-match-crc64 |
Szabadon választható. CRC64 ellenőrzőösszeg értéke. Adja meg ezt a fejlécet, hogy csak akkor hajtsa végre a műveletet, ha a forrásból beolvasott tartomány ellenőrzőösszege megegyezik a megadott ellenőrzőösszegből. Ha a megadott feltétel nem teljesül, az Azure Files a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). |
x-ms-source-if-none-match-crc64 |
Szabadon választható. CRC64 ellenőrzőösszeg értéke. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az adott forrásból beolvasott tartomány ellenőrzőösszege eltér a megadott ellenőrzőösszegtől. Ha a megadott feltétel nem teljesül, az Azure Files a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). |
x-ms-lease-id: <ID> |
Akkor szükséges, ha a fájl aktív bérletet kapott. A 2019-02-02-es és újabb verzióhoz érhető el. Ez a fejléc figyelmen kívül lesz hagyva, ha a fájl engedélyezve van egy NFS protokollal rendelkező fájlmegosztáson, 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 az Azure Storage Analytics naplózásának engedélyezésekor rögzít az elemzési naplókban. Javasoljuk, hogy ezt a fejlécet használja, amikor ügyféloldali tevékenységeket korrelál a kiszolgáló által fogadott kérésekkel. További információ: Blob Storage monitorozása. |
x-ms-file-last-write-time: { now ¦ preserve } |
Szabadon választható. 2021-06-08-es és újabb verzió. A következő lehetőségek egyikét adhatja meg:
|
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. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Szabadon választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a forrás URL-címében található záró pont levágható-e vagy sem. Ezt a fejlécet csak akkor kell megadni, ha a másolási forrás egy Azure-fájlmegosztáson található. Ez az élőfej más másolási forrástípus esetén nem támogatott. Ezt a fejlécet a rendszer figyelmen kívül hagyja, ha a másolási forrás engedélyezett NFS protokollal rendelkező fájlmegosztáson található, 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
Nincs kérelemtörzs.
Mintakérés
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 201-ben (létrehozva) állapotkódot adja vissza. További információ az állapotkódokról: Állapot- és hibakódok.
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 |
|---|---|
ETag |
Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé van zárva. |
Last-Modified |
A fájl utolsó módosításának dátuma és időpontja. A dátumformátum az RFC 1123-at követi. További információ: Dátum/idő értékek megjelenítése fejlécekben. A fájl minden írási művelete, beleértve a fájl metaadatainak vagy tulajdonságainak frissítését is, megváltoztatja a fájl utolsó módosított időpontját. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és 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érelem végrehajtásához használt FileREST API-verziót jelzi. |
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-content-crc64 |
Visszaadva, hogy az ügyfél ellenőrizni tudja az üzenettartalom integritását. Ennek a fejlécnek az értékét az Azure Files számítja ki. Ez nem feltétlenül ugyanaz, mint a kérelemfejlécekben megadott érték. |
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-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban. |
x-ms-file-last-write-time |
2021-06-08-es és újabb verzió. A fájl utolsó írási ideje ISO 8601 formátumban (például 2017-05-10T17:52:33.9551861Z). |
Csak SMB-válaszfejlécek
Egyik sem.
Csak NFS-válaszfejlécek
Egyik sem.
Válasz törzse
Egyik sem.
Mintaválasz
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Felhatalmazás
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A Put Range From URL művelet adattartományt ír egy fájlba, és hasonló a Put Range művelethez. A megadott forrás Get File műveletét használja a forrásfájl adatainak, metaadatainak és egyéb tulajdonságainak olvasásához. A 2020-10-02-es és újabb verziókban a Microsoft Entra-hitelesítés támogatott a másolási művelet forrásához.
A Put Range From URL művelet csak akkor ad vissza sikeres 201(Létrehozás) értéket, ha a megadott tartomány a fájlba van írva.