输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用服务Cloud Foundation Kit（云开发服务）云存储设置云侧文件的元数据

设置云侧文件的元数据

更新时间: 2026-07-28 11:23
本文导读

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

文件保存至云侧后，开发者可以设置文件的自定义属性。

约束与限制

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

前提条件

操作步骤

  1. 导入相关模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { cloudStorage } from '@kit.CloudFoundationKit';
    2. // ...
    3. import { BusinessError } from '@kit.BasicServicesKit';
    4. import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 调用StorageBucket.setMetadata设置云侧文档的元数据信息。

    收起
    自动换行
    深色代码主题
    复制
    1. let bucket: cloudStorage.StorageBucket = cloudStorage.bucket();
    2. hilog.info(0x0000, 'Storage', `promise setMetadata  cloudPath: ${UI.uploadFileName}`);
    3. bucket.setMetadata(UI.uploadFileName, {
    4.   customMetadata: {
    5.     key1: 'value1',
    6.     key2: 'value2'
    7.   }
    8. }).then((result: Object) => {
    9.   hilog.info(0x0000, 'Storage', `Succeeded in setting Metadata  ${JSON.stringify(result)}`);
    10. }).catch((err: BusinessError) => {
    11.   hilog.error(0x0000, 'Storage', `Failed to set Metadata code: ${err.code}, message: ${err.message}`);
    12. });
获取云侧文件的元数据
预加载
相关推荐
文档获取云侧文件的元数据
文档获取云侧文件列表
文档下载云侧文件至本地
文档获取云侧文件下载地址
文档删除云侧文件
文档设置云存储配置项
文档上传指定文件至云侧
文档初始化全局应用上下文
文档初始化存储实例
文档cloudStorage (云存储模块)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词