此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
设置 Blob 属性

设置 Blob 属性

更新时间: 2015年4月

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

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

 

  PUT 方法请求 URI HTTP 版本

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

HTTP/1.1

有关详细信息,请参阅Using the Azure Storage Emulator for Development and Testing

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

 

Parameter 说明

timeout

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

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

 

请求标头 说明

Authorization

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

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关详细信息,请参阅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 字符限制的模糊值,在启用存储分析日志记录时,将在分析日志中记录该值。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息,请参阅关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

x-ms-blob-content-disposition

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

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

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

Origin

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

此操作还支持使用条件标头,以便在符合指定条件时才设置 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

显示:
© 2015 Microsoft