编排对象

组合操作会创建一个新对象,其内容由一系列指定序列的源对象(最多 32 个对象)串联而成。源对象必须全部位于同一存储分区中,而且使用相同的存储类别。源对象不受组合操作的影响,并且生成的复合对象也不会因源对象被替换或删除而改变。

复合对象可以基于本身的复合对象构建。

如需了解详情,请参阅复合对象

查询字符串参数

参数 说明 必需
compose 发出 compose 请求。 要求请求正文中包含 ComposeRequest XML 文档。

如需了解您在创建和使用签名网址时包含的参数,请参阅签名网址查询字符串参数

请求标头

除了通用请求标头之外,您还可以使用以下内容。

标题 说明 必需
Content-Encoding 用于压缩复合对象的压缩算法。
Content-Disposition 一个标头,用于指定有关传输对象数据的表示信息。
x-goog-acl 您要应用于复合对象的预定义 ACL。
x-goog-custom-time 用户指定的日期和时间。
x-goog-meta- 可用于存储自定义元数据的扩展程序标头。

如需编写由客户提供的加密密钥加密的对象,请在请求中使用“加密”页面上列出的标头

请求正文元素

以下请求正文元素仅在您使用 compose 查询字符串参数发出组合请求时才适用。

元素 说明
ComposeRequest 用于生成复合请求的容器。
Component 撰写请求组件参数的容器。
Name 撰写请求组件的对象名称。
Generation Compose 请求组件的世代编号。
IfGenerationMatch Compose 请求组件的当前世代编号。如果组件对象具有不同的世代,则请求将失败。

请求语法

PUT /OBJECT_NAME?compose HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<ComposeRequest>
  <Component>
    <Name>component-obj-1</Name>
  </Component>
  <Component>
    <Name>component-obj-2</Name>
    <Generation>1361471441094000</Generation>
  </Component>
  <Component>
    <Name>component-obj-3</Name>
    <IfGenerationMatch>1361471441094000</IfGenerationMatch>
  </Component>
</ComposeRequest>

响应标头

请求可以返回各种响应标头,具体取决于您使用的请求标头。

响应正文元素

响应的响应正文中不包含 XML 文档。