启动可续传上传

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

发出 POST 请求的可续传上传。此初始请求会生成一个会话 URI,以便在上传数据的后续 PUT 请求中使用。初始请求还允许您指定对象的元数据。可续传上传完成后,上传的对象将替换具有相同名称的现有对象。如需了解上传到 Cloud Storage 的提示,请参阅最佳做法

对于使用 XML API 进行的简单上传,您需要发出 PUT Object 请求,而不是使用 POST 对象。

查询字符串参数

此请求通常不包含查询字符串参数。

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

请求标头

可以使用以下请求标头。

标题 说明 必需
Authorization 请求的身份验证字符串。
Cache-Control 应对可公开访问的对象进行缓存的条件。Cache-Control 也可用于确定是否可以转换对象。
Content-Disposition 一个标头,用于指定有关传输对象数据的表示信息。
Content-Encoding 压缩算法用于压缩要上传的对象。
Content-Language 内容的 ISO 639-1 语言代码。
Content-Length

请求正文的长度(无标头)(以字节为单位)。要启动可续传上传,此值为 0。

Content-Type 要上传的对象的 MIME 类型。如果您未指定内容类型,Cloud Storage 在传送对象时将默认为 application/octet-stream 否(推荐)
Date 请求的日期和时间。
Host Cloud Storage 的 URI。如需了解详情,请参阅请求端点
x-goog-acl 您要应用于对象的预定义 ACL。
x-goog-custom-time 用户指定的日期和时间。
x-goog-encryption-kms-key-name 用于加密对象的客户管理的加密密钥
x-goog-if-generation-match 如果您指定的世代与要替换的对象相同,则系统会替换该对象。您还可以将 0 指定为特殊值,以表示仅当不存在现有对象时,才会创建新对象。
x-goog-if-metageneration-match 如果您指定的元世代与您尝试更新的对象相同,则系统会更新对象元数据。仅在指定了 x-goog-if-generation 时才可以使用此参数。通过结合使用这两个生成属性,您可以实现安全的“读取-修改-写入”更新。
x-goog-meta- 可用于存储自定义元数据的扩展程序标头。
x-goog-resumable 表示此请求发起可续传上传。此标头必须使用值 start
x-goog-storage-class 为关联存储分区指定关联存储分区以外的存储类别。
x-goog-user-project 与请求关联的费用需要收取的项目费用。

如需提供客户提供的加密密钥以及对象上传,请使用请求中的客户提供的加密密钥页面列出的标头

请求正文元素

此请求不包含 XML 文档。

响应标头

响应包含一个 Location 标头,用于指示在上传对象数据时要使用的会话 URI。

响应正文元素

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

示例

以下示例将一个名为 paris.jpg 的对象上传到名为 travel-maps 的存储分区。

请求

POST /paris.jpg HTTP/2
Host: travel-maps.storage.googleapis.com
Date: Thu, 10 Dec 2020 18:11:50 GMT
Content-Type: image/jpg
Content-Length: 0
X-Goog-Resumable: start
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

响应

HTTP/2 201
Content-Type: text/plain; charset=utf-8
X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE
Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE
Content-Length: 0
Date: Thu, 10 Dec 2020 18:11:53 GMT
Server: UploadServer