如何查询 Archive 元数据

为了帮助您更好地理解和使用这两个接口，我将分别对getArchiveMeta和uploadArchive的请求参数、响应结果进行详细说明。

获取Archive元数据信息（GetArchiveMeta）

请求参数: - vaultId: String类型，目标Vault的ID，即待查询Archive所属的存储库ID。 - archiveId: String类型，已成功上传的Archive的ID，用于唯一标识一个Archive。

接口定义: 此方法根据指定的vaultId和archiveId获取Archive的元数据信息。调用时需提供一个GetArchiveMetaRequest对象，并将返回一个包含Archive描述信息的GetArchiveMetaResult对象。过程中可能会抛出客户端或服务端异常。

响应结果: - descriptor: ArchiveDescriptor类型，包含以下字段： - archiveId: Archive的ID字符串。 - treeEtag: Archive的树结构校验信息字符串。 - description: 对Archive的描述信息。 - creationDate: Archive的创建时间日期对象。 - size: Archive的大小，单位为字节的长整型数值。

上传Archive

同步上传

请求参数: - vaultId: String类型，目标Vault的ID，即Archive上传的目标存储库。 - file: File类型，待上传的文件实体，与stream参数互斥。 - stream: InputStream类型，待上传的数据流，与file参数互斥。 - contentLength: Long类型（可选），指定上传内容的长度，默认为文件长度或流的可用长度。 - description: String类型（可选），Archive的描述信息。 - contentEtag: String类型（可选），Archive的内容校验码。 - treeEtag: String类型（可选），Archive的哈希树校验码。

接口定义: - 提供同步上传Archive的方法，需要传入UploadArchiveRequest对象。成功后返回包含上传结果信息的UploadArchiveResult对象，失败则抛出异常。

异步上传

接口定义: - 异步版本的上传接口，除了常规的UploadArchiveRequest外，还需提供一个AsyncHandler处理器来处理异步执行的结果。同样，调用可能抛出客户端或服务端异常。

响应结果: - location: String类型，成功上传后的Archive的URI。 - archiveId: String类型，成功上传的Archive的ID。

通过上述信息，您可以根据实际需求构造请求参数，调用相应接口完成Archive的元数据查询或上传操作。