阿里云-归档存储-API手册-D

《阿里云-归档存储-API手册-D》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、归档存储API使用手册移动推送/OpenAPI文档API使用手册欢迎使用阿里云归档存储。归档存储作为阿里云数据存储服务体系的一部分，提供了极低成本的数据存储服务。适合各种离线数据，包括但不局限于数字媒体、企业归档资料、科学实验数据、个人备份等。用户可以将数据进行几个月、几年甚至几十年的长时间存储。同时不需要任何基础设施的投入，即可拥有无限扩容、可选择地域的低成本数据归档方案，也免去了后续数据的管理维护成本。需要注意的是，存放于归档存储的数据大部分时间会处于"休眠"状态，而对数据的"唤醒"操作需要消耗一些时间和资源，因此如果您对数据长期稳定存储的需求较高，而对数据的访问和读取速度要求较低的

2、话，归档存储会是一个理想的选择。用户可以使用本文档介绍的API对归档存储进行相关操作。在使用这些接口前，请确保已充分了解归档存储产品说明、使用协议和收费方式。若要了解更多相关信息，请访问阿里云归档存储官方网站www.aliyun.com/product/oas。1.1基本概念阿里云归档存储的数据模型，由Vault（目录）和Archive（文档）组成。1.1.1Archive在归档存储中，用户操作的基本数据单元是Archive，它需要包含在Vault（1.1.2）中。Archive可以是任意类型的数据。上传Archive（4.2.1）时，文档大小限制在6GB；如果文档大小超出6GB，请使用

3、MultipartUpload（1.1.4）方式。Archive包含ArchiveID、Description和Data等Data信息，其中ArchiveID是Archive的唯一标识，用户上传Archive时由系统自动生成并返回给用户，Description是用户对该Archive的描述，Data是Archive的数据。Archive目前仅支持通过API进行操作。1.1.2VaultVault是归档存储提供给用户用于管理Archive的目录，也是计费、权限控制等功能的管理单位。Vault名称在每个用户的每个Region（1.1.3）下唯一，每个用户在每个Region最多可以创建10个V

4、ault，Vault不支持嵌套。每个Vault里可以包含任意数量的Archive。Vault可以通过阿里云管理控制台、API两种方式进行创建、删除等操作。Vault的命名规范：-只能包含小写字母、数字、下划线（_）、短横线（-）；-必须以小写字母或者数字开头和结尾；-长度必须在3-63字节之间；1.1.3Region55专有网络VPC/API使用手册Region是归档存储集群的标识。各Region间的操作相互独立。当前可用Region列表参见2.1.1。1.1.1MultipartUploadMultipartUpload是把单个文档分段上传的方式，每段称之为Part（1.1.5），目的

5、是为了便于用户上传较大的文档。使用MultipartUpload最大可以上传10000*4GB的文档。不仅如此，多段上传还支持独立、任意顺序、甚至并行上传这些段。如果某段上传失败，只需要重新上传该段即可。我们建议用户在上传大于100MB的文档时使用这种方式。该上传操作是异步方式，用户需要首先新建MultipartUpload任务，指定每次需要上传的Part字节长度，该长度值必须能够被1MB整除，且介于32MB到4096MB之间。任务启动成功后，归档存储会为该任务分配唯一的UploadID，用户需要使用该ID作为标识完成后续Part的上传与合并。需要注意的是该任务自创建起24小时后，会自动

6、失效。1.1.2Part启动MultipartUpload任务成功以后，单独上传的某个范围内的文档数据称为Part。用户上传时需要指定Part在文档中所属的范围。当所有Part都上传成功以后，用户还需要主动发起一次Part合并请求（4.3.6），才能将上传的数据完整地提交到归档存储，否则任务创建超出24小时以后，用户在该任务中上传的数据将会丢失。1.1.3Job归档存储的Vault/Archive的内容提取为异步操作，用户需要首先提交指定类型的Job完成对数据的"唤醒"，然后通过查询Job状态来确认Job是否完成。在正常情况下，任务会在4小时内完成。Job完成以后，就可以获取JobOut

7、put。Job类型可以是inventory-retrieval或archive-retrieval。前者获取到的JobOutput是Job指定Vault的Archive列表信息，后者则是Job指定Archive的数据内容。注意inventory-retrieval类型Job获取到的Archive列表信息是由系统每天定期扫描生成的信息，不是实时数据。Job类型还可以是pull-from-oss或push-to-oss。这两种Job类型