你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

BlobGetPropertiesResponse interface

包含 getProperties 操作的响应数据。

Extends

属性

objectReplicationDestinationPolicyId

目标 Blob 的对象复制策略 ID。

objectReplicationSourceProperties

分析的对象复制策略 ID、规则 ID (源 blob 的) 和状态。

继承属性

acceptRanges

指示服务支持针对部分 Blob 内容的请求。

accessTier

高级存储帐户上的页 Blob 层或 Blob 存储 LRS 帐户上的块 Blob 层。 有关允许的高级页 Blob 层的列表,请参阅 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features。 对于 Blob 存储 LRS 帐户,有效值为热/冷/存档。

accessTierChangedOn

对象上层更改的时间。 仅当已设置块 Blob 上的层时,才会返回此值。

accessTierInferred

仅适用于高级存储帐户上的页 Blob。 如果未在 Blob 上显式设置访问层,则会根据其内容长度推断该层,并将返回具有 true 值的此标头。

archiveStatus

对于 Blob 存储 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 响应标头字段传达了有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。 例如,如果设置为 attachment,则表示用户代理不应显示响应,而是显示文件名不是指定的 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 到内容长度字节。 如果此 Blob 从未成为复制 Blob 操作中的目标,或者此 Blob 在使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”完成复制 Blob 操作后进行了修改,则不会显示此标头

copySource

URL 长度最大为 2 KB,指定在上次尝试的复制 Blob 操作中使用的源 Blob 或文件,其中此 Blob 是目标 Blob。 如果此 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

由服务生成的 UTC 日期/时间值,该值指示 Blob 不可变策略将过期的时间。

immutabilityPolicyMode

指示不可变策略模式。

isCurrentVersion

此标头的值指示此 Blob 的版本是否为当前版本,另请参阅 x-ms-version-id 标头。

isIncrementalCopy

如果 Blob 是增量复制 blob,则包括 。

isSealed

如果此 Blob 已密封

isServerEncrypted

如果使用指定的算法完全加密 Blob 数据和应用程序元数据,则此标头的值设置为 true。 否则,如果 blob 未加密,或者仅加密 blob/应用程序元数据的一部分) ,则值将设置为 false (。

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。

属性详细信息

objectReplicationDestinationPolicyId

目标 Blob 的对象复制策略 ID。

objectReplicationDestinationPolicyId?: string

属性值

string

objectReplicationSourceProperties

分析的对象复制策略 ID、规则 ID (源 blob 的) 和状态。

objectReplicationSourceProperties?: ObjectReplicationPolicy[]

属性值

继承属性详细信息

acceptRanges

指示服务支持针对部分 Blob 内容的请求。

acceptRanges?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.acceptRanges

accessTier

高级存储帐户上的页 Blob 层或 Blob 存储 LRS 帐户上的块 Blob 层。 有关允许的高级页 Blob 层的列表,请参阅 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features。 对于 Blob 存储 LRS 帐户,有效值为热/冷/存档。

accessTier?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.accessTier

accessTierChangedOn

对象上层更改的时间。 仅当已设置块 Blob 上的层时,才会返回此值。

accessTierChangedOn?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.accessTierChangedOn

accessTierInferred

仅适用于高级存储帐户上的页 Blob。 如果未在 Blob 上显式设置访问层,则会根据其内容长度推断该层,并将返回具有 true 值的此标头。

accessTierInferred?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.accessTierInferred

archiveStatus

对于 Blob 存储 LRS 帐户,有效值为 rehydrate-pending-to-hot/rehydrate-pending-to-cool。 如果 Blob 正在解除冻结且未完成,则返回此标头,指示解除冻结处于挂起状态,同时告知目标层。

archiveStatus?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.archiveStatus

blobCommittedBlockCount

Blob 中存在的已提交块数。 仅对追加 Blob 返回此标头。

blobCommittedBlockCount?: number

属性值

number

继承自 BlobGetPropertiesResponseModel.blobCommittedBlockCount

blobSequenceNumber

页 Blob 的当前序列号。 块 Blob 或追加 Blob 不返回此标头

blobSequenceNumber?: number

属性值

number

继承自 BlobGetPropertiesResponseModel.blobSequenceNumber

blobType

Blob 的类型。

blobType?: BlobType

属性值

继承自 BlobGetPropertiesResponseModel.blobType

cacheControl

如果为 Blob 指定了此标头,则返回此标头。

cacheControl?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.cacheControl

clientRequestId

如果在请求中发送客户端请求 ID 标头,则此标头将出现在具有相同值的响应中。

clientRequestId?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.clientRequestId

contentDisposition

此标头返回为“x-ms-blob-content-disposition”标头指定的值。 Content-Disposition 响应标头字段传达了有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。 例如,如果设置为 attachment,则表示用户代理不应显示响应,而是显示文件名不是指定的 blob 名称的“另存为”对话框。

contentDisposition?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.contentDisposition

contentEncoding

此标头返回为 Content-Encoding 请求标头指定的值

contentEncoding?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.contentEncoding

contentLanguage

此标头返回为 Content-Language 请求标头指定的值。

contentLanguage?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.contentLanguage

contentLength

Blob 大小,以字节为单位。 对于页 Blob,此标头返回随 blob 一起存储的 x-ms-blob-content-length 标头的值。

contentLength?: number

属性值

number

继承自 BlobGetPropertiesResponseModel.contentLength

contentMD5

如果 Blob 具有 MD5 哈希,并且此操作是读取整个 Blob,则会返回此响应标头,以便客户端可以检查消息内容的完整性。

contentMD5?: Uint8Array

属性值

Uint8Array

继承自 BlobGetPropertiesResponseModel.contentMD5

contentType

为 Blob 指定的内容类型。 默认内容类型为“application/octet-stream”

contentType?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.contentType

copyCompletedOn

上次尝试的复制 Blob 操作的结束时间,其中此 Blob 是目标 Blob。 该值可以指定已完成、已中止或失败的复制尝试时间。 如果副本处于挂起状态,如果此 Blob 从未成为复制 Blob 操作中的目标,或者此 blob 在使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”完成复制 Blob 操作后已修改,则不会显示此标头。

copyCompletedOn?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.copyCompletedOn

copyId

此复制操作的字符串标识符。 与“获取 Blob 属性”一起使用可检查此复制操作的状态,或传递到“中止复制 Blob”以中止挂起的副本。

copyId?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.copyId

copyProgress

包含上次尝试的复制 Blob 操作中复制的字节数和源中的总字节数,其中此 Blob 是目标 Blob。 可以显示复制的 0 到内容长度字节。 如果此 Blob 从未成为复制 Blob 操作中的目标,或者此 Blob 在使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”完成复制 Blob 操作后进行了修改,则不会显示此标头

copyProgress?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.copyProgress

copySource

URL 长度最大为 2 KB,指定在上次尝试的复制 Blob 操作中使用的源 Blob 或文件,其中此 Blob 是目标 Blob。 如果此 Blob 从未成为复制 Blob 操作中的目标,或者此 Blob 已在使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”完成复制 Blob 操作后修改,则不会显示此标头。

copySource?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.copySource

copyStatus

x-ms-copy-id 标识的复制操作的状态。

copyStatus?: CopyStatusType

属性值

继承自 BlobGetPropertiesResponseModel.copyStatus

copyStatusDescription

仅当 x-ms-copy-status 失败或挂起时显示。 说明上次严重或不严重的复制操作故障的原因。 如果此 Blob 从未成为复制 Blob 操作中的目标,或者此 Blob 在使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”完成复制 Blob 操作后进行了修改,则不会显示此标头

copyStatusDescription?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.copyStatusDescription

createdOn

返回 Blob 的创建日期和时间。

createdOn?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.createdOn

date

由服务生成的 UTC 日期/时间值,指示启动响应的时间

date?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.date

destinationSnapshot

如果 blob 是增量复制 blob 或增量复制快照,则如果 x-ms-copy-status 成功,则包括在内。 此 Blob 上次成功增量复制快照的快照时间。

destinationSnapshot?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.destinationSnapshot

encryptionKeySha256

用于加密元数据的加密密钥的 SHA-256 哈希。 仅当使用客户提供的密钥加密元数据时,才会返回此标头。

encryptionKeySha256?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.encryptionKeySha256

encryptionScope

返回用于加密 Blob 内容和应用程序元数据的加密范围的名称。 请注意,缺少此标头意味着使用默认帐户加密范围。

encryptionScope?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.encryptionScope

errorCode

错误代码

errorCode?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.errorCode

etag

ETag 包含一个值,你可以使用该值有条件地执行操作。 如果请求版本为 2011-08-18 和更高版本,ETag 值将用引号引起来。

etag?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.etag

expiresOn

此 Blob 过期的时间。

expiresOn?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.expiresOn

immutabilityPolicyExpiresOn

由服务生成的 UTC 日期/时间值,该值指示 Blob 不可变策略将过期的时间。

immutabilityPolicyExpiresOn?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.immutabilityPolicyExpiresOn

immutabilityPolicyMode

指示不可变策略模式。

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

属性值

继承自 BlobGetPropertiesResponseModel.immutabilityPolicyMode

isCurrentVersion

此标头的值指示此 Blob 的版本是否为当前版本,另请参阅 x-ms-version-id 标头。

isCurrentVersion?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.isCurrentVersion

isIncrementalCopy

如果 Blob 是增量复制 blob,则包括 。

isIncrementalCopy?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.isIncrementalCopy

isSealed

如果此 Blob 已密封

isSealed?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.isSealed

isServerEncrypted

如果使用指定的算法完全加密 Blob 数据和应用程序元数据,则此标头的值设置为 true。 否则,如果 blob 未加密,或者仅加密 blob/应用程序元数据的一部分) ,则值将设置为 false (。

isServerEncrypted?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.isServerEncrypted

lastAccessed

由服务生成的 UTC 日期/时间值,该值指示 Blob 上次读取或写入的时间

lastAccessed?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.lastAccessed

lastModified

返回 Blob 上次修改的日期和时间。 任何修改 Blob 的操作(包括 Blob 元数据或属性更新)都会更改 Blob 的上次修改时间。

lastModified?: Date

属性值

Date

继承自 BlobGetPropertiesResponseModel.lastModified

leaseDuration

在租用 Blob 时,指定租约是无限期还是固定时间。

leaseDuration?: LeaseDurationType

属性值

继承自 BlobGetPropertiesResponseModel.leaseDuration

leaseState

Blob 的租约状态。

leaseState?: LeaseStateType

属性值

继承自 BlobGetPropertiesResponseModel.leaseState

leaseStatus

Blob 的当前租约状态。

leaseStatus?: LeaseStatusType

属性值

继承自 BlobGetPropertiesResponseModel.leaseStatus

legalHold

指示 Blob 上是否存在法定保留。

legalHold?: boolean

属性值

boolean

继承自 BlobGetPropertiesResponseModel.legalHold

metadata

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

属性值

{[propertyName: string]: string}

继承自 BlobGetPropertiesResponseModel.metadata

objectReplicationPolicyId

可选。 仅在为存储容器和复制的目标 Blob 启用对象复制时有效。

objectReplicationPolicyId?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.objectReplicationPolicyId

objectReplicationRules

可选。 仅在为存储容器和复制的源 Blob 启用对象复制时有效。 检索此标头时,它将返回具有策略 ID 和规则 ID (的标头,例如 x-ms-or-policyid_ruleid) ,值将是复制 (的状态,例如完成、失败) 。

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

属性值

{[propertyName: string]: string}

继承自 BlobGetPropertiesResponseModel.objectReplicationRules

rehydratePriority

如果对象处于解除冻结挂起状态,则返回此标头的优先级为“解除冻结”。

rehydratePriority?: RehydratePriority

属性值

继承自 BlobGetPropertiesResponseModel.rehydratePriority

requestId

此标头唯一地标识发出的请求,并且可用于解决请求问题。

requestId?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.requestId

tagCount

与 Blob 关联的标记数

tagCount?: number

属性值

number

继承自 BlobGetPropertiesResponseModel.tagCount

version

指示用于执行请求的 BLOB 服务的版本。 针对 2009-09-19 和更高版本发出的请求将返回此标头。

version?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.version

versionId

由唯一标识 blob 的服务返回的 DateTime 值。 此标头的值指示 Blob 版本,可用于后续请求以访问此版本的 Blob。

versionId?: string

属性值

string

继承自 BlobGetPropertiesResponseModel.versionId