你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
BlobGetPropertiesResponse interface
包含 getProperties作的响应数据。
- 扩展
属性
object |
目标 Blob 的对象复制策略 ID。 |
object |
分析的对象复制策略 ID、规则 ID 和源 Blob 的状态。 |
继承属性
accept |
指示服务支持对部分 Blob 内容的请求。 |
access |
高级存储帐户上的页 Blob 层或 Blob 存储 LRS 帐户上的块 Blob 层。 有关允许的高级页 Blob 层的列表,请参阅 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features。 对于 Blob 存储 LRS 帐户,有效值为热/冷/存档。 |
access |
层在对象上更改的时间。 仅当已设置块 Blob 上的层时,才会返回该层。 |
access |
仅适用于高级存储帐户上的页 Blob。 如果未在 Blob 上显式设置访问层,则根据访问层的内容长度推断该层,并且此标头将以 true 值返回。 |
archive |
对于 Blob 存储 LRS 帐户,有效值是解除冻结-挂起到热/解除冻结-挂起到冷。 如果 Blob 正在解除冻结且未完成,则返回此标头,指示解除冻结挂起,并告知目标层。 |
blob |
Blob 中存在的已提交的块数。 仅针对追加 Blob 返回此标头。 |
blob |
页 Blob 的当前序列号。 块 blob 或追加 Blob 不返回此标头 |
blob |
Blob 的类型。 |
cache |
如果以前为 Blob 指定了此标头,则返回此标头。 |
client |
如果在请求中发送客户端请求 ID 标头,此标头将出现在响应中,其值相同。 |
content |
此标头返回为“x-ms-blob-content-disposition”标头指定的值。 Content-Disposition 响应标头字段传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。 例如,如果设置为附件,则表示用户代理不应显示响应,而是显示文件名以外的文件名的“另存为”对话框。 |
content |
此标头返回为 Content-Encoding 请求标头指定的值 |
content |
此标头返回为 Content-Language 请求标头指定的值。 |
content |
blob 的大小(以字节为单位)。 对于页 Blob,此标头返回随 blob 一起存储的 x-ms-blob-content-length 标头的值。 |
contentMD5 | 如果 Blob 具有 MD5 哈希,并且此作是读取完整 Blob,则返回此响应标头,以便客户端可以检查消息内容完整性。 |
content |
为 Blob 指定的内容类型。 默认内容类型为“application/octet-stream” |
copy |
上次尝试复制 Blob作的结束时间,其中此 Blob 是目标 Blob。 此值可以指定已完成、中止或失败复制尝试的时间。 如果复制挂起、此 Blob 从未成为复制 Blob作中的目标,或者此 Blob 在结束的复制 Blob作之后使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”进行修改,则不会显示此标头。 |
copy |
此复制作的字符串标识符。 与“获取 Blob 属性”一起使用可检查此复制作的状态,或传递给中止复制 Blob 以中止挂起的副本。 |
copy |
包含上次尝试的复制 Blob作中复制的字节数和源中的总字节数,其中此 Blob 是目标 Blob。 可以显示复制的 0 到内容长度字节。 如果此 Blob 从未在复制 Blob作中成为目标,或者此 Blob 在结束的复制 Blob作后使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”进行修改,则不会显示此标头 |
copy |
URL 最大长度为 2 KB,指定在上次尝试的复制 Blob作中使用的源 Blob 或文件,其中此 Blob 是目标 Blob。 如果此 Blob 从未在复制 Blob作中成为目标,或者此 Blob 在结束的复制 Blob作之后使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”进行修改,则不会显示此标头。 |
copy |
x-ms-copy-id 标识的复制作的状态。 |
copy |
仅当 x-ms-copy-status 失败或挂起时才显示。 描述最后一次致命或非致命复制作失败的原因。 如果此 Blob 从未在复制 Blob作中成为目标,或者此 Blob 在结束的复制 Blob作后使用“设置 Blob 属性”、“放置 Blob”或“放置块列表”进行修改,则不会显示此标头 |
created |
返回创建 Blob 的日期和时间。 |
date | 服务生成的 UTC 日期/时间值,指示响应启动的时间 |
destination |
如果 Blob 是增量复制 blob 或增量复制快照,则包括 x-ms-copy-status 是否成功。 此 Blob 上次成功的增量复制快照的快照时间。 |
encryption |
用于加密元数据的加密密钥的 SHA-256 哈希。 仅当元数据使用客户提供的密钥加密时,才会返回此标头。 |
encryption |
返回用于加密 Blob 内容和应用程序元数据的加密范围的名称。 请注意,缺少此标头意味着使用默认帐户加密范围。 |
error |
错误代码 |
etag | ETag 包含可用于有条件地执行作的值。 如果请求版本为 2011-08-18 或更高版本,ETag 值将采用引号。 |
expires |
此 Blob 过期的时间。 |
immutability |
服务生成的 UTC 日期/时间值,指示 Blob 不可变性策略过期的时间。 |
immutability |
指示不可变策略模式。 |
is |
此标头的值指示此 Blob 的版本是否为当前版本,另请参阅 x-ms-version-id 标头。 |
is |
如果 Blob 是增量复制 blob,则包含该 Blob。 |
is |
如果此 Blob 已密封 |
is |
如果 blob 数据和应用程序元数据使用指定的算法完全加密,则此标头的值设置为 true。 否则,该值设置为 false(如果 blob 未加密,或者仅加密 blob/应用程序元数据的一部分)。 |
last |
服务生成的 UTC 日期/时间值,该值指示 Blob 上次读取或写入到的时间 |
last |
返回上次修改 Blob 的日期和时间。 任何修改 Blob 的作(包括更新 blob 的元数据或属性)都更改 Blob 的上次修改时间。 |
lease |
当 Blob 租用时,指定租约是无限持续时间还是固定持续时间。 |
lease |
Blob 的租用状态。 |
lease |
Blob 的当前租约状态。 |
legal |
指示 Blob 上是否存在法定保留。 |
metadata | |
object |
自选。 仅在为存储容器和复制的目标 Blob 启用对象复制时有效。 |
object |
自选。 仅在为存储容器和复制的源 Blob 启用对象复制时有效。 检索此标头时,它将返回具有策略 ID 和规则 ID(例如 x-ms-or-policyid_ruleid)的标头,该值将是复制的状态(例如完成,失败)。 |
rehydrate |
如果某个对象处于解除冻结挂起状态,则返回此标头,优先级为解除冻结。 |
request |
此标头唯一标识已发出的请求,并可用于对请求进行故障排除。 |
tag |
与 Blob 关联的标记数 |
version | 指示用于执行请求的 Blob 服务的版本。 对于针对版本 2009-09-19 及更高版本发出的请求,将返回此标头。 |
version |
由唯一标识 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 帐户,有效值是解除冻结-挂起到热/解除冻结-挂起到冷。 如果 Blob 正在解除冻结且未完成,则返回此标头,指示解除冻结挂起,并告知目标层。
archiveStatus?: string
属性值
string
继承自 BlobGetPropertiesResponseModel.archiveStatus
blobCommittedBlockCount
Blob 中存在的已提交的块数。 仅针对追加 Blob 返回此标头。
blobCommittedBlockCount?: number
属性值
number
继承自 BlobGetPropertiesResponseModel.blobCommittedBlockCount
blobSequenceNumber
页 Blob 的当前序列号。 块 blob 或追加 Blob 不返回此标头
blobSequenceNumber?: number
属性值
number
继承自 BlobGetPropertiesResponseModel.blobSequenceNumber
blobType
cacheControl
如果以前为 Blob 指定了此标头,则返回此标头。
cacheControl?: string
属性值
string
继承自 BlobGetPropertiesResponseModel.cacheControl
clientRequestId
如果在请求中发送客户端请求 ID 标头,此标头将出现在响应中,其值相同。
clientRequestId?: string
属性值
string
继承自 BlobGetPropertiesResponseModel.clientRequestId
contentDisposition
此标头返回为“x-ms-blob-content-disposition”标头指定的值。 Content-Disposition 响应标头字段传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。 例如,如果设置为附件,则表示用户代理不应显示响应,而是显示文件名以外的文件名的“另存为”对话框。
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,则包含该 Blob。
isIncrementalCopy?: boolean
属性值
boolean
继承自 BlobGetPropertiesResponseModel.isIncrementalCopy
isSealed
如果此 Blob 已密封
isSealed?: boolean
属性值
boolean
继承自 BlobGetPropertiesResponseModel.isSealed
isServerEncrypted
如果 blob 数据和应用程序元数据使用指定的算法完全加密,则此标头的值设置为 true。 否则,该值设置为 false(如果 blob 未加密,或者仅加密 blob/应用程序元数据的一部分)。
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