
# 修改数据源配置
#### 功能介绍
修改数据源配置
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IoTEdge/doc?api=UpdateDcDs)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
PUT /v2/{project_id}/edge-nodes/{edge_node_id}/ots/data-sources/{ds_id}
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目ID。获取方法请参见 [获取项目ID](https://support.huaweicloud.com/api-iotedge/iotedge_api_0032.html)。 |
| edge_node_id | 是    | String | 边缘节点ID                                                                                    |
| ds_id        | 是    | String | 采集数据源id，创建数据源配置时设置，节点下唯一。                                                                 |
   
表2Query参数 
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| update_name_only | 否    | Boolean | 指此配置是否只更新了名称，默认值为false。 - true: 配置中只更新了名称   - false: 配置中包含其他配置参数更新    |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务 [获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取，接口返回的响应消息头中"X-Subject-Token"就是需要获取的用户Token。简要的获取方法样例请参见 [Token认证](https://support.huaweicloud.com/api-iothub/iot_06_v5_0091.html#section0)。 |
   
表4请求Body参数 
| 参数             | 是否必选 | 参数类型    | 描述                           |
|:---|:---|:---|:---|
| config         | 否    | Object  | 数据源的连接及采集信息                  |
| name           | 否    | String  | 采集数据源名称，允许中、数字、英文大小写、下划线、中划线 |
| quality_report | 否    | Boolean | 质量上报开关，不携带或值不为true，默认为false  |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数                | 参数类型    | 描述                           |
|:---|:---|:---|
| ds_id             | String  | 采集数据源id，节点下唯一                |
| config            | Object  | 数据源的连接及采集信息                  |
| name              | String  | 采集数据源名称，允许中、数字、英文大小写、下划线、中划线 |
| edge_node_id      | String  | 边缘节点id                       |
| module_id         | String  | 模块id                         |
| tpl_id            | String  | 模板id，节点下唯一                   |
| quality_report    | Boolean | 质量上报开关，不携带或值不为true，默认为false  |
| edge_app_name     | String  | 应用ID                         |
| connection_info   | Object  | 数采连接信息                       |
| module_state      | String  | 数采连接状态,stopped\|running      |
| count             | Long    | 数采连接下点位数                     |
| create_time       | String  | 创建时间                         |
| update_time       | String  | 最后一次修改时间                     |
| synchronized      | Boolean | 数采配置是否已同步，已同步：true,未同步：false |
| synchronized_time | String  | 数采配置同步时间                     |
   
#### 请求示例
```
GET https://{endpoint}/v2/{project_id}/edge-nodes/{edge_node_id}/ots/data-sources/{ds_id}
{
  "config" : {
    "connection_info" : {
      "endpoint" : "opc.tcp://127.0.0.1:53530/OPCUA",
      "username" : "admin",
      "password" : "*****"
    },
    "collection_paras" : {
      "default_cycle" : 1000
    }
  },
  "name" : "电力子系统",
  "quality_report" : false
}
```
#### 响应示例
**状态码：200**
修改数据源配置数据
```
{
  "ds_id" : "opcua_1",
  "config" : {
    "connection_info" : {
      "endpoint" : "opc.tcp://127.0.0.1:53530/OPCUA",
      "username" : "admin",
      "password" : "*****"
    },
    "collection_paras" : {
      "default_cycle" : 1000
    }
  },
  "name" : "电力子系统",
  "edge_node_id" : "446007715895193600",
  "module_id" : "user_opc_ua_yz",
  "tpl_id" : "sys_general_opcua",
  "quality_report" : false,
  "edge_app_name" : "西门子OPCUA驱动",
  "connection_info" : { },
  "module_state" : "stopped",
  "count" : 1000000,
  "create_time" : "2020-05-28T11:31:29.740Z",
  "update_time" : "2020-05-28T11:31:29.740Z",
  "synchronized" : true,
  "synchronized_time" : "2020-05-28T11:31:29.740Z"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | 修改数据源配置数据      |
| 400 | Error response |
| 404 | Not Found      |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotedge/ErrorCode.html)。
