BlobDownloadResponseParsed interface

Package:

@azure/storage-blob

Contains response data for the download operation.

Extends

BlobDownloadResponseModel

Properties

objectReplicationDestinationPolicyId	Object Replication Policy Id of the destination blob.
objectReplicationSourceProperties	Parsed Object Replication Policy Id, Rule Id(s) and status of the source blob.

Inherited Properties

acceptRanges	Indicates that the service supports requests for partial blob content.
blobBody	BROWSER ONLY The response body as a browser Blob. Always undefined in node.js.
blobCommittedBlockCount	The number of committed blocks present in the blob. This header is returned only for append blobs.
blobContentMD5	If the blob has a MD5 hash, and if request contains range header (Range or x-ms-range), this response header is returned with the value of the whole blob's MD5 value. This value may or may not be equal to the value returned in Content-MD5 header, with the latter calculated from the requested range
blobSequenceNumber	The current sequence number for a page blob. This header is not returned for block blobs or append blobs
blobType	The blob's type.
cacheControl	This header is returned if it was previously specified for the blob.
clientRequestId	If a client request id header is sent in the request, this header will be present in the response with the same value.
contentCrc64	If the request is to read a specified range and the x-ms-range-get-content-crc64 is set to true, then the request returns a crc64 for the range, as long as the range size is less than or equal to 4 MB. If both x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is specified in the same request, it will fail with 400(Bad Request).
contentDisposition	This header returns the value that was specified for the 'x-ms-blob-content-disposition' header. The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the blob name specified.
contentEncoding	This header returns the value that was specified for the Content-Encoding request header
contentLanguage	This header returns the value that was specified for the Content-Language request header.
contentLength	The number of bytes present in the response body.
contentMD5	If the blob has an MD5 hash and this operation is to read the full blob, this response header is returned so that the client can check for message content integrity.
contentRange	Indicates the range of bytes returned in the event that the client requested a subset of the blob by setting the 'Range' request header.
contentType	The media type of the body of the response. For Download Blob this is 'application/octet-stream'
copyCompletedOn	Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. This value can specify the time of a completed, aborted, or failed copy attempt. This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
copyId	String identifier for this copy operation. Use with Get Blob Properties to check the status of this copy operation, or pass to Abort Copy Blob to abort a pending copy.
copyProgress	Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. Can show between 0 and Content-Length bytes copied. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List
copySource	URL up to 2 KB in length that specifies the source blob or file used in the last attempted Copy Blob operation where this blob was the destination blob. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
copyStatus	State of the copy operation identified by x-ms-copy-id.
copyStatusDescription	Only appears when x-ms-copy-status is failed or pending. Describes the cause of the last fatal or non-fatal copy operation failure. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List
createdOn	Returns the date and time the blob was created.
date	UTC date/time value generated by the service that indicates the time at which the response was initiated
encryptionKeySha256	The SHA-256 hash of the encryption key used to encrypt the blob. This header is only returned when the blob was encrypted with a customer-provided key.
encryptionScope	Returns the name of the encryption scope used to encrypt the blob contents and application metadata. Note that the absence of this header implies use of the default account encryption scope.
errorCode	Error Code
etag	The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
immutabilityPolicyExpiresOn	UTC date/time value generated by the service that indicates the time at which the blob immutability policy will expire.
immutabilityPolicyMode	Indicates immutability policy mode.
isCurrentVersion	The value of this header indicates whether version of this blob is a current version, see also x-ms-version-id header.
isSealed	If this blob has been sealed
isServerEncrypted	The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).
lastAccessed	UTC date/time value generated by the service that indicates the time at which the blob was last read or written to
lastModified	Returns the date and time the container was last modified. Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
leaseDuration	When a blob is leased, specifies whether the lease is of infinite or fixed duration.
leaseState	Lease state of the blob.
leaseStatus	The current lease status of the blob.
legalHold	Indicates if a legal hold is present on the blob.
metadata
objectReplicationPolicyId	Optional. Only valid when Object Replication is enabled for the storage container and on the destination blob of the replication.
objectReplicationRules	Optional. Only valid when Object Replication is enabled for the storage container and on the source blob of the replication. When retrieving this header, it will return the header with the policy id and rule id (e.g. x-ms-or-policyid_ruleid), and the value will be the status of the replication (e.g. complete, failed).
readableStreamBody	NODEJS ONLY The response body as a node.js Readable stream. Always undefined in the browser.
requestId	This header uniquely identifies the request that was made and can be used for troubleshooting the request.
tagCount	The number of tags associated with the blob
version	Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
versionId	A DateTime value returned by the service that uniquely identifies the blob. The value of this header indicates the blob version, and may be used in subsequent requests to access this version of the blob.

Property Details

objectReplicationDestinationPolicyId

Object Replication Policy Id of the destination blob.

objectReplicationDestinationPolicyId?: string

Property Value

string

objectReplicationSourceProperties

Parsed Object Replication Policy Id, Rule Id(s) and status of the source blob.

objectReplicationSourceProperties?: ObjectReplicationPolicy[]

Property Value

ObjectReplicationPolicy[]

Inherited Property Details

acceptRanges

Indicates that the service supports requests for partial blob content.

acceptRanges?: string

Property Value

string

Inherited From BlobDownloadResponseModel.acceptRanges

blobBody

BROWSER ONLY

The response body as a browser Blob. Always undefined in node.js.

blobBody?: Promise<Blob>

Property Value

Promise<Blob>

Inherited From BlobDownloadResponseModel.blobBody

blobCommittedBlockCount

The number of committed blocks present in the blob. This header is returned only for append blobs.

blobCommittedBlockCount?: number

Property Value

number

Inherited From BlobDownloadResponseModel.blobCommittedBlockCount

blobContentMD5

If the blob has a MD5 hash, and if request contains range header (Range or x-ms-range), this response header is returned with the value of the whole blob's MD5 value. This value may or may not be equal to the value returned in Content-MD5 header, with the latter calculated from the requested range

blobContentMD5?: Uint8Array

Property Value

Uint8Array

Inherited From BlobDownloadResponseModel.blobContentMD5

blobSequenceNumber

The current sequence number for a page blob. This header is not returned for block blobs or append blobs

blobSequenceNumber?: number

Property Value

number

Inherited From BlobDownloadResponseModel.blobSequenceNumber

blobType

The blob's type.

blobType?: BlobType

Property Value

BlobType

Inherited From BlobDownloadResponseModel.blobType

cacheControl

This header is returned if it was previously specified for the blob.

cacheControl?: string

Property Value

string

Inherited From BlobDownloadResponseModel.cacheControl

clientRequestId

If a client request id header is sent in the request, this header will be present in the response with the same value.

clientRequestId?: string

Property Value

string

Inherited From BlobDownloadResponseModel.clientRequestId

contentCrc64

If the request is to read a specified range and the x-ms-range-get-content-crc64 is set to true, then the request returns a crc64 for the range, as long as the range size is less than or equal to 4 MB. If both x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is specified in the same request, it will fail with 400(Bad Request).

contentCrc64?: Uint8Array

Property Value

Uint8Array

Inherited From BlobDownloadResponseModel.contentCrc64

contentDisposition

This header returns the value that was specified for the 'x-ms-blob-content-disposition' header. The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the blob name specified.

contentDisposition?: string

Property Value

string

Inherited From BlobDownloadResponseModel.contentDisposition

contentEncoding

This header returns the value that was specified for the Content-Encoding request header

contentEncoding?: string

Property Value

string

Inherited From BlobDownloadResponseModel.contentEncoding

contentLanguage

This header returns the value that was specified for the Content-Language request header.

contentLanguage?: string

Property Value

string

Inherited From BlobDownloadResponseModel.contentLanguage

contentLength

The number of bytes present in the response body.

contentLength?: number

Property Value

number

Inherited From BlobDownloadResponseModel.contentLength

contentMD5

If the blob has an MD5 hash and this operation is to read the full blob, this response header is returned so that the client can check for message content integrity.

contentMD5?: Uint8Array

Property Value

Uint8Array

Inherited From BlobDownloadResponseModel.contentMD5

contentRange

Indicates the range of bytes returned in the event that the client requested a subset of the blob by setting the 'Range' request header.

contentRange?: string

Property Value

string

Inherited From BlobDownloadResponseModel.contentRange

contentType

The media type of the body of the response. For Download Blob this is 'application/octet-stream'

contentType?: string

Property Value

string

Inherited From BlobDownloadResponseModel.contentType

copyCompletedOn

Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. This value can specify the time of a completed, aborted, or failed copy attempt. This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.

copyCompletedOn?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.copyCompletedOn

copyId

String identifier for this copy operation. Use with Get Blob Properties to check the status of this copy operation, or pass to Abort Copy Blob to abort a pending copy.

copyId?: string

Property Value

string

Inherited From BlobDownloadResponseModel.copyId

copyProgress

Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. Can show between 0 and Content-Length bytes copied. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List

copyProgress?: string

Property Value

string

Inherited From BlobDownloadResponseModel.copyProgress

copySource

URL up to 2 KB in length that specifies the source blob or file used in the last attempted Copy Blob operation where this blob was the destination blob. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.

copySource?: string

Property Value

string

Inherited From BlobDownloadResponseModel.copySource

copyStatus

State of the copy operation identified by x-ms-copy-id.

copyStatus?: CopyStatusType

Property Value

CopyStatusType

Inherited From BlobDownloadResponseModel.copyStatus

copyStatusDescription

Only appears when x-ms-copy-status is failed or pending. Describes the cause of the last fatal or non-fatal copy operation failure. This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List

copyStatusDescription?: string

Property Value

string

Inherited From BlobDownloadResponseModel.copyStatusDescription

createdOn

Returns the date and time the blob was created.

createdOn?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.createdOn

date

UTC date/time value generated by the service that indicates the time at which the response was initiated

date?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.date

encryptionKeySha256

The SHA-256 hash of the encryption key used to encrypt the blob. This header is only returned when the blob was encrypted with a customer-provided key.

encryptionKeySha256?: string

Property Value

string

Inherited From BlobDownloadResponseModel.encryptionKeySha256

encryptionScope

Returns the name of the encryption scope used to encrypt the blob contents and application metadata. Note that the absence of this header implies use of the default account encryption scope.

encryptionScope?: string

Property Value

string

Inherited From BlobDownloadResponseModel.encryptionScope

errorCode

Error Code

errorCode?: string

Property Value

string

Inherited From BlobDownloadResponseModel.errorCode

etag

The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.

etag?: string

Property Value

string

Inherited From BlobDownloadResponseModel.etag

immutabilityPolicyExpiresOn

UTC date/time value generated by the service that indicates the time at which the blob immutability policy will expire.

immutabilityPolicyExpiresOn?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.immutabilityPolicyExpiresOn

immutabilityPolicyMode

Indicates immutability policy mode.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Property Value

BlobImmutabilityPolicyMode

Inherited From BlobDownloadResponseModel.immutabilityPolicyMode

isCurrentVersion

The value of this header indicates whether version of this blob is a current version, see also x-ms-version-id header.

isCurrentVersion?: boolean

Property Value

boolean

Inherited From BlobDownloadResponseModel.isCurrentVersion

isSealed

If this blob has been sealed

isSealed?: boolean

Property Value

boolean

Inherited From BlobDownloadResponseModel.isSealed

isServerEncrypted

The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).

isServerEncrypted?: boolean

Property Value

boolean

Inherited From BlobDownloadResponseModel.isServerEncrypted

lastAccessed

UTC date/time value generated by the service that indicates the time at which the blob was last read or written to

lastAccessed?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.lastAccessed

lastModified

Returns the date and time the container was last modified. Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.

lastModified?: Date

Property Value

Date

Inherited From BlobDownloadResponseModel.lastModified

leaseDuration

When a blob is leased, specifies whether the lease is of infinite or fixed duration.

leaseDuration?: LeaseDurationType

Property Value

LeaseDurationType

Inherited From BlobDownloadResponseModel.leaseDuration

leaseState

Lease state of the blob.

leaseState?: LeaseStateType

Property Value

LeaseStateType

Inherited From BlobDownloadResponseModel.leaseState

leaseStatus

The current lease status of the blob.

leaseStatus?: LeaseStatusType

Property Value

LeaseStatusType

Inherited From BlobDownloadResponseModel.leaseStatus

legalHold

Indicates if a legal hold is present on the blob.

legalHold?: boolean

Property Value

boolean

Inherited From BlobDownloadResponseModel.legalHold

metadata

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

Property Value

{[propertyName: string]: string}

Inherited From BlobDownloadResponseModel.metadata

objectReplicationPolicyId

Optional. Only valid when Object Replication is enabled for the storage container and on the destination blob of the replication.

objectReplicationPolicyId?: string

Property Value

string

Inherited From BlobDownloadResponseModel.objectReplicationPolicyId

objectReplicationRules

Optional. Only valid when Object Replication is enabled for the storage container and on the source blob of the replication. When retrieving this header, it will return the header with the policy id and rule id (e.g. x-ms-or-policyid_ruleid), and the value will be the status of the replication (e.g. complete, failed).

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

Property Value

{[propertyName: string]: string}

Inherited From BlobDownloadResponseModel.objectReplicationRules

readableStreamBody

NODEJS ONLY

The response body as a node.js Readable stream. Always undefined in the browser.

readableStreamBody?: ReadableStream

Property Value

ReadableStream

Inherited From BlobDownloadResponseModel.readableStreamBody

requestId

This header uniquely identifies the request that was made and can be used for troubleshooting the request.

requestId?: string

Property Value

string

Inherited From BlobDownloadResponseModel.requestId

tagCount

The number of tags associated with the blob

tagCount?: number

Property Value

number

Inherited From BlobDownloadResponseModel.tagCount

version

Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.

version?: string

Property Value

string

Inherited From BlobDownloadResponseModel.version

versionId

A DateTime value returned by the service that uniquely identifies the blob. The value of this header indicates the blob version, and may be used in subsequent requests to access this version of the blob.

versionId?: string

Property Value

string

Inherited From BlobDownloadResponseModel.versionId