Package version:

Interface BlobGetPropertiesResponse

Contains response data for the BlobClient.getProperties operation.

interface BlobGetPropertiesResponse {
    _response: HttpResponse & {
        parsedHeaders: BlobGetPropertiesHeaders;
    };
    acceptRanges?: string;
    accessTier?: string;
    accessTierChangedOn?: any;
    accessTierInferred?: boolean;
    archiveStatus?: string;
    blobCommittedBlockCount?: number;
    blobSequenceNumber?: number;
    blobType?: BlobType;
    cacheControl?: string;
    clientRequestId?: string;
    contentDisposition?: string;
    contentEncoding?: string;
    contentLanguage?: string;
    contentLength?: number;
    contentMD5?: any;
    contentType?: string;
    copyCompletedOn?: any;
    copyId?: string;
    copyProgress?: string;
    copySource?: string;
    copyStatus?: CopyStatusType;
    copyStatusDescription?: string;
    createdOn?: any;
    date?: any;
    destinationSnapshot?: string;
    encryptionKeySha256?: string;
    encryptionScope?: string;
    errorCode?: string;
    etag?: string;
    expiresOn?: any;
    immutabilityPolicyExpiresOn?: any;
    immutabilityPolicyMode?: BlobImmutabilityPolicyMode;
    isCurrentVersion?: boolean;
    isIncrementalCopy?: boolean;
    isSealed?: boolean;
    isServerEncrypted?: boolean;
    lastAccessed?: any;
    lastModified?: any;
    leaseDuration?: LeaseDurationType;
    leaseState?: LeaseStateType;
    leaseStatus?: LeaseStatusType;
    legalHold?: boolean;
    metadata?: {
        [propertyName: string]: string;
    };
    objectReplicationDestinationPolicyId?: string;
    objectReplicationPolicyId?: string;
    objectReplicationRules?: {
        [propertyName: string]: string;
    };
    objectReplicationSourceProperties?: {};
    rehydratePriority?: RehydratePriority;
    requestId?: string;
    tagCount?: number;
    version?: string;
    versionId?: string;
}

Hierarchy (view full)

Properties

_response acceptRanges? accessTier? accessTierChangedOn? accessTierInferred? archiveStatus? blobCommittedBlockCount? blobSequenceNumber? blobType? cacheControl? clientRequestId? contentDisposition? contentEncoding? contentLanguage? contentLength? contentMD5? contentType? copyCompletedOn? copyId? copyProgress? copySource? copyStatus? copyStatusDescription? createdOn? date? destinationSnapshot? encryptionKeySha256? encryptionScope? errorCode? etag? expiresOn? immutabilityPolicyExpiresOn? immutabilityPolicyMode? isCurrentVersion? isIncrementalCopy? isSealed? isServerEncrypted? lastAccessed? lastModified? leaseDuration? leaseState? leaseStatus? legalHold? metadata? objectReplicationDestinationPolicyId? objectReplicationPolicyId? objectReplicationRules? objectReplicationSourceProperties? rehydratePriority? requestId? tagCount? version? versionId?

Properties

_response

_response: HttpResponse & {
    parsedHeaders: BlobGetPropertiesHeaders;
}

The underlying HTTP response.

Type declaration

OptionalacceptRanges

acceptRanges?: string

Indicates that the service supports requests for partial blob content.

OptionalaccessTier

accessTier?: string

The tier of page blob on a premium storage account or tier of block blob on blob storage LRS accounts. For a list of allowed premium page blob tiers, see https://learn.microsoft.com/azure/virtual-machines/disks-types#premium-ssd. For blob storage LRS accounts, valid values are Hot/Cool/Archive.

OptionalaccessTierChangedOn

accessTierChangedOn?: any

The time the tier was changed on the object. This is only returned if the tier on the block blob was ever set.

OptionalaccessTierInferred

accessTierInferred?: boolean

For page blobs on a premium storage account only. If the access tier is not explicitly set on the blob, the tier is inferred based on its content length and this header will be returned with true value.

OptionalarchiveStatus

archiveStatus?: string

For blob storage LRS accounts, valid values are rehydrate-pending-to-hot/rehydrate-pending-to-cool. If the blob is being rehydrated and is not complete then this header is returned indicating that rehydrate is pending and also tells the destination tier.

OptionalblobCommittedBlockCount

blobCommittedBlockCount?: number

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

OptionalblobSequenceNumber

blobSequenceNumber?: number

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

OptionalblobType

blobType?: BlobType

The blob's type.

OptionalcacheControl

cacheControl?: string

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

OptionalclientRequestId

clientRequestId?: string

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

OptionalcontentDisposition

contentDisposition?: string

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.

OptionalcontentEncoding

contentEncoding?: string

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

OptionalcontentLanguage

contentLanguage?: string

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

OptionalcontentLength

contentLength?: number

The size of the blob in bytes. For a page blob, this header returns the value of the x-ms-blob-content-length header that is stored with the blob.

OptionalcontentMD5

contentMD5?: any

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.

OptionalcontentType

contentType?: string

The content type specified for the blob. The default content type is 'application/octet-stream'

OptionalcopyCompletedOn

copyCompletedOn?: any

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.

OptionalcopyId

copyId?: string

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.

OptionalcopyProgress

copyProgress?: string

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

OptionalcopySource

copySource?: string

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.

OptionalcopyStatus

copyStatus?: CopyStatusType

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

OptionalcopyStatusDescription

copyStatusDescription?: string

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

OptionalcreatedOn

createdOn?: any

Returns the date and time the blob was created.

Optionaldate

date?: any

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

OptionaldestinationSnapshot

destinationSnapshot?: string

Included if the blob is incremental copy blob or incremental copy snapshot, if x-ms-copy-status is success. Snapshot time of the last successful incremental copy snapshot for this blob.

OptionalencryptionKeySha256

encryptionKeySha256?: string

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

OptionalencryptionScope

encryptionScope?: string

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.

OptionalerrorCode

errorCode?: string

Error Code

Optionaletag

etag?: string

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.

OptionalexpiresOn

expiresOn?: any

The time this blob will expire.

OptionalimmutabilityPolicyExpiresOn

immutabilityPolicyExpiresOn?: any

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

OptionalimmutabilityPolicyMode

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Indicates immutability policy mode.

OptionalisCurrentVersion

isCurrentVersion?: boolean

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

OptionalisIncrementalCopy

isIncrementalCopy?: boolean

Included if the blob is incremental copy blob.

OptionalisSealed

isSealed?: boolean

If this blob has been sealed

OptionalisServerEncrypted

isServerEncrypted?: boolean

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).

OptionallastAccessed

lastAccessed?: any

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

OptionallastModified

lastModified?: any

Returns the date and time the blob 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.

OptionalleaseDuration

leaseDuration?: LeaseDurationType

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

OptionalleaseState

leaseState?: LeaseStateType

Lease state of the blob.

OptionalleaseStatus

leaseStatus?: LeaseStatusType

The current lease status of the blob.

OptionallegalHold

legalHold?: boolean

Indicates if a legal hold is present on the blob.

Optionalmetadata

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

OptionalobjectReplicationDestinationPolicyId

objectReplicationDestinationPolicyId?: string

Object Replication Policy Id of the destination blob.

OptionalobjectReplicationPolicyId

objectReplicationPolicyId?: string

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

OptionalobjectReplicationRules

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

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).

OptionalobjectReplicationSourceProperties

objectReplicationSourceProperties?: {}

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

OptionalrehydratePriority

rehydratePriority?: RehydratePriority

If an object is in rehydrate pending state then this header is returned with priority of rehydrate.

OptionalrequestId

requestId?: string

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

OptionaltagCount

tagCount?: number

The number of tags associated with the blob

Optionalversion

version?: string

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.

OptionalversionId

versionId?: string

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.

Settings

Member Visibility