向目录存储桶中的对象追加数据

您可以将数据添加到存储在目录存储桶内 S3 Express One Zone 存储类中的现有对象的末尾。如果数据是在一段时间内连续写入的，或者如果您需要在写入对象的同时读取该对象，我们建议您使用向对象追加数据的功能。向对象追加数据对于一些应用场景很常见，例如，向日志文件添加新的日志条目，或在视频文件转码并流式传输时向其中添加新的视频片段等。通过向对象追加数据，您可以简化之前需要先在本地存储中合并数据然后再将最终对象复制到 Amazon S3 的应用程序。

可以追加到对象的数据没有最小大小要求。但是，您可以在单个请求中追加到对象的最大数据大小为 5 GB。这与使用任何 Amazon S3 API 上传数据时的最大请求大小限制相同。

每次成功的追加操作都将创建对象的一部分，每个对象最多可以有 10000 个部分。这意味着您最多可以向对象追加数据 10000 次。如果使用 S3 分段上传创建对象，那么每个上传的部分都会计入总计最多 10000 个部分的限制中。例如，对于通过分段上传创建的包含 1000 个部分的对象，您最多可以追加 9000 次。

如果您想将分段并行上传至对象，并且无需在上传分段时读取分段，我们建议您使用 Amazon S3 分段上传。有关更多信息，请参阅使用分段上传。

仅支持向存储在 S3 Express One Zone 存储类中的目录存储桶内的对象追加数据。有关 S3 Express One Zone 的更多信息，请参阅开始使用 S3 Express One Zone。

要开始向目录存储桶中的对象追加数据，您可以使用 AWS SDK、AWS CLI 和 PutObject API。当您发出 PutObject 请求时，您可以将 x-amz-write-offset-bytes 标头设置为要追加到的对象的大小。要使用 PutObject API 操作，您必须使用 CreateSession API 建立临时安全凭证，才能访问目录存储桶中的对象。有关更多信息，请参阅《Amazon S3 API Reference》中的 PutObject 和 CreateSession。

每次成功的追加操作都会按 PutObject 请求计费。要了解有关定价的更多信息，请参阅 Amazon S3 pricing。

如果您在上传追加的数据时使用 CRC（循环冗余校验）算法，则可以使用 HeadObject 或 GetObject 请求来检索基于 CRC 的完整对象校验和。如果您在上传追加的数据时使用 SHA-1 或 SHA-256 算法，则可以检索追加部分的校验和，并使用之前的 PutObject 响应中返回的 SHA 校验和来验证其完整性。有关更多信息，请参阅数据保护和加密。

使用 AWS CLI、AWS SDK 和 REST API 向对象追加数据

您可以使用 AWS Command Line Interface（AWS CLI）、AWS SDK 和 REST API 将数据追加到您的对象中。

aws s3api put-object --bucket amzn-s3-demo-bucket--azid--x-s3 --key sampleinput/file001.bin --body bucket-seed/file001.bin --write-offset-bytes size-of-sampleinput/file001.bin