Dela via


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).

Se även

Azure Files begrepp