Megosztás a következőn keresztül:

Listatartományok

  • Cikk

A List Ranges művelet egy fájl érvényes tartományainak listáját adja vissza. Ezt a műveletet a 2025-05-05-ös és újabb verzió támogatja az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll Beszerezhető
SMB Igen
NFS Igen

Kérés

A List Ranges 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ó
KAP https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist HTTP/1.1
KAP https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist HTTP/1.1
KAP https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime> HTTP/1.1
KAP https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&prevsharesnapshot=<DateTime> 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étereket adhatja meg.

Paraméter Leírás
sharesnapshot Szabadon választható. 2017-04-17-es és újabb verzió. A sharesnapshot paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a fájlhoz lekérdezendő megosztási pillanatképet.
timeout Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: Azure Files-műveletek időtúllépéseinek beállítása.
prevsharesnapshot A 2020-02-10-es és újabb verziókban nem kötelező. A prevsharesnapshot paraméter egy átlátszatlan DateTime érték, amely jelen esetben az előző pillanatképet adja meg.

Ha ez a paraméter és sharesnapshot is jelen van, a válasz csak a két pillanatkép között módosított oldaltartományokat tartalmazza. Ha csak prevsharesnapshot jelenik meg, a válasz csak azokat az oldaltartományokat tartalmazza, amelyek módosultak a pillanatkép és az élő megosztás között.

A módosított lapok tartalmazzák a frissített és a törölt oldalakat is.

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 2025-05-05-ös és újabb verzió támogatja az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében.

További információ: Az Azure Storage-szolgáltatások verziószámozása.
Range Szabadon választható. Azt a bájttartományt adja meg, amely fölött a tartományok listája szerepel, beleértve a tartományokat is. Ha nincs megadva, a rendszer visszaadja a fájl összes tartományát.
x-ms-range Szabadon választható. Azt a bájttartományt adja meg, amely fölött a tartományok listája szerepel, beleértve a tartományokat is.

Ha a Range és a x-ms-range fejléc is meg van adva, a szolgáltatás a x-ms-rangeértékét használja. További információt Az Azure Files-műveletek tartományfejlécének megadása.
x-ms-lease-id:<ID> Szabadon választható. 2019-02-02-es és újabb verzió. Ha a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha a fájl bérlete jelenleg aktív, és a kérelemben megadott bérletazonosító megegyezik a fájléval. Ellenkező esetben a művelet a 412-s állapotkóddal meghiúsul (az előkondicionálás sikertelen).

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 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.
x-ms-file-support-rename: { <Boolean> } Szabadon választható. A 2024-05-04-es és újabb verzió támogatott. Ez a fejléc csak akkor engedélyezett, ha prevsharesnapshot lekérdezési paraméter van jelen. A logikai érték határozza meg, hogy egy fájl módosított tartományai szerepeljenek-e a listán, ha a fájl helye az előző pillanatképben eltér a kérelem URI-jának helyétől az átnevezési vagy áthelyezési műveletek eredményeként. Ha az érték igaz, a rendszer visszaadja a fájl érvényes módosított tartományait. Ha az érték hamis, a művelet 409-et (ütközés) eredményez. Az alapértelmezett érték hamis.

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, 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á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
Last-Modified A fájl utolsó módosításának dátuma/időpontja. Minden olyan művelet, amely módosítja a fájlt, beleértve a fájl metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a fájl utolsó módosítási idejét.
ETag A ETag a fájl verzióját idézőjelekben ábrázoló értéket tartalmaz.
x-ms-content-length A fájl mérete bájtban. Ha prevsharesnapshot jelen van, az érték a fájl méretét írja le a sharesnapshot (ha a sharesnapshot lekérdezési paraméter jelen van). Ellenkező esetben az élő fájl méretét írja le.
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ó. További információ: API-műveletek hibaelhárítása.
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

A válasz törzse tartalmazza a nem átfedésben lévő érvényes tartományok listáját, a címtartomány növelésével rendezve. A válasz törzsének formátuma a következő.

<?xml version="1.0" encoding="utf-8"?>  
<Ranges>  
  <Range>  
    <Start>Start Byte</Start>  
    <End>End Byte</End>  
  </Range>  
  <Range>  
    <Start>Start Byte</Start>  
    <End>End Byte</End>  
  </Range>  
</Ranges>

Ha a fájl teljes tartománya törölve lett, a válasz törzse nem tartalmaz tartományokat.

Ha prevsharesnapshot van megadva, a válasz csak a célpillanatkép (vagy az élő fájl) és az előző pillanatkép között eltérő oldalakat tartalmazza. A visszaadott tartományok közé tartoznak a frissített vagy törölt tartományok. A válasz formátuma a következő:

<?xml version="1.0" encoding="utf-8"?> 
<Ranges> 
  <Range> 
    <Start>Start Byte</Start> 
    <End>End Byte</Start> 
  </Range> 
  <ClearRange> 
    <Start>Start Byte</Start>
    <End>End Byte</Start> 
  </ClearRange> 
  <Range> 
    <Start>Start Byte</Start> 
    <End>End Byte</Start> 
  </Range> 
</Ranges>

Ha a fájl teljes lapkészlete törölve lett, és a prevsharesnapshot paraméter nincs megadva, a válasz törzse nem tartalmaz tartományokat.

Felhatalmazás

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Az egyes tartományok kezdő és záró bájt eltolásai a teljes tartományra kiterjednek. Tekintse meg tartományfrissítési műveletek és tartománytörlési műveletek példákat tartományfrissítési. Ezek a példák azt mutatják be, hogy milyen tartományokat ad vissza a rendszer, ha 512 nem elosztott bájttartományt ír vagy töröl a fájlból.

Nagy számú írással rendelkező, erősen töredezett fájlban egy List Ranges kérés meghiúsulhat egy belső kiszolgáló időtúllépése miatt. A nagy számú írási művelettel rendelkező fájltartományokat lekérő alkalmazásoknak egyszerre le kell kérnie a tartományok egy részhalmazát.

A 2020-02-10-es verziótól kezdve meghívhatja List Ranges egy prevsharesnapshot paraméterrel. Ez visszaadja az élő fájl és a pillanatkép közötti, illetve a pillanatképeken lévő fájl két pillanatképe közötti tartományokat. A tartománykülönbségek használatával lekérheti egy fájl növekményes pillanatképét. A növekményes pillanatképek költséghatékony megoldást jelentenek a fájlok biztonsági mentésére, ha saját biztonsági mentési megoldást szeretne implementálni.

Bizonyos fájlműveletek miatt List Ranges meghiúsul, amikor a rendszer meghívja egy növekményes pillanatkép lekérésére. A szolgáltatás a következőt adja vissza:

  • 404 (Nem található), ha olyan fájlt hív meg, amely nem létezik az egyik pillanatképben (vagy élőben, ha nincs megadva sharesnapshot).
  • 409 (ütközés), ha olyan fájlt hív meg, amely egy felülírási másolás célja volt a pillanatképután , amelyet prevsharesnapshotadott meg.
  • 409 (Ütközés), ha olyan fájlt hív meg, amelyet a prevsharesnapshot által megadott pillanatkép készítése után töröltek és hoztak létre újra ugyanazzal a névvel és hellyel.

Lásd még:

Műveletek fájlokon