1# @ohos.data.cloudData (端云服务)
2
3端云服务提供端云协同、端云共享和端云策略。
4
5端云协同提供结构化数据（RDB Store）端云同步的能力。即：云作为数据的中心节点，通过与云的数据同步，实现数据云备份、同账号设备间的数据一致性。
6端云配置提供端云同步策略配置的能力。
7
8> **说明：**
9>
10> - 本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
11
12## 导入模块
13
14```ts
15import { cloudData } from '@kit.ArkData';
16```
17
18## StrategyType
19
20云同步策略类型枚举。
21
22**系统能力：** SystemCapability.DistributedDataManager.CloudSync.Client
23
24| 名称      | 值 | 说明        |
25| --------- |---|-----------|
26| NETWORK | 0 | 通过网络同步策略。 |
27
28## NetWorkStrategy
29
30网络策略参数枚举。
31
32**系统能力：** SystemCapability.DistributedDataManager.CloudSync.Client
33
34| 名称      | 值 | 说明        |
35| --------- |---|-----------|
36| WIFI | 1 | WIFI网络策略。 |
37| CELLULAR | 2 | 蜂窝网络策略。   |
38
39## cloudData.setCloudStrategy
40setCloudStrategy(strategy: StrategyType, param?: Array<commonType.ValueType>): Promise<void>
41
42<!--RP1-->
43设置应用自身的云同步策略，若未设置，则执行全局策略[setGlobalCloudStrategy<sup>12+</sup>](js-apis-data-cloudData-sys.md#setglobalcloudstrategy12)，全局策略若未设置，默认使用WIFI和蜂窝策略。使用Promise异步回调。<!--RP1End-->
44
45**系统能力：** SystemCapability.DistributedDataManager.CloudSync.Client
46
47| 参数名     | 类型                                                                          | 必填 | 说明                             |
48| ---------- |-----------------------------------------------------------------------------| ---- | -------------------------------- |
49| strategy  | [StrategyType](#strategytype)                                               | 是   | 配置的策略类型。             |
50| param | Array&lt;[commonType.ValueType](js-apis-data-commonType.md#valuetype)&gt; | 否   | 策略参数。不填写取消所有配置。 |
51
52**返回值：**
53
54| 类型                | 说明                      |
55| ------------------- | ------------------------- |
56| Promise&lt;void&gt; | 无返回结果的Promise对象。 |
57
58**错误码：**
59
60以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
61
62| **错误码ID** | **错误信息**                                                 |
63|-----------| ------------------------------------------------------------ |
64| 401       | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. |
65| 801       | Capability not supported.|
66
67**样例：**
68
69```ts
70import { BusinessError } from '@kit.BasicServicesKit';
71
72// 仅WIFI同步
73cloudData.setCloudStrategy(cloudData.StrategyType.NETWORK, [cloudData.NetWorkStrategy.WIFI]).then(() => {
74    console.info('Succeeded in setting the cloud strategy');
75}).catch((err: BusinessError) => {
76    console.error(`Failed to set cloud strategy. Code: ${err.code}, message: ${err.message}`);
77});
78
79```
80<!--no_check-->
81