다음을 통해 공유


BlobGetPropertiesHeaders interface

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

속성

acceptRanges

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

accessTier

Premium Storage 계정의 페이지 Blob 계층 또는 Blob Storage LRS 계정의 블록 Blob 계층입니다. 허용되는 프리미엄 페이지 Blob 계층 목록은 를 참조하세요 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Blob Storage LRS 계정의 경우 유효한 값은 핫/쿨/보관입니다.

accessTierChangedOn

개체에서 계층이 변경된 시간입니다. 블록 Blob의 계층이 설정된 경우에만 반환됩니다.

accessTierInferred

Premium Storage 계정의 페이지 Blob에만 해당합니다. 액세스 계층이 Blob에 명시적으로 설정되지 않은 경우 해당 콘텐츠 길이에 따라 계층이 유추되고 이 헤더는 true 값으로 반환됩니다.

archiveStatus

Blob Storage LRS 계정의 경우 유효한 값은 rehydrate-pending-to-hot/rehydrate-pending-to-cool입니다. Blob이 리하이딩되고 있고 완료되지 않은 경우 이 헤더가 반환되어 리하이드 전송이 보류 중임을 나타내고 대상 계층에도 알릴 수 있습니다.

blobCommittedBlockCount

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

blobSequenceNumber

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

blobType

Blob의 형식입니다.

cacheControl

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

clientRequestId

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

contentDisposition

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

contentEncoding

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

contentLanguage

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

contentLength

Blob의 크기(바이트)입니다. 페이지 Blob의 경우 이 헤더는 Blob과 함께 저장된 x-ms-blob-content-length 헤더의 값을 반환합니다.

contentMD5

Blob에 MD5 해시가 있고 이 작업이 전체 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-status가 실패하거나 보류 중인 경우에만 나타납니다. 치명적이거나 치명적이지 않은 마지막 복사 작업 실패의 원인을 설명합니다. 이 Blob이 Blob 복사 작업의 대상이 아니거나 Blob 속성 설정, Blob 배치 또는 블록 목록 배치를 사용하여 Blob 복사 작업이 끝난 후 이 Blob이 수정된 경우에는 이 헤더가 표시되지 않습니다.

createdOn

Blob을 만든 날짜와 시간을 반환합니다.

date

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

destinationSnapshot

blob이 증분 복사 Blob이거나 증분 복사 스냅샷인 경우 x-ms-copy-status가 성공하는 경우 포함됩니다. 이 Blob에 대한 마지막으로 성공한 증분 복사 스냅샷의 스냅샷 시간입니다.

encryptionKeySha256

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

encryptionScope

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

errorCode

오류 코드

etag

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

expiresOn

이 Blob이 만료되는 시간입니다.

immutabilityPolicyExpiresOn

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

immutabilityPolicyMode

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

isCurrentVersion

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

isIncrementalCopy

Blob이 증분 복사 Blob인 경우 포함됩니다.

isSealed

이 Blob이 봉인된 경우

isServerEncrypted

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

lastAccessed

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

lastModified

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

leaseDuration

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

leaseState

blob의 임대 상태입니다.

leaseStatus

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

legalHold

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

metadata
objectReplicationPolicyId

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

objectReplicationRules

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

rehydratePriority

개체가 리하이드 전송 보류 중 상태이면 이 헤더가 리하이드 전송 우선 순위로 반환됩니다.

requestId

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

tagCount

Blob과 연결된 태그 수

version

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

versionId

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

속성 세부 정보

acceptRanges

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

acceptRanges?: string

속성 값

string

accessTier

Premium Storage 계정의 페이지 Blob 계층 또는 Blob Storage LRS 계정의 블록 Blob 계층입니다. 허용되는 프리미엄 페이지 Blob 계층 목록은 를 참조하세요 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Blob Storage LRS 계정의 경우 유효한 값은 핫/쿨/보관입니다.

accessTier?: string

속성 값

string

accessTierChangedOn

개체에서 계층이 변경된 시간입니다. 블록 Blob의 계층이 설정된 경우에만 반환됩니다.

accessTierChangedOn?: Date

속성 값

Date

accessTierInferred

Premium Storage 계정의 페이지 Blob에만 해당합니다. 액세스 계층이 Blob에 명시적으로 설정되지 않은 경우 해당 콘텐츠 길이에 따라 계층이 유추되고 이 헤더는 true 값으로 반환됩니다.

accessTierInferred?: boolean

속성 값

boolean

archiveStatus

Blob Storage LRS 계정의 경우 유효한 값은 rehydrate-pending-to-hot/rehydrate-pending-to-cool입니다. Blob이 리하이딩되고 있고 완료되지 않은 경우 이 헤더가 반환되어 리하이드 전송이 보류 중임을 나타내고 대상 계층에도 알릴 수 있습니다.

archiveStatus?: string

속성 값

string

blobCommittedBlockCount

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

blobCommittedBlockCount?: number

속성 값

number

blobSequenceNumber

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

blobSequenceNumber?: number

속성 값

number

blobType

Blob의 형식입니다.

blobType?: BlobType

속성 값

cacheControl

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

cacheControl?: string

속성 값

string

clientRequestId

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

clientRequestId?: string

속성 값

string

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

Blob의 크기(바이트)입니다. 페이지 Blob의 경우 이 헤더는 Blob과 함께 저장된 x-ms-blob-content-length 헤더의 값을 반환합니다.

contentLength?: number

속성 값

number

contentMD5

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

contentMD5?: Uint8Array

속성 값

Uint8Array

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

속성 값

copyStatusDescription

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

copyStatusDescription?: string

속성 값

string

createdOn

Blob을 만든 날짜와 시간을 반환합니다.

createdOn?: Date

속성 값

Date

date

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

date?: Date

속성 값

Date

destinationSnapshot

blob이 증분 복사 Blob이거나 증분 복사 스냅샷인 경우 x-ms-copy-status가 성공하는 경우 포함됩니다. 이 Blob에 대한 마지막으로 성공한 증분 복사 스냅샷의 스냅샷 시간입니다.

destinationSnapshot?: string

속성 값

string

encryptionKeySha256

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

encryptionKeySha256?: string

속성 값

string

encryptionScope

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

encryptionScope?: string

속성 값

string

errorCode

오류 코드

errorCode?: string

속성 값

string

etag

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

etag?: string

속성 값

string

expiresOn

이 Blob이 만료되는 시간입니다.

expiresOn?: Date

속성 값

Date

immutabilityPolicyExpiresOn

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

immutabilityPolicyExpiresOn?: Date

속성 값

Date

immutabilityPolicyMode

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

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

속성 값

isCurrentVersion

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

isCurrentVersion?: boolean

속성 값

boolean

isIncrementalCopy

Blob이 증분 복사 Blob인 경우 포함됩니다.

isIncrementalCopy?: 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을 수정하는 모든 작업은 수행할 경우 blob의 마지막 수정 시간이 변경됩니다.

lastModified?: Date

속성 값

Date

leaseDuration

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

leaseDuration?: LeaseDurationType

속성 값

leaseState

blob의 임대 상태입니다.

leaseState?: LeaseStateType

속성 값

leaseStatus

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

leaseStatus?: LeaseStatusType

속성 값

legalHold

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

legalHold?: boolean

속성 값

boolean

metadata

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

속성 값

{[propertyName: string]: string}

objectReplicationPolicyId

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

objectReplicationPolicyId?: string

속성 값

string

objectReplicationRules

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

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

속성 값

{[propertyName: string]: string}

rehydratePriority

개체가 리하이드 전송 보류 중 상태이면 이 헤더가 리하이드 전송 우선 순위로 반환됩니다.

rehydratePriority?: RehydratePriority

속성 값

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