归档存储.PDF

归档存储 API使用手册 归档存储 API使用手册 API使用手册 欢迎使用阿里云归档存储。归档存储作为阿里云数据存储服务体系的一部分，提供了极低成本的数据存储服务 。适合各种离线数据，包括但不局限于数字媒体、企业归档资料、科学实验数据、个人备份等。用户可以将数 据进行几个月、几年甚至几十年的长时间存储。同时不需要任何基础设施的投入，即可拥有无限扩容、可选择 地域的低成本数据归档方案，也免去了后续数据的管理维护成本。需要注意的是，存放于归档存储的数据大部 分时间会处于“休眠”状态，而对数据的“唤醒”操作需要消耗一些时间和资源，因此如果您对数据长期稳定 存储的需求较高，而对数据的访问和读取速度要求较低的话，归档存储会是一个理想的选择。用户可以使用本 文档介绍的API对归档存储进行相关操作。在使用这些接口前，请确保已充分了解归档存储产品说明、使用协议 和收费方式。 若要了解更多相关信息，请访问阿里云归档存储官方网站 /product/oas。 基本概念 阿里云归档存储的数据模型，由Vault（目录）和Archive（文档）组成。 Archive 在归档存储中，用户操作的基本数据单元是Archive，它需要包含在Vault（1.1.2）中。Archive可以是任意类 型的数据。上传Archive（4.2.1）时，文档大小限制在6GB；如果文档大小超出6GB，请使用Multipart Upload（1.1.4）方式。Archive包含ArchiveID、Description和Data等Data信息，其中ArchiveID是 Archive的唯一标识，用户上传Archive时由系统自动生成并返回给用户，Description是用户对该Archive的描 述，Data是Archive的数据。Archive目前仅支持通过API进行操作。 Vault Vault是归档存储提供给用户用于管理Archive的目录，也是计费、权限控制等功能的管理单位。Vault名称在每 个用户的每个Region（1.1.3）下唯一，每个用户在每个Region最多可以创建10个Vault，Vault不支持嵌套。 每个Vault里可以包含任意数量的Archive。Vault可以通过阿里云管理控制台、API两种方式进行创建、删除等 操作。 Vault的命名规范： - 只能包含小写字母、数字、下划线（_）、短横线（-）； - 必须以小写字母或者数字开头和结尾； - 长度必须在 3-63 字节之间； Region 1 归档存储 API使用手册 Region是归档存储集群的标识。各Region间的操作相互独立。当前可用Region列表参见2.1.1。