你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
BlobGetPropertiesResponse interface
包含 getProperties 操作的响应数据。
- Extends
属性
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 帐户,有效值为 rehydrate-pending-to-hot/rehydrate-pending-to-cool。 如果 Blob 正在解除冻结且未完成,则返回此标头,指示解除冻结处于挂起状态,同时告知目标层。 |
blob |
Blob 中存在的已提交块数。 仅对追加 Blob 返回此标头。 |
blob |
页 Blob 的当前序列号。 块 Blob 或追加 Blob 不返回此标头 |
blob |
Blob 的类型。 |
cache |
如果为 Blob 指定了此标头,则返回此标头。 |
client |
如果在请求中发送客户端请求 ID 标头,则此标头将出现在具有相同值的响应中。 |
content |
此标头返回为“x-ms-blob-content-disposition”标头指定的值。 Content-Disposition 响应标头字段传达了有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。 例如,如果设置为 attachment,则表示用户代理不应显示响应,而是显示文件名不是指定的 blob 名称的“另存为”对话框。 |
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,则包括 。 |
is |
如果此 Blob 已密封 |
is |
如果使用指定的算法完全加密 Blob 数据和应用程序元数据,则此标头的值设置为 true。 否则,如果 blob 未加密,或者仅加密 blob/应用程序元数据的一部分) ,则值将设置为 false (。 |
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 帐户,有效值为 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
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