Oldaltartományok lekérése

Cikk
02/07/2024

Az Oldaltartományok lekérése művelet az oldalblobok érvényes oldaltartományainak listáját vagy egy lapblob pillanatképét adja vissza.

Kérés

Az Oldaltartományok lekérése kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

GET metóduskérés URI-ja	HTTP-verzió
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist` `https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&snapshot=<DateTime>&prevsnapshot=<DateTime>`	HTTP/1.1

Emulált tárolási szolgáltatás URI-ja

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és Azure Blob Storage portot 127.0.0.1:10000 formátumban, majd az emulált tárfiók nevét:

GET metóduskérés URI-ja	HTTP-verzió
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=pagelist`	HTTP/1.1

További információ: Az Azure Storage Emulator használata fejlesztéshez és teszteléshez.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg:

Paraméter	Leírás
`marker`	Nem kötelező, 2020-10-02-es és újabb verzió. A következő GetPageRanges művelettel visszaadandó tartományrészt azonosítja. A művelet egy jelölőértéket ad vissza a választörzsben, ha a visszaadott tartományok hiányosak voltak. A jelölőérték ezután egy későbbi hívásban használható a következő tartománykészlet lekéréséhez. A jelölő értéke átlátszatlan az ügyfél számára.
`maxresults`	Nem kötelező, 2020-10-02-es és újabb verzió. A visszaadandó oldaltartományok maximális számát adja meg. Ha a kérelem 10 000-nél nagyobb értéket ad meg, a kiszolgáló legfeljebb 10 000 elemet ad vissza. Ha további eredményeket szeretne visszaadni, a szolgáltatás egy folytatási jogkivonatot ad vissza a NextMarker válaszelemben. Ha egy nullánál kisebb vagy egyenlő értékre állítja `maxresults` be a hibát, a 400-ás hibakód jelenik meg (hibás kérés).
`snapshot`	Választható. Egy átlátszatlan DateTime érték, amely jelen esetben megadja a blob pillanatképét az információk lekéréséhez. A blob-pillanatképek használatával kapcsolatos további információkért lásd: Blob pillanatképének létrehozása.
`timeout`	Választható. Másodpercben kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez.
`prevsnapshot`	Nem kötelező, 2015-07-08-es és újabb verzió. Egy DateTime érték, amely azt határozza meg, hogy a válasz csak azokat a lapokat tartalmazza, amelyek módosultak a célblob és az előző pillanatkép között. A módosított lapok tartalmazzák a frissített és a törölt oldalakat is. A célblob lehet egy pillanatkép, feltéve, hogy a megadott `prevsnapshot` pillanatkép a kettő közül a régebbi. Megjegyzés: A növekményes pillanatképek jelenleg csak a 2016. január 1-jén vagy azt követően létrehozott blobok esetében támogatottak.

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érések 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érések engedélyezése az Azure Storage-ba.
`x-ms-version`	Az összes engedélyezett kérelemhez kötelező, a 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.
`Range`	Választható. Azt a bájttartományt adja meg, amely felett a tartományokat is beleértve kell listázni. Ha `Range` nincs megadva, a rendszer a blob összes tartományát visszaadja.
`x-ms-range`	Választható. Azt a bájttartományt adja meg, amely felett a tartományokat is beleértve kell listázni. Ha mindkettő `Range` és `x-ms-range` meg van adva, a szolgáltatás a értékét `x-ms-range`használja. További információt a Blob Storage-műveletek tartományfejlécének megadása című témakörben talál.
`x-ms-lease-id:<ID>`	Választható. Ha ez a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha az alábbi feltételek teljesülnek: - A blob bérlete jelenleg aktív. – A kérelemben megadott bérletazonosító megegyezik a blob bérletazonosítójával. Ha ez a fejléc meg van adva, és egyik feltétel sem teljesül, a kérés meghiúsul, és a művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
`x-ms-previous-snapshot-url`	Nem kötelező, 2019-07-07-es és újabb verzió. A `previous-snapshot-url` megadja, hogy a válasz csak azokat a lapokat tartalmazza, amelyek módosultak a célblob és a megadott URI-n található pillanatkép között. A módosított lapok tartalmazzák a frissített és a törölt oldalakat is. A célblob lehet egy pillanatkép, feltéve, hogy az e fejléc által megadott pillanatkép a kettő közül a régebbi. Megjegyzés: A növekményes pillanatképek jelenleg csak a 2016. január 1-jén vagy azt követően létrehozott blobok esetében támogatottak, és ezt a fejlécet csak felügyelt lemezes forgatókönyvekben szabad használni. Ellenkező esetben használja a paramétert `prevsnapshot` .
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibájtos (KiB) karakterkorláttal, amelyet az Azure Storage Analytics naplózásának engedélyezésekor rögzít az elemzési naplókban. Erősen javasoljuk, hogy ezt a fejlécet használja, amikor az ügyféloldali tevékenységeket a kiszolgáló által fogadott kérésekkel korrelálja. További információ: Tudnivalók a Storage Analytics naplózásáról és az Azure-naplózásról: Naplók használata az Azure Storage-kérelmek nyomon követéséhez.

Ez a művelet feltételes fejlécek használatát is támogatja az oldaltartományok lekéréséhez, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmazza a HTTP-állapotkódot, a válaszfejlécek készletét és a válasz törzsét.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó á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 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.

Syntax	Description
`Last-Modified`	A blob utolsó módosításának dátuma/időpontja. A dátumformátum az RFC 1123-at követi. Minden olyan művelet, amely módosítja a blobot, beleértve a blob metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a blob utolsó módosítási időpontját.
`ETag`	Olyan értéket tartalmaz, amellyel az ügyfél feltételesen hajthatja végre a műveletet. Ha a kérelem verziója 2011-08-18 vagy újabb, az ETag értéke idézőjelek közé kerül.
`x-ms-blob-content-length`	A blob mérete bájtban.
`x-ms-request-id`	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 végrehajtásához használt Blob Storage-verziót jelzi. Ez a fejléc a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén jelenik meg. Ez a fejléc a megadott verzió nélküli névtelen kérések esetén is megjelenik, ha a tároló nyilvános hozzáférésre lett megjelölve a Blob Storage 2009-09-19-es verziójával.
`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-client-request-id`	A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a `x-ms-client-request-id` kérelemben szereplő fejléc értékével, é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, akkor az nem jelenik meg a válaszban.

Választörzs

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

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

Ha a blob teljes lapkészlete törölve lett, a választörzs nem tartalmaz oldaltartományokat.

Ha a prevsnapshot paraméter meg lett adva, a válasz csak azokat az oldalakat tartalmazza, amelyek eltérnek a célpillanatkép vagy blob és az előző pillanatkép között. A visszaadott lapok tartalmazzák a frissített vagy törölt oldalakat. A válasz törzsének formátuma a következő:

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

Ha a blob teljes lapkészlete törölve lett, és a prevsnapshot paraméter nincs megadva, a választörzs nem tartalmaz oldaltartományokat.

Ha a maxresults paraméter meg lett adva, a válasz csak a megadott számú tartományt tartalmazza a címkében NextMarker egy folytatási jogkivonattal. A folytatási jogkivonat üres, ha nincs több függőben lévő tartomány, vagy ha olyan átlátszatlan értéket tartalmaz, amelyet paraméterként marker kell elküldeni a következő kérelemben. A válasz törzsének formátuma a következő:

<?xml version="1.0" encoding="utf-8"?>  
<PageList>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>  
   <ClearRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </ClearRange>  
   <PageRange>  
      <Start>Start Byte</Start>  
      <End>End Byte</End>  
   </PageRange>
   <NextMarker/>
</PageList>

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Get Page Ranges alábbiak szerint engedélyezheti.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Get Page Ranges műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Legkevésbé emelt szintű beépített szerepkör:Storage-blobadatok olvasója

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Az SAS-sel részletesen szabályozhatja, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és mennyi ideig érvényes az SAS.

A Get Page Ranges művelet háromféle közös hozzáférésű jogosultságkódot támogat: felhasználódelegálási SAS, szolgáltatás SAS és fiók SAS.

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, ami könnyebben feltörhető. Ha az alkalmazás kialakítása közös hozzáférésű jogosultságkódokat igényel, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználódelegálási SAS-t, ha lehetséges.

Ha a tárfiók esetében nincs engedélyezve a megosztott kulcshoz való hozzáférés, a blobtárolónak küldött kérések esetén a szolgáltatás SAS-jogkivonata vagy a fiók SAS-jogkivonata nem lesz engedélyezve. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Felhasználódelegálási SAS

A felhasználódelegálási SAS-t Microsoft Entra hitelesítő adatok és az SAS-hez megadott engedélyek védik.

Get Page Ranges A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a felhasználódelegálási SAS-jogkivonat részeként.

További információ a felhasználódelegálási SAS-ről: Felhasználódelegálási SAS létrehozása.

Szolgáltatási SAS

A szolgáltatás SAS-jének védelme a tárfiók kulccsal történik. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a Blob Storage-ban delegálja az erőforrásokhoz való hozzáférést.

Get Page Ranges A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a szolgáltatás SAS-jogkivonatának részeként.

További információ a szolgáltatás SAS-járól: Szolgáltatás SAS létrehozása.

Fiók SAS-fiókja

A fiók SAS-jének védelme a tárfiók kulcsával történik. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt hozzáférést. A szolgáltatáson vagy a felhasználódelegálási SAS-en keresztül elérhető összes művelet fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket jelzi, amelyet a hozzáférés delegálásakor kell megadni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Oldaltartományok beolvasása	Blob (b)	Objektum (o)	Olvasás (r)

További információ a fiók SAS-járól: Fiók SAS létrehozása.

Megjegyzések

Az egyes oldaltartományok kezdő és záró bájtjának eltolása a teljes tartományt magában foglalja.

Nagy számú írással rendelkező, erősen töredezett lapblobban a Get Page Ranges kérések meghiúsulhatnak egy belső kiszolgáló időtúllépése miatt. A nagy számú írási művelettel rendelkező lapblob tartományait lekérő alkalmazásoknak egyszerre le kell kérnie az oldaltartományok egy részét.

A 2015-07-08-as verziótól kezdve meghívhatja Get Page Ranges a paramétert, prevsnapshot hogy visszaadja az alapblob és a pillanatkép közötti különbségeket, vagy a blob két pillanatképét. Ezekkel az oldalkülönbségekkel mentheti a lapblobok növekményes pillanatképét. A növekményes pillanatképek költséghatékony megoldást jelentenek a virtuálisgép-lemezek biztonsági mentésére, ha saját biztonsági mentési megoldást szeretne megvalósítani.

A paraméterrel való prevsnapshot hívás Get Page Ranges olyan oldalakat ad vissza, amelyek frissültek vagy törlődtek az által prevsnapshot megadott pillanatkép elkészítése óta. Ezután másolhatja a biztonsági mentési lapblobba visszaküldött lapokat egy másik tárfiókban a Lap elhelyezése paranccsal.

A 2019-07-07-es verziótól a fejléc használatával pillanatképeket adhat meg a x-ms-previous-snapshot-url felügyelt lemezfiókokban a növekményes pillanatképekhez. Ha nem felügyelt lemezeket használ, használja a lekérdezési prevsnapshot paramétert.

A blobok Get Page Ranges bizonyos műveletei meghiúsulnak, ha meghívják egy növekményes pillanatkép visszaadására. Get Pages Ranges 409-os hibakóddal (ütközés) meghiúsul, ha olyan blobon van meghívva, amely egy Put Blob vagy Copy Blob kérés célja volt az által prevsnapshot megadott pillanatkép elkészítése után. Ha a Get Page Ranges művelet célja maga egy pillanatkép, a hívás addig sikeres lesz, amíg a megadott prevsnapshot pillanatkép régebbi, és a két pillanatkép közötti időszakban nem Put Blob vagy Copy Blob műveletet hívtak meg.

Megjegyzés

A növekményes pillanatképek jelenleg csak a 2016. január 1-jén vagy azt követően létrehozott blobok esetében támogatottak. Ha egy régebbi blobon próbálja használni ezt a funkciót, az a BlobOverwritten 409-os (ütközési) HTTP-hibakódot eredményez.

Lásd még

Kérések engedélyezése az Azure Storage-nak
Állapot- és hibakódok
Időtúllépések beállítása a Blob Storage-műveletekhez