1# 设置分布式文件数据等级 2 3不同设备本身的安全能力差异较大，一些小的嵌入式设备安全能力远弱于平板等设备类型。用户或者应用不同的文件数据有不同安全诉求，例如个人的健康信息和银行卡信息等不期望被弱设备读取。因此，OpenHarmony提供一套完整的数据分级、设备分级标准，并针对不同设备制定不同的数据流转策略，具体规则请参见[数据、设备安全分级](../database/access-control-by-device-and-data-level.md)。 4 5## 接口说明 6 7API详细介绍请参见[ohos.file.securityLabel](../reference/apis/js-apis-file-securityLabel.md)。 8 9**表1** 设置文件数据等级 10 11| 接口名 | 功能 | 接口类型 | 支持同步 | 支持异步 | 12| -------- | -------- | -------- | -------- | -------- | 13| setSecurityLabel | 设置文件安全标签 | 方法 | √ | √ | 14| getSecurityLabel | 获取文件安全标签 | 方法 | √ | √ | 15 16> **须知：** 17> 18> 1. 对于不满足安全等级的文件，跨设备仍然可以看到该文件，但是无权限打开访问该文件。 19> 20> 2. 分布式文件系统的数据等级默认为S3，应用可以主动设置文件的安全等级。 21 22## 开发示例 23 24获取通用文件沙箱路径，并设置数据等级标签。示例中的context的获取方式请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 25 26 27```ts 28import securityLabel from '@ohos.file.securityLabel'; 29 30// 获取需要设备数据等级的文件沙箱路径 31let context = ...; // 获取UIAbilityContext信息 32let pathDir = context.filesDir; 33let filePath = pathDir + '/test.txt'; 34 35// 设置文件的数据等级为s0 36securityLabel.setSecurityLabel(filePath, 's0').then(() => { 37 console.info('Succeeded in setSecurityLabeling.'); 38}).catch((err) => { 39 console.error(`Failed to setSecurityLabel. Code: ${err.code}, message: ${err.message}`); 40}); 41``` 42