다음을 통해 공유


FileDownloadHeaders interface

File_download 작업에 대한 헤더를 정의합니다.

속성

acceptRanges

서비스에서 일부 파일 콘텐츠에 대한 요청이 지원됨을 나타냅니다.

cacheControl

이전에 파일에 대해 지정한 경우 반환됩니다.

contentDisposition

'x-ms-content-disposition' 헤더에 대해 지정된 값을 반환하고 응답을 처리하는 방법을 지정합니다.

contentEncoding

Content-Encoding 요청 헤더에 대해 지정된 값을 반환합니다.

contentLanguage

Content-Language 요청 헤더에 대해 지정된 값을 반환합니다.

contentLength

응답 본문에 제공된 바이트 수입니다.

contentMD5

파일에 MD5 해시가 포함되고 요청이 전체 파일을 읽는 작업인 경우, 클라이언트가 메시지 콘텐츠 무결성을 확인할 수 있도록 이 응답 헤더가 반환됩니다. 요청이 지정된 범위를 읽는 것이고 'x-ms-range-get-content-md5'가 true로 설정된 경우 범위 크기가 4MB보다 작거나 같은 경우 요청은 범위에 대한 MD5 해시를 반환합니다. 이러한 조건 집합 중 어느 것도 true가 아니면 'Content-MD5' 헤더에 대한 값이 반환되지 않습니다.

contentRange

클라이언트가 범위 요청 헤더를 설정하여 파일의 하위 집합을 요청한 경우 반환되는 바이트 범위를 나타냅니다.

contentType

파일에 대해 지정된 콘텐츠 형식입니다. 기본 콘텐츠 형식은 'application/octet-stream'입니다.

copyCompletedOn

이 파일이 대상 파일인 마지막으로 시도한 파일 복사 작업의 결론 시간입니다. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다.

copyId

이 파일이 대상 파일인 마지막으로 시도한 파일 복사 작업의 문자열 식별자입니다.

copyProgress

복사한 바이트 수와 이 파일이 대상 파일인 마지막 파일 복사 작업의 원본에 있는 총 바이트를 포함합니다. 복사된 0과 Content-Length 바이트 사이를 표시할 수 있습니다.

copySource

이 파일이 대상 파일이었던 마지막 시도 파일 복사 작업에 사용된 원본 파일을 지정하는 최대 2KB의 URL입니다.

copyStatus

'x-ms-copy-id'로 식별된 복사 작업의 상태입니다.

copyStatusDescription

x-ms-copy-status가 실패하거나 보류 중인 경우에만 나타납니다. 치명적이거나 치명적이지 않은 복사 작업 실패의 원인을 설명합니다.

date

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

errorCode

오류 코드

etag

ETag에는 조건부로 작업을 수행하는 데 사용할 수 있는 값(따옴표)이 포함되어 있습니다.

fileAttributes

파일에 대해 설정된 특성입니다.

fileChangeOn

파일의 시간을 변경합니다.

fileContentMD5

파일에 MD5 해시가 있고 요청에 범위 헤더(Range 또는 x-ms-range)가 포함된 경우 이 응답 헤더는 전체 파일의 MD5 값과 함께 반환됩니다. 이 값은 Content-MD5 헤더에 반환된 값과 같거나 같지 않을 수 있으며, 후자는 요청된 범위에서 계산됩니다.

fileCreatedOn

파일의 생성 시간입니다.

fileId

파일의 fileId입니다.

fileLastWriteOn

파일의 마지막 쓰기 시간입니다.

fileParentId

파일의 부모 fileId입니다.

filePermissionKey

파일에 대한 권한 집합의 키입니다.

isServerEncrypted

파일 데이터 및 애플리케이션 메타데이터가 지정된 알고리즘을 사용하여 완전히 암호화된 경우 이 헤더의 값은 true로 설정됩니다. 그렇지 않으면 값이 false로 설정됩니다(파일이 암호화되지 않은 경우 또는 파일/애플리케이션 메타데이터의 일부만 암호화된 경우).

lastModified

파일이 마지막으로 수정된 날짜와 시간을 반환합니다. 파일 또는 해당 속성을 수정하는 모든 작업은 마지막으로 수정된 시간을 업데이트합니다.

leaseDuration

파일이 임대되면 임대 기간이 무한인지 또는 고정된 기간인지를 지정합니다.

leaseState

파일의 임대 상태입니다.

leaseStatus

파일의 현재 임대 상태입니다.

metadata

사용자 정의 메타데이터로 이 파일과 연결된 이름-값 쌍의 집합입니다.

requestId

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.

version

요청을 실행하는 데 사용되는 파일 서비스의 버전을 나타냅니다.

속성 세부 정보

acceptRanges

서비스에서 일부 파일 콘텐츠에 대한 요청이 지원됨을 나타냅니다.

acceptRanges?: string

속성 값

string

cacheControl

이전에 파일에 대해 지정한 경우 반환됩니다.

cacheControl?: string

속성 값

string

contentDisposition

'x-ms-content-disposition' 헤더에 대해 지정된 값을 반환하고 응답을 처리하는 방법을 지정합니다.

contentDisposition?: string

속성 값

string

contentEncoding

Content-Encoding 요청 헤더에 대해 지정된 값을 반환합니다.

contentEncoding?: string

속성 값

string

contentLanguage

Content-Language 요청 헤더에 대해 지정된 값을 반환합니다.

contentLanguage?: string

속성 값

string

contentLength

응답 본문에 제공된 바이트 수입니다.

contentLength?: number

속성 값

number

contentMD5

파일에 MD5 해시가 포함되고 요청이 전체 파일을 읽는 작업인 경우, 클라이언트가 메시지 콘텐츠 무결성을 확인할 수 있도록 이 응답 헤더가 반환됩니다. 요청이 지정된 범위를 읽는 것이고 'x-ms-range-get-content-md5'가 true로 설정된 경우 범위 크기가 4MB보다 작거나 같은 경우 요청은 범위에 대한 MD5 해시를 반환합니다. 이러한 조건 집합 중 어느 것도 true가 아니면 'Content-MD5' 헤더에 대한 값이 반환되지 않습니다.

contentMD5?: Uint8Array

속성 값

Uint8Array

contentRange

클라이언트가 범위 요청 헤더를 설정하여 파일의 하위 집합을 요청한 경우 반환되는 바이트 범위를 나타냅니다.

contentRange?: string

속성 값

string

contentType

파일에 대해 지정된 콘텐츠 형식입니다. 기본 콘텐츠 형식은 'application/octet-stream'입니다.

contentType?: string

속성 값

string

copyCompletedOn

이 파일이 대상 파일인 마지막으로 시도한 파일 복사 작업의 결론 시간입니다. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다.

copyCompletedOn?: Date

속성 값

Date

copyId

이 파일이 대상 파일인 마지막으로 시도한 파일 복사 작업의 문자열 식별자입니다.

copyId?: string

속성 값

string

copyProgress

복사한 바이트 수와 이 파일이 대상 파일인 마지막 파일 복사 작업의 원본에 있는 총 바이트를 포함합니다. 복사된 0과 Content-Length 바이트 사이를 표시할 수 있습니다.

copyProgress?: string

속성 값

string

copySource

이 파일이 대상 파일이었던 마지막 시도 파일 복사 작업에 사용된 원본 파일을 지정하는 최대 2KB의 URL입니다.

copySource?: string

속성 값

string

copyStatus

'x-ms-copy-id'로 식별된 복사 작업의 상태입니다.

copyStatus?: CopyStatusType

속성 값

copyStatusDescription

x-ms-copy-status가 실패하거나 보류 중인 경우에만 나타납니다. 치명적이거나 치명적이지 않은 복사 작업 실패의 원인을 설명합니다.

copyStatusDescription?: string

속성 값

string

date

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

date?: Date

속성 값

Date

errorCode

오류 코드

errorCode?: string

속성 값

string

etag

ETag에는 조건부로 작업을 수행하는 데 사용할 수 있는 값(따옴표)이 포함되어 있습니다.

etag?: string

속성 값

string

fileAttributes

파일에 대해 설정된 특성입니다.

fileAttributes?: string

속성 값

string

fileChangeOn

파일의 시간을 변경합니다.

fileChangeOn?: Date

속성 값

Date

fileContentMD5

파일에 MD5 해시가 있고 요청에 범위 헤더(Range 또는 x-ms-range)가 포함된 경우 이 응답 헤더는 전체 파일의 MD5 값과 함께 반환됩니다. 이 값은 Content-MD5 헤더에 반환된 값과 같거나 같지 않을 수 있으며, 후자는 요청된 범위에서 계산됩니다.

fileContentMD5?: Uint8Array

속성 값

Uint8Array

fileCreatedOn

파일의 생성 시간입니다.

fileCreatedOn?: Date

속성 값

Date

fileId

파일의 fileId입니다.

fileId?: string

속성 값

string

fileLastWriteOn

파일의 마지막 쓰기 시간입니다.

fileLastWriteOn?: Date

속성 값

Date

fileParentId

파일의 부모 fileId입니다.

fileParentId?: string

속성 값

string

filePermissionKey

파일에 대한 권한 집합의 키입니다.

filePermissionKey?: string

속성 값

string

isServerEncrypted

파일 데이터 및 애플리케이션 메타데이터가 지정된 알고리즘을 사용하여 완전히 암호화된 경우 이 헤더의 값은 true로 설정됩니다. 그렇지 않으면 값이 false로 설정됩니다(파일이 암호화되지 않은 경우 또는 파일/애플리케이션 메타데이터의 일부만 암호화된 경우).

isServerEncrypted?: boolean

속성 값

boolean

lastModified

파일이 마지막으로 수정된 날짜와 시간을 반환합니다. 파일 또는 해당 속성을 수정하는 모든 작업은 마지막으로 수정된 시간을 업데이트합니다.

lastModified?: Date

속성 값

Date

leaseDuration

파일이 임대되면 임대 기간이 무한인지 또는 고정된 기간인지를 지정합니다.

leaseDuration?: LeaseDurationType

속성 값

leaseState

파일의 임대 상태입니다.

leaseState?: LeaseStateType

속성 값

leaseStatus

파일의 현재 임대 상태입니다.

leaseStatus?: LeaseStatusType

속성 값

metadata

사용자 정의 메타데이터로 이 파일과 연결된 이름-값 쌍의 집합입니다.

metadata?: {[propertyName: string]: string}

속성 값

{[propertyName: string]: string}

requestId

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.

requestId?: string

속성 값

string

version

요청을 실행하는 데 사용되는 파일 서비스의 버전을 나타냅니다.

version?: string

속성 값

string