导出 (0) 打印
全部展开
此主题尚未评级 - 评价此主题

设置 Blob 属性 (REST API)

更新时间: 2013年11月

Set Blob Properties 操作在 Blob 上设置系统属性。

可以按如下方式构建Set Blob Properties请求。建议使用 HTTPS。将 myaccount 替换为您的存储帐户名称:

 

  PUT 方法请求 URI HTTP 版本

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties

HTTP/1.1

模拟的存储服务 URI

在针对模拟的存储服务发出请求时,请将模拟器主机名和 BLOB 服务端口指定为 127.0.0.1:10000,后跟模拟的存储帐户名称:

 

  PUT 方法请求 URI HTTP 版本

http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties

HTTP/1.1

有关详细信息,请参阅 About Development Storage存储仿真程序与 Windows Azure 存储服务之间的差异

URI 参数

可以在请求 URI 上指定以下附加参数。

 

参数 说明

timeout

可选。timeout 参数以秒表示。有关详细信息,请参阅为 BLOB 服务操作设置超时

请求标头(块 Blob 和页 Blob)

下表说明了块 Blob 和页 Blob 上的操作的必需和可选请求标头。

 

请求标头 说明

Authorization

必需。指定身份验证方案、帐户名和签名。有关详细信息,请参阅Windows Azure 存储服务身份验证

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关详细信息,请参阅Windows Azure 存储服务身份验证

x-ms-version

对于所有验证的请求是必需的。指定用于此请求的操作的版本。有关详细信息,请参阅Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

x-ms-blob-cache-control

可选。修改 Blob 的缓存控制字符串。

如果没有在请求上指定此属性,则会为 Blob 清除该属性。获取 Blob 属性 (REST API)的后续调用不会返回此属性,除非在 Blob 上再次显式设置该属性。

x-ms-blob-content-type

可选。设置 Blob 的内容类型。

如果没有在请求上指定此属性,则会为 Blob 清除该属性。获取 Blob 属性 (REST API)的后续调用不会返回此属性,除非在 Blob 上再次显式设置该属性。

x-ms-blob-content-md5

可选。设置 Blob 的 MD5 哈希。

如果没有在请求上指定此属性,则会为 Blob 清除该属性。获取 Blob 属性 (REST API)的后续调用不会返回此属性,除非在 Blob 上再次显式设置该属性。

x-ms-blob-content-encoding

可选。设置 Blob 的内容编码。

如果没有在请求上指定此属性,则会为 Blob 清除该属性。获取 Blob 属性 (REST API)的后续调用不会返回此属性,除非在 Blob 上再次显式设置该属性。

x-ms-blob-content-language

可选。设置 Blob 的内容语言。

如果没有在请求上指定此属性,则会为 Blob 清除该属性。获取 Blob 属性 (REST API)的后续调用不会返回此属性,除非在 Blob 上再次显式设置该属性。

x-ms-lease-id:<ID>

如果 Blob 具有活动租约,则是必需的。要在具有活动租约的 Blob 上执行此操作,请为此标头指定有效的租约 ID。

x-ms-client-request-id

可选。提供客户端生成的、具有 1 KB 字符限制的难理解的值,当启用存储分析日志记录时在分析日志中记录该值。强烈建议使用此标头以将客户端活动与服务器收到的请求关联。有关详细信息,请参阅关于存储分析日志记录Windows Azure 日志记录:使用日志跟踪存储请求

x-ms-blob-content-disposition

可选。设置 Blob 的 Content-Disposition 标头。适用于版本 2013-08-15 和更高版本。

Content-Disposition 响应标头字段传达有关如何处理响应负载的详细信息,也可用于附加更多元数据。例如,如果设置为 attachment,它指示用户代理不应显示响应,而是应显示指定了文件名而非 Blob 名称的“另存为”对话框。

来自获取 Blob (REST API)获取 Blob 属性 (REST API) 操作的响应包含 content-disposition 标头。

Origin

可选。指定从中发出请求的来源。如果存在此标头,则会在响应中产生跨域资源共享标头。有关详细信息,请参阅对 Windows Azure 存储服务的跨域资源共享 (CORS) 支持

此操作还支持使用条件标头,以便在符合指定条件时才设置 Blob 属性。有关详细信息,请参阅为 Blob 服务操作指定条件标头

请求标头(仅限页 Blob)

下表说明了仅适用于页 Blob 上的操作的请求标头。

 

请求标头 说明

x-ms-blob-content-length: byte value

可选。将页 Blob 调整为指定大小。如果指定的值小于当前的 Blob 大小,则会清除超过指定值的所有页面。

此属性不能用于更改块 Blob 大小。如果为块 Blob 设置此属性,则会返回状态代码 400(错误的请求)。

x-ms-sequence-number-action: {max, update, increment}

可选,但如果为请求设置了 x-ms-blob-sequence-number 标头,则是必需的。此属性仅适用于页 Blob。

此属性指示服务应如何修改 Blob 的序列号。为此属性指定以下选项之一:

  • max:将序列号设置为请求中包含的值和当前存储的 Blob 值中的较大值。

  • update:将序列号设置为请求中包含的值。

  • increment:将序列号的值增加 1。如果指定此选项,则不包含 x-ms-blob-sequence-number header;否则,将返回状态代码 400(错误的请求)。

x-ms-blob-sequence-number: <num>

可选,但如果将 x-ms-sequence-number-action 属性设置为 maxupdate,则是必需的。此属性仅适用于页 Blob。

此属性设置 Blob 的序列号。序列号是一个用户控制的属性,可用于跟踪请求和管理并发性问题。有关详细信息,请参阅放置页 (REST API)操作。

可以将此属性与 x-ms-sequence-number-action 一起使用,以便将 Blob 的序列号更新为指定的值,或更新为请求中指定的值和当前存储的 Blob 值中的较大值。如果将 x-ms-sequence-number-action 设置为 increment,则不应指定此标头;在这种情况下,服务自动将序列号的值增加 1。

要将序列号设置为所选的值,必须在请求上将此属性与 x-ms-sequence-number-action 一起指定。

请求正文

无。

响应包括 HTTP 状态代码和一组响应标头。

状态代码

成功的操作将返回状态代码 200(正常)。

有关状态代码的信息,请参阅状态和错误代码

响应标头

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都遵循 HTTP/1.1 协议规范

 

语法 说明

ETag

ETag 包含一个值,您可以使用该值有条件地执行操作。有关详细信息,请参阅为 Blob 服务操作指定条件标头。如果请求版本为 2011-08-18 和更高版本,ETag 值将用引号引起来。

Last-Modified

上次修改 Blob 的日期/时间。日期格式遵循 RFC 1123。有关详细信息,请参阅标头中日期/时间值的表示

针对 Blob 的任何写操作(包括更新 Blob 的元数据或属性)都会更改 Blob 的上次修改时间。

x-ms-blob-sequence-number

如果 Blob 是页 Blob,则将 Blob 的当前序列号与此标头一起返回。

x-ms-request-id

此标头唯一地标识发出的请求,并且可用于解决请求问题。有关详细信息,请参阅API 操作故障排除

x-ms-version

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

Date

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

Access-Control-Allow-Origin

如果请求包含 Origin 标头并且通过匹配的规则启用了 CORS,则返回此标头。如果存在匹配项,此标头返回原始请求标头的值。

Access-Control-Expose-Headers

如果请求包含 Origin 标头并且通过匹配的规则启用了 CORS,则返回此标头。返回将向客户端或请求的发出方公开的响应标头的列表。

Access-Control-Allow-Credentials

如果请求包含 Origin 标头并且通过不允许全部来源的匹配规则启用了 CORS,则返回此标头。此标头将设置为 True。

响应正文

无。

仅帐户所有者以及使用有权在此 Blob 或其容器中写入数据的共享访问签名的任何人可以调用此操作。

更新 Blob 的属性的语义如下所示:

  • 只有在请求符合以下条件之一时,才会更新页 Blob 的序列号:

    • 请求将 x-ms-sequence-number-action 设置为 maxupdate,并且还指定了 x-ms-blob-sequence-number 标头的值。

    • 请求将 x-ms-sequence-number-action 设置为 increment,以指示服务应将序列号的值增加 1。

  • 只有在请求指定了 x-ms-content-length 标头值时,才会修改页 Blob 的大小。

  • 如果请求仅设置了 x-ms-blob-sequence-number 和/或 x-ms-content-length 而未设置其他属性,则不会修改 Blob 的任何其他属性。

  • 如果在请求中设置下面的一个或多个属性,则会设置所有这些属性。在至少设置了下面列出的一个属性时,如果没有为给定属性提供值,则会为 Blob 清除该属性。

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

请注意,对于共享访问签名,您可以通过指定查询参数作为共享访问签名的一部分来替代为 Blob 存储的某些属性。这些属性包括 cache-controlcontent-typecontent-encodingcontent-languagecontent-disposition 属性。有关详细信息,请参阅构造共享访问签名 URI (REST API)

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
显示:
© 2014 Microsoft. 版权所有。