FileREST에 대한 범위 헤더 지정
일부 FileREST GET 작업은 표준 HTTP Range 헤더 사용을 지원합니다. .NET 클라이언트 라이브러리를 비롯한 많은 HTTP 클라이언트는 헤더 크기를 Range 32비트 정수로 제한하므로 해당 값은 최대 4GiB로 제한됩니다. 파일 크기가 4GiB보다 클 수 있으므로 Azure Files HTTP Range 헤더를 사용하는 모든 작업에 대해 사용자 지정 범위 헤더 x-ms-range 를 허용합니다.
Microsoft Silverlight 라이브러리를 포함한 일부 HTTP 클라이언트에서는 Range 헤더에 대한 액세스가 모두 제한됩니다.
x-ms-range 헤더는 이러한 제한을 우회하는 데 사용될 수 있습니다.
x-ms-range 헤더가 요청에 지정된 경우, 서비스에서 x-ms-range로 지정된 범위가 사용되고, 그렇지 않으면 Range 헤더로 지정된 범위가 사용됩니다.
범위 헤더 형식
Azure Files 및 x-ms-range 헤더에 대해 Range 두 개의 바이트 범위를 허용합니다. 바이트 범위는 다음 헤더 형식 중 하나를 따라야 합니다.
bytes=startByte-bytes=startByte-endByte
형식 1: bytes=startByte-
이 범위는 오프셋 startByte부터 파일 끝까지의 바이트를 반환합니다. 예를 들어, 파일의 처음 256바이트 이후의 모든 바이트를 포함하는 범위를 지정하려면 다음 헤더 중 하나를 전달할 수 있습니다.
Range: bytes=255-x-ms-range: bytes=255-
응답의 Content-Length 헤더는 오프셋부터 파일 끝까지의 바이트 수와 동일합니다. 위의 Content-Length 예제 범위를 길이가 1,024바이트인 파일에 사용하면 756이 됩니다.
오프셋이 유효하고 파일의 총 길이를 초과하지 않으면 이 요청에서는 상태 코드 206(일부 내용)이 반환됩니다. 오프셋이 잘못되었고 파일의 총 길이를 초과할 경우에는 이 요청에서 상태 코드 416(요청한 범위가 충분하지 않음)이 반환됩니다.
형식 2: bytes=startByte-endByte
이 범위는 오프셋 startByte부터 endByte까지의 바이트를 반환합니다. 예를 들어, 파일의 처음 512바이트를 포함하는 범위를 지정하려면 다음 헤더 중 하나를 전달합니다.
Range: bytes=0-511x-ms-range: bytes=0-511
응답의 Content-Length 헤더는 각 오프셋 사이의 바이트 수와 동일합니다. 길이가 1,024바이트인 파일에 대해 위의 예제 범위를 사용할 경우 Content-Length는 512가 됩니다.
오프셋이 유효하고 파일의 총 길이를 초과하지 않으면 요청은 상태 코드 206(부분 콘텐츠)을 반환합니다. 오프셋이 잘못되었고 파일의 총 길이를 초과할 경우에는 이 요청에서 상태 코드 416(요청한 범위가 충분하지 않음)이 반환됩니다.