Dela via


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 Ja
NFS Ja

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
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist HTTP/1.1
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>&comp=rangelist HTTP/1.1
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rangelist&snapshot=<DateTime>&prevsharesnapshot=<DateTime> HTTP/1.1
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.

Se även

åtgärder på