BlobDownloadResponseParsed interface

패키지:

@azure/storage-blob

작업에 대한 <xref:BlobClient.download> 응답 데이터를 포함합니다.

Extends

BlobDownloadHeaders & Object

속성

acceptRanges	서비스에서 일부 blob 콘텐츠에 대한 요청이 지원됨을 나타냅니다.
blobBody	브라우저 전용 브라우저 Blob인 응답 본문입니다. 항상 undefined node.js.
blobCommittedBlockCount	Blob에 있는 커밋된 블록의 수입니다. 이 헤더는 추가 Blob에 대해서만 반환됩니다.
blobContentMD5	Blob에 MD5 해시가 있고 요청에 범위 헤더(Range 또는 x-ms-range)가 포함된 경우 이 응답 헤더는 전체 Blob의 MD5 값과 함께 반환됩니다. 이 값은 Content-MD5 헤더에 반환된 값과 같거나 같지 않을 수 있으며, 후자는 요청된 범위에서 계산됩니다.
blobSequenceNumber	페이지 blob에 대한 현재 시퀀스 번호입니다. 이 헤더는 블록 Blob 또는 추가 Blob에 대해 반환되지 않습니다.
blobType	Blob의 형식입니다.
cacheControl	이전에 blob에 대해 지정된 경우 이 헤더가 반환됩니다.
clientRequestId	클라이언트 요청 ID 헤더가 요청에 전송되는 경우 이 헤더는 동일한 값을 가진 응답에 표시됩니다.
contentCrc64	요청이 지정된 범위를 읽는 것이고 x-ms-range-get-content-crc64가 true로 설정된 경우 범위 크기가 4MB보다 작거나 같은 경우 요청은 범위에 대한 crc64를 반환합니다. x-ms-range-get-content-crc64 & x-ms-range-get-content-md5가 동일한 요청에 지정된 경우 400(잘못된 요청)으로 실패합니다.
contentDisposition	이 헤더는 'x-ms-blob-content-disposition' 헤더에 대해 지정된 값을 반환합니다. Content-Disposition 응답 헤더 필드는 응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 추가 메타데이터를 연결하는 데 사용할 수도 있습니다. 예를 들어 첨부 파일로 설정하면 사용자 에이전트가 응답을 표시하지 않고 대신 지정된 Blob 이름이 아닌 파일 이름이 있는 다른 이름으로 저장 대화 상자를 표시합니다.
contentEncoding	이 헤더는 Content-Encoding 요청 헤더에 대해 지정된 값을 반환합니다.
contentLanguage	이 헤더는 Content-Language 요청 헤더에 대해 지정된 값을 반환합니다.
contentLength	응답 본문에 제공된 바이트 수입니다.
contentMD5	Blob에 MD5 해시가 있고 이 작업이 전체 Blob을 읽는 경우 클라이언트가 메시지 콘텐츠 무결성을 검사 수 있도록 이 응답 헤더가 반환됩니다.
contentRange	클라이언트가 'Range' 요청 헤더를 설정하여 Blob의 하위 집합을 요청한 경우에 반환되는 바이트 범위를 나타냅니다.
contentType	응답 본문의 미디어 형식입니다. Blob 다운로드의 경우 'application/octet-stream'입니다.
copyCompletedOn	이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업의 결론 시간입니다. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다. 복사본이 보류 중인 경우, 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.
copyId	이 복사 작업의 문자열 식별자입니다. Blob 속성 가져오기와 함께 를 사용하여 이 복사 작업의 상태 검사 Blob 복사 중단에 전달하여 보류 중인 복사본을 중단합니다.
copyProgress	이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업에서 복사된 바이트 수와 원본의 총 바이트를 포함합니다. 복사된 0과 Content-Length 바이트 사이를 표시할 수 있습니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.
copySource	이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업에 사용된 원본 Blob 또는 파일을 지정하는 최대 2KB의 URL입니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.
copyStatus	x-ms-copy-id로 식별된 복사 작업의 상태입니다.
copyStatusDescription	x-ms-copy-상태 실패하거나 보류 중인 경우에만 나타납니다. 치명적이거나 치명적이지 않은 마지막 복사 작업 실패의 원인을 설명합니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.
date	응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값
encryptionKeySha256	Blob을 암호화하는 데 사용되는 암호화 키의 SHA-256 해시입니다. 이 헤더는 Blob이 고객이 제공한 키로 암호화된 경우에만 반환됩니다.
encryptionScope	Blob 콘텐츠 및 애플리케이션 메타데이터를 암호화하는 데 사용되는 암호화 scope 이름을 반환합니다. 이 헤더의 부재는 기본 계정 암호화 scope 사용을 의미합니다.
errorCode	오류 코드
etag	ETag에는 조건에 따라 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다. 요청 버전이 2011-08-18 이상이면 ETag 값이 따옴표로 표시됩니다.
immutabilityPolicyExpiresOn	Blob 불변성 정책이 만료되는 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.
immutabilityPolicyMode	불변성 정책 모드를 나타냅니다.
isCurrentVersion	이 헤더의 값은 이 Blob의 버전이 현재 버전인지 여부를 나타냅니다. x-ms-version-id 헤더도 참조하세요.
isSealed	이 Blob이 봉인된 경우
isServerEncrypted	Blob 데이터 및 애플리케이션 메타데이터가 지정된 알고리즘을 사용하여 완전히 암호화된 경우 이 헤더의 값은 true로 설정됩니다. 그렇지 않으면 값이 false로 설정됩니다(Blob이 암호화되지 않은 경우 또는 Blob/애플리케이션 메타데이터의 일부만 암호화된 경우).
lastAccessed	서비스에서 생성된 UTC 날짜/시간 값으로, Blob을 마지막으로 읽거나 쓴 시간을 나타냅니다.
lastModified	컨테이너가 마지막으로 수정된 날짜 및 시간을 반환합니다. blob의 메타데이터 또는 속성에 대한 업데이트를 포함하여 Blob을 수정하는 모든 작업은 수행할 경우 blob의 마지막 수정 시간이 변경됩니다.
leaseDuration	blob가 임대된 경우 해당 임대가 무한 또는 고정된 기간인지 여부를 지정합니다.
leaseState	blob의 임대 상태입니다.
leaseStatus	blob의 현재 임대 상태입니다.
legalHold	Blob에 법적 보존이 있는지를 나타냅니다.
metadata
objectReplicationDestinationPolicyId	대상 Blob의 개체 복제 정책 ID입니다.
objectReplicationPolicyId	선택 사항입니다. 스토리지 컨테이너 및 복제의 대상 Blob에 대해 개체 복제를 사용하도록 설정한 경우에만 유효합니다.
objectReplicationRules	선택 사항입니다. 스토리지 컨테이너 및 복제의 원본 Blob에 대해 개체 복제를 사용하도록 설정한 경우에만 유효합니다. 이 헤더를 검색할 때 정책 ID 및 규칙 ID(예: x-ms-or-policyid_ruleid)가 있는 헤더를 반환하고 값은 복제의 상태(예: 완료, 실패)됩니다.
objectReplicationSourceProperties	구문 분석된 개체 복제 정책 ID, 규칙 ID 및 원본 Blob의 상태.
readableStreamBody	NODEJS만 node.js 읽기 가능한 스트림인 응답 본문입니다. 항상 undefined 브라우저에 있습니다.
requestId	이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.
tagCount	Blob과 연결된 태그 수
version	요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.
versionId	Blob을 고유하게 식별하는 서비스에서 반환되는 DateTime 값입니다. 이 헤더의 값은 Blob 버전을 나타내며, 이 버전의 Blob에 액세스하기 위한 후속 요청에 사용될 수 있습니다.

속성 세부 정보

acceptRanges

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

acceptRanges?: string

속성 값

string

blobBody

브라우저 전용 브라우저 Blob인 응답 본문입니다. 항상 undefined node.js.

blobBody?: Promise<Blob>

속성 값

Promise<Blob>

blobCommittedBlockCount

Blob에 있는 커밋된 블록의 수입니다. 이 헤더는 추가 Blob에 대해서만 반환됩니다.

blobCommittedBlockCount?: number

속성 값

number

blobContentMD5

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

blobContentMD5?: Uint8Array

속성 값

Uint8Array

blobSequenceNumber

페이지 blob에 대한 현재 시퀀스 번호입니다. 이 헤더는 블록 Blob 또는 추가 Blob에 대해 반환되지 않습니다.

blobSequenceNumber?: number

속성 값

number

blobType

Blob의 형식입니다.

blobType?: BlobType

속성 값

BlobType

cacheControl

이전에 blob에 대해 지정된 경우 이 헤더가 반환됩니다.

cacheControl?: string

속성 값

string

clientRequestId

클라이언트 요청 ID 헤더가 요청에 전송되는 경우 이 헤더는 동일한 값을 가진 응답에 표시됩니다.

clientRequestId?: string

속성 값

string

contentCrc64

요청이 지정된 범위를 읽는 것이고 x-ms-range-get-content-crc64가 true로 설정된 경우 범위 크기가 4MB보다 작거나 같은 경우 요청은 범위에 대한 crc64를 반환합니다. x-ms-range-get-content-crc64 & x-ms-range-get-content-md5가 동일한 요청에 지정된 경우 400(잘못된 요청)으로 실패합니다.

contentCrc64?: Uint8Array

속성 값

Uint8Array

contentDisposition

이 헤더는 'x-ms-blob-content-disposition' 헤더에 대해 지정된 값을 반환합니다. Content-Disposition 응답 헤더 필드는 응답 페이로드를 처리하는 방법에 대한 추가 정보를 전달하며 추가 메타데이터를 연결하는 데 사용할 수도 있습니다. 예를 들어 첨부 파일로 설정하면 사용자 에이전트가 응답을 표시하지 않고 대신 지정된 Blob 이름이 아닌 파일 이름이 있는 다른 이름으로 저장 대화 상자를 표시합니다.

contentDisposition?: string

속성 값

string

contentEncoding

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

contentEncoding?: string

속성 값

string

contentLanguage

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

contentLanguage?: string

속성 값

string

contentLength

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

contentLength?: number

속성 값

number

contentMD5

Blob에 MD5 해시가 있고 이 작업이 전체 Blob을 읽는 경우 클라이언트가 메시지 콘텐츠 무결성을 검사 수 있도록 이 응답 헤더가 반환됩니다.

contentMD5?: Uint8Array

속성 값

Uint8Array

contentRange

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

contentRange?: string

속성 값

string

contentType

응답 본문의 미디어 형식입니다. Blob 다운로드의 경우 'application/octet-stream'입니다.

contentType?: string

속성 값

string

copyCompletedOn

이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업의 결론 시간입니다. 이 값은 완료, 중단 또는 실패한 복사 시도의 시간을 지정할 수 있습니다. 복사본이 보류 중인 경우, 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.

copyCompletedOn?: Date

속성 값

Date

copyId

이 복사 작업의 문자열 식별자입니다. Blob 속성 가져오기와 함께 를 사용하여 이 복사 작업의 상태 검사 Blob 복사 중단에 전달하여 보류 중인 복사본을 중단합니다.

copyId?: string

속성 값

string

copyProgress

이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업에서 복사된 바이트 수와 원본의 총 바이트를 포함합니다. 복사된 0과 Content-Length 바이트 사이를 표시할 수 있습니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.

copyProgress?: string

속성 값

string

copySource

이 Blob이 대상 Blob인 마지막으로 시도한 Blob 복사 작업에 사용된 원본 Blob 또는 파일을 지정하는 최대 2KB의 URL입니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.

copySource?: string

속성 값

string

copyStatus

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

copyStatus?: CopyStatusType

속성 값

CopyStatusType

copyStatusDescription

x-ms-copy-상태 실패하거나 보류 중인 경우에만 나타납니다. 치명적이거나 치명적이지 않은 마지막 복사 작업 실패의 원인을 설명합니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.

copyStatusDescription?: string

속성 값

string

date

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

date?: Date

속성 값

Date

encryptionKeySha256

Blob을 암호화하는 데 사용되는 암호화 키의 SHA-256 해시입니다. 이 헤더는 Blob이 고객이 제공한 키로 암호화된 경우에만 반환됩니다.

encryptionKeySha256?: string

속성 값

string

encryptionScope

Blob 콘텐츠 및 애플리케이션 메타데이터를 암호화하는 데 사용되는 암호화 scope 이름을 반환합니다. 이 헤더의 부재는 기본 계정 암호화 scope 사용을 의미합니다.

encryptionScope?: string

속성 값

string

errorCode

오류 코드

errorCode?: string

속성 값

string

etag

ETag에는 조건에 따라 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다. 요청 버전이 2011-08-18 이상이면 ETag 값이 따옴표로 표시됩니다.

etag?: string

속성 값

string

immutabilityPolicyExpiresOn

Blob 불변성 정책이 만료되는 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

immutabilityPolicyExpiresOn?: Date

속성 값

Date

immutabilityPolicyMode

불변성 정책 모드를 나타냅니다.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

속성 값

BlobImmutabilityPolicyMode

isCurrentVersion

이 헤더의 값은 이 Blob의 버전이 현재 버전인지 여부를 나타냅니다. x-ms-version-id 헤더도 참조하세요.

isCurrentVersion?: boolean

속성 값

boolean

isSealed

이 Blob이 봉인된 경우

isSealed?: boolean

속성 값

boolean

isServerEncrypted

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

isServerEncrypted?: boolean

속성 값

boolean

lastAccessed

서비스에서 생성된 UTC 날짜/시간 값으로, Blob을 마지막으로 읽거나 쓴 시간을 나타냅니다.

lastAccessed?: Date

속성 값

Date

lastModified

컨테이너가 마지막으로 수정된 날짜 및 시간을 반환합니다. blob의 메타데이터 또는 속성에 대한 업데이트를 포함하여 Blob을 수정하는 모든 작업은 수행할 경우 blob의 마지막 수정 시간이 변경됩니다.

lastModified?: Date

속성 값

Date

leaseDuration

blob가 임대된 경우 해당 임대가 무한 또는 고정된 기간인지 여부를 지정합니다.

leaseDuration?: LeaseDurationType

속성 값

LeaseDurationType

leaseState

blob의 임대 상태입니다.

leaseState?: LeaseStateType

속성 값

LeaseStateType

leaseStatus

blob의 현재 임대 상태입니다.

leaseStatus?: LeaseStatusType

속성 값

LeaseStatusType

legalHold

Blob에 법적 보존이 있는지를 나타냅니다.

legalHold?: boolean

속성 값

boolean

metadata

metadata?: [key: string]: string

속성 값

[key: string]: string

objectReplicationDestinationPolicyId

대상 Blob의 개체 복제 정책 ID입니다.

objectReplicationDestinationPolicyId?: string

속성 값

string

objectReplicationPolicyId

선택 사항입니다. 스토리지 컨테이너 및 복제의 대상 Blob에 대해 개체 복제를 사용하도록 설정한 경우에만 유효합니다.

objectReplicationPolicyId?: string

속성 값

string

objectReplicationRules

선택 사항입니다. 스토리지 컨테이너 및 복제의 원본 Blob에 대해 개체 복제를 사용하도록 설정한 경우에만 유효합니다. 이 헤더를 검색할 때 정책 ID 및 규칙 ID(예: x-ms-or-policyid_ruleid)가 있는 헤더를 반환하고 값은 복제의 상태(예: 완료, 실패)됩니다.

objectReplicationRules?: [key: string]: string

속성 값

[key: string]: string

objectReplicationSourceProperties

구문 분석된 개체 복제 정책 ID, 규칙 ID 및 원본 Blob의 상태.

objectReplicationSourceProperties?: ObjectReplicationPolicy[]

속성 값

ObjectReplicationPolicy[]

readableStreamBody

NODEJS만 node.js 읽기 가능한 스트림인 응답 본문입니다. 항상 undefined 브라우저에 있습니다.

readableStreamBody?: ReadableStream

속성 값

ReadableStream

requestId

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

requestId?: string

속성 값

string

tagCount

Blob과 연결된 태그 수

tagCount?: number

속성 값

number

version

요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.

version?: string

속성 값

string

versionId

Blob을 고유하게 식별하는 서비스에서 반환되는 DateTime 값입니다. 이 헤더의 값은 Blob 버전을 나타내며, 이 버전의 Blob에 액세스하기 위한 후속 요청에 사용될 수 있습니다.

versionId?: string

속성 값

string