다음을 통해 공유


BlobQueryHeaders interface

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

속성

acceptRanges

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

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'입니다.

copyCompletionTime

이 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 값이 따옴표로 표시됩니다.

isServerEncrypted

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

lastModified

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

leaseDuration

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

leaseState

blob의 임대 상태입니다.

leaseStatus

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

metadata
requestId

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

version

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

속성 세부 정보

acceptRanges

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

acceptRanges?: string

속성 값

string

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

속성 값

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

copyCompletionTime

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

copyCompletionTime?: 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

속성 값

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

isServerEncrypted

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

isServerEncrypted?: boolean

속성 값

boolean

lastModified

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

lastModified?: Date

속성 값

Date

leaseDuration

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

leaseDuration?: LeaseDurationType

속성 값

leaseState

blob의 임대 상태입니다.

leaseState?: LeaseStateType

속성 값

leaseStatus

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

leaseStatus?: LeaseStatusType

속성 값

metadata

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

속성 값

{[propertyName: string]: string}

requestId

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

requestId?: string

속성 값

string

version

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

version?: string

속성 값

string