Listintervall
Åtgärden List Ranges
returnerar listan över giltiga intervall för en fil. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.
Protokolltillgänglighet
Aktiverat filresursprotokoll | Tillgänglig |
---|---|
SMB |
![]() |
NFS |
![]() |
Begäran
Den List Ranges
begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
Metod | Begärande-URI | HTTP-version |
---|---|---|
FÅ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist |
HTTP/1.1 |
FÅ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist |
HTTP/1.1 |
FÅ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime> |
HTTP/1.1 |
FÅ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&prevsharesnapshot=<DateTime> |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:
Sökvägskomponent | Beskrivning |
---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfri. Sökvägen till den överordnade katalogen. |
myfile |
Namnet på filen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namngivnings- och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar på begärande-URI:n.
Parameter | Beskrivning |
---|---|
sharesnapshot |
Valfri. Version 2017-04-17 och senare. Parametern sharesnapshot är en ogenomskinlig DateTime värde som, när den finns, anger resursögonblicksbilden för att fråga efter filen. |
timeout |
Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files-åtgärder. |
prevsharesnapshot |
Valfritt i version 2020-02-10 och senare. Parametern prevsharesnapshot är ett ogenomskinlig DateTime värde som, när den finns, anger den tidigare ögonblicksbilden.När både den här parametern och sharesnapshot finns innehåller svaret endast sidintervall som har ändrats mellan de två ögonblicksbilderna. När endast prevsharesnapshot finns innehåller svaret endast sidintervall som har ändrats mellan den här ögonblicksbilden och den aktiva resursen.Ändrade sidor innehåller både uppdaterade och rensade sidor. |
Begärandehuvuden
De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabeller:
Vanliga begärandehuvuden
Begärandehuvud | Beskrivning |
---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
Range |
Valfri. Anger det intervall med byte som du vill visa intervall för, inklusive. Om det utelämnas returneras alla intervall för filen. |
x-ms-range |
Valfri. Anger det intervall med byte som du vill visa intervall för, inklusive. Om både Range - och x-ms-range -huvuden anges använder tjänsten värdet x-ms-range . Mer information finns i Ange intervallrubriken för Azure Files-åtgärder. |
x-ms-lease-id:<ID> |
Valfri. Version 2019-02-02 och senare. Om rubriken anges utförs åtgärden endast om filens lån för närvarande är aktivt och låne-ID:t som anges i begäran matchar filens. Annars misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades). Det här huvudet ignoreras om filen finns på en filresurs med NFS-protokollet aktiverat, vilket inte stöder fillån. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files-. |
x-ms-file-request-intent |
Krävs om Authorization rubrik anger en OAuth-token. Acceptabelt värde är backup . Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization -huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
x-ms-file-support-rename: { <Boolean> } |
Valfri. Stöds i version 2024-05-04 och senare. Det här huvudet tillåts endast när prevsharesnapshot frågeparameter finns. Det booleska värdet avgör om de ändrade intervallen för en fil ska visas när filens plats i den föregående ögonblicksbilden skiljer sig från platsen i begärande-URI:n, som ett resultat av byt namn på eller flyttåtgärder. Om värdet är sant returneras de giltiga ändrade intervallen för filen. Om värdet är falskt resulterar åtgärden i ett fel med svaret 409 (konflikt). Standardvärdet är falskt. |
Endast SMB-begärandehuvuden
Ingen.
Endast NFS-begärandehuvuden
Ingen.
Begärandetext
Ingen.
Svar
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext i XML-format.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabeller. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga svarshuvuden
Svarsrubrik | Beskrivning |
---|---|
Last-Modified |
Datum/tid då filen senast ändrades. Alla åtgärder som ändrar filen, inklusive en uppdatering av filens metadata eller egenskaper, ändrar filens senaste ändringstid. |
ETag |
ETag innehåller ett värde som representerar filens version med citattecken. |
x-ms-content-length |
Storleken på filen i byte. När prevsharesnapshot finns beskriver värdet storleken på filen i sharesnapshot (om sharesnapshot frågeparameter finns). I annat fall beskrivs storleken på livefilen. |
x-ms-request-id |
Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsökning av API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet. |
x-ms-client-request-id |
Du kan använda den här rubriken för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id -huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om x-ms-client-request-id -huvudet inte finns i begäran visas inte det här huvudet i svaret. |
Endast SMB-svarshuvuden
Ingen.
Endast NFS-svarshuvuden
Ingen.
Svarstext
Svarstexten innehåller en lista över giltiga intervall som inte överlappar varandra, sorterade efter att adressintervallet har ökat. Formatet för svarstexten är följande.
<?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>
Om hela filens uppsättning intervall har rensats kommer svarstexten inte att innehålla några intervall.
Om prevsharesnapshot
anges innehåller svaret endast de sidor som skiljer sig mellan målögonblicksbilden (eller livefilen) och den tidigare ögonblicksbilden. De intervall som returneras inkluderar båda intervallen som har uppdaterats eller som rensats. Formatet för det här svaret är följande:
<?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>
Om hela filens uppsättning sidor har rensats och parametern prevsharesnapshot
inte har angetts innehåller svarstexten inga intervall.
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
Start- och slutbyteförskjutningarna för varje intervall är inkluderande. Se exemplen Range Update Operations och Range Clear Operations för Put Range. De här exemplen visar vilka intervall som returneras om du skriver eller rensar ett intervall på 512 ojusterade byte från filen.
I en mycket fragmenterad fil med ett stort antal skrivningar kan en List Ranges
begäran misslyckas på grund av en intern tidsgräns för servern. Program som hämtar intervall för en fil med ett stort antal skrivåtgärder bör hämta en delmängd av intervall i taget.
Från och med version 2020-02-10 kan du anropa List Ranges
med en prevsharesnapshot
parameter. Detta returnerar de intervall som skiljer sig mellan den aktiva filen och en ögonblicksbild, eller mellan två ögonblicksbilder av filen på ögonblicksbilder. Genom att använda dessa intervallskillnader kan du hämta en inkrementell ögonblicksbild av en fil. Inkrementella ögonblicksbilder är ett kostnadseffektivt sätt att säkerhetskopiera filer om du vill implementera din egen säkerhetskopieringslösning.
Vissa åtgärder i en fil gör att List Ranges
misslyckas när den anropas för att hämta en inkrementell ögonblicksbild. Tjänsten returnerar:
- 404 (hittades inte) om du anropar en fil som inte finns i någon av ögonblicksbilderna (eller live, om
sharesnapshot
inte har angetts). - 409 (konflikt) om du anropar en fil som var målet för en överskrivning Kopiera efter ögonblicksbilden, som anges av
prevsharesnapshot
. - 409 (konflikt) om du anropar en fil som har tagits bort och återskapats med samma namn och plats, efter att ögonblicksbilden som angetts av
prevsharesnapshot
har tagits.