Ange områdesrubriken för FileREST
Vissa FileREST GET-åtgärder stöder användningen av HTTP-standardrubriken Range
. Många HTTP-klienter, inklusive .NET-klientbiblioteket, begränsar storleken på Range
huvudet till ett 32-bitars heltal, och därför är dess värde begränsat till högst 4 GiB. Eftersom filer kan vara större än 4 GiB i storlek accepterar Azure Files ett anpassat områdeshuvud x-ms-range
för alla åtgärder som tar ett HTTP-huvudRange
.
Vissa HTTP-klienter, inklusive Microsoft Silverlight-biblioteket, begränsar åtkomsten Range
till huvudet helt och hållet. Huvudet x-ms-range
kan också användas för att kringgå dessa begränsningar.
x-ms-range
Om rubriken anges för en begäran använder tjänsten det intervall som anges av x-ms-range
. Annars används det intervall som anges av Range
rubriken.
Format för områdesrubrik
Azure Files accepterar två byteintervall för huvudena Range
och x-ms-range
. Byteintervallet måste följa något av följande format för rubrikerna:
bytes=startByte-
bytes=startByte-endByte
Format 1: bytes=startByte-
Det här intervallet returnerar byte från förskjutningen startByte
till slutet av filen. Om du till exempel vill ange ett intervall som omfattar alla byte efter de första 256 byteen av en fil kan du skicka in någon av följande huvuden:
Range: bytes=255-
x-ms-range: bytes=255-
Rubriken Content-Length
i svaret är lika med antalet byte från förskjutningen till slutet av filen. Om du använder exempelintervallet ovan för en fil med en längd Content-Length
på 1 024 byte är det 756.
Om förskjutningen är giltig och inte överskrider filens totala längd returnerar begäran statuskoden 206 (partiellt innehåll). Om förskjutningen är ogiltig och överskrider filens totala längd returnerar begäran statuskod 416 (Det begärda intervallet är inte uppfyllt).
Format 2: bytes=startByte-endByte
Det här intervallet returnerar byte från förskjutningen startByte
till endByte
. Om du till exempel vill ange ett intervall som omfattar de första 512 byteen av en fil skickar du in någon av följande rubriker:
Range: bytes=0-511
x-ms-range: bytes=0-511
Rubriken Content-Length
i svaret är lika med antalet byte mellan varje förskjutning. Om du använder exempelintervallet ovan för en fil med en längd Content-Length
på 1 024 byte blir det 512.
Om förskjutningen är giltig och inte överskrider filens totala längd returnerar begäran statuskoden 206 (partiellt innehåll). Om förskjutningen är ogiltig och överskrider filens totala längd returnerar begäran statuskod 416 (Det begärda intervallet är inte uppfyllt).