Seznam oblastí

Článek
03/29/2023

Operace List Ranges vrátí seznam platných oblastí pro soubor.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici.
SMB
NFS

Žádost

Požadavek můžete sestavit List Ranges následujícím způsobem. Doporučuje se https.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist`	HTTP/1.1
GET	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist`	HTTP/1.1
GET	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime>`	HTTP/1.1
GET	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&prevsharesnapshot=<DateTime>`	HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:

Komponenta cesty	Description
`myaccount`	Název vašeho účtu úložiště.
`myshare`	Název sdílené složky.
`mydirectorypath`	Nepovinný parametr. Cesta k nadřazené adresáři.
`myfile`	Název souboru.

Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry.

Parametr	Popis
`sharesnapshot`	Nepovinný parametr. Verze 2017-04-17 a novější. Parametr `sharesnapshot` je neprůzná `DateTime` hodnota, která pokud je k dispozici, určuje snímek sdílené složky, který se má na soubor dotazovat.
`timeout`	Nepovinný parametr. Parametr `timeout` se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files.
`prevsharesnapshot`	Volitelné ve verzi 2020-02-10 a novější. Parametr `prevsharesnapshot` je neprůžná `DateTime` hodnota, která pokud je k dispozici, určuje předchozí snímek. Pokud je k dispozici tento parametr i `sharesnapshot` , bude odpověď obsahovat pouze rozsahy stránek, které byly mezi těmito dvěma snímky změněny. Pokud je k dispozici pouze `prevsharesnapshot` , odpověď bude obsahovat pouze rozsahy stránek, které byly změněny mezi tímto snímkem a živou sdílenou složkou. Změněné stránky zahrnují aktualizované i nezamazané stránky.

Hlavičky požadavku

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

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date` nebo `x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`Range`	Nepovinný parametr. Určuje rozsah bajtů, pro který se mají vypsat rozsahy (včetně). Pokud tento parametr vynecháte, vrátí se všechny rozsahy souboru.
`x-ms-range`	Nepovinný parametr. Určuje rozsah bajtů, pro který se mají vypsat rozsahy (včetně). Pokud jsou zadány hlavičky a `Rangex-ms-range` , služba použije hodnotu `x-ms-range`. Další informace najdete v tématu Zadání hlavičky rozsahu pro operace Azure Files.
`x-ms-lease-id:<ID>`	Nepovinný parametr. Verze 2019-02-02 a novější. Pokud je zadána hlavička, operace se provede pouze v případě, že je zapůjčení souboru aktuálně aktivní a ID zapůjčení zadané v požadavku odpovídá ID zapůjčení souboru. Jinak operace selže se stavovým kódem 412 (Předběžná podmínka selhala).
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files.
`x-ms-file-request-intent`	Vyžaduje se, pokud `Authorization` hlavička určuje token OAuth. Přijatelná hodnota je `backup`. Tato hlavička určuje, že `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` by se měly udělit nebo `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` , pokud jsou zahrnuté v zásadách RBAC přiřazené identitě, která je autorizována pomocí hlavičky `Authorization` . K dispozici pro verzi 2022-11-02 a novější.
`x-ms-allow-trailing-dot: { <Boolean> }`	Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má koncový tečka v adrese URL požadavku oříznout, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a text odpovědi ve formátu XML.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). 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.

Hlavička odpovědi	Description
`Last-Modified`	Datum a čas poslední změny souboru. Jakákoli operace, která upraví soubor, včetně aktualizace metadat nebo vlastností souboru, změní čas poslední změny souboru.
`ETag`	Obsahuje `ETag` hodnotu, která představuje verzi souboru v uvozovkách.
`x-ms-content-length`	Velikost souboru v bajtech Když `prevsharesnapshot` je k dispozici, pak hodnota popisuje velikost souboru v poli `sharesnapshot` (pokud `sharesnapshot` je k dispozici parametr dotazu). V opačném případě popisuje velikost živého souboru.
`x-ms-request-id`	Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a dá se použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Označuje verzi Azure Files použité ke spuštění požadavku.
`Date` nebo `x-ms-date`	Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
`x-ms-client-request-id`	Tuto hlavičku můžete použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud je v požadavku. Hodnota je maximálně 1024 viditelných znaků ASCII. Pokud hlavička `x-ms-client-request-id` v požadavku není, nebude tato hlavička v odpovědi.

Text odpovědi

Text odpovědi obsahuje seznam nepřekrývajících se platných rozsahů seřazených podle zvětšení rozsahu adres. Formát textu odpovědi je následující.

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

Pokud se vymaže celá sada rozsahů souboru, text odpovědi nebude obsahovat žádné rozsahy.

Pokud prevsharesnapshot je zadána, bude odpověď obsahovat pouze stránky, které se liší mezi cílovým snímkem (nebo živým souborem) a předchozím snímkem. Vrácené oblasti zahrnují obě oblasti, které byly aktualizovány nebo které byly vymazány. Formát této odpovědi je následující:

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

Pokud se vymaže celá sada stránek souboru a prevsharesnapshot parametr není zadaný, text odpovědi nebude obsahovat žádné rozsahy.

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Počáteční a koncové posuny bajtů pro každou oblast jsou včetně. Projděte si příklady operací aktualizace rozsahu a operace vymazání rozsahu pro umístění rozsahu. Tyto příklady ukazují, jaké rozsahy se vrátí, když ze souboru napíšete nebo vymažete rozsah 512 bajtů bez zarovnaných bajtů.

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

Počínaje verzí 2020-02-10 můžete volat List Ranges pomocí parametru prevsharesnapshot . Vrátí rozsahy, které se liší mezi živým souborem a snímkem nebo mezi dvěma snímky souboru na snímcích. Pomocí těchto rozdílů v rozsahu můžete načíst přírůstkový snímek souboru. Přírůstkové snímky představují nákladově efektivní způsob zálohování souborů, pokud chcete implementovat vlastní řešení zálohování.

Některé operace se souborem způsobí List Ranges selhání, když se volá za účelem načtení přírůstkového snímku. Služba vrátí:

404 (Nenalezena), pokud voláte soubor, který v jednom ze snímků neexistuje (nebo aktivní, pokud sharesnapshot není zadaný).
409 (Konflikt), pokud voláte u souboru, který byl cílem přepsání kopie po snímku zadaném nástrojem prevsharesnapshot.
409 (Konflikt), pokud zavoláte soubor, který byl odstraněn a znovu vytvořen se stejným názvem a umístěním po pořízení snímku zadaného uživatelem prevsharesnapshot .

Viz také

Operace se soubory