Získat rozsahy stránek

Operace Získat rozsahy stránek vrátí seznam platných rozsahů stránek pro objekt blob stránky nebo snímek objektu blob stránky.

Žádost

Požadavek Get Page Ranges (Získat rozsahy stránek) je možné vytvořit následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

Identifikátor URI služby emulovaného úložiště

Při vytváření požadavku na službu emulovaného úložiště zadejte název hostitele emulátoru a port Azure Blob Storage jako 127.0.0.1:10000 a název emulovaného účtu úložiště:

Další informace najdete v tématu Použití emulátoru úložiště Azure pro vývoj a testování.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Tato operace také podporuje použití podmíněných hlaviček k získání rozsahů stránek pouze v případě, že je splněna zadaná podmínka. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Další informace o stavových kódech najdete v tématu Kódy stavu a chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Text odpovědi

Text odpovědi obsahuje seznam nepřekrývajících se platných rozsahů stránek seřazených podle zvětšení rozsahu adresních stránek. Text odpovědi má následující formát:

<?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>  

Pokud se vymaže celá sada stránek objektu blob, text odpovědi neobsahuje žádné rozsahy stránek.

Pokud jste zadali prevsnapshot parametr, odpověď bude obsahovat jenom stránky, které se liší mezi cílovým snímkem nebo objektem blob a předchozím snímkem. Vrácené stránky zahrnují obě stránky, které byly aktualizovány nebo vymazány. Tento text odpovědi má následující formát:

<?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>  
  

Pokud se vymazala celá sada stránek objektu prevsnapshot blob a nezadá se parametr, tělo odpovědi neobsahuje žádné rozsahy stránek.

maxresults Pokud byl parametr zadán, odpověď bude obsahovat pouze zadaný počet rozsahů s pokračovacím tokenem NextMarker ve značce . Token pokračování je prázdný, pokud neexistují žádné další nevyřízené rozsahy, nebo obsahuje neprůžnou hodnotu, kterou je potřeba odeslat jako marker parametr v dalším požadavku. Tento text odpovědi má následující formát:

<?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>  
  

Autorizace

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci můžete autorizovat Get Page Ranges , jak je popsáno níže.

Poznámky

Počáteční a koncové posuny bajtů pro každý rozsah stránek jsou inkluzivní.

U vysoce fragmentovaného objektu blob stránky s velkým počtem zápisů Get Page Ranges může požadavek selhat kvůli vypršení časového limitu interního serveru. Aplikace, které načítají rozsahy objektu blob stránky s velkým počtem operací zápisu, by měly najednou načíst podmnožinu rozsahů stránek.

Od verze 2015-07-08 můžete volat Get Page Ranges s parametrem prevsnapshot a vrátit stránky, které se liší mezi základním objektem blob a snímkem, nebo mezi dvěma snímky objektu blob. Pomocí těchto rozdílů mezi stránkami můžete uložit přírůstkový snímek objektu blob stránky. Přírůstkové snímky představují nákladově efektivní způsob zálohování disků virtuálních počítačů, pokud chcete implementovat vlastní řešení zálohování.

Volání Get Page Ranges s parametrem prevsnapshot vrátí stránky, které byly aktualizovány nebo vymazány od pořízení snímku určeného parametrem prevsnapshot . Stránky, které se vrátí, pak můžete zkopírovat do záložního objektu blob stránky v jiném účtu úložiště pomocí možnosti Vložit stránku.

Od verze 2019-07-07 můžete pomocí x-ms-previous-snapshot-url hlavičky určit snímky v účtech spravovaných disků pro přírůstkové snímky. Pokud nepoužíváte spravované disky, použijte prevsnapshot parametr dotazu.

Některé operace u objektu blob způsobují Get Page Ranges selhání, když se volá za účelem vrácení přírůstkového snímku. Get Pages Ranges selže s kódem chyby 409 (Konflikt), pokud je volána u objektu blob, který byl cílem požadavku put blob nebo kopírování objektu blob po pořízení snímku určeného nástrojem prevsnapshot . Pokud je cílem Get Page Ranges operace samotný snímek, volání proběhne úspěšně, pokud je snímek zadaný pomocí prevsnapshot starší a v intervalu mezi těmito dvěma snímky nebyla volána žádná Put Blob operace nebo Copy Blob .

Viz také

Autorizace požadavků do Služby Azure Storage
Stavové kódy a kódy chyb
Nastavení časových limitů pro operace služby Blob Storage