# 获取云侧文件的元数据

文件元数据包含云侧文件名、文件大小、文件类型等常用属性，也包括用户自定义的文件属性。

文件上传至云侧后，开发者可以在下载文件前获取指定云侧文件的元数据，来决定是否下载此文件。

## 约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备；从6.1.0(23)版本开始，新增支持PC/2in1设备。

## 前提条件

* 已[初始化存储实例](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-storage-initialize-bucket)。

* 已[上传指定文件至云侧](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-storage-upload-file)。

## 操作步骤

1. 导入相关模块。

   ```TypeScript
   import { cloudStorage } from '@kit.CloudFoundationKit';
   // ...
   import { BusinessError } from '@kit.BasicServicesKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   ```

2. 调用[StorageBucket.getMetadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudstorage#getmetadata)获取指定云侧文件的元数据信息。

   ```TypeScript
   let bucket: cloudStorage.StorageBucket = cloudStorage.bucket();
   bucket.getMetadata(UI.uploadFileName).then((result: cloudStorage.Metadata) => {
     hilog.info(0x0000, 'Storage', `promise bucket.getMetadata end  ${JSON.stringify(result)}`);
     let time: Date = result.createTime;
     hilog.info(0x0000, 'Storage', `printMessage time ${time}`);
     hilog.info(0x0000, 'Storage', `time ${time.getTime()}`);
   }).catch((err: BusinessError) => {
     hilog.error(0x0000, 'Storage', `Failed to getMetadata code: ${err.code}, message: ${err.message}`);
   });
   ```