# [Cloud](/minigame/dev/wxcloud/reference-sdk-api/Cloud).CloudID(cloudID: string)

> 支持端：[小程序 2.7.0](/miniprogram/dev/framework/client-lib/version.md), [Web 1.1.0](/minigame/dev/wxcloud/reference/changelog-web-sdk)

声明字符串为 CloudID（开放数据 ID），该接口传入一个字符串，返回一个 `CloudID` 特殊对象，将该对象传至云函数可以获取其对应的开放数据。详见[通过云调用获取开放数据](/miniprogram/dev/framework/open-ability/signature.md)

## 参数

### cloudID: string

通过开放能力在小程序端 / web 端获取得到的 CloudID

## 示例代码

小程序端调用

```js
wx.cloud.callFunction({
  name: 'myFunction',
  data: {
    weRunData: wx.cloud.CloudID('xxx'), // 这个 CloudID 值到云函数端会被替换
    obj: {
      shareInfo: wx.cloud.CloudID('yyy'), // 非顶层字段的 CloudID 不会被替换，会原样字符串展示
    }
  }
})
```

在云函数端接收到的 `event` 将会包含对应开放数据的对象，其中 `event.weRunData` 会因为符合规则而包含开放数据，`event.shareInfo` 则不会，`event` 结构将如下：

```
{
  "weRunData": {
    "cloudID": "27_Ih-9vxDaOhIbh48Bdpk90DUkUoNMAPaNtg7OSGM-P2wPEk1NbspjKGoql_g",
    "data": {
      "stepInfoList": [
        {
          "step": 9103,
          "timestamp": 1571673600
        },
        {
          "step": 9783,
          "timestamp": 1571760000
        }
      ],
      "watermark": {
        "appid": "wx3d289323f5900f8e",
        "timestamp": 1574338655
      }
    }
  },
  "obj": {
    "shareInfo": "xxx"
  }
}
```